@mastra/mcp 2.5.0-alpha.2 → 2.5.0

package/dist/client/actions/events.d.ts

@@ -0,0 +1,66 @@
+import type { IMastraLogger } from '@mastra/core/logger';
+import type { EventDescriptor } from '../../shared/events/index.js';
+import type { InternalMastraMCPClient } from '../client.js';
+import type { MCPEventSubscribeOptions, MCPEventSubscription } from '../events/types.js';
+interface EventClientActionsConfig {
+    client: InternalMastraMCPClient;
+    logger: IMastraLogger;
+}
+/**
+ * Client-side actions for the MCP Events extension (SEP-3415): discover event types and
+ * subscribe to their occurrences.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare class EventClientActions {
+    private readonly client;
+    private readonly logger;
+    private descriptors?;
+    /**
+     * @internal
+     */
+    constructor({ client, logger }: EventClientActionsConfig);
+    /**
+     * Lists the event types the server offers, following pagination.
+     *
+     * Changes to the list are not announced yet (`notifications/events/list_changed` needs
+     * `subscriptions/listen` support that `@modelcontextprotocol/*` 2.2.0 lacks); call `list()`
+     * again to pick up new event types.
+     *
+     * @throws {MastraError} `MCP_EVENTS_NOT_SUPPORTED` if the server does not advertise the events extension.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    list(): Promise<EventDescriptor[]>;
+    /**
+     * Subscribes to an event type. Resolves once the server has accepted the subscription, so
+     * invalid arguments or unknown events reject here.
+     *
+     * @param name - Event name from {@link list}
+     * @param args - Subscription arguments, validated by the server against the event's `inputSchema`
+     * @param options - Delivery, resume and retry settings
+     *
+     * @example
+     * ```typescript
+     * const sub = await client.events.subscribe('github.push', { repo: 'mastra-ai/mastra' });
+     * for await (const event of sub) {
+     *   console.log(event.eventId, event.data);
+     *   await saveCursor(sub.cursor);
+     * }
+     * ```
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    subscribe(name: string, args?: Record<string, unknown>, options?: MCPEventSubscribeOptions): Promise<MCPEventSubscription>;
+    /**
+     * Drops the cached event descriptors.
+     *
+     * @internal
+     */
+    invalidate(): void;
+    private assertSupported;
+    private findDescriptor;
+    private fetchDescriptors;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/client/actions/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/client/actions/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAMzD,OAAO,KAAK,EAAwB,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAyB5G,UAAU,wBAAwB;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,WAAW,CAAC,CAA6B;IAEjD;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,wBAAwB,EAGvD;IAED;;;;;;;;;;OAUG;IACU,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAQ9C;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACU,SAAS,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;IAED;;;;OAIG;IACI,UAAU,IAAI,IAAI,CAExB;IAED,OAAO,CAAC,eAAe;YAST,cAAc;YAYd,gBAAgB;CAuB/B"}

package/dist/client/client.d.ts

@@ -1,10 +1,15 @@
 import type { Stream } from 'node:stream';
 import { MastraBase } from '@mastra/core/base';
+import { MastraError } from '@mastra/core/error';
 import type { Tool } from '@mastra/core/tools';
 import type { GetPromptResult, ListPromptsResult, ListResourcesResult, ListResourceTemplatesResult, ReadResourceResult } from '@modelcontextprotocol/client';
+import type { EventsCapability, ListEventsResult, PollEventsRequestParams, PollEventsResult, SubscribeEventsRequestParams, SubscribeEventsResult, UnsubscribeEventsRequestParams } from '../shared/events/index.js';
+import { EventClientActions } from './actions/events.js';
 import { ProgressClientActions } from './actions/progress.js';
 import { PromptClientActions } from './actions/prompt.js';
 import { ResourceClientActions } from './actions/resource.js';
+import type { DeliveryDriver } from './events/mode.js';
+import type { EventsWebhookSetup, MCPEventSubscribeOptions, MCPEventSubscription } from './events/types.js';
 import type { ProgressHandler, InternalMastraMCPClientOptions, MCPServerImplementation, SerializableMCPToolDefinition } from './types.js';
 export type { LoggingLevel, LogMessage, LogHandler, ProgressHandler, MastraFetchLike, MastraMCPServerDefinition, MCPClientCapabilities, MCPClientProtocolVersion, MCPInputRequest, MCPInputRequestHandler, InternalMastraMCPClientOptions, RequireToolApproval, RequireToolApprovalFn, RequireToolApprovalContext, SerializableMCPToolDefinition, } from './types.js';
 /**
@@ -89,10 +94,16 @@ export declare class InternalMastraMCPClient extends MastraBase {
     readonly prompts: PromptClientActions;
     /** Provides access to progress operations (notifications) */
     readonly progress: ProgressClientActions;
+    /**
+     * Provides access to MCP Events (list, subscribe, list-changed notifications).
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    readonly events: EventClientActions;
     /**
      * @internal
      */
-    constructor({ name, version, clientInfo, server, timeout, }: InternalMastraMCPClientOptions);
+    constructor({ name, version, clientInfo, server, timeout, webhook, }: InternalMastraMCPClientOptions);
     /**
      * Log a message at the specified level
      */
@@ -161,6 +172,13 @@ export declare class InternalMastraMCPClient extends MastraBase {
     private subscriptionStream?;
     private subscriptionUpdate;
     private lifecycleGeneration;
+    private readonly eventStreamRouter;
+    private onEventStreamSent?;
+    private readonly noteEventStreamSent;
+    /** Live MCP Events subscriptions, restored after a reconnect and cancelled on disconnect. */
+    private readonly eventSubscriptions;
+    /** Webhook settings and receiver shared with the owning `MCPClient`, when configured. */
+    readonly webhook?: EventsWebhookSetup;
     /**
      * Connects to the MCP server using the configured transport.
      *
@@ -247,6 +265,50 @@ export declare class InternalMastraMCPClient extends MastraBase {
     }) => void): void;
     setResourceListChangedNotificationHandler(handler: () => void): Promise<void>;
     setProgressNotificationHandler(handler: ProgressHandler): void;
+    /**
+     * The server's MCP Events capability, or `undefined` when it does not advertise the extension.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    getEventsCapability(): EventsCapability | undefined;
+    /**
+     * Fetches one page of `events/list`.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    listEvents(cursor?: string): Promise<ListEventsResult>;
+    /**
+     * Sends one `events/poll` request.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    pollEvents(params: PollEventsRequestParams, signal?: AbortSignal): Promise<PollEventsResult>;
+    /**
+     * Sends one `events/subscribe` request (webhook delivery).
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    subscribeEvents(params: SubscribeEventsRequestParams, signal?: AbortSignal): Promise<SubscribeEventsResult>;
+    /**
+     * Sends one `events/unsubscribe` request (webhook delivery).
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    unsubscribeEvents(params: UnsubscribeEventsRequestParams): Promise<void>;
+    /**
+     * Starts a subscription driven by `driver` and tracks it so reconnects restore it.
+     *
+     * @internal
+     */
+    startEventSubscription(config: {
+        name: string;
+        arguments?: Record<string, unknown>;
+        driver: DeliveryDriver;
+        options?: MCPEventSubscribeOptions;
+        notice?: MastraError;
+    }): Promise<MCPEventSubscription>;
+    private cancelEventSubscriptions;
+    private readonly eventsPort;
     private getJsonSchemaValidator;
     private convertInputSchema;
     /**

package/dist/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}

package/dist/client/configuration.d.ts

@@ -5,6 +5,7 @@ import type { Tool } from '@mastra/core/tools';
 import type { ProgressNotification, Prompt, Resource, ResourceTemplateType } from '@modelcontextprotocol/client';
 import type { MastraMCPServerDefinition, MCPServerAuthState } from './client.js';
 import type { MCPDiscoveryErrorDetails } from './error-utils.js';
+import type { MCPClientWebhookOptions, MCPEventDescriptor, MCPEventSubscribeOptions, MCPEventSubscription } from './events/index.js';
 import type { MCPClientInfo, MCPServerImplementation, SerializableMCPToolCatalog, SerializableMCPToolDefinition } from './types.js';
 /** Options for aggregate discovery across configured MCP servers. */
 export interface MCPDiscoveryOptions {
@@ -26,6 +27,13 @@ export interface MCPClientOptions {
      * Per-server `clientInfo` overrides it field-wise. Defaults to the server key and `'1.0.0'`.
      */
     clientInfo?: MCPClientInfo;
+    /**
+     * Webhook delivery for MCP Events. Servers that offer webhook delivery POST occurrences to
+     * `webhook.url`, which must route to {@link MCPClient.events}`.handleWebhook()`.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    webhook?: MCPClientWebhookOptions;
 }
 /**
  * Manages Model Context Protocol (MCP) server connections and tool namespacing,
@@ -58,6 +66,7 @@ export declare class MCPClient extends MastraBase {
     private id;
     private defaultTimeout;
     private defaultClientInfo?;
+    private webhook?;
     private mcpClientsById;
     private disconnectPromise;
     private authFlowsByServer;
@@ -120,6 +129,46 @@ export declare class MCPClient extends MastraBase {
     get progress(): {
         onUpdate: (serverName: string, handler: (params: ProgressNotification['params']) => void) => Promise<void>;
     };
+    /**
+     * Provides access to MCP Events (SEP-3415) on configured servers: list event types and
+     * subscribe to their occurrences over webhook (when `webhook` is configured), push or poll
+     * delivery.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     *
+     * @example
+     * ```typescript
+     * const events = await mcp.events.list('github');
+     * const sub = await mcp.events.subscribe('github', 'push', { repo: 'mastra-ai/mastra' });
+     * for await (const event of sub) {
+     *   console.log(event.eventId, event.data);
+     *   await saveCursor(sub.cursor);
+     * }
+     * ```
+     */
+    get events(): {
+        /**
+         * Lists the event types a server offers. Changes are not announced yet; call it again to refresh.
+         *
+         * @throws {MastraError} `MCP_CLIENT_LIST_EVENTS_FAILED`; the cause is `MCP_EVENTS_NOT_SUPPORTED`
+         * when the server does not advertise the events extension.
+         */
+        list: (serverName: string) => Promise<MCPEventDescriptor[]>;
+        /**
+         * Subscribes to an event type on a server. Resolves once the server accepted the subscription.
+         *
+         * @throws {MastraError} `MCP_CLIENT_SUBSCRIBE_EVENT_FAILED`; the cause carries the events error id.
+         */
+        subscribe: (serverName: string, eventName: string, args?: Record<string, unknown>, options?: MCPEventSubscribeOptions) => Promise<MCPEventSubscription>;
+        /**
+         * Handles a webhook delivery POSTed to `webhook.url`: verifies the signature, answers the
+         * server's verification handshake, and routes occurrences to their subscription. Mount it
+         * on the route that `webhook.url` points at. Returns 404 when `webhook` is not configured.
+         *
+         * @experimental SEP-3415 is a draft; this API may change.
+         */
+        handleWebhook: (request: Request) => Promise<Response>;
+    };
     /**
      * Provides access to resource-related operations across all configured servers.
      *

package/dist/client/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/client/configuration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/client/configuration.ts"],"names":[],"mappings":"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"}

package/dist/client/events/errors.d.ts

@@ -0,0 +1,13 @@
+import { MastraError } from '@mastra/core/error';
+import { ProtocolError } from '@modelcontextprotocol/client';
+type Details = Record<string, string | number | boolean | null>;
+export declare function eventsError(id: Uppercase<string>, text: string, details?: Details, cause?: unknown): MastraError;
+/** A JSON-RPC error that means the subscription itself is invalid, so retrying cannot help. */
+export declare function isNonRetryable(error: unknown): error is ProtocolError;
+export declare function isFatal(error: unknown): boolean;
+/** Normalizes a failure that ends the subscription. */
+export declare function toFatalError(error: unknown, details: Details): MastraError;
+/** Normalizes a failure the subscription recovers from. */
+export declare function toTransientError(error: unknown, details: Details): MastraError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/events/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/client/events/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAqB,MAAM,8BAA8B,CAAC;AAGhF,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAEhE,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAY,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAEpH;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKrE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ/C;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAiB1E;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAQ9E"}

package/dist/client/events/index.d.ts

@@ -0,0 +1,3 @@
+export type { MCPClientWebhookOptions, MCPEventDeliveryMode, MCPEventOccurrence, MCPEventRetryOptions, MCPEventSubscribeOptions, MCPEventSubscription, MCPEventSubscriptionError, } from './types.js';
+export type { EventDescriptor as MCPEventDescriptor, WebhookDeliveryStatus as MCPWebhookDeliveryStatus, } from '../../shared/events/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/events/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,IAAI,kBAAkB,EACrC,qBAAqB,IAAI,wBAAwB,GAClD,MAAM,qBAAqB,CAAC"}

package/dist/client/events/mode.d.ts

@@ -0,0 +1,58 @@
+import type { MastraError } from '@mastra/core/error';
+import type { EventOccurrence, WebhookDeliveryStatus } from '../../shared/events/index.js';
+import type { EventsPort, MCPEventDeliveryMode } from './types.js';
+/** Subscription settings with defaults applied. */
+export interface ResolvedDeliveryOptions {
+    maxAgeMs?: number;
+    maxEvents?: number;
+    minPollIntervalMs: number;
+    heartbeatTimeoutMs: number;
+    streamOpenTimeoutMs: number;
+}
+/** What a delivery driver can see and do for one subscription. */
+export interface DeliveryContext {
+    readonly port: EventsPort;
+    readonly name: string;
+    readonly arguments: Record<string, unknown> | undefined;
+    readonly options: ResolvedDeliveryOptions;
+    /** Aborted when the subscription is cancelled. */
+    readonly signal: AbortSignal;
+    /** Cursor to resume from. */
+    readonly cursor: string | null;
+    /** Hands an occurrence to the subscriber (de-duplicated by `eventId`). */
+    deliver(occurrence: EventOccurrence): void;
+    /**
+     * Records the position the server confirmed. An absent cursor is `null`: no replay.
+     * `truncated: true` also records a gap (see {@link markGap}).
+     */
+    setPosition(cursor: string | null | undefined, truncated?: boolean): void;
+    /** Records a server-reported gap before the occurrences that follow it. */
+    markGap(): void;
+    /** Signals that the server accepted the subscription during this session. */
+    established(): void;
+    reportError(error: MastraError): void;
+    /** Webhook only: records the server's latest delivery status for the subscriber. */
+    setDeliveryStatus(status: WebhookDeliveryStatus | undefined): void;
+    /** Waits, resolving early if the subscription is cancelled. */
+    sleep(ms: number): Promise<void>;
+}
+/**
+ * Drives one delivery session. Returning or throwing ends the session; the subscription then
+ * backs off and starts another from the last cursor, unless the error is fatal.
+ */
+export interface DeliveryDriver {
+    readonly mode: MCPEventDeliveryMode;
+    session(context: DeliveryContext): Promise<void>;
+}
+/**
+ * Picks the delivery mode for a subscription from the modes the event descriptor advertises.
+ * Modes this client does not know (from newer SEP revisions) are ignored, and `webhook` is only
+ * eligible when `available.webhook` is set.
+ */
+export declare function selectDeliveryMode(advertised: readonly string[], forced: MCPEventDeliveryMode | undefined, details: {
+    serverName: string;
+    eventName: string;
+}, available?: {
+    webhook?: boolean;
+}): MCPEventDeliveryMode;
+//# sourceMappingURL=mode.d.ts.map

package/dist/client/events/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/client/events/mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEhE,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0EAA0E;IAC1E,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1E,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;IAChB,6EAA6E;IAC7E,WAAW,IAAI,IAAI,CAAC;IACpB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,oFAAoF;IACpF,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAAC;IACnE,+DAA+D;IAC/D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAClD,SAAS,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,oBAAoB,CAyBtB"}

package/dist/client/events/poll-driver.d.ts

@@ -0,0 +1,6 @@
+import type { DeliveryDriver } from './mode.js';
+/** Pages fetched back to back while draining a backlog before the poll floor applies again. */
+export declare const MAX_DRAIN_PAGES = 10;
+/** Delivers a subscription by repeating `events/poll`. A session only ends by throwing. */
+export declare const pollDriver: DeliveryDriver;
+//# sourceMappingURL=poll-driver.d.ts.map

package/dist/client/events/poll-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-driver.d.ts","sourceRoot":"","sources":["../../../src/client/events/poll-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,+FAA+F;AAC/F,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,2FAA2F;AAC3F,eAAO,MAAM,UAAU,EAAE,cAmCxB,CAAC"}

package/dist/client/events/push-driver.d.ts

@@ -0,0 +1,7 @@
+import type { DeliveryDriver } from './mode.js';
+/**
+ * Delivers a subscription over one `events/stream` request. The session ends when the stream
+ * closes, fails, goes silent for `heartbeatTimeoutMs`, or the server terminates it.
+ */
+export declare const pushDriver: DeliveryDriver;
+//# sourceMappingURL=push-driver.d.ts.map

package/dist/client/events/push-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-driver.d.ts","sourceRoot":"","sources":["../../../src/client/events/push-driver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7C;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,cAuFxB,CAAC"}

package/dist/client/events/stream-router.d.ts

@@ -0,0 +1,42 @@
+import type { StreamEventsRequestParams } from '../../shared/events/index.js';
+import type { EventStreamHandle, EventStreamSink, EventsPort } from './types.js';
+/** The transport operations the router needs from the MCP client. */
+export interface EventStreamChannel {
+    /**
+     * Sends `events/stream` and settles when the request ends. Calls `onSent` with the request's
+     * JSON-RPC id when the message goes out on the transport.
+     */
+    request(params: StreamEventsRequestParams, signal: AbortSignal, onSent: (id: string) => void): Promise<unknown>;
+    /** Registers a handler for a notification method; receives the raw `params`. */
+    onNotification(method: string, handler: (params: unknown) => void): void;
+}
+/**
+ * Routes push-stream notifications for one MCP server to the subscription that owns them.
+ *
+ * The server identifies a stream by the JSON-RPC id of its `events/stream` request. The SDK
+ * doesn't return that id, so the channel reports it as the request is sent, and opens are
+ * serialized so the reported id always belongs to the pending open. A pending open binds only to
+ * an `active` carrying its own id; after that, every notification is routed by
+ * `_meta["io.modelcontextprotocol/subscriptionId"]`. A late `active` for an open that timed out,
+ * was aborted, or was released never matches a pending open's id, so it is dropped.
+ */
+export declare class EventStreamRouter {
+    private readonly channel;
+    private readonly log;
+    private readonly sinks;
+    private pending?;
+    private openLock;
+    private listening;
+    constructor(channel: EventStreamChannel, log: EventsPort['log']);
+    /** Opens a stream and resolves once the server confirms it with `notifications/events/active`. */
+    open(params: StreamEventsRequestParams, sink: EventStreamSink, options: {
+        signal: AbortSignal;
+        openTimeoutMs: number;
+    }): Promise<EventStreamHandle>;
+    private release;
+    private acquire;
+    private listen;
+    /** `deliver` returns `false` when no stream owns the id. */
+    private route;
+}
+//# sourceMappingURL=stream-router.d.ts.map

package/dist/client/events/stream-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-router.d.ts","sourceRoot":"","sources":["../../../src/client/events/stream-router.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE9E,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChH,gFAAgF;IAChF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1E;AASD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAO1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,SAAS,CAAS;IAE1B,YACmB,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EACrC;IAEJ,kGAAkG;IAC5F,IAAI,CACR,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,iBAAiB,CAAC,CA4E5B;IAED,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,MAAM;IAiCd,4DAA4D;IAC5D,OAAO,CAAC,KAAK;CAiBd"}

package/dist/client/events/subscription.d.ts

@@ -0,0 +1,118 @@
+import type { MastraError } from '@mastra/core/error';
+import type { WebhookDeliveryStatus } from '../../shared/events/index.js';
+import type { DeliveryDriver } from './mode.js';
+import type { EventsPort, MCPEventDeliveryMode, MCPEventOccurrence, MCPEventSubscribeOptions, MCPEventSubscription, MCPEventSubscriptionError } from './types.js';
+export interface EventSubscriptionConfig {
+    port: EventsPort;
+    serverName: string;
+    name: string;
+    arguments?: Record<string, unknown>;
+    driver: DeliveryDriver;
+    options?: MCPEventSubscribeOptions;
+    /** Used when `options.streamOpenTimeoutMs` is not set. */
+    defaultStreamOpenTimeoutMs: number;
+    /** Called once, synchronously, when the subscription is created. */
+    onOpen?: (subscription: EventSubscription) => void;
+    /** Called once when the subscription ends for any reason. */
+    onClose?: (subscription: EventSubscription) => void;
+    /** Source of jitter; tests pin it. */
+    random?: () => number;
+    /**
+     * Reported once to the first `onError` handler, or logged as a warning if none is attached by
+     * the time the subscription ends. Used to explain a delivery-mode fallback.
+     */
+    notice?: MastraError;
+}
+/**
+ * A client-side MCP Events subscription: owns the cursor, de-duplication, the occurrence queue and
+ * the retry loop, and delegates the wire work for each session to a {@link DeliveryDriver}.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare class EventSubscription implements MCPEventSubscription {
+    readonly name: string;
+    readonly arguments: Record<string, unknown> | undefined;
+    readonly mode: MCPEventDeliveryMode;
+    /** Latest position the server confirmed; the next request resumes from it. */
+    private resumeCursor;
+    /** Position covering only occurrences already handed to the consumer. */
+    private yieldedCursor;
+    private currentTruncated;
+    /** A gap was reported and the next delivered occurrence is the first one after it. */
+    private pendingGap;
+    private currentDeliveryStatus?;
+    private readonly port;
+    private readonly driver;
+    private readonly resolved;
+    private readonly retry;
+    private readonly random;
+    private readonly details;
+    private readonly onClose?;
+    private readonly abort;
+    private readonly errorHandlers;
+    private notice?;
+    private readonly dedupWindow;
+    private readonly maxBuffered;
+    /** Set when the buffer dropped occurrences; cleared once the consumer catches up. */
+    private overflowing;
+    private readonly seenIds;
+    private readonly seenOrder;
+    /** Undelivered occurrences, each with the position that becomes safe once it is yielded. */
+    private readonly buffer;
+    private readonly waiters;
+    private ending?;
+    private endingDelivered;
+    private detachSignal?;
+    private isEstablished;
+    private sessionHealthy;
+    private resolveReady;
+    private rejectReady;
+    private readonly ready;
+    private loopDone;
+    /** Bumped by {@link onReconnected}; a session that sees it change skips its backoff. */
+    private reconnectEpoch;
+    private wakeBackoff?;
+    private constructor();
+    /** Starts the subscription and resolves once the server has accepted it. */
+    static start(config: EventSubscriptionConfig): Promise<EventSubscription>;
+    get cursor(): string | null;
+    get truncated(): boolean;
+    get deliveryStatus(): WebhookDeliveryStatus | undefined;
+    onError(handler: (error: MCPEventSubscriptionError) => void): () => void;
+    cancel(): Promise<void>;
+    /**
+     * Called by the client after a (re)connect: a subscription waiting out a backoff starts its
+     * next session right away, on the new connection.
+     *
+     * @internal
+     */
+    onReconnected(): void;
+    [Symbol.asyncIterator](): AsyncIterator<MCPEventOccurrence>;
+    private next;
+    private enqueue;
+    /**
+     * Drops the oldest unread occurrence so a server cannot grow the queue without bound, and flags
+     * the occurrence that is now first as following a gap.
+     */
+    private dropOldest;
+    /**
+     * Records a gap reported by the server. `truncated` turns true now if nothing is waiting to be
+     * yielded, and stays true until an occurrence received after the gap has been yielded and the
+     * next one is requested, so a consumer reading it per occurrence sees the gap exactly once.
+     */
+    private markGap;
+    /**
+     * Moves the resume position now, and the public cursor once every occurrence buffered before
+     * this point has been yielded, so a persisted cursor never skips an undelivered occurrence.
+     */
+    private setPosition;
+    private end;
+    private cancelledError;
+    private emitError;
+    private context;
+    /** Resolves after `ms`, on cancel, and (for backoff waits) on {@link onReconnected}. */
+    private sleep;
+    private backoffDelay;
+    private run;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/client/events/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/client/events/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAmB,cAAc,EAA2B,MAAM,QAAQ,CAAC;AACvF,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAMjB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,0DAA0D;IAC1D,0BAA0B,EAAE,MAAM,CAAC;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAOD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,oBAAoB;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAAgB;IACpC,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC,sFAAsF;IACtF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA4C;IAErE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyD;IACvF,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,qFAAqF;IACrF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKd;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,MAAM,CAAC,CAA0B;IACzC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAa;IAElC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAoC;IAEpD,wFAAwF;IACxF,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,OAAO,eA4CN;IAED,4EAA4E;IAC5E,OAAa,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM9E;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,cAAc,IAAI,qBAAqB,GAAG,SAAS,CAEtD;IAED,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GAAG,MAAM,IAAI,CAUvE;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAI5B;IAED;;;;;OAKG;IACH,aAAa,IAAI,IAAI,CAGpB;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAQ1D;IAED,OAAO,CAAC,IAAI;IAkBZ,OAAO,CAAC,OAAO;IAoBf;;;OAGG;IACH,OAAO,CAAC,UAAU;IAkBlB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAKf;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,GAAG;IAqBX,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,OAAO;IAgCf,wFAAwF;IACxF,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,YAAY;YAMN,GAAG;CA2ClB"}