@inkeep/agents-sdk 0.26.2 → 0.28.0

package/dist/index.cjs

@@ -514,7 +514,12 @@ var Agent = class {
     this.subAgents = resolveGetter(config.subAgents) || [];
     this.agentMap = new Map(this.subAgents.map((agent2) => [agent2.getId(), agent2]));
     if (this.defaultSubAgent) {
-      this.subAgents.push(this.defaultSubAgent);
+      const isAlreadyPresent = this.subAgents.some(
+        (agent2) => agent2.getId() === this.defaultSubAgent?.getId()
+      );
+      if (!isAlreadyPresent) {
+        this.subAgents.push(this.defaultSubAgent);
+      }
       this.agentMap.set(this.defaultSubAgent.getId(), this.defaultSubAgent);
     }
     if (this.models) {
@@ -655,9 +660,10 @@ var Agent = class {
               externalAgentId: d.externalAgent.getId(),
               ...d.headers && { headers: d.headers }
             };
-          } else if (typeof d === "object" && "type" in d && d.type === "external") {
+          } else if (typeof d === "object" && "agent" in d) {
             return {
-              externalAgentId: d.getId()
+              agentId: d.agent.getId(),
+              ...d.headers && { headers: d.headers }
             };
           }
           return d.getId();
@@ -1037,6 +1043,12 @@ var Agent = class {
       tenantId: this.tenantId
     };
   }
+  with(options) {
+    return {
+      agent: this,
+      headers: options.headers
+    };
+  }
   /**
    * Validate the agent configuration
    */
@@ -1505,7 +1517,8 @@ var DataComponent = class {
     this.config = {
       ...config,
       id: this.id,
-      props: processedProps
+      props: processedProps,
+      render: config.render || null
     };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.tenantId = "default";
@@ -1539,6 +1552,9 @@ var DataComponent = class {
   getProps() {
     return this.config.props;
   }
+  getRender() {
+    return this.config.render;
+  }
   // Public method to ensure data component exists in backend (with upsert behavior)
   async init() {
     if (this.initialized) return;
@@ -1568,7 +1584,8 @@ var DataComponent = class {
       id: this.getId(),
       name: this.config.name,
       description: this.config.description,
-      props: this.config.props
+      props: this.config.props,
+      render: this.config.render
     };
     logger6.info({ dataComponentData }, "dataComponentData for create/update");
     const updateResponse = await fetch(
@@ -2387,23 +2404,27 @@ var Project = class {
             let dataComponentName;
             let dataComponentDescription;
             let dataComponentProps;
+            let dataComponentRender;
             if (dataComponent2.getId) {
               dataComponentId = dataComponent2.getId();
               dataComponentName = dataComponent2.getName();
               dataComponentDescription = dataComponent2.getDescription() || "";
               dataComponentProps = dataComponent2.getProps() || {};
+              dataComponentRender = dataComponent2.getRender?.() || null;
             } else {
               dataComponentId = dataComponent2.id || (dataComponent2.name ? dataComponent2.name.toLowerCase().replace(/\s+/g, "-") : "");
               dataComponentName = dataComponent2.name || "";
               dataComponentDescription = dataComponent2.description || "";
               dataComponentProps = dataComponent2.props || {};
+              dataComponentRender = dataComponent2.render || null;
             }
             if (!dataComponentsObject[dataComponentId] && dataComponentName) {
               dataComponentsObject[dataComponentId] = {
                 id: dataComponentId,
                 name: dataComponentName,
                 description: dataComponentDescription,
-                props: dataComponentProps
+                props: dataComponentProps,
+                render: dataComponentRender
               };
             }
           }
@@ -2744,6 +2765,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
@@ -2871,6 +2915,12 @@ var SubAgent = class {
       if (typeof delegate === "object" && "externalAgent" in delegate) {
         return false;
       }
+      if (typeof delegate === "object" && "agent" in delegate) {
+        return false;
+      }
+      if (typeof delegate === "object" && "toFullAgentDefinition" in delegate) {
+        return false;
+      }
       if (typeof delegate === "object" && "type" in delegate && delegate.type === "external") {
         return false;
       }
@@ -2899,8 +2949,34 @@ var SubAgent = class {
       };
     });
   }
+  getTeamAgentDelegates() {
+    if (typeof this.config.canDelegateTo !== "function") {
+      return [];
+    }
+    return this.config.canDelegateTo().filter((delegate) => {
+      if (typeof delegate === "object" && "agent" in delegate) {
+        return true;
+      }
+      if (typeof delegate === "object" && "toFullAgentDefinition" in delegate) {
+        return true;
+      }
+      return false;
+    }).map((delegate) => {
+      if ("agent" in delegate) {
+        return delegate;
+      }
+      return {
+        agent: delegate,
+        headers: void 0
+      };
+    });
+  }
   getDelegates() {
-    return typeof this.config.canDelegateTo === "function" ? this.config.canDelegateTo() : [];
+    return [
+      ...this.getSubAgentDelegates(),
+      ...this.getTeamAgentDelegates(),
+      ...this.getExternalAgentDelegates()
+    ];
   }
   getDataComponents() {
     const components = resolveGetter2(this.config.dataComponents) || [];
@@ -2910,7 +2986,8 @@ var SubAgent = class {
           id: comp.getId(),
           name: comp.getName(),
           description: comp.getDescription(),
-          props: comp.getProps()
+          props: comp.getProps(),
+          render: comp.getRender?.() || null
         };
       }
       if (comp && typeof comp === "object" && comp.props && schemaConversion.isZodSchema(comp.props)) {
@@ -2918,7 +2995,8 @@ var SubAgent = class {
           id: comp.id,
           name: comp.name,
           description: comp.description,
-          props: schemaConversion.convertZodToJsonSchemaWithPreview(comp.props)
+          props: schemaConversion.convertZodToJsonSchemaWithPreview(comp.props),
+          render: comp.render || null
         };
       }
       return comp;
@@ -3410,7 +3488,8 @@ var SubAgent = class {
         id: dataComponent2.id,
         name: dataComponent2.name,
         description: dataComponent2.description,
-        props: dataComponent2.props
+        props: dataComponent2.props,
+        render: dataComponent2.render
       });
       dc.setContext(this.tenantId, this.projectId);
       await dc.init();
@@ -3668,6 +3747,35 @@ function isCredentialReference(value) {
 // src/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
+    getEnvironmentCredential: (key) => {
+      const currentEnv = process.env.INKEEP_ENV || "development";
+      const env = environments[currentEnv];
+      if (!env) {
+        throw new Error(
+          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
+        );
+      }
+      const credential2 = env.credentials?.[key];
+      if (!credential2) {
+        throw new Error(`Credential '${String(key)}' not found in environment '${currentEnv}'`);
+      }
+      return credential2;
+    },
+    getEnvironmentMcp: (key) => {
+      const currentEnv = process.env.INKEEP_ENV || "development";
+      const env = environments[currentEnv];
+      if (!env) {
+        throw new Error(
+          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
+        );
+      }
+      const mcpServer2 = env.mcpServers?.[key];
+      if (!mcpServer2) {
+        throw new Error(`MCP Server '${String(key)}' not found in environment '${currentEnv}'`);
+      }
+      return mcpServer2;
+    },
+    //Deprecated: Use getEnvironmentCredential instead
     getEnvironmentSetting: (key) => {
       const currentEnv = process.env.INKEEP_ENV || "development";
       const env = environments[currentEnv];

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ArtifactComponentInsert, MCPToolConfig as MCPToolConfig$1, DataComponentApiInsert, ArtifactComponentApiInsert, CredentialReferenceApiInsert, DataComponentInsert, FunctionToolConfig, SubAgentApiInsert, AgentConversationHistoryConfig, AgentStopWhen, ModelSettings, StatusUpdateSettings, FullAgentDefinition, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition, StatusComponent as StatusComponent$1 } from '@inkeep/agents-core';
+import { ArtifactComponentInsert, MCPToolConfig as MCPToolConfig$1, DataComponentApiInsert, ArtifactComponentApiInsert, CredentialReferenceApiInsert, DataComponentInsert, FunctionToolConfig, SubAgentApiInsert, FullAgentDefinition, AgentConversationHistoryConfig, AgentStopWhen, ModelSettings, StatusUpdateSettings, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition, StatusComponent as StatusComponent$1 } from '@inkeep/agents-core';
 export { ANTHROPIC_MODELS, FunctionToolConfig, GOOGLE_MODELS, ModelSettings, OPENAI_MODELS } from '@inkeep/agents-core';
 import { z } from 'zod';
 
@@ -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 {
@@ -83,12 +101,13 @@ declare class SubAgent implements SubAgentInterface {
     getTransfers(): SubAgentInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getTeamAgentDelegates(): subAgentTeamAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getDataComponents(): DataComponentApiInsert[];
     getArtifactComponents(): ArtifactComponentApiInsert[];
     addTool(_name: string, tool: Tool): void;
     addTransfer(...agents: SubAgentInterface[]): void;
-    addDelegate(...agents: AllSubAgentInterface[]): void;
+    addDelegate(...agents: AllDelegateInputInterface[]): void;
     init(): Promise<void>;
     private upsertAgent;
     private saveToolsAndRelations;
@@ -137,6 +156,10 @@ interface ArtifactComponentConfig extends ComponentConfig {
 }
 interface DataComponentConfig extends ComponentConfig {
     props: Record<string, unknown> | z.ZodObject<any>;
+    render?: {
+        component: string;
+        mockData: Record<string, unknown>;
+    };
 }
 interface StatusComponentConfig {
     type: string;
@@ -148,6 +171,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.
  *
@@ -174,8 +206,12 @@ type AgentMcpConfig = {
  */
 declare function transfer(targetAgent: SubAgent, description?: string, condition?: TransferConditionFunction): TransferConfig;
 
-type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projectId' | 'props'> & {
+type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projectId' | 'props' | 'render'> & {
     props?: Record<string, unknown> | z.ZodObject<any> | null;
+    render?: {
+        component: string;
+        mockData: Record<string, unknown>;
+    } | null;
 };
 interface DataComponentInterface {
     config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
@@ -199,6 +235,7 @@ declare class DataComponent implements DataComponentInterface {
     getName(): string;
     getDescription(): string;
     getProps(): DataComponentInsert['props'];
+    getRender(): DataComponentInsert['render'];
     init(): Promise<void>;
     private upsertDataComponent;
 }
@@ -347,13 +384,14 @@ interface ToolResult {
     result: any;
     error?: string;
 }
-type AllSubAgentInterface = SubAgentInterface | subAgentExternalAgentInterface | ExternalAgentInterface;
+type AllDelegateInputInterface = SubAgentInterface | subAgentExternalAgentInterface | ExternalAgentInterface | AgentInterface | subAgentTeamAgentInterface;
+type AllDelegateOutputInterface = SubAgentInterface | subAgentExternalAgentInterface | subAgentTeamAgentInterface;
 type SubAgentCanUseType = Tool | AgentMcpConfig | FunctionTool;
 interface SubAgentConfig extends Omit<SubAgentApiInsert, 'projectId'> {
     type?: 'internal';
     canUse?: () => SubAgentCanUseType[];
     canTransferTo?: () => SubAgentInterface[];
-    canDelegateTo?: () => AllSubAgentInterface[];
+    canDelegateTo?: () => AllDelegateInputInterface[];
     dataComponents?: () => (DataComponentApiInsert | DataComponentInterface | DataComponentWithZodProps)[];
     artifactComponents?: () => (ArtifactComponentApiInsert | ArtifactComponentInterface | ArtifactComponentWithZodProps)[];
     conversationHistoryConfig?: AgentConversationHistoryConfig;
@@ -462,7 +500,7 @@ interface AgentConfig {
     id: string;
     name?: string;
     description?: string;
-    defaultSubAgent?: SubAgentInterface;
+    defaultSubAgent: SubAgentInterface;
     subAgents?: () => SubAgentInterface[];
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
@@ -499,7 +537,7 @@ interface SubAgentInterface {
     getInstructions(): string;
     getTools(): Record<string, AgentTool>;
     getTransfers(): SubAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -507,7 +545,7 @@ interface SubAgentInterface {
     setContext(tenantId: string, projectId: string, baseURL?: string): void;
     addTool(name: string, tool: any): void;
     addTransfer(...agents: SubAgentInterface[]): void;
-    addDelegate(...agents: AllSubAgentInterface[]): void;
+    addDelegate(...agents: AllDelegateInputInterface[]): void;
 }
 interface ExternalAgentInterface {
     config: ExternalAgentConfig;
@@ -518,6 +556,9 @@ interface ExternalAgentInterface {
     getDescription(): string;
     getBaseUrl(): string;
     setContext?(tenantId: string, projectId: string): void;
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentExternalAgentInterface;
     getCredentialReferenceId(): string | undefined;
     getCredentialReference(): CredentialReferenceApiInsert | undefined;
 }
@@ -525,6 +566,10 @@ type subAgentExternalAgentInterface = {
     externalAgent: ExternalAgentInterface;
     headers?: Record<string, string>;
 };
+type subAgentTeamAgentInterface = {
+    agent: AgentInterface;
+    headers?: Record<string, string>;
+};
 interface AgentInterface {
     init(): Promise<void>;
     setConfig(tenantId: string, projectId: string, apiUrl: string): void;
@@ -539,6 +584,9 @@ interface AgentInterface {
     getSubAgent(name: string): SubAgentInterface | undefined;
     getSubAgents(): SubAgentInterface[];
     toFullAgentDefinition(): Promise<FullAgentDefinition>;
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
 }
 interface BuilderToolConfig {
     name: string;
@@ -686,6 +734,9 @@ declare class Agent implements AgentInterface {
         agentId: string;
         tenantId: string;
     };
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
     /**
      * Validate the agent configuration
      */
@@ -697,7 +748,7 @@ declare class Agent implements AgentInterface {
     /**
      * Type guard to check if an agent is an internal AgentInterface
      */
-    isInternalAgent(agent: AllSubAgentInterface): agent is SubAgentInterface;
+    isInternalAgent(agent: AllDelegateInputInterface): agent is SubAgentInterface;
     /**
      * Get project-level model settingsuration defaults
      */
@@ -1172,6 +1223,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.
@@ -1263,16 +1322,33 @@ type ExtractCredentialIds<T> = T extends {
 type UnionCredentialIds<T extends Record<string, any>> = {
     [K in keyof T]: ExtractCredentialIds<T[K]>;
 }[keyof T];
+/**
+ * Type helper to extract tool IDs from environment configuration
+ */
+type ExtractMcpServerIds<T> = T extends {
+    mcpServers?: infer T;
+} ? T extends Record<string, any> ? keyof T : never : never;
+/**
+ * Type helper to create a union of all available tool IDs from multiple environments
+ */
+type UnionMcpServerIds<T extends Record<string, any>> = {
+    [K in keyof T]: ExtractMcpServerIds<T[K]>;
+}[keyof T];
 
 interface EnvironmentSettingsConfig {
     credentials?: {
         [settingId: string]: CredentialReferenceApiInsert;
     };
+    mcpServers?: {
+        [mcpServerId: string]: Tool;
+    };
 }
 /**
  * Create a setting helper with TypeScript autocomplete
  */
 declare function createEnvironmentSettings<T extends Record<string, EnvironmentSettingsConfig>>(environments: T): {
+    getEnvironmentCredential: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
+    getEnvironmentMcp: (key: UnionMcpServerIds<T>) => Tool;
     getEnvironmentSetting: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
 };
 /**
@@ -1339,4 +1415,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceAgents: typeof Runner.raceAgents;
 
-export { type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllSubAgentInterface, ArtifactComponent, type ArtifactComponentInterface, type ArtifactComponentWithZodProps, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, type DataComponentWithZodProps, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, type FetchDefinitionConfig, FunctionTool, type GenerateOptions, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, StatusComponent, type StatusComponentInterface, type StreamEvent, type StreamResponse, SubAgent, type SubAgentCanUseType, type SubAgentConfig, type SubAgentInterface, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, statusComponent, stream, subAgent, type subAgentExternalAgentInterface, transfer, updateFullProjectViaAPI };
+export { type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllDelegateInputInterface, type AllDelegateOutputInterface, ArtifactComponent, type ArtifactComponentInterface, type ArtifactComponentWithZodProps, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, type DataComponentWithZodProps, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, type FetchDefinitionConfig, FunctionTool, type GenerateOptions, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, StatusComponent, type StatusComponentInterface, type StreamEvent, type StreamResponse, SubAgent, type SubAgentCanUseType, type SubAgentConfig, type SubAgentInterface, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, statusComponent, stream, subAgent, type subAgentExternalAgentInterface, type subAgentTeamAgentInterface, transfer, updateFullProjectViaAPI };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ArtifactComponentInsert, MCPToolConfig as MCPToolConfig$1, DataComponentApiInsert, ArtifactComponentApiInsert, CredentialReferenceApiInsert, DataComponentInsert, FunctionToolConfig, SubAgentApiInsert, AgentConversationHistoryConfig, AgentStopWhen, ModelSettings, StatusUpdateSettings, FullAgentDefinition, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition, StatusComponent as StatusComponent$1 } from '@inkeep/agents-core';
+import { ArtifactComponentInsert, MCPToolConfig as MCPToolConfig$1, DataComponentApiInsert, ArtifactComponentApiInsert, CredentialReferenceApiInsert, DataComponentInsert, FunctionToolConfig, SubAgentApiInsert, FullAgentDefinition, AgentConversationHistoryConfig, AgentStopWhen, ModelSettings, StatusUpdateSettings, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition, StatusComponent as StatusComponent$1 } from '@inkeep/agents-core';
 export { ANTHROPIC_MODELS, FunctionToolConfig, GOOGLE_MODELS, ModelSettings, OPENAI_MODELS } from '@inkeep/agents-core';
 import { z } from 'zod';
 
@@ -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 {
@@ -83,12 +101,13 @@ declare class SubAgent implements SubAgentInterface {
     getTransfers(): SubAgentInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getTeamAgentDelegates(): subAgentTeamAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getDataComponents(): DataComponentApiInsert[];
     getArtifactComponents(): ArtifactComponentApiInsert[];
     addTool(_name: string, tool: Tool): void;
     addTransfer(...agents: SubAgentInterface[]): void;
-    addDelegate(...agents: AllSubAgentInterface[]): void;
+    addDelegate(...agents: AllDelegateInputInterface[]): void;
     init(): Promise<void>;
     private upsertAgent;
     private saveToolsAndRelations;
@@ -137,6 +156,10 @@ interface ArtifactComponentConfig extends ComponentConfig {
 }
 interface DataComponentConfig extends ComponentConfig {
     props: Record<string, unknown> | z.ZodObject<any>;
+    render?: {
+        component: string;
+        mockData: Record<string, unknown>;
+    };
 }
 interface StatusComponentConfig {
     type: string;
@@ -148,6 +171,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.
  *
@@ -174,8 +206,12 @@ type AgentMcpConfig = {
  */
 declare function transfer(targetAgent: SubAgent, description?: string, condition?: TransferConditionFunction): TransferConfig;
 
-type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projectId' | 'props'> & {
+type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projectId' | 'props' | 'render'> & {
     props?: Record<string, unknown> | z.ZodObject<any> | null;
+    render?: {
+        component: string;
+        mockData: Record<string, unknown>;
+    } | null;
 };
 interface DataComponentInterface {
     config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
@@ -199,6 +235,7 @@ declare class DataComponent implements DataComponentInterface {
     getName(): string;
     getDescription(): string;
     getProps(): DataComponentInsert['props'];
+    getRender(): DataComponentInsert['render'];
     init(): Promise<void>;
     private upsertDataComponent;
 }
@@ -347,13 +384,14 @@ interface ToolResult {
     result: any;
     error?: string;
 }
-type AllSubAgentInterface = SubAgentInterface | subAgentExternalAgentInterface | ExternalAgentInterface;
+type AllDelegateInputInterface = SubAgentInterface | subAgentExternalAgentInterface | ExternalAgentInterface | AgentInterface | subAgentTeamAgentInterface;
+type AllDelegateOutputInterface = SubAgentInterface | subAgentExternalAgentInterface | subAgentTeamAgentInterface;
 type SubAgentCanUseType = Tool | AgentMcpConfig | FunctionTool;
 interface SubAgentConfig extends Omit<SubAgentApiInsert, 'projectId'> {
     type?: 'internal';
     canUse?: () => SubAgentCanUseType[];
     canTransferTo?: () => SubAgentInterface[];
-    canDelegateTo?: () => AllSubAgentInterface[];
+    canDelegateTo?: () => AllDelegateInputInterface[];
     dataComponents?: () => (DataComponentApiInsert | DataComponentInterface | DataComponentWithZodProps)[];
     artifactComponents?: () => (ArtifactComponentApiInsert | ArtifactComponentInterface | ArtifactComponentWithZodProps)[];
     conversationHistoryConfig?: AgentConversationHistoryConfig;
@@ -462,7 +500,7 @@ interface AgentConfig {
     id: string;
     name?: string;
     description?: string;
-    defaultSubAgent?: SubAgentInterface;
+    defaultSubAgent: SubAgentInterface;
     subAgents?: () => SubAgentInterface[];
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
@@ -499,7 +537,7 @@ interface SubAgentInterface {
     getInstructions(): string;
     getTools(): Record<string, AgentTool>;
     getTransfers(): SubAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -507,7 +545,7 @@ interface SubAgentInterface {
     setContext(tenantId: string, projectId: string, baseURL?: string): void;
     addTool(name: string, tool: any): void;
     addTransfer(...agents: SubAgentInterface[]): void;
-    addDelegate(...agents: AllSubAgentInterface[]): void;
+    addDelegate(...agents: AllDelegateInputInterface[]): void;
 }
 interface ExternalAgentInterface {
     config: ExternalAgentConfig;
@@ -518,6 +556,9 @@ interface ExternalAgentInterface {
     getDescription(): string;
     getBaseUrl(): string;
     setContext?(tenantId: string, projectId: string): void;
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentExternalAgentInterface;
     getCredentialReferenceId(): string | undefined;
     getCredentialReference(): CredentialReferenceApiInsert | undefined;
 }
@@ -525,6 +566,10 @@ type subAgentExternalAgentInterface = {
     externalAgent: ExternalAgentInterface;
     headers?: Record<string, string>;
 };
+type subAgentTeamAgentInterface = {
+    agent: AgentInterface;
+    headers?: Record<string, string>;
+};
 interface AgentInterface {
     init(): Promise<void>;
     setConfig(tenantId: string, projectId: string, apiUrl: string): void;
@@ -539,6 +584,9 @@ interface AgentInterface {
     getSubAgent(name: string): SubAgentInterface | undefined;
     getSubAgents(): SubAgentInterface[];
     toFullAgentDefinition(): Promise<FullAgentDefinition>;
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
 }
 interface BuilderToolConfig {
     name: string;
@@ -686,6 +734,9 @@ declare class Agent implements AgentInterface {
         agentId: string;
         tenantId: string;
     };
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
     /**
      * Validate the agent configuration
      */
@@ -697,7 +748,7 @@ declare class Agent implements AgentInterface {
     /**
      * Type guard to check if an agent is an internal AgentInterface
      */
-    isInternalAgent(agent: AllSubAgentInterface): agent is SubAgentInterface;
+    isInternalAgent(agent: AllDelegateInputInterface): agent is SubAgentInterface;
     /**
      * Get project-level model settingsuration defaults
      */
@@ -1172,6 +1223,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.
@@ -1263,16 +1322,33 @@ type ExtractCredentialIds<T> = T extends {
 type UnionCredentialIds<T extends Record<string, any>> = {
     [K in keyof T]: ExtractCredentialIds<T[K]>;
 }[keyof T];
+/**
+ * Type helper to extract tool IDs from environment configuration
+ */
+type ExtractMcpServerIds<T> = T extends {
+    mcpServers?: infer T;
+} ? T extends Record<string, any> ? keyof T : never : never;
+/**
+ * Type helper to create a union of all available tool IDs from multiple environments
+ */
+type UnionMcpServerIds<T extends Record<string, any>> = {
+    [K in keyof T]: ExtractMcpServerIds<T[K]>;
+}[keyof T];
 
 interface EnvironmentSettingsConfig {
     credentials?: {
         [settingId: string]: CredentialReferenceApiInsert;
     };
+    mcpServers?: {
+        [mcpServerId: string]: Tool;
+    };
 }
 /**
  * Create a setting helper with TypeScript autocomplete
  */
 declare function createEnvironmentSettings<T extends Record<string, EnvironmentSettingsConfig>>(environments: T): {
+    getEnvironmentCredential: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
+    getEnvironmentMcp: (key: UnionMcpServerIds<T>) => Tool;
     getEnvironmentSetting: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
 };
 /**
@@ -1339,4 +1415,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceAgents: typeof Runner.raceAgents;
 
-export { type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllSubAgentInterface, ArtifactComponent, type ArtifactComponentInterface, type ArtifactComponentWithZodProps, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, type DataComponentWithZodProps, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, type FetchDefinitionConfig, FunctionTool, type GenerateOptions, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, StatusComponent, type StatusComponentInterface, type StreamEvent, type StreamResponse, SubAgent, type SubAgentCanUseType, type SubAgentConfig, type SubAgentInterface, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, statusComponent, stream, subAgent, type subAgentExternalAgentInterface, transfer, updateFullProjectViaAPI };
+export { type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllDelegateInputInterface, type AllDelegateOutputInterface, ArtifactComponent, type ArtifactComponentInterface, type ArtifactComponentWithZodProps, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, type DataComponentWithZodProps, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, type FetchDefinitionConfig, FunctionTool, type GenerateOptions, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, StatusComponent, type StatusComponentInterface, type StreamEvent, type StreamResponse, SubAgent, type SubAgentCanUseType, type SubAgentConfig, type SubAgentInterface, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, statusComponent, stream, subAgent, type subAgentExternalAgentInterface, type subAgentTeamAgentInterface, transfer, updateFullProjectViaAPI };

package/dist/index.js

@@ -487,7 +487,12 @@ var Agent = class {
     this.subAgents = resolveGetter(config.subAgents) || [];
     this.agentMap = new Map(this.subAgents.map((agent2) => [agent2.getId(), agent2]));
     if (this.defaultSubAgent) {
-      this.subAgents.push(this.defaultSubAgent);
+      const isAlreadyPresent = this.subAgents.some(
+        (agent2) => agent2.getId() === this.defaultSubAgent?.getId()
+      );
+      if (!isAlreadyPresent) {
+        this.subAgents.push(this.defaultSubAgent);
+      }
       this.agentMap.set(this.defaultSubAgent.getId(), this.defaultSubAgent);
     }
     if (this.models) {
@@ -628,9 +633,10 @@ var Agent = class {
               externalAgentId: d.externalAgent.getId(),
               ...d.headers && { headers: d.headers }
             };
-          } else if (typeof d === "object" && "type" in d && d.type === "external") {
+          } else if (typeof d === "object" && "agent" in d) {
             return {
-              externalAgentId: d.getId()
+              agentId: d.agent.getId(),
+              ...d.headers && { headers: d.headers }
             };
           }
           return d.getId();
@@ -1010,6 +1016,12 @@ var Agent = class {
       tenantId: this.tenantId
     };
   }
+  with(options) {
+    return {
+      agent: this,
+      headers: options.headers
+    };
+  }
   /**
    * Validate the agent configuration
    */
@@ -1478,7 +1490,8 @@ var DataComponent = class {
     this.config = {
       ...config,
       id: this.id,
-      props: processedProps
+      props: processedProps,
+      render: config.render || null
     };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.tenantId = "default";
@@ -1512,6 +1525,9 @@ var DataComponent = class {
   getProps() {
     return this.config.props;
   }
+  getRender() {
+    return this.config.render;
+  }
   // Public method to ensure data component exists in backend (with upsert behavior)
   async init() {
     if (this.initialized) return;
@@ -1541,7 +1557,8 @@ var DataComponent = class {
       id: this.getId(),
       name: this.config.name,
       description: this.config.description,
-      props: this.config.props
+      props: this.config.props,
+      render: this.config.render
     };
     logger6.info({ dataComponentData }, "dataComponentData for create/update");
     const updateResponse = await fetch(
@@ -2360,23 +2377,27 @@ var Project = class {
             let dataComponentName;
             let dataComponentDescription;
             let dataComponentProps;
+            let dataComponentRender;
             if (dataComponent2.getId) {
               dataComponentId = dataComponent2.getId();
               dataComponentName = dataComponent2.getName();
               dataComponentDescription = dataComponent2.getDescription() || "";
               dataComponentProps = dataComponent2.getProps() || {};
+              dataComponentRender = dataComponent2.getRender?.() || null;
             } else {
               dataComponentId = dataComponent2.id || (dataComponent2.name ? dataComponent2.name.toLowerCase().replace(/\s+/g, "-") : "");
               dataComponentName = dataComponent2.name || "";
               dataComponentDescription = dataComponent2.description || "";
               dataComponentProps = dataComponent2.props || {};
+              dataComponentRender = dataComponent2.render || null;
             }
             if (!dataComponentsObject[dataComponentId] && dataComponentName) {
               dataComponentsObject[dataComponentId] = {
                 id: dataComponentId,
                 name: dataComponentName,
                 description: dataComponentDescription,
-                props: dataComponentProps
+                props: dataComponentProps,
+                render: dataComponentRender
               };
             }
           }
@@ -2717,6 +2738,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
@@ -2844,6 +2888,12 @@ var SubAgent = class {
       if (typeof delegate === "object" && "externalAgent" in delegate) {
         return false;
       }
+      if (typeof delegate === "object" && "agent" in delegate) {
+        return false;
+      }
+      if (typeof delegate === "object" && "toFullAgentDefinition" in delegate) {
+        return false;
+      }
       if (typeof delegate === "object" && "type" in delegate && delegate.type === "external") {
         return false;
       }
@@ -2872,8 +2922,34 @@ var SubAgent = class {
       };
     });
   }
+  getTeamAgentDelegates() {
+    if (typeof this.config.canDelegateTo !== "function") {
+      return [];
+    }
+    return this.config.canDelegateTo().filter((delegate) => {
+      if (typeof delegate === "object" && "agent" in delegate) {
+        return true;
+      }
+      if (typeof delegate === "object" && "toFullAgentDefinition" in delegate) {
+        return true;
+      }
+      return false;
+    }).map((delegate) => {
+      if ("agent" in delegate) {
+        return delegate;
+      }
+      return {
+        agent: delegate,
+        headers: void 0
+      };
+    });
+  }
   getDelegates() {
-    return typeof this.config.canDelegateTo === "function" ? this.config.canDelegateTo() : [];
+    return [
+      ...this.getSubAgentDelegates(),
+      ...this.getTeamAgentDelegates(),
+      ...this.getExternalAgentDelegates()
+    ];
   }
   getDataComponents() {
     const components = resolveGetter2(this.config.dataComponents) || [];
@@ -2883,7 +2959,8 @@ var SubAgent = class {
           id: comp.getId(),
           name: comp.getName(),
           description: comp.getDescription(),
-          props: comp.getProps()
+          props: comp.getProps(),
+          render: comp.getRender?.() || null
         };
       }
       if (comp && typeof comp === "object" && comp.props && isZodSchema(comp.props)) {
@@ -2891,7 +2968,8 @@ var SubAgent = class {
           id: comp.id,
           name: comp.name,
           description: comp.description,
-          props: convertZodToJsonSchemaWithPreview(comp.props)
+          props: convertZodToJsonSchemaWithPreview(comp.props),
+          render: comp.render || null
         };
       }
       return comp;
@@ -3383,7 +3461,8 @@ var SubAgent = class {
         id: dataComponent2.id,
         name: dataComponent2.name,
         description: dataComponent2.description,
-        props: dataComponent2.props
+        props: dataComponent2.props,
+        render: dataComponent2.render
       });
       dc.setContext(this.tenantId, this.projectId);
       await dc.init();
@@ -3641,6 +3720,35 @@ function isCredentialReference(value) {
 // src/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
+    getEnvironmentCredential: (key) => {
+      const currentEnv = process.env.INKEEP_ENV || "development";
+      const env = environments[currentEnv];
+      if (!env) {
+        throw new Error(
+          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
+        );
+      }
+      const credential2 = env.credentials?.[key];
+      if (!credential2) {
+        throw new Error(`Credential '${String(key)}' not found in environment '${currentEnv}'`);
+      }
+      return credential2;
+    },
+    getEnvironmentMcp: (key) => {
+      const currentEnv = process.env.INKEEP_ENV || "development";
+      const env = environments[currentEnv];
+      if (!env) {
+        throw new Error(
+          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
+        );
+      }
+      const mcpServer2 = env.mcpServers?.[key];
+      if (!mcpServer2) {
+        throw new Error(`MCP Server '${String(key)}' not found in environment '${currentEnv}'`);
+      }
+      return mcpServer2;
+    },
+    //Deprecated: Use getEnvironmentCredential instead
     getEnvironmentSetting: (key) => {
       const currentEnv = process.env.INKEEP_ENV || "development";
       const env = environments[currentEnv];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.26.2",
+  "version": "0.28.0",
   "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.26.2"
+    "@inkeep/agents-core": "^0.28.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",