@contextvm/sdk 0.11.7 → 0.11.9

package/dist/esm/transport/nostr-server/inbound-notification-dispatcher.d.ts

@@ -0,0 +1,44 @@
+import { type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest } from '@modelcontextprotocol/sdk/types.js';
+import { type NostrEvent } from 'nostr-tools';
+import { type Logger } from '../../core/utils/logger.js';
+import { OpenStreamReceiver, OpenStreamWriter } from '../open-stream/index.js';
+import { OversizedTransferReceiver } from '../oversized-transfer/index.js';
+import { type CorrelationStore } from './correlation-store.js';
+import { type ClientSession } from './session-store.js';
+/**
+ * Dependencies for the Server InboundNotificationDispatcher.
+ */
+export interface InboundNotificationDispatcherDeps {
+    openStreamReceiver: OpenStreamReceiver;
+    oversizedReceiver: OversizedTransferReceiver;
+    openStreamFactory: {
+        getWriter: (eventId: string) => OpenStreamWriter | undefined;
+    };
+    correlationStore: CorrelationStore;
+    sendNotification: (clientPubkey: string, notification: JSONRPCMessage) => Promise<void>;
+    handleIncomingRequest: (event: NostrEvent, eventId: string, request: JSONRPCRequest, clientPubkey: string, wrapKind?: number) => void;
+    handleIncomingNotification: (clientPubkey: string, notification: JSONRPCMessage) => void;
+    cleanupDroppedRequest: (message: JSONRPCMessage) => void;
+    shouldInjectRequestEventId: boolean;
+    injectClientPubkey: boolean;
+    logger: Logger;
+    onerror?: (error: Error) => void;
+}
+/**
+ * Intercepts incoming transport-level notifications (CEP-22, CEP-41) for the server.
+ */
+export declare class InboundNotificationDispatcher {
+    private deps;
+    constructor(deps: InboundNotificationDispatcherDeps);
+    /**
+     * Returns true if the notification was intercepted (CEP-22 or CEP-41).
+     * Returns false if it should fall through to normal middleware dispatch.
+     */
+    tryIntercept(inboundMessage: JSONRPCNotification, ctx: {
+        event: NostrEvent;
+        session: ClientSession;
+        shouldSendAccept: boolean;
+        wrapKind?: number;
+    }, dispatch: (msg: JSONRPCMessage) => Promise<boolean>): boolean;
+}
+//# sourceMappingURL=inbound-notification-dispatcher.d.ts.map

package/dist/esm/transport/nostr-server/inbound-notification-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-notification-dispatcher.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-server/inbound-notification-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,iBAAiB,EAAE;QACjB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;KAC9D,CAAC;IACF,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,cAAc,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,CACrB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAAC;IACV,0BAA0B,EAAE,CAC1B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,cAAc,KACzB,IAAI,CAAC;IACV,qBAAqB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IACzD,0BAA0B,EAAE,OAAO,CAAC;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,6BAA6B;IAC5B,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iCAAiC;IAE3D;;;OAGG;IACI,YAAY,CACjB,cAAc,EAAE,mBAAmB,EACnC,GAAG,EAAE;QACH,KAAK,EAAE,UAAU,CAAC;QAClB,OAAO,EAAE,aAAa,CAAC;QACvB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EACD,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,GAClD,OAAO;CAiMX"}

package/dist/esm/transport/nostr-server/inbound-notification-dispatcher.js

@@ -0,0 +1,153 @@
+import { isJSONRPCRequest, isJSONRPCNotification, } from '@modelcontextprotocol/sdk/types.js';
+import { OpenStreamReceiver, buildOpenStreamAcceptFrame, } from '../open-stream/index.js';
+import { OversizedTransferReceiver } from '../oversized-transfer/index.js';
+import { sendAcceptFrame } from './oversized-server-handler.js';
+import { injectClientPubkey, injectRequestEventId, } from '../../core/utils/utils.js';
+/**
+ * Intercepts incoming transport-level notifications (CEP-22, CEP-41) for the server.
+ */
+export class InboundNotificationDispatcher {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Returns true if the notification was intercepted (CEP-22 or CEP-41).
+     * Returns false if it should fall through to normal middleware dispatch.
+     */
+    tryIntercept(inboundMessage, ctx, dispatch) {
+        var _a, _b, _c, _d, _e;
+        const { event, session, shouldSendAccept, wrapKind } = ctx;
+        if (inboundMessage.method === 'notifications/progress' &&
+            OpenStreamReceiver.isOpenStreamFrame(inboundMessage)) {
+            const frame = (_a = inboundMessage.params) === null || _a === void 0 ? void 0 : _a.cvm;
+            if ((frame === null || frame === void 0 ? void 0 : frame.frameType) === 'abort') {
+                const progressToken = String((_c = (_b = inboundMessage.params) === null || _b === void 0 ? void 0 : _b.progressToken) !== null && _c !== void 0 ? _c : '');
+                const eventId = this.deps.correlationStore.getEventIdByProgressToken(progressToken, event.pubkey);
+                const writer = eventId
+                    ? this.deps.openStreamFactory.getWriter(eventId)
+                    : undefined;
+                if (writer) {
+                    void writer.abort(frame.reason).catch((err) => {
+                        var _a, _b;
+                        this.deps.logger.error('Open stream abort propagation failed (server)', {
+                            error: err instanceof Error ? err.message : String(err),
+                            pubkey: event.pubkey,
+                            progressToken,
+                        });
+                        (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, err instanceof Error ? err : new Error(String(err)));
+                    });
+                }
+                return true;
+            }
+            if ((frame === null || frame === void 0 ? void 0 : frame.frameType) === 'ping') {
+                const progressToken = String((_e = (_d = inboundMessage.params) === null || _d === void 0 ? void 0 : _d.progressToken) !== null && _e !== void 0 ? _e : '');
+                const nonce = 'nonce' in frame && typeof frame.nonce === 'string'
+                    ? frame.nonce
+                    : '';
+                const eventId = this.deps.correlationStore.getEventIdByProgressToken(progressToken, event.pubkey);
+                const writer = eventId
+                    ? this.deps.openStreamFactory.getWriter(eventId)
+                    : undefined;
+                if (writer) {
+                    void writer.pong(nonce).catch((err) => {
+                        var _a, _b;
+                        this.deps.logger.error('Open stream ping handling failed (server)', {
+                            error: err instanceof Error ? err.message : String(err),
+                            pubkey: event.pubkey,
+                            progressToken,
+                        });
+                        (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, err instanceof Error ? err : new Error(String(err)));
+                    });
+                    return true;
+                }
+            }
+            this.deps.openStreamReceiver
+                .processFrame(inboundMessage)
+                .then(async () => {
+                var _a, _b, _c, _d;
+                const frameType = frame === null || frame === void 0 ? void 0 : frame.frameType;
+                if (frameType === 'start' && session.supportsOpenStream) {
+                    await this.deps.sendNotification(event.pubkey, {
+                        jsonrpc: '2.0',
+                        method: 'notifications/progress',
+                        params: buildOpenStreamAcceptFrame({
+                            progressToken: String((_b = (_a = inboundMessage.params) === null || _a === void 0 ? void 0 : _a.progressToken) !== null && _b !== void 0 ? _b : ''),
+                            progress: Number((_d = (_c = inboundMessage.params) === null || _c === void 0 ? void 0 : _c.progress) !== null && _d !== void 0 ? _d : 0) + 1,
+                        }),
+                    });
+                }
+            })
+                .catch((err) => {
+                var _a, _b;
+                this.deps.logger.error('Open stream error (server)', {
+                    error: err instanceof Error ? err.message : String(err),
+                    pubkey: event.pubkey,
+                });
+                (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, err instanceof Error ? err : new Error(String(err)));
+            });
+            return true;
+        }
+        if (inboundMessage.method === 'notifications/progress' &&
+            OversizedTransferReceiver.isOversizedFrame(inboundMessage)) {
+            this.deps.oversizedReceiver
+                .processFrame(inboundMessage)
+                .then(async (synthetic) => {
+                var _a, _b, _c, _d;
+                if (synthetic === null) {
+                    if (((_b = (_a = inboundMessage.params) === null || _a === void 0 ? void 0 : _a.cvm) === null || _b === void 0 ? void 0 : _b.frameType) === 'start' &&
+                        shouldSendAccept) {
+                        await sendAcceptFrame({
+                            clientPubkey: event.pubkey,
+                            progressToken: String((_d = (_c = inboundMessage.params) === null || _c === void 0 ? void 0 : _c.progressToken) !== null && _d !== void 0 ? _d : ''),
+                        }, {
+                            sendNotification: this.deps.sendNotification,
+                        }).catch((err) => {
+                            this.deps.logger.error('Failed to send oversized accept', {
+                                error: err instanceof Error ? err.message : String(err),
+                            });
+                        });
+                    }
+                    return;
+                }
+                if (isJSONRPCRequest(synthetic)) {
+                    this.deps.handleIncomingRequest(event, event.id, synthetic, event.pubkey, wrapKind);
+                    if (this.deps.shouldInjectRequestEventId) {
+                        injectRequestEventId(synthetic, event.id);
+                    }
+                    if (this.deps.injectClientPubkey) {
+                        injectClientPubkey(synthetic, event.pubkey);
+                    }
+                }
+                else if (isJSONRPCNotification(synthetic)) {
+                    this.deps.handleIncomingNotification(event.pubkey, synthetic);
+                }
+                void dispatch(synthetic)
+                    .then((forwarded) => {
+                    if (!forwarded) {
+                        this.deps.cleanupDroppedRequest(synthetic);
+                    }
+                })
+                    .catch((err) => {
+                    var _a, _b;
+                    this.deps.logger.error('Error dispatching reassembled oversized message', {
+                        error: err instanceof Error ? err.message : String(err),
+                        pubkey: event.pubkey,
+                    });
+                    (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, err instanceof Error
+                        ? err
+                        : new Error('oversized dispatch failed'));
+                });
+            })
+                .catch((err) => {
+                var _a, _b;
+                this.deps.logger.error('Oversized transfer error (server)', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, err instanceof Error ? err : new Error(String(err)));
+            });
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=inbound-notification-dispatcher.js.map

package/dist/esm/transport/nostr-server/inbound-notification-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-notification-dispatcher.js","sourceRoot":"","sources":["../../../../src/transport/nostr-server/inbound-notification-dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/esm/transport/nostr-server/open-stream-factory.d.ts

@@ -0,0 +1,81 @@
+import { OpenStreamWriter, OpenStreamReceiver } from '../open-stream/index.js';
+import { type OpenStreamRegistryOptions } from '../open-stream/registry.js';
+import { type Logger } from '../../core/utils/logger.js';
+import { type CorrelationStore } from './correlation-store.js';
+import { type ClientSession, type SessionStore } from './session-store.js';
+import { type JSONRPCMessage, type JSONRPCResponse } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Dependencies for the ServerOpenStreamFactory.
+ */
+export interface ServerOpenStreamFactoryDeps {
+    openStreamEnabled: boolean;
+    sendNotification: (clientPubkey: string, notification: JSONRPCMessage) => Promise<void>;
+    handleResponse: (response: JSONRPCResponse) => Promise<void>;
+    sessionStore: SessionStore;
+    onClientSessionEvicted?: (ctx: {
+        clientPubkey: string;
+        session: ClientSession;
+    }) => void | Promise<void>;
+    onAbort?: (clientPubkey: string, eventId: string, reason?: string) => Promise<void>;
+    correlationStore: CorrelationStore;
+    policy?: Partial<OpenStreamRegistryOptions>;
+    logger: Logger;
+}
+/**
+ * Manages the lifecycle of CEP-41 OpenStream instances for the server transport.
+ */
+export declare class ServerOpenStreamFactory {
+    private deps;
+    private readonly writers;
+    private readonly pendingResponses;
+    private readonly receiver;
+    private readonly pendingSessionEvictions;
+    private readonly evictedClientPubkeys;
+    constructor(deps: ServerOpenStreamFactoryDeps);
+    /**
+     * Gets the inbound OpenStreamReceiver instance used for CEP-41.
+     */
+    getReceiver(): OpenStreamReceiver;
+    /**
+     * Gets an active OpenStreamWriter for a specific event ID.
+     */
+    getWriter(eventId: string): OpenStreamWriter | undefined;
+    /**
+     * Clears all active writers and pending responses.
+     */
+    clear(): void;
+    /** Returns true if the client is currently marked as evicted. */
+    isClientEvicted(clientPubkey: string): boolean;
+    /**
+     * Takes and clears a pending eviction entry keyed by the request event id.
+     */
+    takePendingEviction(eventId: string): {
+        clientPubkey: string;
+        session: ClientSession;
+    } | undefined;
+    /**
+     * Checks if an event has an active stream and defers the response if so.
+     * Returns true if deferred.
+     */
+    deferIfStreamActive(eventId: string, response: JSONRPCResponse): boolean;
+    /**
+     * Conditionally creates a new OpenStreamWriter if the client supports it.
+     */
+    createWriterIfEnabled(eventId: string, clientPubkey: string, progressToken?: string): void;
+    /**
+     * Flushes a deferred response for a stream once it has closed or aborted.
+     */
+    flushPendingResponse(eventId: string): Promise<void>;
+    private handleProbeTimeout;
+    /**
+     * Test-only accessor for writers map.
+     * @internal
+     */
+    getWritersMap(): Map<string, OpenStreamWriter>;
+    /**
+     * Test-only accessor for pending responses map.
+     * @internal
+     */
+    getPendingResponsesMap(): Map<string, JSONRPCResponse>;
+}
+//# sourceMappingURL=open-stream-factory.d.ts.map

package/dist/esm/transport/nostr-server/open-stream-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-stream-factory.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-server/open-stream-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,cAAc,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,YAAY,EAAE,YAAY,CAAC;IAC3B,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,CACR,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAUtB,OAAO,CAAC,IAAI;IATxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGpC;IACJ,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;gBAEtC,IAAI,EAAE,2BAA2B;IAoErD;;OAEG;IACI,WAAW,IAAI,kBAAkB;IAIxC;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/D;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB,iEAAiE;IAC1D,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACI,mBAAmB,CACxB,OAAO,EAAE,MAAM,GACd;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAAG,SAAS;IAW/D;;;OAGG;IACI,mBAAmB,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,GACxB,OAAO;IASV;;OAEG;IACI,qBAAqB,CAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI;IA8BP;;OAEG;IACU,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAYnD,kBAAkB;IA8ChC;;;OAGG;IACI,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIrD;;;OAGG;IACI,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;CAG9D"}

package/dist/esm/transport/nostr-server/open-stream-factory.js

@@ -0,0 +1,224 @@
+import { OpenStreamWriter, OpenStreamReceiver, buildOpenStreamPingFrame, buildOpenStreamPongFrame, buildOpenStreamAbortFrame, } from '../open-stream/index.js';
+/**
+ * Manages the lifecycle of CEP-41 OpenStream instances for the server transport.
+ */
+export class ServerOpenStreamFactory {
+    constructor(deps) {
+        var _a, _b, _c, _d, _e, _f;
+        this.deps = deps;
+        this.writers = new Map();
+        this.pendingResponses = new Map();
+        this.pendingSessionEvictions = new Map();
+        this.evictedClientPubkeys = new Set();
+        this.receiver = new OpenStreamReceiver({
+            maxConcurrentStreams: (_a = deps.policy) === null || _a === void 0 ? void 0 : _a.maxConcurrentStreams,
+            maxBufferedChunksPerStream: (_b = deps.policy) === null || _b === void 0 ? void 0 : _b.maxBufferedChunksPerStream,
+            maxBufferedBytesPerStream: (_c = deps.policy) === null || _c === void 0 ? void 0 : _c.maxBufferedBytesPerStream,
+            idleTimeoutMs: (_d = deps.policy) === null || _d === void 0 ? void 0 : _d.idleTimeoutMs,
+            probeTimeoutMs: (_e = deps.policy) === null || _e === void 0 ? void 0 : _e.probeTimeoutMs,
+            closeGracePeriodMs: (_f = deps.policy) === null || _f === void 0 ? void 0 : _f.closeGracePeriodMs,
+            getSessionOptions: (progressToken) => {
+                let progress = 0;
+                const getClientPubkey = () => {
+                    const eventId = this.deps.correlationStore.getEventIdByProgressToken(progressToken);
+                    if (!eventId)
+                        return undefined;
+                    const route = this.deps.correlationStore.getEventRoute(eventId);
+                    return route === null || route === void 0 ? void 0 : route.clientPubkey;
+                };
+                return {
+                    sendPing: async (nonce) => {
+                        progress += 1;
+                        const clientPubkey = getClientPubkey();
+                        if (!clientPubkey)
+                            return;
+                        await this.deps.sendNotification(clientPubkey, {
+                            jsonrpc: '2.0',
+                            method: 'notifications/progress',
+                            params: buildOpenStreamPingFrame({
+                                progressToken,
+                                progress,
+                                nonce,
+                            }),
+                        });
+                    },
+                    sendPong: async (nonce) => {
+                        progress += 1;
+                        const clientPubkey = getClientPubkey();
+                        if (!clientPubkey)
+                            return;
+                        await this.deps.sendNotification(clientPubkey, {
+                            jsonrpc: '2.0',
+                            method: 'notifications/progress',
+                            params: buildOpenStreamPongFrame({
+                                progressToken,
+                                progress,
+                                nonce,
+                            }),
+                        });
+                    },
+                    sendAbort: async (reason) => {
+                        progress += 1;
+                        const clientPubkey = getClientPubkey();
+                        if (!clientPubkey)
+                            return;
+                        await this.deps.sendNotification(clientPubkey, {
+                            jsonrpc: '2.0',
+                            method: 'notifications/progress',
+                            params: buildOpenStreamAbortFrame({
+                                progressToken,
+                                progress,
+                                reason,
+                            }),
+                        });
+                    },
+                };
+            },
+            logger: deps.logger,
+        });
+    }
+    /**
+     * Gets the inbound OpenStreamReceiver instance used for CEP-41.
+     */
+    getReceiver() {
+        return this.receiver;
+    }
+    /**
+     * Gets an active OpenStreamWriter for a specific event ID.
+     */
+    getWriter(eventId) {
+        return this.writers.get(eventId);
+    }
+    /**
+     * Clears all active writers and pending responses.
+     */
+    clear() {
+        this.writers.clear();
+        this.pendingResponses.clear();
+        this.pendingSessionEvictions.clear();
+        this.evictedClientPubkeys.clear();
+    }
+    /** Returns true if the client is currently marked as evicted. */
+    isClientEvicted(clientPubkey) {
+        return this.evictedClientPubkeys.has(clientPubkey);
+    }
+    /**
+     * Takes and clears a pending eviction entry keyed by the request event id.
+     */
+    takePendingEviction(eventId) {
+        const pendingEviction = this.pendingSessionEvictions.get(eventId);
+        if (!pendingEviction) {
+            return undefined;
+        }
+        this.pendingSessionEvictions.delete(eventId);
+        this.evictedClientPubkeys.delete(pendingEviction.clientPubkey);
+        return pendingEviction;
+    }
+    /**
+     * Checks if an event has an active stream and defers the response if so.
+     * Returns true if deferred.
+     */
+    deferIfStreamActive(eventId, response) {
+        const existingWriter = this.writers.get(eventId);
+        if (existingWriter && existingWriter.isActive) {
+            this.pendingResponses.set(eventId, response);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Conditionally creates a new OpenStreamWriter if the client supports it.
+     */
+    createWriterIfEnabled(eventId, clientPubkey, progressToken) {
+        if (!this.deps.openStreamEnabled || !progressToken) {
+            return;
+        }
+        const writer = new OpenStreamWriter({
+            progressToken,
+            publishFrame: async (frame) => {
+                await this.deps.sendNotification(clientPubkey, {
+                    jsonrpc: '2.0',
+                    method: 'notifications/progress',
+                    params: frame,
+                });
+                return undefined;
+            },
+            onClose: async () => {
+                await this.flushPendingResponse(eventId);
+            },
+            onAbort: async (reason) => {
+                var _a, _b;
+                if (reason === 'Probe timeout') {
+                    await this.handleProbeTimeout(clientPubkey, eventId);
+                }
+                await ((_b = (_a = this.deps).onAbort) === null || _b === void 0 ? void 0 : _b.call(_a, clientPubkey, eventId, reason));
+                await this.flushPendingResponse(eventId);
+            },
+        });
+        this.writers.set(eventId, writer);
+    }
+    /**
+     * Flushes a deferred response for a stream once it has closed or aborted.
+     */
+    async flushPendingResponse(eventId) {
+        const pendingResponse = this.pendingResponses.get(eventId);
+        this.pendingResponses.delete(eventId);
+        this.writers.delete(eventId);
+        if (!pendingResponse) {
+            return;
+        }
+        await this.deps.handleResponse(pendingResponse);
+    }
+    async handleProbeTimeout(clientPubkey, eventId) {
+        var _a, _b;
+        const session = this.deps.sessionStore.getSession(clientPubkey);
+        if (session) {
+            this.pendingSessionEvictions.set(eventId, {
+                clientPubkey,
+                session: { ...session },
+            });
+            this.evictedClientPubkeys.add(clientPubkey);
+        }
+        const removed = this.deps.sessionStore.removeSession(clientPubkey);
+        if (!removed && !session) {
+            return;
+        }
+        this.deps.logger.info('Removed session after open-stream probe timeout', {
+            clientPubkey,
+            eventId,
+        });
+        const evictionSession = session !== null && session !== void 0 ? session : {
+            isInitialized: false,
+            isEncrypted: false,
+            hasSentCommonTags: false,
+            supportsEncryption: false,
+            supportsEphemeralEncryption: false,
+            supportsOversizedTransfer: false,
+            supportsOpenStream: false,
+        };
+        await Promise.resolve((_b = (_a = this.deps).onClientSessionEvicted) === null || _b === void 0 ? void 0 : _b.call(_a, {
+            clientPubkey,
+            session: evictionSession,
+        })).catch((error) => {
+            this.deps.logger.error('Error in onClientSessionEvicted callback', {
+                clientPubkey,
+                error,
+            });
+        });
+    }
+    /**
+     * Test-only accessor for writers map.
+     * @internal
+     */
+    getWritersMap() {
+        return this.writers;
+    }
+    /**
+     * Test-only accessor for pending responses map.
+     * @internal
+     */
+    getPendingResponsesMap() {
+        return this.pendingResponses;
+    }
+}
+//# sourceMappingURL=open-stream-factory.js.map

package/dist/esm/transport/nostr-server/open-stream-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-stream-factory.js","sourceRoot":"","sources":["../../../../src/transport/nostr-server/open-stream-factory.ts"],"names":[],"mappings":"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"}

package/dist/esm/transport/nostr-server/outbound-notification-broadcaster.d.ts

@@ -0,0 +1,24 @@
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import { type Logger } from '../../core/utils/logger.js';
+import { type CorrelationStore } from './correlation-store.js';
+import { type SessionStore } from './session-store.js';
+export interface OutboundNotificationBroadcasterDeps {
+    correlationStore: CorrelationStore;
+    sessionStore: SessionStore;
+    sendNotification: (clientPubkey: string, notification: JSONRPCMessage, correlatedEventId?: string) => Promise<void>;
+    enqueueTask: (task: () => Promise<void>) => void;
+    logger: Logger;
+    onerror?: (error: Error) => void;
+}
+/**
+ * Routes server outbound notifications to a specific client or broadcasts to all.
+ */
+export declare class OutboundNotificationBroadcaster {
+    private deps;
+    constructor(deps: OutboundNotificationBroadcasterDeps);
+    /**
+     * Broadcasts a notification or routes it based on correlation metadata.
+     */
+    broadcast(notification: JSONRPCMessage): Promise<void>;
+}
+//# sourceMappingURL=outbound-notification-broadcaster.d.ts.map

package/dist/esm/transport/nostr-server/outbound-notification-broadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-notification-broadcaster.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-server/outbound-notification-broadcaster.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mCAAmC;IAClD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,cAAc,EAC5B,iBAAiB,CAAC,EAAE,MAAM,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,+BAA+B;IAC9B,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,mCAAmC;IAE7D;;OAEG;IACU,SAAS,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAgEpE"}

package/dist/esm/transport/nostr-server/outbound-notification-broadcaster.js

@@ -0,0 +1,64 @@
+import { isJSONRPCNotification, } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Routes server outbound notifications to a specific client or broadcasts to all.
+ */
+export class OutboundNotificationBroadcaster {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Broadcasts a notification or routes it based on correlation metadata.
+     */
+    async broadcast(notification) {
+        var _a, _b, _c, _d, _e;
+        try {
+            // Special handling for progress notifications
+            // TODO: Add handling for `notifications/resources/updated`, as they need to be associated with an id
+            if (isJSONRPCNotification(notification) &&
+                notification.method === 'notifications/progress' &&
+                ((_a = notification.params) === null || _a === void 0 ? void 0 : _a.progressToken)) {
+                const token = String(notification.params.progressToken);
+                // Use O(1) lookup for progress token routing
+                const nostrEventId = this.deps.correlationStore.getEventIdByProgressToken(token);
+                if (nostrEventId) {
+                    const route = this.deps.correlationStore.getEventRoute(nostrEventId);
+                    if (route) {
+                        await this.deps.sendNotification(route.clientPubkey, notification, nostrEventId);
+                        return;
+                    }
+                }
+                const error = new Error(`No client found for progress token: ${token}`);
+                this.deps.logger.error('Progress token not found', { token });
+                (_c = (_b = this.deps).onerror) === null || _c === void 0 ? void 0 : _c.call(_b, error);
+                return;
+            }
+            // Use TaskQueue for outbound notification broadcasting to prevent event loop blocking
+            for (const [clientPubkey, session,] of this.deps.sessionStore.getAllSessions()) {
+                if (session.isInitialized) {
+                    this.deps.enqueueTask(async () => {
+                        try {
+                            await this.deps.sendNotification(clientPubkey, notification);
+                        }
+                        catch (error) {
+                            this.deps.logger.error('Error sending notification', {
+                                error: error instanceof Error ? error.message : String(error),
+                                clientPubkey,
+                                method: isJSONRPCNotification(notification)
+                                    ? notification.method
+                                    : 'unknown',
+                            });
+                        }
+                    });
+                }
+            }
+        }
+        catch (error) {
+            this.deps.logger.error('Error in notification broadcaster', {
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            (_e = (_d = this.deps).onerror) === null || _e === void 0 ? void 0 : _e.call(_d, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+}
+//# sourceMappingURL=outbound-notification-broadcaster.js.map

package/dist/esm/transport/nostr-server/outbound-notification-broadcaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-notification-broadcaster.js","sourceRoot":"","sources":["../../../../src/transport/nostr-server/outbound-notification-broadcaster.ts"],"names":[],"mappings":"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"}