@mastra/client-js 1.56.0-alpha.11 → 1.56.0-alpha.12

package/dist/index.js

@@ -7896,6 +7896,77 @@ var MastraClient = class extends BaseResource {
 		});
 	}
 	/**
+	* Lists the event types an MCP server declares (experimental).
+	* `testEmit` is true when the server serves {@link emitMcpServerEvent} (under `mastra dev`).
+	* @param serverId - The ID of the MCP server.
+	*/
+	getMcpServerEvents(serverId) {
+		return this.request(`/mcp/${encodeURIComponent(serverId)}/events`);
+	}
+	/**
+	* Reads occurrences of an MCP server event type, like the `events/poll` MCP request (experimental).
+	* Pass the returned `cursor` to the next call to resume.
+	* @param serverId - The ID of the MCP server.
+	* @param eventName - The event type name.
+	* @param body - Event arguments, resume cursor and page size.
+	*/
+	pollMcpServerEvent(serverId, eventName, body = {}) {
+		return this.request(`/mcp/${encodeURIComponent(serverId)}/events/${encodeURIComponent(eventName)}/poll`, {
+			method: "POST",
+			body
+		});
+	}
+	/**
+	* Streams occurrences of a push-capable MCP server event type (experimental).
+	* Yields an `active` frame first, then `event`, `heartbeat` and `error` frames, and ends
+	* when the server ends the stream. Abort `options.signal` or break out of the loop to stop.
+	*
+	* @example
+	* ```typescript
+	* const controller = new AbortController();
+	* for await (const frame of client.streamMcpServerEvent('tickets', 'ticket.created', {}, { signal: controller.signal })) {
+	*   if (frame.type === 'event') console.log(frame.occurrence.data);
+	* }
+	* ```
+	*/
+	async *streamMcpServerEvent(serverId, eventName, body = {}, options = {}) {
+		const response = await this.request(`/mcp/${encodeURIComponent(serverId)}/events/${encodeURIComponent(eventName)}/stream`, {
+			method: "POST",
+			body,
+			stream: true,
+			signal: options.signal,
+			retries: 0
+		});
+		if (!response.body) throw new Error("Response body is null");
+		const reader = response.body.pipeThrough(createSseJsonTransform()).getReader();
+		const cancel = () => void reader.cancel().catch(() => {});
+		options.signal?.addEventListener("abort", cancel, { once: true });
+		try {
+			while (true) {
+				const { value, done } = await reader.read();
+				if (done) return;
+				yield value;
+			}
+		} finally {
+			options.signal?.removeEventListener("abort", cancel);
+			await reader.cancel().catch(() => {});
+		}
+	}
+	/**
+	* Emits a test occurrence of an emit-fed MCP server event type (experimental).
+	* Only served under `mastra dev`; other servers respond 404. The occurrence's
+	* `eventId` starts with `mastra-test-`.
+	* @param serverId - The ID of the MCP server.
+	* @param eventName - The event type name.
+	* @param data - The event payload; validated against the event's payload schema.
+	*/
+	emitMcpServerEvent(serverId, eventName, data) {
+		return this.request(`/mcp/${encodeURIComponent(serverId)}/events/${encodeURIComponent(eventName)}/emit`, {
+			method: "POST",
+			body: { data }
+		});
+	}
+	/**
 	* Gets an A2A client for interacting with an agent via the A2A protocol
 	* @param agentId - ID of the agent to interact with
 	* @returns A2A client instance