@mastra/mcp 2.5.0-alpha.1 → 2.5.0-alpha.2

package/dist/shared/events/capability.d.ts

@@ -0,0 +1,25 @@
+import type { EventsCapability } from './types.js';
+/**
+ * Read the negotiated events extension settings from a capabilities object.
+ * Returns `undefined` when the peer did not advertise the extension (or advertised a malformed entry).
+ *
+ * Only the SEP-3415 `extensions["io.modelcontextprotocol/events"]` form is recognized; the legacy
+ * top-level `capabilities.events` key from pre-SEP prototypes is intentionally ignored.
+ *
+ * @experimental
+ */
+export declare function getEventsCapability(capabilities: {
+    extensions?: Record<string, unknown>;
+} | undefined | null): EventsCapability | undefined;
+/**
+ * Build the `extensions` entry a server advertises when it offers events. The value is plain JSON, so it
+ * can be spread into the SDK's `ServerCapabilities['extensions']`.
+ *
+ * @experimental
+ */
+export declare function eventsCapabilityEntry(settings?: {
+    listChanged?: boolean;
+}): Record<string, {
+    listChanged: boolean;
+} | Record<string, never>>;
+//# sourceMappingURL=capability.d.ts.map

package/dist/shared/events/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../src/shared/events/capability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,GACxE,gBAAgB,GAAG,SAAS,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAElE"}

package/dist/shared/events/constants.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Wire constants for the MCP Events extension (SEP-3415).
+ *
+ * @experimental SEP-3415 is a draft Extensions Track proposal. Names, shapes and error codes may change.
+ */
+/** Extension identifier used as the key under `capabilities.extensions`. */
+export declare const EVENTS_EXTENSION_ID = "io.modelcontextprotocol/events";
+/** `_meta` key that carries the parent `events/stream` request id on push notifications. */
+export declare const EVENTS_SUBSCRIPTION_ID_META_KEY = "io.modelcontextprotocol/subscriptionId";
+export declare const EVENTS_METHODS: {
+    readonly list: 'events/list';
+    readonly poll: 'events/poll';
+    readonly stream: 'events/stream';
+    readonly subscribe: 'events/subscribe';
+    readonly unsubscribe: 'events/unsubscribe';
+};
+export declare const EVENTS_NOTIFICATIONS: {
+    readonly active: 'notifications/events/active';
+    readonly event: 'notifications/events/event';
+    readonly heartbeat: 'notifications/events/heartbeat';
+    readonly error: 'notifications/events/error';
+    readonly terminated: 'notifications/events/terminated';
+    readonly listChanged: 'notifications/events/list_changed';
+};
+export declare const EVENT_DELIVERY_MODES: readonly ['poll', 'push', 'webhook'];
+/**
+ * Error codes defined by SEP-3415. They are provisional until the SEP is accepted, so callers should
+ * surface them rather than branch on them beyond the documented fail-fast set.
+ */
+export declare const EVENTS_ERROR_CODES: {
+    readonly InvalidParams: -32602;
+    readonly NotFound: -32023;
+    readonly Forbidden: -32024;
+    readonly ResourceExhausted: -32025;
+    readonly Unsupported: -32026;
+    readonly CallbackEndpointError: -32027;
+};
+/** Error codes that a client should not retry: the subscription itself is invalid. */
+export declare const EVENTS_NON_RETRYABLE_ERROR_CODES: readonly number[];
+/** Categories allowed in `deliveryStatus.lastError` and `CallbackEndpointError` `data.reason`. */
+export declare const WEBHOOK_FAILURE_REASONS: readonly ['connection_refused', 'timeout', 'tls_error', 'http_4xx', 'http_5xx', 'challenge_failed'];
+/** Headers present on every webhook delivery (Standard Webhooks plus the MCP routing header). */
+export declare const WEBHOOK_HEADERS: {
+    readonly id: 'webhook-id';
+    readonly timestamp: 'webhook-timestamp';
+    readonly signature: 'webhook-signature';
+    readonly subscriptionId: 'x-mcp-subscription-id';
+};
+/** Servers SHOULD send a push heartbeat at least this often. */
+export declare const DEFAULT_EVENTS_HEARTBEAT_INTERVAL_MS = 30000;
+/** Default floor clients apply to `nextPollMs` so a misbehaving server cannot induce a tight loop. */
+export declare const DEFAULT_MIN_POLL_INTERVAL_MS = 1000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/events/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/events/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,mCAAmC,CAAC;AAEpE,4FAA4F;AAC5F,eAAO,MAAM,+BAA+B,2CAA2C,CAAC;AAExF,eAAO,MAAM,cAAc;aACzB,IAAI,EAAE,aAAa;aACnB,IAAI,EAAE,aAAa;aACnB,MAAM,EAAE,eAAe;aACvB,SAAS,EAAE,kBAAkB;aAC7B,WAAW,EAAE,oBAAoB;CACzB,CAAC;AAEX,eAAO,MAAM,oBAAoB;aAC/B,MAAM,EAAE,6BAA6B;aACrC,KAAK,EAAE,4BAA4B;aACnC,SAAS,EAAE,gCAAgC;aAC3C,KAAK,EAAE,4BAA4B;aACnC,UAAU,EAAE,iCAAiC;aAC7C,WAAW,EAAE,mCAAmC;CACxC,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAAI,MAAM,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;aAC7B,aAAa,EAAE,CAAC,KAAK;aACrB,QAAQ,EAAE,CAAC,KAAK;aAChB,SAAS,EAAE,CAAC,KAAK;aACjB,iBAAiB,EAAE,CAAC,KAAK;aACzB,WAAW,EAAE,CAAC,KAAK;aACnB,qBAAqB,EAAE,CAAC,KAAK;CACrB,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,gCAAgC,EAAE,SAAS,MAAM,EAK7D,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,YAClC,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,kBAAkB,CACV,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,eAAe;aAC1B,EAAE,EAAE,YAAY;aAChB,SAAS,EAAE,mBAAmB;aAC9B,SAAS,EAAE,mBAAmB;aAC9B,cAAc,EAAE,uBAAuB;CAC/B,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D,sGAAsG;AACtG,eAAO,MAAM,4BAA4B,OAAQ,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './constants.js';
+export * from './schemas.js';
+export * from './capability.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,mBAAmB,SAAS,CAAC"}

package/dist/shared/events/schemas.d.ts

@@ -0,0 +1,356 @@
+/**
+ * Zod schemas for the MCP Events extension (SEP-3415) wire format.
+ *
+ * Parsing is deliberately loose: objects tolerate unknown fields and `resultType` is optional, so that
+ * revisions of the draft SEP that add fields do not break existing peers.
+ *
+ * @experimental SEP-3415 is a draft Extensions Track proposal. Shapes may change.
+ */
+import { z } from 'zod/v4';
+/** `capabilities.extensions["io.modelcontextprotocol/events"]` settings object. */
+export declare const EventsCapabilitySchema: z.ZodObject<{
+    listChanged: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const EventDeliveryModeSchema: z.ZodEnum<{
+    poll: "poll";
+    push: "push";
+    webhook: "webhook";
+}>;
+export declare const EventDescriptorSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    delivery: z.ZodArray<z.ZodString>;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const EventOccurrenceSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    name: z.ZodString;
+    timestamp: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const EventsErrorSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>;
+export declare const ListEventsRequestParamsSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const ListEventsRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"events/list">;
+    params: z.ZodOptional<z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export declare const ListEventsResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodString>;
+    events: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        delivery: z.ZodArray<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const PollEventsRequestParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxAgeMs: z.ZodOptional<z.ZodNumber>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    maxEvents: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export declare const PollEventsRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"events/poll">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxAgeMs: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        maxEvents: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const PollEventsResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodString>;
+    events: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodString;
+        name: z.ZodString;
+        timestamp: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+    nextPollMs: z.ZodOptional<z.ZodNumber>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const StreamEventsRequestParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxAgeMs: z.ZodOptional<z.ZodNumber>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const StreamEventsRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"events/stream">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxAgeMs: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const StreamEventsResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** `_meta` on every `notifications/events/*` message delivered on a push stream. */
+export declare const StreamNotificationMetaSchema: z.ZodObject<{
+    "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$loose>;
+export declare const EventActiveNotificationParamsSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    _meta: z.ZodObject<{
+        "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const EventNotificationParamsSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    name: z.ZodString;
+    timestamp: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    _meta: z.ZodObject<{
+        "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const EventHeartbeatNotificationParamsSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    _meta: z.ZodObject<{
+        "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const EventErrorNotificationParamsSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+    _meta: z.ZodObject<{
+        "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const EventTerminatedNotificationParamsSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+    _meta: z.ZodObject<{
+        "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const EventsListChangedNotificationParamsSchema: z.ZodOptional<z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>>;
+export declare const EventActiveNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/active">;
+    params: z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+        _meta: z.ZodObject<{
+            "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const EventNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/event">;
+    params: z.ZodObject<{
+        eventId: z.ZodString;
+        name: z.ZodString;
+        timestamp: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        _meta: z.ZodObject<{
+            "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const EventHeartbeatNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/heartbeat">;
+    params: z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        _meta: z.ZodObject<{
+            "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const EventErrorNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/error">;
+    params: z.ZodObject<{
+        error: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$loose>;
+        _meta: z.ZodObject<{
+            "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const EventTerminatedNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/terminated">;
+    params: z.ZodObject<{
+        error: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$loose>;
+        _meta: z.ZodObject<{
+            "io.modelcontextprotocol/subscriptionId": z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const EventsListChangedNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"notifications/events/list_changed">;
+    params: z.ZodOptional<z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+/** Standard Webhooks symmetric secret: `whsec_` + base64 of 24 to 64 random bytes. */
+export declare const WebhookSecretSchema: z.ZodString;
+export declare const WebhookDeliverySchema: z.ZodObject<{
+    mode: z.ZodLiteral<"webhook">;
+    url: z.ZodString;
+    secret: z.ZodString;
+}, z.core.$loose>;
+export declare const SubscribeEventsRequestParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxAgeMs: z.ZodOptional<z.ZodNumber>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    delivery: z.ZodObject<{
+        mode: z.ZodLiteral<"webhook">;
+        url: z.ZodString;
+        secret: z.ZodString;
+    }, z.core.$loose>;
+    ttlMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$loose>;
+export declare const SubscribeEventsRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"events/subscribe">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxAgeMs: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        delivery: z.ZodObject<{
+            mode: z.ZodLiteral<"webhook">;
+            url: z.ZodString;
+            secret: z.ZodString;
+        }, z.core.$loose>;
+        ttlMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const WebhookFailureReasonSchema: z.ZodString;
+export declare const WebhookDeliveryStatusSchema: z.ZodObject<{
+    active: z.ZodBoolean;
+    lastDeliveryAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failedSince: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    throttled: z.ZodOptional<z.ZodBoolean>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export declare const SubscribeEventsResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    refreshBefore: z.ZodNullable<z.ZodString>;
+    cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    deliveryStatus: z.ZodOptional<z.ZodObject<{
+        active: z.ZodBoolean;
+        lastDeliveryAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        failedSince: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        throttled: z.ZodOptional<z.ZodBoolean>;
+        retryAfterMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const UnsubscribeEventsRequestParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    delivery: z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$loose>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const UnsubscribeEventsRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"events/unsubscribe">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        delivery: z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$loose>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const UnsubscribeEventsResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const WebhookGapBodySchema: z.ZodObject<{
+    type: z.ZodLiteral<"gap">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>;
+export declare const WebhookTerminatedBodySchema: z.ZodObject<{
+    type: z.ZodLiteral<"terminated">;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const WebhookVerificationBodySchema: z.ZodObject<{
+    type: z.ZodLiteral<"verification">;
+    challenge: z.ZodString;
+}, z.core.$loose>;
+export declare const WebhookControlBodySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"gap">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>, z.ZodObject<{
+    type: z.ZodLiteral<"terminated">;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+}, z.core.$loose>, z.ZodObject<{
+    type: z.ZodLiteral<"verification">;
+    challenge: z.ZodString;
+}, z.core.$loose>], "type">;
+/** A body with a top-level `type` field is a control envelope; otherwise it is an occurrence. */
+export declare function parseWebhookBody(body: unknown): {
+    kind: 'event';
+    event: z.infer<typeof EventOccurrenceSchema>;
+} | {
+    kind: 'control';
+    control: z.infer<typeof WebhookControlBodySchema>;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/shared/events/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/shared/events/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAc3B,mFAAmF;AACnF,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;EAA+B,CAAC;AAEpE,eAAO,MAAM,qBAAqB;;;;;;;iBAQhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAIH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAKjC,CAAC;AAYH,eAAO,MAAM,6BAA6B;;;;;;;iBAGxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAQjC,CAAC;AAIH,eAAO,MAAM,+BAA+B;;;;;;iBAAyC,CAAC;AAEtF,eAAO,MAAM,yBAAyB;;;;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,4BAA4B;;iBAEvC,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;;iBAI9C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;iBAExC,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;iBAGjD,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;iBAG7C,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;;;;;;iBAAqC,CAAC;AAE1F,eAAO,MAAM,yCAAyC;;kBAAkD,CAAC;AAEzG,eAAO,MAAM,6BAA6B;;;;;;;;;iBAGxC,CAAC;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAGlC,CAAC;AACH,eAAO,MAAM,gCAAgC;;;;;;;;iBAG3C,CAAC;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;iBAGvC,CAAC;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;iBAG5C,CAAC;AACH,eAAO,MAAM,mCAAmC;;;;;iBAG9C,CAAC;AAIH,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,aAW7B,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;iBAK7C,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAGvC,CAAC;AAEH,eAAO,MAAM,0BAA0B,aAAa,CAAC;AAErD,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;iBAQtC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;iBAK/C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAIH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;2BAInC,CAAC;AAEH,iGAAiG;AACjG,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GAEX;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;CAAE,CAKzE"}

package/dist/shared/events/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Types for the MCP Events extension (SEP-3415) wire format.
+ *
+ * @experimental SEP-3415 is a draft Extensions Track proposal. Shapes may change.
+ */
+import type { z } from 'zod/v4';
+import type { EVENT_DELIVERY_MODES, EVENTS_ERROR_CODES, WEBHOOK_FAILURE_REASONS } from './constants.js';
+import type { EventActiveNotificationParamsSchema, EventDescriptorSchema, EventErrorNotificationParamsSchema, EventHeartbeatNotificationParamsSchema, EventNotificationParamsSchema, EventOccurrenceSchema, EventsCapabilitySchema, EventsErrorSchema, EventTerminatedNotificationParamsSchema, ListEventsRequestParamsSchema, ListEventsResultSchema, PollEventsRequestParamsSchema, PollEventsResultSchema, StreamEventsRequestParamsSchema, StreamEventsResultSchema, SubscribeEventsRequestParamsSchema, SubscribeEventsResultSchema, UnsubscribeEventsRequestParamsSchema, UnsubscribeEventsResultSchema, WebhookControlBodySchema, WebhookDeliveryStatusSchema } from './schemas.js';
+export type EventDeliveryMode = (typeof EVENT_DELIVERY_MODES)[number];
+export type EventsErrorCode = (typeof EVENTS_ERROR_CODES)[keyof typeof EVENTS_ERROR_CODES];
+export type WebhookFailureReason = (typeof WEBHOOK_FAILURE_REASONS)[number];
+export type EventsCapability = z.infer<typeof EventsCapabilitySchema>;
+export type EventDescriptor = z.infer<typeof EventDescriptorSchema>;
+export type EventOccurrence = z.infer<typeof EventOccurrenceSchema>;
+export type EventsError = z.infer<typeof EventsErrorSchema>;
+export type ListEventsRequestParams = z.infer<typeof ListEventsRequestParamsSchema>;
+export type ListEventsResult = z.infer<typeof ListEventsResultSchema>;
+export type PollEventsRequestParams = z.infer<typeof PollEventsRequestParamsSchema>;
+export type PollEventsResult = z.infer<typeof PollEventsResultSchema>;
+export type StreamEventsRequestParams = z.infer<typeof StreamEventsRequestParamsSchema>;
+export type StreamEventsResult = z.infer<typeof StreamEventsResultSchema>;
+export type SubscribeEventsRequestParams = z.infer<typeof SubscribeEventsRequestParamsSchema>;
+export type SubscribeEventsResult = z.infer<typeof SubscribeEventsResultSchema>;
+export type UnsubscribeEventsRequestParams = z.infer<typeof UnsubscribeEventsRequestParamsSchema>;
+export type UnsubscribeEventsResult = z.infer<typeof UnsubscribeEventsResultSchema>;
+export type WebhookDeliveryStatus = z.infer<typeof WebhookDeliveryStatusSchema>;
+export type WebhookControlBody = z.infer<typeof WebhookControlBodySchema>;
+export type EventActiveNotificationParams = z.infer<typeof EventActiveNotificationParamsSchema>;
+export type EventNotificationParams = z.infer<typeof EventNotificationParamsSchema>;
+export type EventHeartbeatNotificationParams = z.infer<typeof EventHeartbeatNotificationParamsSchema>;
+export type EventErrorNotificationParams = z.infer<typeof EventErrorNotificationParamsSchema>;
+export type EventTerminatedNotificationParams = z.infer<typeof EventTerminatedNotificationParamsSchema>;
+/** Field this extension adds to the `subscriptions/listen` notifications filter. */
+export interface EventsSubscriptionFilter {
+    eventsListChanged?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/events/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp",
-  "version": "2.5.0-alpha.1",
+  "version": "2.5.0-alpha.2",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -34,10 +34,11 @@
     "fast-deep-equal": "^3.1.3"
   },
   "peerDependencies": {
-    "@mastra/core": ">=1.76.0-0 <2.0.0-0"
+    "@mastra/core": ">=1.76.0-0 <2.0.0-0",
+    "zod": "^4.2.0"
   },
   "devDependencies": {
-    "@ai-sdk/openai-v5": "npm:@ai-sdk/openai@2.0.115",
+    "@ai-sdk/openai-v5": "npm:@ai-sdk/openai@2.0.135",
     "@copilotkit/aimock": "^1.29.0",
     "@mendable/firecrawl-js": "^1.29.3",
     "@modelcontextprotocol/conformance": "0.2.0-alpha.11",
@@ -52,14 +53,14 @@
     "vitest": "4.1.11",
     "zod": "^4.6.7",
     "zod-to-json-schema": "^3.25.1",
+    "@internal/lint": "0.0.144",
     "@internal/ai-sdk-v5": "0.0.91",
     "@internal/llm-recorder": "0.0.80",
-    "@internal/test-utils": "0.0.80",
     "@internal/types-builder": "0.0.119",
-    "@internal/lint": "0.0.144",
-    "@mastra/observability": "1.21.0-alpha.2",
+    "@internal/test-utils": "0.0.80",
     "@mastra/schema-compat": "1.3.16-alpha.0",
-    "@mastra/core": "1.79.0-alpha.4"
+    "@mastra/core": "1.79.0-alpha.11",
+    "@mastra/observability": "1.21.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {