@inkeep/agents-sdk 0.0.0-dev-20251022190909 → 0.0.0-dev-20251022211302

package/dist/index.cjs

@@ -2756,6 +2756,29 @@ var Tool = class {
     }
     throw new Error(`Failed to update tool: ${updateResponse.status}`);
   }
+  /**
+   * Creates a new AgentMcpConfig with the given configuration.
+   *
+   * @param config - The configuration for the AgentMcpConfig
+   * @returns A new AgentMcpConfig
+   *
+   * example:
+   * ```typescript
+   * const tool = new Tool({
+   *   id: 'tool-id',
+   *   name: 'Tool Name',
+   *   serverUrl: 'https://example.com/mcp',
+   * });
+   * const agentMcpConfig = tool.with({ selectedTools: ['tool-1', 'tool-2'], headers: { 'Authorization': 'Bearer token' } });
+   * ```
+   */
+  with(config) {
+    return {
+      server: this,
+      selectedTools: config.selectedTools,
+      headers: config.headers
+    };
+  }
 };
 
 // src/utils/tool-normalization.ts

package/dist/index.d.cts

@@ -40,6 +40,7 @@ interface ToolInterface {
     getServerUrl(): string;
     getActiveTools(): string[] | undefined;
     getCredentialReferenceId(): string | null | undefined;
+    with(config: AgentMcpConfigInput): AgentMcpConfig;
 }
 declare class Tool implements ToolInterface {
     config: MCPToolConfig$1;
@@ -59,6 +60,23 @@ declare class Tool implements ToolInterface {
         skipDatabaseRegistration?: boolean;
     }): Promise<void>;
     private upsertTool;
+    /**
+     * Creates a new AgentMcpConfig with the given configuration.
+     *
+     * @param config - The configuration for the AgentMcpConfig
+     * @returns A new AgentMcpConfig
+     *
+     * example:
+     * ```typescript
+     * const tool = new Tool({
+     *   id: 'tool-id',
+     *   name: 'Tool Name',
+     *   serverUrl: 'https://example.com/mcp',
+     * });
+     * const agentMcpConfig = tool.with({ selectedTools: ['tool-1', 'tool-2'], headers: { 'Authorization': 'Bearer token' } });
+     * ```
+     */
+    with(config: AgentMcpConfigInput): AgentMcpConfig;
 }
 
 declare class SubAgent implements SubAgentInterface {
@@ -149,6 +167,15 @@ type AgentMcpConfig = {
     selectedTools?: string[];
     headers?: Record<string, string>;
 };
+/**
+ * Input configuration for MCP tool customization
+ */
+type AgentMcpConfigInput = {
+    /** Specific tools to enable from the MCP server */
+    selectedTools?: string[];
+    /** Custom headers for MCP server requests */
+    headers?: Record<string, string>;
+};
 /**
  * Creates a transfer configuration for agent transfers.
  *
@@ -1187,6 +1214,14 @@ declare function dataComponent(config: DataComponentConfig): DataComponent;
  * ```
  */
 declare function statusComponent(config: StatusComponentConfig): StatusComponent;
+/**
+ * (deprecated in favor of mcpTool.with()) Creates an agent MCP configuration.
+ *
+ * Agent MCP configurations are used to configure the MCP server for an agent.
+ *
+ * @param config - Agent MCP configuration
+ * @returns An AgentMcpConfig instance
+ */
 declare function agentMcp(config: AgentMcpConfig): AgentMcpConfig;
 /**
  * Creates a function tool that executes user-defined code in a sandboxed environment.

package/dist/index.d.ts

@@ -40,6 +40,7 @@ interface ToolInterface {
     getServerUrl(): string;
     getActiveTools(): string[] | undefined;
     getCredentialReferenceId(): string | null | undefined;
+    with(config: AgentMcpConfigInput): AgentMcpConfig;
 }
 declare class Tool implements ToolInterface {
     config: MCPToolConfig$1;
@@ -59,6 +60,23 @@ declare class Tool implements ToolInterface {
         skipDatabaseRegistration?: boolean;
     }): Promise<void>;
     private upsertTool;
+    /**
+     * Creates a new AgentMcpConfig with the given configuration.
+     *
+     * @param config - The configuration for the AgentMcpConfig
+     * @returns A new AgentMcpConfig
+     *
+     * example:
+     * ```typescript
+     * const tool = new Tool({
+     *   id: 'tool-id',
+     *   name: 'Tool Name',
+     *   serverUrl: 'https://example.com/mcp',
+     * });
+     * const agentMcpConfig = tool.with({ selectedTools: ['tool-1', 'tool-2'], headers: { 'Authorization': 'Bearer token' } });
+     * ```
+     */
+    with(config: AgentMcpConfigInput): AgentMcpConfig;
 }
 
 declare class SubAgent implements SubAgentInterface {
@@ -149,6 +167,15 @@ type AgentMcpConfig = {
     selectedTools?: string[];
     headers?: Record<string, string>;
 };
+/**
+ * Input configuration for MCP tool customization
+ */
+type AgentMcpConfigInput = {
+    /** Specific tools to enable from the MCP server */
+    selectedTools?: string[];
+    /** Custom headers for MCP server requests */
+    headers?: Record<string, string>;
+};
 /**
  * Creates a transfer configuration for agent transfers.
  *
@@ -1187,6 +1214,14 @@ declare function dataComponent(config: DataComponentConfig): DataComponent;
  * ```
  */
 declare function statusComponent(config: StatusComponentConfig): StatusComponent;
+/**
+ * (deprecated in favor of mcpTool.with()) Creates an agent MCP configuration.
+ *
+ * Agent MCP configurations are used to configure the MCP server for an agent.
+ *
+ * @param config - Agent MCP configuration
+ * @returns An AgentMcpConfig instance
+ */
 declare function agentMcp(config: AgentMcpConfig): AgentMcpConfig;
 /**
  * Creates a function tool that executes user-defined code in a sandboxed environment.

package/dist/index.js

@@ -2729,6 +2729,29 @@ var Tool = class {
     }
     throw new Error(`Failed to update tool: ${updateResponse.status}`);
   }
+  /**
+   * Creates a new AgentMcpConfig with the given configuration.
+   *
+   * @param config - The configuration for the AgentMcpConfig
+   * @returns A new AgentMcpConfig
+   *
+   * example:
+   * ```typescript
+   * const tool = new Tool({
+   *   id: 'tool-id',
+   *   name: 'Tool Name',
+   *   serverUrl: 'https://example.com/mcp',
+   * });
+   * const agentMcpConfig = tool.with({ selectedTools: ['tool-1', 'tool-2'], headers: { 'Authorization': 'Bearer token' } });
+   * ```
+   */
+  with(config) {
+    return {
+      server: this,
+      selectedTools: config.selectedTools,
+      headers: config.headers
+    };
+  }
 };
 
 // src/utils/tool-normalization.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.0.0-dev-20251022190909",
+  "version": "0.0.0-dev-20251022211302",
   "description": "Agents SDK for building and managing agents in the Inkeep Agent Framework",
   "main": "dist/index.js",
   "type": "module",
@@ -12,7 +12,7 @@
     "nanoid": "^5.1.5",
     "typescript": "^5.3.3",
     "zod": "^4.1.11",
-    "@inkeep/agents-core": "^0.0.0-dev-20251022190909"
+    "@inkeep/agents-core": "^0.0.0-dev-20251022211302"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",