@inkeep/agents-sdk 0.21.1 → 0.22.1

package/dist/index.js

@@ -377,7 +377,9 @@ var FunctionTool = class {
       for (const dep in deps) {
         if (deps[dep] === false) {
           delete deps[dep];
-          throw new Error(`Dependency \x1B[1;32m${dep}\x1B[0m used in function tool \x1B[1;32m${config.name}\x1B[0m is neither installed nor in dependencies object.`);
+          throw new Error(
+            `Dependency \x1B[1;32m${dep}\x1B[0m used in function tool \x1B[1;32m${config.name}\x1B[0m is neither installed nor in dependencies object.`
+          );
         }
       }
       this.config.dependencies = deps;
@@ -637,6 +639,31 @@ var Agent = class {
         };
       }
     }
+    const processedStatusUpdates = this.statusUpdateSettings ? {
+      ...this.statusUpdateSettings,
+      statusComponents: this.statusUpdateSettings.statusComponents?.map((comp) => {
+        if (comp && typeof comp.getType === "function") {
+          return {
+            type: comp.getType(),
+            description: comp.getDescription(),
+            detailsSchema: comp.getDetailsSchema()
+          };
+        }
+        if (comp && typeof comp === "object" && comp.detailsSchema && isZodSchema(comp.detailsSchema)) {
+          const jsonSchema = convertZodToJsonSchema(comp.detailsSchema);
+          return {
+            type: comp.type,
+            description: comp.description,
+            detailsSchema: {
+              type: "object",
+              properties: jsonSchema.properties || {},
+              required: jsonSchema.required || void 0
+            }
+          };
+        }
+        return comp;
+      })
+    } : void 0;
     return {
       id: this.agentId,
       name: this.agentName,
@@ -647,7 +674,7 @@ var Agent = class {
       ...Object.keys(functionToolsObject).length > 0 && { functionTools: functionToolsObject },
       ...Object.keys(functionsObject).length > 0 && { functions: functionsObject },
       models: this.models,
-      statusUpdates: this.statusUpdateSettings,
+      statusUpdates: processedStatusUpdates,
       prompt: this.prompt,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -2035,7 +2062,6 @@ var Project = class {
     __publicField(this, "initialized", false);
     __publicField(this, "models");
     __publicField(this, "stopWhen");
-    __publicField(this, "sandboxConfig");
     __publicField(this, "agents", []);
     __publicField(this, "agentMap", /* @__PURE__ */ new Map());
     __publicField(this, "credentialReferences", []);
@@ -2049,7 +2075,6 @@ var Project = class {
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.models = config.models;
     this.stopWhen = config.stopWhen;
-    this.sandboxConfig = config.sandboxConfig;
     if (config.agents) {
       this.agents = config.agents();
       this.agentMap = new Map(this.agents.map((agent2) => [agent2.getId(), agent2]));
@@ -2608,7 +2633,6 @@ var Project = class {
       description: this.projectDescription || "",
       models: this.models,
       stopWhen: this.stopWhen,
-      sandboxConfig: this.sandboxConfig,
       agents: agentsObject,
       tools: toolsObject,
       functions: Object.keys(functionsObject).length > 0 ? functionsObject : void 0,
@@ -2620,7 +2644,43 @@ var Project = class {
     };
   }
 };
-var logger9 = getLogger("tool");
+var logger9 = getLogger("statusComponent");
+var StatusComponent = class {
+  constructor(config) {
+    __publicField(this, "config");
+    let processedDetailsSchema;
+    if (config.detailsSchema && isZodSchema(config.detailsSchema)) {
+      const jsonSchema = convertZodToJsonSchema(config.detailsSchema);
+      processedDetailsSchema = {
+        type: "object",
+        properties: jsonSchema.properties || {},
+        required: jsonSchema.required || void 0
+      };
+    } else {
+      processedDetailsSchema = config.detailsSchema;
+    }
+    this.config = {
+      ...config,
+      detailsSchema: processedDetailsSchema
+    };
+    logger9.info(
+      {
+        statusComponentType: config.type
+      },
+      "StatusComponent constructor initialized"
+    );
+  }
+  getType() {
+    return this.config.type;
+  }
+  getDescription() {
+    return this.config.description;
+  }
+  getDetailsSchema() {
+    return this.config.detailsSchema;
+  }
+};
+var logger10 = getLogger("tool");
 var Tool = class {
   constructor(config) {
     __publicField(this, "config");
@@ -2632,7 +2692,7 @@ var Tool = class {
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.tenantId = "default";
     this.projectId = "default";
-    logger9.info(
+    logger10.info(
       {
         Id: this.getId(),
         Name: config.name
@@ -2674,7 +2734,7 @@ var Tool = class {
       if (!options?.skipDatabaseRegistration) {
         await this.upsertTool();
       }
-      logger9.info(
+      logger10.info(
         {
           toolId: this.getId()
         },
@@ -2682,7 +2742,7 @@ var Tool = class {
       );
       this.initialized = true;
     } catch (error) {
-      logger9.error(
+      logger10.error(
         {
           toolId: this.getId(),
           error: error instanceof Error ? error.message : "Unknown error"
@@ -2714,7 +2774,7 @@ var Tool = class {
     const toolDataForCreate = {
       ...toolDataForUpdate
     };
-    logger9.info({ toolDataForCreate }, "toolDataForCreate");
+    logger10.info({ toolDataForCreate }, "toolDataForCreate");
     const updateResponse = await fetch(
       `${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/tools/${this.getId()}`,
       {
@@ -2725,9 +2785,9 @@ var Tool = class {
         body: JSON.stringify(toolDataForUpdate)
       }
     );
-    logger9.info({ updateResponse }, "tool updateResponse");
+    logger10.info({ updateResponse }, "tool updateResponse");
     if (updateResponse.ok) {
-      logger9.info(
+      logger10.info(
         {
           toolId: this.getId()
         },
@@ -2736,7 +2796,7 @@ var Tool = class {
       return;
     }
     if (updateResponse.status === 404) {
-      logger9.info(
+      logger10.info(
         {
           toolId: this.getId()
         },
@@ -2755,7 +2815,7 @@ var Tool = class {
       if (!createResponse.ok) {
         throw new Error(`Failed to create tool: ${createResponse.status}`);
       }
-      logger9.info(
+      logger10.info(
         {
           toolId: this.getId()
         },
@@ -2796,7 +2856,7 @@ function normalizeAgentCanUseType(value, fallbackName) {
 }
 
 // src/subAgent.ts
-var logger10 = getLogger("agent");
+var logger11 = getLogger("agent");
 function resolveGetter2(value) {
   if (typeof value === "function") {
     return value();
@@ -2815,7 +2875,7 @@ var SubAgent = class {
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.tenantId = "default";
     this.projectId = "default";
-    logger10.info(
+    logger11.info(
       {
         tenantId: this.tenantId,
         subAgentId: this.config.id,
@@ -2965,7 +3025,7 @@ var SubAgent = class {
       await this.saveToolsAndRelations();
       await this.saveDataComponents();
       await this.saveArtifactComponents();
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId()
         },
@@ -2973,7 +3033,7 @@ var SubAgent = class {
       );
       this.initialized = true;
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           error: error instanceof Error ? error.message : "Unknown error"
@@ -3005,7 +3065,7 @@ var SubAgent = class {
       }
     );
     if (updateResponse.ok) {
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId()
         },
@@ -3014,7 +3074,7 @@ var SubAgent = class {
       return;
     }
     if (updateResponse.status === 404) {
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId()
         },
@@ -3033,7 +3093,7 @@ var SubAgent = class {
           `Failed to create agent: ${createResponse.status} ${createResponse.statusText} - ${errorText2}`
         );
       }
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId()
         },
@@ -3056,7 +3116,7 @@ var SubAgent = class {
             const normalizedTool = normalizeAgentCanUseType(toolConfig, `tool-${i}`);
             await this.createTool(normalizedTool.toolId, toolConfig);
           } catch (error) {
-            logger10.error(
+            logger11.error(
               {
                 toolId: isAgentMcpConfig(toolConfig) ? toolConfig.server.getId() : toolConfig.getId?.(),
                 error: error instanceof Error ? error.message : "Unknown error"
@@ -3070,7 +3130,7 @@ var SubAgent = class {
     }
   }
   async saveDataComponents() {
-    logger10.info({ dataComponents: this.config.dataComponents }, "dataComponents and config");
+    logger11.info({ dataComponents: this.config.dataComponents }, "dataComponents and config");
     const components = resolveGetter2(this.config.dataComponents);
     if (components) {
       for (const dataComponent2 of components) {
@@ -3085,7 +3145,7 @@ var SubAgent = class {
     }
   }
   async saveArtifactComponents() {
-    logger10.info(
+    logger11.info(
       { artifactComponents: this.config.artifactComponents },
       "artifactComponents and config"
     );
@@ -3140,7 +3200,7 @@ var SubAgent = class {
         return acc;
       }, []);
       this.config.dataComponents = () => uniqueComponents;
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId(),
           dbComponentCount: dbDataComponents.length,
@@ -3150,7 +3210,7 @@ var SubAgent = class {
         "Loaded and merged data components"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           error: error instanceof Error ? error.message : "Unknown error"
@@ -3197,7 +3257,7 @@ var SubAgent = class {
         return acc;
       }, []);
       this.config.artifactComponents = () => uniqueComponents;
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId(),
           dbComponentCount: dbArtifactComponents.length,
@@ -3207,7 +3267,7 @@ var SubAgent = class {
         "Loaded and merged artifact components"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           error: error instanceof Error ? error.message : "Unknown error"
@@ -3221,7 +3281,7 @@ var SubAgent = class {
       const functionData = functionTool2.serializeFunction();
       const toolData = functionTool2.serializeTool();
       const functionUrl = `${this.baseURL}/tenants/${this.tenantId}/crud/projects/${this.projectId}/functions`;
-      logger10.info(
+      logger11.info(
         {
           agentId: this.getId(),
           toolId,
@@ -3241,7 +3301,7 @@ var SubAgent = class {
           dependencies: functionData.dependencies
         })
       });
-      logger10.info(
+      logger11.info(
         {
           agentId: this.getId(),
           toolId,
@@ -3252,7 +3312,7 @@ var SubAgent = class {
       );
       if (!functionResponse.ok) {
         const errorText = await functionResponse.text();
-        logger10.error(
+        logger11.error(
           {
             agentId: this.getId(),
             toolId,
@@ -3265,7 +3325,7 @@ var SubAgent = class {
         throw new Error(`Failed to create function: ${functionResponse.status} ${errorText}`);
       }
       const toolUrl = `${this.baseURL}/tenants/${this.tenantId}/crud/projects/${this.projectId}/tools`;
-      logger10.info(
+      logger11.info(
         {
           agentId: this.getId(),
           toolId,
@@ -3289,7 +3349,7 @@ var SubAgent = class {
           }
         })
       });
-      logger10.info(
+      logger11.info(
         {
           agentId: this.getId(),
           toolId,
@@ -3300,7 +3360,7 @@ var SubAgent = class {
       );
       if (!toolResponse.ok) {
         const errorText = await toolResponse.text();
-        logger10.error(
+        logger11.error(
           {
             agentId: this.getId(),
             toolId,
@@ -3313,7 +3373,7 @@ var SubAgent = class {
         throw new Error(`Failed to create tool: ${toolResponse.status} ${errorText}`);
       }
       await this.createAgentToolRelation(toolData.id);
-      logger10.info(
+      logger11.info(
         {
           agentId: this.getId(),
           functionId: functionData.id,
@@ -3322,7 +3382,7 @@ var SubAgent = class {
         "Function and tool created successfully"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           agentId: this.getId(),
           toolId,
@@ -3341,7 +3401,7 @@ var SubAgent = class {
         return;
       }
       if (toolConfig.type === "function") {
-        logger10.info(
+        logger11.info(
           {
             subAgentId: this.getId(),
             toolId
@@ -3373,7 +3433,7 @@ var SubAgent = class {
         await tool.init();
       }
       await this.createAgentToolRelation(tool.getId(), selectedTools, headers);
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId(),
           toolId: tool.getId()
@@ -3381,7 +3441,7 @@ var SubAgent = class {
         "Tool created and linked to agent"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           toolId,
@@ -3403,7 +3463,7 @@ var SubAgent = class {
       dc.setContext(this.tenantId, this.projectId);
       await dc.init();
       await this.createAgentDataComponentRelation(dc.getId());
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId(),
           dataComponentId: dc.getId()
@@ -3411,7 +3471,7 @@ var SubAgent = class {
         "DataComponent created and linked to agent"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           dataComponentName: dataComponent2.name,
@@ -3433,7 +3493,7 @@ var SubAgent = class {
       ac.setContext(this.tenantId, this.projectId);
       await ac.init();
       await this.createAgentArtifactComponentRelation(ac.getId());
-      logger10.info(
+      logger11.info(
         {
           subAgentId: this.getId(),
           artifactComponentId: ac.getId()
@@ -3441,7 +3501,7 @@ var SubAgent = class {
         "ArtifactComponent created and linked to agent"
       );
     } catch (error) {
-      logger10.error(
+      logger11.error(
         {
           subAgentId: this.getId(),
           artifactComponentName: artifactComponent2.name,
@@ -3473,7 +3533,7 @@ var SubAgent = class {
         `Failed to create agent-dataComponent relation: ${relationResponse.status} ${relationResponse.statusText}`
       );
     }
-    logger10.info(
+    logger11.info(
       {
         subAgentId: this.getId(),
         dataComponentId
@@ -3502,7 +3562,7 @@ var SubAgent = class {
         `Failed to create agent-artifactComponent relation: ${relationResponse.status} ${relationResponse.statusText}`
       );
     }
-    logger10.info(
+    logger11.info(
       {
         subAgentId: this.getId(),
         artifactComponentId
@@ -3600,6 +3660,9 @@ function dataComponent(config) {
   };
   return new DataComponent(configWithId);
 }
+function statusComponent(config) {
+  return new StatusComponent(config);
+}
 function agentMcp(config) {
   return {
     server: config.server,
@@ -3672,7 +3735,7 @@ function createEnvironmentSettings(environments) {
 function registerEnvironmentSettings(config) {
   return config;
 }
-var logger11 = getLogger("external-agent-builder");
+var logger12 = getLogger("external-agent-builder");
 var ExternalAgent = class {
   constructor(config) {
     __publicField(this, "config");
@@ -3683,7 +3746,7 @@ var ExternalAgent = class {
     this.config = { ...config, type: "external" };
     this.tenantId = "default";
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    logger11.debug(
+    logger12.debug(
       {
         externalAgentName: this.config.name,
         baseUrl: this.config.baseUrl,
@@ -3699,7 +3762,7 @@ var ExternalAgent = class {
     if (this.initialized) return;
     try {
       await this.upsertExternalAgent();
-      logger11.info(
+      logger12.info(
         {
           externalSubAgentId: this.getId()
         },
@@ -3707,7 +3770,7 @@ var ExternalAgent = class {
       );
       this.initialized = true;
     } catch (error) {
-      logger11.error(
+      logger12.error(
         {
           externalSubAgentId: this.getId(),
           error: error instanceof Error ? error.message : "Unknown error"
@@ -3749,7 +3812,7 @@ var ExternalAgent = class {
       }
     );
     if (updateResponse.ok) {
-      logger11.info(
+      logger12.info(
         {
           externalSubAgentId: this.getId()
         },
@@ -3758,7 +3821,7 @@ var ExternalAgent = class {
       return;
     }
     if (updateResponse.status === 404) {
-      logger11.info(
+      logger12.info(
         {
           externalSubAgentId: this.getId()
         },
@@ -3780,7 +3843,7 @@ var ExternalAgent = class {
           `Failed to create external agent: ${createResponse.status} ${createResponse.statusText} - ${errorText2}`
         );
       }
-      logger11.info(
+      logger12.info(
         {
           externalSubAgentId: this.getId()
         },
@@ -3855,7 +3918,7 @@ var MaxTurnsExceededError = class extends AgentError {
 };
 
 // src/runner.ts
-var logger12 = getLogger("runner");
+var logger13 = getLogger("runner");
 var Runner = class _Runner {
   /**
    * Run an agent until completion, handling transfers and tool calls
@@ -3867,7 +3930,7 @@ var Runner = class _Runner {
     let turnCount = 0;
     const messageHistory = _Runner.normalizeToMessageHistory(messages);
     const allToolCalls = [];
-    logger12.info(
+    logger13.info(
       {
         agentId: agent2.getId(),
         defaultSubAgent: agent2.getDefaultSubAgent()?.getName(),
@@ -3877,7 +3940,7 @@ var Runner = class _Runner {
       "Starting agent run"
     );
     while (turnCount < maxTurns) {
-      logger12.debug(
+      logger13.debug(
         {
           agentId: agent2.getId(),
           turnCount,
@@ -3887,7 +3950,7 @@ var Runner = class _Runner {
       );
       const response = await agent2.generate(messageHistory, options);
       turnCount++;
-      logger12.info(
+      logger13.info(
         {
           agentId: agent2.getId(),
           turnCount,
@@ -3907,7 +3970,7 @@ var Runner = class _Runner {
         }
       };
     }
-    logger12.error(
+    logger13.error(
       {
         agentId: agent2.getId(),
         maxTurns,
@@ -3921,7 +3984,7 @@ var Runner = class _Runner {
    * Stream an agent's response
    */
   static async stream(agent2, messages, options) {
-    logger12.info(
+    logger13.info(
       {
         agentId: agent2.getId(),
         defaultSubAgent: agent2.getDefaultSubAgent()?.getName()
@@ -3937,7 +4000,7 @@ var Runner = class _Runner {
     if (agent2.length === 0) {
       throw new Error("No agent provided for race");
     }
-    logger12.info(
+    logger13.info(
       {
         agentCount: agent2.length,
         agentIds: agent2.map((g) => g.getId())
@@ -3949,7 +4012,7 @@ var Runner = class _Runner {
         const result2 = await _Runner.run(agent3, messages, options);
         return { ...result2, raceIndex: index };
       } catch (error) {
-        logger12.error(
+        logger13.error(
           {
             agentId: agent3.getId(),
             error: error instanceof Error ? error.message : "Unknown error"
@@ -3960,7 +4023,7 @@ var Runner = class _Runner {
       }
     });
     const result = await Promise.race(promises);
-    logger12.info(
+    logger13.info(
       {
         winningAgentId: result.agentId || "unknown",
         raceIndex: result.raceIndex
@@ -4034,4 +4097,4 @@ var run = Runner.run.bind(Runner);
 var stream = Runner.stream.bind(Runner);
 var raceAgents = Runner.raceAgents.bind(Runner);
 
-export { ArtifactComponent, DataComponent, ExternalAgent, FunctionTool, Project, Runner, SubAgent, Tool, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, stream, subAgent, transfer, updateFullProjectViaAPI };
+export { ArtifactComponent, DataComponent, ExternalAgent, FunctionTool, Project, Runner, StatusComponent, SubAgent, Tool, agent, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceAgents, registerEnvironmentSettings, run, statusComponent, stream, subAgent, transfer, updateFullProjectViaAPI };

package/package.json

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