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

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

@@ -0,0 +1,270 @@
+/**
+ * @module ai/plugins/nft/schemas
+ * @description NFT Plugin — Zod schemas for NFT operations.
+ *
+ * Covers:
+ *  - Metaplex NFT management     (collection deploy, mint, metadata, royalties)
+ *  - 3.Land integration          (create collection, mint + auto-list, list for sale)
+ *  - DAS queries                 (search, get by owner, get by creator)
+ *
+ * @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 zMint = z.string().describe('NFT mint address (base58)');
+const zTx = z.string().describe('Base64-encoded serialized transaction');
+/* ═══════════════════════════════════════════════════════════════
+ *  1. Metaplex NFT Management
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regMpl, methods: metaplexNftMethods } = createMethodRegistry('metaplex-nft');
+regMpl('deployCollection', z.object({
+    authority: zPubkey.describe('Collection authority wallet'),
+    name: z.string().describe('Collection name'),
+    symbol: z.string().max(10).describe('Collection symbol'),
+    uri: z.string().url().describe('URI to collection metadata JSON'),
+    sellerFeeBasisPoints: z.number().int().min(0).max(10000).default(500)
+        .describe('Royalty fee in bps (500 = 5%)'),
+    isMutable: z.boolean().optional().default(true),
+    maxSupply: z.number().int().optional().describe('Max NFTs in collection (0 = unlimited)'),
+    creators: z.array(z.object({
+        address: zPubkey,
+        share: z.number().int().min(0).max(100).describe('Revenue share percentage'),
+        verified: z.boolean().optional().default(false),
+    })).optional().describe('Creator list with revenue shares (must sum to 100)'),
+}), z.object({
+    collectionMint: zMint.describe('Collection NFT mint address'),
+    metadataAddress: zPubkey,
+    masterEditionAddress: zPubkey,
+    tx: zTx,
+    signature: z.string().optional(),
+}), 'Deploy a new NFT collection via Metaplex. Returns the collection mint and metadata addresses.');
+regMpl('mintNFT', z.object({
+    authority: zPubkey.describe('Mint authority wallet'),
+    collection: zMint.optional().describe('Collection mint to add this NFT to'),
+    name: z.string().describe('NFT name'),
+    symbol: z.string().max(10).optional().describe('NFT symbol'),
+    uri: z.string().url().describe('URI to NFT metadata JSON (image, attributes, etc.)'),
+    sellerFeeBasisPoints: z.number().int().min(0).max(10000).default(500),
+    isMutable: z.boolean().optional().default(true),
+    creators: z.array(z.object({
+        address: zPubkey,
+        share: z.number().int().min(0).max(100),
+        verified: z.boolean().optional().default(false),
+    })).optional(),
+    recipient: zPubkey.optional().describe('Recipient wallet (default: authority)'),
+    isCompressed: z.boolean().optional().default(false).describe('Mint as compressed NFT (cNFT) for lower cost'),
+    merkleTree: zPubkey.optional().describe('Merkle tree account for compressed NFTs'),
+}), z.object({
+    mint: zMint.describe('NFT mint address'),
+    metadataAddress: zPubkey,
+    editionAddress: zPubkey.optional(),
+    tx: zTx,
+    signature: z.string().optional(),
+}), 'Mint a new NFT via Metaplex. Supports both standard and compressed (cNFT) minting.');
+regMpl('updateMetadata', z.object({
+    mint: zMint.describe('NFT mint address'),
+    updateAuthority: zPubkey.describe('Current update authority'),
+    name: z.string().optional().describe('New name'),
+    symbol: z.string().optional().describe('New symbol'),
+    uri: z.string().url().optional().describe('New metadata URI'),
+    sellerFeeBasisPoints: z.number().int().min(0).max(10000).optional(),
+    creators: z.array(z.object({
+        address: zPubkey,
+        share: z.number().int().min(0).max(100),
+        verified: z.boolean().optional(),
+    })).optional(),
+    isMutable: z.boolean().optional(),
+    primarySaleHappened: z.boolean().optional(),
+    newUpdateAuthority: zPubkey.optional().describe('Transfer update authority to a new wallet'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Update NFT metadata fields (name, symbol, URI, creators, royalties, authority).');
+regMpl('verifyCreator', z.object({
+    mint: zMint,
+    creator: zPubkey.describe('Creator wallet to verify'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Verify a creator on an NFT\'s metadata (requires creator\'s signature).');
+regMpl('verifyCollection', z.object({
+    mint: zMint.describe('NFT mint to verify'),
+    collection: zMint.describe('Collection mint'),
+    collectionAuthority: zPubkey.describe('Collection authority wallet'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Verify an NFT as part of a collection.');
+regMpl('setAndVerifyCollection', z.object({
+    mint: zMint,
+    collection: zMint,
+    collectionAuthority: zPubkey,
+    updateAuthority: zPubkey.describe('NFT update authority'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Set and verify a collection on an NFT in a single transaction.');
+regMpl('delegateAuthority', z.object({
+    mint: zMint,
+    currentAuthority: zPubkey,
+    newAuthority: zPubkey,
+    authorityType: z.enum(['update', 'mint', 'freeze', 'collection']).describe('Type of authority to delegate'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Delegate a specific authority (update, mint, freeze, collection) to another wallet.');
+regMpl('revokeAuthority', z.object({
+    mint: zMint,
+    authority: zPubkey.describe('Current authority holder'),
+    authorityType: z.enum(['update', 'mint', 'freeze', 'collection']),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Revoke (remove) a specific authority. Irreversible for some types.');
+regMpl('configureRoyalties', z.object({
+    mint: zMint,
+    updateAuthority: zPubkey,
+    sellerFeeBasisPoints: z.number().int().min(0).max(10000).describe('Royalty fee in bps'),
+    creators: z.array(z.object({
+        address: zPubkey,
+        share: z.number().int().min(0).max(100),
+    })).describe('Creator list with revenue shares (must sum to 100)'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Configure royalty fee and creator splits for an NFT.');
+/* ═══════════════════════════════════════════════════════════════
+ *  2. 3.Land NFT Marketplace
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: reg3land, methods: threeLandMethods } = createMethodRegistry('3land');
+reg3land('createCollection', z.object({
+    owner: zPubkey.describe('Collection owner wallet'),
+    name: z.string().describe('Collection name'),
+    symbol: z.string().describe('Collection symbol'),
+    description: z.string().optional().describe('Collection description'),
+    image: z.string().url().describe('Collection cover image URL'),
+    royaltyBps: z.number().int().min(0).max(10000).default(500),
+    creators: z.array(z.object({
+        address: zPubkey,
+        share: z.number().int().min(0).max(100),
+    })).optional(),
+}), z.object({
+    collectionId: z.string().describe('3.Land collection ID'),
+    collectionMint: zMint,
+    tx: zTx,
+    signature: z.string().optional(),
+}), 'Create a new NFT collection on 3.Land marketplace.');
+reg3land('mintAndList', z.object({
+    owner: zPubkey,
+    collection: z.string().describe('3.Land collection ID'),
+    name: z.string(),
+    description: z.string().optional(),
+    image: z.string().url().describe('NFT image URL'),
+    attributes: z.array(z.object({
+        trait_type: z.string(),
+        value: z.union([z.string(), z.number()]),
+    })).optional(),
+    price: z.string().describe('Listing price in token amount'),
+    priceMint: zMint.optional().describe('Price in this SPL token (default: SOL)'),
+    supply: z.number().int().positive().optional().default(1).describe('Edition supply'),
+}), z.object({
+    mint: zMint,
+    listingId: z.string(),
+    tx: zTx,
+    signature: z.string().optional(),
+}), 'Mint an NFT on 3.Land and automatically list it for sale.');
+reg3land('listForSale', z.object({
+    seller: zPubkey,
+    mint: zMint.describe('NFT mint to list'),
+    price: z.string().describe('Listing price (in specified token)'),
+    priceMint: zMint.optional().describe('SPL token for pricing (default: SOL). Any SPL token supported.'),
+    expiry: z.string().optional().describe('ISO 8601 listing expiry timestamp'),
+}), z.object({
+    listingId: z.string(),
+    tx: zTx,
+    signature: z.string().optional(),
+}), 'List an NFT for sale on 3.Land in any SPL token.');
+reg3land('cancelListing', z.object({
+    seller: zPubkey,
+    listingId: z.string().describe('3.Land listing ID to cancel'),
+}), z.object({ tx: zTx, signature: z.string().optional() }), 'Cancel an active NFT listing on 3.Land.');
+reg3land('buyNFT', z.object({
+    buyer: zPubkey,
+    listingId: z.string().describe('3.Land listing ID'),
+}), z.object({
+    mint: zMint,
+    tx: zTx,
+    price: z.string(),
+    priceMint: zMint,
+    signature: z.string().optional(),
+}), 'Purchase an NFT from a 3.Land listing.');
+/* ═══════════════════════════════════════════════════════════════
+ *  3. DAS — Digital Asset Standard queries
+ * ═══════════════════════════════════════════════════════════════ */
+const { register: regDas, methods: dasMethods } = createMethodRegistry('das');
+regDas('getAsset', z.object({
+    id: zMint.describe('Asset mint address'),
+}), z.object({
+    id: zMint,
+    content: z.object({
+        json_uri: z.string().optional(),
+        metadata: z.object({
+            name: z.string().optional(),
+            symbol: z.string().optional(),
+            description: z.string().optional(),
+            image: z.string().optional(),
+            attributes: z.array(z.object({
+                trait_type: z.string(),
+                value: z.union([z.string(), z.number()]),
+            })).optional(),
+        }).optional(),
+    }).optional(),
+    authorities: z.array(z.unknown()).optional(),
+    compression: z.object({
+        compressed: z.boolean(),
+        tree: zPubkey.optional(),
+        leaf_id: z.number().optional(),
+    }).optional(),
+    ownership: z.object({
+        owner: zPubkey,
+        delegate: zPubkey.optional(),
+        frozen: z.boolean().optional(),
+    }).optional(),
+    royalty: z.object({
+        basis_points: z.number().optional(),
+        primary_sale_happened: z.boolean().optional(),
+    }).optional(),
+}), 'Get detailed information about a single NFT/asset via DAS.');
+regDas('getAssetsByOwner', z.object({
+    ownerAddress: zPubkey,
+    page: z.number().int().positive().optional().default(1),
+    limit: z.number().int().min(1).max(1000).optional().default(100),
+    sortBy: z.enum(['created', 'updated', 'recent_action']).optional(),
+    before: z.string().optional(),
+    after: z.string().optional(),
+}), z.object({
+    items: z.array(z.unknown()),
+    total: z.number(),
+    page: z.number(),
+    limit: z.number(),
+}), 'Get all NFTs/assets owned by a wallet via DAS (supports pagination).');
+regDas('getAssetsByCreator', z.object({
+    creatorAddress: zPubkey,
+    onlyVerified: z.boolean().optional().default(true),
+    page: z.number().int().positive().optional().default(1),
+    limit: z.number().int().min(1).max(1000).optional().default(100),
+}), z.object({
+    items: z.array(z.unknown()),
+    total: z.number(),
+    page: z.number(),
+}), 'Get all NFTs/assets created by a specific creator via DAS.');
+regDas('getAssetsByCollection', z.object({
+    collectionAddress: zMint,
+    page: z.number().int().positive().optional().default(1),
+    limit: z.number().int().min(1).max(1000).optional().default(100),
+}), z.object({
+    items: z.array(z.unknown()),
+    total: z.number(),
+    page: z.number(),
+}), 'Get all NFTs in a collection via DAS.');
+regDas('searchAssets', z.object({
+    ownerAddress: zPubkey.optional(),
+    creatorAddress: zPubkey.optional(),
+    grouping: z.tuple([z.string(), z.string()]).optional().describe('Grouping key-value pair (e.g. ["collection", "mint_address"])'),
+    compressed: z.boolean().optional(),
+    frozen: z.boolean().optional(),
+    burnt: z.boolean().optional().default(false),
+    jsonUri: z.string().optional(),
+    page: z.number().int().positive().optional().default(1),
+    limit: z.number().int().min(1).max(1000).optional().default(100),
+}), z.object({
+    items: z.array(z.unknown()),
+    total: z.number(),
+    page: z.number(),
+}), 'Search NFTs/assets with flexible filters via DAS.');
+/* ═══════════════════════════════════════════════════════════════
+ *  Exports
+ * ═══════════════════════════════════════════════════════════════ */
+export { metaplexNftMethods, threeLandMethods, dasMethods };
+export const allNftMethods = [...metaplexNftMethods, ...threeLandMethods, ...dasMethods];
+//# sourceMappingURL=schemas.js.map

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

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

package/dist/esm/ai/plugins/registry.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @module ai/plugins/registry
+ * @description Plugin Registry — the `.use()` chainable infrastructure.
+ *
+ * SynapseAgentKit is the main entry point. Install plugins via `.use()`,
+ * then extract tools for LangChain, Vercel AI SDK, or MCP servers.
+ *
+ * ```ts
+ * const kit = new SynapseAgentKit({ rpcUrl: '...', walletPubkey: '...' })
+ *   .use(TokenPlugin)
+ *   .use(NFTPlugin)
+ *   .use(DefiPlugin);
+ *
+ * // LangChain
+ * const tools = kit.getTools();
+ *
+ * // Vercel AI SDK
+ * const vercelTools = kit.getVercelAITools();
+ *
+ * // MCP descriptors
+ * const mcpTools = kit.getMcpToolDescriptors();
+ * ```
+ *
+ * @since 2.0.0
+ */
+import { type ProtocolToolkit, type ProtocolTool } from '../tools/protocols/shared';
+import type { SynapsePlugin, AgentKitConfig, McpToolDescriptor, McpResourceDescriptor } from './types';
+/**
+ * @description The agent kit — chainable plugin host that produces tools for any framework.
+ *
+ * @example
+ * ```ts
+ * import { SynapseAgentKit } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins';
+ * import { TokenPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins/token';
+ * import { DefiPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins/defi';
+ *
+ * const kit = new SynapseAgentKit({ rpcUrl: process.env.RPC_URL! })
+ *   .use(TokenPlugin)
+ *   .use(DefiPlugin);
+ *
+ * // 53 RPC tools + Token tools + DeFi tools
+ * const tools = kit.getTools();
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare class SynapseAgentKit {
+    /** Installed plugins keyed by plugin ID. */
+    private readonly _plugins;
+    /** Plugin installation order. */
+    private readonly _pluginOrder;
+    /** Kit configuration. */
+    private readonly _config;
+    /** Shared plugin context. */
+    private readonly _context;
+    constructor(config: AgentKitConfig);
+    /**
+     * @description Install a plugin. Returns `this` for chaining.
+     *
+     * @param {SynapsePlugin} plugin - Plugin to install
+     * @param {Record<string, unknown>} [config] - Plugin-specific config overrides
+     * @returns {this} The agent kit (for chaining)
+     *
+     * @example
+     * ```ts
+     * kit.use(TokenPlugin).use(NFTPlugin);
+     * ```
+     *
+     * @since 2.0.0
+     */
+    use(plugin: SynapsePlugin, config?: Record<string, unknown>): this;
+    /**
+     * @description Get all LangChain-compatible tools from installed plugins.
+     * @returns {ProtocolTool[]} Flat array of all tools
+     * @since 2.0.0
+     */
+    getTools(): ProtocolTool[];
+    /**
+     * @description Get tools keyed by name for cherry-picking.
+     * @returns {Record<string, ProtocolTool>} Map of tool name → tool
+     * @since 2.0.0
+     */
+    getToolMap(): Record<string, ProtocolTool>;
+    /**
+     * @description Get tools for a specific plugin by ID.
+     * @param {string} pluginId - Plugin identifier (e.g. 'token', 'defi')
+     * @returns {ProtocolTool[] | undefined} Tools for that plugin, or undefined if not installed
+     * @since 2.0.0
+     */
+    getPluginTools(pluginId: string): ProtocolTool[] | undefined;
+    /**
+     * @description Get a specific protocol toolkit from within a plugin.
+     * @param {string} pluginId - Plugin identifier
+     * @param {string} protocolId - Protocol identifier within the plugin
+     * @returns {ProtocolToolkit | undefined}
+     * @since 2.0.0
+     */
+    getProtocolToolkit(pluginId: string, protocolId: string): ProtocolToolkit | undefined;
+    /**
+     * @description Get MCP tool descriptors for all installed plugins.
+     * @returns {McpToolDescriptor[]} MCP-compatible tool descriptors
+     * @since 2.0.0
+     */
+    getMcpToolDescriptors(): McpToolDescriptor[];
+    /**
+     * @description Get MCP resource descriptors for all installed plugins.
+     * @returns {McpResourceDescriptor[]} MCP-compatible resource descriptors
+     * @since 2.0.0
+     */
+    getMcpResourceDescriptors(): McpResourceDescriptor[];
+    /**
+     * @description Get tools formatted for the Vercel AI SDK.
+     * Returns a record of `{ toolName: { description, parameters, execute } }`.
+     *
+     * @returns {Record<string, { description: string; parameters: unknown; execute: Function }>}
+     * @since 2.0.0
+     */
+    getVercelAITools(): Record<string, {
+        description: string;
+        parameters: unknown;
+        execute: (input: Record<string, unknown>) => Promise<string>;
+    }>;
+    /**
+     * @description Get a summary of all installed plugins.
+     * @returns {{ plugins: PluginMeta[]; totalTools: number; protocols: string[] }}
+     * @since 2.0.0
+     */
+    summary(): {
+        plugins: {
+            id: string;
+            name: string;
+            toolCount: number;
+            protocols: string[];
+        }[];
+        totalTools: number;
+        totalProtocols: number;
+    };
+    /**
+     * @description Check if a plugin is installed.
+     * @param {string} pluginId - Plugin identifier
+     * @returns {boolean}
+     * @since 2.0.0
+     */
+    hasPlugin(pluginId: string): boolean;
+    /**
+     * @description List all installed plugin IDs in installation order.
+     * @returns {string[]}
+     * @since 2.0.0
+     */
+    getInstalledPlugins(): string[];
+    /**
+     * @description Destroy the agent kit and call teardown on all plugins.
+     * @since 2.0.0
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/esm/ai/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/ai/plugins/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAuB,MAAM,2BAA2B,CAAC;AAC7H,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC1B,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,EAAE,cAAc;IAkClC;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuDlE;;;;OAIG;IACH,QAAQ,IAAI,YAAY,EAAE;IAS1B;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAW1C;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,SAAS;IAI5D;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAMrF;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAsB5C;;;;OAIG;IACH,yBAAyB,IAAI,qBAAqB,EAAE;IAsBpD;;;;;;OAMG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAyB9I;;;;OAIG;IACH,OAAO,IAAI;QAAE,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAkB1I;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}