@inkeep/agents-sdk 0.6.4 → 0.6.5

package/dist/index.cjs

@@ -437,6 +437,11 @@ var Tool = class {
   }
 };
 
+// src/utils/tool-normalization.ts
+function isAgentMcpConfig(value) {
+  return value !== null && typeof value === "object" && "server" in value && "selectedTools" in value && Array.isArray(value.selectedTools) && value.server && typeof value.server === "object";
+}
+
 // src/agent.ts
 var logger4 = agentsCore.getLogger("agent");
 function resolveGetter(value) {
@@ -501,14 +506,13 @@ var Agent = class {
       if (tool && typeof tool === "object") {
         let id;
         let toolInstance;
-        if ("server" in tool && "selectedTools" in tool) {
-          const agentMcpConfig = tool;
-          id = agentMcpConfig.server.getId();
-          toolInstance = agentMcpConfig.server;
-          toolInstance.selectedTools = agentMcpConfig.selectedTools;
+        if (isAgentMcpConfig(tool)) {
+          id = tool.server.getId();
+          toolInstance = tool.server;
+          toolInstance.selectedTools = tool.selectedTools;
         } else {
-          id = tool.id || tool.getId?.() || tool.name;
           toolInstance = tool;
+          id = toolInstance.getId();
         }
         if (id) {
           toolRecord[id] = toolInstance;
@@ -1054,171 +1058,9 @@ var Agent = class {
     }
   }
 };
-var logger5 = agentsCore.getLogger("external-agent-builder");
-var ExternalAgent = class {
-  constructor(config) {
-    __publicField(this, "config");
-    __publicField(this, "type", "external");
-    __publicField(this, "initialized", false);
-    __publicField(this, "tenantId");
-    __publicField(this, "baseURL");
-    this.config = { ...config, type: "external" };
-    this.tenantId = "default";
-    this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    logger5.debug(
-      {
-        externalAgentName: this.config.name,
-        baseUrl: this.config.baseUrl,
-        tenantId: this.tenantId
-      },
-      "External Agent constructor initialized"
-    );
-  }
-  /**
-   * Initialize the external agent by upserting it in the database
-   */
-  async init() {
-    if (this.initialized) return;
-    try {
-      await this.upsertExternalAgent();
-      logger5.info(
-        {
-          externalAgentId: this.getId()
-        },
-        "External agent initialized successfully"
-      );
-      this.initialized = true;
-    } catch (error) {
-      logger5.error(
-        {
-          externalAgentId: this.getId(),
-          error: error instanceof Error ? error.message : "Unknown error"
-        },
-        "Failed to initialize external agent"
-      );
-      throw error;
-    }
-  }
-  // Set context (tenantId) from external source (graph, CLI, etc)
-  setContext(tenantId) {
-    this.tenantId = tenantId;
-  }
-  // Compute ID from name using a simple slug transformation
-  getId() {
-    return this.config.id;
-  }
-  // Private method to upsert external agent (create or update)
-  async upsertExternalAgent() {
-    const externalAgentData = {
-      id: this.getId(),
-      name: this.config.name,
-      description: this.config.description,
-      baseUrl: this.config.baseUrl,
-      credentialReferenceId: this.config.credentialReference?.id || void 0,
-      headers: this.config.headers || void 0
-    };
-    const updateResponse = await fetch(
-      `${this.baseURL}/tenants/${this.tenantId}/external-agents/${this.getId()}`,
-      {
-        method: "PUT",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(externalAgentData)
-      }
-    );
-    if (updateResponse.ok) {
-      logger5.info(
-        {
-          externalAgentId: this.getId()
-        },
-        "External agent updated successfully"
-      );
-      return;
-    }
-    if (updateResponse.status === 404) {
-      logger5.info(
-        {
-          externalAgentId: this.getId()
-        },
-        "External agent not found, creating new external agent"
-      );
-      const createResponse = await fetch(
-        `${this.baseURL}/tenants/${this.tenantId}/external-agents`,
-        {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify(externalAgentData)
-        }
-      );
-      if (!createResponse.ok) {
-        const errorText2 = await createResponse.text().catch(() => "Unknown error");
-        throw new Error(
-          `Failed to create external agent: ${createResponse.status} ${createResponse.statusText} - ${errorText2}`
-        );
-      }
-      logger5.info(
-        {
-          externalAgentId: this.getId()
-        },
-        "External agent created successfully"
-      );
-      return;
-    }
-    const errorText = await updateResponse.text().catch(() => "Unknown error");
-    throw new Error(
-      `Failed to update external agent: ${updateResponse.status} ${updateResponse.statusText} - ${errorText}`
-    );
-  }
-  /**
-   * Get the external agent configuration
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-  /**
-   * Get the external agent name
-   */
-  getName() {
-    return this.config.name;
-  }
-  /**
-   * Get the external agent base URL
-   */
-  getBaseUrl() {
-    return this.config.baseUrl;
-  }
-  /**
-   * Get the tenant ID
-   */
-  getTenantId() {
-    return this.tenantId;
-  }
-  getDescription() {
-    return this.config.description || "";
-  }
-  getCredentialReferenceId() {
-    return this.config.credentialReference?.id || void 0;
-  }
-  getHeaders() {
-    return this.config.headers;
-  }
-};
-function externalAgent(config) {
-  return new ExternalAgent(config);
-}
-function externalAgents(configs) {
-  const builders = {};
-  for (const [name, config] of Object.entries(configs)) {
-    builders[name] = externalAgent(config);
-  }
-  return builders;
-}
-var logger6 = agentsCore.getLogger("graphFullClient");
+var logger5 = agentsCore.getLogger("graphFullClient");
 async function updateFullGraphViaAPI(tenantId, projectId, apiUrl, graphId, graphData) {
-  logger6.info(
+  logger5.info(
     {
       tenantId,
       projectId,
@@ -1248,7 +1090,7 @@ async function updateFullGraphViaAPI(tenantId, projectId, apiUrl, graphId, graph
         errorMessage = errorText;
       }
     }
-    logger6.error(
+    logger5.error(
       {
         status: response.status,
         error: errorMessage
@@ -1258,7 +1100,7 @@ async function updateFullGraphViaAPI(tenantId, projectId, apiUrl, graphId, graph
     throw new Error(errorMessage);
   }
   const result = await response.json();
-  logger6.info(
+  logger5.info(
     {
       graphId
     },
@@ -1268,7 +1110,7 @@ async function updateFullGraphViaAPI(tenantId, projectId, apiUrl, graphId, graph
 }
 
 // src/graph.ts
-var logger7 = agentsCore.getLogger("graph");
+var logger6 = agentsCore.getLogger("graph");
 function resolveGetter2(value) {
   if (typeof value === "function") {
     return value();
@@ -1323,7 +1165,7 @@ var AgentGraph = class {
     if (this.models) {
       this.propagateImmediateModelSettings();
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         tenantId: this.tenantId,
@@ -1356,9 +1198,6 @@ var AgentGraph = class {
             if ("setContext" in toolInstance && typeof toolInstance.setContext === "function") {
               toolInstance.setContext(tenantId, projectId);
             }
-            if ("baseURL" in toolInstance && !toolInstance.baseURL) {
-              toolInstance.baseURL = apiUrl;
-            }
           }
         }
       }
@@ -1366,7 +1205,7 @@ var AgentGraph = class {
     if (this.contextConfig?.setContext) {
       this.contextConfig.setContext(tenantId, projectId);
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         tenantId: this.tenantId,
@@ -1394,7 +1233,7 @@ var AgentGraph = class {
             let toolId;
             toolId = toolInstance.getId?.() || toolInstance.id;
             if ("selectedTools" in toolInstance && toolInstance.selectedTools !== void 0) {
-              logger7.info(
+              logger6.info(
                 { toolId, selectedTools: toolInstance.selectedTools },
                 "Selected tools"
               );
@@ -1450,103 +1289,6 @@ var AgentGraph = class {
         };
       }
     }
-    const toolsObject = {};
-    for (const agent2 of this.agents) {
-      if (!agent2.getTransfers) {
-        continue;
-      }
-      const internalAgent = agent2;
-      const agentTools = internalAgent.getTools();
-      for (const [toolName, toolInstance] of Object.entries(agentTools)) {
-        if (toolInstance && typeof toolInstance === "object") {
-          let actualTool;
-          let toolId;
-          if ("server" in toolInstance && "selectedTools" in toolInstance) {
-            const mcpConfig = toolInstance;
-            actualTool = mcpConfig.server;
-            toolId = actualTool.getId();
-          } else {
-            actualTool = toolInstance;
-            toolId = actualTool.getId?.() || actualTool.id || toolName;
-          }
-          if (!toolsObject[toolId]) {
-            let toolConfig;
-            if (actualTool.config?.serverUrl) {
-              toolConfig = {
-                type: "mcp",
-                mcp: {
-                  server: {
-                    url: actualTool.config.serverUrl
-                  }
-                }
-              };
-            } else if (actualTool.config?.type === "mcp") {
-              toolConfig = actualTool.config;
-            } else {
-              toolConfig = {
-                type: "function",
-                parameters: actualTool.parameters || {}
-              };
-            }
-            const toolData = {
-              id: toolId,
-              name: actualTool.config?.name || actualTool.name || toolName,
-              config: toolConfig,
-              status: actualTool.getStatus?.() || actualTool.status || "unknown"
-            };
-            if (actualTool.config?.imageUrl) {
-              toolData.imageUrl = actualTool.config.imageUrl;
-            }
-            if (actualTool.config?.headers) {
-              toolData.headers = actualTool.config.headers;
-            }
-            if (actualTool.capabilities) {
-              toolData.capabilities = actualTool.capabilities;
-            }
-            if (actualTool.lastHealthCheck) {
-              toolData.lastHealthCheck = actualTool.lastHealthCheck;
-            }
-            if (actualTool.availableTools) {
-              toolData.availableTools = actualTool.availableTools;
-            }
-            if (actualTool.lastError) {
-              toolData.lastError = actualTool.lastError;
-            }
-            if (actualTool.lastToolsSync) {
-              toolData.lastToolsSync = actualTool.lastToolsSync;
-            }
-            if (actualTool.getCredentialReferenceId?.()) {
-              toolData.credentialReferenceId = actualTool.getCredentialReferenceId();
-            }
-            toolsObject[toolId] = toolData;
-          }
-        }
-      }
-    }
-    for (const agent2 of this.agents) {
-      if (!this.isInternalAgent(agent2)) {
-        continue;
-      }
-      const internalAgent = agent2;
-      const agentDataComponents = internalAgent.getDataComponents();
-      if (agentDataComponents) {
-        for (const dataComponent2 of agentDataComponents) {
-          dataComponent2.id || dataComponent2.name.toLowerCase().replace(/\s+/g, "-");
-        }
-      }
-    }
-    for (const agent2 of this.agents) {
-      if (!this.isInternalAgent(agent2)) {
-        continue;
-      }
-      const internalAgent = agent2;
-      const agentArtifactComponents = internalAgent.getArtifactComponents();
-      if (agentArtifactComponents) {
-        for (const artifactComponent2 of agentArtifactComponents) {
-          artifactComponent2.id || artifactComponent2.name.toLowerCase().replace(/\s+/g, "-");
-        }
-      }
-    }
     return {
       id: this.graphId,
       name: this.graphName,
@@ -1565,7 +1307,7 @@ var AgentGraph = class {
    * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
    */
   async initializeAllTools() {
-    logger7.info({ graphId: this.graphId }, "Initializing all tools in graph");
+    logger6.info({ graphId: this.graphId }, "Initializing all tools in graph");
     const toolInitPromises = [];
     for (const agent2 of this.agents) {
       if (!agent2.getTools) {
@@ -1589,7 +1331,7 @@ var AgentGraph = class {
                       await toolInstance.init();
                     }
                   }
-                  logger7.debug(
+                  logger6.debug(
                     {
                       agentId: agent2.getId(),
                       toolName,
@@ -1599,7 +1341,7 @@ var AgentGraph = class {
                     "Tool initialized successfully"
                   );
                 } catch (error) {
-                  logger7.error(
+                  logger6.error(
                     {
                       agentId: agent2.getId(),
                       toolName,
@@ -1616,7 +1358,7 @@ var AgentGraph = class {
       }
     }
     await Promise.all(toolInitPromises);
-    logger7.info(
+    logger6.info(
       { graphId: this.graphId, toolCount: toolInitPromises.length },
       "All tools initialized successfully"
     );
@@ -1626,10 +1368,10 @@ var AgentGraph = class {
    */
   async init() {
     if (this.initialized) {
-      logger7.info({ graphId: this.graphId }, "Graph already initialized");
+      logger6.info({ graphId: this.graphId }, "Graph already initialized");
       return;
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         agentCount: this.agents.length
@@ -1640,7 +1382,7 @@ var AgentGraph = class {
       await this.initializeAllTools();
       await this.applyModelInheritance();
       const graphDefinition = await this.toFullGraphDefinition();
-      logger7.info(
+      logger6.info(
         {
           graphId: this.graphId,
           mode: "api-client",
@@ -1655,7 +1397,7 @@ var AgentGraph = class {
         this.graphId,
         graphDefinition
       );
-      logger7.info(
+      logger6.info(
         {
           graphId: this.graphId,
           agentCount: Object.keys(createdGraph.agents || {}).length
@@ -1664,7 +1406,7 @@ var AgentGraph = class {
       );
       this.initialized = true;
     } catch (error) {
-      logger7.error(
+      logger6.error(
         {
           graphId: this.graphId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -1680,10 +1422,10 @@ var AgentGraph = class {
    */
   async initLegacy() {
     if (this.initialized) {
-      logger7.info({ graphId: this.graphId }, "Graph already initialized");
+      logger6.info({ graphId: this.graphId }, "Graph already initialized");
       return;
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         agentCount: this.agents.length
@@ -1693,7 +1435,7 @@ var AgentGraph = class {
     try {
       if (this.contextConfig) {
         await this.contextConfig.init();
-        logger7.info(
+        logger6.info(
           {
             graphId: this.graphId,
             contextConfigId: this.contextConfig.getId()
@@ -1705,7 +1447,7 @@ var AgentGraph = class {
         try {
           agent2.config.graphId = this.graphId;
           await agent2.init();
-          logger7.debug(
+          logger6.debug(
             {
               agentId: agent2.getId(),
               graphId: this.graphId
@@ -1713,7 +1455,7 @@ var AgentGraph = class {
             "Agent initialized in graph"
           );
         } catch (error) {
-          logger7.error(
+          logger6.error(
             {
               agentId: agent2.getId(),
               graphId: this.graphId,
@@ -1730,7 +1472,7 @@ var AgentGraph = class {
       await this.createAgentRelations();
       await this.saveRelations();
       this.initialized = true;
-      logger7.info(
+      logger6.info(
         {
           graphId: this.graphId,
           agentCount: this.agents.length
@@ -1738,7 +1480,7 @@ var AgentGraph = class {
         "Agent graph initialized successfully"
       );
     } catch (error) {
-      logger7.error(
+      logger6.error(
         {
           graphId: this.graphId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -1756,7 +1498,7 @@ var AgentGraph = class {
     if (!this.defaultAgent) {
       throw new Error("No default agent configured for this graph");
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         defaultAgent: this.defaultAgent.getName(),
@@ -1775,7 +1517,7 @@ var AgentGraph = class {
     if (!this.defaultAgent) {
       throw new Error("No default agent configured for this graph");
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         defaultAgent: this.defaultAgent.getName(),
@@ -1814,7 +1556,7 @@ var AgentGraph = class {
         `Agent '${agentId}' is an external agent and cannot be run directly. External agents are only accessible via delegation.`
       );
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         agentId,
@@ -1849,7 +1591,7 @@ var AgentGraph = class {
     if (this.models && this.isInternalAgent(agent2)) {
       this.propagateModelSettingsToAgent(agent2);
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         agentId: agent2.getId(),
@@ -1866,7 +1608,7 @@ var AgentGraph = class {
     if (agentToRemove) {
       this.agentMap.delete(agentToRemove.getId());
       this.agents = this.agents.filter((agent2) => agent2.getId() !== agentToRemove.getId());
-      logger7.info(
+      logger6.info(
         {
           graphId: this.graphId,
           agentId: agentToRemove.getId()
@@ -1895,7 +1637,7 @@ var AgentGraph = class {
   setDefaultAgent(agent2) {
     this.defaultAgent = agent2;
     this.addAgent(agent2);
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         defaultAgent: agent2.getId()
@@ -2037,7 +1779,7 @@ var AgentGraph = class {
       });
       return project2?.models;
     } catch (error) {
-      logger7.warn(
+      logger6.warn(
         {
           tenantId: this.tenantId,
           projectId: this.projectId,
@@ -2058,7 +1800,7 @@ var AgentGraph = class {
       });
       return project2?.stopWhen;
     } catch (error) {
-      logger7.warn(
+      logger6.warn(
         {
           tenantId: this.tenantId,
           projectId: this.projectId,
@@ -2122,7 +1864,7 @@ var AgentGraph = class {
         }
       }
     }
-    logger7.debug(
+    logger6.debug(
       {
         graphId: this.graphId,
         graphStopWhen: this.stopWhen,
@@ -2172,7 +1914,7 @@ var AgentGraph = class {
   async executeWithBackend(input, options) {
     const normalizedMessages = this.normalizeMessages(input);
     const url = `${this.baseURL}/tenants/${this.tenantId}/graphs/${this.graphId}/v1/chat/completions`;
-    logger7.info({ url }, "Executing with backend");
+    logger6.info({ url }, "Executing with backend");
     const requestBody = {
       model: "gpt-4o-mini",
       messages: normalizedMessages.map((msg) => ({
@@ -2256,7 +1998,7 @@ var AgentGraph = class {
           }
         });
         if (getResponse.ok) {
-          logger7.info({ graphId: this.graphId }, "Graph already exists in backend");
+          logger6.info({ graphId: this.graphId }, "Graph already exists in backend");
           return;
         }
         if (getResponse.status !== 404) {
@@ -2267,7 +2009,7 @@ var AgentGraph = class {
           throw error;
         }
       }
-      logger7.info({ graphId: this.graphId }, "Creating graph in backend");
+      logger6.info({ graphId: this.graphId }, "Creating graph in backend");
       const createUrl = `${this.baseURL}/tenants/${this.tenantId}/agent-graphs`;
       const createResponse = await fetch(createUrl, {
         method: "POST",
@@ -2287,7 +2029,7 @@ var AgentGraph = class {
       }
       const createData = await createResponse.json();
       this.graphId = createData.data.id;
-      logger7.info({ graph: createData.data }, "Graph created in backend");
+      logger6.info({ graph: createData.data }, "Graph created in backend");
     } catch (error) {
       throw new Error(
         `Failed to save graph to database: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -2312,7 +2054,7 @@ var AgentGraph = class {
         if (!updateResponse.ok) {
           throw new Error(`HTTP ${updateResponse.status}: ${updateResponse.statusText}`);
         }
-        logger7.debug(
+        logger6.debug(
           {
             graphId: this.graphId,
             defaultAgent: this.defaultAgent.getName()
@@ -2320,7 +2062,7 @@ var AgentGraph = class {
           "Graph relationships configured"
         );
       } catch (error) {
-        logger7.error(
+        logger6.error(
           {
             graphId: this.graphId,
             error: error instanceof Error ? error.message : "Unknown error"
@@ -2343,7 +2085,7 @@ var AgentGraph = class {
         }
         const delegates = agent2.getDelegates();
         for (const delegate of delegates) {
-          if (delegate instanceof ExternalAgent) {
+          if (delegate.type === "external") {
             allRelationPromises.push(this.createExternalAgentRelation(agent2, delegate, "delegate"));
           } else {
             allRelationPromises.push(
@@ -2361,7 +2103,7 @@ var AgentGraph = class {
         successCount++;
       } else {
         errors.push(result.reason);
-        logger7.error(
+        logger6.error(
           {
             error: result.reason instanceof Error ? result.reason.message : "Unknown error",
             graphId: this.graphId
@@ -2370,7 +2112,7 @@ var AgentGraph = class {
         );
       }
     }
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         totalRelations: allRelationPromises.length,
@@ -2385,25 +2127,22 @@ var AgentGraph = class {
   }
   async createInternalAgentRelation(sourceAgent, targetAgent, relationType) {
     try {
-      const response = await fetch(
-        `${this.baseURL}/tenants/${this.tenantId}/agent-relations`,
-        {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            graphId: this.graphId,
-            sourceAgentId: sourceAgent.getId(),
-            targetAgentId: targetAgent.getId(),
-            relationType
-          })
-        }
-      );
+      const response = await fetch(`${this.baseURL}/tenants/${this.tenantId}/agent-relations`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          graphId: this.graphId,
+          sourceAgentId: sourceAgent.getId(),
+          targetAgentId: targetAgent.getId(),
+          relationType
+        })
+      });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
         if (response.status === 422 && errorText.includes("already exists")) {
-          logger7.info(
+          logger6.info(
             {
               sourceAgentId: sourceAgent.getId(),
               targetAgentId: targetAgent.getId(),
@@ -2416,7 +2155,7 @@ var AgentGraph = class {
         }
         throw new Error(`Failed to create agent relation: ${response.status} - ${errorText}`);
       }
-      logger7.info(
+      logger6.info(
         {
           sourceAgentId: sourceAgent.getId(),
           targetAgentId: targetAgent.getId(),
@@ -2426,7 +2165,7 @@ var AgentGraph = class {
         `${relationType} relation created successfully`
       );
     } catch (error) {
-      logger7.error(
+      logger6.error(
         {
           sourceAgentId: sourceAgent.getId(),
           targetAgentId: targetAgent.getId(),
@@ -2441,25 +2180,22 @@ var AgentGraph = class {
   }
   async createExternalAgentRelation(sourceAgent, externalAgent2, relationType) {
     try {
-      const response = await fetch(
-        `${this.baseURL}/tenants/${this.tenantId}/agent-relations`,
-        {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            graphId: this.graphId,
-            sourceAgentId: sourceAgent.getId(),
-            externalAgentId: externalAgent2.getId(),
-            relationType
-          })
-        }
-      );
+      const response = await fetch(`${this.baseURL}/tenants/${this.tenantId}/agent-relations`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          graphId: this.graphId,
+          sourceAgentId: sourceAgent.getId(),
+          externalAgentId: externalAgent2.getId(),
+          relationType
+        })
+      });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
         if (response.status === 422 && errorText.includes("already exists")) {
-          logger7.info(
+          logger6.info(
             {
               sourceAgentId: sourceAgent.getId(),
               externalAgentId: externalAgent2.getId(),
@@ -2474,7 +2210,7 @@ var AgentGraph = class {
           `Failed to create external agent relation: ${response.status} - ${errorText}`
         );
       }
-      logger7.info(
+      logger6.info(
         {
           sourceAgentId: sourceAgent.getId(),
           externalAgentId: externalAgent2.getId(),
@@ -2484,7 +2220,7 @@ var AgentGraph = class {
         `${relationType} relation created successfully`
       );
     } catch (error) {
-      logger7.error(
+      logger6.error(
         {
           sourceAgentId: sourceAgent.getId(),
           externalAgentId: externalAgent2.getId(),
@@ -2502,7 +2238,7 @@ var AgentGraph = class {
    */
   async createExternalAgents() {
     const externalAgents2 = this.agents.filter((agent2) => this.isExternalAgent(agent2));
-    logger7.info(
+    logger6.info(
       {
         graphId: this.graphId,
         externalAgentCount: externalAgents2.length
@@ -2512,7 +2248,7 @@ var AgentGraph = class {
     const initPromises = externalAgents2.map(async (externalAgent2) => {
       try {
         await externalAgent2.init();
-        logger7.debug(
+        logger6.debug(
           {
             externalAgentId: externalAgent2.getId(),
             graphId: this.graphId
@@ -2520,7 +2256,7 @@ var AgentGraph = class {
           "External agent created in database"
         );
       } catch (error) {
-        logger7.error(
+        logger6.error(
           {
             externalAgentId: externalAgent2.getId(),
             graphId: this.graphId,
@@ -2533,7 +2269,7 @@ var AgentGraph = class {
     });
     try {
       await Promise.all(initPromises);
-      logger7.info(
+      logger6.info(
         {
           graphId: this.graphId,
           externalAgentCount: externalAgents2.length
@@ -2541,7 +2277,7 @@ var AgentGraph = class {
         "All external agents created successfully"
       );
     } catch (error) {
-      logger7.error(
+      logger6.error(
         {
           graphId: this.graphId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -2552,9 +2288,9 @@ var AgentGraph = class {
     }
   }
 };
-var logger8 = agentsCore.getLogger("projectFullClient");
+var logger7 = agentsCore.getLogger("projectFullClient");
 async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
-  logger8.info(
+  logger7.info(
     {
       tenantId,
       projectId: projectData.id,
@@ -2573,7 +2309,7 @@ async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
       body: JSON.stringify(projectData)
     });
   } catch (fetchError) {
-    logger8.error({
+    logger7.error({
       error: fetchError instanceof Error ? fetchError.message : "Unknown fetch error",
       url,
       tenantId,
@@ -2594,7 +2330,7 @@ async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
         errorMessage = errorText;
       }
     }
-    logger8.error(
+    logger7.error(
       {
         status: response.status,
         error: errorMessage
@@ -2604,7 +2340,7 @@ async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
     throw new Error(errorMessage);
   }
   const result = await response.json();
-  logger8.info(
+  logger7.info(
     {
       projectId: projectData.id
     },
@@ -2613,7 +2349,7 @@ async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
   return result.data;
 }
 async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData) {
-  logger8.info(
+  logger7.info(
     {
       tenantId,
       projectId,
@@ -2632,7 +2368,7 @@ async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData)
       body: JSON.stringify(projectData)
     });
   } catch (fetchError) {
-    logger8.error({
+    logger7.error({
       error: fetchError instanceof Error ? fetchError.message : "Unknown fetch error",
       url,
       tenantId,
@@ -2653,7 +2389,7 @@ async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData)
         errorMessage = errorText;
       }
     }
-    logger8.error(
+    logger7.error(
       {
         status: response.status,
         error: errorMessage
@@ -2663,7 +2399,7 @@ async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData)
     throw new Error(errorMessage);
   }
   const result = await response.json();
-  logger8.info(
+  logger7.info(
     {
       projectId
     },
@@ -2672,7 +2408,7 @@ async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData)
   return result.data;
 }
 async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
-  logger8.info(
+  logger7.info(
     {
       tenantId,
       projectId,
@@ -2689,7 +2425,7 @@ async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
   });
   if (!response.ok) {
     if (response.status === 404) {
-      logger8.info(
+      logger7.info(
         {
           projectId
         },
@@ -2709,7 +2445,7 @@ async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
         errorMessage = errorText;
       }
     }
-    logger8.error(
+    logger7.error(
       {
         status: response.status,
         error: errorMessage
@@ -2719,7 +2455,7 @@ async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
     throw new Error(errorMessage);
   }
   const result = await response.json();
-  logger8.info(
+  logger7.info(
     {
       projectId
     },
@@ -2728,7 +2464,7 @@ async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
   return result.data;
 }
 async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
-  logger8.info(
+  logger7.info(
     {
       tenantId,
       projectId,
@@ -2756,7 +2492,7 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
         errorMessage = errorText;
       }
     }
-    logger8.error(
+    logger7.error(
       {
         status: response.status,
         error: errorMessage
@@ -2765,7 +2501,7 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
     );
     throw new Error(errorMessage);
   }
-  logger8.info(
+  logger7.info(
     {
       projectId
     },
@@ -2774,7 +2510,7 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
 }
 
 // src/project.ts
-var logger9 = agentsCore.getLogger("project");
+var logger8 = agentsCore.getLogger("project");
 var Project = class {
   constructor(config) {
     __publicField(this, "__type", "project");
@@ -2803,7 +2539,7 @@ var Project = class {
         graph.setConfig(this.tenantId, this.projectId, this.baseURL);
       }
     }
-    logger9.info(
+    logger8.info(
       {
         projectId: this.projectId,
         tenantId: this.tenantId,
@@ -2828,7 +2564,7 @@ var Project = class {
     for (const graph of this.graphs) {
       graph.setConfig(tenantId, this.projectId, apiUrl);
     }
-    logger9.info(
+    logger8.info(
       {
         projectId: this.projectId,
         tenantId: this.tenantId,
@@ -2844,7 +2580,7 @@ var Project = class {
    */
   setCredentials(credentials) {
     this.credentialReferences = Object.values(credentials);
-    logger9.info(
+    logger8.info(
       {
         projectId: this.projectId,
         credentialCount: this.credentialReferences?.length || 0
@@ -2857,10 +2593,10 @@ var Project = class {
    */
   async init() {
     if (this.initialized) {
-      logger9.info({ projectId: this.projectId }, "Project already initialized");
+      logger8.info({ projectId: this.projectId }, "Project already initialized");
       return;
     }
-    logger9.info(
+    logger8.info(
       {
         projectId: this.projectId,
         tenantId: this.tenantId,
@@ -2883,7 +2619,7 @@ var Project = class {
         createdAt: (/* @__PURE__ */ new Date()).toISOString(),
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       };
-      logger9.info(
+      logger8.info(
         {
           projectId: this.projectId,
           mode: "api-client",
@@ -2892,7 +2628,7 @@ var Project = class {
         "Creating project metadata first"
       );
       await updateFullProjectViaAPI(this.tenantId, this.baseURL, this.projectId, projectMetadata);
-      logger9.info(
+      logger8.info(
         {
           projectId: this.projectId
         },
@@ -2901,7 +2637,7 @@ var Project = class {
       const initPromises = this.graphs.map(async (graph) => {
         try {
           await graph.init();
-          logger9.debug(
+          logger8.debug(
             {
               projectId: this.projectId,
               graphId: graph.getId()
@@ -2909,7 +2645,7 @@ var Project = class {
             "Graph initialized in project"
           );
         } catch (error) {
-          logger9.error(
+          logger8.error(
             {
               projectId: this.projectId,
               graphId: graph.getId(),
@@ -2922,7 +2658,7 @@ var Project = class {
       });
       await Promise.all(initPromises);
       const projectDefinition = await this.toFullProjectDefinition();
-      logger9.info(
+      logger8.info(
         {
           projectId: this.projectId,
           mode: "api-client",
@@ -2937,7 +2673,7 @@ var Project = class {
         projectDefinition
       );
       this.initialized = true;
-      logger9.info(
+      logger8.info(
         {
           projectId: this.projectId,
           tenantId: this.tenantId,
@@ -2946,7 +2682,7 @@ var Project = class {
         "Project initialized successfully using full project endpoint"
       );
     } catch (error) {
-      logger9.error(
+      logger8.error(
         {
           projectId: this.projectId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -3037,7 +2773,7 @@ var Project = class {
     this.graphs.push(graph);
     this.graphMap.set(graph.getId(), graph);
     graph.setConfig(this.tenantId, this.projectId, this.baseURL);
-    logger9.info(
+    logger8.info(
       {
         projectId: this.projectId,
         graphId: graph.getId()
@@ -3053,7 +2789,7 @@ var Project = class {
     if (graphToRemove) {
       this.graphMap.delete(id);
       this.graphs = this.graphs.filter((graph) => graph.getId() !== id);
-      logger9.info(
+      logger8.info(
         {
           projectId: this.projectId,
           graphId: id
@@ -3189,94 +2925,41 @@ var Project = class {
           }
         }
       }
-      for (const agent2 of graph.agents) {
-        if (!agent2.getTools) {
+      for (const agent2 of graph.getAgents()) {
+        if (agent2.type === "external") {
           continue;
         }
         const agentTools = agent2.getTools();
-        for (const [toolName, toolInstance] of Object.entries(agentTools)) {
-          if (toolInstance && typeof toolInstance === "object") {
-            let actualTool;
-            let toolId;
-            if ("server" in toolInstance && "selectedTools" in toolInstance) {
-              const mcpConfig = toolInstance;
-              actualTool = mcpConfig.server;
-              toolId = actualTool.getId();
-            } else {
-              actualTool = toolInstance;
-              toolId = actualTool.getId?.() || actualTool.id || toolName;
-            }
-            if (!toolsObject[toolId]) {
-              let toolConfig;
-              if (actualTool.config?.serverUrl) {
-                toolConfig = {
-                  type: "mcp",
-                  mcp: {
-                    server: {
-                      url: actualTool.config.serverUrl
-                    }
-                  }
-                };
-              } else if (actualTool.config?.type === "mcp") {
-                toolConfig = actualTool.config;
-              } else {
-                toolConfig = {
-                  type: "function",
-                  parameters: actualTool.parameters || {}
-                };
-              }
-              const toolData = {
-                id: toolId,
-                name: actualTool.config?.name || actualTool.name || toolName,
-                config: toolConfig,
-                status: actualTool.getStatus?.() || actualTool.status || "unknown"
-              };
-              if (actualTool.config?.imageUrl) {
-                toolData.imageUrl = actualTool.config.imageUrl;
-              }
-              if (actualTool.config?.headers) {
-                toolData.headers = actualTool.config.headers;
-              }
-              if (actualTool.capabilities) {
-                toolData.capabilities = actualTool.capabilities;
-              }
-              if (actualTool.lastHealthCheck) {
-                toolData.lastHealthCheck = actualTool.lastHealthCheck;
-              }
-              if (actualTool.availableTools) {
-                toolData.availableTools = actualTool.availableTools;
-              }
-              if (actualTool.lastError) {
-                toolData.lastError = actualTool.lastError;
-              }
-              if (actualTool.lastToolsSync) {
-                toolData.lastToolsSync = actualTool.lastToolsSync;
-              }
-              if (actualTool.getCredentialReferenceId?.()) {
-                const credId = actualTool.getCredentialReferenceId();
-                toolData.credentialReferenceId = credId;
-                if (!credentialUsageMap[credId]) {
-                  credentialUsageMap[credId] = [];
-                }
-                credentialUsageMap[credId].push({
-                  type: "tool",
-                  id: toolId,
-                  graphId: graph.getId()
-                });
-              } else if (actualTool.config?.credential?.id) {
-                const credId = actualTool.config.credential.id;
-                toolData.credentialReferenceId = credId;
-                if (!credentialUsageMap[credId]) {
-                  credentialUsageMap[credId] = [];
-                }
-                credentialUsageMap[credId].push({
-                  type: "tool",
-                  id: toolId,
-                  graphId: graph.getId()
-                });
+        for (const [, toolInstance] of Object.entries(agentTools)) {
+          const actualTool = toolInstance;
+          const toolId = actualTool.getId();
+          if (!toolsObject[toolId]) {
+            const toolConfig = {
+              type: "mcp",
+              mcp: {
+                server: {
+                  url: actualTool.config.serverUrl
+                },
+                transport: actualTool.config.transport,
+                activeTools: actualTool.config.activeTools
               }
-              toolsObject[toolId] = toolData;
+            };
+            const toolData = {
+              id: toolId,
+              name: actualTool.getName(),
+              config: toolConfig
+            };
+            if (actualTool.config?.imageUrl) {
+              toolData.imageUrl = actualTool.config.imageUrl;
+            }
+            if (actualTool.config?.headers) {
+              toolData.headers = actualTool.config.headers;
             }
+            const credentialId = actualTool.getCredentialReferenceId();
+            if (credentialId) {
+              toolData.credentialReferenceId = credentialId;
+            }
+            toolsObject[toolId] = toolData;
           }
         }
         const agentDataComponents = agent2.getDataComponents?.();
@@ -3498,6 +3181,168 @@ function createEnvironmentSettings(environments) {
 function registerEnvironmentSettings(config) {
   return config;
 }
+var logger9 = agentsCore.getLogger("external-agent-builder");
+var ExternalAgent = class {
+  constructor(config) {
+    __publicField(this, "config");
+    __publicField(this, "type", "external");
+    __publicField(this, "initialized", false);
+    __publicField(this, "tenantId");
+    __publicField(this, "baseURL");
+    this.config = { ...config, type: "external" };
+    this.tenantId = "default";
+    this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
+    logger9.debug(
+      {
+        externalAgentName: this.config.name,
+        baseUrl: this.config.baseUrl,
+        tenantId: this.tenantId
+      },
+      "External Agent constructor initialized"
+    );
+  }
+  /**
+   * Initialize the external agent by upserting it in the database
+   */
+  async init() {
+    if (this.initialized) return;
+    try {
+      await this.upsertExternalAgent();
+      logger9.info(
+        {
+          externalAgentId: this.getId()
+        },
+        "External agent initialized successfully"
+      );
+      this.initialized = true;
+    } catch (error) {
+      logger9.error(
+        {
+          externalAgentId: this.getId(),
+          error: error instanceof Error ? error.message : "Unknown error"
+        },
+        "Failed to initialize external agent"
+      );
+      throw error;
+    }
+  }
+  // Set context (tenantId) from external source (graph, CLI, etc)
+  setContext(tenantId) {
+    this.tenantId = tenantId;
+  }
+  // Compute ID from name using a simple slug transformation
+  getId() {
+    return this.config.id;
+  }
+  // Private method to upsert external agent (create or update)
+  async upsertExternalAgent() {
+    const externalAgentData = {
+      id: this.getId(),
+      name: this.config.name,
+      description: this.config.description,
+      baseUrl: this.config.baseUrl,
+      credentialReferenceId: this.config.credentialReference?.id || void 0,
+      headers: this.config.headers || void 0
+    };
+    const updateResponse = await fetch(
+      `${this.baseURL}/tenants/${this.tenantId}/external-agents/${this.getId()}`,
+      {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(externalAgentData)
+      }
+    );
+    if (updateResponse.ok) {
+      logger9.info(
+        {
+          externalAgentId: this.getId()
+        },
+        "External agent updated successfully"
+      );
+      return;
+    }
+    if (updateResponse.status === 404) {
+      logger9.info(
+        {
+          externalAgentId: this.getId()
+        },
+        "External agent not found, creating new external agent"
+      );
+      const createResponse = await fetch(
+        `${this.baseURL}/tenants/${this.tenantId}/external-agents`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(externalAgentData)
+        }
+      );
+      if (!createResponse.ok) {
+        const errorText2 = await createResponse.text().catch(() => "Unknown error");
+        throw new Error(
+          `Failed to create external agent: ${createResponse.status} ${createResponse.statusText} - ${errorText2}`
+        );
+      }
+      logger9.info(
+        {
+          externalAgentId: this.getId()
+        },
+        "External agent created successfully"
+      );
+      return;
+    }
+    const errorText = await updateResponse.text().catch(() => "Unknown error");
+    throw new Error(
+      `Failed to update external agent: ${updateResponse.status} ${updateResponse.statusText} - ${errorText}`
+    );
+  }
+  /**
+   * Get the external agent configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Get the external agent name
+   */
+  getName() {
+    return this.config.name;
+  }
+  /**
+   * Get the external agent base URL
+   */
+  getBaseUrl() {
+    return this.config.baseUrl;
+  }
+  /**
+   * Get the tenant ID
+   */
+  getTenantId() {
+    return this.tenantId;
+  }
+  getDescription() {
+    return this.config.description || "";
+  }
+  getCredentialReferenceId() {
+    return this.config.credentialReference?.id || void 0;
+  }
+  getHeaders() {
+    return this.config.headers;
+  }
+};
+function externalAgent(config) {
+  return new ExternalAgent(config);
+}
+function externalAgents(configs) {
+  const builders = {};
+  for (const [name, config] of Object.entries(configs)) {
+    builders[name] = externalAgent(config);
+  }
+  return builders;
+}
 zod.z.object({
   model: zod.z.string().optional(),
   providerOptions: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown())).optional()