@iqai/adk 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @iqai/adk
 
+## 0.1.4
+
+### Patch Changes
+
+- 5e68c31: Adds sampling handler for mcp-simplified-syntax
+
 ## 0.1.3
 
 ### 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
@@ -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
@@ -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

@@ -5177,7 +5177,13 @@ var McpToolAdapter = (_class18 = class extends BaseTool {
 
 // src/tools/mcp/servers.ts
 function createMcpConfig(name, packageName, config = {}) {
-  const { debug, description, retryOptions, env: envVars = {} } = config;
+  const {
+    debug,
+    description,
+    retryOptions,
+    env: envVars = {},
+    samplingHandler
+  } = config;
   const env = {};
   for (const [key, value] of Object.entries(envVars)) {
     if (value !== void 0) {
@@ -5197,7 +5203,8 @@ function createMcpConfig(name, packageName, config = {}) {
       command: "npx",
       args: ["-y", packageName],
       env
-    }
+    },
+    samplingHandler
   };
 }
 function McpAbi(config = {}) {

package/dist/index.mjs

@@ -5177,7 +5177,13 @@ var McpToolAdapter = class extends BaseTool {
 
 // src/tools/mcp/servers.ts
 function createMcpConfig(name, packageName, config = {}) {
-  const { debug, description, retryOptions, env: envVars = {} } = config;
+  const {
+    debug,
+    description,
+    retryOptions,
+    env: envVars = {},
+    samplingHandler
+  } = config;
   const env = {};
   for (const [key, value] of Object.entries(envVars)) {
     if (value !== void 0) {
@@ -5197,7 +5203,8 @@ function createMcpConfig(name, packageName, config = {}) {
       command: "npx",
       args: ["-y", packageName],
       env
-    }
+    },
+    samplingHandler
   };
 }
 function McpAbi(config = {}) {

package/package.json

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