@inkeep/agents-sdk 0.41.2 → 0.42.0

package/dist/agent.d.ts

@@ -1,3 +1,4 @@
+import { Trigger, TriggerInterface } from "./trigger.js";
 import { AgentConfig, AgentInterface, AllDelegateInputInterface, GenerateOptions, MessageInput, ModelSettings, RunResult, StreamResponse, SubAgentInterface, subAgentTeamAgentInterface } from "./types.js";
 import { AgentStopWhen, FullAgentDefinition, StatusUpdateSettings } from "@inkeep/agents-core";
 
@@ -19,102 +20,112 @@ declare class Agent implements AgentInterface {
   private statusUpdateSettings?;
   private prompt?;
   private stopWhen?;
+  private triggers;
+  private triggerMap;
   constructor(config: AgentConfig);
   /**
-   * Set or update the configuration (tenantId, projectId and apiUrl)
-   * This is used by the CLI to inject configuration from inkeep.config.ts
-   */
+  * Set or update the configuration (tenantId, projectId and apiUrl)
+  * This is used by the CLI to inject configuration from inkeep.config.ts
+  */
   setConfig(tenantId: string, projectId: string, apiUrl: string): void;
   /**
-   * Convert the Agent to FullAgentDefinition format for the new agent endpoint
-   */
+  * Convert the Agent to FullAgentDefinition format for the new agent endpoint
+  */
   toFullAgentDefinition(): Promise<FullAgentDefinition>;
   /**
-   * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
-   */
+  * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
+  */
   private initializeAllTools;
   /**
-   * Initialize the agent and all agents in the backend using the new agent endpoint
-   */
+  * Initialize the agent and all agents in the backend using the new agent endpoint
+  */
   init(): Promise<void>;
   /**
-   * Generate a response using the default agent
-   */
+  * Generate a response using the default agent
+  */
   generate(input: MessageInput, options?: GenerateOptions): Promise<string>;
   /**
-   * Stream a response using the default agent
-   */
+  * Stream a response using the default agent
+  */
   stream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
   /**
-   * Alias for stream() method for consistency with naming patterns
-   */
+  * Alias for stream() method for consistency with naming patterns
+  */
   generateStream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
   /**
-   * Run with a specific agent from the agent
-   */
+  * Run with a specific agent from the agent
+  */
   runWith(subAgentId: string, input: MessageInput, options?: GenerateOptions): Promise<RunResult>;
   /**
-   * Get an agent by name (unified method for all agent types)
-   */
+  * Get an agent by name (unified method for all agent types)
+  */
   getSubAgent(name: string): SubAgentInterface | undefined;
   /**
-   * Add an agent to the agent
-   */
+  * Add an agent to the agent
+  */
   addSubAgent(agent: SubAgentInterface): void;
   /**
-   * Remove an agent from the agent
-   */
+  * Remove an agent from the agent
+  */
   removeSubAgent(id: string): boolean;
   /**
-   * Get all agents in the agent
-   */
+  * Get all agents in the agent
+  */
   getSubAgents(): SubAgentInterface[];
   /**
-   * Get all agent ids (unified method for all agent types)
-   */
+  * Get all agent ids (unified method for all agent types)
+  */
   getSubAgentIds(): string[];
   /**
-   * Set the default agent
-   */
+  * Set the default agent
+  */
   setDefaultSubAgent(agent: SubAgentInterface): void;
   /**
-   * Get the default agent
-   */
+  * Get the default agent
+  */
   getDefaultSubAgent(): SubAgentInterface | undefined;
   /**
-   * Get the agent ID
-   */
+  * Get all triggers for this agent
+  */
+  getTriggers(): Record<string, Trigger>;
+  /**
+  * Add one or more triggers to the agent at runtime
+  */
+  addTrigger(...triggers: TriggerInterface[]): void;
+  /**
+  * Get the agent ID
+  */
   getId(): string;
   getName(): string;
   getDescription(): string | undefined;
   getTenantId(): string;
   /**
-   * Get the agent's model settingsuration
-   */
+  * Get the agent's model settingsuration
+  */
   getModels(): typeof this.models;
   /**
-   * Set the agent's model settingsuration
-   */
+  * Set the agent's model settingsuration
+  */
   setModels(models: typeof this.models): void;
   /**
-   * Get the agent's prompt configuration
-   */
+  * Get the agent's prompt configuration
+  */
   getPrompt(): string | undefined;
   /**
-   * Get the agent's stopWhen configuration
-   */
+  * Get the agent's stopWhen configuration
+  */
   getStopWhen(): AgentStopWhen;
   /**
-   * Get the agent's status updates configuration
-   */
+  * Get the agent's status updates configuration
+  */
   getStatusUpdateSettings(): StatusUpdateSettings | undefined;
   /**
-   * Get the summarizer model from the agent's model settings
-   */
+  * Get the summarizer model from the agent's model settings
+  */
   getSummarizerModel(): ModelSettings | undefined;
   /**
-   * Get agent statistics
-   */
+  * Get agent statistics
+  */
   getStats(): {
     agentCount: number;
     defaultSubAgent: string | null;
@@ -126,61 +137,61 @@ declare class Agent implements AgentInterface {
     headers?: Record<string, string>;
   }): subAgentTeamAgentInterface;
   /**
-   * Validate the agent configuration
-   */
+  * Validate the agent configuration
+  */
   validate(): {
     valid: boolean;
     errors: string[];
   };
   private _init;
   /**
-   * Type guard to check if an agent is an internal AgentInterface
-   */
+  * Type guard to check if an agent is an internal AgentInterface
+  */
   isInternalAgent(agent: AllDelegateInputInterface): agent is SubAgentInterface;
   /**
-   * Get project-level model settingsuration defaults
-   */
+  * Get project-level model settingsuration defaults
+  */
   private getProjectModelDefaults;
   /**
-   * Get project-level stopWhen configuration defaults
-   */
+  * Get project-level stopWhen configuration defaults
+  */
   private getProjectStopWhenDefaults;
   /**
-   * Apply model inheritance hierarchy: Project -> Agent -> Agent
-   */
+  * Apply model inheritance hierarchy: Project -> Agent -> Agent
+  */
   private applyModelInheritance;
   /**
-   * Apply stopWhen inheritance hierarchy: Project -> Agent -> Agent
-   */
+  * Apply stopWhen inheritance hierarchy: Project -> Agent -> Agent
+  */
   private applyStopWhenInheritance;
   /**
-   * Propagate agent-level model settings to agents (supporting partial inheritance)
-   */
+  * Propagate agent-level model settings to agents (supporting partial inheritance)
+  */
   private propagateModelSettingsToAgent;
   /**
-   * Immediately propagate agent-level models to all agents during construction
-   */
+  * Immediately propagate agent-level models to all agents during construction
+  */
   private propagateImmediateModelSettings;
   /**
-   * Execute agent using the backend system instead of local runner
-   */
+  * Execute agent using the backend system instead of local runner
+  */
   private executeWithBackend;
   /**
-   * Parse streaming response in SSE format
-   */
+  * Parse streaming response in SSE format
+  */
   private parseStreamingResponse;
   /**
-   * Normalize input messages to the expected format
-   */
+  * Normalize input messages to the expected format
+  */
   private normalizeMessages;
 }
 /**
- * Helper function to create agent - OpenAI style
- */
+* Helper function to create agent - OpenAI style
+*/
 declare function agent(config: AgentConfig): Agent;
 /**
- * Factory function to create agent from configuration file
- */
+* Factory function to create agent from configuration file
+*/
 declare function generateAgent(configPath: string): Promise<Agent>;
 //#endregion
 export { Agent, agent, generateAgent };

package/dist/agent.js

@@ -27,6 +27,8 @@ var Agent = class {
 	statusUpdateSettings;
 	prompt;
 	stopWhen;
+	triggers = [];
+	triggerMap = /* @__PURE__ */ new Map();
 	constructor(config) {
 		this.defaultSubAgent = config.defaultSubAgent;
 		this.tenantId = "default";
@@ -43,6 +45,8 @@ var Agent = class {
 		this.stopWhen = config.stopWhen ? { transferCountIs: config.stopWhen.transferCountIs } : void 0;
 		this.subAgents = resolveGetter(config.subAgents) || [];
 		this.agentMap = new Map(this.subAgents.map((agent$1) => [agent$1.getId(), agent$1]));
+		this.triggers = resolveGetter(config.triggers) || [];
+		this.triggerMap = new Map(this.triggers.map((trigger) => [trigger.getId(), trigger]));
 		if (this.defaultSubAgent) {
 			if (!this.subAgents.some((agent$1) => agent$1.getId() === this.defaultSubAgent?.getId())) this.subAgents.push(this.defaultSubAgent);
 			this.agentMap.set(this.defaultSubAgent.getId(), this.defaultSubAgent);
@@ -52,7 +56,8 @@ var Agent = class {
 			agentId: this.agentId,
 			tenantId: this.tenantId,
 			agentCount: this.subAgents.length,
-			defaultSubAgent: this.defaultSubAgent?.getName()
+			defaultSubAgent: this.defaultSubAgent?.getName(),
+			triggerCount: this.triggers.length
 		}, "Agent created");
 	}
 	/**
@@ -221,6 +226,16 @@ var Agent = class {
 				}
 			}
 		}
+		const triggersObject = {};
+		for (const [triggerId, trigger] of this.triggerMap.entries()) {
+			const config = trigger.getConfig();
+			let processedInputSchema = config.inputSchema;
+			if (config.inputSchema && isZodSchema(config.inputSchema)) processedInputSchema = convertZodToJsonSchema(config.inputSchema);
+			triggersObject[triggerId] = {
+				...config,
+				inputSchema: processedInputSchema
+			};
+		}
 		return {
 			id: this.agentId,
 			name: this.agentName,
@@ -231,6 +246,7 @@ var Agent = class {
 			contextConfig: this.contextConfig?.toObject(),
 			...Object.keys(functionToolsObject).length > 0 && { functionTools: functionToolsObject },
 			...Object.keys(functionsObject).length > 0 && { functions: functionsObject },
+			...Object.keys(triggersObject).length > 0 && { triggers: triggersObject },
 			models: this.models,
 			stopWhen: this.stopWhen,
 			statusUpdates: processedStatusUpdates,
@@ -437,6 +453,28 @@ var Agent = class {
 		return this.defaultSubAgent;
 	}
 	/**
+	* Get all triggers for this agent
+	*/
+	getTriggers() {
+		const triggersObject = {};
+		for (const [id, trigger] of this.triggerMap.entries()) triggersObject[id] = trigger;
+		return triggersObject;
+	}
+	/**
+	* Add one or more triggers to the agent at runtime
+	*/
+	addTrigger(...triggers) {
+		for (const trigger of triggers) {
+			this.triggers.push(trigger);
+			this.triggerMap.set(trigger.getId(), trigger);
+			logger.info({
+				agentId: this.agentId,
+				triggerId: trigger.getId(),
+				triggerName: trigger.getName()
+			}, "Trigger added to agent");
+		}
+	}
+	/**
 	* Get the agent ID
 	*/
 	getId() {
@@ -624,7 +662,7 @@ var Agent = class {
 	*/
 	async executeWithBackend(input, options) {
 		const normalizedMessages = this.normalizeMessages(input);
-		const url = `${this.baseURL}/tenants/${this.tenantId}/agent/${this.agentId}/v1/chat/completions`;
+		const url = `${this.baseURL}/run/v1/chat/completions`;
 		logger.info({ url }, "Executing with backend");
 		const requestBody = {
 			model: "gpt-4o-mini",

package/dist/agentFullClient.d.ts

@@ -3,20 +3,20 @@ import { FullAgentDefinition } from "@inkeep/agents-core";
 //#region src/agentFullClient.d.ts
 
 /**
- * Create a full agent via HTTP API
- */
+* Create a full agent via HTTP API
+*/
 declare function createFullAgentViaAPI(tenantId: string, projectId: string, apiUrl: string, agentData: FullAgentDefinition): Promise<FullAgentDefinition>;
 /**
- * Update a full agent via HTTP API (upsert behavior)
- */
+* Update a full agent via HTTP API (upsert behavior)
+*/
 declare function updateFullAgentViaAPI(tenantId: string, projectId: string, apiUrl: string, agentId: string, agentData: FullAgentDefinition): Promise<FullAgentDefinition>;
 /**
- * Get a full agent via HTTP API
- */
+* Get a full agent via HTTP API
+*/
 declare function getFullAgentViaAPI(tenantId: string, projectId: string, apiUrl: string, agentId: string): Promise<FullAgentDefinition | null>;
 /**
- * Delete a full agent via HTTP API
- */
+* Delete a full agent via HTTP API
+*/
 declare function deleteFullAgentViaAPI(tenantId: string, projectId: string, apiUrl: string, agentId: string): Promise<void>;
 //#endregion
 export { createFullAgentViaAPI, deleteFullAgentViaAPI, getFullAgentViaAPI, updateFullAgentViaAPI };

package/dist/agentFullClient.js

@@ -13,7 +13,7 @@ async function createFullAgentViaAPI(tenantId, projectId, apiUrl, agentData) {
 		agentId: agentData.id,
 		apiUrl
 	}, "Creating full agent via API");
-	const url = `${apiUrl}/tenants/${tenantId}/projects/${projectId}/agent`;
+	const url = `${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agent`;
 	const response = await fetch(url, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
@@ -41,7 +41,7 @@ async function updateFullAgentViaAPI(tenantId, projectId, apiUrl, agentId, agent
 		agentId,
 		apiUrl
 	}, "Updating full agent via API");
-	const url = `${apiUrl}/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
+	const url = `${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
 	const response = await fetch(url, {
 		method: "PUT",
 		headers: { "Content-Type": "application/json" },
@@ -69,7 +69,7 @@ async function getFullAgentViaAPI(tenantId, projectId, apiUrl, agentId) {
 		agentId,
 		apiUrl
 	}, "Getting full agent via API");
-	const url = `${apiUrl}/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
+	const url = `${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
 	const response = await fetch(url, {
 		method: "GET",
 		headers: { "Content-Type": "application/json" }
@@ -100,7 +100,7 @@ async function deleteFullAgentViaAPI(tenantId, projectId, apiUrl, agentId) {
 		agentId,
 		apiUrl
 	}, "Deleting full agent via API");
-	const url = `${apiUrl}/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
+	const url = `${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agent/${agentId}`;
 	const response = await fetch(url, {
 		method: "DELETE",
 		headers: { "Content-Type": "application/json" }

package/dist/artifact-component.d.ts

@@ -2,20 +2,20 @@ import { ArtifactComponentInsert } from "@inkeep/agents-core";
 import { z } from "zod";
 
 //#region src/artifact-component.d.ts
-type ArtifactComponentConfigWithZod = Omit<ArtifactComponentInsert, 'tenantId' | 'projectId' | 'props'> & {
+type ArtifactComponentConfigWithZod = Omit<ArtifactComponentInsert, "tenantId" | "projectId" | "props"> & {
   props?: Record<string, unknown> | z.ZodObject<any> | null;
 };
 interface ArtifactComponentInterface {
-  config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+  config: Omit<ArtifactComponentInsert, "tenantId" | "projectId">;
   init(): Promise<void>;
-  getId(): ArtifactComponentInsert['id'];
-  getName(): ArtifactComponentInsert['name'];
-  getDescription(): ArtifactComponentInsert['description'];
-  getProps(): ArtifactComponentInsert['props'];
+  getId(): ArtifactComponentInsert["id"];
+  getName(): ArtifactComponentInsert["name"];
+  getDescription(): ArtifactComponentInsert["description"];
+  getProps(): ArtifactComponentInsert["props"];
   setContext(tenantId: string, projectId: string, baseURL?: string): void;
 }
 declare class ArtifactComponent implements ArtifactComponentInterface {
-  config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+  config: Omit<ArtifactComponentInsert, "tenantId" | "projectId">;
   private baseURL;
   private tenantId;
   private projectId;
@@ -26,7 +26,7 @@ declare class ArtifactComponent implements ArtifactComponentInterface {
   getId(): string;
   getName(): string;
   getDescription(): string;
-  getProps(): ArtifactComponentInsert['props'];
+  getProps(): ArtifactComponentInsert["props"];
   init(): Promise<void>;
   private upsertArtifactComponent;
 }

package/dist/artifact-component.js

@@ -68,7 +68,7 @@ var ArtifactComponent = class {
 			props: this.config.props
 		};
 		logger.info({ artifactComponentData }, "artifactComponentData for create/update");
-		const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components/${this.getId()}`, {
+		const updateResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components/${this.getId()}`, {
 			method: "PUT",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(artifactComponentData)
@@ -83,7 +83,7 @@ var ArtifactComponent = class {
 		}
 		if (updateResponse.status === 404) {
 			logger.info({ artifactComponentId: this.getId() }, "ArtifactComponent not found, creating new artifact component");
-			const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components`, {
+			const createResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components`, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify(artifactComponentData)