@mastra/client-js 1.15.2-alpha.0 → 1.15.2

package/dist/index.js

@@ -1557,6 +1557,51 @@ var Agent = class extends BaseResource {
     };
     return streamResponse;
   }
+  /**
+   * Observe (reconnect to) an existing agent stream.
+   * Use this to resume receiving events after a disconnection.
+   *
+   * @param params.runId - The run ID to observe
+   * @param params.offset - Optional position to resume from (0-based). If omitted, replays all events.
+   * @returns Promise containing a streaming Response
+   *
+   * @example
+   * ```typescript
+   * // Reconnect to a stream from a specific position
+   * const response = await client.agents('my-agent').observe({
+   *   runId: 'run-123',
+   *   offset: 42, // Resume from event 42
+   * });
+   *
+   * await response.processDataStream({
+   *   onChunk: (chunk) => console.log('Received:', chunk),
+   * });
+   * ```
+   */
+  async observe(params) {
+    const response = await this.request(`/agents/${this.agentId}/observe`, {
+      method: "POST",
+      body: params,
+      stream: true
+    });
+    if (!response.body) {
+      throw new Error("No response body");
+    }
+    const streamResponse = new Response(response.body, {
+      status: response.status,
+      statusText: response.statusText,
+      headers: response.headers
+    });
+    streamResponse.processDataStream = async ({
+      onChunk
+    }) => {
+      await processMastraStream({
+        stream: streamResponse.body,
+        onChunk
+      });
+    };
+    return streamResponse;
+  }
   /**
    * Resumes a suspended agent stream with custom resume data.
    * Used to continue execution after a suspension point (e.g., workflow suspend within an agent).
@@ -2310,19 +2355,32 @@ var Run = class extends BaseResource {
     return response.body.pipeThrough(this.createChunkTransformStream());
   }
   /**
-   * Observes workflow stream for a workflow run
-   * @returns Promise containing the workflow execution results
+   * Observe (reconnect to) an existing workflow stream.
+   * Use this to resume receiving events after a disconnection.
+   *
+   * @param params.offset - Optional position to resume from (0-based). If omitted, replays all events.
+   * @returns Promise containing a ReadableStream of workflow events
+   *
+   * @example
+   * ```typescript
+   * // Reconnect to a workflow stream from a specific position
+   * const stream = await run.observe({ offset: 42 });
+   *
+   * for await (const event of stream) {
+   *   console.log('Received:', event);
+   * }
+   * ```
    */
-  async observeStream() {
+  async observe(params) {
     const searchParams = new URLSearchParams();
     searchParams.set("runId", this.runId);
-    const response = await this.request(
-      `/workflows/${this.workflowId}/observe-stream?${searchParams.toString()}`,
-      {
-        method: "POST",
-        stream: true
-      }
-    );
+    if (params?.offset !== void 0) {
+      searchParams.set("offset", String(params.offset));
+    }
+    const response = await this.request(`/workflows/${this.workflowId}/observe?${searchParams.toString()}`, {
+      method: "POST",
+      stream: true
+    });
     if (!response.ok) {
       throw new Error(`Failed to observe workflow stream: ${response.statusText}`);
     }
@@ -2331,6 +2389,14 @@ var Run = class extends BaseResource {
     }
     return response.body.pipeThrough(this.createChunkTransformStream());
   }
+  /**
+   * Observes workflow stream for a workflow run
+   * @deprecated Use `observe()` instead for better control over replay position
+   * @returns Promise containing the workflow execution results
+   */
+  async observeStream() {
+    return this.observe();
+  }
   /**
    * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
    * @param params - Object containing the step, resumeData and requestContext