@inkeep/agents-sdk 0.26.2 → 0.27.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
    */
@@ -2744,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
@@ -2871,6 +2906,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 +2940,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) || [];

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;
@@ -148,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.
  *
@@ -347,13 +375,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 +491,7 @@ interface AgentConfig {
     id: string;
     name?: string;
     description?: string;
-    defaultSubAgent?: SubAgentInterface;
+    defaultSubAgent: SubAgentInterface;
     subAgents?: () => SubAgentInterface[];
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
@@ -499,7 +528,7 @@ interface SubAgentInterface {
     getInstructions(): string;
     getTools(): Record<string, AgentTool>;
     getTransfers(): SubAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -507,7 +536,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 +547,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 +557,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 +575,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 +725,9 @@ declare class Agent implements AgentInterface {
         agentId: string;
         tenantId: string;
     };
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
     /**
      * Validate the agent configuration
      */
@@ -697,7 +739,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 +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.
@@ -1339,4 +1389,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;
@@ -148,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.
  *
@@ -347,13 +375,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 +491,7 @@ interface AgentConfig {
     id: string;
     name?: string;
     description?: string;
-    defaultSubAgent?: SubAgentInterface;
+    defaultSubAgent: SubAgentInterface;
     subAgents?: () => SubAgentInterface[];
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
@@ -499,7 +528,7 @@ interface SubAgentInterface {
     getInstructions(): string;
     getTools(): Record<string, AgentTool>;
     getTransfers(): SubAgentInterface[];
-    getDelegates(): AllSubAgentInterface[];
+    getDelegates(): AllDelegateOutputInterface[];
     getSubAgentDelegates(): SubAgentInterface[];
     getExternalAgentDelegates(): subAgentExternalAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -507,7 +536,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 +547,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 +557,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 +575,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 +725,9 @@ declare class Agent implements AgentInterface {
         agentId: string;
         tenantId: string;
     };
+    with(options: {
+        headers?: Record<string, string>;
+    }): subAgentTeamAgentInterface;
     /**
      * Validate the agent configuration
      */
@@ -697,7 +739,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 +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.
@@ -1339,4 +1389,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
    */
@@ -2717,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
@@ -2844,6 +2879,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 +2913,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) || [];

package/package.json

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