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

package/dist/index.js

@@ -689,20 +689,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,
@@ -712,11 +710,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;
     }
@@ -1492,7 +1489,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");
@@ -1529,10 +1526,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) {
@@ -1542,7 +1539,7 @@ var AgentGraph = class {
       {
         graphId: this.graphId,
         tenantId: this.tenantId,
-        agentCount: this.agents.length,
+        agentCount: this.subAgents.length,
         defaultSubAgent: this.defaultSubAgent?.getName()
       },
       "AgentGraph created"
@@ -1559,9 +1556,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);
         }
@@ -1574,7 +1571,7 @@ var AgentGraph = class {
           }
         }
       } else {
-        const externalAgent2 = agent2;
+        const externalAgent2 = agent;
         if (externalAgent2.setContext) {
           externalAgent2.setContext(tenantId, apiUrl);
         }
@@ -1598,9 +1595,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 = [];
@@ -1653,7 +1650,7 @@ var AgentGraph = class {
           type: "internal"
         };
       } else {
-        const externalAgent2 = agent2;
+        const externalAgent2 = agent;
         agentsObject[externalAgent2.getId()] = {
           id: externalAgent2.getId(),
           name: externalAgent2.getName(),
@@ -1685,11 +1682,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") {
@@ -1709,7 +1706,7 @@ var AgentGraph = class {
                   }
                   logger8.debug(
                     {
-                      subAgentId: agent2.getId(),
+                      subAgentId: agent.getId(),
                       toolName,
                       toolType: toolInstance.constructor.name,
                       skipDbRegistration
@@ -1719,7 +1716,7 @@ var AgentGraph = class {
                 } catch (error) {
                   logger8.error(
                     {
-                      subAgentId: agent2.getId(),
+                      subAgentId: agent.getId(),
                       toolName,
                       error: error instanceof Error ? error.message : "Unknown error"
                     },
@@ -1750,7 +1747,7 @@ var AgentGraph = class {
     logger8.info(
       {
         graphId: this.graphId,
-        agentCount: this.agents.length
+        agentCount: this.subAgents.length
       },
       "Initializing agent graph using new graph endpoint"
     );
@@ -1804,7 +1801,7 @@ var AgentGraph = class {
     logger8.info(
       {
         graphId: this.graphId,
-        agentCount: this.agents.length
+        agentCount: this.subAgents.length
       },
       "Initializing agent graph"
     );
@@ -1819,13 +1816,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"
@@ -1833,7 +1830,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"
             },
@@ -1851,7 +1848,7 @@ var AgentGraph = class {
       logger8.info(
         {
           graphId: this.graphId,
-          agentCount: this.agents.length
+          agentCount: this.subAgents.length
         },
         "Agent graph initialized successfully"
       );
@@ -1923,11 +1920,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.`
       );
@@ -1943,7 +1940,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: {
@@ -1961,17 +1958,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"
     );
@@ -1979,11 +1976,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,
@@ -1998,25 +1995,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"
     );
@@ -2083,7 +2080,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,
@@ -2095,35 +2092,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`
           );
         }
       }
@@ -2142,8 +2139,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
@@ -2207,9 +2204,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);
       }
     }
   }
@@ -2228,9 +2225,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 = {};
           }
@@ -2252,19 +2249,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;
       }
     }
   }
@@ -2272,17 +2269,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
@@ -2451,21 +2448,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")
             );
           }
         }
@@ -2613,7 +2610,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,
@@ -3285,11 +3282,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();
@@ -3348,7 +3345,7 @@ var Project = class {
             }
           }
         }
-        const subAgentDataComponents = agent2.getDataComponents?.();
+        const subAgentDataComponents = agent.getDataComponents?.();
         if (subAgentDataComponents) {
           for (const dataComponent2 of subAgentDataComponents) {
             let dataComponentId;
@@ -3376,7 +3373,7 @@ var Project = class {
             }
           }
         }
-        const subAgentArtifactComponents = agent2.getArtifactComponents?.();
+        const subAgentArtifactComponents = agent.getArtifactComponents?.();
         if (subAgentArtifactComponents) {
           for (const artifactComponent2 of subAgentArtifactComponents) {
             let artifactComponentId;
@@ -3506,13 +3503,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 CredentialReferenceApiInsertSchema.parse(config);
@@ -3567,17 +3564,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") {
@@ -3587,7 +3573,7 @@ function validateFunction(value, name) {
 
 // src/builders.ts
 var TransferConfigSchema = z.object({
-  agent: z.instanceof(Agent),
+  agent: z.instanceof(SubAgent),
   description: z.string().optional()
 });
 function transfer(targetAgent, description, condition) {
@@ -3606,6 +3592,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 {
@@ -3956,12 +3953,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`);
       }
     }
@@ -3974,7 +3971,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 {
@@ -3990,4 +3987,4 @@ var run = Runner.run.bind(Runner);
 var stream = Runner.stream.bind(Runner);
 var raceGraphs = Runner.raceGraphs.bind(Runner);
 
-export { Agent, ArtifactComponent, DataComponent, ExternalAgent, FunctionTool, Project, Runner, Tool, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { SubAgent as Agent, ArtifactComponent, DataComponent, ExternalAgent, FunctionTool, Project, Runner, Tool, subAgent as agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, functionTool, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.0.0-dev-20251009233425",
+  "version": "0.0.0-dev-20251010064032",
   "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.0.0-dev-20251009233425"
+    "@inkeep/agents-core": "^0.0.0-dev-20251010064032"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",