@contextvm/sdk 0.11.8 → 0.11.9

package/dist/esm/transport/nostr-client/event-pipeline.js.map

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

package/dist/esm/transport/nostr-client/inbound-coordinator.d.ts

@@ -0,0 +1,37 @@
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import { type NostrEvent } from 'nostr-tools';
+import { type Logger } from '../../core/utils/logger.js';
+import { type ClientCapabilityNegotiator } from '../capability-negotiator.js';
+import { type ClientCorrelationStore } from './correlation-store.js';
+import { type UnwrappedClientEvent } from './event-pipeline.js';
+import { type ClientInboundNotificationDispatcher } from './inbound-notification-dispatcher.js';
+import { type ServerMetadataStore } from './server-metadata-store.js';
+export interface ClientInboundCoordinatorDeps {
+    capabilityNegotiator: ClientCapabilityNegotiator;
+    correlationStore: ClientCorrelationStore;
+    notificationDispatcher: ClientInboundNotificationDispatcher;
+    metadataStore: ServerMetadataStore;
+    unwrapEvent: (event: NostrEvent) => Promise<UnwrappedClientEvent | null>;
+    convertNostrEventToMcpMessage: (event: NostrEvent) => JSONRPCMessage | null;
+    handleResponse: (correlatedEventId: string, msg: JSONRPCMessage) => void;
+    handleNotification: (eventId: string, correlatedEventId: string | undefined, msg: JSONRPCMessage) => void;
+    logger: Logger;
+    onerror?: (error: Error) => void;
+}
+/**
+ * Owns the inbound protocol workflow for the client: discovery learning,
+ * initialize tracking, message classification, and response routing.
+ */
+export declare class ClientInboundCoordinator {
+    private deps;
+    constructor(deps: ClientInboundCoordinatorDeps);
+    /**
+     * Processes an inbound Nostr event by unwrapping, validating, and routing it.
+     */
+    processIncomingEvent(event: NostrEvent): Promise<void>;
+    private learnServerDiscovery;
+    private trySetInitializeEventFromResponse;
+    private setInitializeEvent;
+    private getInitializeResultCandidate;
+}
+//# sourceMappingURL=inbound-coordinator.d.ts.map

package/dist/esm/transport/nostr-client/inbound-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-coordinator.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/inbound-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,KAAK,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,sBAAsB,EAAE,mCAAmC,CAAC;IAC5D,aAAa,EAAE,mBAAmB,CAAC;IACnC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACzE,6BAA6B,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,cAAc,GAAG,IAAI,CAAC;IAC5E,cAAc,EAAE,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;IACzE,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,GAAG,EAAE,cAAc,KAChB,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,4BAA4B;IAEtD;;OAEG;IACU,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiInE,OAAO,CAAC,oBAAoB;IAiD5B,OAAO,CAAC,iCAAiC;IAiBzC,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,4BAA4B;CAYrC"}

package/dist/esm/transport/nostr-client/inbound-coordinator.js

@@ -0,0 +1,159 @@
+import { InitializeResultSchema, ListPromptsResultSchema, ListResourcesResultSchema, ListResourceTemplatesResultSchema, ListToolsResultSchema, isJSONRPCResultResponse, isJSONRPCErrorResponse, isJSONRPCNotification, } from '@modelcontextprotocol/sdk/types.js';
+import { getNostrEventTag } from '../../core/utils/serializers.js';
+import { parseDiscoveredPeerCapabilities, } from '../capability-negotiator.js';
+/**
+ * Owns the inbound protocol workflow for the client: discovery learning,
+ * initialize tracking, message classification, and response routing.
+ */
+export class ClientInboundCoordinator {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Processes an inbound Nostr event by unwrapping, validating, and routing it.
+     */
+    async processIncomingEvent(event) {
+        var _a, _b;
+        try {
+            const unwrapped = await this.deps.unwrapEvent(event);
+            if (!unwrapped) {
+                return;
+            }
+            const nostrEvent = unwrapped.event;
+            this.learnServerDiscovery(nostrEvent);
+            const eTag = getNostrEventTag(nostrEvent.tags, 'e');
+            if (!this.deps.metadataStore.getServerInitializeEvent() && eTag) {
+                this.trySetInitializeEventFromResponse(nostrEvent);
+            }
+            const mcpMessage = this.deps.convertNostrEventToMcpMessage(nostrEvent);
+            if (!mcpMessage) {
+                this.deps.logger.error('Skipping invalid Nostr event with malformed JSON content', { eventId: nostrEvent.id, pubkey: nostrEvent.pubkey });
+                return;
+            }
+            // CEP-22/41 Interception
+            if (this.deps.notificationDispatcher.tryIntercept(mcpMessage, nostrEvent.id, eTag !== null && eTag !== void 0 ? eTag : undefined)) {
+                return;
+            }
+            // Message classification MUST be based on JSON-RPC type, not on the presence of an `e` tag.
+            // CEP-8 notifications are correlated (include `e`) but are still notifications.
+            if (isJSONRPCResultResponse(mcpMessage) ||
+                isJSONRPCErrorResponse(mcpMessage)) {
+                if (!eTag) {
+                    this.deps.logger.warn('Received JSON-RPC response without correlation `e` tag', {
+                        eventId: nostrEvent.id,
+                    });
+                    return;
+                }
+                if (!this.deps.correlationStore.hasPendingRequest(eTag)) {
+                    this.deps.logger.warn('Received response for unknown/expired request', {
+                        eventId: nostrEvent.id,
+                        eTag,
+                        reason: 'Request not found in pending set - may be duplicate or late response',
+                    });
+                    return;
+                }
+                // Capture outer Nostr event envelope for capability list JSON-RPC responses.
+                // This allows consumers to inspect Nostr tags (e.g. CEP-8 `cap` tags)
+                // that are not present in the JSON-RPC payload.
+                if (isJSONRPCResultResponse(mcpMessage)) {
+                    const result = mcpMessage.result;
+                    if (ListToolsResultSchema.safeParse(result).success) {
+                        this.deps.metadataStore.updateListEnvelopeState('tools', nostrEvent);
+                    }
+                    else if (ListResourcesResultSchema.safeParse(result).success) {
+                        this.deps.metadataStore.updateListEnvelopeState('resources', nostrEvent);
+                    }
+                    else if (ListResourceTemplatesResultSchema.safeParse(result).success) {
+                        this.deps.metadataStore.updateListEnvelopeState('templates', nostrEvent);
+                    }
+                    else if (ListPromptsResultSchema.safeParse(result).success) {
+                        this.deps.metadataStore.updateListEnvelopeState('prompts', nostrEvent);
+                    }
+                }
+                this.deps.handleResponse(eTag, mcpMessage);
+                return;
+            }
+            if (isJSONRPCNotification(mcpMessage)) {
+                this.deps.handleNotification(nostrEvent.id, eTag !== null && eTag !== void 0 ? eTag : undefined, mcpMessage);
+                return;
+            }
+            this.deps.logger.warn('Received unsupported JSON-RPC message type', {
+                eventId: nostrEvent.id,
+                hasETag: !!eTag,
+            });
+        }
+        catch (error) {
+            this.deps.logger.error('Error handling incoming Nostr event', {
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+                eventId: event.id,
+                pubkey: event.pubkey,
+                kind: event.kind,
+            });
+            (_b = (_a = this.deps).onerror) === null || _b === void 0 ? void 0 : _b.call(_a, error instanceof Error
+                ? error
+                : new Error('Failed to handle incoming Nostr event'));
+        }
+    }
+    learnServerDiscovery(event) {
+        if (!Array.isArray(event.tags)) {
+            return;
+        }
+        const discovered = parseDiscoveredPeerCapabilities(event.tags);
+        if (discovered.discoveryTags.length === 0) {
+            return;
+        }
+        this.deps.capabilityNegotiator.learnServerCapabilities(discovered);
+        this.deps.metadataStore.setSupportsOversizedTransfer(discovered.supportsOversizedTransfer);
+        this.deps.metadataStore.setSupportsOpenStream(discovered.supportsOpenStream);
+        if (!this.deps.metadataStore.getServerInitializeEvent()) {
+            this.setInitializeEvent(event);
+            this.deps.logger.info('Learned server discovery tags from inbound event', {
+                eventId: event.id,
+            });
+            return;
+        }
+        const currentHasInitializeResult = InitializeResultSchema.safeParse(this.getInitializeResultCandidate(event)).success;
+        const existingHasInitializeResult = InitializeResultSchema.safeParse(this.getInitializeResultCandidate(this.deps.metadataStore.getServerInitializeEvent())).success;
+        if (!existingHasInitializeResult && currentHasInitializeResult) {
+            this.setInitializeEvent(event);
+            this.deps.logger.info('Upgraded learned server discovery event to initialize response', {
+                eventId: event.id,
+            });
+        }
+    }
+    trySetInitializeEventFromResponse(event) {
+        try {
+            const content = JSON.parse(event.content);
+            const parse = InitializeResultSchema.safeParse(content.result);
+            if (parse.success) {
+                this.setInitializeEvent(event);
+                this.deps.logger.info('Received server initialize event', {
+                    eventId: event.id,
+                });
+            }
+        }
+        catch (_a) {
+            this.deps.logger.debug('Event is not a valid initialize response', {
+                eventId: event.id,
+            });
+        }
+    }
+    setInitializeEvent(event) {
+        this.deps.metadataStore.setServerInitializeEvent(event);
+        this.deps.capabilityNegotiator.setServerInitializeEvent(event);
+    }
+    getInitializeResultCandidate(event) {
+        if (!event) {
+            return undefined;
+        }
+        try {
+            const content = JSON.parse(event.content);
+            return content.result;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=inbound-coordinator.js.map

package/dist/esm/transport/nostr-client/inbound-coordinator.js.map

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

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

@@ -0,0 +1,28 @@
+import { type JSONRPCMessage, type JSONRPCResponse } from '@modelcontextprotocol/sdk/types.js';
+import { type Logger } from '../../core/utils/logger.js';
+import { OpenStreamReceiver } from '../open-stream/index.js';
+import { OversizedTransferReceiver } from '../oversized-transfer/index.js';
+/**
+ * Dependencies for the ClientInboundNotificationDispatcher.
+ */
+export interface ClientInboundNotificationDispatcherDeps {
+    openStreamReceiver: OpenStreamReceiver;
+    oversizedReceiver: OversizedTransferReceiver;
+    handleResponse: (correlatedEventId: string, synthetic: JSONRPCResponse) => void;
+    handleNotification: (eventId: string, correlatedEventId: string | undefined, synthetic: JSONRPCMessage) => void;
+    logger: Logger;
+    onerror?: (error: Error) => void;
+}
+/**
+ * Intercepts incoming transport-level notifications (CEP-22, CEP-41) for the client.
+ */
+export declare class ClientInboundNotificationDispatcher {
+    private deps;
+    constructor(deps: ClientInboundNotificationDispatcherDeps);
+    /**
+     * Returns true if the notification was intercepted (CEP-22 or CEP-41).
+     * Returns false if it should fall through to normal processing.
+     */
+    tryIntercept(mcpMessage: JSONRPCMessage, eventId: string, correlatedEventId: string | undefined): boolean;
+}
+//# sourceMappingURL=inbound-notification-dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-notification-dispatcher.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/inbound-notification-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAIrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,uCAAuC;IACtD,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,cAAc,EAAE,CACd,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,eAAe,KACvB,IAAI,CAAC;IACV,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,SAAS,EAAE,cAAc,KACtB,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,mCAAmC;IAClC,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,uCAAuC;IAEjE;;;OAGG;IACI,YAAY,CACjB,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO;CA8DX"}

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

@@ -0,0 +1,65 @@
+import { isJSONRPCNotification, isJSONRPCResultResponse, isJSONRPCErrorResponse, } from '@modelcontextprotocol/sdk/types.js';
+import { OpenStreamReceiver } from '../open-stream/index.js';
+import { OversizedTransferReceiver } from '../oversized-transfer/index.js';
+/**
+ * Intercepts incoming transport-level notifications (CEP-22, CEP-41) for the client.
+ */
+export class ClientInboundNotificationDispatcher {
+    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 processing.
+     */
+    tryIntercept(mcpMessage, eventId, correlatedEventId) {
+        if (isJSONRPCNotification(mcpMessage) &&
+            mcpMessage.method === 'notifications/progress' &&
+            OpenStreamReceiver.isOpenStreamFrame(mcpMessage)) {
+            this.deps.openStreamReceiver
+                .processFrame(mcpMessage)
+                .catch((err) => {
+                var _a, _b;
+                this.deps.logger.error('Open stream error (client)', {
+                    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)));
+            });
+            // Allow progress notifications to fall through to the user's onmessage handler
+            return false;
+        }
+        if (isJSONRPCNotification(mcpMessage) &&
+            mcpMessage.method === 'notifications/progress' &&
+            OversizedTransferReceiver.isOversizedFrame(mcpMessage)) {
+            this.deps.oversizedReceiver
+                .processFrame(mcpMessage)
+                .then((synthetic) => {
+                if (synthetic !== null) {
+                    if (isJSONRPCResultResponse(synthetic) ||
+                        isJSONRPCErrorResponse(synthetic)) {
+                        if (correlatedEventId) {
+                            this.deps.handleResponse(correlatedEventId, synthetic);
+                        }
+                        else {
+                            this.deps.logger.warn('Oversized response completed without correlation `e` tag', {
+                                eventId,
+                            });
+                        }
+                        return;
+                    }
+                    this.deps.handleNotification(eventId, correlatedEventId, synthetic);
+                }
+            })
+                .catch((err) => {
+                var _a, _b;
+                this.deps.logger.error('Oversized transfer error (client)', {
+                    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-client/inbound-notification-dispatcher.js.map

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

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

@@ -0,0 +1,36 @@
+import { OpenStreamReceiver, OpenStreamSession } from '../open-stream/index.js';
+import type { OpenStreamTransportPolicy } from '../open-stream-policy.js';
+import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Logger } from '../../core/utils/logger.js';
+/** Dependencies for the ClientOpenStreamFactory. */
+export interface ClientOpenStreamFactoryDeps {
+    openStreamEnabled: boolean;
+    policy?: OpenStreamTransportPolicy;
+    send: (message: JSONRPCMessage) => Promise<void>;
+    logger: Logger;
+    onerror?: (error: Error) => void;
+}
+/**
+ * Manages the lifecycle of CEP-41 OpenStream instances for the client transport.
+ *
+ * Owns the inbound OpenStreamReceiver and exposes helpers for creating
+ * outbound sessions with the correct ping/pong/abort wiring.
+ */
+export declare class ClientOpenStreamFactory {
+    private readonly receiver;
+    private readonly policy;
+    private readonly send;
+    constructor(deps: ClientOpenStreamFactoryDeps);
+    /** Gets the inbound OpenStreamReceiver instance used for CEP-41. */
+    getReceiver(): OpenStreamReceiver;
+    /** Returns an existing session for a progress token, or undefined. */
+    getSession(progressToken: string): OpenStreamSession | undefined;
+    /** Returns the session for a progress token, creating it lazily if needed. */
+    getOrCreateSession(progressToken: string): OpenStreamSession;
+    /**
+     * Creates an outbound CEP-41 session whose local ping/pong/abort
+     * publishes the corresponding notification to the server.
+     */
+    createOutboundSession(progressToken: string): OpenStreamSession;
+}
+//# sourceMappingURL=open-stream-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open-stream-factory.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/open-stream-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EAIlB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6C;gBAEtD,IAAI,EAAE,2BAA2B;IAwD7C,oEAAoE;IAC7D,WAAW,IAAI,kBAAkB;IAIxC,sEAAsE;IAC/D,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvE,8EAA8E;IACvE,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB;IAInE;;;OAGG;IACI,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB;CAoDvE"}

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

@@ -0,0 +1,126 @@
+import { OpenStreamReceiver, buildOpenStreamPingFrame, buildOpenStreamPongFrame, buildOpenStreamAbortFrame, } from '../open-stream/index.js';
+import { DEFAULT_OPEN_STREAM_CLOSE_GRACE_PERIOD_MS, DEFAULT_OPEN_STREAM_IDLE_TIMEOUT_MS, DEFAULT_OPEN_STREAM_PROBE_TIMEOUT_MS, DEFAULT_MAX_BUFFERED_BYTES_PER_STREAM, DEFAULT_MAX_BUFFERED_CHUNKS_PER_STREAM, } from '../open-stream/constants.js';
+/**
+ * Manages the lifecycle of CEP-41 OpenStream instances for the client transport.
+ *
+ * Owns the inbound OpenStreamReceiver and exposes helpers for creating
+ * outbound sessions with the correct ping/pong/abort wiring.
+ */
+export class ClientOpenStreamFactory {
+    constructor(deps) {
+        var _a, _b, _c, _d, _e, _f;
+        this.policy = deps.policy;
+        this.send = deps.send;
+        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;
+                return {
+                    sendPing: async (nonce) => {
+                        progress += 1;
+                        await this.send({
+                            jsonrpc: '2.0',
+                            method: 'notifications/progress',
+                            params: buildOpenStreamPingFrame({
+                                progressToken,
+                                progress,
+                                nonce,
+                            }),
+                        });
+                    },
+                    sendPong: async (nonce) => {
+                        progress += 1;
+                        await this.send({
+                            jsonrpc: '2.0',
+                            method: 'notifications/progress',
+                            params: buildOpenStreamPongFrame({
+                                progressToken,
+                                progress,
+                                nonce,
+                            }),
+                        });
+                    },
+                    sendAbort: async (reason) => {
+                        progress += 1;
+                        await this.send({
+                            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;
+    }
+    /** Returns an existing session for a progress token, or undefined. */
+    getSession(progressToken) {
+        return this.receiver.getSession(progressToken);
+    }
+    /** Returns the session for a progress token, creating it lazily if needed. */
+    getOrCreateSession(progressToken) {
+        return this.receiver.getOrCreateSession(progressToken);
+    }
+    /**
+     * Creates an outbound CEP-41 session whose local ping/pong/abort
+     * publishes the corresponding notification to the server.
+     */
+    createOutboundSession(progressToken) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        const existing = this.receiver.getSession(progressToken);
+        if (existing) {
+            return existing;
+        }
+        let progress = 0;
+        return this.receiver.createSession({
+            progressToken,
+            maxBufferedChunks: (_b = (_a = this.policy) === null || _a === void 0 ? void 0 : _a.maxBufferedChunksPerStream) !== null && _b !== void 0 ? _b : DEFAULT_MAX_BUFFERED_CHUNKS_PER_STREAM,
+            maxBufferedBytes: (_d = (_c = this.policy) === null || _c === void 0 ? void 0 : _c.maxBufferedBytesPerStream) !== null && _d !== void 0 ? _d : DEFAULT_MAX_BUFFERED_BYTES_PER_STREAM,
+            idleTimeoutMs: (_f = (_e = this.policy) === null || _e === void 0 ? void 0 : _e.idleTimeoutMs) !== null && _f !== void 0 ? _f : DEFAULT_OPEN_STREAM_IDLE_TIMEOUT_MS,
+            probeTimeoutMs: (_h = (_g = this.policy) === null || _g === void 0 ? void 0 : _g.probeTimeoutMs) !== null && _h !== void 0 ? _h : DEFAULT_OPEN_STREAM_PROBE_TIMEOUT_MS,
+            closeGracePeriodMs: (_k = (_j = this.policy) === null || _j === void 0 ? void 0 : _j.closeGracePeriodMs) !== null && _k !== void 0 ? _k : DEFAULT_OPEN_STREAM_CLOSE_GRACE_PERIOD_MS,
+            sendPing: async (nonce) => {
+                progress += 1;
+                await this.send({
+                    jsonrpc: '2.0',
+                    method: 'notifications/progress',
+                    params: buildOpenStreamPingFrame({ progressToken, progress, nonce }),
+                });
+            },
+            sendPong: async (nonce) => {
+                progress += 1;
+                await this.send({
+                    jsonrpc: '2.0',
+                    method: 'notifications/progress',
+                    params: buildOpenStreamPongFrame({ progressToken, progress, nonce }),
+                });
+            },
+            sendAbort: async (reason) => {
+                progress += 1;
+                await this.send({
+                    jsonrpc: '2.0',
+                    method: 'notifications/progress',
+                    params: buildOpenStreamAbortFrame({
+                        progressToken,
+                        progress,
+                        reason,
+                    }),
+                });
+            },
+        });
+    }
+}
+//# sourceMappingURL=open-stream-factory.js.map

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

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

package/dist/esm/transport/nostr-client/outbound-sender.d.ts

@@ -0,0 +1,45 @@
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import { type Logger } from '../../core/utils/logger.js';
+import { type ClientCorrelationStore, type OriginalRequestContext } from './correlation-store.js';
+import { type ClientCapabilityNegotiator } from '../capability-negotiator.js';
+export interface ClientOutboundSenderDeps {
+    serverPubkey: string;
+    correlationStore: ClientCorrelationStore;
+    capabilityNegotiator: ClientCapabilityNegotiator;
+    oversizedEnabled: boolean;
+    oversizedThreshold: number;
+    oversizedChunkSize: number;
+    oversizedAcceptTimeoutMs: number;
+    serverSupportsOversizedTransfer: () => boolean;
+    createRecipientTags: (pubkey: string) => string[][];
+    sendMcpMessage: (msg: JSONRPCMessage, pubkey: string, kind: number, tags?: string[][], isEncrypted?: boolean, onEventPublished?: (id: string) => void, wrapKind?: number) => Promise<string>;
+    waitForAccept: (token: string, timeoutMs: number) => Promise<void>;
+    getOriginalRequestContext: (msg: JSONRPCMessage) => OriginalRequestContext | undefined;
+    resolvePendingOpenStream: (progressToken: string) => void;
+    measurePublishedMcpMessageSize: (message: JSONRPCMessage, recipientPublicKey: string, kind: number, tags?: string[][], isEncrypted?: boolean, giftWrapKind?: number) => Promise<number>;
+    resolveSafeOversizedChunkSize: (params: {
+        desiredChunkSizeBytes: number;
+        maxPublishedEventBytes: number;
+        recipientPublicKey: string;
+        kind: number;
+        progressToken: string;
+        progress: number;
+        tags?: string[][];
+        isEncrypted?: boolean;
+        giftWrapKind?: number;
+    }) => Promise<number>;
+    logger: Logger;
+}
+/**
+ * Encapsulates outbound client request routing, including CEP-22 oversized handling.
+ */
+export declare class ClientOutboundSender {
+    private deps;
+    constructor(deps: ClientOutboundSenderDeps);
+    /**
+     * Sends an MCP message to the server, registering correlation when applicable.
+     */
+    sendRequest(message: JSONRPCMessage): Promise<string>;
+    private sendOversizedRequest;
+}
+//# sourceMappingURL=outbound-sender.d.ts.map

package/dist/esm/transport/nostr-client/outbound-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-sender.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/outbound-sender.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,+BAA+B,EAAE,MAAM,OAAO,CAAC;IAC/C,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,EAAE,CAAC;IACpD,cAAc,EAAE,CACd,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EACjB,WAAW,CAAC,EAAE,OAAO,EACrB,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EACvC,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,yBAAyB,EAAE,CACzB,GAAG,EAAE,cAAc,KAChB,sBAAsB,GAAG,SAAS,CAAC;IACxC,wBAAwB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,8BAA8B,EAAE,CAC9B,OAAO,EAAE,cAAc,EACvB,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EACjB,WAAW,CAAC,EAAE,OAAO,EACrB,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,6BAA6B,EAAE,CAAC,MAAM,EAAE;QACtC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAElD;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;YAmFpD,oBAAoB;CA4DnC"}