@inkeep/agents-sdk 0.41.2 → 0.43.0

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import { TriggerInterface } from "./trigger.js";
 import { ArtifactComponentInterface } from "./artifact-component.js";
 import { Tool } from "./tool.js";
 import { AgentMcpConfig } from "./builders.js";
@@ -21,8 +22,8 @@ interface DataComponentWithZodProps {
   props?: z.ZodObject<any>;
 }
 /**
- * Tool instance that may have additional metadata attached during agent processing
- */
+* Tool instance that may have additional metadata attached during agent processing
+*/
 type AgentTool = (Tool & {
   selectedTools?: string[];
   headers?: Record<string, string>;
@@ -33,28 +34,28 @@ type AgentTool = (Tool & {
   toolPolicies?: Record<string, ToolPolicy>;
 });
 interface UserMessage {
-  role: 'user';
+  role: "user";
   content: string;
 }
 interface AssistantMessage {
-  role: 'assistant';
+  role: "assistant";
   content: string;
   toolCalls?: ToolCall[];
 }
 interface ToolMessage {
-  role: 'tool';
+  role: "tool";
   content: string;
   toolCallId: string;
 }
 interface SystemMessage {
-  role: 'system';
+  role: "system";
   content: string;
 }
 type Message = UserMessage | AssistantMessage | ToolMessage | SystemMessage;
 type MessageInput = string | string[] | Message | Message[];
 interface ToolCall {
   id: string;
-  type: 'function';
+  type: "function";
   function: {
     name: string;
     arguments: string;
@@ -68,8 +69,8 @@ interface ToolResult {
 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';
+interface SubAgentConfig extends Omit<SubAgentApiInsert, "projectId"> {
+  type?: "internal";
   canUse?: () => SubAgentCanUseType[];
   canTransferTo?: () => SubAgentInterface[];
   canDelegateTo?: () => AllDelegateInputInterface[];
@@ -97,14 +98,21 @@ interface MCPToolConfig {
   toolName?: string;
   activeTools?: string[];
   headers?: Record<string, string>;
-  mcpType?: 'nango' | 'generic';
+  mcpType?: "nango" | "generic";
   transport?: McpTransportConfig;
   imageUrl?: string;
+  toolOverrides?: Record<string, {
+    displayName?: string;
+    description?: string;
+    schema?: any;
+    transformation?: string | Record<string, string>;
+  }>;
+  prompt?: string;
 }
 interface FetchDefinitionConfig {
   id: string;
   name?: string;
-  trigger: 'initialization' | 'invocation';
+  trigger: "initialization" | "invocation";
   url: string;
   method?: string;
   headers?: Record<string, string>;
@@ -123,7 +131,7 @@ interface RequestSchemaDefinition {
 }
 interface RequestSchemaConfig {
   schemas: RequestSchemaDefinition;
-  optional?: ('body' | 'headers' | 'query' | 'params')[];
+  optional?: ("body" | "headers" | "query" | "params")[];
 }
 interface TransferConfig {
   agent: SubAgentInterface;
@@ -134,7 +142,7 @@ interface GenerateOptions {
   maxTurns?: number;
   maxSteps?: number;
   temperature?: number;
-  toolChoice?: 'auto' | 'none' | string;
+  toolChoice?: "auto" | "none" | string;
   resourceId?: string;
   conversationId?: string;
   stream?: boolean;
@@ -145,7 +153,7 @@ interface AgentResponse {
   text: string;
   toolCalls?: ToolCall[];
   transfer?: TransferConfig;
-  finishReason: 'completed' | 'tool_calls' | 'transfer' | 'max_turns' | 'error';
+  finishReason: "completed" | "tool_calls" | "transfer" | "max_turns" | "error";
   usage?: {
     inputTokens: number;
     outputTokens: number;
@@ -158,7 +166,7 @@ interface StreamResponse {
   eventStream?: AsyncGenerator<StreamEvent>;
 }
 interface StreamEvent {
-  type: 'text' | 'tool_call' | 'transfer' | 'error' | 'done';
+  type: "text" | "tool_call" | "transfer" | "error" | "done";
   data: any;
   timestamp: Date;
 }
@@ -192,11 +200,12 @@ interface AgentConfig {
     summarizer?: ModelSettings;
   };
   statusUpdates?: StatusUpdateSettings;
+  triggers?: () => TriggerInterface[];
 }
 declare class AgentError extends Error {
   code?: string | undefined;
-  details?: any | undefined;
-  constructor(message: string, code?: string | undefined, details?: any | undefined);
+  details?: any;
+  constructor(message: string, code?: string | undefined, details?: any);
 }
 declare class MaxTurnsExceededError extends AgentError {
   constructor(maxTurns: number);
@@ -209,7 +218,7 @@ declare class TransferError extends AgentError {
 }
 interface SubAgentInterface {
   config: SubAgentConfig;
-  type: 'internal';
+  type: "internal";
   init(): Promise<void>;
   getId(): string;
   getName(): string;
@@ -229,7 +238,7 @@ interface SubAgentInterface {
 }
 interface ExternalAgentInterface {
   config: ExternalAgentConfig;
-  type: 'external';
+  type: "external";
   init(): Promise<void>;
   getId(): string;
   getName(): string;
@@ -272,7 +281,7 @@ interface BuilderToolConfig {
   name: string;
   description: string;
   config: {
-    type: 'mcp';
+    type: "mcp";
     mcp: {
       server: {
         url: string;
@@ -283,7 +292,7 @@ interface BuilderToolConfig {
 }
 interface BuilderRelationConfig {
   targetAgent: string;
-  relationType: 'transfer' | 'delegate';
+  relationType: "transfer" | "delegate";
 }
 interface BuilderAgentConfig {
   name: string;
@@ -293,4 +302,4 @@ interface BuilderAgentConfig {
   relations?: BuilderRelationConfig[];
 }
 //#endregion
-export { AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, ArtifactComponentWithZodProps, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, DataComponentWithZodProps, ExternalAgentInterface, FetchDefinitionConfig, type FunctionToolConfig, GenerateOptions, MCPToolConfig, MaxTurnsExceededError, Message, MessageInput, type ModelSettings, RequestSchemaConfig, RequestSchemaDefinition, RunResult, ServerConfig, StreamEvent, StreamResponse, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface };
+export { AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, ArtifactComponentWithZodProps, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, DataComponentWithZodProps, ExternalAgentInterface, FetchDefinitionConfig, type FunctionToolConfig, GenerateOptions, MCPToolConfig, MaxTurnsExceededError, Message, MessageInput, type ModelSettings, RequestSchemaConfig, RequestSchemaDefinition, RunResult, ServerConfig, StreamEvent, StreamResponse, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, type TriggerInterface, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface };

package/dist/utils/generateIdFromName.d.ts

@@ -1,9 +1,9 @@
 //#region src/utils/generateIdFromName.d.ts
 /**
- * Generates a kebab-case ID from a name string
- * @param name - The name to convert
- * @returns A kebab-case ID
- */
+* Generates a kebab-case ID from a name string
+* @param name - The name to convert
+* @returns A kebab-case ID
+*/
 declare function generateIdFromName(name: string): string;
 //#endregion
 export { generateIdFromName };

package/dist/utils/tool-normalization.d.ts

@@ -6,20 +6,20 @@ import { ToolPolicy } from "@inkeep/agents-core";
 //#region src/utils/tool-normalization.d.ts
 
 /**
- * Type guard to check if a value is an AgentMcpConfig
- */
+* Type guard to check if a value is an AgentMcpConfig
+*/
 declare function isAgentMcpConfig(value: unknown): value is AgentMcpConfig;
 /**
- * Type guard to check if a value is a Tool instance
- */
+* Type guard to check if a value is a Tool instance
+*/
 declare function isTool(value: unknown): value is Tool;
 /**
- * Type guard to narrow down AgentCanUseType
- */
+* Type guard to narrow down AgentCanUseType
+*/
 declare function isAgentCanUseType(value: unknown): value is SubAgentCanUseType;
 /**
- * Normalized tool representation with proper typing
- */
+* Normalized tool representation with proper typing
+*/
 interface NormalizedToolInfo {
   /** The underlying Tool instance */
   tool: Tool;
@@ -35,8 +35,8 @@ interface NormalizedToolInfo {
   isWrapped: boolean;
 }
 /**
- * Safely extracts tool information from AgentCanUseType with proper typing
- */
+* Safely extracts tool information from AgentCanUseType with proper typing
+*/
 declare function normalizeAgentCanUseType(value: SubAgentCanUseType, fallbackName?: string): NormalizedToolInfo;
 //#endregion
 export { NormalizedToolInfo, isAgentCanUseType, isAgentMcpConfig, isTool, normalizeAgentCanUseType };

package/dist/utils/validateFunction.d.ts

@@ -1,10 +1,10 @@
 //#region src/utils/validateFunction.d.ts
 /**
- * Validates that a value is a function
- * @param value - The value to check
- * @param name - The name of the parameter (for error messages)
- * @throws {Error} If the value is not a function
- */
+* Validates that a value is a function
+* @param value - The value to check
+* @param name - The name of the parameter (for error messages)
+* @throws {Error} If the value is not a function
+*/
 declare function validateFunction(value: unknown, name: string): void;
 //#endregion
 export { validateFunction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.41.2",
+  "version": "0.43.0",
   "description": "Agents SDK for building and managing agents in the Inkeep Agent Framework",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -16,7 +16,7 @@
     "js-yaml": "^4.1.0",
     "typescript": "^5.3.3",
     "zod": "^4.1.11",
-    "@inkeep/agents-core": "^0.41.2"
+    "@inkeep/agents-core": "^0.43.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",