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

package/dist/integrations/events-cursor-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Persists the resume cursor of each MCP Events subscription, keyed by
+ * {@link MCPEventsSignalProvider.key}. Implement it over durable storage to resume after a restart.
+ * `set` is only ever called with non-null cursors.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventCursorStore {
+    get(key: string): Promise<string | undefined> | string | undefined;
+    set(key: string, cursor: string): Promise<void> | void;
+    delete(key: string): Promise<void> | void;
+}
+/**
+ * Process-local {@link MCPEventCursorStore}. Cursors survive a provider restart within the same
+ * process, not a process restart.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare class InMemoryMCPEventCursorStore implements MCPEventCursorStore {
+    #private;
+    get(key: string): string | undefined;
+    set(key: string, cursor: string): void;
+    delete(key: string): void;
+}
+//# sourceMappingURL=events-cursor-store.d.ts.map

package/dist/integrations/events-cursor-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-cursor-store.d.ts","sourceRoot":"","sources":["../../src/integrations/events-cursor-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IACnE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;;IAGrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnC;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAErC;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;CACF"}

package/dist/integrations/events-signals.d.ts

@@ -0,0 +1,99 @@
+import type { NotificationPriority } from '@mastra/core/notifications';
+import { SignalProvider } from '@mastra/core/signals';
+import type { SignalProviderTarget, SignalSubscription } from '@mastra/core/signals';
+import type { MCPClient } from '../client/configuration.js';
+import type { MCPEventSubscribeOptions } from '../client/events/index.js';
+import type { MCPEventCursorStore } from './events-cursor-store.js';
+/**
+ * An event type on a server plus the subscription arguments that select its occurrences.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventTarget {
+    server: string;
+    event: string;
+    args?: Record<string, unknown>;
+}
+/**
+ * Options for {@link MCPEventsSignalProvider}.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventsSignalProviderOptions {
+    /** The client whose servers are subscribed to. Usually an `MCPClient`. */
+    client: Pick<MCPClient, 'events'>;
+    /** Default `'mcp-events'`. Also used as the notification `source`. */
+    id?: string;
+    /** Default `'MCP Events'`. */
+    name?: string;
+    /** Where resume cursors are kept. Default: an {@link InMemoryMCPEventCursorStore}. */
+    cursorStore?: MCPEventCursorStore;
+    /** Passed to every `events.subscribe()` call, e.g. `maxAgeMs` to bound the replay backlog. */
+    subscribeOptions?: Omit<MCPEventSubscribeOptions, 'cursor' | 'signal'>;
+    /** Priority of event notifications. Default `'medium'`. */
+    priority?: NotificationPriority;
+    /**
+     * Coalesce pending notifications per subscription key (`coalesceKey: 'mcp-events:<key>'`, regardless of `id`).
+     * When on, a burst of occurrences that arrives before the agent reads its inbox keeps only the latest
+     * occurrence's summary and payload. Default `false`: every occurrence is its own notification.
+     */
+    coalesce?: boolean;
+    /**
+     * Expose `mcp_events_list`, `mcp_events_subscribe` and `mcp_events_unsubscribe` to the agent,
+     * optionally limited to the listed servers. Default `false`: letting a model subscribe a thread
+     * to server events is opt-in.
+     */
+    tools?: boolean | {
+        servers: string[];
+    };
+    /** Called for failures that do not reach a caller: notification delivery, cursor storage, subscription end. */
+    onError?: (error: unknown, info: {
+        server: string;
+        event: string;
+        key: string;
+    }) => void;
+}
+/**
+ * Delivers MCP Events (SEP-3415) occurrences into agent threads as notification signals.
+ *
+ * Each `(server, event, arguments)` key holds one MCP subscription, shared by every thread
+ * subscribed to it. Occurrences are wrapped as untrusted data before the model sees them, and the
+ * subscription cursor is persisted after each occurrence so a new provider resumes where this one
+ * stopped.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ *
+ * @example
+ * ```ts
+ * const mcpEvents = new MCPEventsSignalProvider({ client: mcp });
+ * const agent = new Agent({ ..., signals: [mcpEvents] });
+ * await mcpEvents.subscribeThread(
+ *   { resourceId: 'user-1', threadId: 'thread-1' },
+ *   { server: 'github', event: 'repo.push', args: { repo: 'mastra-ai/mastra' } },
+ * );
+ * ```
+ */
+export declare class MCPEventsSignalProvider extends SignalProvider {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    constructor(options: MCPEventsSignalProviderOptions);
+    /** The subscription key, `<server>:<event>:<hash of arguments>`, also used as the cursor store key. */
+    static key(target: MCPEventTarget): string;
+    /**
+     * Subscribes a thread to an event. Resolves once the MCP subscription is established, and
+     * rejects (without subscribing the thread) when the server refuses it.
+     */
+    subscribeThread(thread: SignalProviderTarget, target: MCPEventTarget): Promise<SignalSubscription>;
+    /**
+     * Unsubscribes a thread. When it was the last thread on the key, the MCP subscription is
+     * cancelled and its stored cursor deleted.
+     *
+     * @returns `true` if the thread was subscribed.
+     */
+    unsubscribeThread(thread: SignalProviderTarget, target: MCPEventTarget): Promise<boolean>;
+    getTools(): {};
+    /** Cancels every MCP subscription. Stored cursors are kept so a new provider resumes from them. */
+    stop(): void;
+}
+//# sourceMappingURL=events-signals.d.ts.map

package/dist/integrations/events-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-signals.d.ts","sourceRoot":"","sources":["../../src/integrations/events-signals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAA+B,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAsB,wBAAwB,EAAwB,MAAM,kBAAkB,CAAC;AAE3G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0EAA0E;IAC1E,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACvE,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxC,+GAA+G;IAC/G,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1F;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAMtB,YAAY,OAAO,EAAE,8BAA8B,EAMlD;IAED,uGAAuG;IACvG,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEzC;IAED;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgBvG;IAED;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAe9F;IAED,QAAQ,OAQP;IAED,mGAAmG;IACnG,IAAI,IAAI,IAAI,CAUX;CAoIF"}

package/dist/integrations/events-tools.d.ts

@@ -0,0 +1,24 @@
+import type { ToolExecutionContext } from '@mastra/core/tools';
+import type { MCPClient } from '../client/configuration.js';
+import type { MCPEventsSignalProvider } from './events-signals.js';
+/** Builds the model-facing MCP Events tools for a provider. */
+export declare function createMCPEventsTools({ provider, client, servers, }: {
+    provider: MCPEventsSignalProvider;
+    client: Pick<MCPClient, 'events'>;
+    servers?: string[];
+}): {
+    mcp_events_list: import("@mastra/core/tools").Tool<{
+        server: string;
+    }, unknown, unknown, unknown, ToolExecutionContext<unknown, unknown, unknown>, "mcp_events_list", unknown>;
+    mcp_events_subscribe: import("@mastra/core/tools").Tool<{
+        server: string;
+        event: string;
+        arguments?: string | undefined;
+    }, unknown, unknown, unknown, ToolExecutionContext<unknown, unknown, unknown>, "mcp_events_subscribe", unknown>;
+    mcp_events_unsubscribe: import("@mastra/core/tools").Tool<{
+        server: string;
+        event: string;
+        arguments?: string | undefined;
+    }, unknown, unknown, unknown, ToolExecutionContext<unknown, unknown, unknown>, "mcp_events_unsubscribe", unknown>;
+};
+//# sourceMappingURL=events-tools.d.ts.map

package/dist/integrations/events-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-tools.d.ts","sourceRoot":"","sources":["../../src/integrations/events-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAiDhE,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;IAOG,eAAe;;;IAyBf,oBAAoB;;;;;IAsBpB,sBAAsB;;;;;EAuBzB"}

package/dist/integrations/events-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hashes subscription arguments so that equal arguments give the same key regardless of key
+ * order. `undefined` and `{}` hash the same.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare function stableArgsHash(args: Record<string, unknown> | undefined): string;
+export declare const UNTRUSTED_EVENT_TAG = "untrusted-mcp-event-data";
+/**
+ * Formats server-provided event content for a model: a fixed header, a warning, and the data as
+ * escaped JSON inside an `<untrusted-mcp-event-data>` block that the data cannot break out of.
+ */
+export declare function formatUntrustedEvent({ header, data, footer, }: {
+    header: string;
+    data: unknown;
+    footer?: string;
+}): string;
+//# sourceMappingURL=events-utils.d.ts.map

package/dist/integrations/events-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-utils.d.ts","sourceRoot":"","sources":["../../src/integrations/events-utils.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAGhF;AAUD,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAK9D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,IAAI,EACJ,MAAM,GACP,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAST"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,5 @@
+export { MCPEventsSignalProvider } from './events-signals.js';
+export type { MCPEventTarget, MCPEventsSignalProviderOptions } from './events-signals.js';
+export { InMemoryMCPEventCursorStore } from './events-cursor-store.js';
+export type { MCPEventCursorStore } from './events-cursor-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { EventDescriptor, EventOccurrence } from '../../shared/events/index.js';
+import type { ServerEventRegistry } from './registry.js';
+import type { MCPServerEmitOptions, MCPServerEventData } from './types.js';
+/**
+ * `server.events`: publishes occurrences of the event types configured in `MCPServer`'s `events`.
+ *
+ * Emitted events are delivered to this process's open `events/stream` subscriptions, POSTed to
+ * its webhook subscriptions (when `eventsOptions.webhook` is set), and kept in the type's
+ * in-memory ring buffer for `events/poll`. They do not reach other server processes.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare class ServerEventActions {
+    private readonly registry;
+    private readonly describe;
+    constructor(registry: ServerEventRegistry, describe: () => EventDescriptor[]);
+    /**
+     * Records an occurrence of `name` and delivers it to every matching push and webhook subscription.
+     * `data` is validated against the type's `payloadSchema` when one is set.
+     *
+     * @throws MastraError `MCP_SERVER_UNKNOWN_EVENT` for an unconfigured name,
+     * `MCP_SERVER_EVENT_INVALID_PAYLOAD` when `data` fails `payloadSchema`, and
+     * `MCP_SERVER_EVENT_NOT_EMITTABLE` for a type with a `poll` source, which can't be pushed.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    emit(name: string, data: MCPServerEventData, options?: MCPServerEmitOptions): Promise<EventOccurrence>;
+    /**
+     * The descriptors `events/list` returns, in definition order.
+     *
+     * @experimental SEP-3415 is a draft; this API may change.
+     */
+    list(): EventDescriptor[];
+}
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/server/events/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAExE;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,eAAe,EAAE,EAChD;IAEJ;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAErG;IAED;;;;OAIG;IACH,IAAI,IAAI,eAAe,EAAE,CAExB;CACF"}

package/dist/server/events/define-event.d.ts

@@ -0,0 +1,19 @@
+import type { MCPServerEventArgs, MCPServerEventData, MCPServerEventDefinition } from './types.js';
+/**
+ * Declares an event type for `MCPServer`'s `events` option. An identity helper: it types `match`
+ * and `poll` from `inputSchema` and `payloadSchema`.
+ *
+ * @example
+ * ```typescript
+ * const ticketCreated = defineEvent({
+ *   description: 'A ticket was created',
+ *   inputSchema: z.object({ project: z.string().optional() }),
+ *   payloadSchema: z.object({ id: z.string(), project: z.string() }),
+ *   match: (args, data) => !args.project || data.project === args.project,
+ * });
+ * ```
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export declare function defineEvent<TArgs extends MCPServerEventArgs = MCPServerEventArgs, TData extends MCPServerEventData = MCPServerEventData>(definition: MCPServerEventDefinition<TArgs, TData>): MCPServerEventDefinition<TArgs, TData>;
+//# sourceMappingURL=define-event.d.ts.map

package/dist/server/events/define-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-event.d.ts","sourceRoot":"","sources":["../../../src/server/events/define-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEhG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,SAAS,kBAAkB,GAAG,kBAAkB,EACrD,KAAK,SAAS,kBAAkB,GAAG,kBAAkB,EACrD,UAAU,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAE5F"}

package/dist/server/events/handlers.d.ts

@@ -0,0 +1,49 @@
+import type { IMastraLogger } from '@mastra/core/logger';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { Server, ServerContext } from '@modelcontextprotocol/server';
+import type { EventDeliveryMode, PollEventsRequestParams, PollEventsResult, StreamEventsRequestParams } from '../../shared/events/index.js';
+import type { RegisteredEvent, ServerEventRegistry } from './registry.js';
+import { EventStream } from './stream.js';
+import type { EventStreamOptions } from './stream.js';
+import type { WebhookDispatcher } from './webhook-dispatcher.js';
+export declare const DEFAULT_EVENTS_MAX_STREAMS = 1024;
+export interface EventHandlerDeps {
+    registry: ServerEventRegistry;
+    heartbeatIntervalMs: number;
+    listPageSize?: number;
+    maxStreams?: number;
+    getLogger: () => IMastraLogger;
+    /** Serves `events/subscribe` and `events/unsubscribe` when webhook delivery is configured. */
+    webhooks?: WebhookDispatcher;
+    jsonSchema: (schema: unknown, options: {
+        io: 'input' | 'output';
+    }) => Record<string, unknown> | undefined;
+    /** Runs one request under the server's request span with its resolved request context. */
+    trace: <T>(server: Server, method: string, params: Record<string, unknown>, ctx: ServerContext, fn: (requestContext: RequestContext) => Promise<T>) => Promise<T>;
+}
+/**
+ * Registers `events/list`, `events/poll` and `events/stream` on one protocol instance, plus
+ * `events/subscribe` and `events/unsubscribe` when webhook delivery is configured.
+ */
+export declare function registerEventHandlers(server: Server, deps: EventHandlerDeps): void;
+type PollDeps = Pick<EventHandlerDeps, 'registry' | 'getLogger'>;
+type StreamDeps = Pick<EventHandlerDeps, 'registry' | 'getLogger' | 'heartbeatIntervalMs' | 'maxStreams'>;
+/** Serves one `events/poll` request: the event's `poll` source, or its ring buffer. */
+export declare function pollEvent(deps: PollDeps, params: PollEventsRequestParams, { requestContext, signal }: {
+    requestContext: RequestContext;
+    signal: AbortSignal;
+}): Promise<PollEventsResult>;
+/**
+ * Opens one `events/stream` subscription: replays from `cursor`, then delivers live events
+ * until the stream closes or `signal` aborts. Resolves once `active` is queued.
+ */
+export declare function openEventStream(deps: StreamDeps, params: StreamEventsRequestParams, { subscriptionId, requestContext, notify, signal, }: {
+    subscriptionId: string | number;
+    requestContext: RequestContext;
+    notify: EventStreamOptions['notify'];
+    signal: AbortSignal;
+}): Promise<EventStream>;
+/** Runs the definition's `authorize`; rejects with -32024 when it denies the caller. */
+export declare function authorizeOrThrow(event: RegisteredEvent, args: Record<string, unknown>, requestContext: RequestContext, delivery: EventDeliveryMode, deps: Pick<EventHandlerDeps, 'getLogger'>): Promise<void>;
+export {};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/server/events/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/server/events/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAiB1E,OAAO,KAAK,EACV,iBAAiB,EAGjB,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EAG1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,GAAG,QAAQ,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1G,0FAA0F;IAC1F,KAAK,EAAE,CAAC,CAAC,EACP,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,KAC/C,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA+ElF;AAED,KAAK,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC;AACjE,KAAK,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,WAAW,GAAG,qBAAqB,GAAG,YAAY,CAAC,CAAC;AAE1G,uFAAuF;AACvF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,uBAAuB,EAC/B,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE;IAAE,cAAc,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAClF,OAAO,CAAC,gBAAgB,CAAC,CAwD3B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,yBAAyB,EACjC,EACE,cAAc,EACd,cAAc,EACd,MAAM,EACN,MAAM,GACP,EAAE;IACD,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;CACrB,GACA,OAAO,CAAC,WAAW,CAAC,CA2CtB;AAUD,wFAAwF;AACxF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAaf"}

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

@@ -0,0 +1,7 @@
+export { defineEvent } from './define-event.js';
+export { ServerEventActions } from './actions.js';
+export type * from './types.js';
+export { InMemoryWebhookSubscriptionStore } from './webhook-store.js';
+export type { WebhookSubscriptionRecord, WebhookSubscriptionStore } from './webhook-store.js';
+export type { WebhookTransport, WebhookTransportRequest, WebhookTransportResult } from './webhook-transport.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,mBAAmB,SAAS,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server/events/inspector.d.ts

@@ -0,0 +1,14 @@
+import type { MCPServerEventInfo, MCPServerEventsInspector } from '@mastra/core/mcp';
+import type { EventHandlerDeps } from './handlers.js';
+/** Prefix of the `eventId` of occurrences sent with the inspector's `emit`. */
+export declare const TEST_EMIT_EVENT_ID_PREFIX = "mastra-test-";
+type InspectorDeps = Pick<EventHandlerDeps, 'registry' | 'getLogger' | 'heartbeatIntervalMs' | 'maxStreams' | 'jsonSchema'>;
+/** Studio's view of the declared event types: the `events/list` descriptors plus `emittable`. */
+export declare function listEventsInfo(deps: Pick<InspectorDeps, 'registry' | 'jsonSchema'>): MCPServerEventInfo[];
+/**
+ * Serves `events/poll` and `events/stream` in-process through the protocol handlers' code
+ * paths, translating protocol errors into `MastraError`s with {@link MCP_SERVER_EVENT_ERROR_IDS}.
+ */
+export declare function createEventsInspector(deps: InspectorDeps): MCPServerEventsInspector;
+export {};
+//# sourceMappingURL=inspector.d.ts.map

package/dist/server/events/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../src/server/events/inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAElB,wBAAwB,EAEzB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAExD,KAAK,aAAa,GAAG,IAAI,CACvB,gBAAgB,EAChB,UAAU,GAAG,WAAW,GAAG,qBAAqB,GAAG,YAAY,GAAG,YAAY,CAC/E,CAAC;AAIF,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,kBAAkB,EAAE,CAMzG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,wBAAwB,CA0CnF"}

package/dist/server/events/registry.d.ts

@@ -0,0 +1,59 @@
+import type { StandardSchemaWithJSON } from '@mastra/core/schema';
+import type { EventDeliveryMode, EventDescriptor, EventOccurrence } from '../../shared/events/index.js';
+import { EventRingBuffer } from './ring-buffer.js';
+import type { BufferedEvent } from './ring-buffer.js';
+import type { EventStream } from './stream.js';
+import type { MCPServerEmitOptions, MCPServerEventData, MCPServerEventDefinition } from './types.js';
+export type EventListener = (entry: BufferedEvent) => void;
+/** One configured event type. */
+export interface RegisteredEvent {
+    name: string;
+    definition: MCPServerEventDefinition;
+    delivery: EventDeliveryMode[];
+    inputSchema?: StandardSchemaWithJSON;
+    payloadSchema?: StandardSchemaWithJSON;
+    /** Present when the type has no `poll` source, i.e. when it accepts `emit()`. */
+    buffer?: EventRingBuffer;
+    listeners: Set<EventListener>;
+}
+/**
+ * Delivery modes advertised for a definition. They are fixed at construction because clients
+ * only learn them from `events/list` (no `listChanged` yet). Without a `poll` source the type
+ * is fed by `emit()` and served over push and poll; with one it is served over poll only. An
+ * explicit `delivery` only narrows that set. `extraModes` lets other delivery mechanisms
+ * (webhooks) add themselves.
+ */
+export declare function deriveDelivery(name: string, definition: Pick<MCPServerEventDefinition, 'poll' | 'delivery'>, extraModes?: EventDeliveryMode[]): EventDeliveryMode[];
+/** Event types, their buffers and live subscriptions. Shared by every protocol instance of one `MCPServer`. */
+export declare class ServerEventRegistry {
+    readonly bootId: `${string}-${string}-${string}-${string}-${string}`;
+    readonly openStreams: Set<EventStream>;
+    private readonly events;
+    /** `webhook`: the server serves webhook delivery, which emit-fed types (no `poll` source) then advertise. */
+    constructor(definitions: Record<string, MCPServerEventDefinition> | undefined, options?: {
+        webhook?: boolean;
+    });
+    get size(): number;
+    list(): RegisteredEvent[];
+    /**
+     * The event type a poll or stream request names, if it supports `mode`.
+     * @throws ProtocolError -32023 for an unknown name, -32026 for an unsupported mode.
+     */
+    resolve(name: string, mode: EventDeliveryMode): RegisteredEvent;
+    /**
+     * Validates subscription arguments against the type's `inputSchema`.
+     * @throws ProtocolError -32602 when they do not match.
+     */
+    validateArguments(event: RegisteredEvent, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Records an occurrence and hands it to every live subscription of the type. */
+    emit(name: string, data: MCPServerEventData, options?: MCPServerEmitOptions): Promise<EventOccurrence>;
+    /** Registers a live listener for a type's emitted events. Returns the unsubscribe function. */
+    subscribe(event: RegisteredEvent, listener: EventListener): () => void;
+    listenerCount(): number;
+    closeStreams(): void;
+}
+export declare function toTimestamp(value: string | Date | undefined): string;
+export declare function toDescriptor(event: RegisteredEvent, convert: (schema: unknown, options: {
+    io: 'input' | 'output';
+}) => Record<string, unknown> | undefined): EventDescriptor;
+//# sourceMappingURL=registry.d.ts.map

package/dist/server/events/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/server/events/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAIlG,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE3D,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,wBAAwB,CAAC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,iFAAiF;IACjF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,UAAU,CAAC,EAC/D,UAAU,GAAE,iBAAiB,EAAO,GACnC,iBAAiB,EAAE,CAcrB;AAED,+GAA+G;AAC/G,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,MAAM,sDAAgB;IAC/B,QAAQ,CAAC,WAAW,mBAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,6GAA6G;IAC7G,YAAY,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,SAAS,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,EAcjH;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,eAAe,EAAE,CAExB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAa9D;IAED;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAe/G;IAED,iFAAiF;IAC3E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuC/G;IAED,+FAA+F;IAC/F,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAGrE;IAED,aAAa,IAAI,MAAM,CAItB;IAED,YAAY,IAAI,IAAI,CAEnB;CACF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGpE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;IAAE,EAAE,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACrG,eAAe,CAQjB"}

package/dist/server/events/ring-buffer.d.ts

@@ -0,0 +1,56 @@
+import type { EventOccurrence } from '../../shared/events/index.js';
+/** An event occurrence before a cursor is attached. */
+export interface StoredOccurrence {
+    eventId: string;
+    name: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+/** An emitted event as retained by the buffer. */
+export interface BufferedEvent {
+    seq: number;
+    /** Position after this event. */
+    cursor: string;
+    /** Parsed `occurrence.timestamp`, for `maxAgeMs`. */
+    timestampMs: number;
+    occurrence: StoredOccurrence;
+}
+export interface RingBufferReadOptions {
+    maxEvents: number;
+    maxAgeMs?: number;
+    match?: (data: Record<string, unknown>) => boolean;
+    now?: number;
+}
+export interface RingBufferReadResult {
+    /** Position the read started from, after any gap adjustment. */
+    from: string;
+    events: EventOccurrence[];
+    /** Position after the last scanned event, including events `match` rejected. */
+    cursor: string;
+    truncated: boolean;
+    hasMore: boolean;
+}
+/**
+ * Bounded, in-memory history of one event type's emitted occurrences.
+ *
+ * Cursors are opaque `base64url("<bootId>:<seq>")`. `bootId` is random per server instance, so a
+ * cursor minted by a previous process is recognised as foreign and read as a gap.
+ */
+export declare class EventRingBuffer {
+    private readonly bootId;
+    private readonly capacity;
+    private readonly entries;
+    private seq;
+    constructor(bootId: string, capacity: number);
+    get head(): string;
+    /** Sequence number of the latest pushed event (0 before the first). */
+    get lastSeq(): number;
+    push(occurrence: StoredOccurrence): BufferedEvent;
+    /** `cursor` absent or `null` starts from now: nothing is replayed and `maxAgeMs` is ignored. */
+    read(cursor: string | null | undefined, options: RingBufferReadOptions): RingBufferReadResult;
+    /** Cursor for the position after event `seq` (`seq - 1` is the position before it). */
+    cursorFor(seq: number): string;
+    /** Sequence number of a cursor this buffer minted, or `undefined` if it is foreign or malformed. */
+    private decode;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/server/events/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../../src/server/events/ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,GAAG,CAAK;IAEhB,YACmB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAC/B;IAEJ,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uEAAuE;IACvE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,CAAC,UAAU,EAAE,gBAAgB,GAAG,aAAa,CAYhD;IAED,gGAAgG;IAChG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAsC5F;IAED,uFAAuF;IACvF,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,oGAAoG;IACpG,OAAO,CAAC,MAAM;CASf"}

package/dist/server/events/stream.d.ts

@@ -0,0 +1,56 @@
+import type { EventOccurrence } from '../../shared/events/index.js';
+import type { BufferedEvent } from './ring-buffer.js';
+type SubscriptionId = string | number;
+export interface StreamNotification {
+    method: string;
+    params: Record<string, unknown>;
+}
+export interface EventStreamOptions {
+    subscriptionId: SubscriptionId;
+    /** Sends a notification related to the `events/stream` request. */
+    notify: (notification: StreamNotification) => Promise<void>;
+    heartbeatIntervalMs: number;
+    /** Subscription filter, already bound to the subscription's arguments. */
+    match?: (data: Record<string, unknown>) => boolean;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Server side of one push subscription (`events/stream`).
+ *
+ * Every notification goes through one promise chain, so `active` is always first and events
+ * arrive in emit order. A heartbeat is sent whenever `heartbeatIntervalMs` passes without
+ * another message.
+ */
+export declare class EventStream {
+    private readonly options;
+    /** Resolves once the stream is closed. */
+    readonly closed: Promise<void>;
+    private queue;
+    private timer;
+    private cursor;
+    private isClosed;
+    private started;
+    private readonly pending;
+    private readonly cleanups;
+    private resolveClosed;
+    constructor(options: EventStreamOptions);
+    get subscriptionId(): SubscriptionId;
+    /** Runs `cleanup` when the stream closes. */
+    onClose(cleanup: () => void): void;
+    /** Sends `active`, then the replayed events, and starts the heartbeat. */
+    start(start: {
+        cursor: string | null;
+        truncated: boolean;
+        replay?: EventOccurrence[];
+    }): void;
+    /** Live listener: forwards an emitted event if it matches the subscription. */
+    deliver(entry: BufferedEvent): void;
+    /** `match` for replay and live delivery. A throwing `match` is reported on the stream as a recoverable error; the details go only to `onError`. */
+    matches(data: Record<string, unknown>): boolean;
+    close(): void;
+    private sendEvent;
+    private send;
+    private armHeartbeat;
+}
+export {};
+//# sourceMappingURL=stream.d.ts.map

package/dist/server/events/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/server/events/stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,mEAAmE;IACnE,MAAM,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IAaV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgE;IACxF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,aAAa,CAAc;IAEnC,YAA6B,OAAO,EAAE,kBAAkB,EAIvD;IAED,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,6CAA6C;IAC7C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAGjC;IAED,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,IAAI,CAM5F;IAED,+EAA+E;IAC/E,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAOlC;IAED,mJAAmJ;IACnJ,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAc9C;IAED,KAAK,IAAI,IAAI,CAOZ;IAED,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,IAAI;IAuBZ,OAAO,CAAC,YAAY;CAQrB"}