@mastra/client-js 1.18.0-alpha.9 → 1.18.1-alpha.0

package/dist/index.js

@@ -5,7 +5,7 @@ import { standardSchemaToJSONSchema, toStandardSchema } from '@mastra/schema-com
 import { RequestContext } from '@mastra/core/request-context';
 export { RequestContext } from '@mastra/core/request-context';
 import { zodToJsonSchema as zodToJsonSchema$1 } from '@mastra/schema-compat/zod-to-json';
-import { MastraA2AError } from '@mastra/core/a2a';
+import { MastraA2AError } from '@mastra/core/a2a/client';
 import canonicalize from 'canonicalize';
 import { base64url, decodeProtectedHeader, compactVerify, importX509, importSPKI, importJWK } from 'jose';
 
@@ -130,11 +130,15 @@ function processClientTools(clientTools) {
 // src/utils/process-mastra-stream.ts
 async function sharedProcessMastraStream({
   stream,
-  onChunk
+  onChunk,
+  signal
 }) {
   const reader = stream.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  const abort = () => void reader.cancel();
+  if (signal?.aborted) abort();
+  else signal?.addEventListener("abort", abort, { once: true });
   try {
     while (true) {
       const { done, value } = await reader.read();
@@ -162,25 +166,30 @@ async function sharedProcessMastraStream({
       }
     }
   } finally {
+    signal?.removeEventListener("abort", abort);
     reader.releaseLock();
   }
 }
 async function processMastraNetworkStream({
   stream,
-  onChunk
+  onChunk,
+  signal
 }) {
   return sharedProcessMastraStream({
     stream,
-    onChunk
+    onChunk,
+    signal
   });
 }
 async function processMastraStream({
   stream,
-  onChunk
+  onChunk,
+  signal
 }) {
   return sharedProcessMastraStream({
     stream,
-    onChunk
+    onChunk,
+    signal
   });
 }
 
@@ -343,8 +352,6 @@ var AgentVoice = class extends BaseResource {
     this.version = version;
     this.agentId = agentId;
   }
-  agentId;
-  version;
   getQueryString(requestContext, delimiter = "?") {
     const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
     if (this.version) {
@@ -414,8 +421,6 @@ var Agent = class extends BaseResource {
     this.version = version;
     this.voice = new AgentVoice(options, this.agentId, this.version);
   }
-  agentId;
-  version;
   voice;
   getQueryString(requestContext, delimiter = "?") {
     const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
@@ -441,6 +446,38 @@ var Agent = class extends BaseResource {
       body: { instructions, comment }
     });
   }
+  /**
+   * @experimental Agent signals are experimental and may change in a future release.
+   */
+  sendSignal(params) {
+    return this.request(`/agents/${this.agentId}/signals`, {
+      method: "POST",
+      body: params
+    });
+  }
+  /**
+   * @experimental Agent signals are experimental and may change in a future release.
+   */
+  async subscribeToThread(params) {
+    const streamResponse = await this.request(`/agents/${this.agentId}/threads/subscribe`, {
+      method: "POST",
+      body: params,
+      stream: true
+    });
+    if (!streamResponse.body) {
+      throw new Error("No response body");
+    }
+    streamResponse.processDataStream = async ({
+      onChunk
+    }) => {
+      await processMastraStream({
+        stream: streamResponse.body,
+        onChunk,
+        signal: this.options.abortSignal
+      });
+    };
+    return streamResponse;
+  }
   /**
    * Clones this agent to a new stored agent in the database
    * @param params - Clone parameters including optional newId, newName, metadata, authorId, and requestContext
@@ -1900,13 +1937,25 @@ var MemoryThread = class extends BaseResource {
     this.threadId = threadId;
     this.agentId = agentId;
   }
-  threadId;
-  agentId;
   /**
    * Builds the query string for agentId (if provided)
    */
-  getAgentIdQueryParam(prefix = "?") {
-    return this.agentId ? `${prefix}agentId=${this.agentId}` : "";
+  getAgentIdQueryParam(prefix = "?", overrideAgentId) {
+    const agentId = overrideAgentId ?? this.agentId;
+    return agentId ? `${prefix}agentId=${agentId}` : "";
+  }
+  /**
+   * Resolves the agentId to use for a write request. Prefers the per-call value, falls back
+   * to the constructor value, and throws if neither is set.
+   */
+  requireAgentId(perCallAgentId, methodName) {
+    const agentId = perCallAgentId ?? this.agentId;
+    if (!agentId) {
+      throw new Error(
+        `MemoryThread.${methodName}() requires an agentId. Pass it via getMemoryThread({ threadId, agentId }) or as a parameter to ${methodName}().`
+      );
+    }
+    return agentId;
   }
   /**
    * Retrieves the memory thread details
@@ -1920,25 +1969,30 @@ var MemoryThread = class extends BaseResource {
   }
   /**
    * Updates the memory thread properties
-   * @param params - Update parameters including title, metadata, and optional request context
+   * @param params - Update parameters including title, metadata, and optional request context.
+   *                 `agentId` is required by the server; pass it here if not supplied on the constructor.
    * @returns Promise containing updated thread details
    */
   update(params) {
-    const agentIdParam = this.getAgentIdQueryParam("?");
-    const contextParam = requestContextQueryString(params.requestContext, agentIdParam ? "&" : "?");
+    const agentId = this.requireAgentId(params.agentId, "update");
+    const { agentId: _omitAgentId, requestContext, ...body } = params;
+    const agentIdParam = `?agentId=${agentId}`;
+    const contextParam = requestContextQueryString(requestContext, "&");
     return this.request(`/memory/threads/${this.threadId}${agentIdParam}${contextParam}`, {
       method: "PATCH",
-      body: params
+      body
     });
   }
   /**
    * Deletes the memory thread
-   * @param requestContext - Optional request context to pass as query parameter
+   * @param opts - Optional `agentId` (required by the server when not supplied on the constructor)
+   *               and request context.
    * @returns Promise containing deletion result
    */
-  delete(requestContext) {
-    const agentIdParam = this.getAgentIdQueryParam("?");
-    const contextParam = requestContextQueryString(requestContext, agentIdParam ? "&" : "?");
+  delete(opts = {}) {
+    const agentId = this.requireAgentId(opts.agentId, "delete");
+    const agentIdParam = `?agentId=${agentId}`;
+    const contextParam = requestContextQueryString(opts.requestContext, "&");
     return this.request(`/memory/threads/${this.threadId}${agentIdParam}${contextParam}`, {
       method: "DELETE"
     });
@@ -1968,37 +2022,46 @@ var MemoryThread = class extends BaseResource {
    * Deletes one or more messages from the thread
    * @param messageIds - Can be a single message ID (string), array of message IDs,
    *                     message object with id property, or array of message objects
-   * @param requestContext - Optional request context to pass as query parameter
+   * @param opts - Optional `agentId` (required by the server when not supplied on the constructor)
+   *               and request context. For backwards compatibility a `RequestContext` may also be
+   *               passed directly as the second argument.
    * @returns Promise containing deletion result
    */
-  deleteMessages(messageIds, requestContext) {
-    const queryParams = {};
-    if (this.agentId) queryParams.agentId = this.agentId;
-    const query = new URLSearchParams(queryParams);
-    const queryString = query.toString();
-    return this.request(
-      `/memory/messages/delete${queryString ? `?${queryString}` : ""}${requestContextQueryString(requestContext, queryString ? "&" : "?")}`,
-      {
-        method: "POST",
-        body: { messageIds }
-      }
-    );
+  deleteMessages(messageIds, opts = {}) {
+    const { agentId: explicitAgentId, requestContext } = normalizeWriteOpts(opts);
+    const agentId = this.requireAgentId(explicitAgentId, "deleteMessages");
+    const queryString = `agentId=${agentId}`;
+    return this.request(`/memory/messages/delete?${queryString}${requestContextQueryString(requestContext, "&")}`, {
+      method: "POST",
+      body: { messageIds }
+    });
   }
   /**
    * Clones the thread with all its messages to a new thread
-   * @param params - Clone parameters including optional new thread ID, title, metadata, and message filters
+   * @param params - Clone parameters including optional new thread ID, title, metadata, and message filters.
+   *                 `agentId` is required by the server; pass it here if not supplied on the constructor.
    * @returns Promise containing the cloned thread and copied messages
    */
   clone(params = {}) {
-    const { requestContext, ...body } = params;
-    const agentIdParam = this.getAgentIdQueryParam("?");
-    const contextParam = requestContextQueryString(requestContext, agentIdParam ? "&" : "?");
+    const agentId = this.requireAgentId(params.agentId, "clone");
+    const { agentId: _omitAgentId, requestContext, ...body } = params;
+    const agentIdParam = `?agentId=${agentId}`;
+    const contextParam = requestContextQueryString(requestContext, "&");
     return this.request(`/memory/threads/${this.threadId}/clone${agentIdParam}${contextParam}`, {
       method: "POST",
       body
     });
   }
 };
+function normalizeWriteOpts(opts) {
+  if (!opts || typeof opts !== "object") return {};
+  if ("agentId" in opts || "requestContext" in opts) {
+    const o = opts;
+    return { agentId: o.agentId, requestContext: o.requestContext };
+  }
+  if (Object.keys(opts).length === 0) return {};
+  return { requestContext: opts };
+}
 
 // src/resources/vector.ts
 var Vector = class extends BaseResource {
@@ -2006,7 +2069,6 @@ var Vector = class extends BaseResource {
     super(options);
     this.vectorName = vectorName;
   }
-  vectorName;
   /**
    * Retrieves details about a specific vector index
    * @param indexName - Name of the index to get details for
@@ -2079,7 +2141,6 @@ var Tool = class extends BaseResource {
     super(options);
     this.toolId = toolId;
   }
-  toolId;
   /**
    * Retrieves details about the tool
    * @param requestContext - Optional request context to pass as query parameter
@@ -2115,7 +2176,6 @@ var Processor = class extends BaseResource {
     super(options);
     this.processorId = processorId;
   }
-  processorId;
   /**
    * Retrieves details about the processor
    * @param requestContext - Optional request context to pass as query parameter
@@ -2197,8 +2257,6 @@ var Run = class extends BaseResource {
     this.workflowId = workflowId;
     this.runId = runId;
   }
-  workflowId;
-  runId;
   /**
    * Creates a transform stream that parses RECORD_SEPARATOR-delimited JSON chunks
    */
@@ -2591,7 +2649,6 @@ var Workflow = class extends BaseResource {
     super(options);
     this.workflowId = workflowId;
   }
-  workflowId;
   /**
    * Retrieves details about the workflow
    * @param requestContext - Optional request context to pass as query parameter
@@ -2954,7 +3011,6 @@ var A2A = class extends BaseResource {
     super(options);
     this.agentId = agentId;
   }
-  agentId;
   /**
    * Get the agent card with metadata about the agent.
    * @param options - Optional Agent Card verification settings
@@ -3186,12 +3242,10 @@ var MCPTool = class extends BaseResource {
   execute(params) {
     const body = {};
     if (params.data !== void 0) body.data = params.data;
-    if (params.requestContext !== void 0) {
-      body.requestContext = params.requestContext;
-    }
+    if (params.requestContext !== void 0) body.requestContext = params.requestContext;
     return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute`, {
       method: "POST",
-      body: Object.keys(body).length > 0 ? body : void 0
+      body
     });
   }
 };
@@ -3203,7 +3257,6 @@ var AgentBuilder = class extends BaseResource {
     super(options);
     this.actionId = actionId;
   }
-  actionId;
   // Helper function to transform workflow result to action result
   transformWorkflowResult(result) {
     if (result.status === "success") {
@@ -3390,13 +3443,14 @@ var AgentBuilder = class extends BaseResource {
    * This calls `/agent-builder/:actionId/stream`.
    */
   async stream(params, runId) {
-    const searchParams = new URLSearchParams();
-    if (runId) {
-      searchParams.set("runId", runId);
+    if (!runId) {
+      throw new Error("runId is required to stream an agent builder action");
     }
+    const searchParams = new URLSearchParams();
+    searchParams.set("runId", runId);
     const requestContext = parseClientRequestContext(params.requestContext);
     const { requestContext: _, ...actionParams } = params;
-    const url = `/agent-builder/${this.actionId}/stream${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    const url = `/agent-builder/${this.actionId}/stream?${searchParams.toString()}`;
     const response = await this.request(url, {
       method: "POST",
       body: { ...actionParams, requestContext },
@@ -3930,7 +3984,6 @@ var StoredAgent = class extends BaseResource {
     super(options);
     this.storedAgentId = storedAgentId;
   }
-  storedAgentId;
   /**
    * Retrieves details about the stored agent
    * @param requestContext - Optional request context to pass as query parameter
@@ -4090,7 +4143,6 @@ var StoredPromptBlock = class extends BaseResource {
     super(options);
     this.storedPromptBlockId = storedPromptBlockId;
   }
-  storedPromptBlockId;
   /**
    * Retrieves details about the stored prompt block
    * @param requestContext - Optional request context to pass as query parameter
@@ -4250,7 +4302,6 @@ var StoredMCPClient = class extends BaseResource {
     super(options);
     this.storedMCPClientId = storedMCPClientId;
   }
-  storedMCPClientId;
   /**
    * Retrieves details about the stored MCP client
    * @param requestContext - Optional request context to pass as query parameter
@@ -4297,7 +4348,6 @@ var StoredScorer = class extends BaseResource {
     super(options);
     this.storedScorerId = storedScorerId;
   }
-  storedScorerId;
   /**
    * Retrieves details about the stored scorer definition
    * @param requestContext - Optional request context to pass as query parameter
@@ -4458,7 +4508,6 @@ var ToolProvider = class extends BaseResource {
     super(options);
     this.providerId = providerId;
   }
-  providerId;
   /**
    * Lists available toolkits from this provider
    * @returns Promise containing list of toolkits
@@ -4508,7 +4557,6 @@ var ProcessorProvider = class extends BaseResource {
     super(options);
     this.providerId = providerId;
   }
-  providerId;
   /**
    * Gets details about this processor provider and its available processors
    * @returns Promise containing provider info and processor list
@@ -4528,9 +4576,6 @@ var WorkspaceSkillResource = class extends BaseResource {
     this.basePath = `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}`;
     this.pathQuery = this.skillPath ? `?path=${encodeURIComponent(this.skillPath)}` : "";
   }
-  workspaceId;
-  skillName;
-  skillPath;
   basePath;
   pathQuery;
   /**
@@ -4750,7 +4795,6 @@ var StoredSkill = class extends BaseResource {
     super(options);
     this.storedSkillId = storedSkillId;
   }
-  storedSkillId;
   /**
    * Retrieves details about the stored skill
    * @param requestContext - Optional request context to pass as query parameter
@@ -4847,7 +4891,6 @@ var ResponsesStream = class {
   constructor(response) {
     this.response = response;
   }
-  response;
   asResponse() {
     return this.response;
   }
@@ -5107,13 +5150,13 @@ var MastraClient = class extends BaseResource {
     }
     return this.request(url);
   }
-  deleteThread(threadId, opts = {}) {
-    let url = "";
-    if (opts.agentId) {
-      url = `/memory/threads/${threadId}?agentId=${opts.agentId}${requestContextQueryString(opts.requestContext, "&")}`;
-    } else if (opts.networkId) {
-      url = `/memory/network/threads/${threadId}?networkId=${opts.networkId}${requestContextQueryString(opts.requestContext, "&")}`;
+  deleteThread(threadId, opts) {
+    if (!opts || !!opts.agentId === !!opts.networkId) {
+      throw new Error(
+        "MastraClient.deleteThread() requires exactly one of agentId or networkId. The server cannot resolve which memory store owns the thread without one, and passing both is ambiguous."
+      );
     }
+    const url = opts.agentId ? `/memory/threads/${threadId}?agentId=${opts.agentId}${requestContextQueryString(opts.requestContext, "&")}` : `/memory/network/threads/${threadId}?networkId=${opts.networkId}${requestContextQueryString(opts.requestContext, "&")}`;
     return this.request(url, { method: "DELETE" });
   }
   /**
@@ -5257,7 +5300,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing map of action IDs to action details
    */
   getAgentBuilderActions() {
-    return this.request("/agent-builder/");
+    return this.request("/agent-builder");
   }
   /**
    * Gets an agent builder instance for executing agent-builder workflows