@oobe-protocol-labs/synapse-client-sdk 1.2.2 → 2.0.0

package/dist/esm/ai/mcp/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module ai/mcp
+ * @description MCP (Model Context Protocol) for Synapse SDK.
+ *
+ * Provides both **server** and **client** capabilities:
+ *
+ * - **Server**: Expose SynapseAgentKit tools as an MCP server (stdio/SSE)
+ * - **Client**: Connect to external MCP servers and import their tools
+ * - **Plugin**: `.use(McpPlugin)` to integrate external MCP tools
+ *
+ * @since 2.0.0
+ */
+export { SynapseMcpServer, McpServerError } from './server';
+export { McpClientBridge } from './client';
+export { MCP_PROTOCOL_VERSION, MCP_JSONRPC_VERSION, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcNotification, type McpToolDefinition, type McpToolCallParams, type McpToolCallResult, type McpResourceDefinition, type McpResourceTemplate, type McpPromptDefinition, type McpPromptMessage, type McpServerInfo, type McpCapabilities, type McpTransport, type McpServerConfig, type McpExternalServerConfig, type McpConnectionStatus, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC"}

package/dist/esm/ai/mcp/index.js

@@ -0,0 +1,19 @@
+/**
+ * @module ai/mcp
+ * @description MCP (Model Context Protocol) for Synapse SDK.
+ *
+ * Provides both **server** and **client** capabilities:
+ *
+ * - **Server**: Expose SynapseAgentKit tools as an MCP server (stdio/SSE)
+ * - **Client**: Connect to external MCP servers and import their tools
+ * - **Plugin**: `.use(McpPlugin)` to integrate external MCP tools
+ *
+ * @since 2.0.0
+ */
+// ── Server ──────────────────────────────────────────────────────
+export { SynapseMcpServer, McpServerError } from './server.js';
+// ── Client Bridge ───────────────────────────────────────────────
+export { McpClientBridge } from './client.js';
+// ── Types ───────────────────────────────────────────────────────
+export { MCP_PROTOCOL_VERSION, MCP_JSONRPC_VERSION, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/ai/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mEAAmE;AACnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5D,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,mEAAmE;AACnE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAiBpB,MAAM,SAAS,CAAC"}

package/dist/esm/ai/mcp/server.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @module ai/mcp/server
+ * @description MCP Server — exposes a SynapseAgentKit as a fully spec-compliant
+ * Model Context Protocol server over stdio or SSE.
+ *
+ * Zero external MCP dependencies — implements the protocol directly using
+ * the MCP spec (2024-11-05). Works with Claude Desktop, Cursor, VS Code,
+ * Cline, and any MCP-compatible client.
+ *
+ * ## Usage — stdio (Claude Desktop / Cursor)
+ *
+ * ```ts
+ * import { SynapseAgentKit, TokenPlugin, DeFiPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins';
+ * import { SynapseMcpServer } from '@oobe-protocol-labs/synapse-client-sdk/ai/mcp';
+ *
+ * const kit = new SynapseAgentKit({ rpcUrl: process.env.RPC_URL! })
+ *   .use(TokenPlugin)
+ *   .use(DeFiPlugin);
+ *
+ * const server = new SynapseMcpServer(kit, {
+ *   name: 'synapse-solana',
+ *   version: '2.0.0',
+ *   instructions: 'Solana blockchain tools for AI agents — token, NFT, DeFi, and more.',
+ * });
+ *
+ * await server.start(); // Listens on stdin/stdout
+ * ```
+ *
+ * ## Usage — SSE (web-based clients)
+ *
+ * ```ts
+ * const server = new SynapseMcpServer(kit, {
+ *   transport: 'sse',
+ *   ssePort: 3001,
+ *   ssePath: '/mcp',
+ * });
+ *
+ * await server.start(); // HTTP server on port 3001
+ * ```
+ *
+ * ## Claude Desktop config (claude_desktop_config.json)
+ *
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "synapse-solana": {
+ *       "command": "npx",
+ *       "args": ["synapse-mcp-server"],
+ *       "env": { "SYNAPSE_RPC_URL": "https://..." }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @since 2.0.0
+ */
+import type { SynapseAgentKit } from '../plugins/registry';
+import type { McpServerConfig } from './types';
+export declare class McpServerError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(message: string, code?: number, data?: unknown | undefined);
+}
+export declare class SynapseMcpServer {
+    private readonly kit;
+    private readonly config;
+    private readonly toolDefs;
+    private readonly resourceDefs;
+    private readonly resourceTemplates;
+    private _initialized;
+    private _running;
+    private _stdinBuffer;
+    private _httpServer;
+    private _sseClients;
+    constructor(kit: SynapseAgentKit, config?: McpServerConfig);
+    /**
+     * Start the MCP server on the configured transport.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server.
+     */
+    stop(): Promise<void>;
+    private startStdio;
+    private processStdinBuffer;
+    private startSse;
+    private handleMessage;
+    private dispatch;
+    private handleNotification;
+    private handleInitialize;
+    private handleToolsList;
+    private handleToolsCall;
+    private handleResourcesList;
+    private handleResourcesRead;
+    private handleResourceTemplatesList;
+    private buildToolDefinitions;
+    private buildResourceDefinitions;
+    private buildResourceTemplates;
+    private findMethodByName;
+    private errorResponse;
+    /**
+     * Get server info and stats.
+     */
+    info(): {
+        name: string;
+        version: string;
+        transport: string;
+        tools: number;
+        resources: number;
+        resourceTemplates: number;
+        running: boolean;
+        initialized: boolean;
+    };
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/esm/ai/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/ai/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAIV,eAAe,EAYhB,MAAM,SAAS,CAAC;AAejB,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,MAAe,EACrB,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AA6ID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwE;IAC/F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAC1D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAM;IAG1B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAA+C;gBAEtD,GAAG,EAAE,eAAe,EAAE,MAAM,GAAE,eAAoB;IAgB9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBb,UAAU;IAqBxB,OAAO,CAAC,kBAAkB;YA2BZ,QAAQ;YA6GR,aAAa;YAwCb,QAAQ;YA8CR,kBAAkB;IAiBhC,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,eAAe;YAIT,eAAe;IAoC7B,OAAO,CAAC,mBAAmB;YAIb,mBAAmB;IAkBjC,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,IAAI,IAAI;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;KACtB;CAYF"}