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

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

@@ -0,0 +1,215 @@
+/**
+ * @module ai/mcp/types
+ * @description MCP (Model Context Protocol) types — protocol-level interfaces.
+ *
+ * These types follow the MCP specification (2024-11-05) and are independent
+ * of `@modelcontextprotocol/sdk` so the SDK has zero MCP runtime dependencies
+ * unless the user opts in.
+ *
+ * @see https://spec.modelcontextprotocol.io/specification/2024-11-05/
+ * @since 2.0.0
+ */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface McpServerInfo {
+    name: string;
+    version: string;
+}
+export interface McpCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    logging?: Record<string, never>;
+}
+export interface McpInitializeParams {
+    protocolVersion: string;
+    capabilities?: McpCapabilities;
+    clientInfo: McpServerInfo;
+}
+export interface McpInitializeResult {
+    protocolVersion: string;
+    capabilities: McpCapabilities;
+    serverInfo: McpServerInfo;
+    instructions?: string;
+}
+export interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+export interface McpToolsListResult {
+    tools: McpToolDefinition[];
+    nextCursor?: string;
+}
+export interface McpToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+export interface McpContentItem {
+    type: 'text' | 'image' | 'resource';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    resource?: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+    };
+}
+export interface McpToolCallResult {
+    content: McpContentItem[];
+    isError?: boolean;
+}
+export interface McpResourceDefinition {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpResourcesListResult {
+    resources: McpResourceDefinition[];
+    nextCursor?: string;
+}
+export interface McpResourceReadParams {
+    uri: string;
+}
+export interface McpResourceReadResult {
+    contents: Array<{
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    }>;
+}
+export interface McpResourceTemplate {
+    uriTemplate: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpPromptDefinition {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export interface McpPromptMessage {
+    role: 'user' | 'assistant';
+    content: McpContentItem;
+}
+export interface McpGetPromptResult {
+    description?: string;
+    messages: McpPromptMessage[];
+}
+/**
+ * @description Abstract MCP transport — implement for stdio, SSE, WebSocket, etc.
+ */
+export interface McpTransport {
+    /** Start listening for messages. */
+    start(): Promise<void>;
+    /** Stop and cleanup. */
+    close(): Promise<void>;
+    /** Send a JSON-RPC message. */
+    send(message: JsonRpcResponse | JsonRpcNotification): Promise<void>;
+    /** Register handler for incoming messages. */
+    onMessage(handler: (message: JsonRpcRequest | JsonRpcNotification) => void): void;
+    /** Register close handler. */
+    onClose(handler: () => void): void;
+    /** Register error handler. */
+    onError(handler: (error: Error) => void): void;
+}
+export interface McpServerConfig {
+    /** Server name (shown to MCP clients). */
+    name?: string;
+    /** Server version. */
+    version?: string;
+    /** Server instructions/description shown to the connecting LLM. */
+    instructions?: string;
+    /** Transport mode. Default: 'stdio'. */
+    transport?: 'stdio' | 'sse';
+    /** SSE port (only for 'sse' transport). Default: 3001. */
+    ssePort?: number;
+    /** SSE path prefix. Default: '/mcp'. */
+    ssePath?: string;
+    /** Enable request logging. Default: false. */
+    debug?: boolean;
+    /** Custom capabilities to advertise. */
+    capabilities?: Partial<McpCapabilities>;
+}
+/**
+ * @description Configuration for connecting to an external MCP server.
+ */
+export interface McpExternalServerConfig {
+    /** Unique identifier for this connection. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Transport type. */
+    transport: 'stdio' | 'sse';
+    /** Command to spawn (for stdio). */
+    command?: string;
+    /** Command arguments (for stdio). */
+    args?: string[];
+    /** Environment variables (for stdio). */
+    env?: Record<string, string>;
+    /** SSE endpoint URL (for sse transport). */
+    url?: string;
+    /** SSE auth headers. */
+    headers?: Record<string, string>;
+    /** Tool name prefix to avoid collisions (e.g. 'github_'). */
+    toolPrefix?: string;
+    /** Whether to auto-reconnect on disconnect. */
+    reconnect?: boolean;
+    /** Connection timeout in ms. */
+    timeout?: number;
+}
+/**
+ * @description Status of an external MCP server connection.
+ */
+export interface McpConnectionStatus {
+    id: string;
+    name: string;
+    status: 'connected' | 'connecting' | 'disconnected' | 'error';
+    toolCount: number;
+    resourceCount: number;
+    serverInfo?: McpServerInfo;
+    error?: string;
+    connectedAt?: number;
+}
+export declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+export declare const MCP_JSONRPC_VERSION: "2.0";
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @module ai/mcp/types
+ * @description MCP (Model Context Protocol) types — protocol-level interfaces.
+ *
+ * These types follow the MCP specification (2024-11-05) and are independent
+ * of `@modelcontextprotocol/sdk` so the SDK has zero MCP runtime dependencies
+ * unless the user opts in.
+ *
+ * @see https://spec.modelcontextprotocol.io/specification/2024-11-05/
+ * @since 2.0.0
+ */
+export const MCP_PROTOCOL_VERSION = '2024-11-05';
+export const MCP_JSONRPC_VERSION = '2.0';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoPH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAc,CAAC"}

package/dist/esm/ai/plugins/blinks/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module ai/plugins/blinks
+ * @description Blinks Plugin — Solana Actions / Blinks discovery and execution.
+ *
+ * ```ts
+ * import { BlinksPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins/blinks';
+ *
+ * const kit = new SynapseAgentKit({ rpcUrl: '...' })
+ *   .use(BlinksPlugin);
+ * ```
+ *
+ * Implements the Solana Actions spec for AI agents:
+ *  - **blinks** (6)  — getAction, executeAction, confirmAction, resolveBlinkUrl,
+ *                       validateActionsJson, buildActionUrl
+ *
+ * @since 2.0.0
+ */
+import type { SynapsePlugin } from '../types';
+export { blinksMethods, allBlinksMethods } from './schemas';
+export declare const BlinksPlugin: SynapsePlugin;
+export default BlinksPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/ai/plugins/blinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/plugins/blinks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAI7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAM5D,eAAO,MAAM,YAAY,EAAE,aAkC1B,CAAC;AAwLF,eAAe,YAAY,CAAC"}

package/dist/esm/ai/plugins/blinks/index.js

@@ -0,0 +1,197 @@
+import { blinksMethods } from './schemas.js';
+export { blinksMethods, allBlinksMethods } from './schemas.js';
+/* ═══════════════════════════════════════════════════════════════
+ *  Blinks Plugin
+ * ═══════════════════════════════════════════════════════════════ */
+export const BlinksPlugin = {
+    meta: {
+        id: 'blinks',
+        name: 'Blinks Plugin',
+        description: 'Solana Actions / Blinks — discover, inspect, execute, and share on-chain actions via URL',
+        version: '2.0.0',
+        tags: ['blinks', 'actions', 'solana-actions', 'dial.to', 'shareable'],
+        mcpResources: [
+            'solana://action/{actionUrl}',
+            'solana://blink/{blinkUrl}',
+        ],
+    },
+    protocols: [
+        {
+            id: 'blinks',
+            name: 'Solana Actions (Blinks)',
+            methods: blinksMethods,
+            requiresClient: false,
+        },
+    ],
+    install(context) {
+        return {
+            executor: async (method, input, _ctx) => {
+                return executeBlinks(method, input);
+            },
+        };
+    },
+};
+/* ═══════════════════════════════════════════════════════════════
+ *  Executor
+ *
+ *  All Blinks methods are HTTP-based (Actions spec uses GET/POST).
+ *  No RPC transport needed — pure HTTP client.
+ * ═══════════════════════════════════════════════════════════════ */
+const ACTIONS_HEADERS = {
+    Accept: 'application/json',
+    'Content-Type': 'application/json',
+};
+async function executeBlinks(method, input) {
+    try {
+        switch (method.name) {
+            /* ── GET Action Metadata ─────────────────────────────────── */
+            case 'getAction': {
+                const url = input.actionUrl;
+                const res = await fetch(url, {
+                    method: 'GET',
+                    headers: ACTIONS_HEADERS,
+                });
+                if (!res.ok) {
+                    return {
+                        error: `Action endpoint returned ${res.status}`,
+                        actionUrl: url,
+                    };
+                }
+                return await res.json();
+            }
+            /* ── POST Execute Action ─────────────────────────────────── */
+            case 'executeAction': {
+                let url = input.actionUrl;
+                // Substitute template parameters: {paramName} → value
+                const params = (input.params ?? {});
+                for (const [key, value] of Object.entries(params)) {
+                    url = url.replace(`{${key}}`, encodeURIComponent(value));
+                }
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: ACTIONS_HEADERS,
+                    body: JSON.stringify({ account: input.wallet }),
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => '');
+                    return {
+                        error: `Action POST returned ${res.status}: ${text}`,
+                        actionUrl: url,
+                    };
+                }
+                return await res.json();
+            }
+            /* ── Confirm Action (chain callback) ─────────────────────── */
+            case 'confirmAction': {
+                // Per the Actions spec, some endpoints accept a callback PATCH/POST
+                // with the tx signature for chained actions.
+                const url = input.actionUrl;
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: ACTIONS_HEADERS,
+                    body: JSON.stringify({ signature: input.signature }),
+                });
+                if (!res.ok) {
+                    return { error: `Confirm returned ${res.status}`, actionUrl: url };
+                }
+                const data = await res.json();
+                return {
+                    ...data,
+                    confirmed: true,
+                };
+            }
+            /* ── Resolve Blink URL → Action URL ──────────────────────── */
+            case 'resolveBlinkUrl': {
+                const blinkUrl = input.blinkUrl;
+                const url = new URL(blinkUrl);
+                // dial.to format: https://dial.to/?action=solana-action:https://...
+                const actionParam = url.searchParams.get('action');
+                if (actionParam) {
+                    const actionUrl = actionParam.replace(/^solana-action:/, '');
+                    return {
+                        actionUrl,
+                        provider: url.hostname,
+                        isInterstitial: true,
+                    };
+                }
+                // Direct action URL
+                return {
+                    actionUrl: blinkUrl,
+                    provider: url.hostname,
+                    isInterstitial: false,
+                };
+            }
+            /* ── Validate actions.json ───────────────────────────────── */
+            case 'validateActionsJson': {
+                const domain = input.domain;
+                const actionsUrl = `https://${domain.replace(/^https?:\/\//, '')}/actions.json`;
+                const res = await fetch(actionsUrl, {
+                    headers: { Accept: 'application/json' },
+                });
+                if (!res.ok) {
+                    return {
+                        valid: false,
+                        error: `actions.json not found at ${actionsUrl} (HTTP ${res.status})`,
+                    };
+                }
+                const data = (await res.json());
+                const rules = data?.rules;
+                if (!Array.isArray(rules) || rules.length === 0) {
+                    return {
+                        valid: false,
+                        error: 'actions.json found but contains no rules array',
+                    };
+                }
+                return {
+                    valid: true,
+                    rules: rules.map((r) => ({
+                        pathPattern: r.pathPattern ?? r.pathPrefix ?? '',
+                        apiPath: r.apiPath ?? '',
+                    })),
+                };
+            }
+            /* ── Build Action URL ────────────────────────────────────── */
+            case 'buildActionUrl': {
+                let actionUrl = input.baseUrl;
+                const params = (input.params ?? {});
+                // Append query params
+                const urlObj = new URL(actionUrl);
+                for (const [key, value] of Object.entries(params)) {
+                    urlObj.searchParams.set(key, value);
+                }
+                actionUrl = urlObj.toString();
+                const provider = input.blinkProvider ?? 'none';
+                let blinkUrl;
+                if (provider !== 'none') {
+                    switch (provider) {
+                        case 'dial.to':
+                            blinkUrl = `https://dial.to/?action=solana-action:${encodeURIComponent(actionUrl)}`;
+                            break;
+                        case 'phantom':
+                            blinkUrl = `https://phantom.app/ul/browse/${encodeURIComponent(actionUrl)}`;
+                            break;
+                        case 'backpack':
+                            blinkUrl = `https://backpack.app/browse/${encodeURIComponent(actionUrl)}`;
+                            break;
+                    }
+                }
+                return {
+                    actionUrl,
+                    blinkUrl,
+                    shareable: blinkUrl ?? actionUrl,
+                };
+            }
+            default:
+                return { error: `Unknown blinks method: ${method.name}` };
+        }
+    }
+    catch (err) {
+        return {
+            error: String(err),
+            method: method.name,
+            message: 'Blinks operation failed. Check URL accessibility and network connectivity.',
+        };
+    }
+}
+export default BlinksPlugin;
+//# sourceMappingURL=index.js.map

package/dist/esm/ai/plugins/blinks/index.js.map

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

package/dist/esm/ai/plugins/blinks/schemas.d.ts

@@ -0,0 +1,4 @@
+declare const blinksMethods: import("../..").ProtocolMethod[];
+export { blinksMethods };
+export declare const allBlinksMethods: readonly import("../..").ProtocolMethod[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/esm/ai/plugins/blinks/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/ai/plugins/blinks/schemas.ts"],"names":[],"mappings":"AAmBA,QAAA,MAAsC,aAAa,kCAAmC,CAAC;AA0HvF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,eAAO,MAAM,gBAAgB,2CAA8B,CAAC"}

package/dist/esm/ai/plugins/blinks/schemas.js

@@ -0,0 +1,103 @@
+/**
+ * @module ai/plugins/blinks/schemas
+ * @description Blinks Plugin — Zod schemas for Solana Actions (Blinks) protocol.
+ *
+ * Implements the Solana Actions spec (https://solana.com/docs/advanced/actions):
+ *  - **blinks** (6 methods — discover, inspect, execute, and track Solana Actions / Blinks)
+ *
+ * @since 2.0.0
+ */
+import { z } from 'zod';
+import { createMethodRegistry } from '../../tools/protocols/shared.js';
+const zPubkey = z.string().describe('Solana public key (base58)');
+const zTx = z.string().describe('Base64-encoded serialized transaction');
+/* ═══════════════════════════════════════════════════════════════
+ *  Blinks — Solana Actions
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regBlinks, methods: blinksMethods } = createMethodRegistry('blinks');
+regBlinks('getAction', z.object({
+    actionUrl: z.string().url().describe('Solana Action URL (https endpoint implementing the Actions spec)'),
+}), z.object({
+    type: z.enum(['action', 'completed']).optional(),
+    icon: z.string().url().optional().describe('Icon URL for the Action'),
+    title: z.string().describe('Action title'),
+    description: z.string().describe('Action description'),
+    label: z.string().describe('Button label text'),
+    disabled: z.boolean().optional(),
+    error: z.object({ message: z.string() }).optional(),
+    links: z.object({
+        actions: z.array(z.object({
+            href: z.string().describe('Action endpoint URL (may contain template params)'),
+            label: z.string(),
+            parameters: z.array(z.object({
+                name: z.string(),
+                label: z.string().optional(),
+                required: z.boolean().optional(),
+                type: z.enum(['text', 'number', 'email', 'url', 'date', 'select', 'textarea', 'radio', 'checkbox'])
+                    .optional(),
+                options: z.array(z.object({
+                    label: z.string(),
+                    value: z.string(),
+                })).optional(),
+                min: z.number().optional(),
+                max: z.number().optional(),
+                pattern: z.string().optional(),
+                patternDescription: z.string().optional(),
+            })).optional(),
+        })).optional(),
+    }).optional(),
+}), 'Fetch metadata for a Solana Action (Blink) — returns title, description, available actions, and parameters.');
+regBlinks('executeAction', z.object({
+    actionUrl: z.string().url().describe('Action endpoint URL (from getAction links)'),
+    wallet: zPubkey.describe('User wallet to sign the transaction'),
+    params: z.record(z.string(), z.string()).optional()
+        .describe('Key-value parameters to fill Action template variables'),
+}), z.object({
+    transaction: zTx.describe('Base64-encoded transaction to be signed'),
+    message: z.string().optional().describe('Human-readable message from the Action provider'),
+    redirect: z.string().url().optional().describe('Optional redirect URL after completion'),
+}), 'Execute a Solana Action — sends wallet to the Action endpoint and receives a transaction to sign.');
+regBlinks('confirmAction', z.object({
+    actionUrl: z.string().url(),
+    signature: z.string().describe('Transaction signature after signing and submitting'),
+}), z.object({
+    type: z.literal('completed').optional(),
+    icon: z.string().url().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    label: z.string().optional(),
+    nextAction: z.string().url().optional().describe('URL for a chained follow-up action'),
+}), 'Confirm a completed Solana Action by sending the tx signature back to the Action provider.');
+regBlinks('resolveBlinkUrl', z.object({
+    blinkUrl: z.string().url().describe('Blink URL (e.g. https://dial.to/?action=solana-action:...)'),
+}), z.object({
+    actionUrl: z.string().url().describe('Resolved Solana Action URL'),
+    provider: z.string().optional().describe('Blink provider (dial.to, phantom, etc.)'),
+    isInterstitial: z.boolean().optional().describe('Whether this is a proxy/interstitial Blink URL'),
+}), 'Resolve a Blink URL (e.g. dial.to link) to its underlying Solana Action URL.');
+regBlinks('validateActionsJson', z.object({
+    domain: z.string().describe('Domain to check for actions.json (e.g. "jupiter.exchange")'),
+}), z.object({
+    valid: z.boolean(),
+    rules: z.array(z.object({
+        pathPattern: z.string(),
+        apiPath: z.string(),
+    })).optional(),
+    error: z.string().optional(),
+}), 'Validate a domain\'s actions.json file — checks if a website correctly implements the Solana Actions spec.');
+regBlinks('buildActionUrl', z.object({
+    baseUrl: z.string().url().describe('Action API endpoint'),
+    params: z.record(z.string(), z.string()).optional().describe('Template parameters to encode'),
+    blinkProvider: z.enum(['dial.to', 'phantom', 'backpack', 'none']).optional().default('none')
+        .describe('Optionally wrap in a Blink provider URL'),
+}), z.object({
+    actionUrl: z.string().url().describe('Constructed Solana Action URL'),
+    blinkUrl: z.string().url().optional().describe('Blink-wrapped URL (if provider selected)'),
+    shareable: z.string().optional().describe('Short shareable URL'),
+}), 'Build and optionally wrap a Solana Action URL for sharing as a Blink.');
+/* ═══════════════════════════════════════════════════════════════
+ *  Exports
+ * ═══════════════════════════════════════════════════════════════ */
+export { blinksMethods };
+export const allBlinksMethods = [...blinksMethods];
+//# sourceMappingURL=schemas.js.map

package/dist/esm/ai/plugins/blinks/schemas.js.map

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

package/dist/esm/ai/plugins/defi/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module ai/plugins/defi
+ * @description DeFi Plugin — Comprehensive DeFi protocol integrations for Solana.
+ *
+ * ```ts
+ * import { DeFiPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins/defi';
+ *
+ * const kit = new SynapseAgentKit({ rpcUrl: '...' })
+ *   .use(DeFiPlugin);
+ * ```
+ *
+ * Protocols included:
+ *  - **pump**          (2)  — Launch & trade on Pump.fun via PumpPortal
+ *  - **raydium-pools** (5)  — CPMM, CLMM, AMM v4 pool creation + liquidity
+ *  - **orca**          (5)  — Whirlpool info, swap, positions, fees
+ *  - **manifest**      (4)  — Market creation + limit orders
+ *  - **meteora**       (5)  — Dynamic AMM, DLMM, Alpha Vault
+ *  - **openbook**      (3)  — Market creation + order management
+ *  - **drift**         (7)  — Vaults, perps, lending, borrowing
+ *  - **adrena**        (5)  — Perpetuals trading
+ *  - **lulo**          (4)  — Best APR lending aggregation
+ *  - **jito**          (3)  — MEV bundles + tip estimation
+ *
+ * Total: 43 tools
+ *
+ * @since 2.0.0
+ */
+import type { SynapsePlugin } from '../types';
+export { pumpMethods, raydiumPoolMethods, orcaMethods, manifestMethods, meteoraMethods, openbookMethods, driftMethods, adrenaMethods, luloMethods, jitoMethods, allDefiMethods, } from './schemas';
+/**
+ * @description DeFi Plugin — 43 tools across 10 protocols.
+ *
+ * Usage:
+ * ```ts
+ * const kit = new SynapseAgentKit({ rpcUrl })
+ *   .use(DeFiPlugin);
+ * const tools = kit.getTools();
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare const DeFiPlugin: SynapsePlugin;
+export default DeFiPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/ai/plugins/defi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/plugins/defi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAe7D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,WAAW,CAAC;AAenB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,EAAE,aA2HxB,CAAC;AAqZF,eAAe,UAAU,CAAC"}