@contextvm/sdk 0.1.1 → 0.1.2

package/dist/esm/gateway/index.js

@@ -0,0 +1,110 @@
+import { NostrServerTransport, } from '../transport/nostr-server-transport.js';
+/**
+ * The main gateway class that orchestrates communication between Nostr clients
+ * and a local MCP server. It acts as a bridge, receiving MCP requests via Nostr
+ * events and forwarding them to the local MCP server, then publishing the
+ * responses back to Nostr. All request/response correlation is handled by the
+ * NostrServerTransport, making this a simple message forwarder.
+ */
+export class NostrMCPGateway {
+    constructor(options) {
+        this.isRunning = false;
+        this.mcpServerTransport = options.mcpServerTransport;
+        this.nostrServerTransport = new NostrServerTransport(options.nostrTransportOptions);
+        this.setupEventHandlers();
+    }
+    /**
+     * Sets up event handlers for both transports.
+     */
+    setupEventHandlers() {
+        // Forward messages from Nostr to the MCP server, handling any potential errors.
+        this.nostrServerTransport.onmessage = (message) => {
+            this.mcpServerTransport
+                .send(message)
+                .catch(this.handleServerError.bind(this));
+        };
+        this.nostrServerTransport.onerror = this.handleNostrError.bind(this);
+        this.nostrServerTransport.onclose = this.handleNostrClose.bind(this);
+        // Forward messages from the MCP server to the Nostr transport, handling any potential errors.
+        this.mcpServerTransport.onmessage = (message) => {
+            this.nostrServerTransport
+                .send(message)
+                .catch(this.handleNostrError.bind(this));
+        };
+        this.mcpServerTransport.onerror = this.handleServerError.bind(this);
+        this.mcpServerTransport.onclose = this.handleServerClose.bind(this);
+    }
+    /**
+     * Starts the gateway, initializing both transports.
+     */
+    async start() {
+        if (this.isRunning) {
+            throw new Error('Gateway is already running');
+        }
+        try {
+            // Start both transports
+            await this.nostrServerTransport.start();
+            await this.mcpServerTransport.start();
+            this.isRunning = true;
+            console.log('NostrMCPGateway started successfully');
+        }
+        catch (error) {
+            console.error('Failed to start NostrMCPGateway:', error);
+            await this.stop();
+            throw error;
+        }
+    }
+    /**
+     * Stops the gateway, closing both transports.
+     */
+    async stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        try {
+            // Stop both transports
+            await this.nostrServerTransport.close();
+            await this.mcpServerTransport.close();
+            this.isRunning = false;
+            console.log('NostrMCPGateway stopped successfully');
+        }
+        catch (error) {
+            console.error('Error stopping NostrMCPGateway:', error);
+            throw error;
+        }
+    }
+    /**
+     * Handles errors from the Nostr transport.
+     * @param error The error that occurred.
+     */
+    handleNostrError(error) {
+        console.error('Nostr transport error:', error);
+    }
+    /**
+     * Handles the Nostr transport closing.
+     */
+    handleNostrClose() {
+        console.log('Nostr transport closed');
+    }
+    /**
+     * Handles errors from the MCP server transport.
+     * @param error The error that occurred.
+     */
+    handleServerError(error) {
+        console.error('MCP server transport error:', error);
+    }
+    /**
+     * Handles the MCP server transport closing.
+     */
+    handleServerClose() {
+        console.log('MCP server transport closed');
+    }
+    /**
+     * Gets the current status of the gateway.
+     * @returns True if the gateway is running, false otherwise.
+     */
+    isActive() {
+        return this.isRunning;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/gateway/index.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,7 @@
+export * from './core/index.js';
+export * from './relay/index.js';
+export * from './signer/index.js';
+export * from './gateway/index.js';
+export * from './proxy/index.js';
+export * from './transport/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+export * from './core/index.js';
+export * from './relay/index.js';
+export * from './signer/index.js';
+export * from './gateway/index.js';
+export * from './proxy/index.js';
+export * from './transport/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/dist/esm/proxy/index.d.ts

@@ -0,0 +1,42 @@
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { NostrTransportOptions } from '../transport/nostr-client-transport.js';
+/**
+ * Options for configuring the NostrMCPProxy.
+ */
+export interface NostrMCPProxyOptions {
+    /**
+     * The transport for the local MCP Host (e.g., StdioServerTransport).
+     */
+    mcpHostTransport: Transport;
+    /**
+     * Configuration options for the client-facing Nostr transport.
+     */
+    nostrTransportOptions: NostrTransportOptions;
+}
+/**
+ * `NostrMCPProxy` acts as a bridge between a local MCP Host
+ * and a remote MCP Server accessible via the Nostr network.
+ *
+ * It listens for MCP messages from the local host, forwards them over Nostr,
+ * and relays the responses back.
+ */
+export declare class NostrMCPProxy {
+    private mcpHostTransport;
+    private nostrTransport;
+    constructor(options: NostrMCPProxyOptions);
+    /**
+     * Starts the proxy, establishing connections to both the local MCP host
+     * and the remote Nostr transport.
+     *
+     * @returns Promise that resolves when both transports are started
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the proxy and closes all connections.
+     *
+     * @returns Promise that resolves when both transports are closed
+     */
+    stop(): Promise<void>;
+    private setupEventHandlers;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE1E,OAAO,EAEL,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC;IAC5B;;OAEG;IACH,qBAAqB,EAAE,qBAAqB,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,cAAc,CAAuB;gBAEjC,OAAO,EAAE,oBAAoB;IAOzC;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/esm/proxy/index.js

@@ -0,0 +1,59 @@
+import { NostrClientTransport, } from '../transport/nostr-client-transport.js';
+/**
+ * `NostrMCPProxy` acts as a bridge between a local MCP Host
+ * and a remote MCP Server accessible via the Nostr network.
+ *
+ * It listens for MCP messages from the local host, forwards them over Nostr,
+ * and relays the responses back.
+ */
+export class NostrMCPProxy {
+    constructor(options) {
+        this.mcpHostTransport = options.mcpHostTransport;
+        this.nostrTransport = new NostrClientTransport(options.nostrTransportOptions);
+    }
+    /**
+     * Starts the proxy, establishing connections to both the local MCP host
+     * and the remote Nostr transport.
+     *
+     * @returns Promise that resolves when both transports are started
+     */
+    async start() {
+        // Set up message handlers
+        this.setupEventHandlers();
+        // Start both transports
+        await Promise.all([
+            this.mcpHostTransport.start(),
+            this.nostrTransport.start(),
+        ]);
+        console.log('NostrMCPProxy started.');
+    }
+    /**
+     * Stops the proxy and closes all connections.
+     *
+     * @returns Promise that resolves when both transports are closed
+     */
+    async stop() {
+        await this.mcpHostTransport.close();
+        await this.nostrTransport.close();
+        console.log('NostrMCPProxy stopped.');
+    }
+    setupEventHandlers() {
+        // Forward messages from the local host to Nostr.
+        this.mcpHostTransport.onmessage = (message) => {
+            this.nostrTransport
+                .send(message)
+                .catch((err) => console.error('Error sending message to Nostr:', err));
+        };
+        this.mcpHostTransport.onerror = (err) => console.error('MCP Host Transport Error:', err);
+        this.mcpHostTransport.onclose = () => console.log('MCP Host Transport closed');
+        // Forward messages from Nostr back to the local host.
+        this.nostrTransport.onmessage = (message) => {
+            this.mcpHostTransport
+                .send(message)
+                .catch((err) => console.error('Error sending message to local host:', err));
+        };
+        this.nostrTransport.onerror = (err) => console.error('Nostr Transport Error:', err);
+        this.nostrTransport.onclose = () => console.log('Nostr Transport closed');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAgBhD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAIxB,YAAY,OAA6B;QACvC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,IAAI,oBAAoB,CAC5C,OAAO,CAAC,qBAAqB,CAC9B,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,KAAK;QAChB,0BAA0B;QAC1B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,wBAAwB;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE;YAC7B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;SAC5B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI;QACf,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAEO,kBAAkB;QACxB,iDAAiD;QACjD,IAAI,CAAC,gBAAgB,CAAC,SAAS,GAAG,CAAC,OAAuB,EAAE,EAAE;YAC5D,IAAI,CAAC,cAAc;iBAChB,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE,CACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,gBAAgB,CAAC,OAAO,GAAG,GAAG,EAAE,CACnC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAE3C,sDAAsD;QACtD,IAAI,CAAC,cAAc,CAAC,SAAS,GAAG,CAAC,OAAuB,EAAE,EAAE;YAC1D,IAAI,CAAC,gBAAgB;iBAClB,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAC3D,CAAC;QACN,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE,CACpC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/esm/proxy/proxy-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=proxy-server.d.ts.map

package/dist/esm/proxy/proxy-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.d.ts","sourceRoot":"","sources":["../../../src/proxy/proxy-server.ts"],"names":[],"mappings":""}

package/dist/esm/proxy/proxy-server.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env bun
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { NostrMCPProxy } from './index.js';
+import { PrivateKeySigner } from '../signer/private-key-signer.js';
+import { SimpleRelayPool } from '../relay/simple-relay-pool.js';
+/**
+ * Proxy server that exposes a remote Nostr MCP server via stdio.
+ * This allows MCP clients to connect to remote servers through the Nostr network.
+ */
+async function main() {
+    // Get configuration from environment variables
+    const relayUrl = process.env.RELAY_URL || 'ws://localhost:7777';
+    const clientPrivateKey = process.env.CLIENT_PRIVATE_KEY;
+    const serverPubkey = process.env.SERVER_PUBKEY;
+    if (!clientPrivateKey) {
+        console.error('CLIENT_PRIVATE_KEY environment variable is required');
+        process.exit(1);
+    }
+    if (!serverPubkey) {
+        console.error('SERVER_PUBKEY environment variable is required');
+        process.exit(1);
+    }
+    // Set up stdio transport for the server
+    const transport = new StdioServerTransport();
+    // Create Nostr components
+    const signer = new PrivateKeySigner(clientPrivateKey);
+    const relayPool = new SimpleRelayPool([relayUrl]);
+    // Create and start the proxy
+    const proxy = new NostrMCPProxy({
+        mcpHostTransport: transport,
+        nostrTransportOptions: {
+            signer,
+            relayHandler: relayPool,
+            serverPubkey,
+        },
+    });
+    // Handle cleanup on process termination
+    process.on('SIGINT', async () => {
+        await proxy.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await proxy.stop();
+        process.exit(0);
+    });
+    // Start the proxy
+    await proxy.start();
+    console.error('Proxy server started and connected to stdio');
+}
+// Run the server
+main().catch((error) => {
+    console.error('Proxy server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=proxy-server.js.map

package/dist/esm/proxy/proxy-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.js","sourceRoot":"","sources":["../../../src/proxy/proxy-server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;GAGG;AACH,KAAK,UAAU,IAAI;IACjB,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,qBAAqB,CAAC;IAChE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAE/C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,0BAA0B;IAC1B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElD,6BAA6B;IAC7B,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC;QAC9B,gBAAgB,EAAE,SAAS;QAC3B,qBAAqB,EAAE;YACrB,MAAM;YACN,YAAY,EAAE,SAAS;YACvB,YAAY;SACb;KACF,CAAC,CAAC;IAEH,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC;AAED,iBAAiB;AACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/esm/relay/index.d.ts

@@ -0,0 +1,2 @@
+export * from './simple-relay-pool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/relay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/relay/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/esm/relay/index.js

@@ -0,0 +1,2 @@
+export * from './simple-relay-pool.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/relay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/relay/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/esm/relay/simple-relay-pool.d.ts

@@ -0,0 +1,19 @@
+import { type Filter, type NostrEvent } from 'nostr-tools';
+import { RelayHandler } from '../core/interfaces.js';
+/**
+ * A RelayHandler implementation that uses a SimplePool to manage connections and subscriptions.
+ * @argument relayUrls - An array of relay URLs to connect to.
+ * @returns A RelayHandler implementation that uses a SimplePool to manage connections and subscriptions.
+ */
+export declare class SimpleRelayPool implements RelayHandler {
+    private readonly relayUrls;
+    private pool;
+    private subscriptions;
+    constructor(relayUrls: string[]);
+    connect(): Promise<void>;
+    disconnect(relayUrls?: string[]): Promise<void>;
+    publish(event: NostrEvent): Promise<void>;
+    subscribe(filters: Filter[], onEvent: (event: NostrEvent) => void, onEose?: () => void): Promise<void>;
+    unsubscribe(): void;
+}
+//# sourceMappingURL=simple-relay-pool.d.ts.map

package/dist/esm/relay/simple-relay-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-relay-pool.d.ts","sourceRoot":"","sources":["../../../src/relay/simple-relay-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,aAAa,CAAmB;gBAE5B,SAAS,EAAE,MAAM,EAAE;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,SAAS,CACb,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC;IAQhB,WAAW,IAAI,IAAI;CAKpB"}

package/dist/esm/relay/simple-relay-pool.js

@@ -0,0 +1,44 @@
+import { SimplePool } from 'nostr-tools';
+/**
+ * A RelayHandler implementation that uses a SimplePool to manage connections and subscriptions.
+ * @argument relayUrls - An array of relay URLs to connect to.
+ * @returns A RelayHandler implementation that uses a SimplePool to manage connections and subscriptions.
+ */
+export class SimpleRelayPool {
+    constructor(relayUrls) {
+        this.subscriptions = [];
+        this.relayUrls = relayUrls;
+        this.pool = new SimplePool();
+    }
+    async connect() {
+        this.relayUrls.forEach((url) => {
+            const normalizedUrl = new URL(url).href;
+            if (!this.pool.listConnectionStatus().get(normalizedUrl)) {
+                this.pool.ensureRelay(url, { connectionTimeout: 5000 });
+            }
+        });
+    }
+    async disconnect(relayUrls) {
+        if (!relayUrls) {
+            relayUrls = this.relayUrls;
+        }
+        this.pool.close(relayUrls);
+        await Bun.sleep(100);
+    }
+    async publish(event) {
+        await Promise.all(this.pool.publish(this.relayUrls, event));
+    }
+    async subscribe(filters, onEvent, onEose) {
+        const sub = this.pool.subscribeMany(this.relayUrls, filters, {
+            onevent: onEvent,
+            oneose: onEose,
+        });
+        this.subscriptions.push(sub);
+    }
+    unsubscribe() {
+        this.subscriptions.forEach((sub) => {
+            sub.close();
+        });
+    }
+}
+//# sourceMappingURL=simple-relay-pool.js.map

package/dist/esm/relay/simple-relay-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-relay-pool.js","sourceRoot":"","sources":["../../../src/relay/simple-relay-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgC,MAAM,aAAa,CAAC;AAIvE;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAK1B,YAAY,SAAmB;QAFvB,kBAAa,GAAgB,EAAE,CAAC;QAGtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC7B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAoB;QACnC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3B,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAiB;QAC7B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAiB,EACjB,OAAoC,EACpC,MAAmB;QAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE;YAC3D,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW;QACT,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/signer/index.d.ts

@@ -0,0 +1,2 @@
+export * from './private-key-signer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/signer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/signer/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/esm/signer/index.js

@@ -0,0 +1,2 @@
+export * from './private-key-signer.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/signer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/signer/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/esm/signer/private-key-signer.d.ts

@@ -0,0 +1,16 @@
+import { type NostrEvent, type UnsignedEvent } from 'nostr-tools';
+import { NostrSigner } from '../core/interfaces.js';
+/**
+ * A signer that uses a private key to sign events.
+ * @argument privateKey - The private key to use for signing.
+ * @returns A signer that uses the provided private key to sign events.
+ */
+export declare class PrivateKeySigner implements NostrSigner {
+    private readonly privateKey;
+    private readonly publicKey;
+    constructor(privateKey: string);
+    getSecretKey(): Promise<Uint8Array>;
+    getPublicKey(): Promise<string>;
+    signEvent(event: UnsignedEvent): Promise<NostrEvent>;
+}
+//# sourceMappingURL=private-key-signer.d.ts.map

package/dist/esm/signer/private-key-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-key-signer.d.ts","sourceRoot":"","sources":["../../../src/signer/private-key-signer.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,UAAU,EAAE,MAAM;IAKxB,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAInC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;CAG3D"}

package/dist/esm/signer/private-key-signer.js

@@ -0,0 +1,23 @@
+import { hexToBytes } from '@noble/hashes/utils';
+import { finalizeEvent, getPublicKey, } from 'nostr-tools';
+/**
+ * A signer that uses a private key to sign events.
+ * @argument privateKey - The private key to use for signing.
+ * @returns A signer that uses the provided private key to sign events.
+ */
+export class PrivateKeySigner {
+    constructor(privateKey) {
+        this.privateKey = hexToBytes(privateKey);
+        this.publicKey = getPublicKey(this.privateKey);
+    }
+    async getSecretKey() {
+        return this.privateKey;
+    }
+    async getPublicKey() {
+        return this.publicKey;
+    }
+    async signEvent(event) {
+        return finalizeEvent(event, this.privateKey);
+    }
+}
+//# sourceMappingURL=private-key-signer.js.map

package/dist/esm/signer/private-key-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-key-signer.js","sourceRoot":"","sources":["../../../src/signer/private-key-signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,aAAa,EACb,YAAY,GAGb,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAI3B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAoB;QAClC,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/esm/transport/base-nostr-transport.d.ts

@@ -0,0 +1,67 @@
+import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Event as NostrEvent, Filter } from 'nostr-tools';
+import { EncryptionMode, NostrSigner, RelayHandler } from '../core/interfaces.js';
+/**
+ * Base options for configuring Nostr-based transports.
+ */
+export interface BaseNostrTransportOptions {
+    signer: NostrSigner;
+    relayHandler: RelayHandler;
+    encryptionMode?: EncryptionMode;
+}
+/**
+ * Base class for Nostr-based transports that provides common functionality
+ * for managing Nostr connections, event conversion, and message handling.
+ */
+export declare abstract class BaseNostrTransport {
+    protected readonly signer: NostrSigner;
+    protected readonly relayHandler: RelayHandler;
+    protected readonly encryptionMode: EncryptionMode;
+    protected isConnected: boolean;
+    constructor(options: BaseNostrTransportOptions);
+    /**
+     * Connects to the Nostr relay network.
+     */
+    protected connect(): Promise<void>;
+    /**
+     * Disconnects from the Nostr relay network.
+     */
+    protected disconnect(): Promise<void>;
+    /**
+     * Gets the public key from the signer.
+     */
+    protected getPublicKey(): Promise<string>;
+    /**
+     * Sets up a subscription to listen for Nostr events.
+     */
+    protected subscribe(filters: Filter[], onEvent: (event: NostrEvent) => void | Promise<void>): Promise<void>;
+    /**
+     * Converts a Nostr event to an MCP message.
+     */
+    protected convertNostrEventToMcpMessage(event: NostrEvent): JSONRPCMessage;
+    /**
+     * Converts an MCP message to a Nostr event and signs it.
+     */
+    protected createSignedNostrEvent(message: JSONRPCMessage, kind: number, tags?: NostrEvent['tags']): Promise<NostrEvent>;
+    /**
+     * Publishes a signed Nostr event to the relay network.
+     */
+    protected publishEvent(event: NostrEvent): Promise<void>;
+    /**
+     * Creates and publishes a Nostr event for an MCP message.
+     */
+    protected sendMcpMessage(message: JSONRPCMessage, recipientPublicKey: string, kind: number, tags?: NostrEvent['tags'], forceEncryption?: boolean): Promise<string>;
+    /**
+     * Creates subscription filters for listening to messages targeting a specific pubkey.
+     */
+    protected createSubscriptionFilters(targetPubkey: string, additionalFilters?: Partial<Filter>): Filter[];
+    /**
+     * Creates tags for targeting a specific recipient.
+     */
+    protected createRecipientTags(recipientPubkey: string): NostrEvent['tags'];
+    /**
+     * Creates tags for responding to a specific event.
+     */
+    protected createResponseTags(recipientPubkey: string, originalEventId: string): NostrEvent['tags'];
+}
+//# sourceMappingURL=base-nostr-transport.d.ts.map

package/dist/esm/transport/base-nostr-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-nostr-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/base-nostr-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,uBAAuB,CAAC;AAe/B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;GAGG;AACH,8BAAsB,kBAAkB;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAClD,SAAS,CAAC,WAAW,UAAS;gBAElB,OAAO,EAAE,yBAAyB;IAM9C;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3C;;OAEG;cACa,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/C;;OAEG;cACa,SAAS,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACH,SAAS,CAAC,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAI1E;;OAEG;cACa,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,UAAU,CAAC;IAMtB;;OAEG;cACa,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;cACa,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,EACzB,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,MAAM,CAAC;IA0BlB;;OAEG;IACH,SAAS,CAAC,yBAAyB,CACjC,YAAY,EAAE,MAAM,EACpB,iBAAiB,GAAE,OAAO,CAAC,MAAM,CAAM,GACtC,MAAM,EAAE;IAWX;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAC1B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,UAAU,CAAC,MAAM,CAAC;CAOtB"}