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

package/dist/index.js

@@ -483,6 +483,12 @@ var Agent = class extends BaseResource {
     return this.request(`/api/agents/${this.agentId}`);
   }
   async generate(params) {
+    console.warn(
+      "Deprecation NOTICE:Generate method will switch to use generateVNext implementation September 16th. Please use generateLegacy if you don't want to upgrade just yet."
+    );
+    return this.generateLegacy(params);
+  }
+  async generateLegacy(params) {
     const processedParams = {
       ...params,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
@@ -492,7 +498,7 @@ var Agent = class extends BaseResource {
     };
     const { runId, resourceId, threadId, runtimeContext } = processedParams;
     const response = await this.request(
-      `/api/agents/${this.agentId}/generate`,
+      `/api/agents/${this.agentId}/generate-legacy`,
       {
         method: "POST",
         body: processedParams
@@ -843,6 +849,17 @@ var Agent = class extends BaseResource {
    * @returns Promise containing the enhanced Response object with processDataStream method
    */
   async stream(params) {
+    console.warn(
+      "Deprecation NOTICE:\nStream method will switch to use streamVNext implementation September 16th. Please use streamLegacy if you don't want to upgrade just yet."
+    );
+    return this.streamLegacy(params);
+  }
+  /**
+   * Streams a response from the agent
+   * @param params - Stream parameters including prompt
+   * @returns Promise containing the enhanced Response object with processDataStream method
+   */
+  async streamLegacy(params) {
     const processedParams = {
       ...params,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
@@ -1257,7 +1274,7 @@ var Agent = class extends BaseResource {
    * Processes the stream response and handles tool calls
    */
   async processStreamResponse(processedParams, writable) {
-    const response = await this.request(`/api/agents/${this.agentId}/stream`, {
+    const response = await this.request(`/api/agents/${this.agentId}/stream-legacy`, {
       method: "POST",
       body: processedParams,
       stream: true
@@ -2253,6 +2270,369 @@ var MCPTool = class extends BaseResource {
   }
 };
 
+// src/resources/agent-builder.ts
+var RECORD_SEPARATOR3 = "";
+var AgentBuilder = class extends BaseResource {
+  constructor(options, actionId) {
+    super(options);
+    this.actionId = actionId;
+  }
+  // Helper function to transform workflow result to action result
+  transformWorkflowResult(result) {
+    if (result.status === "success") {
+      return {
+        success: result.result.success || false,
+        applied: result.result.applied || false,
+        branchName: result.result.branchName,
+        message: result.result.message || "Agent builder action completed",
+        validationResults: result.result.validationResults,
+        error: result.result.error,
+        errors: result.result.errors,
+        stepResults: result.result.stepResults
+      };
+    } else if (result.status === "failed") {
+      return {
+        success: false,
+        applied: false,
+        message: `Agent builder action failed: ${result.error.message}`,
+        error: result.error.message
+      };
+    } else {
+      return {
+        success: false,
+        applied: false,
+        message: "Agent builder action was suspended",
+        error: "Workflow suspended - manual intervention required"
+      };
+    }
+  }
+  /**
+   * Creates a new agent builder action run and returns the runId.
+   * This calls `/api/agent-builder/:actionId/create-run`.
+   */
+  async createRun(params, runId) {
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...actionParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/create-run${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    return this.request(url, {
+      method: "POST",
+      body: { ...actionParams, runtimeContext }
+    });
+  }
+  /**
+   * Starts agent builder action asynchronously and waits for completion.
+   * This calls `/api/agent-builder/:actionId/start-async`.
+   */
+  async startAsync(params, runId) {
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...actionParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/start-async${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    const result = await this.request(url, {
+      method: "POST",
+      body: { ...actionParams, runtimeContext }
+    });
+    return this.transformWorkflowResult(result);
+  }
+  /**
+   * Starts an existing agent builder action run.
+   * This calls `/api/agent-builder/:actionId/start`.
+   */
+  async startActionRun(params, runId) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("runId", runId);
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...actionParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/start?${searchParams.toString()}`;
+    return this.request(url, {
+      method: "POST",
+      body: { ...actionParams, runtimeContext }
+    });
+  }
+  /**
+   * Resumes a suspended agent builder action step.
+   * This calls `/api/agent-builder/:actionId/resume`.
+   */
+  async resume(params, runId) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("runId", runId);
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...resumeParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/resume?${searchParams.toString()}`;
+    return this.request(url, {
+      method: "POST",
+      body: { ...resumeParams, runtimeContext }
+    });
+  }
+  /**
+   * Resumes a suspended agent builder action step asynchronously.
+   * This calls `/api/agent-builder/:actionId/resume-async`.
+   */
+  async resumeAsync(params, runId) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("runId", runId);
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...resumeParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/resume-async?${searchParams.toString()}`;
+    const result = await this.request(url, {
+      method: "POST",
+      body: { ...resumeParams, runtimeContext }
+    });
+    return this.transformWorkflowResult(result);
+  }
+  /**
+   * Creates an async generator that processes a readable stream and yields action records
+   * separated by the Record Separator character (\x1E)
+   *
+   * @param stream - The readable stream to process
+   * @returns An async generator that yields parsed records
+   */
+  async *streamProcessor(stream) {
+    const reader = stream.getReader();
+    let doneReading = false;
+    let buffer = "";
+    try {
+      while (!doneReading) {
+        const { done, value } = await reader.read();
+        doneReading = done;
+        if (done && !value) continue;
+        try {
+          const decoded = value ? new TextDecoder().decode(value) : "";
+          const chunks = (buffer + decoded).split(RECORD_SEPARATOR3);
+          buffer = chunks.pop() || "";
+          for (const chunk of chunks) {
+            if (chunk) {
+              if (typeof chunk === "string") {
+                try {
+                  const parsedChunk = JSON.parse(chunk);
+                  yield parsedChunk;
+                } catch {
+                }
+              }
+            }
+          }
+        } catch {
+        }
+      }
+      if (buffer) {
+        try {
+          yield JSON.parse(buffer);
+        } catch {
+        }
+      }
+    } finally {
+      reader.cancel().catch(() => {
+      });
+    }
+  }
+  /**
+   * Streams agent builder action progress in real-time.
+   * This calls `/api/agent-builder/:actionId/stream`.
+   */
+  async stream(params, runId) {
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...actionParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/stream${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    const response = await this.request(url, {
+      method: "POST",
+      body: { ...actionParams, runtimeContext },
+      stream: true
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to stream agent builder action: ${response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    let failedChunk = void 0;
+    const transformStream = new TransformStream({
+      start() {
+      },
+      async transform(chunk, controller) {
+        try {
+          const decoded = new TextDecoder().decode(chunk);
+          const chunks = decoded.split(RECORD_SEPARATOR3);
+          for (const chunk2 of chunks) {
+            if (chunk2) {
+              const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
+              try {
+                const parsedChunk = JSON.parse(newChunk);
+                controller.enqueue(parsedChunk);
+                failedChunk = void 0;
+              } catch {
+                failedChunk = newChunk;
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    });
+    return response.body.pipeThrough(transformStream);
+  }
+  /**
+   * Streams agent builder action progress in real-time using VNext streaming.
+   * This calls `/api/agent-builder/:actionId/streamVNext`.
+   */
+  async streamVNext(params, runId) {
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
+    const { runtimeContext: _, ...actionParams } = params;
+    const url = `/api/agent-builder/${this.actionId}/streamVNext${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    const response = await this.request(url, {
+      method: "POST",
+      body: { ...actionParams, runtimeContext },
+      stream: true
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to stream agent builder action VNext: ${response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    let failedChunk = void 0;
+    const transformStream = new TransformStream({
+      start() {
+      },
+      async transform(chunk, controller) {
+        try {
+          const decoded = new TextDecoder().decode(chunk);
+          const chunks = decoded.split(RECORD_SEPARATOR3);
+          for (const chunk2 of chunks) {
+            if (chunk2) {
+              const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
+              try {
+                const parsedChunk = JSON.parse(newChunk);
+                controller.enqueue(parsedChunk);
+                failedChunk = void 0;
+              } catch {
+                failedChunk = newChunk;
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    });
+    return response.body.pipeThrough(transformStream);
+  }
+  /**
+   * Watches an existing agent builder action run by runId.
+   * This is used for hot reload recovery - it loads the existing run state
+   * and streams any remaining progress.
+   * This calls `/api/agent-builder/:actionId/watch`.
+   */
+  async watch({ runId }, onRecord) {
+    const url = `/api/agent-builder/${this.actionId}/watch?runId=${runId}`;
+    const response = await this.request(url, {
+      method: "GET",
+      stream: true
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to watch agent builder action: ${response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    for await (const record of this.streamProcessor(response.body)) {
+      if (typeof record === "string") {
+        onRecord(JSON.parse(record));
+      } else {
+        onRecord(record);
+      }
+    }
+  }
+  /**
+   * Gets a specific action run by its ID.
+   * This calls `/api/agent-builder/:actionId/runs/:runId`.
+   */
+  async runById(runId) {
+    const url = `/api/agent-builder/${this.actionId}/runs/${runId}`;
+    return this.request(url, {
+      method: "GET"
+    });
+  }
+  /**
+   * Gets details about this agent builder action.
+   * This calls `/api/agent-builder/:actionId`.
+   */
+  async details() {
+    const result = await this.request(`/api/agent-builder/${this.actionId}`);
+    return result;
+  }
+  /**
+   * Gets all runs for this agent builder action.
+   * This calls `/api/agent-builder/:actionId/runs`.
+   */
+  async runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit !== void 0) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset !== void 0) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    const url = `/api/agent-builder/${this.actionId}/runs${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
+    return this.request(url, {
+      method: "GET"
+    });
+  }
+  /**
+   * Gets the execution result of an agent builder action run.
+   * This calls `/api/agent-builder/:actionId/runs/:runId/execution-result`.
+   */
+  async runExecutionResult(runId) {
+    const url = `/api/agent-builder/${this.actionId}/runs/${runId}/execution-result`;
+    return this.request(url, {
+      method: "GET"
+    });
+  }
+  /**
+   * Cancels an agent builder action run.
+   * This calls `/api/agent-builder/:actionId/runs/:runId/cancel`.
+   */
+  async cancelRun(runId) {
+    const url = `/api/agent-builder/${this.actionId}/runs/${runId}/cancel`;
+    return this.request(url, {
+      method: "POST"
+    });
+  }
+  /**
+   * Sends an event to an agent builder action run.
+   * This calls `/api/agent-builder/:actionId/runs/:runId/send-event`.
+   */
+  async sendRunEvent(params) {
+    const url = `/api/agent-builder/${this.actionId}/runs/${params.runId}/send-event`;
+    return this.request(url, {
+      method: "POST",
+      body: { event: params.event, data: params.data }
+    });
+  }
+};
+
 // src/resources/observability.ts
 var Observability = class extends BaseResource {
   constructor(options) {
@@ -2364,7 +2744,7 @@ var NetworkMemoryThread = class extends BaseResource {
 };
 
 // src/resources/vNextNetwork.ts
-var RECORD_SEPARATOR3 = "";
+var RECORD_SEPARATOR4 = "";
 var VNextNetwork = class extends BaseResource {
   constructor(options, networkId) {
     super(options);
@@ -2416,7 +2796,7 @@ var VNextNetwork = class extends BaseResource {
         if (done && !value) continue;
         try {
           const decoded = value ? new TextDecoder().decode(value) : "";
-          const chunks = (buffer + decoded).split(RECORD_SEPARATOR3);
+          const chunks = (buffer + decoded).split(RECORD_SEPARATOR4);
           buffer = chunks.pop() || "";
           for (const chunk of chunks) {
             if (chunk) {
@@ -2667,6 +3047,20 @@ var MastraClient = class extends BaseResource {
   getWorkflow(workflowId) {
     return new Workflow(this.options, workflowId);
   }
+  /**
+   * Gets all available agent builder actions
+   * @returns Promise containing map of action IDs to action details
+   */
+  getAgentBuilderActions() {
+    return this.request("/api/agent-builder/");
+  }
+  /**
+   * Gets an agent builder instance for executing agent-builder workflows
+   * @returns AgentBuilder instance
+   */
+  getAgentBuilderAction(actionId) {
+    return new AgentBuilder(this.options, actionId);
+  }
   /**
    * Gets a vector instance by name
    * @param vectorName - Name of the vector to retrieve