@inkeep/agents-sdk 0.0.0-dev-20250920001717 → 0.0.0-dev-20250924191551

package/dist/index.cjs

@@ -2345,7 +2345,6 @@ var AgentGraph = class {
       throw error;
     }
   }
-  // enableComponentMode removed – feature deprecated
   async createExternalAgentRelation(sourceAgent, externalAgent2, relationType) {
     try {
       const response = await fetch(
@@ -3204,6 +3203,20 @@ function transfer(targetAgent, description, condition) {
   return config;
 }
 
+// src/default-status-schemas.ts
+var retrieveStatusSchema = {
+  type: "retrieve",
+  description: 'Use this when the system found or retrieved specific information from searches, queries, or lookups. ONLY report ACTUAL findings that appear explicitly in the tool results - never make up data, names, numbers, or details. The label must state the SPECIFIC discovery (e.g., "Found 3 authentication methods", "Database contains 500 records", "API supports JSON format") not the act of searching. Every detail must be traceable to actual tool output. NEVER invent placeholder names, fictional data, or information not present in the activities.'
+};
+var actionStatusSchema = {
+  type: "action",
+  description: 'Use this when the system executed a tool or performed an operation that modified state or had side effects. ONLY report ACTUAL tool executions and their results as they appear in the tool outputs - never make up tool names, parameters, or outcomes. The label must describe what specific action was performed and its concrete result based on actual tool execution data. DO NOT make up examples like "Ran test suite with X passes" unless a test suite was ACTUALLY run and reported X passes. DO NOT say "Executed database query" unless a database query was ACTUALLY executed. Only report what literally happened. NEVER invent tool names, execution results, or details not explicitly present in the tool execution activities. If a tool failed, report the actual failure, not imagined success.'
+};
+var defaultStatusSchemas = [
+  retrieveStatusSchema,
+  actionStatusSchema
+];
+
 // src/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
@@ -3432,6 +3445,7 @@ exports.ExternalAgent = ExternalAgent;
 exports.Project = Project;
 exports.Runner = Runner;
 exports.Tool = Tool;
+exports.actionStatusSchema = actionStatusSchema;
 exports.agent = agent;
 exports.agentGraph = agentGraph;
 exports.agentMcp = agentMcp;
@@ -3440,6 +3454,7 @@ exports.createEnvironmentSettings = createEnvironmentSettings;
 exports.createFullProjectViaAPI = createFullProjectViaAPI;
 exports.credential = credential;
 exports.dataComponent = dataComponent;
+exports.defaultStatusSchemas = defaultStatusSchemas;
 exports.deleteFullProjectViaAPI = deleteFullProjectViaAPI;
 exports.externalAgent = externalAgent;
 exports.externalAgents = externalAgents;
@@ -3449,6 +3464,7 @@ exports.mcpTool = mcpTool;
 exports.project = project;
 exports.raceGraphs = raceGraphs;
 exports.registerEnvironmentSettings = registerEnvironmentSettings;
+exports.retrieveStatusSchema = retrieveStatusSchema;
 exports.run = run;
 exports.stream = stream;
 exports.transfer = transfer;

package/dist/index.d.cts

@@ -314,7 +314,7 @@ interface RunResult {
 interface StatusComponent {
     type: string;
     description?: string;
-    schema?: {
+    detailsSchema?: {
         type: 'object';
         properties: Record<string, any>;
         required?: string[];
@@ -1064,6 +1064,25 @@ declare function artifactComponent(config: ArtifactComponentConfig): ArtifactCom
 declare function dataComponent(config: DataComponentConfig): DataComponent;
 declare function agentMcp(config: AgentMcpConfig): AgentMcpConfig;
 
+/**
+ * Default status component schemas for AI agent operations
+ */
+
+/**
+ * Schema for retrieve operations - when agents are looking up, searching,
+ * or researching information in web or downstream services
+ */
+declare const retrieveStatusSchema: StatusComponent;
+/**
+ * Schema for action operations - when agents are using tools or delegating
+ * tasks with side-effects to update, create, or modify downstream services
+ */
+declare const actionStatusSchema: StatusComponent;
+/**
+ * Default status component schemas collection
+ */
+declare const defaultStatusSchemas: StatusComponent[];
+
 interface EnvironmentSettingsConfig {
     credentials?: {
         [settingId: string]: CredentialReferenceApiInsert;
@@ -1139,4 +1158,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceGraphs: typeof Runner.raceGraphs;
 
-export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, actionStatusSchema, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, defaultStatusSchemas, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, retrieveStatusSchema, run, stream, transfer, updateFullProjectViaAPI };

package/dist/index.d.ts

@@ -314,7 +314,7 @@ interface RunResult {
 interface StatusComponent {
     type: string;
     description?: string;
-    schema?: {
+    detailsSchema?: {
         type: 'object';
         properties: Record<string, any>;
         required?: string[];
@@ -1064,6 +1064,25 @@ declare function artifactComponent(config: ArtifactComponentConfig): ArtifactCom
 declare function dataComponent(config: DataComponentConfig): DataComponent;
 declare function agentMcp(config: AgentMcpConfig): AgentMcpConfig;
 
+/**
+ * Default status component schemas for AI agent operations
+ */
+
+/**
+ * Schema for retrieve operations - when agents are looking up, searching,
+ * or researching information in web or downstream services
+ */
+declare const retrieveStatusSchema: StatusComponent;
+/**
+ * Schema for action operations - when agents are using tools or delegating
+ * tasks with side-effects to update, create, or modify downstream services
+ */
+declare const actionStatusSchema: StatusComponent;
+/**
+ * Default status component schemas collection
+ */
+declare const defaultStatusSchemas: StatusComponent[];
+
 interface EnvironmentSettingsConfig {
     credentials?: {
         [settingId: string]: CredentialReferenceApiInsert;
@@ -1139,4 +1158,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceGraphs: typeof Runner.raceGraphs;
 
-export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, actionStatusSchema, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, defaultStatusSchemas, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, retrieveStatusSchema, run, stream, transfer, updateFullProjectViaAPI };

package/dist/index.js

@@ -2343,7 +2343,6 @@ var AgentGraph = class {
       throw error;
     }
   }
-  // enableComponentMode removed – feature deprecated
   async createExternalAgentRelation(sourceAgent, externalAgent2, relationType) {
     try {
       const response = await fetch(
@@ -3202,6 +3201,20 @@ function transfer(targetAgent, description, condition) {
   return config;
 }
 
+// src/default-status-schemas.ts
+var retrieveStatusSchema = {
+  type: "retrieve",
+  description: 'Use this when the system found or retrieved specific information from searches, queries, or lookups. ONLY report ACTUAL findings that appear explicitly in the tool results - never make up data, names, numbers, or details. The label must state the SPECIFIC discovery (e.g., "Found 3 authentication methods", "Database contains 500 records", "API supports JSON format") not the act of searching. Every detail must be traceable to actual tool output. NEVER invent placeholder names, fictional data, or information not present in the activities.'
+};
+var actionStatusSchema = {
+  type: "action",
+  description: 'Use this when the system executed a tool or performed an operation that modified state or had side effects. ONLY report ACTUAL tool executions and their results as they appear in the tool outputs - never make up tool names, parameters, or outcomes. The label must describe what specific action was performed and its concrete result based on actual tool execution data. DO NOT make up examples like "Ran test suite with X passes" unless a test suite was ACTUALLY run and reported X passes. DO NOT say "Executed database query" unless a database query was ACTUALLY executed. Only report what literally happened. NEVER invent tool names, execution results, or details not explicitly present in the tool execution activities. If a tool failed, report the actual failure, not imagined success.'
+};
+var defaultStatusSchemas = [
+  retrieveStatusSchema,
+  actionStatusSchema
+];
+
 // src/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
@@ -3423,4 +3436,4 @@ var run = Runner.run.bind(Runner);
 var stream = Runner.stream.bind(Runner);
 var raceGraphs = Runner.raceGraphs.bind(Runner);
 
-export { Agent, ArtifactComponent, DataComponent, ExternalAgent, Project, Runner, Tool, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { Agent, ArtifactComponent, DataComponent, ExternalAgent, Project, Runner, Tool, actionStatusSchema, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, defaultStatusSchemas, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, retrieveStatusSchema, run, stream, transfer, updateFullProjectViaAPI };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.0.0-dev-20250920001717",
+  "version": "0.0.0-dev-20250924191551",
   "description": "Agents SDK for building and managing agents in the Inkeep Agent Framework",
   "main": "dist/index.js",
   "type": "module",
@@ -8,7 +8,7 @@
   "dependencies": {
     "nanoid": "^5.1.5",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250920001717"
+    "@inkeep/agents-core": "^0.0.0-dev-20250924191551"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",