@inkeep/agents-sdk 0.47.4 → 0.48.0

package/dist/agent.d.ts

@@ -1,3 +1,4 @@
+import { ScheduledTrigger, ScheduledTriggerInterface } from "./scheduled-trigger.js";
 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";
@@ -22,6 +23,8 @@ declare class Agent implements AgentInterface {
   private stopWhen?;
   private triggers;
   private triggerMap;
+  private scheduledTriggers;
+  private scheduledTriggerMap;
   constructor(config: AgentConfig);
   /**
   * Set or update the configuration (tenantId, projectId and apiUrl)
@@ -93,6 +96,14 @@ declare class Agent implements AgentInterface {
   */
   addTrigger(...triggers: TriggerInterface[]): void;
   /**
+  * Get all scheduled triggers for this agent
+  */
+  getScheduledTriggers(): Record<string, ScheduledTrigger>;
+  /**
+  * Add one or more scheduled triggers to the agent at runtime
+  */
+  addScheduledTrigger(...triggers: ScheduledTriggerInterface[]): void;
+  /**
   * Get the agent ID
   */
   getId(): string;

package/dist/agent.js

@@ -28,6 +28,8 @@ var Agent = class {
 	stopWhen;
 	triggers = [];
 	triggerMap = /* @__PURE__ */ new Map();
+	scheduledTriggers = [];
+	scheduledTriggerMap = /* @__PURE__ */ new Map();
 	constructor(config) {
 		this.defaultSubAgent = config.defaultSubAgent;
 		this.tenantId = "default";
@@ -46,6 +48,8 @@ var Agent = class {
 		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]));
+		this.scheduledTriggers = resolveGetter(config.scheduledTriggers) || [];
+		this.scheduledTriggerMap = new Map(this.scheduledTriggers.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);
@@ -56,7 +60,8 @@ var Agent = class {
 			tenantId: this.tenantId,
 			agentCount: this.subAgents.length,
 			defaultSubAgent: this.defaultSubAgent?.getName(),
-			triggerCount: this.triggers.length
+			triggerCount: this.triggers.length,
+			scheduledTriggerCount: this.scheduledTriggers.length
 		}, "Agent initialized");
 	}
 	/**
@@ -149,6 +154,11 @@ var Agent = class {
 				headers: headersMapping[toolId] || null,
 				toolPolicies: toolPoliciesMapping[toolId] || null
 			}));
+			const resolvedSkills = subAgent.getSkills().map((skillRef, idx) => ({
+				id: skillRef.id,
+				index: skillRef.index ?? idx,
+				...skillRef.alwaysLoaded !== void 0 && { alwaysLoaded: skillRef.alwaysLoaded }
+			}));
 			subAgentsObject[subAgent.getId()] = {
 				id: subAgent.getId(),
 				name: subAgent.getName(),
@@ -171,6 +181,7 @@ var Agent = class {
 				canUse,
 				dataComponents: dataComponents.length > 0 ? dataComponents : void 0,
 				artifactComponents: artifactComponents.length > 0 ? artifactComponents : void 0,
+				skills: resolvedSkills.length > 0 ? resolvedSkills : void 0,
 				type: "internal"
 			};
 		}
@@ -235,6 +246,8 @@ var Agent = class {
 				inputSchema: processedInputSchema
 			};
 		}
+		const scheduledTriggersObject = {};
+		for (const [triggerId, trigger] of this.scheduledTriggerMap.entries()) scheduledTriggersObject[triggerId] = trigger.getConfig();
 		return {
 			id: this.agentId,
 			name: this.agentName,
@@ -246,6 +259,7 @@ var Agent = class {
 			...Object.keys(functionToolsObject).length > 0 && { functionTools: functionToolsObject },
 			...Object.keys(functionsObject).length > 0 && { functions: functionsObject },
 			triggers: triggersObject,
+			scheduledTriggers: scheduledTriggersObject,
 			models: this.models,
 			stopWhen: this.stopWhen,
 			statusUpdates: processedStatusUpdates,
@@ -474,6 +488,28 @@ var Agent = class {
 		}
 	}
 	/**
+	* Get all scheduled triggers for this agent
+	*/
+	getScheduledTriggers() {
+		const scheduledTriggersObject = {};
+		for (const [id, trigger] of this.scheduledTriggerMap.entries()) scheduledTriggersObject[id] = trigger;
+		return scheduledTriggersObject;
+	}
+	/**
+	* Add one or more scheduled triggers to the agent at runtime
+	*/
+	addScheduledTrigger(...triggers) {
+		for (const trigger of triggers) {
+			this.scheduledTriggers.push(trigger);
+			this.scheduledTriggerMap.set(trigger.getId(), trigger);
+			logger.info({
+				agentId: this.agentId,
+				scheduledTriggerId: trigger.getId(),
+				scheduledTriggerName: trigger.getName()
+			}, "Scheduled trigger added to agent");
+		}
+	}
+	/**
 	* Get the agent ID
 	*/
 	getId() {

package/dist/artifact-component.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 
 //#region src/artifact-component.d.ts
 type ArtifactComponentConfigWithZod = Omit<ArtifactComponentInsert, "tenantId" | "projectId" | "props"> & {
-  props?: Record<string, unknown> | z.ZodObject<any> | null;
+  props: ArtifactComponentInsert["props"] | z.ZodObject<any>;
 };
 interface ArtifactComponentInterface {
   config: Omit<ArtifactComponentInsert, "tenantId" | "projectId">;

package/dist/artifact-component.js

@@ -12,9 +12,7 @@ var ArtifactComponent = class {
 	id;
 	constructor(config) {
 		this.id = config.id || generateIdFromName(config.name);
-		let processedProps;
-		if (config.props && isZodSchema(config.props)) processedProps = convertZodToJsonSchemaWithPreview(config.props);
-		else processedProps = config.props;
+		const processedProps = isZodSchema(config.props) ? convertZodToJsonSchemaWithPreview(config.props) : config.props;
 		this.config = {
 			...config,
 			id: this.id,

package/dist/builderFunctions.d.ts

@@ -1,3 +1,4 @@
+import { ScheduledTrigger } from "./scheduled-trigger.js";
 import { Trigger } from "./trigger.js";
 import { ArtifactComponent } from "./artifact-component.js";
 import { Tool } from "./tool.js";
@@ -9,7 +10,7 @@ import { AgentConfig, FunctionToolConfig, SubAgentConfig } from "./types.js";
 import { Agent } from "./agent.js";
 import { Project, ProjectConfig } from "./project.js";
 import { StatusComponent as StatusComponent$1 } from "./status-component.js";
-import { CredentialReferenceApiInsert, MCPToolConfig, TriggerApiInsert } from "@inkeep/agents-core";
+import { CredentialReferenceApiInsert, MCPToolConfig, ScheduledTriggerInsert, TriggerApiInsert } from "@inkeep/agents-core";
 
 //#region src/builderFunctions.d.ts
 
@@ -368,5 +369,47 @@ declare function functionTool(config: FunctionToolConfig): FunctionTool;
 declare function trigger(config: Omit<TriggerApiInsert, "id"> & {
   id?: string;
 }): Trigger;
+/**
+* Creates a scheduled trigger for time-based agent execution.
+*
+* Scheduled triggers allow agents to be invoked on a schedule using cron expressions
+* or at a specific one-time date/time.
+*
+* @param config - Scheduled trigger configuration
+* @returns A ScheduledTrigger instance
+*
+* @example
+* ```typescript
+* // Daily report at 9 AM
+* const dailyReport = scheduledTrigger({
+*   name: 'Daily Report',
+*   cronExpression: '0 9 * * *',
+*   messageTemplate: 'Generate the daily report for {{date}}',
+*   payload: { date: '{{now}}' },
+* });
+*
+* // One-time migration task
+* const migrationTask = scheduledTrigger({
+*   name: 'Migration Task',
+*   runAt: '2024-12-31T23:59:59Z',
+*   messageTemplate: 'Run the end-of-year migration',
+*   maxRetries: 5,
+*   timeoutSeconds: 600,
+* });
+*
+* // Hourly health check with retry configuration
+* const healthCheck = scheduledTrigger({
+*   name: 'Hourly Health Check',
+*   cronExpression: '0 * * * *',
+*   messageTemplate: 'Check system health',
+*   maxRetries: 3,
+*   retryDelaySeconds: 30,
+*   timeoutSeconds: 120,
+* });
+* ```
+*/
+declare function scheduledTrigger(config: Omit<ScheduledTriggerInsert, "id"> & {
+  id?: string;
+}): ScheduledTrigger;
 //#endregion
-export { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, statusComponent, subAgent, trigger };
+export { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, scheduledTrigger, statusComponent, subAgent, trigger };

package/dist/builderFunctions.js

@@ -4,6 +4,7 @@ import { Agent } from "./agent.js";
 import { ArtifactComponent } from "./artifact-component.js";
 import { DataComponent } from "./data-component.js";
 import { Project } from "./project.js";
+import { ScheduledTrigger } from "./scheduled-trigger.js";
 import { StatusComponent as StatusComponent$1 } from "./status-component.js";
 import { Tool } from "./tool.js";
 import { SubAgent } from "./subAgent.js";
@@ -451,6 +452,48 @@ function trigger(config) {
 	}
 	return new Trigger(config);
 }
+/**
+* Creates a scheduled trigger for time-based agent execution.
+*
+* Scheduled triggers allow agents to be invoked on a schedule using cron expressions
+* or at a specific one-time date/time.
+*
+* @param config - Scheduled trigger configuration
+* @returns A ScheduledTrigger instance
+*
+* @example
+* ```typescript
+* // Daily report at 9 AM
+* const dailyReport = scheduledTrigger({
+*   name: 'Daily Report',
+*   cronExpression: '0 9 * * *',
+*   messageTemplate: 'Generate the daily report for {{date}}',
+*   payload: { date: '{{now}}' },
+* });
+*
+* // One-time migration task
+* const migrationTask = scheduledTrigger({
+*   name: 'Migration Task',
+*   runAt: '2024-12-31T23:59:59Z',
+*   messageTemplate: 'Run the end-of-year migration',
+*   maxRetries: 5,
+*   timeoutSeconds: 600,
+* });
+*
+* // Hourly health check with retry configuration
+* const healthCheck = scheduledTrigger({
+*   name: 'Hourly Health Check',
+*   cronExpression: '0 * * * *',
+*   messageTemplate: 'Check system health',
+*   maxRetries: 3,
+*   retryDelaySeconds: 30,
+*   timeoutSeconds: 120,
+* });
+* ```
+*/
+function scheduledTrigger(config) {
+	return new ScheduledTrigger(config);
+}
 
 //#endregion
-export { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, statusComponent, subAgent, trigger };
+export { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, scheduledTrigger, statusComponent, subAgent, trigger };

package/dist/builders.d.ts

@@ -1,7 +1,7 @@
 import { Tool } from "./tool.js";
 import { SubAgent } from "./subAgent.js";
 import { TransferConfig } from "./types.js";
-import { CredentialReferenceApiInsert, McpToolSelection, ToolPolicy } from "@inkeep/agents-core";
+import { CredentialReferenceApiInsert, JsonSchemaForLlmSchemaType, McpToolSelection, ToolPolicy } from "@inkeep/agents-core";
 import { z } from "zod";
 
 //#region src/builders.d.ts
@@ -40,10 +40,10 @@ interface ComponentConfig {
   description: string;
 }
 interface ArtifactComponentConfig extends ComponentConfig {
-  props: Record<string, unknown> | z.ZodObject<any>;
+  props: JsonSchemaForLlmSchemaType | z.ZodObject<any>;
 }
 interface DataComponentConfig extends ComponentConfig {
-  props: Record<string, unknown> | z.ZodObject<any>;
+  props: JsonSchemaForLlmSchemaType | z.ZodObject<any>;
   render?: {
     component: string;
     mockData: Record<string, unknown>;

package/dist/data-component.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 
 //#region src/data-component.d.ts
 type DataComponentConfigWithZod = Omit<DataComponentInsert, "tenantId" | "projectId" | "props" | "render"> & {
-  props?: Record<string, unknown> | z.ZodObject<any> | null;
+  props: DataComponentInsert["props"] | z.ZodObject<any>;
   render?: {
     component: string;
     mockData: Record<string, unknown>;

package/dist/data-component.js

@@ -12,9 +12,7 @@ var DataComponent = class {
 	id;
 	constructor(config) {
 		this.id = config.id || generateIdFromName(config.name);
-		let processedProps;
-		if (config.props && isZodSchema(config.props)) processedProps = convertZodToJsonSchema(config.props);
-		else processedProps = config.props;
+		const processedProps = isZodSchema(config.props) ? convertZodToJsonSchema(config.props) : config.props;
 		this.config = {
 			...config,
 			id: this.id,

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ScheduledTrigger, ScheduledTriggerConfig, ScheduledTriggerInterface } from "./scheduled-trigger.js";
 import { Trigger, TriggerConfig, TriggerInterface } from "./trigger.js";
 import { ArtifactComponent, ArtifactComponentInterface } from "./artifact-component.js";
 import { Tool } from "./tool.js";
@@ -6,16 +7,17 @@ import { transfer } from "./builders.js";
 import { DataComponent, DataComponentInterface } from "./data-component.js";
 import { ExternalAgent, externalAgent, externalAgents } from "./external-agent.js";
 import { FunctionTool } from "./function-tool.js";
-import { AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, ArtifactComponentWithZodProps, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, DataComponentWithZodProps, ExternalAgentInterface, FetchDefinitionConfig, FunctionToolConfig, GenerateOptions, MCPToolConfig, MaxTurnsExceededError, Message, MessageInput, ModelSettings, RequestSchemaConfig, RequestSchemaDefinition, RunResult, ServerConfig, StreamEvent, StreamResponse, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface } from "./types.js";
+import { AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, ExternalAgentInterface, FetchDefinitionConfig, FunctionToolConfig, GenerateOptions, MCPToolConfig, MaxTurnsExceededError, Message, MessageInput, ModelSettings, RequestSchemaConfig, RequestSchemaDefinition, RunResult, ServerConfig, SkillDefinition, SkillReference, StreamEvent, StreamResponse, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface } from "./types.js";
 import { Project } from "./project.js";
 import { StatusComponent, StatusComponentInterface } from "./status-component.js";
-import { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, statusComponent, subAgent, trigger } from "./builderFunctions.js";
+import { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, scheduledTrigger, statusComponent, subAgent, trigger } from "./builderFunctions.js";
 import { CredentialProviderConfig, CredentialProviderType, CredentialStore, CustomCredentialConfig, InkeepCredentialProvider, KeychainCredentialConfig, MemoryCredentialConfig, NangoCredentialConfig, createCredentialProvider } from "./credential-provider.js";
 import { CredentialReference, ExtractCredentialIds, UnionCredentialIds, credentialRef, isCredentialReference } from "./credential-ref.js";
 import { createEnvironmentSettings, registerEnvironmentSettings } from "./environment-settings.js";
 import { EvaluationClient, EvaluationClientConfig, evaluationClient } from "./evaluationClient.js";
 import { createFullProjectViaAPI, deleteFullProjectViaAPI, getFullProjectViaAPI, updateFullProjectViaAPI } from "./projectFullClient.js";
 import { Runner, raceAgents, run, stream } from "./runner.js";
+import { loadSkills } from "./skill-loader.js";
 import { ConsoleTelemetryProvider, InkeepTelemetryProvider, NoOpTelemetryProvider, OpenTelemetryConfig, SpanOptions, SpanStatus, SpanStatusType, TelemetryConfig, TelemetryLogger, TelemetryMetrics, TelemetryProvider, TelemetrySpan, TelemetryTracer, createConsoleTelemetryProvider, createNoOpTelemetryProvider, createOpenTelemetryProvider, getGlobalTelemetryProvider, setGlobalTelemetryProvider } from "./telemetry-provider.js";
 import { ANTHROPIC_MODELS, GOOGLE_MODELS, OPENAI_MODELS, SignatureSource, SignatureVerificationConfig, SignedComponent } from "@inkeep/agents-core";
-export { ANTHROPIC_MODELS, AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, ArtifactComponent, type ArtifactComponentInterface, ArtifactComponentWithZodProps, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, ConsoleTelemetryProvider, type CredentialProviderConfig, type CredentialProviderType, type CredentialReference, type CredentialStore, type CustomCredentialConfig, DataComponent, type DataComponentInterface, DataComponentWithZodProps, EvaluationClient, type EvaluationClientConfig, ExternalAgent, ExternalAgentInterface, type ExtractCredentialIds, FetchDefinitionConfig, FunctionTool, FunctionToolConfig, GOOGLE_MODELS, GenerateOptions, InkeepCredentialProvider, InkeepTelemetryProvider, type KeychainCredentialConfig, MCPToolConfig, MaxTurnsExceededError, type MemoryCredentialConfig, Message, MessageInput, ModelSettings, type NangoCredentialConfig, NoOpTelemetryProvider, OPENAI_MODELS, type OpenTelemetryConfig, Project, RequestSchemaConfig, RequestSchemaDefinition, RunResult, Runner, ServerConfig, type SignatureSource, type SignatureVerificationConfig, type SignedComponent, type SpanOptions, SpanStatus, type SpanStatusType, StatusComponent, type StatusComponentInterface, StreamEvent, StreamResponse, SubAgent, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, type TelemetryConfig, type TelemetryLogger, type TelemetryMetrics, type TelemetryProvider, type TelemetrySpan, type TelemetryTracer, Tool, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, Trigger, type TriggerConfig, type TriggerInterface, type UnionCredentialIds, UserMessage, agent, agentMcp, artifactComponent, createConsoleTelemetryProvider, createCredentialProvider, createEnvironmentSettings, createFullProjectViaAPI, createNoOpTelemetryProvider, createOpenTelemetryProvider, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, evaluationClient, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, getGlobalTelemetryProvider, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, setGlobalTelemetryProvider, statusComponent, stream, subAgent, subAgentExternalAgentInterface, subAgentTeamAgentInterface, transfer, trigger, updateFullProjectViaAPI };
+export { ANTHROPIC_MODELS, AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, ArtifactComponent, type ArtifactComponentInterface, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, ConsoleTelemetryProvider, type CredentialProviderConfig, type CredentialProviderType, type CredentialReference, type CredentialStore, type CustomCredentialConfig, DataComponent, type DataComponentInterface, EvaluationClient, type EvaluationClientConfig, ExternalAgent, ExternalAgentInterface, type ExtractCredentialIds, FetchDefinitionConfig, FunctionTool, FunctionToolConfig, GOOGLE_MODELS, GenerateOptions, InkeepCredentialProvider, InkeepTelemetryProvider, type KeychainCredentialConfig, MCPToolConfig, MaxTurnsExceededError, type MemoryCredentialConfig, Message, MessageInput, ModelSettings, type NangoCredentialConfig, NoOpTelemetryProvider, OPENAI_MODELS, type OpenTelemetryConfig, Project, RequestSchemaConfig, RequestSchemaDefinition, RunResult, Runner, ScheduledTrigger, type ScheduledTriggerConfig, type ScheduledTriggerInterface, ServerConfig, type SignatureSource, type SignatureVerificationConfig, type SignedComponent, SkillDefinition, SkillReference, type SpanOptions, SpanStatus, type SpanStatusType, StatusComponent, type StatusComponentInterface, StreamEvent, StreamResponse, SubAgent, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, type TelemetryConfig, type TelemetryLogger, type TelemetryMetrics, type TelemetryProvider, type TelemetrySpan, type TelemetryTracer, Tool, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, Trigger, type TriggerConfig, type TriggerInterface, type UnionCredentialIds, UserMessage, agent, agentMcp, artifactComponent, createConsoleTelemetryProvider, createCredentialProvider, createEnvironmentSettings, createFullProjectViaAPI, createNoOpTelemetryProvider, createOpenTelemetryProvider, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, evaluationClient, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, getGlobalTelemetryProvider, isCredentialReference, loadSkills, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, scheduledTrigger, setGlobalTelemetryProvider, statusComponent, stream, subAgent, subAgentExternalAgentInterface, subAgentTeamAgentInterface, transfer, trigger, updateFullProjectViaAPI };

package/dist/index.js

@@ -3,11 +3,12 @@ import { FunctionTool } from "./function-tool.js";
 import { ArtifactComponent } from "./artifact-component.js";
 import { DataComponent } from "./data-component.js";
 import { Project } from "./project.js";
+import { ScheduledTrigger } from "./scheduled-trigger.js";
 import { StatusComponent } from "./status-component.js";
 import { Tool } from "./tool.js";
 import { SubAgent } from "./subAgent.js";
 import { Trigger } from "./trigger.js";
-import { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, statusComponent, subAgent, trigger } from "./builderFunctions.js";
+import { agent, agentMcp, artifactComponent, credential, dataComponent, functionTool, mcpServer, mcpTool, project, scheduledTrigger, statusComponent, subAgent, trigger } from "./builderFunctions.js";
 import { transfer } from "./builders.js";
 import { InkeepCredentialProvider, createCredentialProvider } from "./credential-provider.js";
 import { credentialRef, isCredentialReference } from "./credential-ref.js";
@@ -15,7 +16,8 @@ import { createEnvironmentSettings, registerEnvironmentSettings } from "./enviro
 import { EvaluationClient, evaluationClient } from "./evaluationClient.js";
 import { ExternalAgent, externalAgent, externalAgents } from "./external-agent.js";
 import { Runner, raceAgents, run, stream } from "./runner.js";
+import { loadSkills } from "./skill-loader.js";
 import { ConsoleTelemetryProvider, InkeepTelemetryProvider, NoOpTelemetryProvider, SpanStatus, createConsoleTelemetryProvider, createNoOpTelemetryProvider, createOpenTelemetryProvider, getGlobalTelemetryProvider, setGlobalTelemetryProvider } from "./telemetry-provider.js";
 import { ANTHROPIC_MODELS, GOOGLE_MODELS, OPENAI_MODELS } from "@inkeep/agents-core";
 
-export { ANTHROPIC_MODELS, ArtifactComponent, ConsoleTelemetryProvider, DataComponent, EvaluationClient, ExternalAgent, FunctionTool, GOOGLE_MODELS, InkeepCredentialProvider, InkeepTelemetryProvider, NoOpTelemetryProvider, OPENAI_MODELS, Project, Runner, SpanStatus, StatusComponent, SubAgent, Tool, Trigger, agent, agentMcp, artifactComponent, createConsoleTelemetryProvider, createCredentialProvider, createEnvironmentSettings, createFullProjectViaAPI, createNoOpTelemetryProvider, createOpenTelemetryProvider, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, evaluationClient, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, getGlobalTelemetryProvider, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, setGlobalTelemetryProvider, statusComponent, stream, subAgent, transfer, trigger, updateFullProjectViaAPI };
+export { ANTHROPIC_MODELS, ArtifactComponent, ConsoleTelemetryProvider, DataComponent, EvaluationClient, ExternalAgent, FunctionTool, GOOGLE_MODELS, InkeepCredentialProvider, InkeepTelemetryProvider, NoOpTelemetryProvider, OPENAI_MODELS, Project, Runner, ScheduledTrigger, SpanStatus, StatusComponent, SubAgent, Tool, Trigger, agent, agentMcp, artifactComponent, createConsoleTelemetryProvider, createCredentialProvider, createEnvironmentSettings, createFullProjectViaAPI, createNoOpTelemetryProvider, createOpenTelemetryProvider, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, evaluationClient, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, getGlobalTelemetryProvider, isCredentialReference, loadSkills, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, scheduledTrigger, setGlobalTelemetryProvider, statusComponent, stream, subAgent, transfer, trigger, updateFullProjectViaAPI };

package/dist/project.d.ts

@@ -2,7 +2,7 @@ import { ArtifactComponent } from "./artifact-component.js";
 import { Tool } from "./tool.js";
 import { DataComponent } from "./data-component.js";
 import { ExternalAgent } from "./external-agent.js";
-import { ModelSettings } from "./types.js";
+import { ModelSettings, SkillDefinition } from "./types.js";
 import { Agent } from "./agent.js";
 import { CredentialReferenceApiInsert, FullProjectDefinition, StopWhen } from "@inkeep/agents-core";
 
@@ -27,6 +27,7 @@ interface ProjectConfig {
   dataComponents?: () => DataComponent[];
   artifactComponents?: () => ArtifactComponent[];
   credentialReferences?: () => CredentialReferenceApiInsert[];
+  skills?: () => SkillDefinition[];
 }
 /**
 * Project interface for operations
@@ -98,6 +99,7 @@ declare class Project implements ProjectInterface {
   private projectArtifactComponents;
   private projectExternalAgents;
   private externalAgentMap;
+  private skills;
   constructor(config: ProjectConfig);
   /**
   * Set or update the configuration (tenantId and apiUrl)

package/dist/project.js

@@ -48,6 +48,7 @@ var Project = class {
 	projectArtifactComponents = [];
 	projectExternalAgents = [];
 	externalAgentMap = /* @__PURE__ */ new Map();
+	skills = [];
 	constructor(config) {
 		this.projectId = config.id;
 		this.projectName = config.name;
@@ -56,6 +57,7 @@ var Project = class {
 		this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
 		this.models = config.models;
 		this.stopWhen = config.stopWhen;
+		this.skills = config.skills ? config.skills() : [];
 		if (config.agents) {
 			this.agents = config.agents();
 			this.agentMap = new Map(this.agents.map((agent) => [agent.getId(), agent]));
@@ -321,6 +323,8 @@ var Project = class {
 		const artifactComponentsObject = {};
 		const credentialReferencesObject = {};
 		const externalAgentsObject = {};
+		const skillsObject = {};
+		const skillTimestamp = (/* @__PURE__ */ new Date()).toISOString();
 		const credentialUsageMap = {};
 		for (const agent of this.agents) {
 			logger.info({ agentId: agent.getId() }, "Agent id");
@@ -552,6 +556,18 @@ var Project = class {
 			}
 		}
 		logger.info({ externalAgentsObject }, "External agents object");
+		for (const skill of this.skills) {
+			if (!skill.id) continue;
+			skillsObject[skill.id] = {
+				id: skill.id,
+				name: skill.name,
+				description: skill.description,
+				content: skill.content,
+				metadata: skill.metadata ?? null,
+				createdAt: skill.createdAt ?? skillTimestamp,
+				updatedAt: skill.updatedAt ?? skillTimestamp
+			};
+		}
 		for (const tool of this.projectTools) {
 			const toolId = tool.getId();
 			if (!toolsObject[toolId]) {
@@ -623,6 +639,7 @@ var Project = class {
 			artifactComponents: Object.keys(artifactComponentsObject).length > 0 ? artifactComponentsObject : void 0,
 			externalAgents: Object.keys(externalAgentsObject).length > 0 ? externalAgentsObject : void 0,
 			credentialReferences: Object.keys(credentialReferencesObject).length > 0 ? credentialReferencesObject : void 0,
+			skills: Object.keys(skillsObject).length > 0 ? skillsObject : void 0,
 			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 		};

package/dist/scheduled-trigger.d.ts

@@ -0,0 +1,43 @@
+import { ScheduledTriggerInsert } from "@inkeep/agents-core";
+
+//#region src/scheduled-trigger.d.ts
+type ScheduledTriggerConfig = Omit<ScheduledTriggerInsert, "id"> & {
+  id?: string;
+};
+interface ScheduledTriggerInterface {
+  getId(): string;
+  getName(): string;
+  getConfig(): Omit<ScheduledTriggerInsert, "id"> & {
+    id: string;
+  };
+  with(config: Partial<ScheduledTriggerConfig>): ScheduledTrigger;
+}
+declare class ScheduledTrigger implements ScheduledTriggerInterface {
+  private config;
+  private id;
+  constructor(config: ScheduledTriggerConfig);
+  getId(): string;
+  getName(): string;
+  getConfig(): Omit<ScheduledTriggerInsert, "id"> & {
+    id: string;
+  };
+  /**
+  * Creates a new ScheduledTrigger with the given configuration overrides.
+  *
+  * @param config - Partial configuration to override
+  * @returns A new ScheduledTrigger instance with the merged configuration
+  *
+  * @example
+  * ```typescript
+  * const trigger = new ScheduledTrigger({
+  *   name: 'Daily Report',
+  *   cronExpression: '0 9 * * *',
+  *   messageTemplate: 'Generate daily report for {{date}}',
+  * });
+  * const disabled = trigger.with({ enabled: false });
+  * ```
+  */
+  with(config: Partial<ScheduledTriggerConfig>): ScheduledTrigger;
+}
+//#endregion
+export { ScheduledTrigger, ScheduledTriggerConfig, ScheduledTriggerInterface };

package/dist/scheduled-trigger.js

@@ -0,0 +1,56 @@
+import { generateIdFromName } from "./utils/generateIdFromName.js";
+import { getLogger } from "@inkeep/agents-core";
+
+//#region src/scheduled-trigger.ts
+const logger = getLogger("scheduled-trigger");
+var ScheduledTrigger = class ScheduledTrigger {
+	config;
+	id;
+	constructor(config) {
+		this.id = config.id || generateIdFromName(config.name);
+		this.config = {
+			...config,
+			id: this.id
+		};
+		logger.info({
+			scheduledTriggerId: this.getId(),
+			scheduledTriggerName: config.name,
+			cronExpression: config.cronExpression,
+			runAt: config.runAt
+		}, "ScheduledTrigger constructor initialized");
+	}
+	getId() {
+		return this.id;
+	}
+	getName() {
+		return this.config.name;
+	}
+	getConfig() {
+		return this.config;
+	}
+	/**
+	* Creates a new ScheduledTrigger with the given configuration overrides.
+	*
+	* @param config - Partial configuration to override
+	* @returns A new ScheduledTrigger instance with the merged configuration
+	*
+	* @example
+	* ```typescript
+	* const trigger = new ScheduledTrigger({
+	*   name: 'Daily Report',
+	*   cronExpression: '0 9 * * *',
+	*   messageTemplate: 'Generate daily report for {{date}}',
+	* });
+	* const disabled = trigger.with({ enabled: false });
+	* ```
+	*/
+	with(config) {
+		return new ScheduledTrigger({
+			...this.config,
+			...config
+		});
+	}
+};
+
+//#endregion
+export { ScheduledTrigger };

package/dist/skill-loader.d.ts

@@ -0,0 +1,6 @@
+import { SkillDefinition } from "./types.js";
+
+//#region src/skill-loader.d.ts
+declare function loadSkills(directoryPath: string): SkillDefinition[];
+//#endregion
+export { loadSkills };

package/dist/skill-loader.js

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+import { SkillFrontmatterSchema } from "@inkeep/agents-core/client-exports";
+import { simplematter } from "simplematter";
+
+//#region src/skill-loader.ts
+function getParentDirName(filePath) {
+	return path.basename(path.dirname(filePath));
+}
+function loadSkills(directoryPath) {
+	return fs.globSync("*/SKILL.md", { cwd: directoryPath }).map((filePath) => {
+		const resolvedPath = path.join(directoryPath, filePath);
+		const [frontmatter, document] = simplematter(fs.readFileSync(resolvedPath, "utf8"));
+		const { name, description, metadata } = SkillFrontmatterSchema.parse(frontmatter);
+		const id = getParentDirName(filePath);
+		if (name !== id) throw new Error(`Skill name "${name}" does not match directory "${id}"`);
+		return {
+			id,
+			name,
+			description,
+			metadata,
+			content: document.trim()
+		};
+	});
+}
+
+//#endregion
+export { loadSkills };

package/dist/subAgent.d.ts

@@ -1,11 +1,11 @@
 import { Tool } from "./tool.js";
-import { AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, SubAgentConfig, SubAgentInterface, subAgentExternalAgentInterface, subAgentTeamAgentInterface } from "./types.js";
+import { AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, SkillDefinition, SubAgentConfig, SubAgentInterface, subAgentExternalAgentInterface, subAgentTeamAgentInterface } from "./types.js";
 import { ArtifactComponentApiInsert, DataComponentApiInsert } from "@inkeep/agents-core";
 
 //#region src/subAgent.d.ts
 declare class SubAgent implements SubAgentInterface {
   config: SubAgentConfig;
-  readonly type: "internal";
+  readonly type = "internal";
   private baseURL;
   private tenantId;
   private projectId;
@@ -27,6 +27,12 @@ declare class SubAgent implements SubAgentInterface {
   getExternalAgentDelegates(): subAgentExternalAgentInterface[];
   getTeamAgentDelegates(): subAgentTeamAgentInterface[];
   getDelegates(): AllDelegateOutputInterface[];
+  getSkills(): Array<{
+    id: string;
+    index?: number;
+    alwaysLoaded?: boolean;
+    skill?: SkillDefinition;
+  }>;
   getDataComponents(): DataComponentApiInsert[];
   getArtifactComponents(): ArtifactComponentApiInsert[];
   addTool(_name: string, tool: Tool): void;

package/dist/subAgent.js

@@ -127,6 +127,38 @@ var SubAgent = class {
 			...this.getExternalAgentDelegates()
 		];
 	}
+	getSkills() {
+		const skills = resolveGetter(this.config.skills);
+		if (!skills) return [];
+		return skills.map((entry, idx) => {
+			if (!entry) return null;
+			if (typeof entry === "string") return {
+				id: entry,
+				index: idx
+			};
+			if ("id" in entry) {
+				const skillEntry = entry;
+				const hasSkillDefinition = typeof skillEntry.content === "string" || typeof skillEntry.name === "string";
+				const alwaysLoaded = typeof skillEntry.alwaysLoaded === "boolean" ? skillEntry.alwaysLoaded : void 0;
+				return {
+					id: skillEntry.id,
+					index: skillEntry.index ?? idx,
+					...alwaysLoaded !== void 0 && { alwaysLoaded },
+					...hasSkillDefinition && { skill: skillEntry }
+				};
+			}
+			if ("skillId" in entry) {
+				const skillEntry = entry;
+				const alwaysLoaded = typeof skillEntry.alwaysLoaded === "boolean" ? skillEntry.alwaysLoaded : void 0;
+				return {
+					id: skillEntry.skillId,
+					index: skillEntry.index ?? idx,
+					...alwaysLoaded !== void 0 && { alwaysLoaded }
+				};
+			}
+			return null;
+		}).filter((p) => !!p);
+	}
 	getDataComponents() {
 		return (resolveGetter(this.config.dataComponents) || []).map((comp) => {
 			if (comp && typeof comp.getId === "function") return {

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import { ScheduledTriggerInterface } from "./scheduled-trigger.js";
 import { TriggerInterface } from "./trigger.js";
 import { ArtifactComponentInterface } from "./artifact-component.js";
 import { Tool } from "./tool.js";
@@ -9,18 +10,7 @@ import { AgentConversationHistoryConfig, AgentStopWhen, ArtifactComponentApiInse
 import { z } from "zod";
 
 //#region src/types.d.ts
-interface ArtifactComponentWithZodProps {
-  id: string;
-  name: string;
-  description: string;
-  props?: z.ZodObject<any>;
-}
-interface DataComponentWithZodProps {
-  id: string;
-  name: string;
-  description: string;
-  props?: z.ZodObject<any>;
-}
+
 /**
 * Tool instance that may have additional metadata attached during agent processing
 */
@@ -66,6 +56,27 @@ interface ToolResult {
   result: any;
   error?: string;
 }
+interface SkillDefinition {
+  id: string;
+  name: string;
+  description: string;
+  content: string;
+  metadata: Record<string, string> | null;
+  createdAt?: string;
+  updatedAt?: string;
+}
+type SkillReference = string | {
+  id: string;
+  index?: number;
+  alwaysLoaded?: boolean;
+} | {
+  skillId: string;
+  index?: number;
+  alwaysLoaded?: boolean;
+} | (SkillDefinition & {
+  index?: number;
+  alwaysLoaded?: boolean;
+});
 type AllDelegateInputInterface = SubAgentInterface | subAgentExternalAgentInterface | ExternalAgentInterface | AgentInterface | subAgentTeamAgentInterface;
 type AllDelegateOutputInterface = SubAgentInterface | subAgentExternalAgentInterface | subAgentTeamAgentInterface;
 type SubAgentCanUseType = Tool | AgentMcpConfig | FunctionTool;
@@ -74,8 +85,9 @@ interface SubAgentConfig extends Omit<SubAgentApiInsert, "projectId"> {
   canUse?: () => SubAgentCanUseType[];
   canTransferTo?: () => SubAgentInterface[];
   canDelegateTo?: () => AllDelegateInputInterface[];
-  dataComponents?: () => (DataComponentApiInsert | DataComponentInterface | DataComponentWithZodProps)[];
-  artifactComponents?: () => (ArtifactComponentApiInsert | ArtifactComponentInterface | ArtifactComponentWithZodProps)[];
+  skills?: () => SkillReference[];
+  dataComponents?: () => (DataComponentApiInsert | DataComponentInterface)[];
+  artifactComponents?: () => (ArtifactComponentApiInsert | ArtifactComponentInterface)[];
   conversationHistoryConfig?: AgentConversationHistoryConfig;
 }
 interface ToolConfig extends ToolInsert {
@@ -201,6 +213,7 @@ interface AgentConfig {
   };
   statusUpdates?: StatusUpdateSettings;
   triggers?: () => TriggerInterface[];
+  scheduledTriggers?: () => ScheduledTriggerInterface[];
 }
 declare class AgentError extends Error {
   code?: string | undefined;
@@ -231,6 +244,12 @@ interface SubAgentInterface {
   getExternalAgentDelegates(): subAgentExternalAgentInterface[];
   getDataComponents(): DataComponentApiInsert[];
   getArtifactComponents(): ArtifactComponentApiInsert[];
+  getSkills(): Array<{
+    id: string;
+    index?: number;
+    alwaysLoaded?: boolean;
+    skill?: SkillDefinition;
+  }>;
   setContext(tenantId: string, projectId: string, baseURL?: string): void;
   addTool(name: string, tool: any): void;
   addTransfer(...agents: SubAgentInterface[]): void;
@@ -261,7 +280,7 @@ type subAgentTeamAgentInterface = {
 };
 interface AgentInterface {
   init(): Promise<void>;
-  setConfig(tenantId: string, projectId: string, apiUrl: string): void;
+  setConfig(tenantId: string, projectId: string, apiUrl: string, skills?: SkillDefinition[]): void;
   getId(): string;
   getName(): string;
   getDescription(): string | undefined;
@@ -302,4 +321,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, type TriggerInterface, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface };
+export { AgentConfig, AgentError, AgentInterface, AgentResponse, AgentTool, AllDelegateInputInterface, AllDelegateOutputInterface, AssistantMessage, BuilderAgentConfig, BuilderRelationConfig, BuilderToolConfig, ExternalAgentInterface, FetchDefinitionConfig, type FunctionToolConfig, GenerateOptions, MCPToolConfig, MaxTurnsExceededError, Message, MessageInput, type ModelSettings, RequestSchemaConfig, RequestSchemaDefinition, RunResult, type ScheduledTriggerInterface, ServerConfig, SkillDefinition, SkillReference, StreamEvent, StreamResponse, SubAgentCanUseType, SubAgentConfig, SubAgentInterface, SystemMessage, ToolCall, ToolConfig, ToolExecutionError, ToolMessage, ToolResult, TransferConfig, TransferError, type TriggerInterface, UserMessage, subAgentExternalAgentInterface, subAgentTeamAgentInterface };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.47.4",
+  "version": "0.48.0",
   "description": "Agents SDK for building and managing agents in the Inkeep Agent Framework",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -13,14 +13,15 @@
   },
   "dependencies": {
     "@yarnpkg/lockfile": "^1.1.0",
+    "simplematter": "^1.0.0",
     "js-yaml": "^4.1.0",
     "typescript": "^5.3.3",
     "zod": "^4.3.6",
-    "@inkeep/agents-core": "^0.47.4"
+    "@inkeep/agents-core": "^0.48.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.24",
+    "@types/node": "^22.19.3",
     "@types/yarnpkg__lockfile": "^1.1.0",
     "@vitest/coverage-v8": "^3.2.4",
     "vitest": "^3.2.4"