@inkeep/agents-manage-api 0.2.1 → 0.3.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { getLogger as getLogger$1, createDatabaseClient, commonGetErrorResponses, TenantProjectParamsSchema, ArtifactComponentApiSelectSchema, getArtifactComponentsForAgent, getAgentsUsingArtifactComponent, ErrorResponseSchema, SingleResponseSchema, AgentArtifactComponentApiInsertSchema, AgentArtifactComponentApiSelectSchema, getAgentById, getArtifactComponentById, createApiError, isArtifactComponentAssociatedWithAgent, associateArtifactComponentWithAgent, RemovedResponseSchema, removeArtifactComponentFromAgent, ExistsResponseSchema, DataComponentApiSelectSchema, getDataComponentsForAgent, getAgentsUsingDataComponent, AgentDataComponentApiInsertSchema, AgentDataComponentApiSelectSchema, getDataComponent, isDataComponentAssociatedWithAgent, associateDataComponentWithAgent, removeDataComponentFromAgent, ListResponseSchema, PaginationQueryParamsSchema, AgentGraphApiSelectSchema, listAgentGraphs, IdParamsSchema, getAgentGraph, getGraphAgentInfos, FullGraphDefinitionSchema, getFullGraphDefinition, AgentGraphApiInsertSchema, createAgentGraph, AgentGraphApiUpdateSchema, updateAgentGraph, deleteAgentGraph, AgentRelationApiSelectSchema, AgentRelationQuerySchema, getAgentRelationsBySource, getAgentRelationsByTarget, getExternalAgentRelations, listAgentRelations, getAgentRelationById, AgentRelationApiInsertSchema, validateExternalAgent, validateInternalAgent, createAgentRelation, AgentRelationApiUpdateSchema, updateAgentRelation, deleteAgentRelation, AgentApiSelectSchema, listAgentsPaginated, TenantProjectIdParamsSchema, AgentApiInsertSchema, createAgent, AgentApiUpdateSchema, updateAgent, deleteAgent, AgentToolRelationApiSelectSchema, getAgentToolRelationByAgent, getAgentToolRelationByTool, listAgentToolRelations, getAgentToolRelationById, getToolsForAgent, getAgentsForTool, AgentToolRelationApiInsertSchema, createAgentToolRelation, AgentToolRelationApiUpdateSchema, updateAgentToolRelation, deleteAgentToolRelation, ApiKeyApiSelectSchema, listApiKeysPaginated, getApiKeyById, ApiKeyApiCreationResponseSchema, ApiKeyApiInsertSchema, generateApiKey, createApiKey, ApiKeyApiUpdateSchema, updateApiKey, deleteApiKey, listArtifactComponentsPaginated, ArtifactComponentApiInsertSchema, createArtifactComponent, ArtifactComponentApiUpdateSchema, updateArtifactComponent, deleteArtifactComponent, ContextConfigApiSelectSchema, listContextConfigsPaginated, getContextConfigById, ContextConfigApiInsertSchema, createContextConfig, commonUpdateErrorResponses, ContextConfigApiUpdateSchema, updateContextConfig, commonDeleteErrorResponses, deleteContextConfig, CredentialReferenceApiSelectSchema, listCredentialReferencesPaginated, getCredentialReferenceById, CredentialReferenceApiInsertSchema, createCredentialReference, CredentialReferenceApiUpdateSchema, updateCredentialReference, getCredentialStoreLookupKeyFromRetrievalParams, deleteCredentialReference, listDataComponentsPaginated, DataComponentApiInsertSchema, createDataComponent, DataComponentApiUpdateSchema, updateDataComponent, deleteDataComponent, ExternalAgentApiSelectSchema, listExternalAgentsPaginated, getExternalAgent, ExternalAgentApiInsertSchema, createExternalAgent, ExternalAgentApiUpdateSchema, updateExternalAgent, deleteExternalAgent, createFullGraphServerSide, getFullGraph, updateFullGraphServerSide, deleteFullGraph, TenantParamsSchema, ProjectApiSelectSchema, listProjectsPaginated, TenantIdParamsSchema, getProject, ProjectApiInsertSchema, createProject, ProjectApiUpdateSchema, updateProject, deleteProject, McpToolSchema, ToolStatusSchema, listToolsByStatus, dbResultToMcpTool, listTools, getToolById, ToolApiInsertSchema, createTool, ToolApiUpdateSchema, updateTool, deleteTool, getCredentialReference, CredentialStoreType, FullProjectDefinitionSchema, createFullProjectServerSide, getFullProject, updateFullProjectServerSide, deleteFullProject, createDefaultCredentialStores, CredentialStoreRegistry, ContextResolver, CredentialStuffer, McpClient, detectAuthenticationRequired, handleApiError, MCPServerType, MCPTransportType } from '@inkeep/agents-core';
+import { loadEnvironmentFiles, getLogger as getLogger$1, createDatabaseClient, commonGetErrorResponses, TenantProjectGraphParamsSchema, ArtifactComponentApiSelectSchema, getArtifactComponentsForAgent, getAgentsUsingArtifactComponent, ErrorResponseSchema, SingleResponseSchema, AgentArtifactComponentApiInsertSchema, AgentArtifactComponentApiSelectSchema, getAgentById, getArtifactComponentById, createApiError, isArtifactComponentAssociatedWithAgent, associateArtifactComponentWithAgent, RemovedResponseSchema, removeArtifactComponentFromAgent, ExistsResponseSchema, DataComponentApiSelectSchema, getDataComponentsForAgent, getAgentsUsingDataComponent, AgentDataComponentApiInsertSchema, AgentDataComponentApiSelectSchema, getDataComponent, isDataComponentAssociatedWithAgent, associateDataComponentWithAgent, removeDataComponentFromAgent, ListResponseSchema, PaginationQueryParamsSchema, TenantProjectParamsSchema, AgentGraphApiSelectSchema, listAgentGraphs, IdParamsSchema, getAgentGraphById, getGraphAgentInfos, FullGraphDefinitionSchema, getFullGraphDefinition, AgentGraphApiInsertSchema, createAgentGraph, AgentGraphApiUpdateSchema, updateAgentGraph, deleteAgentGraph, AgentRelationApiSelectSchema, AgentRelationQuerySchema, getAgentRelationsBySource, getAgentRelationsByTarget, getExternalAgentRelations, listAgentRelations, TenantProjectGraphIdParamsSchema, getAgentRelationById, AgentRelationApiInsertSchema, validateExternalAgent, validateInternalAgent, createAgentRelation, AgentRelationApiUpdateSchema, updateAgentRelation, deleteAgentRelation, AgentApiSelectSchema, listAgentsPaginated, AgentApiInsertSchema, createAgent, AgentApiUpdateSchema, updateAgent, deleteAgent, AgentToolRelationApiSelectSchema, getAgentToolRelationByAgent, getAgentToolRelationByTool, listAgentToolRelations, getAgentToolRelationById, getToolsForAgent, getAgentsForTool, AgentToolRelationApiInsertSchema, createAgentToolRelation, AgentToolRelationApiUpdateSchema, updateAgentToolRelation, deleteAgentToolRelation, ApiKeyApiSelectSchema, listApiKeysPaginated, getApiKeyById, ApiKeyApiCreationResponseSchema, ApiKeyApiInsertSchema, generateApiKey, createApiKey, ApiKeyApiUpdateSchema, updateApiKey, deleteApiKey, listArtifactComponentsPaginated, ArtifactComponentApiInsertSchema, createArtifactComponent, ArtifactComponentApiUpdateSchema, updateArtifactComponent, deleteArtifactComponent, ContextConfigApiSelectSchema, listContextConfigsPaginated, getContextConfigById, ContextConfigApiInsertSchema, createContextConfig, commonUpdateErrorResponses, ContextConfigApiUpdateSchema, updateContextConfig, commonDeleteErrorResponses, deleteContextConfig, CredentialReferenceApiSelectSchema, listCredentialReferencesPaginated, getCredentialReferenceById, CredentialReferenceApiInsertSchema, createCredentialReference, CredentialReferenceApiUpdateSchema, updateCredentialReference, getCredentialStoreLookupKeyFromRetrievalParams, deleteCredentialReference, listDataComponentsPaginated, DataComponentApiInsertSchema, createDataComponent, DataComponentApiUpdateSchema, updateDataComponent, deleteDataComponent, ExternalAgentApiSelectSchema, listExternalAgentsPaginated, getExternalAgent, ExternalAgentApiInsertSchema, createExternalAgent, ExternalAgentApiUpdateSchema, updateExternalAgent, deleteExternalAgent, createFullGraphServerSide, getFullGraph, updateFullGraphServerSide, deleteFullGraph, TenantParamsSchema, ProjectApiSelectSchema, listProjectsPaginated, TenantIdParamsSchema, getProject, ProjectApiInsertSchema, createProject, ProjectApiUpdateSchema, updateProject, deleteProject, McpToolSchema, ToolStatusSchema, listToolsByStatus, dbResultToMcpTool, listTools, getToolById, ToolApiInsertSchema, createTool, ToolApiUpdateSchema, updateTool, deleteTool, getCredentialReference, CredentialStoreType, FullProjectDefinitionSchema, createFullProjectServerSide, getFullProject, updateFullProjectServerSide, deleteFullProject, createDefaultCredentialStores, CredentialStoreRegistry, ContextResolver, CredentialStuffer, McpClient, detectAuthenticationRequired, handleApiError, MCPServerType, MCPTransportType } from '@inkeep/agents-core';
 import { OpenAPIHono, createRoute, z as z$1 } from '@hono/zod-openapi';
 import { Hono } from 'hono';
 import { cors } from 'hono/cors';
@@ -7,9 +7,6 @@ import { requestId } from 'hono/request-id';
 import { pinoLogger } from 'hono-pino';
 import { AsyncLocalStorage } from 'async_hooks';
 import { pino } from 'pino';
-import fs from 'fs';
-import path from 'path';
-import * as dotenv from 'dotenv';
 import { z } from 'zod';
 import { createMiddleware } from 'hono/factory';
 import { swaggerUI } from '@hono/swagger-ui';
@@ -18,29 +15,12 @@ import { nanoid } from 'nanoid';
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
-dotenv.config({ quiet: true });
-z.enum(["development", "production"]).default("development");
-var environmentSchema = z.enum(["development", "pentest", "production", "test"]);
-var criticalEnv = z.object({
-  ENVIRONMENT: environmentSchema
-}).parse(process.env);
-var loadEnvFile = () => {
-  const envPath = path.resolve(process.cwd(), `.env.${criticalEnv.ENVIRONMENT}.nonsecret`);
-  if (fs.existsSync(envPath)) {
-    const envConfig = dotenv.parse(fs.readFileSync(envPath));
-    for (const k in envConfig) {
-      if (!(k in process.env)) {
-        process.env[k] = envConfig[k];
-      }
-    }
-  }
-};
-loadEnvFile();
+loadEnvironmentFiles();
 var envSchema = z.object({
   NODE_ENV: z.enum(["development", "production", "test"]).optional(),
   ENVIRONMENT: z.enum(["development", "production", "pentest", "test"]).optional(),
   AGENTS_MANAGE_API_URL: z.string().optional().default("http://localhost:3002"),
-  DB_FILE_NAME: z.string().default("file:../local.db"),
+  DB_FILE_NAME: z.string(),
   LOG_LEVEL: z.enum(["trace", "debug", "info", "warn", "error"]).optional().default("debug"),
   NANGO_SECRET_KEY: z.string().optional(),
   INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET: z.string().optional()
@@ -166,9 +146,9 @@ app.openapi(
     path: "/agent/:agentId",
     summary: "Get Artifact Components for Agent",
     operationId: "get-artifact-components-for-agent",
-    tags: ["CRUD Agent Artifact Component Relations"],
+    tags: ["Agent Artifact Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string()
       })
     },
@@ -187,10 +167,9 @@ app.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId } = c.req.valid("param");
     const artifactComponents = await getArtifactComponentsForAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId
+      scopes: { tenantId, projectId, graphId, agentId }
     });
     return c.json({
       data: artifactComponents
@@ -203,9 +182,9 @@ app.openapi(
     path: "/component/:artifactComponentId/agents",
     summary: "Get Agents Using Artifact Component",
     operationId: "get-agents-using-artifact-component",
-    tags: ["CRUD Agent Artifact Component Relations"],
+    tags: ["Agent Artifact Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         artifactComponentId: z.string()
       })
     },
@@ -243,9 +222,9 @@ app.openapi(
     path: "/",
     summary: "Associate Artifact Component with Agent",
     operationId: "associate-artifact-component-with-agent",
-    tags: ["CRUD Agent Artifact Component Relations"],
+    tags: ["Agent Artifact Component Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -275,9 +254,12 @@ app.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const { agentId, artifactComponentId } = c.req.valid("json");
-    const agent = await getAgentById(dbClient_default)({ scopes: { tenantId, projectId }, agentId });
+    const agent = await getAgentById(dbClient_default)({
+      scopes: { tenantId, projectId, graphId },
+      agentId
+    });
     const artifactComponent = await getArtifactComponentById(dbClient_default)({
       scopes: { tenantId, projectId },
       id: artifactComponentId
@@ -295,8 +277,7 @@ app.openapi(
       });
     }
     const exists = await isArtifactComponentAssociatedWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       artifactComponentId
     });
     if (exists) {
@@ -306,8 +287,7 @@ app.openapi(
       });
     }
     const association = await associateArtifactComponentWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       artifactComponentId
     });
     return c.json({ data: association }, 201);
@@ -319,9 +299,9 @@ app.openapi(
     path: "/agent/:agentId/component/:artifactComponentId",
     summary: "Remove Artifact Component from Agent",
     operationId: "remove-artifact-component-from-agent",
-    tags: ["CRUD Agent Artifact Component Relations"],
+    tags: ["Agent Artifact Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string(),
         artifactComponentId: z.string()
       })
@@ -339,10 +319,9 @@ app.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId, artifactComponentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId, artifactComponentId } = c.req.valid("param");
     const removed = await removeArtifactComponentFromAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       artifactComponentId
     });
     if (!removed) {
@@ -363,9 +342,9 @@ app.openapi(
     path: "/agent/:agentId/component/:artifactComponentId/exists",
     summary: "Check if Artifact Component is Associated with Agent",
     operationId: "check-artifact-component-agent-association",
-    tags: ["CRUD Agent Artifact Component Relations"],
+    tags: ["Agent Artifact Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string(),
         artifactComponentId: z.string()
       })
@@ -383,10 +362,9 @@ app.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId, artifactComponentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId, artifactComponentId } = c.req.valid("param");
     const exists = await isArtifactComponentAssociatedWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       artifactComponentId
     });
     return c.json({ exists });
@@ -400,9 +378,9 @@ app2.openapi(
     path: "/agent/:agentId",
     summary: "Get Data Components for Agent",
     operationId: "get-data-components-for-agent",
-    tags: ["CRUD Agent Data Component Relations"],
+    tags: ["Agent Data Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string()
       })
     },
@@ -421,10 +399,9 @@ app2.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId } = c.req.valid("param");
     const dataComponents = await getDataComponentsForAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId
+      scopes: { tenantId, projectId, graphId, agentId }
     });
     return c.json({ data: dataComponents });
   }
@@ -435,9 +412,9 @@ app2.openapi(
     path: "/component/:dataComponentId/agents",
     summary: "Get Agents Using Data Component",
     operationId: "get-agents-using-data-component",
-    tags: ["CRUD Agent Data Component Relations"],
+    tags: ["Agent Data Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         dataComponentId: z.string()
       })
     },
@@ -475,9 +452,9 @@ app2.openapi(
     path: "/",
     summary: "Associate Data Component with Agent",
     operationId: "associate-data-component-with-agent",
-    tags: ["CRUD Agent Data Component Relations"],
+    tags: ["Agent Data Component Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -507,10 +484,10 @@ app2.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const { agentId, dataComponentId } = c.req.valid("json");
     const [agent, dataComponent] = await Promise.all([
-      getAgentById(dbClient_default)({ scopes: { tenantId, projectId }, agentId }),
+      getAgentById(dbClient_default)({ scopes: { tenantId, projectId, graphId }, agentId }),
       getDataComponent(dbClient_default)({ scopes: { tenantId, projectId }, dataComponentId })
     ]);
     if (!agent) {
@@ -526,8 +503,7 @@ app2.openapi(
       });
     }
     const exists = await isDataComponentAssociatedWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       dataComponentId
     });
     if (exists) {
@@ -537,8 +513,7 @@ app2.openapi(
       });
     }
     const association = await associateDataComponentWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       dataComponentId
     });
     return c.json({ data: association }, 201);
@@ -550,9 +525,9 @@ app2.openapi(
     path: "/agent/:agentId/component/:dataComponentId",
     summary: "Remove Data Component from Agent",
     operationId: "remove-data-component-from-agent",
-    tags: ["CRUD Agent Data Component Relations"],
+    tags: ["Agent Data Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string(),
         dataComponentId: z.string()
       })
@@ -570,10 +545,9 @@ app2.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId, dataComponentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId, dataComponentId } = c.req.valid("param");
     const removed = await removeDataComponentFromAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       dataComponentId
     });
     if (!removed) {
@@ -594,9 +568,9 @@ app2.openapi(
     path: "/agent/:agentId/component/:dataComponentId/exists",
     summary: "Check if Data Component is Associated with Agent",
     operationId: "check-data-component-agent-association",
-    tags: ["CRUD Agent Data Component Relations"],
+    tags: ["Agent Data Component Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string(),
         dataComponentId: z.string()
       })
@@ -614,10 +588,9 @@ app2.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId, dataComponentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId, dataComponentId } = c.req.valid("param");
     const exists = await isDataComponentAssociatedWithAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       dataComponentId
     });
     return c.json({ exists });
@@ -631,7 +604,7 @@ app3.openapi(
     path: "/",
     summary: "List Agent Graphs",
     operationId: "list-agent-graphs",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema
@@ -670,7 +643,7 @@ app3.openapi(
     path: "/{id}",
     summary: "Get Agent Graph",
     operationId: "get-agent-graph",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -688,9 +661,8 @@ app3.openapi(
   }),
   async (c) => {
     const { tenantId, projectId, id } = c.req.valid("param");
-    const graph = await getAgentGraph(dbClient_default)({
-      scopes: { tenantId, projectId },
-      graphId: id
+    const graph = await getAgentGraphById(dbClient_default)({
+      scopes: { tenantId, projectId, graphId: id }
     });
     if (!graph) {
       throw createApiError({
@@ -707,7 +679,7 @@ app3.openapi(
     path: "/{graphId}/agents/{agentId}/related",
     summary: "Get Related Agent Infos",
     operationId: "get-related-agent-infos",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema.extend({
         graphId: z.string(),
@@ -756,7 +728,7 @@ app3.openapi(
     path: "/{graphId}/full",
     summary: "Get Full Graph Definition",
     operationId: "get-full-graph-definition",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema.extend({
         graphId: z.string()
@@ -777,8 +749,7 @@ app3.openapi(
   async (c) => {
     const { tenantId, projectId, graphId } = c.req.valid("param");
     const fullGraph = await getFullGraphDefinition(dbClient_default)({
-      scopes: { tenantId, projectId },
-      graphId
+      scopes: { tenantId, projectId, graphId }
     });
     if (!fullGraph) {
       throw createApiError({
@@ -795,7 +766,7 @@ app3.openapi(
     path: "/",
     summary: "Create Agent Graph",
     operationId: "create-agent-graph",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -838,7 +809,7 @@ app3.openapi(
     path: "/{id}",
     summary: "Update Agent Graph",
     operationId: "update-agent-graph",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -865,8 +836,7 @@ app3.openapi(
     const { tenantId, projectId, id } = c.req.valid("param");
     const validatedBody = c.req.valid("json");
     const updatedGraph = await updateAgentGraph(dbClient_default)({
-      scopes: { tenantId, projectId },
-      graphId: id,
+      scopes: { tenantId, projectId, graphId: id },
       data: {
         defaultAgentId: validatedBody.defaultAgentId,
         contextConfigId: validatedBody.contextConfigId ?? void 0
@@ -887,7 +857,7 @@ app3.openapi(
     path: "/{id}",
     summary: "Delete Agent Graph",
     operationId: "delete-agent-graph",
-    tags: ["CRUD Agent Graph"],
+    tags: ["Agent Graph"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -908,8 +878,7 @@ app3.openapi(
   async (c) => {
     const { tenantId, projectId, id } = c.req.valid("param");
     const deleted = await deleteAgentGraph(dbClient_default)({
-      scopes: { tenantId, projectId },
-      graphId: id
+      scopes: { tenantId, projectId, graphId: id }
     });
     if (!deleted) {
       throw createApiError({
@@ -928,9 +897,9 @@ app4.openapi(
     path: "/",
     summary: "List Agent Relations",
     operationId: "list-agent-relations",
-    tags: ["CRUD Agent Relations"],
+    tags: ["Agent Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       query: PaginationQueryParamsSchema.merge(AgentRelationQuerySchema)
     },
     responses: {
@@ -946,7 +915,7 @@ app4.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const {
       page = 1,
       limit = 10,
@@ -960,28 +929,28 @@ app4.openapi(
       let result;
       if (sourceAgentId) {
         const rawResult = await getAgentRelationsBySource(dbClient_default)({
-          scopes: { tenantId, projectId },
+          scopes: { tenantId, projectId, graphId },
           sourceAgentId,
           pagination: { page: pageNum, limit: limitNum }
         });
         result = { ...rawResult, data: rawResult.data };
       } else if (targetAgentId) {
         const rawResult = await getAgentRelationsByTarget(dbClient_default)({
-          scopes: { tenantId, projectId },
+          scopes: { tenantId, projectId, graphId },
           targetAgentId,
           pagination: { page: pageNum, limit: limitNum }
         });
         result = { ...rawResult, data: rawResult.data };
       } else if (externalAgentId) {
         const rawResult = await getExternalAgentRelations(dbClient_default)({
-          scopes: { tenantId, projectId },
+          scopes: { tenantId, projectId, graphId },
           externalAgentId,
           pagination: { page: pageNum, limit: limitNum }
         });
         result = { ...rawResult, data: rawResult.data };
       } else {
         const rawResult = await listAgentRelations(dbClient_default)({
-          scopes: { tenantId, projectId },
+          scopes: { tenantId, projectId, graphId },
           pagination: { page: pageNum, limit: limitNum }
         });
         result = { ...rawResult, data: rawResult.data };
@@ -1001,9 +970,9 @@ app4.openapi(
     path: "/{id}",
     summary: "Get Agent Relation",
     operationId: "get-agent-relation-by-id",
-    tags: ["CRUD Agent Relations"],
+    tags: ["Agent Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       200: {
@@ -1018,9 +987,9 @@ app4.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const agentRelation = await getAgentRelationById(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       relationId: id
     });
     if (!agentRelation) {
@@ -1038,9 +1007,9 @@ app4.openapi(
     path: "/",
     summary: "Create Agent Relation",
     operationId: "create-agent-relation",
-    tags: ["CRUD Agent Relations"],
+    tags: ["Agent Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -1062,13 +1031,12 @@ app4.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const body = await c.req.valid("json");
     const isExternalAgent = body.externalAgentId != null;
     if (isExternalAgent && body.externalAgentId) {
       const externalAgentExists = await validateExternalAgent(dbClient_default)({
-        scopes: { tenantId, projectId },
-        agentId: body.externalAgentId
+        scopes: { tenantId, projectId, graphId, agentId: body.externalAgentId }
       });
       if (!externalAgentExists) {
         throw createApiError({
@@ -1079,8 +1047,7 @@ app4.openapi(
     }
     if (!isExternalAgent && body.targetAgentId) {
       const internalAgentExists = await validateInternalAgent(dbClient_default)({
-        scopes: { tenantId, projectId },
-        agentId: body.targetAgentId
+        scopes: { tenantId, projectId, graphId, agentId: body.targetAgentId }
       });
       if (!internalAgentExists) {
         throw createApiError({
@@ -1090,11 +1057,11 @@ app4.openapi(
       }
     }
     const existingRelations = await listAgentRelations(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       pagination: { page: 1, limit: 1e3 }
     });
     const isDuplicate = existingRelations.data.some((relation) => {
-      if (relation.graphId !== body.graphId || relation.sourceAgentId !== body.sourceAgentId) {
+      if (relation.graphId !== graphId || relation.sourceAgentId !== body.sourceAgentId) {
         return false;
       }
       if (isExternalAgent) {
@@ -1110,7 +1077,7 @@ app4.openapi(
       });
     }
     const relationData = {
-      graphId: body.graphId,
+      graphId,
       tenantId,
       id: nanoid(),
       projectId,
@@ -1131,9 +1098,9 @@ app4.openapi(
     path: "/{id}",
     summary: "Update Agent Relation",
     operationId: "update-agent-relation",
-    tags: ["CRUD Agent Relations"],
+    tags: ["Agent Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema),
+      params: TenantProjectGraphIdParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -1155,10 +1122,10 @@ app4.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const body = await c.req.valid("json");
     const updatedAgentRelation = await updateAgentRelation(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       relationId: id,
       data: body
     });
@@ -1177,9 +1144,9 @@ app4.openapi(
     path: "/{id}",
     summary: "Delete Agent Relation",
     operationId: "delete-agent-relation",
-    tags: ["CRUD Agent Relations"],
+    tags: ["Agent Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       204: {
@@ -1196,9 +1163,9 @@ app4.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const deleted = await deleteAgentRelation(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       relationId: id
     });
     if (!deleted) {
@@ -1218,9 +1185,9 @@ app5.openapi(
     path: "/",
     summary: "List Agents",
     operationId: "list-agents",
-    tags: ["CRUD Agent"],
+    tags: ["Agent"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       query: PaginationQueryParamsSchema
     },
     responses: {
@@ -1236,11 +1203,11 @@ app5.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const page = Number(c.req.query("page")) || 1;
     const limit = Math.min(Number(c.req.query("limit")) || 10, 100);
     const result = await listAgentsPaginated(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       pagination: { page, limit }
     });
     const dataWithType = {
@@ -1259,9 +1226,9 @@ app5.openapi(
     path: "/{id}",
     summary: "Get Agent",
     operationId: "get-agent-by-id",
-    tags: ["CRUD Agent"],
+    tags: ["Agent"],
     request: {
-      params: TenantProjectIdParamsSchema
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       200: {
@@ -1276,9 +1243,9 @@ app5.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const agent = await getAgentById(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id
     });
     if (!agent) {
@@ -1300,9 +1267,9 @@ app5.openapi(
     path: "/",
     summary: "Create Agent",
     operationId: "create-agent",
-    tags: ["CRUD Agent"],
+    tags: ["Agent"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -1324,14 +1291,15 @@ app5.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const body = c.req.valid("json");
     const agentId = body.id ? String(body.id) : nanoid();
     const agent = await createAgent(dbClient_default)({
       ...body,
       id: agentId,
       tenantId,
-      projectId
+      projectId,
+      graphId
     });
     const agentWithType = {
       ...agent,
@@ -1346,9 +1314,9 @@ app5.openapi(
     path: "/{id}",
     summary: "Update Agent",
     operationId: "update-agent",
-    tags: ["CRUD Agent"],
+    tags: ["Agent"],
     request: {
-      params: TenantProjectIdParamsSchema,
+      params: TenantProjectGraphIdParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -1370,10 +1338,10 @@ app5.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const body = c.req.valid("json");
     const updatedAgent = await updateAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id,
       data: body
     });
@@ -1396,9 +1364,9 @@ app5.openapi(
     path: "/{id}",
     summary: "Delete Agent",
     operationId: "delete-agent",
-    tags: ["CRUD Agent"],
+    tags: ["Agent"],
     request: {
-      params: TenantProjectIdParamsSchema
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       204: {
@@ -1415,9 +1383,9 @@ app5.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const deleted = await deleteAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id
     });
     if (!deleted) {
@@ -1437,9 +1405,9 @@ app6.openapi(
     path: "/",
     summary: "List Agent Tool Relations",
     operationId: "list-agent-tool-relations",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       query: PaginationQueryParamsSchema.extend({
         agentId: z.string().optional(),
         toolId: z.string().optional()
@@ -1458,13 +1426,12 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const { page, limit, agentId, toolId } = c.req.valid("query");
     let result;
     if (agentId) {
       const dbResult = await getAgentToolRelationByAgent(dbClient_default)({
-        scopes: { tenantId, projectId },
-        agentId,
+        scopes: { tenantId, projectId, graphId, agentId },
         pagination: { page, limit }
       });
       result = {
@@ -1473,7 +1440,7 @@ app6.openapi(
       };
     } else if (toolId) {
       const dbResult = await getAgentToolRelationByTool(dbClient_default)({
-        scopes: { tenantId, projectId },
+        scopes: { tenantId, projectId, graphId },
         toolId,
         pagination: { page, limit }
       });
@@ -1483,7 +1450,7 @@ app6.openapi(
       };
     } else {
       const dbResult = await listAgentToolRelations(dbClient_default)({
-        scopes: { tenantId, projectId },
+        scopes: { tenantId, projectId, graphId },
         pagination: { page, limit }
       });
       result = {
@@ -1500,9 +1467,9 @@ app6.openapi(
     path: "/{id}",
     summary: "Get Agent Tool Relation",
     operationId: "get-agent-tool-relation",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphParamsSchema.merge(IdParamsSchema)
     },
     responses: {
       200: {
@@ -1517,9 +1484,9 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const agentToolRelation = await getAgentToolRelationById(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId, agentId: id },
       relationId: id
     });
     if (!agentToolRelation) {
@@ -1537,9 +1504,9 @@ app6.openapi(
     path: "/agent/{agentId}/tools",
     summary: "Get Tools for Agent",
     operationId: "get-tools-for-agent",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         agentId: z.string()
       }),
       query: PaginationQueryParamsSchema
@@ -1557,11 +1524,10 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, agentId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, agentId } = c.req.valid("param");
     const { page, limit } = c.req.valid("query");
     const dbResult = await getToolsForAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
-      agentId,
+      scopes: { tenantId, projectId, graphId, agentId },
       pagination: { page, limit }
     });
     const result = {
@@ -1577,9 +1543,9 @@ app6.openapi(
     path: "/tool/{toolId}/agents",
     summary: "Get Agents for Tool",
     operationId: "get-agents-for-tool",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema.extend({
+      params: TenantProjectGraphParamsSchema.extend({
         toolId: z.string()
       }),
       query: PaginationQueryParamsSchema
@@ -1597,18 +1563,14 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, toolId } = c.req.valid("param");
+    const { tenantId, projectId, graphId, toolId } = c.req.valid("param");
     const { page, limit } = c.req.valid("query");
     const dbResult = await getAgentsForTool(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       toolId,
       pagination: { page, limit }
     });
-    const result = {
-      data: dbResult.data,
-      pagination: dbResult.pagination
-    };
-    return c.json(result);
+    return c.json(dbResult);
   }
 );
 app6.openapi(
@@ -1617,9 +1579,9 @@ app6.openapi(
     path: "/",
     summary: "Create Agent Tool Relation",
     operationId: "create-agent-tool-relation",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -1641,10 +1603,10 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const body = c.req.valid("json");
     const existingRelations = await listAgentToolRelations(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       pagination: { limit: 1e3 }
     });
     const isDuplicate = existingRelations.data.some((relation) => {
@@ -1659,7 +1621,7 @@ app6.openapi(
     }
     try {
       const agentToolRelation = await createAgentToolRelation(dbClient_default)({
-        scopes: { tenantId, projectId },
+        scopes: { tenantId, projectId, graphId },
         data: body
       });
       return c.json({ data: agentToolRelation }, 201);
@@ -1680,9 +1642,9 @@ app6.openapi(
     path: "/{id}",
     summary: "Update Agent Tool Relation",
     operationId: "update-agent-tool-relation",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema),
+      params: TenantProjectGraphParamsSchema.merge(IdParamsSchema),
       body: {
         content: {
           "application/json": {
@@ -1704,7 +1666,7 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     console.log("id", id);
     const body = await c.req.valid("json");
     if (Object.keys(body).length === 0) {
@@ -1714,7 +1676,7 @@ app6.openapi(
       });
     }
     const updatedAgentToolRelation = await updateAgentToolRelation(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       relationId: id,
       data: body
     });
@@ -1733,9 +1695,9 @@ app6.openapi(
     path: "/{id}",
     summary: "Delete Agent Tool Relation",
     operationId: "delete-agent-tool-relation",
-    tags: ["CRUD Agent Tool Relations"],
+    tags: ["Agent Tool Relations"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphParamsSchema.merge(IdParamsSchema)
     },
     responses: {
       204: {
@@ -1752,9 +1714,9 @@ app6.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const deleted = await deleteAgentToolRelation(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       relationId: id
     });
     if (!deleted) {
@@ -1775,7 +1737,7 @@ app7.openapi(
     summary: "List API Keys",
     description: "List all API keys for a tenant with optional pagination",
     operationId: "list-api-keys",
-    tags: ["CRUD API Keys"],
+    tags: ["API Keys"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema.extend({
@@ -1818,7 +1780,7 @@ app7.openapi(
     summary: "Get API Key",
     description: "Get a specific API key by ID (does not return the actual key)",
     operationId: "get-api-key-by-id",
-    tags: ["CRUD API Keys"],
+    tags: ["API Keys"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -1863,7 +1825,7 @@ app7.openapi(
     summary: "Create API Key",
     description: "Create a new API key for a graph. Returns the full key (shown only once).",
     operationId: "create-api-key",
-    tags: ["CRUD API Keys"],
+    tags: ["API Keys"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -1932,7 +1894,7 @@ app7.openapi(
     summary: "Update API Key",
     description: "Update an API key (currently only expiration date can be changed)",
     operationId: "update-api-key",
-    tags: ["CRUD API Keys"],
+    tags: ["API Keys"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -1988,7 +1950,7 @@ app7.openapi(
     summary: "Delete API Key",
     description: "Delete an API key permanently",
     operationId: "delete-api-key",
-    tags: ["CRUD API Keys"],
+    tags: ["API Keys"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2029,7 +1991,7 @@ app8.openapi(
     path: "/",
     summary: "List Artifact Components",
     operationId: "list-artifact-components",
-    tags: ["CRUD Artifact Component"],
+    tags: ["Artifact Component"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema
@@ -2063,7 +2025,7 @@ app8.openapi(
     path: "/{id}",
     summary: "Get Artifact Component",
     operationId: "get-artifact-component-by-id",
-    tags: ["CRUD Artifact Component"],
+    tags: ["Artifact Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2100,7 +2062,7 @@ app8.openapi(
     path: "/",
     summary: "Create Artifact Component",
     operationId: "create-artifact-component",
-    tags: ["CRUD Artifact Component"],
+    tags: ["Artifact Component"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -2158,7 +2120,7 @@ app8.openapi(
     path: "/{id}",
     summary: "Update Artifact Component",
     operationId: "update-artifact-component",
-    tags: ["CRUD Artifact Component"],
+    tags: ["Artifact Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -2209,7 +2171,7 @@ app8.openapi(
     path: "/{id}",
     summary: "Delete Artifact Component",
     operationId: "delete-artifact-component",
-    tags: ["CRUD Artifact Component"],
+    tags: ["Artifact Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2250,7 +2212,7 @@ app9.openapi(
     path: "/",
     summary: "List Context Configurations",
     operationId: "list-context-configs",
-    tags: ["CRUD Context Config"],
+    tags: ["Context Config"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema
@@ -2284,7 +2246,7 @@ app9.openapi(
     path: "/{id}",
     summary: "Get Context Configuration",
     operationId: "get-context-config-by-id",
-    tags: ["CRUD Context Config"],
+    tags: ["Context Config"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2321,7 +2283,7 @@ app9.openapi(
     path: "/",
     summary: "Create Context Configuration",
     operationId: "create-context-config",
-    tags: ["CRUD Context Config"],
+    tags: ["Context Config"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -2362,7 +2324,7 @@ app9.openapi(
     path: "/{id}",
     summary: "Update Context Configuration",
     operationId: "update-context-config",
-    tags: ["CRUD Context Config"],
+    tags: ["Context Config"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -2408,7 +2370,7 @@ app9.openapi(
     path: "/{id}",
     summary: "Delete Context Configuration",
     operationId: "delete-context-config",
-    tags: ["CRUD Context Config"],
+    tags: ["Context Config"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2442,7 +2404,7 @@ app10.openapi(
     path: "/",
     summary: "List Credentials",
     operationId: "list-credentials",
-    tags: ["CRUD Credential"],
+    tags: ["Credential"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema
@@ -2477,7 +2439,7 @@ app10.openapi(
     path: "/{id}",
     summary: "Get Credential",
     operationId: "get-credential-by-id",
-    tags: ["CRUD Credential"],
+    tags: ["Credential"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2515,7 +2477,7 @@ app10.openapi(
     path: "/",
     summary: "Create Credential",
     operationId: "create-credential",
-    tags: ["CRUD Credential"],
+    tags: ["Credential"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -2557,7 +2519,7 @@ app10.openapi(
     path: "/{id}",
     summary: "Update Credential",
     operationId: "update-credential",
-    tags: ["CRUD Credential"],
+    tags: ["Credential"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -2604,7 +2566,7 @@ app10.openapi(
     path: "/{id}",
     summary: "Delete Credential",
     operationId: "delete-credential",
-    tags: ["CRUD Credential"],
+    tags: ["Credential"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2677,7 +2639,7 @@ app11.openapi(
     path: "/",
     summary: "List Data Components",
     operationId: "list-data-components",
-    tags: ["CRUD Data Component"],
+    tags: ["Data Component"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema
@@ -2711,7 +2673,7 @@ app11.openapi(
     path: "/{id}",
     summary: "Get Data Component",
     operationId: "get-data-component-by-id",
-    tags: ["CRUD Data Component"],
+    tags: ["Data Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2748,7 +2710,7 @@ app11.openapi(
     path: "/",
     summary: "Create Data Component",
     operationId: "create-data-component",
-    tags: ["CRUD Data Component"],
+    tags: ["Data Component"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -2789,7 +2751,7 @@ app11.openapi(
     path: "/{id}",
     summary: "Update Data Component",
     operationId: "update-data-component",
-    tags: ["CRUD Data Component"],
+    tags: ["Data Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema),
       body: {
@@ -2835,7 +2797,7 @@ app11.openapi(
     path: "/{id}",
     summary: "Delete Data Component",
     operationId: "delete-data-component",
-    tags: ["CRUD Data Component"],
+    tags: ["Data Component"],
     request: {
       params: TenantProjectParamsSchema.merge(IdParamsSchema)
     },
@@ -2876,9 +2838,9 @@ app12.openapi(
     path: "/",
     summary: "List External Agents",
     operationId: "list-external-agents",
-    tags: ["CRUD External Agents"],
+    tags: ["External Agents"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       query: PaginationQueryParamsSchema
     },
     responses: {
@@ -2894,10 +2856,10 @@ app12.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const { page, limit } = c.req.valid("query");
     const result = await listExternalAgentsPaginated(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       pagination: { page, limit }
     });
     const dataWithType = {
@@ -2916,9 +2878,9 @@ app12.openapi(
     path: "/{id}",
     summary: "Get External Agent",
     operationId: "get-external-agent-by-id",
-    tags: ["CRUD External Agents"],
+    tags: ["External Agents"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       200: {
@@ -2933,9 +2895,9 @@ app12.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const externalAgent = await getExternalAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id
     });
     if (!externalAgent) {
@@ -2957,9 +2919,9 @@ app12.openapi(
     path: "/",
     summary: "Create External Agent",
     operationId: "create-external-agent",
-    tags: ["CRUD External Agents"],
+    tags: ["External Agents"],
     request: {
-      params: TenantProjectParamsSchema,
+      params: TenantProjectGraphParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -2981,11 +2943,12 @@ app12.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId } = c.req.valid("param");
+    const { tenantId, projectId, graphId } = c.req.valid("param");
     const body = c.req.valid("json");
     const externalAgentData = {
       tenantId,
       projectId,
+      graphId,
       id: body.id ? String(body.id) : nanoid(),
       name: body.name,
       description: body.description,
@@ -3007,9 +2970,9 @@ app12.openapi(
     path: "/{id}",
     summary: "Update External Agent",
     operationId: "update-external-agent",
-    tags: ["CRUD External Agents"],
+    tags: ["External Agents"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema),
+      params: TenantProjectGraphIdParamsSchema,
       body: {
         content: {
           "application/json": {
@@ -3031,10 +2994,10 @@ app12.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const body = c.req.valid("json");
     const updatedExternalAgent = await updateExternalAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id,
       data: body
     });
@@ -3057,9 +3020,9 @@ app12.openapi(
     path: "/{id}",
     summary: "Delete External Agent",
     operationId: "delete-external-agent",
-    tags: ["CRUD External Agents"],
+    tags: ["External Agents"],
     request: {
-      params: TenantProjectParamsSchema.merge(IdParamsSchema)
+      params: TenantProjectGraphIdParamsSchema
     },
     responses: {
       204: {
@@ -3076,9 +3039,9 @@ app12.openapi(
     }
   }),
   async (c) => {
-    const { tenantId, projectId, id } = c.req.valid("param");
+    const { tenantId, projectId, graphId, id } = c.req.valid("param");
     const deleted = await deleteExternalAgent(dbClient_default)({
-      scopes: { tenantId, projectId },
+      scopes: { tenantId, projectId, graphId },
       agentId: id
     });
     if (!deleted) {
@@ -3113,7 +3076,7 @@ app13.openapi(
     path: "/",
     summary: "Create Full Graph",
     operationId: "create-full-graph",
-    tags: ["CRUD Full Graph"],
+    tags: ["Full Graph"],
     description: "Create a complete agent graph with all agents, tools, and relationships from JSON definition",
     request: {
       params: TenantProjectParamsSchema,
@@ -3162,7 +3125,7 @@ app13.openapi(
     path: "/{graphId}",
     summary: "Get Full Graph",
     operationId: "get-full-graph",
-    tags: ["CRUD Full Graph"],
+    tags: ["Full Graph"],
     description: "Retrieve a complete agent graph definition with all agents, tools, and relationships",
     request: {
       params: GraphIdParamsSchema
@@ -3186,8 +3149,7 @@ app13.openapi(
         dbClient_default,
         logger3
       )({
-        scopes: { tenantId, projectId },
-        graphId
+        scopes: { tenantId, projectId, graphId }
       });
       if (!graph) {
         throw createApiError({
@@ -3216,7 +3178,7 @@ app13.openapi(
     path: "/{graphId}",
     summary: "Update Full Graph",
     operationId: "update-full-graph",
-    tags: ["CRUD Full Graph"],
+    tags: ["Full Graph"],
     description: "Update or create a complete agent graph with all agents, tools, and relationships from JSON definition",
     request: {
       params: GraphIdParamsSchema,
@@ -3263,8 +3225,7 @@ app13.openapi(
         dbClient_default,
         logger3
       )({
-        scopes: { tenantId, projectId },
-        graphId
+        scopes: { tenantId, projectId, graphId }
       });
       const isCreate = !existingGraph;
       const updatedGraph = isCreate ? await createFullGraphServerSide(dbClient_default, logger3)(
@@ -3301,7 +3262,7 @@ app13.openapi(
     path: "/{graphId}",
     summary: "Delete Full Graph",
     operationId: "delete-full-graph",
-    tags: ["CRUD Full Graph"],
+    tags: ["Full Graph"],
     description: "Delete a complete agent graph and cascade to all related entities (relationships, not agents/tools)",
     request: {
       params: GraphIdParamsSchema
@@ -3320,8 +3281,7 @@ app13.openapi(
         dbClient_default,
         logger3
       )({
-        scopes: { tenantId, projectId },
-        graphId
+        scopes: { tenantId, projectId, graphId }
       });
       if (!deleted) {
         throw createApiError({
@@ -3922,14 +3882,14 @@ function retrievePKCEVerifier(state) {
   return null;
 }
 var OAuthService = class {
-  constructor(config2 = {}) {
+  constructor(config = {}) {
     __publicField(this, "defaultConfig");
     this.defaultConfig = {
-      defaultClientId: config2.defaultClientId || process.env.DEFAULT_OAUTH_CLIENT_ID || "mcp-client",
-      clientName: config2.clientName || process.env.OAUTH_CLIENT_NAME || "Inkeep Agent Framework",
-      clientUri: config2.clientUri || process.env.OAUTH_CLIENT_URI || "https://inkeep.com",
-      logoUri: config2.logoUri || process.env.OAUTH_CLIENT_LOGO_URI || "https://inkeep.com/images/logos/inkeep-logo-blue.svg",
-      redirectBaseUrl: config2.redirectBaseUrl || process.env.OAUTH_REDIRECT_BASE_URL || "http://localhost:3002"
+      defaultClientId: config.defaultClientId || process.env.DEFAULT_OAUTH_CLIENT_ID || "mcp-client",
+      clientName: config.clientName || process.env.OAUTH_CLIENT_NAME || "Inkeep Agent Framework",
+      clientUri: config.clientUri || process.env.OAUTH_CLIENT_URI || "https://inkeep.com",
+      logoUri: config.logoUri || process.env.OAUTH_CLIENT_LOGO_URI || "https://inkeep.com/images/logos/inkeep-logo-blue.svg",
+      redirectBaseUrl: config.redirectBaseUrl || process.env.OAUTH_REDIRECT_BASE_URL || "http://localhost:3002"
     };
   }
   /**
@@ -4073,7 +4033,7 @@ var OAuthService = class {
     const tokenUrl = new URL(oAuthConfig.tokenUrl);
     const oauthServerUrl = `${tokenUrl.protocol}//${tokenUrl.host}`;
     logger6.info({ oauthServerUrl, clientId }, "Attempting openid-client discovery");
-    const config2 = await oauth.discovery(
+    const config = await oauth.discovery(
       new URL(oauthServerUrl),
       clientId,
       void 0
@@ -4082,7 +4042,7 @@ var OAuthService = class {
     const callbackUrl = new URL(
       `${redirectUri}?${new URLSearchParams({ code, state: "unused" }).toString()}`
     );
-    return await oauth.authorizationCodeGrant(config2, callbackUrl, {
+    return await oauth.authorizationCodeGrant(config, callbackUrl, {
       pkceCodeVerifier: codeVerifier
     });
   }
@@ -4147,7 +4107,7 @@ app15.openapi(
     path: "/",
     summary: "List Tools",
     operationId: "list-tools",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema,
       query: PaginationQueryParamsSchema.extend({
@@ -4200,7 +4160,7 @@ app15.openapi(
     path: "/{id}",
     summary: "Get Tool",
     operationId: "get-tool",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape)
     },
@@ -4236,7 +4196,7 @@ app15.openapi(
     path: "/",
     summary: "Create Tool",
     operationId: "create-tool",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema,
       body: {
@@ -4288,7 +4248,7 @@ app15.openapi(
     path: "/{id}",
     summary: "Update Tool",
     operationId: "update-tool",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape),
       body: {
@@ -4348,7 +4308,7 @@ app15.openapi(
     path: "/{id}",
     summary: "Delete Tool",
     operationId: "delete-tool",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape)
     },
@@ -4384,7 +4344,7 @@ app15.openapi(
     path: "/{id}/health-check",
     summary: "Check Tool Health",
     operationId: "check-tool-health",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape)
     },
@@ -4440,7 +4400,7 @@ app15.openapi(
     path: "/health-check-all",
     summary: "Check All Tools Health",
     operationId: "check-all-tools-health",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema
     },
@@ -4504,7 +4464,7 @@ app15.openapi(
     path: "/{id}/sync",
     summary: "Sync Tool Definitions",
     operationId: "sync-tool-definitions",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape)
     },
@@ -4548,7 +4508,7 @@ app15.openapi(
     path: "/{id}/available-tools",
     summary: "Get Available Tools",
     operationId: "get-available-tools",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape)
     },
@@ -4600,7 +4560,7 @@ app15.openapi(
     path: "/{id}/status",
     summary: "Update Tool Status",
     operationId: "update-tool-status",
-    tags: ["CRUD Tools"],
+    tags: ["Tools"],
     request: {
       params: TenantProjectParamsSchema.extend(IdParamsSchema.shape),
       body: {
@@ -4720,17 +4680,17 @@ var tools_default = app15;
 // src/routes/index.ts
 var app16 = new OpenAPIHono();
 app16.route("/projects", projects_default);
-app16.route("/projects/:projectId/agents", agents_default);
-app16.route("/projects/:projectId/agent-relations", agentRelations_default);
+app16.route("/projects/:projectId/graphs/:graphId/agents", agents_default);
+app16.route("/projects/:projectId/graphs/:graphId/agent-relations", agentRelations_default);
 app16.route("/projects/:projectId/agent-graphs", agentGraph_default);
-app16.route("/projects/:projectId/agent-tool-relations", agentToolRelations_default);
-app16.route("/projects/:projectId/agent-artifact-components", agentArtifactComponents_default);
-app16.route("/projects/:projectId/agent-data-components", agentDataComponents_default);
+app16.route("/projects/:projectId/graphs/:graphId/agent-tool-relations", agentToolRelations_default);
+app16.route("/projects/:projectId/graphs/:graphId/agent-artifact-components", agentArtifactComponents_default);
+app16.route("/projects/:projectId/graphs/:graphId/agent-data-components", agentDataComponents_default);
 app16.route("/projects/:projectId/artifact-components", artifactComponents_default);
 app16.route("/projects/:projectId/context-configs", contextConfigs_default);
 app16.route("/projects/:projectId/credentials", credentials_default);
 app16.route("/projects/:projectId/data-components", dataComponents_default);
-app16.route("/projects/:projectId/external-agents", externalAgents_default);
+app16.route("/projects/:projectId/graphs/:graphId/external-agents", externalAgents_default);
 app16.route("/projects/:projectId/tools", tools_default);
 app16.route("/projects/:projectId/api-keys", apiKeys_default);
 app16.route("/projects/:projectId/graph", graphFull_default);
@@ -4930,7 +4890,7 @@ app18.openapi(
     path: "/project-full",
     summary: "Create Full Project",
     operationId: "create-full-project",
-    tags: ["CRUD Full Project"],
+    tags: ["Full Project"],
     description: "Create a complete project with all graphs, agents, tools, and relationships from JSON definition",
     request: {
       params: TenantParamsSchema2,
@@ -4989,7 +4949,7 @@ app18.openapi(
     path: "/project-full/{projectId}",
     summary: "Get Full Project",
     operationId: "get-full-project",
-    tags: ["CRUD Full Project"],
+    tags: ["Full Project"],
     description: "Retrieve a complete project definition with all graphs, agents, tools, and relationships",
     request: {
       params: ProjectIdParamsSchema
@@ -5013,8 +4973,7 @@ app18.openapi(
         dbClient_default,
         logger8
       )({
-        scopes: { tenantId, projectId },
-        projectId
+        scopes: { tenantId, projectId }
       });
       if (!project) {
         throw createApiError({
@@ -5043,7 +5002,7 @@ app18.openapi(
     path: "/project-full/{projectId}",
     summary: "Update Full Project",
     operationId: "update-full-project",
-    tags: ["CRUD Full Project"],
+    tags: ["Full Project"],
     description: "Update or create a complete project with all graphs, agents, tools, and relationships from JSON definition",
     request: {
       params: ProjectIdParamsSchema,
@@ -5090,8 +5049,7 @@ app18.openapi(
         dbClient_default,
         logger8
       )({
-        scopes: { tenantId, projectId },
-        projectId
+        scopes: { tenantId, projectId }
       });
       const isCreate = !existingProject;
       const updatedProject = isCreate ? await createFullProjectServerSide(dbClient_default, logger8)(
@@ -5128,7 +5086,7 @@ app18.openapi(
     path: "/project-full/{projectId}",
     summary: "Delete Full Project",
     operationId: "delete-full-project",
-    tags: ["CRUD Full Project"],
+    tags: ["Full Project"],
     description: "Delete a complete project and cascade to all related entities (graphs, agents, tools, relationships)",
     request: {
       params: ProjectIdParamsSchema
@@ -5147,8 +5105,7 @@ app18.openapi(
         dbClient_default,
         logger8
       )({
-        scopes: { tenantId, projectId },
-        projectId
+        scopes: { tenantId, projectId }
       });
       if (!deleted) {
         throw createApiError({
@@ -5302,7 +5259,7 @@ function createManagementHono(serverConfig, credentialStores) {
     }
   );
   app20.use("/tenants/*", apiKeyAuth());
-  app20.route("/tenants/:tenantId/crud", routes_default);
+  app20.route("/tenants/:tenantId", routes_default);
   app20.route("/tenants/:tenantId", projectFull_default);
   app20.route("/oauth", oauth_default);
   setupOpenAPIRoutes(app20);
@@ -5325,9 +5282,9 @@ var defaultStores = createDefaultCredentialStores();
 var defaultRegistry = new CredentialStoreRegistry(defaultStores);
 var app19 = createManagementHono(defaultConfig, defaultRegistry);
 var index_default = app19;
-function createManagementApp(config2) {
-  const serverConfig = config2?.serverConfig ?? defaultConfig;
-  const stores = config2?.credentialStores ?? defaultStores;
+function createManagementApp(config) {
+  const serverConfig = config?.serverConfig ?? defaultConfig;
+  const stores = config?.credentialStores ?? defaultStores;
   const registry = new CredentialStoreRegistry(stores);
   return createManagementHono(serverConfig, registry);
 }