@inkeep/agents-run-api 0.18.0 → 0.19.0

package/dist/index.cjs

@@ -228,7 +228,7 @@ async function getScopedHistory({
       let matchesAgent = true;
       let matchesTask = true;
       if (filters.subAgentId) {
-        matchesAgent = msg.role === "agent" && msg.visibility === "user-facing" || msg.toAgentId === filters.subAgentId || msg.fromAgentId === filters.subAgentId;
+        matchesAgent = msg.role === "agent" && msg.visibility === "user-facing" || msg.toSubAgentId === filters.subAgentId || msg.fromSubAgentId === filters.subAgentId;
       }
       if (filters.taskId) {
         matchesTask = msg.taskId === filters.taskId || msg.a2aTaskId === filters.taskId;
@@ -303,12 +303,12 @@ async function getFormattedConversationHistory({
     if (msg.role === "user") {
       roleLabel = "user";
     } else if (msg.role === "agent" && (msg.messageType === "a2a-request" || msg.messageType === "a2a-response")) {
-      const fromAgent = msg.fromAgentId || msg.fromExternalAgentId || "unknown";
-      const toAgent = msg.toAgentId || msg.toExternalAgentId || "unknown";
-      roleLabel = `${fromAgent} to ${toAgent}`;
+      const fromSubAgent = msg.fromSubAgentId || msg.fromExternalAgentId || "unknown";
+      const toSubAgent = msg.toSubAgentId || msg.toExternalAgentId || "unknown";
+      roleLabel = `${fromSubAgent} to ${toSubAgent}`;
     } else if (msg.role === "agent" && msg.messageType === "chat") {
-      const fromAgent = msg.fromAgentId || "unknown";
-      roleLabel = `${fromAgent} to User`;
+      const fromSubAgent = msg.fromSubAgentId || "unknown";
+      roleLabel = `${fromSubAgent} to User`;
     } else {
       roleLabel = msg.role || "system";
     }
@@ -389,10 +389,62 @@ var LocalSandboxExecutor_exports = {};
 __export(LocalSandboxExecutor_exports, {
   LocalSandboxExecutor: () => LocalSandboxExecutor
 });
-var logger17, _LocalSandboxExecutor, LocalSandboxExecutor;
+var logger17, ExecutionSemaphore, _LocalSandboxExecutor, LocalSandboxExecutor;
 var init_LocalSandboxExecutor = __esm({
   "src/tools/LocalSandboxExecutor.ts"() {
     logger17 = agentsCore.getLogger("local-sandbox-executor");
+    ExecutionSemaphore = class {
+      constructor(permits, maxWaitTimeMs = 3e4) {
+        __publicField(this, "permits");
+        __publicField(this, "waitQueue", []);
+        __publicField(this, "maxWaitTime");
+        this.permits = Math.max(1, permits);
+        this.maxWaitTime = maxWaitTimeMs;
+      }
+      async acquire(fn) {
+        await new Promise((resolve, reject) => {
+          if (this.permits > 0) {
+            this.permits--;
+            resolve();
+            return;
+          }
+          const timeoutId = setTimeout(() => {
+            const index = this.waitQueue.findIndex((item) => item.resolve === resolve);
+            if (index !== -1) {
+              this.waitQueue.splice(index, 1);
+              reject(
+                new Error(
+                  `Function execution queue timeout after ${this.maxWaitTime}ms. Too many concurrent executions.`
+                )
+              );
+            }
+          }, this.maxWaitTime);
+          this.waitQueue.push({
+            resolve: () => {
+              clearTimeout(timeoutId);
+              this.permits--;
+              resolve();
+            },
+            reject
+          });
+        });
+        try {
+          return await fn();
+        } finally {
+          this.permits++;
+          const next = this.waitQueue.shift();
+          if (next) {
+            next.resolve();
+          }
+        }
+      }
+      getAvailablePermits() {
+        return this.permits;
+      }
+      getQueueLength() {
+        return this.waitQueue.length;
+      }
+    };
     _LocalSandboxExecutor = class _LocalSandboxExecutor {
       constructor() {
         __publicField(this, "tempDir");
@@ -400,6 +452,7 @@ var init_LocalSandboxExecutor = __esm({
         __publicField(this, "POOL_TTL", 5 * 60 * 1e3);
         // 5 minutes
         __publicField(this, "MAX_USE_COUNT", 50);
+        __publicField(this, "executionSemaphores", /* @__PURE__ */ new Map());
         this.tempDir = path.join(os.tmpdir(), "inkeep-sandboxes");
         this.ensureTempDir();
         this.startPoolCleanup();
@@ -410,6 +463,34 @@ var init_LocalSandboxExecutor = __esm({
         }
         return _LocalSandboxExecutor.instance;
       }
+      /**
+       * Get or create a semaphore for the specified vCPU limit
+       */
+      getSemaphore(vcpus) {
+        const effectiveVcpus = Math.max(1, vcpus || 1);
+        if (!this.executionSemaphores.has(effectiveVcpus)) {
+          logger17.debug({ vcpus: effectiveVcpus }, "Creating new execution semaphore");
+          this.executionSemaphores.set(effectiveVcpus, new ExecutionSemaphore(effectiveVcpus));
+        }
+        const semaphore = this.executionSemaphores.get(effectiveVcpus);
+        if (!semaphore) {
+          throw new Error(`Failed to create semaphore for ${effectiveVcpus} vCPUs`);
+        }
+        return semaphore;
+      }
+      /**
+       * Get execution statistics for monitoring and debugging
+       */
+      getExecutionStats() {
+        const stats = {};
+        for (const [vcpus, semaphore] of this.executionSemaphores.entries()) {
+          stats[`vcpu_${vcpus}`] = {
+            availablePermits: semaphore.getAvailablePermits(),
+            queueLength: semaphore.getQueueLength()
+          };
+        }
+        return stats;
+      }
       ensureTempDir() {
         try {
           fs.mkdirSync(this.tempDir, { recursive: true });
@@ -484,7 +565,7 @@ var init_LocalSandboxExecutor = __esm({
           }
         }, 6e4);
       }
-      detectModuleType(executeCode) {
+      detectModuleType(executeCode, configuredRuntime) {
         const esmPatterns = [
           /import\s+.*\s+from\s+['"]/g,
           // import ... from '...'
@@ -505,6 +586,9 @@ var init_LocalSandboxExecutor = __esm({
         ];
         const hasEsmSyntax = esmPatterns.some((pattern) => pattern.test(executeCode));
         const hasCjsSyntax = cjsPatterns.some((pattern) => pattern.test(executeCode));
+        if (configuredRuntime === "typescript") {
+          return hasCjsSyntax ? "cjs" : "esm";
+        }
         if (hasEsmSyntax && hasCjsSyntax) {
           logger17.warn(
             { executeCode: `${executeCode.substring(0, 100)}...` },
@@ -521,6 +605,24 @@ var init_LocalSandboxExecutor = __esm({
         return "cjs";
       }
       async executeFunctionTool(toolId, args, config) {
+        const vcpus = config.sandboxConfig?.vcpus || 1;
+        const semaphore = this.getSemaphore(vcpus);
+        logger17.debug(
+          {
+            toolId,
+            vcpus,
+            availablePermits: semaphore.getAvailablePermits(),
+            queueLength: semaphore.getQueueLength(),
+            sandboxConfig: config.sandboxConfig,
+            poolSize: Object.keys(this.sandboxPool).length
+          },
+          "Acquiring execution slot for function tool"
+        );
+        return semaphore.acquire(async () => {
+          return this.executeInSandbox_Internal(toolId, args, config);
+        });
+      }
+      async executeInSandbox_Internal(toolId, args, config) {
         const dependencies = config.dependencies || {};
         const dependencyHash = this.generateDependencyHash(dependencies);
         logger17.debug(
@@ -528,6 +630,7 @@ var init_LocalSandboxExecutor = __esm({
             toolId,
             dependencies,
             dependencyHash,
+            sandboxConfig: config.sandboxConfig,
             poolSize: Object.keys(this.sandboxPool).length
           },
           "Executing function tool"
@@ -547,7 +650,7 @@ var init_LocalSandboxExecutor = __esm({
             },
             "Creating new sandbox"
           );
-          const moduleType = this.detectModuleType(config.executeCode);
+          const moduleType = this.detectModuleType(config.executeCode, config.sandboxConfig?.runtime);
           const packageJson = {
             name: `function-tool-${toolId}`,
             version: "1.0.0",
@@ -564,14 +667,15 @@ var init_LocalSandboxExecutor = __esm({
           this.addToPool(dependencyHash, sandboxDir, dependencies);
         }
         try {
-          const moduleType = this.detectModuleType(config.executeCode);
+          const moduleType = this.detectModuleType(config.executeCode, config.sandboxConfig?.runtime);
           const executionCode = this.wrapFunctionCode(config.executeCode, args);
           const fileExtension = moduleType === "esm" ? "mjs" : "js";
           fs.writeFileSync(path.join(sandboxDir, `index.${fileExtension}`), executionCode, "utf8");
           const result = await this.executeInSandbox(
             sandboxDir,
             config.sandboxConfig?.timeout || 3e4,
-            moduleType
+            moduleType,
+            config.sandboxConfig
           );
           return result;
         } catch (error) {
@@ -610,7 +714,7 @@ var init_LocalSandboxExecutor = __esm({
           });
         });
       }
-      async executeInSandbox(sandboxDir, timeout, moduleType) {
+      async executeInSandbox(sandboxDir, timeout, moduleType, _sandboxConfig) {
         return new Promise((resolve, reject) => {
           const fileExtension = moduleType === "esm" ? "mjs" : "js";
           const spawnOptions = {
@@ -648,12 +752,13 @@ var init_LocalSandboxExecutor = __esm({
           const timeoutId = setTimeout(() => {
             logger17.warn({ sandboxDir, timeout }, "Function execution timed out, killing process");
             node.kill("SIGTERM");
+            const forceKillTimeout = Math.min(Math.max(timeout / 10, 2e3), 5e3);
             setTimeout(() => {
               try {
                 node.kill("SIGKILL");
               } catch {
               }
-            }, 5e3);
+            }, forceKillTimeout);
             reject(new Error(`Function execution timed out after ${timeout}ms`));
           }, timeout);
           node.on("close", (code, signal) => {
@@ -819,7 +924,7 @@ function createExecutionContext(params) {
     apiKey: params.apiKey,
     tenantId: params.tenantId,
     projectId: params.projectId,
-    graphId: params.graphId,
+    agentId: params.agentId,
     baseUrl: params.baseUrl || process.env.API_URL || "http://localhost:3003",
     apiKeyId: params.apiKeyId,
     subAgentId: params.subAgentId
@@ -836,8 +941,8 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
   const authHeader = c.req.header("Authorization");
   const tenantId = c.req.header("x-inkeep-tenant-id");
   const projectId = c.req.header("x-inkeep-project-id");
-  const graphId = c.req.header("x-inkeep-graph-id");
-  const subAgentId = c.req.header("x-inkeep-agent-id");
+  const agentId = c.req.header("x-inkeep-agent-id");
+  const subAgentId = c.req.header("x-inkeep-sub-agent-id");
   const proto = c.req.header("x-forwarded-proto")?.split(",")[0].trim();
   const fwdHost = c.req.header("x-forwarded-host")?.split(",")[0].trim();
   const host = fwdHost ?? c.req.header("host");
@@ -855,7 +960,7 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
           apiKey: "development",
           tenantId: tenantId || "test-tenant",
           projectId: projectId || "test-project",
-          graphId: graphId || "test-graph",
+          agentId: agentId || "test-agent",
           apiKeyId: "test-key",
           baseUrl,
           subAgentId
@@ -870,7 +975,7 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
         apiKey: "development",
         tenantId: tenantId || "test-tenant",
         projectId: projectId || "test-project",
-        graphId: graphId || "test-graph",
+        agentId: agentId || "test-agent",
         apiKeyId: "test-key",
         baseUrl,
         subAgentId
@@ -892,16 +997,16 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
   const apiKey = authHeader.substring(7);
   if (env.INKEEP_AGENTS_RUN_API_BYPASS_SECRET) {
     if (apiKey === env.INKEEP_AGENTS_RUN_API_BYPASS_SECRET) {
-      if (!tenantId || !projectId || !graphId) {
+      if (!tenantId || !projectId || !agentId) {
         throw new httpException.HTTPException(401, {
-          message: "Missing or invalid tenant, project, or graph ID"
+          message: "Missing or invalid tenant, project, or agent ID"
         });
       }
       const executionContext = createExecutionContext({
         apiKey,
         tenantId,
         projectId,
-        graphId,
+        agentId,
         apiKeyId: "bypass",
         baseUrl,
         subAgentId
@@ -936,7 +1041,7 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
       {
         tenantId: executionContext.tenantId,
         projectId: executionContext.projectId,
-        graphId: executionContext.graphId,
+        agentId: executionContext.agentId,
         subAgentId: executionContext.subAgentId
       },
       "API key authenticated successfully"
@@ -963,7 +1068,7 @@ var extractContextFromApiKey = async (apiKey, baseUrl) => {
     apiKey,
     tenantId: apiKeyRecord.tenantId,
     projectId: apiKeyRecord.projectId,
-    graphId: apiKeyRecord.graphId,
+    agentId: apiKeyRecord.agentId,
     apiKeyId: apiKeyRecord.id,
     baseUrl
   });
@@ -1066,7 +1171,7 @@ async function handleMessageSend(c, agent, request) {
   try {
     const params = request.params;
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { graphId } = executionContext;
+    const { agentId } = executionContext;
     const task = {
       id: nanoid.nanoid(),
       input: {
@@ -1080,7 +1185,7 @@ async function handleMessageSend(c, agent, request) {
         conversationId: params.message.contextId,
         metadata: {
           blocking: params.configuration?.blocking ?? false,
-          custom: { graph_id: graphId || "" },
+          custom: { agent_id: agentId || "" },
           // Pass through streaming metadata from the original message
           ...params.message.metadata
         }
@@ -1141,7 +1246,7 @@ async function handleMessageSend(c, agent, request) {
       id: task.id,
       tenantId: agent.tenantId,
       projectId: agent.projectId,
-      graphId: graphId || "",
+      agentId: agentId || "",
       contextId: effectiveContextId,
       status: "working",
       metadata: {
@@ -1149,8 +1254,8 @@ async function handleMessageSend(c, agent, request) {
         message_id: params.message.messageId || "",
         created_at: (/* @__PURE__ */ new Date()).toISOString(),
         updated_at: (/* @__PURE__ */ new Date()).toISOString(),
-        agent_id: agent.subAgentId,
-        graph_id: graphId || "",
+        sub_agent_id: agent.subAgentId,
+        agent_id: agentId || "",
         stream_request_id: params.message.metadata?.stream_request_id
       },
       subAgentId: agent.subAgentId,
@@ -1158,7 +1263,7 @@ async function handleMessageSend(c, agent, request) {
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
     logger3.info({ metadata: params.message.metadata }, "message metadata");
-    if (params.message.metadata?.fromAgentId || params.message.metadata?.fromExternalAgentId) {
+    if (params.message.metadata?.fromSubAgentId || params.message.metadata?.fromExternalAgentId) {
       const messageText = params.message.parts.filter((part) => part.kind === "text" && "text" in part && part.text).map((part) => part.text).join(" ");
       try {
         const messageData = {
@@ -1174,19 +1279,19 @@ async function handleMessageSend(c, agent, request) {
           messageType: "a2a-request",
           taskId: task.id
         };
-        if (params.message.metadata?.fromAgentId) {
-          messageData.fromAgentId = params.message.metadata.fromAgentId;
-          messageData.toAgentId = agent.subAgentId;
+        if (params.message.metadata?.fromSubAgentId) {
+          messageData.fromSubAgentId = params.message.metadata.fromSubAgentId;
+          messageData.toSubAgentId = agent.subAgentId;
         } else if (params.message.metadata?.fromExternalAgentId) {
           messageData.fromExternalAgentId = params.message.metadata.fromExternalAgentId;
-          messageData.toAgentId = agent.subAgentId;
+          messageData.toSubAgentId = agent.subAgentId;
         }
         await agentsCore.createMessage(dbClient_default)(messageData);
         logger3.info(
           {
-            fromAgentId: params.message.metadata.fromAgentId,
+            fromSubAgentId: params.message.metadata.fromSubAgentId,
             fromExternalAgentId: params.message.metadata.fromExternalAgentId,
-            toAgentId: agent.subAgentId,
+            toSubAgentId: agent.subAgentId,
             conversationId: effectiveContextId,
             messageType: "a2a-request",
             taskId: task.id
@@ -1197,9 +1302,9 @@ async function handleMessageSend(c, agent, request) {
         logger3.error(
           {
             error,
-            fromAgentId: params.message.metadata.fromAgentId,
+            fromSubAgentId: params.message.metadata.fromSubAgentId,
             fromExternalAgentId: params.message.metadata.fromExternalAgentId,
-            toAgentId: agent.subAgentId,
+            toSubAgentId: agent.subAgentId,
             conversationId: effectiveContextId
           },
           "Failed to store A2A message in database"
@@ -1216,8 +1321,8 @@ async function handleMessageSend(c, agent, request) {
           message_id: params.message.messageId || "",
           created_at: (/* @__PURE__ */ new Date()).toISOString(),
           updated_at: (/* @__PURE__ */ new Date()).toISOString(),
-          agent_id: agent.subAgentId,
-          graph_id: graphId || ""
+          sub_agent_id: agent.subAgentId,
+          agent_id: agentId || ""
         }
       }
     });
@@ -1250,7 +1355,8 @@ async function handleMessageSend(c, agent, request) {
                     kind: "data",
                     data: {
                       type: "transfer",
-                      targetSubAgentId: transferPart.data.target
+                      targetSubAgentId: transferPart.data.targetSubAgentId,
+                      fromSubAgentId: transferPart.data.fromSubAgentId
                     }
                   },
                   {
@@ -1318,7 +1424,7 @@ async function handleMessageStream(c, agent, request) {
   try {
     const params = request.params;
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { graphId } = executionContext;
+    const { agentId } = executionContext;
     if (!agent.agentCard.capabilities.streaming) {
       return c.json({
         jsonrpc: "2.0",
@@ -1343,7 +1449,7 @@ async function handleMessageStream(c, agent, request) {
         metadata: {
           blocking: false,
           // Streaming is always non-blocking
-          custom: { graph_id: graphId || "" }
+          custom: { agent_id: agentId || "" }
         }
       }
     };
@@ -1382,7 +1488,7 @@ async function handleMessageStream(c, agent, request) {
                 jsonrpc: "2.0",
                 result: {
                   type: "transfer",
-                  target: transferPart.data.target,
+                  target: transferPart.data.targetSubAgentId,
                   task_id: task.id,
                   reason: transferPart.data.reason || "Agent requested transfer",
                   original_message: transferPart.data.original_message,
@@ -1614,129 +1720,6 @@ async function handleTasksResubscribe(c, agent, request) {
   }
 }
 init_dbClient();
-function createAgentCard({
-  dbAgent,
-  baseUrl
-}) {
-  const description = dbAgent.description || "AI Agent";
-  return {
-    name: dbAgent.name,
-    description,
-    url: baseUrl ? `${baseUrl}/a2a` : "",
-    version: "1.0.0",
-    capabilities: {
-      streaming: true,
-      // Enable streaming for A2A compliance
-      pushNotifications: false,
-      stateTransitionHistory: false
-    },
-    defaultInputModes: ["text", "text/plain"],
-    defaultOutputModes: ["text", "text/plain"],
-    skills: [],
-    // Add provider info if available
-    ...baseUrl && {
-      provider: {
-        organization: "Inkeep",
-        url: baseUrl
-      }
-    }
-  };
-}
-function generateDescriptionWithTransfers(baseDescription, internalRelations, externalRelations) {
-  const transfers = [
-    ...internalRelations.filter((rel) => rel.relationType === "transfer"),
-    ...externalRelations.filter((rel) => rel.relationType === "transfer")
-  ];
-  const delegates = [
-    ...internalRelations.filter((rel) => rel.relationType === "delegate"),
-    ...externalRelations.filter((rel) => rel.relationType === "delegate")
-  ];
-  if (transfers.length === 0 && delegates.length === 0) {
-    return baseDescription;
-  }
-  let enhancedDescription = baseDescription;
-  if (transfers.length > 0) {
-    const transferList = transfers.map((rel) => {
-      const name = rel.externalAgent?.name || rel.name;
-      const desc = rel.externalAgent?.description || rel.description || "";
-      return `- ${name}: ${desc}`;
-    }).join("\n");
-    enhancedDescription += `
-
-Can transfer to:
-${transferList}`;
-  }
-  if (delegates.length > 0) {
-    const delegateList = delegates.map((rel) => {
-      const name = rel.externalAgent?.name || rel.name;
-      const desc = rel.externalAgent?.description || rel.description || "";
-      return `- ${name}: ${desc}`;
-    }).join("\n");
-    enhancedDescription += `
-
-Can delegate to:
-${delegateList}`;
-  }
-  return enhancedDescription;
-}
-async function hydrateAgent({
-  dbAgent,
-  graphId,
-  baseUrl,
-  apiKey,
-  credentialStoreRegistry
-}) {
-  try {
-    const taskHandlerConfig = await createTaskHandlerConfig({
-      tenantId: dbAgent.tenantId,
-      projectId: dbAgent.projectId,
-      graphId,
-      subAgentId: dbAgent.id,
-      baseUrl,
-      apiKey
-    });
-    const taskHandler = createTaskHandler(taskHandlerConfig, credentialStoreRegistry);
-    const agentCard = createAgentCard({
-      dbAgent,
-      baseUrl
-    });
-    return {
-      subAgentId: dbAgent.id,
-      tenantId: dbAgent.tenantId,
-      projectId: dbAgent.projectId,
-      graphId,
-      agentCard,
-      taskHandler
-    };
-  } catch (error) {
-    console.error(`\u274C Failed to hydrate agent ${dbAgent.id}:`, error);
-    throw error;
-  }
-}
-async function getRegisteredAgent(executionContext, credentialStoreRegistry) {
-  const { tenantId, projectId, graphId, subAgentId, baseUrl, apiKey } = executionContext;
-  if (!subAgentId) {
-    throw new Error("Agent ID is required");
-  }
-  const dbAgent = await agentsCore.getSubAgentById(dbClient_default)({
-    scopes: { tenantId, projectId, graphId },
-    subAgentId
-  });
-  if (!dbAgent) {
-    return null;
-  }
-  const agentFrameworkBaseUrl = `${baseUrl}/agents`;
-  return hydrateAgent({
-    dbAgent,
-    graphId,
-    baseUrl: agentFrameworkBaseUrl,
-    credentialStoreRegistry,
-    apiKey
-  });
-}
-
-// src/agents/generateTaskHandler.ts
-init_dbClient();
 init_logger();
 
 // src/agents/ModelFactory.ts
@@ -1955,7 +1938,7 @@ var _ToolSessionManager = class _ToolSessionManager {
     return this.createSessionWithId(sessionId, tenantId, projectId, contextId, taskId);
   }
   /**
-   * Create a new tool session with a specific ID (for coordination with GraphSession)
+   * Create a new tool session with a specific ID (for coordination with AgentSession)
    */
   createSessionWithId(sessionId, tenantId, projectId, contextId, taskId) {
     const session = {
@@ -1981,17 +1964,17 @@ var _ToolSessionManager = class _ToolSessionManager {
     return sessionId;
   }
   /**
-   * Ensure a graph-scoped session exists (idempotent)
-   * All agents in the same graph execution share this session
+   * Ensure an agent-scoped session exists (idempotent)
+   * All agents in the same agent execution share this session
    */
-  ensureGraphSession(sessionId, tenantId, projectId, contextId, taskId) {
+  ensureAgentSession(sessionId, tenantId, projectId, contextId, taskId) {
     if (this.sessions.has(sessionId)) {
-      logger5.debug({ sessionId }, "Graph session already exists, reusing");
+      logger5.debug({ sessionId }, "Agent session already exists, reusing");
       return sessionId;
     }
     logger5.debug(
       { sessionId, tenantId, contextId, taskId },
-      "Creating new graph-scoped tool session"
+      "Creating new agent-scoped tool session"
     );
     return this.createSessionWithId(sessionId, tenantId, projectId, contextId, taskId);
   }
@@ -2101,7 +2084,7 @@ __publicField(_ToolSessionManager, "instance");
 var ToolSessionManager = _ToolSessionManager;
 var toolSessionManager = ToolSessionManager.getInstance();
 
-// src/services/GraphSession.ts
+// src/services/AgentSession.ts
 init_conversations();
 init_dbClient();
 init_logger();
@@ -2321,7 +2304,7 @@ var _ArtifactService = class _ArtifactService {
   async getArtifactSummary(artifactId, toolCallId, artifactMap) {
     const key = `${artifactId}:${toolCallId}`;
     if (this.context.streamRequestId) {
-      const cachedArtifact = await graphSessionManager.getArtifactCache(
+      const cachedArtifact = await agentSessionManager.getArtifactCache(
         this.context.streamRequestId,
         key
       );
@@ -2367,7 +2350,7 @@ var _ArtifactService = class _ArtifactService {
   async getArtifactFull(artifactId, toolCallId, artifactMap) {
     const key = `${artifactId}:${toolCallId}`;
     if (this.context.streamRequestId) {
-      const cachedArtifact = await graphSessionManager.getArtifactCache(
+      const cachedArtifact = await agentSessionManager.getArtifactCache(
         this.context.streamRequestId,
         key
       );
@@ -2434,12 +2417,12 @@ var _ArtifactService = class _ArtifactService {
     };
   }
   /**
-   * Persist artifact to database via graph session
+   * Persist artifact to database vian agent session
    */
   async persistArtifact(request, summaryData, fullData, subAgentId) {
     const effectiveAgentId = subAgentId || this.context.subAgentId;
     if (this.context.streamRequestId && effectiveAgentId && this.context.taskId) {
-      await graphSessionManager.recordEvent(
+      await agentSessionManager.recordEvent(
         this.context.streamRequestId,
         "artifact_saved",
         effectiveAgentId,
@@ -2491,7 +2474,7 @@ var _ArtifactService = class _ArtifactService {
     };
     this.createdArtifacts.set(cacheKey, artifactForCache);
     if (this.context.streamRequestId) {
-      await graphSessionManager.setArtifactCache(
+      await agentSessionManager.setArtifactCache(
         this.context.streamRequestId,
         cacheKey,
         artifactForCache
@@ -2523,7 +2506,7 @@ var _ArtifactService = class _ArtifactService {
   }
   /**
    * Save an already-created artifact directly to the database
-   * Used by GraphSession to save artifacts after name/description generation
+   * Used by AgentSession to save artifacts after name/description generation
    */
   async saveArtifact(artifact) {
     let summaryData = artifact.data;
@@ -3070,14 +3053,14 @@ __publicField(_ArtifactParser, "ARTIFACT_PATTERNS", [
 __publicField(_ArtifactParser, "INCOMPLETE_CREATE_REGEX", /<artifact:create(?![^>]*(?:\/>|<\/artifact:create>))/);
 var ArtifactParser = _ArtifactParser;
 
-// src/services/GraphSession.ts
-var logger9 = agentsCore.getLogger("GraphSession");
-var GraphSession = class {
+// src/services/AgentSession.ts
+var logger9 = agentsCore.getLogger("AgentSession");
+var AgentSession = class {
   // Whether to send data operations
-  constructor(sessionId, messageId, graphId, tenantId, projectId, contextId) {
+  constructor(sessionId, messageId, agentId, tenantId, projectId, contextId) {
     this.sessionId = sessionId;
     this.messageId = messageId;
-    this.graphId = graphId;
+    this.agentId = agentId;
     this.tenantId = tenantId;
     this.projectId = projectId;
     this.contextId = contextId;
@@ -3104,7 +3087,7 @@ var GraphSession = class {
     __publicField(this, "artifactParser");
     // Session-scoped ArtifactParser instance
     __publicField(this, "isEmitOperations", false);
-    logger9.debug({ sessionId, messageId, graphId }, "GraphSession created");
+    logger9.debug({ sessionId, messageId, agentId }, "AgentSession created");
     if (tenantId && projectId) {
       toolSessionManager.createSessionWithId(
         sessionId,
@@ -3140,7 +3123,7 @@ var GraphSession = class {
     this.isEmitOperations = true;
     logger9.info(
       { sessionId: this.sessionId },
-      "\u{1F50D} DEBUG: Emit operations enabled for GraphSession"
+      "\u{1F50D} DEBUG: Emit operations enabled for AgentSession"
     );
   }
   /**
@@ -3413,7 +3396,7 @@ var GraphSession = class {
     return {
       sessionId: this.sessionId,
       messageId: this.messageId,
-      graphId: this.graphId,
+      agentId: this.agentId,
       totalEvents: this.events.length,
       eventCounts,
       agentCounts,
@@ -3464,7 +3447,7 @@ var GraphSession = class {
     }
   }
   /**
-   * Generate and send a status update using graph-level summarizer
+   * Generate and send a status update using agent-level summarizer
    */
   async generateAndSendUpdate() {
     if (this.isEnded) {
@@ -3489,8 +3472,8 @@ var GraphSession = class {
       logger9.warn({ sessionId: this.sessionId }, "No status update state - cannot generate update");
       return;
     }
-    if (!this.graphId) {
-      logger9.warn({ sessionId: this.sessionId }, "No graph ID - cannot generate update");
+    if (!this.agentId) {
+      logger9.warn({ sessionId: this.sessionId }, "No agent ID - cannot generate update");
       return;
     }
     const newEventCount = this.events.length - this.statusUpdateState.lastEventCount;
@@ -3642,10 +3625,10 @@ var GraphSession = class {
    */
   async generateStructuredStatusUpdate(newEvents, elapsedTime, statusComponents, summarizerModel, previousSummaries = []) {
     return tracer.startActiveSpan(
-      "graph_session.generate_structured_update",
+      "agent_session.generate_structured_update",
       {
         attributes: {
-          "graph_session.id": this.sessionId,
+          "agent_session.id": this.sessionId,
           "events.count": newEvents.length,
           "elapsed_time.seconds": Math.round(elapsedTime / 1e3),
           "llm.model": summarizerModel?.model,
@@ -3726,7 +3709,7 @@ CRITICAL - HIDE ALL INTERNAL SYSTEM OPERATIONS:
 - ABSOLUTELY FORBIDDEN WORDS/PHRASES: "transfer", "transferring", "delegation", "delegating", "delegate", "agent", "routing", "route", "artifact", "saving artifact", "stored artifact", "artifact saved", "continuing", "passing to", "handing off", "switching to"
 - NEVER reveal internal architecture: No mentions of different agents, components, systems, or modules working together
 - NEVER mention artifact operations: Users don't need to know about data being saved, stored, or organized internally
-- NEVER describe handoffs or transitions: Present everything as one seamless operation
+- NEVER describe transfers or transitions: Present everything as one seamless operation
 - If you see "transfer", "delegation_sent", "delegation_returned", or "artifact_saved" events - IGNORE THEM or translate to user-facing information only
 - Focus ONLY on actual discoveries, findings, and results that matter to the user
 
@@ -3948,10 +3931,10 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
    */
   async processArtifact(artifactData) {
     return tracer.startActiveSpan(
-      "graph_session.process_artifact",
+      "agent_session.process_artifact",
       {
         attributes: {
-          "graph_session.id": this.sessionId,
+          "agent_session.id": this.sessionId,
           "artifact.id": artifactData.artifactId,
           "artifact.type": artifactData.artifactType || "unknown",
           "artifact.agent_id": artifactData.subAgentId || "unknown",
@@ -4019,7 +4002,7 @@ Make it specific and relevant.`;
                     scopes: {
                       tenantId: artifactData.tenantId,
                       projectId: artifactData.projectId,
-                      graphId: this.graphId || ""
+                      agentId: this.agentId || ""
                     },
                     subAgentId: artifactData.subAgentId
                   });
@@ -4074,7 +4057,7 @@ Make it specific and relevant.`;
               description: z6.z.string().describe("Brief description of the artifact's relevance to the user's question")
             });
             const { object } = await tracer.startActiveSpan(
-              "graph_session.generate_artifact_metadata",
+              "agent_session.generate_artifact_metadata",
               {
                 attributes: {
                   "llm.model": this.statusUpdateState?.summarizerModel?.model,
@@ -4284,20 +4267,20 @@ Make it specific and relevant.`;
     }
   }
 };
-var GraphSessionManager = class {
+var AgentSessionManager = class {
   constructor() {
     __publicField(this, "sessions", /* @__PURE__ */ new Map());
   }
   /**
    * Create a new session for a message
    */
-  createSession(messageId, graphId, tenantId, projectId, contextId) {
+  createSession(messageId, agentId, tenantId, projectId, contextId) {
     const sessionId = messageId;
-    const session = new GraphSession(sessionId, messageId, graphId, tenantId, projectId, contextId);
+    const session = new AgentSession(sessionId, messageId, agentId, tenantId, projectId, contextId);
     this.sessions.set(sessionId, session);
     logger9.info(
-      { sessionId, messageId, graphId, tenantId, projectId, contextId },
-      "GraphSession created"
+      { sessionId, messageId, agentId, tenantId, projectId, contextId },
+      "AgentSession created"
     );
     return sessionId;
   }
@@ -4364,7 +4347,7 @@ var GraphSessionManager = class {
     }
     const events = session.getEvents();
     const summary = session.getSummary();
-    logger9.info({ sessionId, summary }, "GraphSession ended");
+    logger9.info({ sessionId, summary }, "AgentSession ended");
     session.cleanup();
     this.sessions.delete(sessionId);
     return events;
@@ -4428,36 +4411,36 @@ var GraphSessionManager = class {
     }
   }
 };
-var graphSessionManager = new GraphSessionManager();
+var agentSessionManager = new AgentSessionManager();
 
 // src/utils/model-resolver.ts
 init_dbClient();
-async function resolveModelConfig(graphId, agent) {
-  if (agent.models?.base?.model) {
+async function resolveModelConfig(agentId, subAgent) {
+  if (subAgent.models?.base?.model) {
     return {
-      base: agent.models.base,
-      structuredOutput: agent.models.structuredOutput || agent.models.base,
-      summarizer: agent.models.summarizer || agent.models.base
+      base: subAgent.models.base,
+      structuredOutput: subAgent.models.structuredOutput || subAgent.models.base,
+      summarizer: subAgent.models.summarizer || subAgent.models.base
     };
   }
-  const graph = await agentsCore.getAgentGraphById(dbClient_default)({
-    scopes: { tenantId: agent.tenantId, projectId: agent.projectId, graphId }
+  const agent = await agentsCore.getAgentById(dbClient_default)({
+    scopes: { tenantId: subAgent.tenantId, projectId: subAgent.projectId, agentId }
   });
-  if (graph?.models?.base?.model) {
+  if (agent?.models?.base?.model) {
     return {
-      base: graph.models.base,
-      structuredOutput: agent.models?.structuredOutput || graph.models.structuredOutput || graph.models.base,
-      summarizer: agent.models?.summarizer || graph.models.summarizer || graph.models.base
+      base: agent.models.base,
+      structuredOutput: subAgent.models?.structuredOutput || agent.models.structuredOutput || agent.models.base,
+      summarizer: subAgent.models?.summarizer || agent.models.summarizer || agent.models.base
     };
   }
   const project = await agentsCore.getProject(dbClient_default)({
-    scopes: { tenantId: agent.tenantId, projectId: agent.projectId }
+    scopes: { tenantId: subAgent.tenantId, projectId: subAgent.projectId }
   });
   if (project?.models?.base?.model) {
     return {
       base: project.models.base,
-      structuredOutput: agent.models?.structuredOutput || project.models.structuredOutput || project.models.base,
-      summarizer: agent.models?.summarizer || project.models.summarizer || project.models.base
+      structuredOutput: subAgent.models?.structuredOutput || project.models.structuredOutput || project.models.base,
+      summarizer: subAgent.models?.summarizer || project.models.summarizer || project.models.base
     };
   }
   throw new Error(
@@ -4494,7 +4477,7 @@ var _IncrementalStreamParser = class _IncrementalStreamParser {
     this.contextId = contextId;
     this.subAgentId = artifactParserOptions?.subAgentId;
     if (artifactParserOptions?.streamRequestId) {
-      const sessionParser = graphSessionManager.getArtifactParser(
+      const sessionParser = agentSessionManager.getArtifactParser(
         artifactParserOptions.streamRequestId
       );
       if (sessionParser) {
@@ -4503,9 +4486,9 @@ var _IncrementalStreamParser = class _IncrementalStreamParser {
       }
     }
     let sharedArtifactService = null;
-    if (artifactParserOptions?.streamRequestId && typeof graphSessionManager.getArtifactService === "function") {
+    if (artifactParserOptions?.streamRequestId && typeof agentSessionManager.getArtifactService === "function") {
       try {
-        sharedArtifactService = graphSessionManager.getArtifactService(
+        sharedArtifactService = agentSessionManager.getArtifactService(
           artifactParserOptions.streamRequestId
         );
       } catch (error) {
@@ -4880,7 +4863,7 @@ var ResponseFormatter = class {
     __publicField(this, "subAgentId");
     this.subAgentId = artifactParserOptions?.subAgentId;
     if (artifactParserOptions?.streamRequestId) {
-      const sessionParser = graphSessionManager.getArtifactParser(
+      const sessionParser = agentSessionManager.getArtifactParser(
         artifactParserOptions.streamRequestId
       );
       if (sessionParser) {
@@ -4889,9 +4872,9 @@ var ResponseFormatter = class {
       }
     }
     let sharedArtifactService = null;
-    if (artifactParserOptions?.streamRequestId && typeof graphSessionManager.getArtifactService === "function") {
+    if (artifactParserOptions?.streamRequestId && typeof agentSessionManager.getArtifactService === "function") {
       try {
-        sharedArtifactService = graphSessionManager.getArtifactService(
+        sharedArtifactService = agentSessionManager.getArtifactService(
           artifactParserOptions.streamRequestId
         );
       } catch (error) {
@@ -5033,12 +5016,12 @@ var ResponseFormatter = class {
     }
   }
 };
-function agentInitializingOp(sessionId, graphId) {
+function agentInitializingOp(sessionId, agentId) {
   return {
     type: "agent_initializing",
     details: {
       sessionId,
-      graphId
+      agentId
     }
   };
 }
@@ -6124,23 +6107,29 @@ var createTransferToAgentTool = ({
       logger14.info(
         {
           transferTo: transferConfig.id ?? "unknown",
-          fromAgent: callingAgentId
+          fromSubAgent: callingAgentId
         },
         "invoked transferToAgentTool"
       );
       if (streamRequestId) {
-        graphSessionManager.recordEvent(streamRequestId, "transfer", callingAgentId, {
+        agentSessionManager.recordEvent(streamRequestId, "transfer", callingAgentId, {
           fromSubAgent: callingAgentId,
           targetSubAgent: transferConfig.id ?? "unknown",
           reason: `Transfer to ${transferConfig.name || transferConfig.id}`
         });
       }
-      return {
+      const transferResult = {
         type: "transfer",
-        target: transferConfig.id ?? "unknown",
-        fromAgentId: callingAgentId
+        targetSubAgentId: transferConfig.id ?? "unknown",
+        // Changed from "target" for type safety
+        fromSubAgentId: callingAgentId
         // Include the calling agent ID for tracking
       };
+      logger14.info({
+        transferResult,
+        transferResultKeys: Object.keys(transferResult)
+      }, "[DEBUG] Transfer tool returning");
+      return transferResult;
     }
   });
 };
@@ -6149,7 +6138,7 @@ function createDelegateToAgentTool({
   callingAgentId,
   tenantId,
   projectId,
-  graphId,
+  agentId,
   contextId,
   metadata,
   sessionId,
@@ -6170,7 +6159,7 @@ function createDelegateToAgentTool({
         });
       }
       if (metadata.streamRequestId) {
-        graphSessionManager.recordEvent(
+        agentSessionManager.recordEvent(
           metadata.streamRequestId,
           "delegation_sent",
           callingAgentId,
@@ -6189,7 +6178,7 @@ function createDelegateToAgentTool({
           scopes: {
             tenantId,
             projectId,
-            graphId
+            agentId
           },
           subAgentId: delegateConfig.config.id
         });
@@ -6235,8 +6224,8 @@ function createDelegateToAgentTool({
           Authorization: `Bearer ${metadata.apiKey}`,
           "x-inkeep-tenant-id": tenantId,
           "x-inkeep-project-id": projectId,
-          "x-inkeep-graph-id": graphId,
-          "x-inkeep-agent-id": delegateConfig.config.id
+          "x-inkeep-agent-id": agentId,
+          "x-inkeep-sub-agent-id": delegateConfig.config.id
         };
       }
       const a2aClient = new A2AClient(delegateConfig.config.baseUrl, {
@@ -6267,7 +6256,7 @@ function createDelegateToAgentTool({
           // Flag to prevent streaming in delegated agents
           delegationId,
           // Include delegation ID for tracking
-          ...isInternal ? { fromAgentId: callingAgentId } : { fromExternalAgentId: callingAgentId }
+          ...isInternal ? { fromSubAgentId: callingAgentId } : { fromExternalAgentId: callingAgentId }
         }
       };
       logger14.info({ messageToSend }, "messageToSend");
@@ -6283,7 +6272,7 @@ function createDelegateToAgentTool({
         visibility: isInternal ? "internal" : "external",
         messageType: "a2a-request",
         fromSubAgentId: callingAgentId,
-        ...isInternal ? { toAgentId: delegateConfig.config.id } : { toExternalAgentId: delegateConfig.config.id }
+        ...isInternal ? { toSubAgentId: delegateConfig.config.id } : { toExternalAgentId: delegateConfig.config.id }
       });
       const response = await a2aClient.sendMessage({
         message: messageToSend
@@ -6311,7 +6300,7 @@ function createDelegateToAgentTool({
         toolSessionManager.recordToolResult(sessionId, toolResult);
       }
       if (metadata.streamRequestId) {
-        graphSessionManager.recordEvent(
+        agentSessionManager.recordEvent(
           metadata.streamRequestId,
           "delegation_returned",
           callingAgentId,
@@ -6390,7 +6379,7 @@ var system_prompt_default = `<system_message>
     {{CORE_INSTRUCTIONS}}
   </core_instructions>
 
-  {{GRAPH_CONTEXT_SECTION}}
+  {{AGENT_CONTEXT_SECTION}}
 
   {{ARTIFACTS_SECTION}}
   {{TOOLS_SECTION}}
@@ -6555,7 +6544,7 @@ When you use delegation tools, the response may include artifacts in the parts a
 These artifacts become immediately available for you to reference using the artifactId and toolCallId from the response.
 Present delegation results naturally without mentioning the delegation process itself.
 
-IMPORTANT: All agents can retrieve and use information from existing artifacts when the graph has artifact components, regardless of whether the individual agent can create new artifacts.`;
+IMPORTANT: All sub-agents can retrieve and use information from existing artifacts when the agent has artifact components, regardless of whether the individual agent or sub-agents can create new artifacts.`;
 
 // src/agents/versions/v1/Phase1Config.ts
 init_logger();
@@ -6601,8 +6590,8 @@ var Phase1Config = class _Phase1Config {
     }
     let systemPrompt = systemPromptTemplate;
     systemPrompt = systemPrompt.replace("{{CORE_INSTRUCTIONS}}", config.corePrompt);
-    const graphContextSection = this.generateGraphContextSection(config.graphPrompt);
-    systemPrompt = systemPrompt.replace("{{GRAPH_CONTEXT_SECTION}}", graphContextSection);
+    const agentContextSection = this.generateAgentContextSection(config.agentPrompt);
+    systemPrompt = systemPrompt.replace("{{AGENT_CONTEXT_SECTION}}", agentContextSection);
     const toolData = this.isToolDataArray(config.tools) ? config.tools : _Phase1Config.convertMcpToolsToToolData(config.tools);
     const hasArtifactComponents = config.artifactComponents && config.artifactComponents.length > 0;
     const artifactsSection = this.generateArtifactsSection(
@@ -6610,7 +6599,7 @@ var Phase1Config = class _Phase1Config {
       config.artifacts,
       hasArtifactComponents,
       config.artifactComponents,
-      config.hasGraphArtifactComponents
+      config.hasAgentArtifactComponents
     );
     systemPrompt = systemPrompt.replace("{{ARTIFACTS_SECTION}}", artifactsSection);
     const toolsSection = this.generateToolsSection(templates, toolData);
@@ -6629,14 +6618,14 @@ var Phase1Config = class _Phase1Config {
     systemPrompt = systemPrompt.replace("{{DELEGATION_INSTRUCTIONS}}", delegationSection);
     return systemPrompt;
   }
-  generateGraphContextSection(graphPrompt) {
-    if (!graphPrompt) {
+  generateAgentContextSection(agentPrompt) {
+    if (!agentPrompt) {
       return "";
     }
     return `
-  <graph_context>
-    ${graphPrompt}
-  </graph_context>`;
+  <agent_context>
+    ${agentPrompt}
+  </agent_context>`;
   }
   generateThinkingPreparationSection(templates, isThinkingPreparation) {
     if (!isThinkingPreparation) {
@@ -6654,7 +6643,7 @@ var Phase1Config = class _Phase1Config {
     }
     return `- You have transfer_to_* tools that seamlessly continue the conversation
 - NEVER announce transfers - just call the tool when needed
-- The conversation continues naturally without any handoff language`;
+- The conversation continues naturally without any transfer language`;
   }
   generateDelegationInstructions(hasDelegateRelations) {
     if (!hasDelegateRelations) {
@@ -6888,8 +6877,8 @@ ${typeDescriptions}
 - Do NOT abbreviate, modify, or guess the type name
 - Copy the exact quoted name from the "AVAILABLE ARTIFACT TYPES" list above`;
   }
-  generateArtifactsSection(templates, artifacts, hasArtifactComponents = false, artifactComponents, hasGraphArtifactComponents) {
-    const shouldShowReferencingRules = hasGraphArtifactComponents || artifacts.length > 0;
+  generateArtifactsSection(templates, artifacts, hasArtifactComponents = false, artifactComponents, hasAgentArtifactComponents) {
+    const shouldShowReferencingRules = hasAgentArtifactComponents || artifacts.length > 0;
     const rules = this.getArtifactReferencingRules(
       hasArtifactComponents,
       templates,
@@ -7369,7 +7358,7 @@ ${artifact_retrieval_guidance_default}
       dataComponents,
       artifactComponents,
       hasArtifactComponents,
-      hasGraphArtifactComponents,
+      hasAgentArtifactComponents,
       artifacts = []
     } = config;
     let allDataComponents = [...dataComponents];
@@ -7385,7 +7374,7 @@ ${artifact_retrieval_guidance_default}
     }
     const dataComponentsSection = this.generateDataComponentsSection(allDataComponents);
     const artifactsSection = this.generateArtifactsSection(artifacts);
-    const shouldShowReferencingRules = hasGraphArtifactComponents || artifacts.length > 0;
+    const shouldShowReferencingRules = hasAgentArtifactComponents || artifacts.length > 0;
     const artifactGuidance = this.getStructuredArtifactGuidance(
       hasArtifactComponents,
       artifactComponents,
@@ -7590,7 +7579,7 @@ var Agent = class {
     return this.isDelegatedAgent ? void 0 : this.streamHelper;
   }
   /**
-   * Wraps a tool with streaming lifecycle tracking (start, complete, error) and GraphSession recording
+   * Wraps a tool with streaming lifecycle tracking (start, complete, error) and AgentSession recording
    */
   wrapToolWithStreaming(toolName, toolDefinition, streamRequestId, toolType) {
     if (!toolDefinition || typeof toolDefinition !== "object" || !("execute" in toolDefinition)) {
@@ -7609,7 +7598,7 @@ var Agent = class {
             "tool.purpose": toolDefinition.description || "No description provided",
             "ai.toolType": toolType || "unknown",
             "ai.agentName": this.config.name || "unknown",
-            "graph.id": this.config.graphId || "unknown"
+            "agent.id": this.config.agentId || "unknown"
           });
         }
         const isInternalTool = toolName.includes("save_tool_result") || toolName.includes("thinking_complete") || toolName.startsWith("transfer_to_") || toolName.startsWith("delegate_to_");
@@ -7617,7 +7606,7 @@ var Agent = class {
           const result = await originalExecute(args, context);
           const duration = Date.now() - startTime;
           if (streamRequestId && !isInternalTool) {
-            graphSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
+            agentSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
               toolName,
               args,
               result,
@@ -7630,7 +7619,7 @@ var Agent = class {
           const duration = Date.now() - startTime;
           const errorMessage = error instanceof Error ? error.message : "Unknown error";
           if (streamRequestId && !isInternalTool) {
-            graphSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
+            agentSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
               toolName,
               args,
               result: { error: errorMessage },
@@ -7675,7 +7664,7 @@ var Agent = class {
               callingAgentId: this.config.id,
               tenantId: this.config.tenantId,
               projectId: this.config.projectId,
-              graphId: this.config.graphId,
+              agentId: this.config.agentId,
               contextId: runtimeContext?.contextId || "default",
               // fallback for compatibility
               metadata: runtimeContext?.metadata || {
@@ -7784,7 +7773,7 @@ var Agent = class {
       scopes: {
         tenantId: this.config.tenantId,
         projectId: this.config.projectId,
-        graphId: this.config.graphId,
+        agentId: this.config.agentId,
         subAgentId: this.config.id
       }
     });
@@ -7890,26 +7879,26 @@ var Agent = class {
               "ai.toolCall.args": JSON.stringify({ operation: "mcp_tool_discovery" }),
               "ai.toolCall.result": JSON.stringify({
                 status: "no_tools_available",
-                message: `MCP server has 0 effective tools. Double check the selected tools in your graph and the active tools in the MCP server configuration.`,
+                message: `MCP server has 0 effective tools. Double check the selected tools in your agent and the active tools in the MCP server configuration.`,
                 serverUrl: tool3.config.type === "mcp" ? tool3.config.mcp.server.url : "unknown",
                 originalToolName: tool3.name
               }),
               "ai.toolType": "mcp",
               "ai.agentName": this.config.name || "unknown",
               "conversation.id": this.conversationId || "unknown",
-              "graph.id": this.config.graphId || "unknown",
+              "agent.id": this.config.agentId || "unknown",
               "tenant.id": this.config.tenantId || "unknown",
               "project.id": this.config.projectId || "unknown"
             }
           },
           (span) => {
             agentsCore.setSpanWithError(span, new Error(`0 effective tools available for ${tool3.name}`));
-            graphSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
+            agentSessionManager.recordEvent(streamRequestId, "tool_execution", this.config.id, {
               toolName: tool3.name,
               args: { operation: "mcp_tool_discovery" },
               result: {
                 status: "no_tools_available",
-                message: `MCP server has 0 effective tools. Double check the selected tools in your graph and the active tools in the MCP server configuration.`,
+                message: `MCP server has 0 effective tools. Double check the selected tools in your agent and the active tools in the MCP server configuration.`,
                 serverUrl: tool3.config.type === "mcp" ? tool3.config.mcp.server.url : "unknown"
               }
             });
@@ -7958,7 +7947,7 @@ var Agent = class {
         scopes: {
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
-          graphId: this.config.graphId
+          agentId: this.config.agentId
         },
         subAgentId: this.config.id
       });
@@ -8001,11 +7990,21 @@ var Agent = class {
               "Function Tool Called"
             );
             try {
+              const project = await agentsCore.getProject(dbClient_default)({
+                scopes: { tenantId: this.config.tenantId, projectId: this.config.projectId }
+              });
+              const defaultSandboxConfig = {
+                provider: "local",
+                runtime: "node22",
+                timeout: 3e4,
+                vcpus: 1
+              };
               const result = await sandboxExecutor.executeFunctionTool(functionToolDef.id, args, {
                 description: functionToolDef.description || functionToolDef.name,
                 inputSchema: functionData.inputSchema || {},
                 executeCode: functionData.executeCode,
-                dependencies: functionData.dependencies || {}
+                dependencies: functionData.dependencies || {},
+                sandboxConfig: project?.sandboxConfig || defaultSandboxConfig
               });
               toolSessionManager.recordToolResult(sessionId || "", {
                 toolCallId,
@@ -8042,14 +8041,14 @@ var Agent = class {
   async getResolvedContext(conversationId, headers) {
     try {
       if (!this.config.contextConfigId) {
-        logger18.debug({ graphId: this.config.graphId }, "No context config found for graph");
+        logger18.debug({ agentId: this.config.agentId }, "No context config found for agent");
         return null;
       }
       const contextConfig = await agentsCore.getContextConfigById(dbClient_default)({
         scopes: {
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
-          graphId: this.config.graphId
+          agentId: this.config.agentId
         },
         id: this.config.contextConfigId
       });
@@ -8096,67 +8095,67 @@ var Agent = class {
     }
   }
   /**
-   * Get the graph prompt for this agent's graph
+   * Get the agent prompt for this agent's agent
    */
-  async getGraphPrompt() {
+  async getAgentPrompt() {
     try {
-      const graphDefinition = await agentsCore.getFullGraphDefinition(dbClient_default)({
+      const agentDefinition = await agentsCore.getFullAgentDefinition(dbClient_default)({
         scopes: {
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
-          graphId: this.config.graphId
+          agentId: this.config.agentId
         }
       });
-      return graphDefinition?.graphPrompt || void 0;
+      return agentDefinition?.prompt || void 0;
     } catch (error) {
       logger18.warn(
         {
-          graphId: this.config.graphId,
+          agentId: this.config.agentId,
           error: error instanceof Error ? error.message : "Unknown error"
         },
-        "Failed to get graph prompt"
+        "Failed to get agent prompt"
       );
       return void 0;
     }
   }
   /**
-   * Check if any agent in the graph has artifact components configured
+   * Check if any agent in the agent has artifact components configured
    */
-  async hasGraphArtifactComponents() {
+  async hasAgentArtifactComponents() {
     try {
-      const graphDefinition = await agentsCore.getFullGraphDefinition(dbClient_default)({
+      const agentDefinition = await agentsCore.getFullAgentDefinition(dbClient_default)({
         scopes: {
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
-          graphId: this.config.graphId
+          agentId: this.config.agentId
         }
       });
-      if (!graphDefinition) {
+      if (!agentDefinition) {
         return false;
       }
-      return Object.values(graphDefinition.subAgents).some(
+      return Object.values(agentDefinition.subAgents).some(
         (subAgent) => "artifactComponents" in subAgent && subAgent.artifactComponents && subAgent.artifactComponents.length > 0
       );
     } catch (error) {
       logger18.warn(
         {
-          graphId: this.config.graphId,
+          agentId: this.config.agentId,
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
           error: error instanceof Error ? error.message : "Unknown error"
         },
-        "Failed to check graph artifact components, assuming none exist"
+        "Failed to check agent artifact components, assuming none exist"
       );
       return this.artifactComponents.length > 0;
     }
   }
   /**
    * Build adaptive system prompt for Phase 2 structured output generation
-   * based on configured data components and artifact components across the graph
+   * based on configured data components and artifact components across the agent
    */
   async buildPhase2SystemPrompt(runtimeContext) {
     const phase2Config = new Phase2Config();
-    const hasGraphArtifactComponents = await this.hasGraphArtifactComponents();
+    const hasAgentArtifactComponents = await this.hasAgentArtifactComponents();
     const conversationId = runtimeContext?.metadata?.conversationId || runtimeContext?.contextId;
     const resolvedContext = conversationId ? await this.getResolvedContext(conversationId) : null;
     let processedPrompt = this.config.agentPrompt;
@@ -8196,7 +8195,7 @@ var Agent = class {
       dataComponents: this.config.dataComponents || [],
       artifactComponents: this.artifactComponents,
       hasArtifactComponents: this.artifactComponents && this.artifactComponents.length > 0,
-      hasGraphArtifactComponents,
+      hasAgentArtifactComponents,
       artifacts: referenceArtifacts
     });
   }
@@ -8260,10 +8259,10 @@ var Agent = class {
     });
     const componentDataComponents = excludeDataComponents ? [] : this.config.dataComponents || [];
     const isThinkingPreparation = this.config.dataComponents && this.config.dataComponents.length > 0 && excludeDataComponents;
-    let graphPrompt = await this.getGraphPrompt();
-    if (graphPrompt && resolvedContext) {
+    let agentPrompt = await this.getAgentPrompt();
+    if (agentPrompt && resolvedContext) {
       try {
-        graphPrompt = agentsCore.TemplateEngine.render(graphPrompt, resolvedContext, {
+        agentPrompt = agentsCore.TemplateEngine.render(agentPrompt, resolvedContext, {
           strict: false,
           preserveUnresolved: false
         });
@@ -8273,20 +8272,20 @@ var Agent = class {
             conversationId,
             error: error instanceof Error ? error.message : "Unknown error"
           },
-          "Failed to process graph prompt with context, using original"
+          "Failed to process agent prompt with context, using original"
         );
       }
     }
     const shouldIncludeArtifactComponents = !excludeDataComponents;
-    const hasGraphArtifactComponents = await this.hasGraphArtifactComponents();
+    const hasAgentArtifactComponents = await this.hasAgentArtifactComponents();
     const config = {
       corePrompt: processedPrompt,
-      graphPrompt,
+      agentPrompt,
       tools: toolDefinitions,
       dataComponents: componentDataComponents,
       artifacts: referenceArtifacts,
       artifactComponents: shouldIncludeArtifactComponents ? this.artifactComponents : [],
-      hasGraphArtifactComponents,
+      hasAgentArtifactComponents,
       isThinkingPreparation,
       hasTransferRelations: (this.config.transferRelations?.length ?? 0) > 0,
       hasDelegateRelations: (this.config.delegateRelations?.length ?? 0) > 0
@@ -8303,7 +8302,7 @@ var Agent = class {
       execute: async ({ artifactId, toolCallId }) => {
         logger18.info({ artifactId, toolCallId }, "get_artifact_full executed");
         const streamRequestId = this.getStreamRequestId();
-        const artifactService = graphSessionManager.getArtifactService(streamRequestId);
+        const artifactService = agentSessionManager.getArtifactService(streamRequestId);
         if (!artifactService) {
           throw new Error(`ArtifactService not found for session ${streamRequestId}`);
         }
@@ -8337,7 +8336,7 @@ var Agent = class {
   // Provide a default tool set that is always available to the agent.
   async getDefaultTools(streamRequestId) {
     const defaultTools = {};
-    if (await this.graphHasArtifactComponents()) {
+    if (await this.agentHasArtifactComponents()) {
       defaultTools.get_reference_artifact = this.getArtifactTools();
     }
     const hasStructuredOutput = this.config.dataComponents && this.config.dataComponents.length > 0;
@@ -8565,20 +8564,20 @@ var Agent = class {
       return result;
     }
   }
-  // Check if any agents in the graph have artifact components
-  async graphHasArtifactComponents() {
+  // Check if any agents in the agent have artifact components
+  async agentHasArtifactComponents() {
     try {
-      return await agentsCore.graphHasArtifactComponents(dbClient_default)({
+      return await agentsCore.agentHasArtifactComponents(dbClient_default)({
         scopes: {
           tenantId: this.config.tenantId,
           projectId: this.config.projectId,
-          graphId: this.config.graphId
+          agentId: this.config.agentId
         }
       });
     } catch (error) {
       logger18.error(
-        { error, graphId: this.config.graphId },
-        "Failed to check graph artifact components"
+        { error, agentId: this.config.agentId },
+        "Failed to check agent artifact components"
       );
       return false;
     }
@@ -8710,7 +8709,7 @@ var Agent = class {
               const last = steps.at(-1);
               if (last && "text" in last && last.text) {
                 try {
-                  await graphSessionManager.recordEvent(
+                  await agentSessionManager.recordEvent(
                     this.getStreamRequestId(),
                     "agent_reasoning",
                     this.config.id,
@@ -8722,8 +8721,14 @@ var Agent = class {
                   logger18.debug({ error }, "Failed to track agent reasoning");
                 }
               }
-              if (last && "toolCalls" in last && last.toolCalls) {
-                return last.toolCalls.some((tc) => tc.toolName.startsWith("transfer_to_"));
+              if (steps.length >= 2) {
+                const previousStep = steps[steps.length - 2];
+                if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
+                  const hasTransferCall = previousStep.toolCalls.some((tc) => tc.toolName.startsWith("transfer_to_"));
+                  if (hasTransferCall && "toolResults" in previousStep && previousStep.toolResults) {
+                    return true;
+                  }
+                }
               }
               return steps.length >= this.getMaxGenerationSteps();
             },
@@ -8824,7 +8829,7 @@ var Agent = class {
               const last = steps.at(-1);
               if (last && "text" in last && last.text) {
                 try {
-                  await graphSessionManager.recordEvent(
+                  await agentSessionManager.recordEvent(
                     this.getStreamRequestId(),
                     "agent_reasoning",
                     this.config.id,
@@ -8836,10 +8841,16 @@ var Agent = class {
                   logger18.debug({ error }, "Failed to track agent reasoning");
                 }
               }
-              if (last && "toolCalls" in last && last.toolCalls) {
-                return last.toolCalls.some(
-                  (tc) => tc.toolName.startsWith("transfer_to_") || tc.toolName === "thinking_complete"
-                );
+              if (steps.length >= 2) {
+                const previousStep = steps[steps.length - 2];
+                if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
+                  const hasStopTool = previousStep.toolCalls.some(
+                    (tc) => tc.toolName.startsWith("transfer_to_") || tc.toolName === "thinking_complete"
+                  );
+                  if (hasStopTool && "toolResults" in previousStep && previousStep.toolResults) {
+                    return true;
+                  }
+                }
               }
               return steps.length >= this.getMaxGenerationSteps();
             },
@@ -9105,7 +9116,7 @@ ${output}${structureHintsFormatted}`;
         };
         if (streamRequestId) {
           const generationType = response.object ? "object_generation" : "text_generation";
-          graphSessionManager.recordEvent(streamRequestId, "agent_generate", this.config.id, {
+          agentSessionManager.recordEvent(streamRequestId, "agent_generate", this.config.id, {
             parts: (formattedContent?.parts || []).map((part) => ({
               type: part.kind === "text" ? "text" : part.kind === "data" ? "tool_result" : "text",
               content: part.text || JSON.stringify(part.data)
@@ -9145,11 +9156,11 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
         dataComponents,
         artifactComponents
       ] = await Promise.all([
-        agentsCore.getRelatedAgentsForGraph(dbClient_default)({
+        agentsCore.getRelatedAgentsForAgent(dbClient_default)({
           scopes: {
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId
+            agentId: config.agentId
           },
           subAgentId: config.subAgentId
         }),
@@ -9157,7 +9168,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
           scopes: {
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId,
+            agentId: config.agentId,
             subAgentId: config.subAgentId
           }
         }),
@@ -9165,7 +9176,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
           scopes: {
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId,
+            agentId: config.agentId,
             subAgentId: config.subAgentId
           }
         }),
@@ -9173,7 +9184,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
           scopes: {
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId,
+            agentId: config.agentId,
             subAgentId: config.subAgentId
           }
         })
@@ -9186,16 +9197,16 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
               scopes: {
                 tenantId: config.tenantId,
                 projectId: config.projectId,
-                graphId: config.graphId
+                agentId: config.agentId
               },
               subAgentId: relation.id
             });
             if (relatedAgent) {
-              const relatedAgentRelations = await agentsCore.getRelatedAgentsForGraph(dbClient_default)({
+              const relatedAgentRelations = await agentsCore.getRelatedAgentsForAgent(dbClient_default)({
                 scopes: {
                   tenantId: config.tenantId,
                   projectId: config.projectId,
-                  graphId: config.graphId
+                  agentId: config.agentId
                 },
                 subAgentId: relation.id
               });
@@ -9225,7 +9236,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
           id: config.subAgentId,
           tenantId: config.tenantId,
           projectId: config.projectId,
-          graphId: config.graphId,
+          agentId: config.agentId,
           baseUrl: config.baseUrl,
           apiKey: config.apiKey,
           name: config.name,
@@ -9237,7 +9248,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
             id: relation.id,
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId,
+            agentId: config.agentId,
             baseUrl: config.baseUrl,
             apiKey: config.apiKey,
             name: relation.name,
@@ -9253,7 +9264,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
             id: relation.id,
             tenantId: config.tenantId,
             projectId: config.projectId,
-            graphId: config.graphId,
+            agentId: config.agentId,
             name: relation.name,
             description: relation.description,
             agentPrompt: "",
@@ -9269,7 +9280,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
                 id: relation.id,
                 tenantId: config.tenantId,
                 projectId: config.projectId,
-                graphId: config.graphId,
+                agentId: config.agentId,
                 baseUrl: config.baseUrl,
                 apiKey: config.apiKey,
                 name: relation.name,
@@ -9304,7 +9315,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
       );
       const artifactStreamRequestId = task.context?.metadata?.streamRequestId;
       if (artifactStreamRequestId && artifactComponents.length > 0) {
-        graphSessionManager.updateArtifactComponents(artifactStreamRequestId, artifactComponents);
+        agentSessionManager.updateArtifactComponents(artifactStreamRequestId, artifactComponents);
       }
       let contextId = task.context?.conversationId;
       if (!contextId || contextId === "default" || contextId === "") {
@@ -9332,7 +9343,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
           "Delegated agent - streaming disabled"
         );
         if (streamRequestId && config.tenantId && config.projectId) {
-          toolSessionManager.ensureGraphSession(
+          toolSessionManager.ensureAgentSession(
             streamRequestId,
             config.tenantId,
             config.projectId,
@@ -9364,17 +9375,42 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
             const toolResult = allToolResults.find(
               (result) => result.toolCallId === toolCall.toolCallId
             );
+            logger19.info({
+              toolCallName: toolCall.toolName,
+              toolCallId: toolCall.toolCallId,
+              hasToolResult: !!toolResult,
+              toolResultOutput: toolResult?.output,
+              toolResultKeys: toolResult?.output ? Object.keys(toolResult.output) : []
+            }, "[DEBUG] Transfer tool result found");
             const isValidTransferResult = (output) => {
-              return typeof output === "object" && output !== null && "type" in output && "target" in output && output.type === "transfer" && typeof output.target === "string" && (output.reason === void 0 || typeof output.reason === "string");
+              return typeof output === "object" && output !== null && "type" in output && "targetSubAgentId" in output && output.type === "transfer" && typeof output.targetSubAgentId === "string";
             };
             const responseText = response.text || (response.object ? JSON.stringify(response.object) : "");
             const transferReason = responseText || allThoughts[allThoughts.length - 1]?.text || "Agent requested transfer. No reason provided.";
             if (toolResult?.output && isValidTransferResult(toolResult.output)) {
               const transferResult = toolResult.output;
+              logger19.info({
+                validationPassed: true,
+                transferResult,
+                targetSubAgentId: transferResult.targetSubAgentId,
+                fromSubAgentId: transferResult.fromSubAgentId
+              }, "[DEBUG] Transfer validation passed, extracted data");
+              const artifactData = {
+                type: "transfer",
+                targetSubAgentId: transferResult.targetSubAgentId,
+                fromSubAgentId: transferResult.fromSubAgentId,
+                task_id: task.id,
+                reason: transferReason,
+                original_message: userMessage
+              };
+              logger19.info({
+                artifactData,
+                artifactDataKeys: Object.keys(artifactData)
+              }, "[DEBUG] Artifact data being returned");
               return {
                 status: {
                   state: agentsCore.TaskState.Completed,
-                  message: `Transfer requested to ${transferResult.target}`
+                  message: `Transfer requested to ${transferResult.targetSubAgentId}`
                 },
                 artifacts: [
                   {
@@ -9382,18 +9418,19 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
                     parts: [
                       {
                         kind: "data",
-                        data: {
-                          type: "transfer",
-                          target: transferResult.target,
-                          task_id: task.id,
-                          reason: transferReason,
-                          original_message: userMessage
-                        }
+                        data: artifactData
                       }
                     ]
                   }
                 ]
               };
+            } else {
+              logger19.warn({
+                hasToolResult: !!toolResult,
+                hasOutput: !!toolResult?.output,
+                validationPassed: false,
+                output: toolResult?.output
+              }, "[DEBUG] Transfer validation FAILED");
             }
           }
         }
@@ -9425,129 +9462,172 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
   };
 };
 var createTaskHandlerConfig = async (params) => {
-  const agent = await agentsCore.getSubAgentById(dbClient_default)({
+  const subAgent = await agentsCore.getSubAgentById(dbClient_default)({
     scopes: {
       tenantId: params.tenantId,
       projectId: params.projectId,
-      graphId: params.graphId
+      agentId: params.agentId
     },
     subAgentId: params.subAgentId
   });
-  const agentGraph = await agentsCore.getAgentGraphById(dbClient_default)({
+  const agent = await agentsCore.getAgentById(dbClient_default)({
     scopes: {
       tenantId: params.tenantId,
       projectId: params.projectId,
-      graphId: params.graphId
+      agentId: params.agentId
     }
   });
-  if (!agent) {
+  if (!subAgent) {
     throw new Error(`Agent not found: ${params.subAgentId}`);
   }
-  const effectiveModels = await resolveModelConfig(params.graphId, agent);
-  const effectiveConversationHistoryConfig = agent.conversationHistoryConfig || { mode: "full" };
+  const effectiveModels = await resolveModelConfig(params.agentId, subAgent);
+  const effectiveConversationHistoryConfig = subAgent.conversationHistoryConfig || { mode: "full" };
   return {
     tenantId: params.tenantId,
     projectId: params.projectId,
-    graphId: params.graphId,
+    agentId: params.agentId,
     subAgentId: params.subAgentId,
     agentSchema: {
-      id: agent.id,
-      name: agent.name,
-      description: agent.description,
-      prompt: agent.prompt,
+      id: subAgent.id,
+      name: subAgent.name,
+      description: subAgent.description,
+      prompt: subAgent.prompt,
       models: effectiveModels,
       conversationHistoryConfig: effectiveConversationHistoryConfig || null,
-      stopWhen: agent.stopWhen || null,
-      createdAt: agent.createdAt,
-      updatedAt: agent.updatedAt
+      stopWhen: subAgent.stopWhen || null,
+      createdAt: subAgent.createdAt,
+      updatedAt: subAgent.updatedAt
     },
     baseUrl: params.baseUrl,
     apiKey: params.apiKey,
-    name: agent.name,
-    description: agent.description,
+    name: subAgent.name,
+    description: subAgent.description,
     conversationHistoryConfig: effectiveConversationHistoryConfig,
-    contextConfigId: agentGraph?.contextConfigId || void 0
+    contextConfigId: agent?.contextConfigId || void 0
   };
 };
 
-// src/data/agentGraph.ts
+// src/data/agents.ts
 init_dbClient();
-async function hydrateGraph({
-  dbGraph,
+function createAgentCard({
+  dbAgent,
+  baseUrl
+}) {
+  const description = dbAgent.description || "AI Agent";
+  return {
+    name: dbAgent.name,
+    description,
+    url: baseUrl ? `${baseUrl}/a2a` : "",
+    version: "1.0.0",
+    capabilities: {
+      streaming: true,
+      // Enable streaming for A2A compliance
+      pushNotifications: false,
+      stateTransitionHistory: false
+    },
+    defaultInputModes: ["text", "text/plain"],
+    defaultOutputModes: ["text", "text/plain"],
+    skills: [],
+    // Add provider info if available
+    ...baseUrl && {
+      provider: {
+        organization: "Inkeep",
+        url: baseUrl
+      }
+    }
+  };
+}
+function generateDescriptionWithTransfers(baseDescription, internalRelations, externalRelations) {
+  const transfers = [
+    ...internalRelations.filter((rel) => rel.relationType === "transfer"),
+    ...externalRelations.filter((rel) => rel.relationType === "transfer")
+  ];
+  const delegates = [
+    ...internalRelations.filter((rel) => rel.relationType === "delegate"),
+    ...externalRelations.filter((rel) => rel.relationType === "delegate")
+  ];
+  if (transfers.length === 0 && delegates.length === 0) {
+    return baseDescription;
+  }
+  let enhancedDescription = baseDescription;
+  if (transfers.length > 0) {
+    const transferList = transfers.map((rel) => {
+      const name = rel.externalAgent?.name || rel.name;
+      const desc = rel.externalAgent?.description || rel.description || "";
+      return `- ${name}: ${desc}`;
+    }).join("\n");
+    enhancedDescription += `
+
+Can transfer to:
+${transferList}`;
+  }
+  if (delegates.length > 0) {
+    const delegateList = delegates.map((rel) => {
+      const name = rel.externalAgent?.name || rel.name;
+      const desc = rel.externalAgent?.description || rel.description || "";
+      return `- ${name}: ${desc}`;
+    }).join("\n");
+    enhancedDescription += `
+
+Can delegate to:
+${delegateList}`;
+  }
+  return enhancedDescription;
+}
+async function hydrateAgent({
+  dbAgent,
+  agentId,
   baseUrl,
-  apiKey
+  apiKey,
+  credentialStoreRegistry
 }) {
   try {
-    if (!dbGraph.defaultSubAgentId) {
-      throw new Error(`Graph ${dbGraph.id} does not have a default agent configured`);
-    }
-    const defaultSubAgent = await agentsCore.getSubAgentById(dbClient_default)({
-      scopes: {
-        tenantId: dbGraph.tenantId,
-        projectId: dbGraph.projectId,
-        graphId: dbGraph.id
-      },
-      subAgentId: dbGraph.defaultSubAgentId
-    });
-    if (!defaultSubAgent) {
-      throw new Error(
-        `Default agent ${dbGraph.defaultSubAgentId} not found for graph ${dbGraph.id}`
-      );
-    }
     const taskHandlerConfig = await createTaskHandlerConfig({
-      tenantId: dbGraph.tenantId,
-      projectId: dbGraph.projectId,
-      graphId: dbGraph.id,
-      subAgentId: dbGraph.defaultSubAgentId,
+      tenantId: dbAgent.tenantId,
+      projectId: dbAgent.projectId,
+      agentId,
+      subAgentId: dbAgent.id,
       baseUrl,
       apiKey
     });
-    const taskHandler = createTaskHandler(taskHandlerConfig);
-    const agentCard = {
-      name: dbGraph.name,
-      description: dbGraph.description || `Agent graph: ${dbGraph.name}`,
-      url: baseUrl ? `${baseUrl}/a2a` : "",
-      version: "1.0.0",
-      capabilities: {
-        streaming: true,
-        // Enable streaming for A2A compliance
-        pushNotifications: false,
-        stateTransitionHistory: false
-      },
-      defaultInputModes: ["text", "text/plain"],
-      defaultOutputModes: ["text", "text/plain"],
-      skills: [],
-      // TODO: Could aggregate skills from all agents in the graph
-      // Add provider info if available
-      ...baseUrl && {
-        provider: {
-          organization: "Inkeep",
-          url: baseUrl
-        }
-      }
-    };
+    const taskHandler = createTaskHandler(taskHandlerConfig, credentialStoreRegistry);
+    const agentCard = createAgentCard({
+      dbAgent,
+      baseUrl
+    });
     return {
-      subAgentId: dbGraph.id,
-      // Use graph ID as agent ID for A2A purposes
-      tenantId: dbGraph.tenantId,
-      projectId: dbGraph.projectId,
-      graphId: dbGraph.id,
+      subAgentId: dbAgent.id,
+      tenantId: dbAgent.tenantId,
+      projectId: dbAgent.projectId,
+      agentId,
       agentCard,
       taskHandler
     };
   } catch (error) {
-    console.error(`\u274C Failed to hydrate graph ${dbGraph.id}:`, error);
+    console.error(`\u274C Failed to hydrate agent ${dbAgent.id}:`, error);
     throw error;
   }
 }
-async function getRegisteredGraph(executionContext) {
-  const { tenantId, projectId, graphId, baseUrl, apiKey } = executionContext;
-  const dbGraph = await agentsCore.getAgentGraphById(dbClient_default)({ scopes: { tenantId, projectId, graphId } });
-  if (!dbGraph) {
+async function getRegisteredAgent(executionContext, credentialStoreRegistry) {
+  const { tenantId, projectId, agentId, subAgentId, baseUrl, apiKey } = executionContext;
+  if (!subAgentId) {
+    throw new Error("Agent ID is required");
+  }
+  const dbAgent = await agentsCore.getSubAgentById(dbClient_default)({
+    scopes: { tenantId, projectId, agentId },
+    subAgentId
+  });
+  if (!dbAgent) {
     return null;
   }
   const agentFrameworkBaseUrl = `${baseUrl}/agents`;
-  return hydrateGraph({ dbGraph, baseUrl: agentFrameworkBaseUrl, apiKey });
+  return hydrateAgent({
+    dbAgent,
+    agentId,
+    baseUrl: agentFrameworkBaseUrl,
+    credentialStoreRegistry,
+    apiKey
+  });
 }
 
 // src/routes/agents.ts
@@ -9601,7 +9681,7 @@ app.openapi(
       "OpenTelemetry headers: well-known agent.json"
     );
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { tenantId, projectId, graphId, subAgentId } = executionContext;
+    const { tenantId, projectId, agentId, subAgentId } = executionContext;
     console.dir("executionContext", executionContext);
     if (subAgentId) {
       logger20.info(
@@ -9609,7 +9689,7 @@ app.openapi(
           message: "getRegisteredAgent (agent-level)",
           tenantId,
           projectId,
-          graphId,
+          agentId,
           subAgentId
         },
         "agent-level well-known agent.json"
@@ -9627,21 +9707,21 @@ app.openapi(
     } else {
       logger20.info(
         {
-          message: "getRegisteredGraph (graph-level)",
+          message: "getRegisteredAgent (agent-level)",
           tenantId,
           projectId,
-          graphId
+          agentId
         },
-        "graph-level well-known agent.json"
+        "agent-level well-known agent.json"
       );
-      const graph = await getRegisteredGraph(executionContext);
-      if (!graph) {
+      const agent = await getRegisteredAgent(executionContext);
+      if (!agent) {
         throw agentsCore.createApiError({
           code: "not_found",
-          message: "Graph not found"
+          message: "Agent not found"
         });
       }
-      return c.json(graph.agentCard);
+      return c.json(agent.agentCard);
     }
   }
 );
@@ -9660,14 +9740,14 @@ app.post("/a2a", async (c) => {
     "OpenTelemetry headers: a2a"
   );
   const executionContext = agentsCore.getRequestExecutionContext(c);
-  const { tenantId, projectId, graphId, subAgentId } = executionContext;
+  const { tenantId, projectId, agentId, subAgentId } = executionContext;
   if (subAgentId) {
     logger20.info(
       {
         message: "a2a (agent-level)",
         tenantId,
         projectId,
-        graphId,
+        agentId,
         subAgentId
       },
       "agent-level a2a endpoint"
@@ -9688,17 +9768,17 @@ app.post("/a2a", async (c) => {
   } else {
     logger20.info(
       {
-        message: "a2a (graph-level)",
+        message: "a2a (agent-level)",
         tenantId,
         projectId,
-        graphId
+        agentId
       },
-      "graph-level a2a endpoint"
+      "agent-level a2a endpoint"
     );
-    const graph = await agentsCore.getAgentGraphWithDefaultSubAgent(dbClient_default)({
-      scopes: { tenantId, projectId, graphId }
+    const agent = await agentsCore.getAgentWithDefaultSubAgent(dbClient_default)({
+      scopes: { tenantId, projectId, agentId }
     });
-    if (!graph) {
+    if (!agent) {
       return c.json(
         {
           jsonrpc: "2.0",
@@ -9708,17 +9788,17 @@ app.post("/a2a", async (c) => {
         404
       );
     }
-    if (!graph.defaultSubAgentId) {
+    if (!agent.defaultSubAgentId) {
       return c.json(
         {
           jsonrpc: "2.0",
-          error: { code: -32004, message: "Graph does not have a default agent configured" },
+          error: { code: -32004, message: "Agent does not have a default agent configured" },
           id: null
         },
         400
       );
     }
-    executionContext.subAgentId = graph.defaultSubAgentId;
+    executionContext.subAgentId = agent.defaultSubAgentId;
     const credentialStores = c.get("credentialStores");
     const defaultSubAgent = await getRegisteredAgent(executionContext, credentialStores);
     if (!defaultSubAgent) {
@@ -9742,6 +9822,55 @@ init_dbClient();
 // src/a2a/transfer.ts
 init_dbClient();
 init_logger();
+function isTransferTask(result) {
+  console.log(
+    "[isTransferTask] Checking result:",
+    JSON.stringify(
+      {
+        hasArtifacts: "artifacts" in result,
+        artifactsLength: result.kind === "task" ? result.artifacts?.length : 0,
+        firstArtifactParts: result.kind === "task" ? result.artifacts?.[0]?.parts?.length : 0,
+        allParts: result.kind === "task" ? result.artifacts?.[0]?.parts?.map((p, i) => ({
+          index: i,
+          kind: p.kind,
+          hasData: !!(p.kind === "data" && p.data),
+          dataType: p.kind === "data" ? p.data?.type : void 0,
+          dataKeys: p.kind === "data" ? Object.keys(p.data) : []
+        })) : []
+      },
+      null,
+      2
+    )
+  );
+  if (!("artifacts" in result) || !result.artifacts) {
+    console.log("[isTransferTask] No artifacts found");
+    return false;
+  }
+  const hasTransfer = result.artifacts.some(
+    (artifact) => artifact.parts.some((part) => {
+      if (part.kind !== "data" || !part.data) return false;
+      const isTransfer = typeof part.data === "object" && "type" in part.data && part.data.type === "transfer";
+      if (isTransfer) {
+        console.log("[isTransferTask] Found transfer data:", JSON.stringify(part.data, null, 2));
+      }
+      return isTransfer;
+    })
+  );
+  console.log("[isTransferTask] Result:", hasTransfer);
+  return hasTransfer;
+}
+function extractTransferData(task) {
+  for (const artifact of task.artifacts) {
+    for (const part of artifact.parts) {
+      if (part.kind === "data" && part.data?.type === "transfer") {
+        return part.data;
+      }
+    }
+  }
+  return null;
+}
+
+// src/a2a/transfer.ts
 var logger21 = agentsCore.getLogger("Transfer");
 async function executeTransfer({
   tenantId,
@@ -9749,19 +9878,25 @@ async function executeTransfer({
   projectId,
   targetSubAgentId
 }) {
-  logger21.info({ targetAgent: targetSubAgentId }, "Executing transfer to agent");
-  await agentsCore.setActiveAgentForThread(dbClient_default)({
-    scopes: { tenantId, projectId },
+  logger21.info({
+    targetAgent: targetSubAgentId,
     threadId,
-    subAgentId: targetSubAgentId
-  });
+    tenantId,
+    projectId
+  }, "Executing transfer - calling setActiveAgentForThread");
+  try {
+    await agentsCore.setActiveAgentForThread(dbClient_default)({
+      scopes: { tenantId, projectId },
+      threadId,
+      subAgentId: targetSubAgentId
+    });
+    logger21.info({ targetAgent: targetSubAgentId, threadId }, "Successfully updated active_sub_agent_id in database");
+  } catch (error) {
+    logger21.error({ error, targetAgent: targetSubAgentId, threadId }, "Failed to update active_sub_agent_id");
+    throw error;
+  }
   return { success: true, targetSubAgentId };
 }
-function isTransferResponse(result) {
-  return result?.artifacts.some(
-    (artifact) => artifact.parts.some((part) => part.kind === "data" && part.data?.type === "transfer")
-  );
-}
 
 // src/handlers/executionHandler.ts
 init_dbClient();
@@ -10365,24 +10500,26 @@ var ExecutionHandler = class {
       sseHelper,
       emitOperations
     } = params;
-    const { tenantId, projectId, graphId, apiKey, baseUrl } = executionContext;
+    const { tenantId, projectId, agentId, apiKey, baseUrl } = executionContext;
     registerStreamHelper(requestId2, sseHelper);
-    graphSessionManager.createSession(requestId2, graphId, tenantId, projectId, conversationId);
+    agentSessionManager.createSession(requestId2, agentId, tenantId, projectId, conversationId);
     if (emitOperations) {
-      graphSessionManager.enableEmitOperations(requestId2);
+      agentSessionManager.enableEmitOperations(requestId2);
     }
     logger22.info(
-      { sessionId: requestId2, graphId, conversationId, emitOperations },
-      "Created GraphSession for message execution"
+      { sessionId: requestId2, agentId, conversationId, emitOperations },
+      "Created AgentSession for message execution"
     );
-    let graphConfig = null;
+    let agentConfig = null;
     try {
-      graphConfig = await agentsCore.getFullGraph(dbClient_default)({ scopes: { tenantId, projectId, graphId } });
-      if (graphConfig?.statusUpdates && graphConfig.statusUpdates.enabled !== false) {
-        graphSessionManager.initializeStatusUpdates(
+      agentConfig = await agentsCore.getFullAgent(dbClient_default)({
+        scopes: { tenantId, projectId, agentId }
+      });
+      if (agentConfig?.statusUpdates && agentConfig.statusUpdates.enabled !== false) {
+        agentSessionManager.initializeStatusUpdates(
           requestId2,
-          graphConfig.statusUpdates,
-          graphConfig.models?.summarizer
+          agentConfig.statusUpdates,
+          agentConfig.models?.summarizer
         );
       }
     } catch (error) {
@@ -10398,9 +10535,9 @@ var ExecutionHandler = class {
     let iterations = 0;
     let errorCount = 0;
     let task = null;
-    let fromAgentId;
+    let fromSubAgentId;
     try {
-      await sseHelper.writeOperation(agentInitializingOp(requestId2, graphId));
+      await sseHelper.writeOperation(agentInitializingOp(requestId2, agentId));
       const taskId = `task_${conversationId}-${requestId2}`;
       logger22.info(
         { taskId, currentAgentId, conversationId, requestId: requestId2 },
@@ -10411,7 +10548,7 @@ var ExecutionHandler = class {
           id: taskId,
           tenantId,
           projectId,
-          graphId,
+          agentId,
           subAgentId: currentAgentId,
           contextId: conversationId,
           status: "pending",
@@ -10419,11 +10556,11 @@ var ExecutionHandler = class {
             conversation_id: conversationId,
             message_id: requestId2,
             stream_request_id: requestId2,
-            // This also serves as the GraphSession ID
+            // This also serves as the AgentSession ID
             created_at: (/* @__PURE__ */ new Date()).toISOString(),
             updated_at: (/* @__PURE__ */ new Date()).toISOString(),
-            root_agent_id: initialAgentId,
-            agent_id: currentAgentId
+            root_sub_agent_id: initialAgentId,
+            sub_agent_id: currentAgentId
           }
         });
         logger22.info(
@@ -10460,6 +10597,7 @@ var ExecutionHandler = class {
           timestamp: (/* @__PURE__ */ new Date()).toISOString(),
           executionType: "create_initial_task",
           conversationId,
+          agentId,
           requestId: requestId2,
           currentAgentId,
           taskId: Array.isArray(task) ? task[0]?.id : task?.id,
@@ -10470,12 +10608,12 @@ var ExecutionHandler = class {
       );
       if (Array.isArray(task)) task = task[0];
       let currentMessage = userMessage;
-      const maxTransfers = graphConfig?.stopWhen?.transferCountIs ?? 10;
+      const maxTransfers = agentConfig?.stopWhen?.transferCountIs ?? 10;
       while (iterations < maxTransfers) {
         iterations++;
         logger22.info(
-          { iterations, currentAgentId, graphId, conversationId, fromAgentId },
-          `Execution loop iteration ${iterations} with agent ${currentAgentId}, transfer from: ${fromAgentId || "none"}`
+          { iterations, currentAgentId, agentId, conversationId, fromSubAgentId },
+          `Execution loop iteration ${iterations} with agent ${currentAgentId}, transfer from: ${fromSubAgentId || "none"}`
         );
         const activeAgent = await agentsCore.getActiveAgentForConversation(dbClient_default)({
           scopes: { tenantId, projectId },
@@ -10492,17 +10630,17 @@ var ExecutionHandler = class {
             Authorization: `Bearer ${apiKey}`,
             "x-inkeep-tenant-id": tenantId,
             "x-inkeep-project-id": projectId,
-            "x-inkeep-graph-id": graphId,
-            "x-inkeep-agent-id": currentAgentId
+            "x-inkeep-agent-id": agentId,
+            "x-inkeep-sub-agent-id": currentAgentId
           }
         });
         let messageResponse = null;
         const messageMetadata = {
           stream_request_id: requestId2
-          // This also serves as the GraphSession ID
+          // This also serves as the AgentSession ID
         };
-        if (fromAgentId) {
-          messageMetadata.fromAgentId = fromAgentId;
+        if (fromSubAgentId) {
+          messageMetadata.fromSubAgentId = fromSubAgentId;
         }
         messageResponse = await a2aClient.sendMessage({
           message: {
@@ -10546,17 +10684,28 @@ var ExecutionHandler = class {
                 }
               });
             }
-            graphSessionManager.endSession(requestId2);
+            agentSessionManager.endSession(requestId2);
             unregisterStreamHelper(requestId2);
             return { success: false, error: errorMessage2, iterations };
           }
           continue;
         }
-        if (isTransferResponse(messageResponse.result)) {
-          const transferResponse = messageResponse.result;
-          const targetSubAgentId = transferResponse.artifacts?.[0]?.parts?.[0]?.data?.targetSubAgentId;
-          const transferReason = transferResponse.artifacts?.[0]?.parts?.[1]?.text;
-          logger22.info({ targetSubAgentId, transferReason }, "transfer response");
+        if (isTransferTask(messageResponse.result)) {
+          const transferData = extractTransferData(messageResponse.result);
+          if (!transferData) {
+            logger22.error(
+              { result: messageResponse.result },
+              "Transfer detected but no transfer data found"
+            );
+            continue;
+          }
+          const { targetSubAgentId, fromSubAgentId: transferFromAgent } = transferData;
+          const firstArtifact = messageResponse.result.artifacts[0];
+          const transferReason = firstArtifact?.parts[1]?.kind === "text" ? firstArtifact.parts[1].text : "Transfer initiated";
+          logger22.info(
+            { targetSubAgentId, transferReason, transferFromAgent },
+            "Transfer response"
+          );
           currentMessage = `<transfer_context> ${transferReason} </transfer_context>`;
           const { success, targetSubAgentId: newAgentId } = await executeTransfer({
             projectId,
@@ -10565,15 +10714,15 @@ var ExecutionHandler = class {
             targetSubAgentId
           });
           if (success) {
-            fromAgentId = currentAgentId;
+            fromSubAgentId = currentAgentId;
             currentAgentId = newAgentId;
             logger22.info(
               {
-                transferFrom: fromAgentId,
+                transferFrom: fromSubAgentId,
                 transferTo: currentAgentId,
                 reason: transferReason
               },
-              "Transfer executed, tracking fromAgentId for next iteration"
+              "Transfer executed, tracking fromSubAgentId for next iteration"
             );
           }
           continue;
@@ -10595,10 +10744,10 @@ var ExecutionHandler = class {
           );
         }
         if (responseParts && responseParts.length > 0) {
-          const graphSessionData = graphSessionManager.getSession(requestId2);
-          if (graphSessionData) {
-            const sessionSummary = graphSessionData.getSummary();
-            logger22.info(sessionSummary, "GraphSession data after completion");
+          const agentSessionData = agentSessionManager.getSession(requestId2);
+          if (agentSessionData) {
+            const sessionSummary = agentSessionData.getSummary();
+            logger22.info(sessionSummary, "AgentSession data after completion");
           }
           let textContent = "";
           for (const part of responseParts) {
@@ -10657,8 +10806,8 @@ var ExecutionHandler = class {
               );
               await sseHelper.writeOperation(completionOp(currentAgentId, iterations));
               await sseHelper.complete();
-              logger22.info({}, "Ending GraphSession and cleaning up");
-              graphSessionManager.endSession(requestId2);
+              logger22.info({}, "Ending AgentSession and cleaning up");
+              agentSessionManager.endSession(requestId2);
               logger22.info({}, "Cleaning up streamHelper");
               unregisterStreamHelper(requestId2);
               let response;
@@ -10698,7 +10847,7 @@ var ExecutionHandler = class {
               }
             });
           }
-          graphSessionManager.endSession(requestId2);
+          agentSessionManager.endSession(requestId2);
           unregisterStreamHelper(requestId2);
           return { success: false, error: errorMessage2, iterations };
         }
@@ -10719,7 +10868,7 @@ var ExecutionHandler = class {
           }
         });
       }
-      graphSessionManager.endSession(requestId2);
+      agentSessionManager.endSession(requestId2);
       unregisterStreamHelper(requestId2);
       return { success: false, error: errorMessage, iterations };
     } catch (error) {
@@ -10741,7 +10890,7 @@ var ExecutionHandler = class {
           }
         });
       }
-      graphSessionManager.endSession(requestId2);
+      agentSessionManager.endSession(requestId2);
       unregisterStreamHelper(requestId2);
       return { success: false, error: errorMessage, iterations };
     }
@@ -10757,7 +10906,7 @@ var chatCompletionsRoute = zodOpenapi.createRoute({
   path: "/completions",
   tags: ["chat"],
   summary: "Create chat completion",
-  description: "Creates a new chat completion with streaming SSE response using the configured agent graph",
+  description: "Creates a new chat completion with streaming SSE response using the configured agent",
   security: [{ bearerAuth: [] }],
   request: {
     body: {
@@ -10832,7 +10981,7 @@ var chatCompletionsRoute = zodOpenapi.createRoute({
       }
     },
     404: {
-      description: "Agent graph or agent not found",
+      description: "Agent or agent not found",
       content: {
         "application/json": {
           schema: z6.z.object({
@@ -10879,48 +11028,48 @@ app2.openapi(chatCompletionsRoute, async (c) => {
   );
   try {
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { tenantId, projectId, graphId } = executionContext;
+    const { tenantId, projectId, agentId } = executionContext;
     agentsCore.getLogger("chat").debug(
       {
         tenantId,
-        graphId
+        agentId
       },
       "Extracted chat parameters from API key context"
     );
     const body = c.get("requestBody") || {};
     const conversationId = body.conversationId || agentsCore.getConversationId();
-    const fullGraph = await agentsCore.getFullGraph(dbClient_default)({
-      scopes: { tenantId, projectId, graphId }
+    const fullAgent = await agentsCore.getFullAgent(dbClient_default)({
+      scopes: { tenantId, projectId, agentId }
     });
-    let agentGraph;
+    let agent;
     let defaultSubAgentId;
-    if (fullGraph) {
-      agentGraph = {
-        id: fullGraph.id,
-        name: fullGraph.name,
+    if (fullAgent) {
+      agent = {
+        id: fullAgent.id,
+        name: fullAgent.name,
         tenantId,
         projectId,
-        defaultSubAgentId: fullGraph.defaultSubAgentId
+        defaultSubAgentId: fullAgent.defaultSubAgentId
       };
-      const agentKeys = Object.keys(fullGraph.subAgents || {});
+      const agentKeys = Object.keys(fullAgent.subAgents || {});
       const firstAgentId = agentKeys.length > 0 ? agentKeys[0] : "";
-      defaultSubAgentId = fullGraph.defaultSubAgentId || firstAgentId;
+      defaultSubAgentId = fullAgent.defaultSubAgentId || firstAgentId;
     } else {
-      agentGraph = await agentsCore.getAgentGraphWithDefaultSubAgent(dbClient_default)({
-        scopes: { tenantId, projectId, graphId }
+      agent = await agentsCore.getAgentWithDefaultSubAgent(dbClient_default)({
+        scopes: { tenantId, projectId, agentId }
       });
-      if (!agentGraph) {
+      if (!agent) {
         throw agentsCore.createApiError({
           code: "not_found",
-          message: "Agent graph not found"
+          message: "Agent not found"
         });
       }
-      defaultSubAgentId = agentGraph.defaultSubAgentId || "";
+      defaultSubAgentId = agent.defaultSubAgentId || "";
     }
     if (!defaultSubAgentId) {
       throw agentsCore.createApiError({
         code: "not_found",
-        message: "No default agent found in graph"
+        message: "No default agent found in agent"
       });
     }
     await agentsCore.createOrGetConversation(dbClient_default)({
@@ -10942,7 +11091,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
     }
     const subAgentId = activeAgent?.activeSubAgentId || defaultSubAgentId;
     const agentInfo = await agentsCore.getSubAgentById(dbClient_default)({
-      scopes: { tenantId, projectId, graphId },
+      scopes: { tenantId, projectId, agentId },
       subAgentId
     });
     if (!agentInfo) {
@@ -10956,7 +11105,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
     await agentsCore.handleContextResolution({
       tenantId,
       projectId,
-      graphId,
+      agentId,
       conversationId,
       headers: validatedContext,
       dbClient: dbClient_default,
@@ -10966,11 +11115,11 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       {
         tenantId,
         projectId,
-        graphId,
+        agentId,
         conversationId,
         defaultSubAgentId,
         activeSubAgentId: activeAgent?.activeSubAgentId || "none",
-        hasContextConfig: !!agentGraph.contextConfigId,
+        hasContextConfig: !!agent.contextConfigId,
         hasHeaders: !!body.headers,
         hasValidatedContext: !!validatedContext,
         validatedContextKeys: Object.keys(validatedContext)
@@ -11139,8 +11288,8 @@ app3.use("/chat", agentsCore.contextValidationMiddleware(dbClient_default));
 app3.openapi(chatDataStreamRoute, async (c) => {
   try {
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { tenantId, projectId, graphId } = executionContext;
-    agentsCore.loggerFactory.getLogger("chatDataStream").debug({ tenantId, projectId, graphId }, "Extracted chatDataStream parameters");
+    const { tenantId, projectId, agentId } = executionContext;
+    agentsCore.loggerFactory.getLogger("chatDataStream").debug({ tenantId, projectId, agentId }, "Extracted chatDataStream parameters");
     const body = c.get("requestBody") || {};
     const conversationId = body.conversationId || agentsCore.getConversationId();
     const activeSpan = api.trace.getActiveSpan();
@@ -11148,25 +11297,25 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       activeSpan.setAttributes({
         "conversation.id": conversationId,
         "tenant.id": tenantId,
-        "graph.id": graphId,
+        "agent.id": agentId,
         "project.id": projectId
       });
     }
-    const agentGraph = await agentsCore.getAgentGraphWithDefaultSubAgent(dbClient_default)({
-      scopes: { tenantId, projectId, graphId }
+    const agent = await agentsCore.getAgentWithDefaultSubAgent(dbClient_default)({
+      scopes: { tenantId, projectId, agentId }
     });
-    if (!agentGraph) {
+    if (!agent) {
       throw agentsCore.createApiError({
         code: "not_found",
-        message: "Agent graph not found"
+        message: "Agent not found"
       });
     }
-    const defaultSubAgentId = agentGraph.defaultSubAgentId;
-    const graphName = agentGraph.name;
+    const defaultSubAgentId = agent.defaultSubAgentId;
+    const agentName = agent.name;
     if (!defaultSubAgentId) {
       throw agentsCore.createApiError({
         code: "bad_request",
-        message: "Graph does not have a default agent configured"
+        message: "Agent does not have a default agent configured"
       });
     }
     const activeAgent = await agentsCore.getActiveAgentForConversation(dbClient_default)({
@@ -11182,7 +11331,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
     }
     const subAgentId = activeAgent?.activeSubAgentId || defaultSubAgentId;
     const agentInfo = await agentsCore.getSubAgentById(dbClient_default)({
-      scopes: { tenantId, projectId, graphId },
+      scopes: { tenantId, projectId, agentId },
       subAgentId
     });
     if (!agentInfo) {
@@ -11196,7 +11345,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
     await agentsCore.handleContextResolution({
       tenantId,
       projectId,
-      graphId,
+      agentId,
       conversationId,
       headers: validatedContext,
       dbClient: dbClient_default,
@@ -11210,7 +11359,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       messageSpan.setAttributes({
         "message.timestamp": (/* @__PURE__ */ new Date()).toISOString(),
         "message.content": userText,
-        "graph.name": graphName
+        "agent.name": agentName
       });
     }
     await agentsCore.createMessage(dbClient_default)({
@@ -11350,7 +11499,7 @@ var spoofTransportInitialization = async (transport, req, sessionId, mcpProtocol
     logger25.warn({ sessionId, error: spoofError }, "Spoof initialization failed, continuing anyway");
   }
 };
-var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
+var validateSession = async (req, res, body, tenantId, projectId, agentId) => {
   const sessionId = req.headers["mcp-session-id"];
   logger25.info({ sessionId }, "Received MCP session ID");
   if (!sessionId) {
@@ -11385,12 +11534,12 @@ var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
       sessionId,
       conversationFound: !!conversation,
       sessionType: conversation?.metadata?.sessionData?.sessionType,
-      storedGraphId: conversation?.metadata?.sessionData?.graphId,
-      requestGraphId: graphId
+      storedAgentId: conversation?.metadata?.sessionData?.agentId,
+      requestAgentId: agentId
     },
     "Conversation lookup result"
   );
-  if (!conversation || conversation.metadata?.sessionData?.sessionType !== "mcp" || conversation.metadata?.sessionData?.graphId !== graphId) {
+  if (!conversation || conversation.metadata?.sessionData?.sessionType !== "mcp" || conversation.metadata?.sessionData?.agentId !== agentId) {
     logger25.info(
       { sessionId, conversationId: conversation?.id },
       "MCP session not found or invalid"
@@ -11409,13 +11558,13 @@ var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
   }
   return conversation;
 };
-var setupTracing = (conversationId, tenantId, graphId) => {
+var setupTracing = (conversationId, tenantId, agentId) => {
   const activeSpan = api.trace.getActiveSpan();
   if (activeSpan) {
     activeSpan.setAttributes({
       "conversation.id": conversationId,
       "tenant.id": tenantId,
-      "graph.id": graphId
+      "agent.id": agentId
     });
   }
 };
@@ -11477,13 +11626,13 @@ var executeAgentQuery = async (executionContext, conversationId, query, defaultS
   };
 };
 var getServer = async (headers, executionContext, conversationId, credentialStores) => {
-  const { tenantId, projectId, graphId } = executionContext;
-  setupTracing(conversationId, tenantId, graphId);
-  const agentGraph = await agentsCore.getAgentGraphWithDefaultSubAgent(dbClient_default)({
-    scopes: { tenantId, projectId, graphId }
+  const { tenantId, projectId, agentId } = executionContext;
+  setupTracing(conversationId, tenantId, agentId);
+  const agent = await agentsCore.getAgentWithDefaultSubAgent(dbClient_default)({
+    scopes: { tenantId, projectId, agentId }
   });
-  if (!agentGraph) {
-    throw new Error("Agent graph not found");
+  if (!agent) {
+    throw new Error("Agent not found");
   }
   const server = new mcp_js.McpServer(
     {
@@ -11494,26 +11643,26 @@ var getServer = async (headers, executionContext, conversationId, credentialStor
   );
   server.tool(
     "send-query-to-agent",
-    `Send a query to the ${agentGraph.name} agent. The agent has the following description: ${agentGraph.description}`,
+    `Send a query to the ${agent.name} agent. The agent has the following description: ${agent.description}`,
     {
       query: createMCPSchema(v3.z.string().describe("The query to send to the agent"))
     },
     async ({ query }) => {
       try {
-        if (!agentGraph.defaultSubAgentId) {
+        if (!agent.defaultSubAgentId) {
           return {
             content: [
               {
                 type: "text",
-                text: `Graph does not have a default agent configured`
+                text: `Agent does not have a default agent configured`
               }
             ],
             isError: true
           };
         }
-        const defaultSubAgentId = agentGraph.defaultSubAgentId;
+        const defaultSubAgentId = agent.defaultSubAgentId;
         const agentInfo = await agentsCore.getSubAgentById(dbClient_default)({
-          scopes: { tenantId, projectId, graphId },
+          scopes: { tenantId, projectId, agentId },
           subAgentId: defaultSubAgentId
         });
         if (!agentInfo) {
@@ -11530,7 +11679,7 @@ var getServer = async (headers, executionContext, conversationId, credentialStor
         const resolvedContext = await agentsCore.handleContextResolution({
           tenantId,
           projectId,
-          graphId,
+          agentId,
           conversationId,
           headers,
           dbClient: dbClient_default,
@@ -11540,9 +11689,9 @@ var getServer = async (headers, executionContext, conversationId, credentialStor
           {
             tenantId,
             projectId,
-            graphId,
+            agentId,
             conversationId,
-            hasContextConfig: !!agentGraph.contextConfigId,
+            hasContextConfig: !!agent.contextConfigId,
             hasHeaders: !!headers,
             hasValidatedContext: !!resolvedContext
           },
@@ -11575,8 +11724,8 @@ app4.use("/", async (c, next) => {
 var validateRequestParameters = (c) => {
   try {
     const executionContext = agentsCore.getRequestExecutionContext(c);
-    const { tenantId, projectId, graphId } = executionContext;
-    agentsCore.getLogger("mcp").debug({ tenantId, projectId, graphId }, "Extracted MCP entity parameters");
+    const { tenantId, projectId, agentId } = executionContext;
+    agentsCore.getLogger("mcp").debug({ tenantId, projectId, agentId }, "Extracted MCP entity parameters");
     return { valid: true, executionContext };
   } catch (error) {
     agentsCore.getLogger("chat").warn(
@@ -11597,27 +11746,27 @@ var validateRequestParameters = (c) => {
   }
 };
 var handleInitializationRequest = async (body, executionContext, validatedContext, req, res, c, credentialStores) => {
-  const { tenantId, projectId, graphId } = executionContext;
+  const { tenantId, projectId, agentId } = executionContext;
   logger25.info({ body }, "Received initialization request");
   const sessionId = agentsCore.getConversationId();
-  const agentGraph = await agentsCore.getAgentGraphWithDefaultSubAgent(dbClient_default)({
-    scopes: { tenantId, projectId, graphId }
+  const agent = await agentsCore.getAgentWithDefaultSubAgent(dbClient_default)({
+    scopes: { tenantId, projectId, agentId }
   });
-  if (!agentGraph) {
+  if (!agent) {
     return c.json(
       {
         jsonrpc: "2.0",
-        error: { code: -32001, message: "Agent graph not found" },
+        error: { code: -32001, message: "Agent not found" },
         id: body.id || null
       },
       { status: 404 }
     );
   }
-  if (!agentGraph.defaultSubAgentId) {
+  if (!agent.defaultSubAgentId) {
     return c.json(
       {
         jsonrpc: "2.0",
-        error: { code: -32001, message: "Graph does not have a default agent configured" },
+        error: { code: -32001, message: "Agent does not have a default agent configured" },
         id: body.id || null
       },
       { status: 400 }
@@ -11627,10 +11776,10 @@ var handleInitializationRequest = async (body, executionContext, validatedContex
     id: sessionId,
     tenantId,
     projectId,
-    activeSubAgentId: agentGraph.defaultSubAgentId,
+    activeSubAgentId: agent.defaultSubAgentId,
     metadata: {
       sessionData: {
-        graphId,
+        agentId,
         sessionType: "mcp",
         mcpProtocolVersion: c.req.header("mcp-protocol-version"),
         initialized: false
@@ -11662,8 +11811,8 @@ var handleInitializationRequest = async (body, executionContext, validatedContex
   return fetchToNode.toFetchResponse(res);
 };
 var handleExistingSessionRequest = async (body, executionContext, validatedContext, req, res, credentialStores) => {
-  const { tenantId, projectId, graphId } = executionContext;
-  const conversation = await validateSession(req, res, body, tenantId, projectId, graphId);
+  const { tenantId, projectId, agentId } = executionContext;
+  const conversation = await validateSession(req, res, body, tenantId, projectId, agentId);
   if (!conversation) {
     return fetchToNode.toFetchResponse(res);
   }
@@ -11739,7 +11888,7 @@ app4.openapi(
         description: "Unauthorized - API key authentication required"
       },
       404: {
-        description: "Not Found - Agent graph not found"
+        description: "Not Found - Agent not found"
       },
       500: {
         description: "Internal Server Error"
@@ -11957,7 +12106,7 @@ function createExecutionHono(serverConfig, credentialStores) {
       logger26.debug({}, "Empty execution context");
       return next();
     }
-    const { tenantId, projectId, graphId } = executionContext;
+    const { tenantId, projectId, agentId } = executionContext;
     let conversationId;
     const requestBody = c.get("requestBody") || {};
     if (requestBody) {
@@ -11968,7 +12117,7 @@ function createExecutionHono(serverConfig, credentialStores) {
     }
     const entries = Object.fromEntries(
       Object.entries({
-        "graph.id": graphId,
+        "agent.id": agentId,
         "tenant.id": tenantId,
         "project.id": projectId,
         "conversation.id": conversationId