@inkeep/agents-sdk 0.0.0-dev-20251009233425 → 0.0.0-dev-20251010165126

package/README.md

@@ -27,7 +27,7 @@ export const graph = agentGraph({
   name: 'My Graph',
   description: 'My agent graph',
   defaultSubAgent: myAgent,
-  agents: [myAgent],
+  subAgents: () => [myAgent],
 });
 ```
 

package/dist/index.cjs

@@ -717,20 +717,18 @@ function resolveGetter(value) {
   }
   return value;
 }
-var Agent = class {
+var SubAgent = class {
   constructor(config) {
     __publicField(this, "config");
     __publicField(this, "type", "internal");
     __publicField(this, "baseURL");
     __publicField(this, "tenantId");
     __publicField(this, "projectId");
-    __publicField(this, "graphId");
     __publicField(this, "initialized", false);
     this.config = { ...config, type: "internal" };
     this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
     this.tenantId = "default";
     this.projectId = "default";
-    this.graphId = "default";
     logger6.info(
       {
         tenantId: this.tenantId,
@@ -740,11 +738,10 @@ var Agent = class {
       "Agent constructor initialized"
     );
   }
-  // Set context (tenantId, projectId, graphId, and baseURL) from external source (graph, CLI, etc)
-  setContext(tenantId, projectId, graphId, baseURL) {
+  // Set context (tenantId, projectId, and baseURL) from external source (graph, CLI, etc)
+  setContext(tenantId, projectId, baseURL) {
     this.tenantId = tenantId;
     this.projectId = projectId;
-    this.graphId = graphId;
     if (baseURL) {
       this.baseURL = baseURL;
     }
@@ -1520,7 +1517,7 @@ function resolveGetter2(value) {
 }
 var AgentGraph = class {
   constructor(config) {
-    __publicField(this, "agents", []);
+    __publicField(this, "subAgents", []);
     __publicField(this, "agentMap", /* @__PURE__ */ new Map());
     __publicField(this, "defaultSubAgent");
     __publicField(this, "baseURL");
@@ -1557,10 +1554,10 @@ var AgentGraph = class {
     this.stopWhen = config.stopWhen ? {
       transferCountIs: config.stopWhen.transferCountIs
     } : void 0;
-    this.agents = resolveGetter2(config.agents) || [];
-    this.agentMap = new Map(this.agents.map((agent2) => [agent2.getId(), agent2]));
+    this.subAgents = resolveGetter2(config.subAgents) || [];
+    this.agentMap = new Map(this.subAgents.map((agent) => [agent.getId(), agent]));
     if (this.defaultSubAgent) {
-      this.agents.push(this.defaultSubAgent);
+      this.subAgents.push(this.defaultSubAgent);
       this.agentMap.set(this.defaultSubAgent.getId(), this.defaultSubAgent);
     }
     if (this.models) {
@@ -1570,7 +1567,7 @@ var AgentGraph = class {
       {
         graphId: this.graphId,
         tenantId: this.tenantId,
-        agentCount: this.agents.length,
+        agentCount: this.subAgents.length,
         defaultSubAgent: this.defaultSubAgent?.getName()
       },
       "AgentGraph created"
@@ -1587,9 +1584,9 @@ var AgentGraph = class {
     this.tenantId = tenantId;
     this.projectId = projectId;
     this.baseURL = apiUrl;
-    for (const agent2 of this.agents) {
-      if (this.isInternalAgent(agent2)) {
-        const internalAgent = agent2;
+    for (const agent of this.subAgents) {
+      if (this.isInternalAgent(agent)) {
+        const internalAgent = agent;
         if (internalAgent.setContext) {
           internalAgent.setContext(tenantId, projectId, apiUrl);
         }
@@ -1602,7 +1599,7 @@ var AgentGraph = class {
           }
         }
       } else {
-        const externalAgent2 = agent2;
+        const externalAgent2 = agent;
         if (externalAgent2.setContext) {
           externalAgent2.setContext(tenantId, apiUrl);
         }
@@ -1626,9 +1623,9 @@ var AgentGraph = class {
    */
   async toFullGraphDefinition() {
     const agentsObject = {};
-    for (const agent2 of this.agents) {
-      if (this.isInternalAgent(agent2)) {
-        const internalAgent = agent2;
+    for (const agent of this.subAgents) {
+      if (this.isInternalAgent(agent)) {
+        const internalAgent = agent;
         const transfers = internalAgent.getTransfers();
         const delegates = internalAgent.getDelegates();
         const tools = [];
@@ -1681,7 +1678,7 @@ var AgentGraph = class {
           type: "internal"
         };
       } else {
-        const externalAgent2 = agent2;
+        const externalAgent2 = agent;
         agentsObject[externalAgent2.getId()] = {
           id: externalAgent2.getId(),
           name: externalAgent2.getName(),
@@ -1713,11 +1710,11 @@ var AgentGraph = class {
   async initializeAllTools() {
     logger8.info({ graphId: this.graphId }, "Initializing all tools in graph");
     const toolInitPromises = [];
-    for (const agent2 of this.agents) {
-      if (!agent2.getTools) {
+    for (const agent of this.subAgents) {
+      if (!agent.getTools) {
         continue;
       }
-      const internalAgent = agent2;
+      const internalAgent = agent;
       const agentTools = internalAgent.getTools();
       for (const [toolName, toolInstance] of Object.entries(agentTools)) {
         if (toolInstance && typeof toolInstance === "object") {
@@ -1737,7 +1734,7 @@ var AgentGraph = class {
                   }
                   logger8.debug(
                     {
-                      subAgentId: agent2.getId(),
+                      subAgentId: agent.getId(),
                       toolName,
                       toolType: toolInstance.constructor.name,
                       skipDbRegistration
@@ -1747,7 +1744,7 @@ var AgentGraph = class {
                 } catch (error) {
                   logger8.error(
                     {
-                      subAgentId: agent2.getId(),
+                      subAgentId: agent.getId(),
                       toolName,
                       error: error instanceof Error ? error.message : "Unknown error"
                     },
@@ -1778,7 +1775,7 @@ var AgentGraph = class {
     logger8.info(
       {
         graphId: this.graphId,
-        agentCount: this.agents.length
+        agentCount: this.subAgents.length
       },
       "Initializing agent graph using new graph endpoint"
     );
@@ -1832,7 +1829,7 @@ var AgentGraph = class {
     logger8.info(
       {
         graphId: this.graphId,
-        agentCount: this.agents.length
+        agentCount: this.subAgents.length
       },
       "Initializing agent graph"
     );
@@ -1847,13 +1844,13 @@ var AgentGraph = class {
           "Context configuration initialized for graph"
         );
       }
-      const initPromises = this.agents.map(async (agent2) => {
+      const initPromises = this.subAgents.map(async (agent) => {
         try {
-          agent2.config.graphId = this.graphId;
-          await agent2.init();
+          agent.config.graphId = this.graphId;
+          await agent.init();
           logger8.debug(
             {
-              subAgentId: agent2.getId(),
+              subAgentId: agent.getId(),
               graphId: this.graphId
             },
             "Agent initialized in graph"
@@ -1861,7 +1858,7 @@ var AgentGraph = class {
         } catch (error) {
           logger8.error(
             {
-              subAgentId: agent2.getId(),
+              subAgentId: agent.getId(),
               graphId: this.graphId,
               error: error instanceof Error ? error.message : "Unknown error"
             },
@@ -1879,7 +1876,7 @@ var AgentGraph = class {
       logger8.info(
         {
           graphId: this.graphId,
-          agentCount: this.agents.length
+          agentCount: this.subAgents.length
         },
         "Agent graph initialized successfully"
       );
@@ -1951,11 +1948,11 @@ var AgentGraph = class {
    */
   async runWith(subAgentId, input, options) {
     await this._init();
-    const agent2 = this.getAgent(subAgentId);
-    if (!agent2) {
+    const agent = this.getAgent(subAgentId);
+    if (!agent) {
       throw new Error(`Agent '${subAgentId}' not found in graph`);
     }
-    if (!this.isInternalAgent(agent2)) {
+    if (!this.isInternalAgent(agent)) {
       throw new Error(
         `Agent '${subAgentId}' is an external agent and cannot be run directly. External agents are only accessible via delegation.`
       );
@@ -1971,7 +1968,7 @@ var AgentGraph = class {
     const response = await this.executeWithBackend(input, options);
     return {
       finalOutput: response,
-      agent: agent2,
+      agent,
       turnCount: 1,
       usage: { inputTokens: 0, outputTokens: 0 },
       metadata: {
@@ -1989,17 +1986,17 @@ var AgentGraph = class {
   /**
    * Add an agent to the graph
    */
-  addAgent(agent2) {
-    this.agents.push(agent2);
-    this.agentMap.set(agent2.getId(), agent2);
-    if (this.models && this.isInternalAgent(agent2)) {
-      this.propagateModelSettingsToAgent(agent2);
+  addSubAgent(agent) {
+    this.subAgents.push(agent);
+    this.agentMap.set(agent.getId(), agent);
+    if (this.models && this.isInternalAgent(agent)) {
+      this.propagateModelSettingsToAgent(agent);
     }
     logger8.info(
       {
         graphId: this.graphId,
-        subAgentId: agent2.getId(),
-        agentType: this.isInternalAgent(agent2) ? "internal" : "external"
+        subAgentId: agent.getId(),
+        agentType: this.isInternalAgent(agent) ? "internal" : "external"
       },
       "Agent added to graph"
     );
@@ -2007,11 +2004,11 @@ var AgentGraph = class {
   /**
    * Remove an agent from the graph
    */
-  removeAgent(id) {
+  removeSubAgent(id) {
     const agentToRemove = this.agentMap.get(id);
     if (agentToRemove) {
       this.agentMap.delete(agentToRemove.getId());
-      this.agents = this.agents.filter((agent2) => agent2.getId() !== agentToRemove.getId());
+      this.subAgents = this.subAgents.filter((agent) => agent.getId() !== agentToRemove.getId());
       logger8.info(
         {
           graphId: this.graphId,
@@ -2026,25 +2023,25 @@ var AgentGraph = class {
   /**
    * Get all agents in the graph
    */
-  getAgents() {
-    return this.agents;
+  getSubAgents() {
+    return this.subAgents;
   }
   /**
    * Get all agent ids (unified method for all agent types)
    */
-  getAgentIds() {
+  getSubAgentIds() {
     return Array.from(this.agentMap.keys());
   }
   /**
    * Set the default agent
    */
-  setdefaultSubAgent(agent2) {
-    this.defaultSubAgent = agent2;
-    this.addAgent(agent2);
+  setdefaultSubAgent(agent) {
+    this.defaultSubAgent = agent;
+    this.addSubAgent(agent);
     logger8.info(
       {
         graphId: this.graphId,
-        defaultSubAgent: agent2.getId()
+        defaultSubAgent: agent.getId()
       },
       "Default agent updated"
     );
@@ -2111,7 +2108,7 @@ var AgentGraph = class {
    */
   getStats() {
     return {
-      agentCount: this.agents.length,
+      agentCount: this.subAgents.length,
       defaultSubAgent: this.defaultSubAgent?.getName() || null,
       initialized: this.initialized,
       graphId: this.graphId,
@@ -2123,35 +2120,35 @@ var AgentGraph = class {
    */
   validate() {
     const errors = [];
-    if (this.agents.length === 0) {
+    if (this.subAgents.length === 0) {
       errors.push("Graph must contain at least one agent");
     }
     if (!this.defaultSubAgent) {
       errors.push("Graph must have a default agent");
     }
     const names = /* @__PURE__ */ new Set();
-    for (const agent2 of this.agents) {
-      const name = agent2.getName();
+    for (const agent of this.subAgents) {
+      const name = agent.getName();
       if (names.has(name)) {
         errors.push(`Duplicate agent name: ${name}`);
       }
       names.add(name);
     }
-    for (const agent2 of this.agents) {
-      if (!this.isInternalAgent(agent2)) continue;
-      const transfers = agent2.getTransfers();
+    for (const agent of this.subAgents) {
+      if (!this.isInternalAgent(agent)) continue;
+      const transfers = agent.getTransfers();
       for (const transferAgent of transfers) {
         if (!this.agentMap.has(transferAgent.getName())) {
           errors.push(
-            `Agent '${agent2.getName()}' has transfer to '${transferAgent.getName()}' which is not in the graph`
+            `Agent '${agent.getName()}' has transfer to '${transferAgent.getName()}' which is not in the graph`
           );
         }
       }
-      const delegates = agent2.getDelegates();
+      const delegates = agent.getDelegates();
       for (const delegateAgent of delegates) {
         if (!this.agentMap.has(delegateAgent.getName())) {
           errors.push(
-            `Agent '${agent2.getName()}' has delegation to '${delegateAgent.getName()}' which is not in the graph`
+            `Agent '${agent.getName()}' has delegation to '${delegateAgent.getName()}' which is not in the graph`
           );
         }
       }
@@ -2170,8 +2167,8 @@ var AgentGraph = class {
   /**
    * Type guard to check if an agent is an internal AgentInterface
    */
-  isInternalAgent(agent2) {
-    return "getTransfers" in agent2 && typeof agent2.getTransfers === "function";
+  isInternalAgent(agent) {
+    return "getTransfers" in agent && typeof agent.getTransfers === "function";
   }
   /**
    * Get project-level model settingsuration defaults
@@ -2235,9 +2232,9 @@ var AgentGraph = class {
       }
     }
     await this.applyStopWhenInheritance();
-    for (const agent2 of this.agents) {
-      if (this.isInternalAgent(agent2)) {
-        this.propagateModelSettingsToAgent(agent2);
+    for (const agent of this.subAgents) {
+      if (this.isInternalAgent(agent)) {
+        this.propagateModelSettingsToAgent(agent);
       }
     }
   }
@@ -2256,9 +2253,9 @@ var AgentGraph = class {
       this.stopWhen.transferCountIs = 10;
     }
     if (projectStopWhen?.stepCountIs !== void 0) {
-      for (const agent2 of this.agents) {
-        if (this.isInternalAgent(agent2)) {
-          const internalAgent = agent2;
+      for (const agent of this.subAgents) {
+        if (this.isInternalAgent(agent)) {
+          const internalAgent = agent;
           if (!internalAgent.config.stopWhen) {
             internalAgent.config.stopWhen = {};
           }
@@ -2280,19 +2277,19 @@ var AgentGraph = class {
   /**
    * Propagate graph-level model settings to agents (supporting partial inheritance)
    */
-  propagateModelSettingsToAgent(agent2) {
+  propagateModelSettingsToAgent(agent) {
     if (this.models) {
-      if (!agent2.config.models) {
-        agent2.config.models = {};
+      if (!agent.config.models) {
+        agent.config.models = {};
       }
-      if (!agent2.config.models.base && this.models.base) {
-        agent2.config.models.base = this.models.base;
+      if (!agent.config.models.base && this.models.base) {
+        agent.config.models.base = this.models.base;
       }
-      if (!agent2.config.models.structuredOutput && this.models.structuredOutput) {
-        agent2.config.models.structuredOutput = this.models.structuredOutput;
+      if (!agent.config.models.structuredOutput && this.models.structuredOutput) {
+        agent.config.models.structuredOutput = this.models.structuredOutput;
       }
-      if (!agent2.config.models.summarizer && this.models.summarizer) {
-        agent2.config.models.summarizer = this.models.summarizer;
+      if (!agent.config.models.summarizer && this.models.summarizer) {
+        agent.config.models.summarizer = this.models.summarizer;
       }
     }
   }
@@ -2300,17 +2297,17 @@ var AgentGraph = class {
    * Immediately propagate graph-level models to all agents during construction
    */
   propagateImmediateModelSettings() {
-    for (const agent2 of this.agents) {
-      if (this.isInternalAgent(agent2)) {
-        this.propagateModelSettingsToAgent(agent2);
+    for (const agent of this.subAgents) {
+      if (this.isInternalAgent(agent)) {
+        this.propagateModelSettingsToAgent(agent);
       }
     }
   }
   /**
    * Type guard to check if an agent is an external AgentInterface
    */
-  isExternalAgent(agent2) {
-    return !this.isInternalAgent(agent2);
+  isExternalAgent(agent) {
+    return !this.isInternalAgent(agent);
   }
   /**
    * Execute agent using the backend system instead of local runner
@@ -2479,21 +2476,21 @@ var AgentGraph = class {
   }
   async createAgentRelations() {
     const allRelationPromises = [];
-    for (const agent2 of this.agents) {
-      if (this.isInternalAgent(agent2)) {
-        const transfers = agent2.getTransfers();
+    for (const agent of this.subAgents) {
+      if (this.isInternalAgent(agent)) {
+        const transfers = agent.getTransfers();
         for (const transferAgent of transfers) {
           allRelationPromises.push(
-            this.createInternalAgentRelation(agent2, transferAgent, "transfer")
+            this.createInternalAgentRelation(agent, transferAgent, "transfer")
           );
         }
-        const delegates = agent2.getDelegates();
+        const delegates = agent.getDelegates();
         for (const delegate of delegates) {
           if (delegate.type === "external") {
-            allRelationPromises.push(this.createExternalAgentRelation(agent2, delegate, "delegate"));
+            allRelationPromises.push(this.createExternalAgentRelation(agent, delegate, "delegate"));
           } else {
             allRelationPromises.push(
-              this.createInternalAgentRelation(agent2, delegate, "delegate")
+              this.createInternalAgentRelation(agent, delegate, "delegate")
             );
           }
         }
@@ -2641,7 +2638,7 @@ var AgentGraph = class {
    * Create external agents in the database
    */
   async createExternalAgents() {
-    const externalAgents2 = this.agents.filter((agent2) => this.isExternalAgent(agent2));
+    const externalAgents2 = this.subAgents.filter((agent) => this.isExternalAgent(agent));
     logger8.info(
       {
         graphId: this.graphId,
@@ -3313,11 +3310,11 @@ var Project = class {
           }
         }
       }
-      for (const agent2 of graph.getAgents()) {
-        if (agent2.type === "external") {
+      for (const agent of graph.getSubAgents()) {
+        if (agent.type === "external") {
           continue;
         }
-        const agentTools = agent2.getTools();
+        const agentTools = agent.getTools();
         for (const [, toolInstance] of Object.entries(agentTools)) {
           const actualTool = toolInstance;
           const toolId = actualTool.getId();
@@ -3376,7 +3373,7 @@ var Project = class {
             }
           }
         }
-        const subAgentDataComponents = agent2.getDataComponents?.();
+        const subAgentDataComponents = agent.getDataComponents?.();
         if (subAgentDataComponents) {
           for (const dataComponent2 of subAgentDataComponents) {
             let dataComponentId;
@@ -3404,7 +3401,7 @@ var Project = class {
             }
           }
         }
-        const subAgentArtifactComponents = agent2.getArtifactComponents?.();
+        const subAgentArtifactComponents = agent.getArtifactComponents?.();
         if (subAgentArtifactComponents) {
           for (const artifactComponent2 of subAgentArtifactComponents) {
             let artifactComponentId;
@@ -3534,13 +3531,13 @@ function agentGraph(config) {
 function project(config) {
   return new Project(config);
 }
-function agent(config) {
+function subAgent(config) {
   if (!config.id) {
     throw new Error(
-      "Agent ID is required. Agents must have stable IDs for consistency across deployments."
+      "Sub-Agent ID is required. Sub-Agents must have stable IDs for consistency across deployments."
     );
   }
-  return new Agent(config);
+  return new SubAgent(config);
 }
 function credential(config) {
   return agentsCore.CredentialReferenceApiInsertSchema.parse(config);
@@ -3595,17 +3592,6 @@ function functionTool(config) {
   return new FunctionTool(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") {
@@ -3615,7 +3601,7 @@ function validateFunction(value, name) {
 
 // src/builders.ts
 var TransferConfigSchema = zod.z.object({
-  agent: zod.z.instanceof(Agent),
+  agent: zod.z.instanceof(SubAgent),
   description: zod.z.string().optional()
 });
 function transfer(targetAgent, description, condition) {
@@ -3634,6 +3620,17 @@ function transfer(targetAgent, description, condition) {
   return 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/environment-settings.ts
 function createEnvironmentSettings(environments) {
   return {
@@ -3984,12 +3981,12 @@ var Runner = class _Runner {
         errors.push("Default agent instructions are required");
       }
     }
-    const agents = graph.getAgents();
+    const agents = graph.getSubAgents();
     if (agents.length === 0) {
       errors.push("Graph must contain at least one agent");
     }
-    for (const agent2 of agents) {
-      if (!agent2.getName()) {
+    for (const agent of agents) {
+      if (!agent.getName()) {
         errors.push(`Agent missing name`);
       }
     }
@@ -4002,7 +3999,7 @@ var Runner = class _Runner {
    * Get execution statistics for a graph
    */
   static async getExecutionStats(graph, messages, options) {
-    const agents = graph.getAgents();
+    const agents = graph.getSubAgents();
     const defaultSubAgent = graph.getdefaultSubAgent();
     const messageCount = Array.isArray(messages) ? messages.length : 1;
     return {
@@ -4018,7 +4015,7 @@ var run = Runner.run.bind(Runner);
 var stream = Runner.stream.bind(Runner);
 var raceGraphs = Runner.raceGraphs.bind(Runner);
 
-exports.Agent = Agent;
+exports.Agent = SubAgent;
 exports.ArtifactComponent = ArtifactComponent;
 exports.DataComponent = DataComponent;
 exports.ExternalAgent = ExternalAgent;
@@ -4026,7 +4023,7 @@ exports.FunctionTool = FunctionTool;
 exports.Project = Project;
 exports.Runner = Runner;
 exports.Tool = Tool;
-exports.agent = agent;
+exports.agent = subAgent;
 exports.agentGraph = agentGraph;
 exports.agentMcp = agentMcp;
 exports.artifactComponent = artifactComponent;