@inkeep/agents-sdk 0.37.1 → 0.38.0

package/dist/index.cjs

@@ -92,7 +92,7 @@ var ArtifactComponent = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getProps() {
     return this.config.props;
@@ -387,17 +387,19 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId, apiKey) {
   );
 }
 function parseError(errorText) {
+  let result;
   try {
     const errorJson = JSON.parse(errorText);
     if (errorJson.error) {
       const { error } = errorJson;
-      return error?.message ?? error;
+      result = error?.message ?? error;
     }
   } catch {
     if (errorText) {
-      return errorText;
+      result = errorText;
     }
   }
+  return result;
 }
 
 // src/agentFullClient.ts
@@ -623,7 +625,7 @@ var FunctionTool = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getInputSchema() {
     return this.config.inputSchema;
@@ -847,7 +849,7 @@ var Agent = class {
       subAgentsObject[subAgent2.getId()] = {
         id: subAgent2.getId(),
         name: subAgent2.getName(),
-        description: subAgent2.config.description || `Agent ${subAgent2.getName()}`,
+        description: subAgent2.config.description || "",
         prompt: subAgent2.getInstructions(),
         models: subAgent2.config.models,
         stopWhen: subAgent2.config.stopWhen,
@@ -1537,193 +1539,6 @@ var Agent = class {
     }
     return [input];
   }
-  async saveToDatabase() {
-    try {
-      const getUrl = `${this.baseURL}/tenants/${this.tenantId}/agents/${this.agentId}`;
-      try {
-        const getResponse = await fetch(getUrl, {
-          method: "GET",
-          headers: {
-            "Content-Type": "application/json"
-          }
-        });
-        if (getResponse.ok) {
-          logger6.info({ agentId: this.agentId }, "Agent already exists in backend");
-          return;
-        }
-        if (getResponse.status !== 404) {
-          throw new Error(`HTTP ${getResponse.status}: ${getResponse.statusText}`);
-        }
-      } catch (error) {
-        if (!error.message.includes("404")) {
-          throw error;
-        }
-      }
-      logger6.info({ agentId: this.agentId }, "Creating agent in backend");
-      const createUrl = `${this.baseURL}/tenants/${this.tenantId}/agents`;
-      const createResponse = await fetch(createUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({
-          id: this.agentId,
-          name: this.agentName,
-          defaultSubAgentId: this.defaultSubAgent?.getId() || "",
-          contextConfigId: this.contextConfig?.getId(),
-          models: this.models
-        })
-      });
-      if (!createResponse.ok) {
-        throw new Error(`HTTP ${createResponse.status}: ${createResponse.statusText}`);
-      }
-      const createData = await createResponse.json();
-      this.agentId = createData.data.id;
-      logger6.info({ agent: createData.data }, "Agent created in backend");
-    } catch (error) {
-      throw new Error(
-        `Failed to save agent to database: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
-    }
-  }
-  async saveRelations() {
-    if (this.defaultSubAgent) {
-      try {
-        const updateUrl = `${this.baseURL}/tenants/${this.tenantId}/agents/${this.agentId}`;
-        const updateResponse = await fetch(updateUrl, {
-          method: "PUT",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            id: this.agentId,
-            defaultSubAgentId: this.defaultSubAgent.getId(),
-            contextConfigId: this.contextConfig?.getId()
-          })
-        });
-        if (!updateResponse.ok) {
-          throw new Error(`HTTP ${updateResponse.status}: ${updateResponse.statusText}`);
-        }
-        logger6.debug(
-          {
-            agentId: this.agentId,
-            defaultSubAgent: this.defaultSubAgent.getName()
-          },
-          "Agent relationships configured"
-        );
-      } catch (error) {
-        logger6.error(
-          {
-            agentId: this.agentId,
-            error: error instanceof Error ? error.message : "Unknown error"
-          },
-          "Failed to update agent relationships"
-        );
-        throw error;
-      }
-    }
-  }
-  async createSubAgentRelations() {
-    const allSubAgentRelationPromises = [];
-    for (const subAgent2 of this.subAgents) {
-      const transfers = subAgent2.getTransfers();
-      for (const transferAgent of transfers) {
-        allSubAgentRelationPromises.push(
-          this.createSubAgentRelation(subAgent2, transferAgent, "transfer")
-        );
-      }
-      const delegates = subAgent2.getSubAgentDelegates();
-      for (const delegate of delegates) {
-        if (this.isInternalAgent(delegate)) {
-          allSubAgentRelationPromises.push(
-            this.createSubAgentRelation(subAgent2, delegate, "delegate")
-          );
-        }
-      }
-    }
-    const results = await Promise.allSettled(allSubAgentRelationPromises);
-    const errors = [];
-    let successCount = 0;
-    for (const result of results) {
-      if (result.status === "fulfilled") {
-        successCount++;
-      } else {
-        errors.push(result.reason);
-        logger6.error(
-          {
-            error: result.reason instanceof Error ? result.reason.message : "Unknown error",
-            agentId: this.agentId
-          },
-          "Failed to create agent relation"
-        );
-      }
-    }
-    logger6.info(
-      {
-        agentId: this.agentId,
-        totalRelations: allSubAgentRelationPromises.length,
-        successCount,
-        errorCount: errors.length
-      },
-      "Completed agent relation creation batch"
-    );
-    if (errors.length > 0 && successCount === 0) {
-      throw new Error(`All ${errors.length} agent relation creations failed`);
-    }
-  }
-  async createSubAgentRelation(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({
-          agentId: this.agentId,
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          relationType
-        })
-      });
-      if (!response.ok) {
-        const errorText = await response.text().catch(() => "Unknown error");
-        if (response.status === 422 && errorText.includes("already exists")) {
-          logger6.info(
-            {
-              sourceSubAgentId: sourceAgent.getId(),
-              targetSubAgentId: targetAgent.getId(),
-              agentId: this.agentId,
-              relationType
-            },
-            `${relationType} relation already exists, skipping creation`
-          );
-          return;
-        }
-        throw new Error(`Failed to create subAgent relation: ${response.status} - ${errorText}`);
-      }
-      logger6.info(
-        {
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          agentId: this.agentId,
-          relationType
-        },
-        `${relationType} subAgent relation created successfully`
-      );
-    } catch (error) {
-      logger6.error(
-        {
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          agentId: this.agentId,
-          relationType,
-          error: error instanceof Error ? error.message : "Unknown error"
-        },
-        `Failed to create ${relationType} subAgent relation`
-      );
-      throw error;
-    }
-  }
 };
 var logger7 = agentsCore.getLogger("dataComponent");
 var DataComponent = class {
@@ -1774,7 +1589,7 @@ var DataComponent = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getProps() {
     return this.config.props;
@@ -2777,12 +2592,17 @@ var Tool = class {
    * ```
    */
   with(config) {
-    const { selectedTools, toolPolicies } = agentsCore.normalizeToolSelections(config.selectedTools);
+    const { selectedTools, toolPolicies } = agentsCore.normalizeToolSelections(
+      config.selectedTools ?? void 0
+    );
+    const isUnspecified = config.selectedTools === void 0 || config.selectedTools === null;
+    const resolvedSelectedTools = isUnspecified ? void 0 : selectedTools;
+    const resolvedToolPolicies = isUnspecified || Object.keys(toolPolicies).length === 0 ? void 0 : toolPolicies;
     return {
       server: this,
-      selectedTools,
+      selectedTools: resolvedSelectedTools,
       headers: config.headers,
-      toolPolicies
+      toolPolicies: resolvedToolPolicies
     };
   }
 };
@@ -2862,7 +2682,7 @@ var SubAgent = class {
     return this.config.name;
   }
   getInstructions() {
-    return this.config.prompt;
+    return this.config.prompt || "";
   }
   /**
    * Get the agent's description (the human-readable description field)
@@ -3078,7 +2898,7 @@ var SubAgent = class {
       id: this.getId(),
       name: this.config.name,
       description: this.config.description || "",
-      prompt: this.config.prompt,
+      prompt: this.config.prompt || "",
       conversationHistoryConfig: this.config.conversationHistoryConfig,
       models: this.config.models,
       stopWhen: this.config.stopWhen
@@ -4136,9 +3956,6 @@ var Runner = class _Runner {
       if (!defaultSubAgent.getName()) {
         errors.push("Default agent name is required");
       }
-      if (!defaultSubAgent.getInstructions()) {
-        errors.push("Default agent instructions are required");
-      }
     }
     const subAgents = agent2.getSubAgents();
     if (subAgents.length === 0) {

package/dist/index.d.cts

@@ -177,8 +177,13 @@ type AgentMcpConfig = {
  * Supports flexible tool selection with per-tool policies
  */
 type AgentMcpConfigInput = {
-    /** Tools to enable from the MCP server - can be strings or objects with policies */
-    selectedTools?: McpToolSelection[];
+    /**
+     * Tools to enable from the MCP server - can be strings or objects with policies
+     * - undefined or null: all tools enabled (no filtering)
+     * - []: zero tools enabled (explicit empty selection)
+     * - ['tool1', 'tool2']: specific tools enabled
+     */
+    selectedTools?: McpToolSelection[] | null;
     /** Custom headers for MCP server requests */
     headers?: Record<string, string>;
 };
@@ -788,10 +793,6 @@ declare class Agent implements AgentInterface {
      * Normalize input messages to the expected format
      */
     private normalizeMessages;
-    private saveToDatabase;
-    private saveRelations;
-    private createSubAgentRelations;
-    private createSubAgentRelation;
 }
 
 /**
@@ -1098,7 +1099,10 @@ declare function credential(config: CredentialReferenceApiInsert): {
     type: "nango" | "memory" | "keychain";
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    userId?: string | null | undefined;
     retrievalParams?: Record<string, unknown> | null | undefined;
+    toolId?: string | null | undefined;
+    createdBy?: string | null | undefined;
 };
 /**
  * Creates an MCP (Model Context Protocol) server for tool functionality.

package/dist/index.d.ts

@@ -177,8 +177,13 @@ type AgentMcpConfig = {
  * Supports flexible tool selection with per-tool policies
  */
 type AgentMcpConfigInput = {
-    /** Tools to enable from the MCP server - can be strings or objects with policies */
-    selectedTools?: McpToolSelection[];
+    /**
+     * Tools to enable from the MCP server - can be strings or objects with policies
+     * - undefined or null: all tools enabled (no filtering)
+     * - []: zero tools enabled (explicit empty selection)
+     * - ['tool1', 'tool2']: specific tools enabled
+     */
+    selectedTools?: McpToolSelection[] | null;
     /** Custom headers for MCP server requests */
     headers?: Record<string, string>;
 };
@@ -788,10 +793,6 @@ declare class Agent implements AgentInterface {
      * Normalize input messages to the expected format
      */
     private normalizeMessages;
-    private saveToDatabase;
-    private saveRelations;
-    private createSubAgentRelations;
-    private createSubAgentRelation;
 }
 
 /**
@@ -1098,7 +1099,10 @@ declare function credential(config: CredentialReferenceApiInsert): {
     type: "nango" | "memory" | "keychain";
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    userId?: string | null | undefined;
     retrievalParams?: Record<string, unknown> | null | undefined;
+    toolId?: string | null | undefined;
+    createdBy?: string | null | undefined;
 };
 /**
  * Creates an MCP (Model Context Protocol) server for tool functionality.

package/dist/index.js

@@ -65,7 +65,7 @@ var ArtifactComponent = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getProps() {
     return this.config.props;
@@ -360,17 +360,19 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId, apiKey) {
   );
 }
 function parseError(errorText) {
+  let result;
   try {
     const errorJson = JSON.parse(errorText);
     if (errorJson.error) {
       const { error } = errorJson;
-      return error?.message ?? error;
+      result = error?.message ?? error;
     }
   } catch {
     if (errorText) {
-      return errorText;
+      result = errorText;
     }
   }
+  return result;
 }
 
 // src/agentFullClient.ts
@@ -596,7 +598,7 @@ var FunctionTool = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getInputSchema() {
     return this.config.inputSchema;
@@ -820,7 +822,7 @@ var Agent = class {
       subAgentsObject[subAgent2.getId()] = {
         id: subAgent2.getId(),
         name: subAgent2.getName(),
-        description: subAgent2.config.description || `Agent ${subAgent2.getName()}`,
+        description: subAgent2.config.description || "",
         prompt: subAgent2.getInstructions(),
         models: subAgent2.config.models,
         stopWhen: subAgent2.config.stopWhen,
@@ -1510,193 +1512,6 @@ var Agent = class {
     }
     return [input];
   }
-  async saveToDatabase() {
-    try {
-      const getUrl = `${this.baseURL}/tenants/${this.tenantId}/agents/${this.agentId}`;
-      try {
-        const getResponse = await fetch(getUrl, {
-          method: "GET",
-          headers: {
-            "Content-Type": "application/json"
-          }
-        });
-        if (getResponse.ok) {
-          logger6.info({ agentId: this.agentId }, "Agent already exists in backend");
-          return;
-        }
-        if (getResponse.status !== 404) {
-          throw new Error(`HTTP ${getResponse.status}: ${getResponse.statusText}`);
-        }
-      } catch (error) {
-        if (!error.message.includes("404")) {
-          throw error;
-        }
-      }
-      logger6.info({ agentId: this.agentId }, "Creating agent in backend");
-      const createUrl = `${this.baseURL}/tenants/${this.tenantId}/agents`;
-      const createResponse = await fetch(createUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({
-          id: this.agentId,
-          name: this.agentName,
-          defaultSubAgentId: this.defaultSubAgent?.getId() || "",
-          contextConfigId: this.contextConfig?.getId(),
-          models: this.models
-        })
-      });
-      if (!createResponse.ok) {
-        throw new Error(`HTTP ${createResponse.status}: ${createResponse.statusText}`);
-      }
-      const createData = await createResponse.json();
-      this.agentId = createData.data.id;
-      logger6.info({ agent: createData.data }, "Agent created in backend");
-    } catch (error) {
-      throw new Error(
-        `Failed to save agent to database: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
-    }
-  }
-  async saveRelations() {
-    if (this.defaultSubAgent) {
-      try {
-        const updateUrl = `${this.baseURL}/tenants/${this.tenantId}/agents/${this.agentId}`;
-        const updateResponse = await fetch(updateUrl, {
-          method: "PUT",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            id: this.agentId,
-            defaultSubAgentId: this.defaultSubAgent.getId(),
-            contextConfigId: this.contextConfig?.getId()
-          })
-        });
-        if (!updateResponse.ok) {
-          throw new Error(`HTTP ${updateResponse.status}: ${updateResponse.statusText}`);
-        }
-        logger6.debug(
-          {
-            agentId: this.agentId,
-            defaultSubAgent: this.defaultSubAgent.getName()
-          },
-          "Agent relationships configured"
-        );
-      } catch (error) {
-        logger6.error(
-          {
-            agentId: this.agentId,
-            error: error instanceof Error ? error.message : "Unknown error"
-          },
-          "Failed to update agent relationships"
-        );
-        throw error;
-      }
-    }
-  }
-  async createSubAgentRelations() {
-    const allSubAgentRelationPromises = [];
-    for (const subAgent2 of this.subAgents) {
-      const transfers = subAgent2.getTransfers();
-      for (const transferAgent of transfers) {
-        allSubAgentRelationPromises.push(
-          this.createSubAgentRelation(subAgent2, transferAgent, "transfer")
-        );
-      }
-      const delegates = subAgent2.getSubAgentDelegates();
-      for (const delegate of delegates) {
-        if (this.isInternalAgent(delegate)) {
-          allSubAgentRelationPromises.push(
-            this.createSubAgentRelation(subAgent2, delegate, "delegate")
-          );
-        }
-      }
-    }
-    const results = await Promise.allSettled(allSubAgentRelationPromises);
-    const errors = [];
-    let successCount = 0;
-    for (const result of results) {
-      if (result.status === "fulfilled") {
-        successCount++;
-      } else {
-        errors.push(result.reason);
-        logger6.error(
-          {
-            error: result.reason instanceof Error ? result.reason.message : "Unknown error",
-            agentId: this.agentId
-          },
-          "Failed to create agent relation"
-        );
-      }
-    }
-    logger6.info(
-      {
-        agentId: this.agentId,
-        totalRelations: allSubAgentRelationPromises.length,
-        successCount,
-        errorCount: errors.length
-      },
-      "Completed agent relation creation batch"
-    );
-    if (errors.length > 0 && successCount === 0) {
-      throw new Error(`All ${errors.length} agent relation creations failed`);
-    }
-  }
-  async createSubAgentRelation(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({
-          agentId: this.agentId,
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          relationType
-        })
-      });
-      if (!response.ok) {
-        const errorText = await response.text().catch(() => "Unknown error");
-        if (response.status === 422 && errorText.includes("already exists")) {
-          logger6.info(
-            {
-              sourceSubAgentId: sourceAgent.getId(),
-              targetSubAgentId: targetAgent.getId(),
-              agentId: this.agentId,
-              relationType
-            },
-            `${relationType} relation already exists, skipping creation`
-          );
-          return;
-        }
-        throw new Error(`Failed to create subAgent relation: ${response.status} - ${errorText}`);
-      }
-      logger6.info(
-        {
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          agentId: this.agentId,
-          relationType
-        },
-        `${relationType} subAgent relation created successfully`
-      );
-    } catch (error) {
-      logger6.error(
-        {
-          sourceSubAgentId: sourceAgent.getId(),
-          targetSubAgentId: targetAgent.getId(),
-          agentId: this.agentId,
-          relationType,
-          error: error instanceof Error ? error.message : "Unknown error"
-        },
-        `Failed to create ${relationType} subAgent relation`
-      );
-      throw error;
-    }
-  }
 };
 var logger7 = getLogger("dataComponent");
 var DataComponent = class {
@@ -1747,7 +1562,7 @@ var DataComponent = class {
     return this.config.name;
   }
   getDescription() {
-    return this.config.description;
+    return this.config.description || "";
   }
   getProps() {
     return this.config.props;
@@ -2750,12 +2565,17 @@ var Tool = class {
    * ```
    */
   with(config) {
-    const { selectedTools, toolPolicies } = normalizeToolSelections(config.selectedTools);
+    const { selectedTools, toolPolicies } = normalizeToolSelections(
+      config.selectedTools ?? void 0
+    );
+    const isUnspecified = config.selectedTools === void 0 || config.selectedTools === null;
+    const resolvedSelectedTools = isUnspecified ? void 0 : selectedTools;
+    const resolvedToolPolicies = isUnspecified || Object.keys(toolPolicies).length === 0 ? void 0 : toolPolicies;
     return {
       server: this,
-      selectedTools,
+      selectedTools: resolvedSelectedTools,
       headers: config.headers,
-      toolPolicies
+      toolPolicies: resolvedToolPolicies
     };
   }
 };
@@ -2835,7 +2655,7 @@ var SubAgent = class {
     return this.config.name;
   }
   getInstructions() {
-    return this.config.prompt;
+    return this.config.prompt || "";
   }
   /**
    * Get the agent's description (the human-readable description field)
@@ -3051,7 +2871,7 @@ var SubAgent = class {
       id: this.getId(),
       name: this.config.name,
       description: this.config.description || "",
-      prompt: this.config.prompt,
+      prompt: this.config.prompt || "",
       conversationHistoryConfig: this.config.conversationHistoryConfig,
       models: this.config.models,
       stopWhen: this.config.stopWhen
@@ -4109,9 +3929,6 @@ var Runner = class _Runner {
       if (!defaultSubAgent.getName()) {
         errors.push("Default agent name is required");
       }
-      if (!defaultSubAgent.getInstructions()) {
-        errors.push("Default agent instructions are required");
-      }
     }
     const subAgents = agent2.getSubAgents();
     if (subAgents.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.37.1",
+  "version": "0.38.0",
   "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.37.1"
+    "@inkeep/agents-core": "^0.38.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
@@ -65,7 +65,7 @@
     "test:coverage": "ENVIRONMENT=test vitest --run --coverage",
     "typecheck": "tsc --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
-    "lint": "biome lint .",
+    "lint": "biome lint --error-on-warnings",
     "lint:fix": "biome check --write .",
     "format": "biome format --write ."
   }