@inkeep/agents-sdk 0.3.0 → 0.6.0

package/dist/index.cjs

@@ -6,6 +6,13 @@ var zod = require('zod');
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/utils/generateIdFromName.ts
+function generateIdFromName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+
+// src/artifact-component.ts
 var logger = agentsCore.getLogger("artifactComponent");
 var ArtifactComponent = class {
   constructor(config) {
@@ -15,16 +22,14 @@ var ArtifactComponent = class {
     __publicField(this, "projectId");
     __publicField(this, "initialized", false);
     __publicField(this, "id");
-    this.id = agentsCore.generateIdFromName(config.name);
+    this.id = config.id || generateIdFromName(config.name);
     this.config = {
       ...config,
-      id: this.id,
-      tenantId: config.tenantId || "default",
-      projectId: config.projectId || "default"
+      id: this.id
     };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    this.tenantId = this.config.tenantId;
-    this.projectId = this.config.projectId;
+    this.tenantId = "default";
+    this.projectId = "default";
     logger.info(
       {
         artifactComponentId: this.getId(),
@@ -33,6 +38,11 @@ var ArtifactComponent = class {
       "ArtifactComponent constructor initialized"
     );
   }
+  // Set context (tenantId and projectId) from external source (agent, graph, CLI, etc)
+  setContext(tenantId, projectId) {
+    this.tenantId = tenantId;
+    this.projectId = projectId;
+  }
   // Compute ID from name using same slug transformation as agents
   getId() {
     return this.id;
@@ -83,7 +93,7 @@ var ArtifactComponent = class {
     };
     logger.info({ artifactComponentData }, "artifactComponentData for create/update");
     const updateResponse = await fetch(
-      `${this.baseURL}/tenants/${this.tenantId}/artifact-components/${this.getId()}`,
+      `${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components/${this.getId()}`,
       {
         method: "PUT",
         headers: {
@@ -116,7 +126,7 @@ var ArtifactComponent = class {
         "ArtifactComponent not found, creating new artifact component"
       );
       const createResponse = await fetch(
-        `${this.baseURL}/tenants/${this.tenantId}/artifact-components`,
+        `${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/artifact-components`,
         {
           method: "POST",
           headers: {
@@ -154,16 +164,14 @@ var DataComponent = class {
     __publicField(this, "projectId");
     __publicField(this, "initialized", false);
     __publicField(this, "id");
-    this.id = agentsCore.generateIdFromName(config.name);
+    this.id = config.id || generateIdFromName(config.name);
     this.config = {
       ...config,
-      id: this.id,
-      tenantId: config.tenantId || "default",
-      projectId: config.projectId || "default"
+      id: this.id
     };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    this.tenantId = this.config.tenantId;
-    this.projectId = this.config.projectId;
+    this.tenantId = "default";
+    this.projectId = "default";
     logger2.info(
       {
         dataComponentId: this.getId(),
@@ -172,6 +180,11 @@ var DataComponent = class {
       "DataComponent constructor initialized"
     );
   }
+  // Set context (tenantId and projectId) from external source (agent, graph, CLI, etc)
+  setContext(tenantId, projectId) {
+    this.tenantId = tenantId;
+    this.projectId = projectId;
+  }
   // Compute ID from name using same slug transformation as agents
   getId() {
     return this.id;
@@ -218,7 +231,7 @@ var DataComponent = class {
     };
     logger2.info({ dataComponentData }, "dataComponentData for create/update");
     const updateResponse = await fetch(
-      `${this.baseURL}/tenants/${this.tenantId}/data-components/${this.getId()}`,
+      `${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/data-components/${this.getId()}`,
       {
         method: "PUT",
         headers: {
@@ -251,7 +264,7 @@ var DataComponent = class {
         "DataComponent not found, creating new data component"
       );
       const createResponse = await fetch(
-        `${this.baseURL}/tenants/${this.tenantId}/data-components`,
+        `${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/data-components`,
         {
           method: "POST",
           headers: {
@@ -290,8 +303,8 @@ var Tool = class {
     __publicField(this, "projectId");
     this.config = config;
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    this.tenantId = config.tenantId || "default";
-    this.projectId = config.projectId || "default";
+    this.tenantId = "default";
+    this.projectId = "default";
     logger3.info(
       {
         Id: this.getId(),
@@ -300,6 +313,11 @@ var Tool = class {
       "Tool constructor initialized"
     );
   }
+  // Set context (tenantId and projectId) from external source (agent, graph, CLI, etc)
+  setContext(tenantId, projectId) {
+    this.tenantId = tenantId;
+    this.projectId = projectId;
+  }
   // Compute ID from name using same slug transformation as agents
   getId() {
     return this.config.id;
@@ -437,8 +455,8 @@ var Agent = class {
     __publicField(this, "initialized", false);
     this.config = { ...config, type: "internal" };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
-    this.tenantId = config.tenantId || "default";
-    this.projectId = config.projectId || "default";
+    this.tenantId = "default";
+    this.projectId = "default";
     logger4.info(
       {
         tenantId: this.tenantId,
@@ -448,6 +466,11 @@ var Agent = class {
       "Agent constructor initialized"
     );
   }
+  // Set context (tenantId and projectId) from external source (graph, CLI, etc)
+  setContext(tenantId, projectId) {
+    this.tenantId = tenantId;
+    this.projectId = projectId;
+  }
   // Return the configured ID
   getId() {
     return this.config.id;
@@ -507,10 +530,33 @@ var Agent = class {
     return typeof this.config.canDelegateTo === "function" ? this.config.canDelegateTo() : [];
   }
   getDataComponents() {
-    return resolveGetter(this.config.dataComponents) || [];
+    const components = resolveGetter(this.config.dataComponents) || [];
+    return components.map((comp) => {
+      if (comp && typeof comp.getId === "function") {
+        return {
+          id: comp.getId(),
+          name: comp.getName(),
+          description: comp.getDescription(),
+          props: comp.getProps()
+        };
+      }
+      return comp;
+    });
   }
   getArtifactComponents() {
-    return resolveGetter(this.config.artifactComponents) || [];
+    const components = resolveGetter(this.config.artifactComponents) || [];
+    return components.map((comp) => {
+      if (comp && typeof comp.getId === "function") {
+        return {
+          id: comp.getId(),
+          name: comp.getName(),
+          description: comp.getDescription(),
+          summaryProps: comp.getSummaryProps?.() || comp.summaryProps,
+          fullProps: comp.getFullProps?.() || comp.fullProps
+        };
+      }
+      return comp;
+    });
   }
   // adjust
   addTool(_name, tool) {
@@ -659,7 +705,13 @@ var Agent = class {
     const components = resolveGetter(this.config.dataComponents);
     if (components) {
       for (const dataComponent2 of components) {
-        await this.createDataComponent(dataComponent2);
+        const plainComponent = dataComponent2 && typeof dataComponent2.getId === "function" ? {
+          id: dataComponent2.getId(),
+          name: dataComponent2.getName(),
+          description: dataComponent2.getDescription(),
+          props: dataComponent2.getProps()
+        } : dataComponent2;
+        await this.createDataComponent(plainComponent);
       }
     }
   }
@@ -671,7 +723,14 @@ var Agent = class {
     const components = resolveGetter(this.config.artifactComponents);
     if (components) {
       for (const artifactComponent2 of components) {
-        await this.createArtifactComponent(artifactComponent2);
+        const plainComponent = artifactComponent2 && typeof artifactComponent2.getId === "function" ? {
+          id: artifactComponent2.getId(),
+          name: artifactComponent2.getName(),
+          description: artifactComponent2.getDescription(),
+          summaryProps: artifactComponent2.getSummaryProps?.() || artifactComponent2.summaryProps,
+          fullProps: artifactComponent2.getFullProps?.() || artifactComponent2.fullProps
+        } : artifactComponent2;
+        await this.createArtifactComponent(plainComponent);
       }
     }
   }
@@ -680,8 +739,6 @@ var Agent = class {
       const existingComponents = [];
       const dbDataComponents = existingComponents.map((component) => ({
         id: component.id,
-        tenantId: component.tenantId || this.tenantId,
-        projectId: component.projectId || this.projectId,
         name: component.name,
         description: component.description,
         props: component.props,
@@ -689,9 +746,24 @@ var Agent = class {
         updatedAt: component.updatedAt
       }));
       const configComponents = resolveGetter(this.config.dataComponents) || [];
-      const allComponents = [...dbDataComponents, ...configComponents];
+      const normalizedConfigComponents = configComponents.map((comp) => {
+        if (comp && typeof comp.getId === "function") {
+          return {
+            id: comp.getId(),
+            name: comp.getName(),
+            description: comp.getDescription(),
+            props: comp.getProps()
+          };
+        }
+        return comp;
+      });
+      const allComponents = [...dbDataComponents, ...normalizedConfigComponents];
       const uniqueComponents = allComponents.reduce((acc, component) => {
-        const existingIndex = acc.findIndex((c) => c.id === component.id);
+        const componentId = typeof component.getId === "function" ? component.getId() : component.id;
+        const existingIndex = acc.findIndex((c) => {
+          const cId = typeof c.getId === "function" ? c.getId() : c.id;
+          return cId === componentId;
+        });
         if (existingIndex >= 0) {
           acc[existingIndex] = component;
         } else {
@@ -699,7 +771,7 @@ var Agent = class {
         }
         return acc;
       }, []);
-      this.config.dataComponents = uniqueComponents;
+      this.config.dataComponents = () => uniqueComponents;
       logger4.info(
         {
           agentId: this.getId(),
@@ -724,8 +796,6 @@ var Agent = class {
       const existingComponents = [];
       const dbArtifactComponents = existingComponents.map((component) => ({
         id: component.id,
-        tenantId: component.tenantId || this.tenantId,
-        projectId: component.projectId || this.projectId,
         name: component.name,
         description: component.description,
         summaryProps: component.summaryProps,
@@ -734,9 +804,25 @@ var Agent = class {
         updatedAt: component.updatedAt
       }));
       const configComponents = resolveGetter(this.config.artifactComponents) || [];
-      const allComponents = [...dbArtifactComponents, ...configComponents];
+      const normalizedConfigComponents = configComponents.map((comp) => {
+        if (comp && typeof comp.getId === "function") {
+          return {
+            id: comp.getId(),
+            name: comp.getName(),
+            description: comp.getDescription(),
+            summaryProps: comp.getSummaryProps?.() || comp.summaryProps,
+            fullProps: comp.getFullProps?.() || comp.fullProps
+          };
+        }
+        return comp;
+      });
+      const allComponents = [...dbArtifactComponents, ...normalizedConfigComponents];
       const uniqueComponents = allComponents.reduce((acc, component) => {
-        const existingIndex = acc.findIndex((c) => c.id === component.id);
+        const componentId = typeof component.getId === "function" ? component.getId() : component.id;
+        const existingIndex = acc.findIndex((c) => {
+          const cId = typeof c.getId === "function" ? c.getId() : c.id;
+          return cId === componentId;
+        });
         if (existingIndex >= 0) {
           acc[existingIndex] = component;
         } else {
@@ -744,7 +830,7 @@ var Agent = class {
         }
         return acc;
       }, []);
-      this.config.artifactComponents = uniqueComponents;
+      this.config.artifactComponents = () => uniqueComponents;
       logger4.info(
         {
           agentId: this.getId(),
@@ -782,20 +868,22 @@ var Agent = class {
         const mcpConfig = toolConfig;
         tool = mcpConfig.server;
         selectedTools = mcpConfig.selectedTools;
+        tool.setContext(this.tenantId, this.projectId);
         await tool.init();
       } else if (toolConfig instanceof Tool) {
         tool = toolConfig;
+        tool.setContext(this.tenantId, this.projectId);
         await tool.init();
       } else {
         tool = new Tool({
           id: toolId,
-          tenantId: this.tenantId,
           name: toolConfig.name || toolId,
           description: toolConfig.description || `MCP tool: ${toolId}`,
           serverUrl: toolConfig.config?.serverUrl || toolConfig.serverUrl || "http://localhost:3000",
           activeTools: toolConfig.config?.mcp?.activeTools,
           credential: toolConfig.credential
         });
+        tool.setContext(this.tenantId, this.projectId);
         await tool.init();
       }
       await this.createAgentToolRelation(tool.getId(), selectedTools);
@@ -821,12 +909,12 @@ var Agent = class {
   async createDataComponent(dataComponent2) {
     try {
       const dc = new DataComponent({
-        tenantId: this.tenantId,
-        projectId: this.projectId,
+        id: dataComponent2.id,
         name: dataComponent2.name,
         description: dataComponent2.description,
         props: dataComponent2.props
       });
+      dc.setContext(this.tenantId, this.projectId);
       await dc.init();
       await this.createAgentDataComponentRelation(dc.getId());
       logger4.info(
@@ -851,13 +939,13 @@ var Agent = class {
   async createArtifactComponent(artifactComponent2) {
     try {
       const ac = new ArtifactComponent({
-        tenantId: this.tenantId,
-        projectId: this.projectId,
+        id: artifactComponent2.id,
         name: artifactComponent2.name,
         description: artifactComponent2.description,
         summaryProps: artifactComponent2.summaryProps,
         fullProps: artifactComponent2.fullProps
       });
+      ac.setContext(this.tenantId, this.projectId);
       await ac.init();
       await this.createAgentArtifactComponentRelation(ac.getId());
       logger4.info(
@@ -975,13 +1063,13 @@ var ExternalAgent = class {
     __publicField(this, "tenantId");
     __publicField(this, "baseURL");
     this.config = { ...config, type: "external" };
-    this.tenantId = config.tenantId || "default";
+    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.config.tenantId
+        tenantId: this.tenantId
       },
       "External Agent constructor initialized"
     );
@@ -1011,6 +1099,10 @@ var ExternalAgent = class {
       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;
@@ -1204,7 +1296,7 @@ var AgentGraph = class {
     __publicField(this, "stopWhen");
     __publicField(this, "dbClient");
     this.defaultAgent = config.defaultAgent;
-    this.tenantId = config.tenantId || "default";
+    this.tenantId = "default";
     this.projectId = "default";
     this.graphId = config.id;
     this.graphName = config.name || this.graphId;
@@ -1255,14 +1347,14 @@ var AgentGraph = class {
     for (const agent2 of this.agents) {
       if (this.isInternalAgent(agent2)) {
         const internalAgent = agent2;
-        if (!internalAgent.config.tenantId) {
-          internalAgent.config.tenantId = tenantId;
+        if (internalAgent.setContext) {
+          internalAgent.setContext(tenantId, projectId);
         }
         const tools = internalAgent.getTools();
         for (const [_, toolInstance] of Object.entries(tools)) {
-          if (toolInstance && typeof toolInstance === "object" && toolInstance.config) {
-            if (!toolInstance.config.tenantId) {
-              toolInstance.config.tenantId = tenantId;
+          if (toolInstance && typeof toolInstance === "object") {
+            if ("setContext" in toolInstance && typeof toolInstance.setContext === "function") {
+              toolInstance.setContext(tenantId, projectId);
             }
             if ("baseURL" in toolInstance && !toolInstance.baseURL) {
               toolInstance.baseURL = apiUrl;
@@ -1271,8 +1363,8 @@ var AgentGraph = class {
         }
       }
     }
-    if (this.contextConfig && !this.contextConfig.tenantId) {
-      this.contextConfig.tenantId = tenantId;
+    if (this.contextConfig?.setContext) {
+      this.contextConfig.setContext(tenantId, projectId);
     }
     logger7.info(
       {
@@ -1327,6 +1419,10 @@ var AgentGraph = class {
             artifactComponents.push(artifactComponentId);
           }
         }
+        const canUse = tools.map((toolId) => ({
+          toolId,
+          toolSelection: selectedToolsMapping[toolId] || null
+        }));
         agentsObject[internalAgent.getId()] = {
           id: internalAgent.getId(),
           name: internalAgent.getName(),
@@ -1335,8 +1431,8 @@ var AgentGraph = class {
           models: internalAgent.config.models,
           canTransferTo: transfers.map((h) => h.getId()),
           canDelegateTo: delegates.map((d) => d.getId()),
-          tools,
-          selectedTools: Object.keys(selectedToolsMapping).length > 0 ? selectedToolsMapping : void 0,
+          canUse,
+          // Always include for internal agents (required by API)
           dataComponents: dataComponents.length > 0 ? dataComponents : void 0,
           artifactComponents: artifactComponents.length > 0 ? artifactComponents : void 0,
           type: "internal"
@@ -1350,8 +1446,6 @@ var AgentGraph = class {
           baseUrl: externalAgent2.getBaseUrl(),
           credentialReferenceId: externalAgent2.getCredentialReferenceId(),
           headers: externalAgent2.getHeaders(),
-          tools: [],
-          // External agents don't have tools in this context
           type: "external"
         };
       }
@@ -2345,7 +2439,6 @@ var AgentGraph = class {
       throw error;
     }
   }
-  // enableComponentMode removed – feature deprecated
   async createExternalAgentRelation(sourceAgent, externalAgent2, relationType) {
     try {
       const response = await fetch(
@@ -2470,13 +2563,24 @@ async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
     "Creating full project via API"
   );
   const url = `${apiUrl}/tenants/${tenantId}/project-full`;
-  const response = await fetch(url, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(projectData)
-  });
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(projectData)
+    });
+  } catch (fetchError) {
+    logger8.error({
+      error: fetchError instanceof Error ? fetchError.message : "Unknown fetch error",
+      url,
+      tenantId,
+      projectId: projectData.id
+    }, "Fetch request failed");
+    throw fetchError;
+  }
   if (!response.ok) {
     const errorText = await response.text();
     let errorMessage = `Failed to create project: ${response.status} ${response.statusText}`;
@@ -2518,13 +2622,24 @@ async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData)
     "Updating full project via API"
   );
   const url = `${apiUrl}/tenants/${tenantId}/project-full/${projectId}`;
-  const response = await fetch(url, {
-    method: "PUT",
-    headers: {
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(projectData)
-  });
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(projectData)
+    });
+  } catch (fetchError) {
+    logger8.error({
+      error: fetchError instanceof Error ? fetchError.message : "Unknown fetch error",
+      url,
+      tenantId,
+      projectId
+    }, "Fetch request failed");
+    throw fetchError;
+  }
   if (!response.ok) {
     const errorText = await response.text();
     let errorMessage = `Failed to update project: ${response.status} ${response.statusText}`;
@@ -2677,7 +2792,7 @@ var Project = class {
     this.projectId = config.id;
     this.projectName = config.name;
     this.projectDescription = config.description;
-    this.tenantId = config.tenantId || "default";
+    this.tenantId = process.env.INKEEP_TENANT_ID || "default";
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.models = config.models;
     this.stopWhen = config.stopWhen;
@@ -2889,6 +3004,20 @@ var Project = class {
   setStopWhen(stopWhen) {
     this.stopWhen = stopWhen;
   }
+  /**
+   * Get credential tracking information
+   */
+  async getCredentialTracking() {
+    const fullDef = await this.toFullProjectDefinition();
+    const credentials = fullDef.credentialReferences || {};
+    const usage = {};
+    for (const [credId, credData] of Object.entries(credentials)) {
+      if (credData.usedBy) {
+        usage[credId] = credData.usedBy;
+      }
+    }
+    return { credentials, usage };
+  }
   /**
    * Get all graphs in the project
    */
@@ -2984,9 +3113,82 @@ var Project = class {
     const toolsObject = {};
     const dataComponentsObject = {};
     const artifactComponentsObject = {};
+    const credentialReferencesObject = {};
+    const credentialUsageMap = {};
     for (const graph of this.graphs) {
       const graphDefinition = await graph.toFullGraphDefinition();
       graphsObject[graph.getId()] = graphDefinition;
+      const graphCredentials = graph.credentials;
+      if (graphCredentials && Array.isArray(graphCredentials)) {
+        for (const credential2 of graphCredentials) {
+          if (credential2?.__type === "credential-ref") {
+            continue;
+          }
+          if (credential2?.id) {
+            if (!credentialReferencesObject[credential2.id]) {
+              credentialReferencesObject[credential2.id] = {
+                id: credential2.id,
+                type: credential2.type,
+                credentialStoreId: credential2.credentialStoreId,
+                retrievalParams: credential2.retrievalParams
+              };
+              credentialUsageMap[credential2.id] = [];
+            }
+            credentialUsageMap[credential2.id].push({
+              type: "graph",
+              id: graph.getId()
+            });
+          }
+        }
+      }
+      const contextConfig = graph.contextConfig;
+      if (contextConfig) {
+        const contextVariables = contextConfig.getContextVariables?.() || contextConfig.contextVariables;
+        if (contextVariables) {
+          for (const [key, variable] of Object.entries(contextVariables)) {
+            if (variable?.credential) {
+              const credential2 = variable.credential;
+              let credId;
+              if (credential2.__type === "credential-ref") {
+                credId = credential2.id;
+                if (credId && this.credentialReferences) {
+                  const resolvedCred = this.credentialReferences.find((c) => c.id === credId);
+                  if (resolvedCred && !credentialReferencesObject[credId]) {
+                    credentialReferencesObject[credId] = resolvedCred;
+                    credentialUsageMap[credId] = [];
+                  }
+                }
+              } else if (credential2.id) {
+                credId = credential2.id;
+                if (credId && !credentialReferencesObject[credId]) {
+                  credentialReferencesObject[credId] = credential2;
+                  credentialUsageMap[credId] = [];
+                }
+              }
+              if (credId) {
+                if (!credentialUsageMap[credId]) {
+                  credentialUsageMap[credId] = [];
+                }
+                credentialUsageMap[credId].push({
+                  type: "contextVariable",
+                  id: key,
+                  graphId: graph.getId()
+                });
+              }
+            } else if (variable?.credentialReferenceId) {
+              const credId = variable.credentialReferenceId;
+              if (!credentialUsageMap[credId]) {
+                credentialUsageMap[credId] = [];
+              }
+              credentialUsageMap[credId].push({
+                type: "contextVariable",
+                id: key,
+                graphId: graph.getId()
+              });
+            }
+          }
+        }
+      }
       for (const agent2 of graph.agents) {
         if (!agent2.getTools) {
           continue;
@@ -3051,7 +3253,27 @@ var Project = class {
                 toolData.lastToolsSync = actualTool.lastToolsSync;
               }
               if (actualTool.getCredentialReferenceId?.()) {
-                toolData.credentialReferenceId = 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()
+                });
               }
               toolsObject[toolId] = toolData;
             }
@@ -3060,13 +3282,27 @@ var Project = class {
         const agentDataComponents = agent2.getDataComponents?.();
         if (agentDataComponents) {
           for (const dataComponent2 of agentDataComponents) {
-            const dataComponentId = dataComponent2.id || dataComponent2.name.toLowerCase().replace(/\s+/g, "-");
-            if (!dataComponentsObject[dataComponentId]) {
+            let dataComponentId;
+            let dataComponentName;
+            let dataComponentDescription;
+            let dataComponentProps;
+            if (dataComponent2.getId) {
+              dataComponentId = dataComponent2.getId();
+              dataComponentName = dataComponent2.getName();
+              dataComponentDescription = dataComponent2.getDescription() || "";
+              dataComponentProps = dataComponent2.getProps() || {};
+            } else {
+              dataComponentId = dataComponent2.id || (dataComponent2.name ? dataComponent2.name.toLowerCase().replace(/\s+/g, "-") : "");
+              dataComponentName = dataComponent2.name || "";
+              dataComponentDescription = dataComponent2.description || "";
+              dataComponentProps = dataComponent2.props || {};
+            }
+            if (!dataComponentsObject[dataComponentId] && dataComponentName) {
               dataComponentsObject[dataComponentId] = {
                 id: dataComponentId,
-                name: dataComponent2.name,
-                description: dataComponent2.description || "",
-                props: dataComponent2.props || {}
+                name: dataComponentName,
+                description: dataComponentDescription,
+                props: dataComponentProps
               };
             }
           }
@@ -3074,20 +3310,52 @@ var Project = class {
         const agentArtifactComponents = agent2.getArtifactComponents?.();
         if (agentArtifactComponents) {
           for (const artifactComponent2 of agentArtifactComponents) {
-            const artifactComponentId = artifactComponent2.id || artifactComponent2.name.toLowerCase().replace(/\s+/g, "-");
-            if (!artifactComponentsObject[artifactComponentId]) {
+            let artifactComponentId;
+            let artifactComponentName;
+            let artifactComponentDescription;
+            let artifactComponentSummaryProps;
+            let artifactComponentFullProps;
+            if (artifactComponent2.getId) {
+              artifactComponentId = artifactComponent2.getId();
+              artifactComponentName = artifactComponent2.getName();
+              artifactComponentDescription = artifactComponent2.getDescription() || "";
+              artifactComponentSummaryProps = artifactComponent2.getSummaryProps() || {};
+              artifactComponentFullProps = artifactComponent2.getFullProps() || {};
+            } else {
+              artifactComponentId = artifactComponent2.id || (artifactComponent2.name ? artifactComponent2.name.toLowerCase().replace(/\s+/g, "-") : "");
+              artifactComponentName = artifactComponent2.name || "";
+              artifactComponentDescription = artifactComponent2.description || "";
+              artifactComponentSummaryProps = artifactComponent2.summaryProps || {};
+              artifactComponentFullProps = artifactComponent2.fullProps || {};
+            }
+            if (!artifactComponentsObject[artifactComponentId] && artifactComponentName) {
               artifactComponentsObject[artifactComponentId] = {
                 id: artifactComponentId,
-                name: artifactComponent2.name,
-                description: artifactComponent2.description || "",
-                summaryProps: artifactComponent2.summaryProps || {},
-                fullProps: artifactComponent2.fullProps || {}
+                name: artifactComponentName,
+                description: artifactComponentDescription,
+                summaryProps: artifactComponentSummaryProps,
+                fullProps: artifactComponentFullProps
               };
             }
           }
         }
       }
     }
+    if (this.credentialReferences && this.credentialReferences.length > 0) {
+      for (const credential2 of this.credentialReferences) {
+        if (credential2.id) {
+          if (!credentialReferencesObject[credential2.id]) {
+            credentialReferencesObject[credential2.id] = credential2;
+            credentialUsageMap[credential2.id] = [];
+          }
+        }
+      }
+    }
+    for (const [credId, usages] of Object.entries(credentialUsageMap)) {
+      if (credentialReferencesObject[credId]) {
+        credentialReferencesObject[credId].usedBy = usages;
+      }
+    }
     return {
       id: this.projectId,
       name: this.projectName,
@@ -3098,31 +3366,13 @@ var Project = class {
       tools: toolsObject,
       dataComponents: Object.keys(dataComponentsObject).length > 0 ? dataComponentsObject : void 0,
       artifactComponents: Object.keys(artifactComponentsObject).length > 0 ? artifactComponentsObject : void 0,
-      credentialReferences: void 0,
-      // Projects don't directly hold credentials yet
+      credentialReferences: Object.keys(credentialReferencesObject).length > 0 ? credentialReferencesObject : void 0,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
-  /**
-   * Convert project configuration to API format
-   */
-  toApiFormat() {
-    return {
-      id: this.projectId,
-      name: this.projectName,
-      description: this.projectDescription || "",
-      models: this.models,
-      stopWhen: this.stopWhen
-    };
-  }
 };
 
-// src/utils/generateIdFromName.ts
-function generateIdFromName3(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-
 // src/builderFunctions.ts
 function agentGraph(config) {
   return new AgentGraph(config);
@@ -3145,13 +3395,12 @@ function mcpServer(config) {
   if (!config.serverUrl) {
     throw new Error("MCP server requires a serverUrl");
   }
-  const id = config.id || generateIdFromName3(config.name);
+  const id = config.id || generateIdFromName(config.name);
   return new Tool({
     id,
     name: config.name,
     description: config.description,
     serverUrl: config.serverUrl,
-    tenantId: config.tenantId,
     credential: config.credential,
     activeTools: config.activeTools,
     headers: config.headers,
@@ -3162,24 +3411,24 @@ function mcpServer(config) {
 function mcpTool(config) {
   const configWithId = {
     ...config,
-    id: config.id || generateIdFromName3(config.name)
+    id: config.id || generateIdFromName(config.name)
   };
   const validatedConfig = agentsCore.MCPToolConfigSchema.parse(configWithId);
   return new Tool(validatedConfig);
 }
 function artifactComponent(config) {
-  return new ArtifactComponent({
+  const configWithId = {
     ...config,
-    tenantId: config.tenantId || "default",
-    projectId: config.projectId || "default"
-  });
+    id: config.id || generateIdFromName(config.name)
+  };
+  return new ArtifactComponent(configWithId);
 }
 function dataComponent(config) {
-  return new DataComponent({
+  const configWithId = {
     ...config,
-    tenantId: config.tenantId || "default",
-    projectId: config.projectId || "default"
-  });
+    id: config.id || generateIdFromName(config.name)
+  };
+  return new DataComponent(configWithId);
 }
 function agentMcp(config) {
   return {
@@ -3188,6 +3437,17 @@ function agentMcp(config) {
   };
 }
 
+// src/credential-ref.ts
+function credentialRef(id) {
+  return {
+    __type: "credential-ref",
+    id
+  };
+}
+function isCredentialReference(value) {
+  return value && typeof value === "object" && value.__type === "credential-ref";
+}
+
 // src/utils/validateFunction.ts
 function validateFunction(value, name) {
   if (typeof value !== "function") {
@@ -3219,7 +3479,7 @@ function transfer(targetAgent, description, condition) {
 // src/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
-    getEnvironmentSetting: async (key) => {
+    getEnvironmentSetting: (key) => {
       const currentEnv = process.env.INKEEP_ENV || "development";
       const env = environments[currentEnv];
       if (!env) {
@@ -3451,11 +3711,13 @@ exports.artifactComponent = artifactComponent;
 exports.createEnvironmentSettings = createEnvironmentSettings;
 exports.createFullProjectViaAPI = createFullProjectViaAPI;
 exports.credential = credential;
+exports.credentialRef = credentialRef;
 exports.dataComponent = dataComponent;
 exports.deleteFullProjectViaAPI = deleteFullProjectViaAPI;
 exports.externalAgent = externalAgent;
 exports.externalAgents = externalAgents;
 exports.getFullProjectViaAPI = getFullProjectViaAPI;
+exports.isCredentialReference = isCredentialReference;
 exports.mcpServer = mcpServer;
 exports.mcpTool = mcpTool;
 exports.project = project;