@iqai/adk 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @iqai/adk
 
+## 0.1.4
+
+### Patch Changes
+
+- 5e68c31: Adds sampling handler for mcp-simplified-syntax
+
+## 0.1.3
+
+### Patch Changes
+
+- f1cb8d4: Allow mcp interface to allow parameters optional
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1500,6 +1500,38 @@ declare function createSamplingHandler(handler: SamplingHandler): SamplingHandle
  *   tools: [...atpTools, ...fraxlendTools],
  * });
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Using MCP servers with sampling handlers:
+ * import { createSamplingHandler, LlmResponse } from "@iqai/adk";
+ *
+ * const samplingHandler = createSamplingHandler(async (request) => {
+ *   // Handle MCP sampling requests
+ *   return new LlmResponse({
+ *     content: {
+ *       role: "model",
+ *       parts: [{ text: "Response from sampling handler" }],
+ *     },
+ *   });
+ * });
+ *
+ * const nearTools = await McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   },
+ *   samplingHandler
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
  */
 /**
  * Base configuration interface for MCP servers
@@ -1516,6 +1548,8 @@ interface McpServerConfig {
         maxRetries?: number;
         initialDelay?: number;
     };
+    /** Sampling handler for processing MCP sampling requests */
+    samplingHandler?: SamplingHandler;
 }
 /**
  * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
@@ -1523,25 +1557,25 @@ interface McpServerConfig {
  * Required env vars: CONTRACT_ABI, CONTRACT_ADDRESS
  * Optional env vars: CONTRACT_NAME, CHAIN_ID, RPC_URL, WALLET_PRIVATE_KEY
  */
-declare function McpAbi(config: McpServerConfig): McpToolset;
+declare function McpAbi(config?: McpServerConfig): McpToolset;
 /**
  * MCP ATP - Interact with the IQ AI Agent Tokenization Platform
  *
  * Required env vars: ATP_WALLET_PRIVATE_KEY, ATP_API_KEY
  */
-declare function McpAtp(config: McpServerConfig): McpToolset;
+declare function McpAtp(config?: McpServerConfig): McpToolset;
 /**
  * MCP BAMM - Borrow Automated Market Maker operations on Fraxtal
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpBamm(config: McpServerConfig): McpToolset;
+declare function McpBamm(config?: McpServerConfig): McpToolset;
 /**
  * MCP FRAXLEND - Interact with the Fraxlend lending platform
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpFraxlend(config: McpServerConfig): McpToolset;
+declare function McpFraxlend(config?: McpServerConfig): McpToolset;
 /**
  * MCP IQWiki - Access and manage IQ.wiki data and user activities
  *
@@ -1554,26 +1588,26 @@ declare function McpIqWiki(config?: McpServerConfig): McpToolset;
  * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
  * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
  */
-declare function McpNearAgent(config: McpServerConfig): McpToolset;
+declare function McpNearAgent(config?: McpServerConfig): McpToolset;
 /**
  * MCP NEAR Intent Swaps - NEAR Protocol intent swaps functionality
  *
  * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
  * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
  */
-declare function McpNearIntentSwaps(config: McpServerConfig): McpToolset;
+declare function McpNearIntentSwaps(config?: McpServerConfig): McpToolset;
 /**
  * MCP ODOS - Interact with decentralized exchanges through ODOS aggregation
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpOdos(config: McpServerConfig): McpToolset;
+declare function McpOdos(config?: McpServerConfig): McpToolset;
 /**
  * MCP Telegram - Interact with Telegram bots and channels
  *
  * Required env vars: TELEGRAM_BOT_TOKEN
  */
-declare function McpTelegram(config: McpServerConfig): McpToolset;
+declare function McpTelegram(config?: McpServerConfig): McpToolset;
 /**
  * Popular third-party MCP servers
  * These can be added as we expand support for community MCP servers
@@ -1594,7 +1628,7 @@ declare function McpMemory(config?: McpServerConfig): McpToolset;
  * Generic MCP server function for any package
  *
  * @param packageName The npm package name of the MCP server
- * @param config Configuration object with environment variables
+ * @param config Configuration object with environment variables and optional sampling handler
  * @param name Optional custom name for the client
  */
 declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;

package/dist/index.d.ts

@@ -1500,6 +1500,38 @@ declare function createSamplingHandler(handler: SamplingHandler): SamplingHandle
  *   tools: [...atpTools, ...fraxlendTools],
  * });
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Using MCP servers with sampling handlers:
+ * import { createSamplingHandler, LlmResponse } from "@iqai/adk";
+ *
+ * const samplingHandler = createSamplingHandler(async (request) => {
+ *   // Handle MCP sampling requests
+ *   return new LlmResponse({
+ *     content: {
+ *       role: "model",
+ *       parts: [{ text: "Response from sampling handler" }],
+ *     },
+ *   });
+ * });
+ *
+ * const nearTools = await McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   },
+ *   samplingHandler
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
  */
 /**
  * Base configuration interface for MCP servers
@@ -1516,6 +1548,8 @@ interface McpServerConfig {
         maxRetries?: number;
         initialDelay?: number;
     };
+    /** Sampling handler for processing MCP sampling requests */
+    samplingHandler?: SamplingHandler;
 }
 /**
  * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
@@ -1523,25 +1557,25 @@ interface McpServerConfig {
  * Required env vars: CONTRACT_ABI, CONTRACT_ADDRESS
  * Optional env vars: CONTRACT_NAME, CHAIN_ID, RPC_URL, WALLET_PRIVATE_KEY
  */
-declare function McpAbi(config: McpServerConfig): McpToolset;
+declare function McpAbi(config?: McpServerConfig): McpToolset;
 /**
  * MCP ATP - Interact with the IQ AI Agent Tokenization Platform
  *
  * Required env vars: ATP_WALLET_PRIVATE_KEY, ATP_API_KEY
  */
-declare function McpAtp(config: McpServerConfig): McpToolset;
+declare function McpAtp(config?: McpServerConfig): McpToolset;
 /**
  * MCP BAMM - Borrow Automated Market Maker operations on Fraxtal
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpBamm(config: McpServerConfig): McpToolset;
+declare function McpBamm(config?: McpServerConfig): McpToolset;
 /**
  * MCP FRAXLEND - Interact with the Fraxlend lending platform
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpFraxlend(config: McpServerConfig): McpToolset;
+declare function McpFraxlend(config?: McpServerConfig): McpToolset;
 /**
  * MCP IQWiki - Access and manage IQ.wiki data and user activities
  *
@@ -1554,26 +1588,26 @@ declare function McpIqWiki(config?: McpServerConfig): McpToolset;
  * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
  * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
  */
-declare function McpNearAgent(config: McpServerConfig): McpToolset;
+declare function McpNearAgent(config?: McpServerConfig): McpToolset;
 /**
  * MCP NEAR Intent Swaps - NEAR Protocol intent swaps functionality
  *
  * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
  * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
  */
-declare function McpNearIntentSwaps(config: McpServerConfig): McpToolset;
+declare function McpNearIntentSwaps(config?: McpServerConfig): McpToolset;
 /**
  * MCP ODOS - Interact with decentralized exchanges through ODOS aggregation
  *
  * Required env vars: WALLET_PRIVATE_KEY
  */
-declare function McpOdos(config: McpServerConfig): McpToolset;
+declare function McpOdos(config?: McpServerConfig): McpToolset;
 /**
  * MCP Telegram - Interact with Telegram bots and channels
  *
  * Required env vars: TELEGRAM_BOT_TOKEN
  */
-declare function McpTelegram(config: McpServerConfig): McpToolset;
+declare function McpTelegram(config?: McpServerConfig): McpToolset;
 /**
  * Popular third-party MCP servers
  * These can be added as we expand support for community MCP servers
@@ -1594,7 +1628,7 @@ declare function McpMemory(config?: McpServerConfig): McpToolset;
  * Generic MCP server function for any package
  *
  * @param packageName The npm package name of the MCP server
- * @param config Configuration object with environment variables
+ * @param config Configuration object with environment variables and optional sampling handler
  * @param name Optional custom name for the client
  */
 declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;

package/dist/index.js

@@ -5176,8 +5176,14 @@ var McpToolAdapter = (_class18 = class extends BaseTool {
 }, _class18);
 
 // src/tools/mcp/servers.ts
-function createMcpConfig(name, packageName, config) {
-  const { debug, description, retryOptions, env: envVars = {} } = config;
+function createMcpConfig(name, packageName, config = {}) {
+  const {
+    debug,
+    description,
+    retryOptions,
+    env: envVars = {},
+    samplingHandler
+  } = config;
   const env = {};
   for (const [key, value] of Object.entries(envVars)) {
     if (value !== void 0) {
@@ -5197,18 +5203,19 @@ function createMcpConfig(name, packageName, config) {
       command: "npx",
       args: ["-y", packageName],
       env
-    }
+    },
+    samplingHandler
   };
 }
-function McpAbi(config) {
+function McpAbi(config = {}) {
   const mcpConfig = createMcpConfig("ABI MCP Client", "@iqai/mcp-abi", config);
   return new McpToolset(mcpConfig);
 }
-function McpAtp(config) {
+function McpAtp(config = {}) {
   const mcpConfig = createMcpConfig("ATP MCP Client", "@iqai/mcp-atp", config);
   return new McpToolset(mcpConfig);
 }
-function McpBamm(config) {
+function McpBamm(config = {}) {
   const mcpConfig = createMcpConfig(
     "BAMM MCP Client",
     "@iqai/mcp-bamm",
@@ -5216,7 +5223,7 @@ function McpBamm(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpFraxlend(config) {
+function McpFraxlend(config = {}) {
   const mcpConfig = createMcpConfig(
     "Fraxlend MCP Client",
     "@iqai/mcp-fraxlend",
@@ -5232,7 +5239,7 @@ function McpIqWiki(config = {}) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpNearAgent(config) {
+function McpNearAgent(config = {}) {
   const mcpConfig = createMcpConfig(
     "NEAR Agent MCP Client",
     "@iqai/mcp-near-agent",
@@ -5240,7 +5247,7 @@ function McpNearAgent(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpNearIntentSwaps(config) {
+function McpNearIntentSwaps(config = {}) {
   const mcpConfig = createMcpConfig(
     "NEAR Intent Swaps MCP Client",
     "@iqai/mcp-near-intent-swaps",
@@ -5248,7 +5255,7 @@ function McpNearIntentSwaps(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpOdos(config) {
+function McpOdos(config = {}) {
   const mcpConfig = createMcpConfig(
     "ODOS MCP Client",
     "@iqai/mcp-odos",
@@ -5256,7 +5263,7 @@ function McpOdos(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpTelegram(config) {
+function McpTelegram(config = {}) {
   const mcpConfig = createMcpConfig(
     "Telegram MCP Client",
     "@iqai/mcp-telegram",

package/dist/index.mjs

@@ -5176,8 +5176,14 @@ var McpToolAdapter = class extends BaseTool {
 };
 
 // src/tools/mcp/servers.ts
-function createMcpConfig(name, packageName, config) {
-  const { debug, description, retryOptions, env: envVars = {} } = config;
+function createMcpConfig(name, packageName, config = {}) {
+  const {
+    debug,
+    description,
+    retryOptions,
+    env: envVars = {},
+    samplingHandler
+  } = config;
   const env = {};
   for (const [key, value] of Object.entries(envVars)) {
     if (value !== void 0) {
@@ -5197,18 +5203,19 @@ function createMcpConfig(name, packageName, config) {
       command: "npx",
       args: ["-y", packageName],
       env
-    }
+    },
+    samplingHandler
   };
 }
-function McpAbi(config) {
+function McpAbi(config = {}) {
   const mcpConfig = createMcpConfig("ABI MCP Client", "@iqai/mcp-abi", config);
   return new McpToolset(mcpConfig);
 }
-function McpAtp(config) {
+function McpAtp(config = {}) {
   const mcpConfig = createMcpConfig("ATP MCP Client", "@iqai/mcp-atp", config);
   return new McpToolset(mcpConfig);
 }
-function McpBamm(config) {
+function McpBamm(config = {}) {
   const mcpConfig = createMcpConfig(
     "BAMM MCP Client",
     "@iqai/mcp-bamm",
@@ -5216,7 +5223,7 @@ function McpBamm(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpFraxlend(config) {
+function McpFraxlend(config = {}) {
   const mcpConfig = createMcpConfig(
     "Fraxlend MCP Client",
     "@iqai/mcp-fraxlend",
@@ -5232,7 +5239,7 @@ function McpIqWiki(config = {}) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpNearAgent(config) {
+function McpNearAgent(config = {}) {
   const mcpConfig = createMcpConfig(
     "NEAR Agent MCP Client",
     "@iqai/mcp-near-agent",
@@ -5240,7 +5247,7 @@ function McpNearAgent(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpNearIntentSwaps(config) {
+function McpNearIntentSwaps(config = {}) {
   const mcpConfig = createMcpConfig(
     "NEAR Intent Swaps MCP Client",
     "@iqai/mcp-near-intent-swaps",
@@ -5248,7 +5255,7 @@ function McpNearIntentSwaps(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpOdos(config) {
+function McpOdos(config = {}) {
   const mcpConfig = createMcpConfig(
     "ODOS MCP Client",
     "@iqai/mcp-odos",
@@ -5256,7 +5263,7 @@ function McpOdos(config) {
   );
   return new McpToolset(mcpConfig);
 }
-function McpTelegram(config) {
+function McpTelegram(config = {}) {
   const mcpConfig = createMcpConfig(
     "Telegram MCP Client",
     "@iqai/mcp-telegram",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iqai/adk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Agent Development Kit for TypeScript with multi-provider LLM support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",