@inkeep/agents-manage-api 0.1.6 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
-# Inkeep Management API
+# Inkeep Agents Manage API
 
-The Management API is responsible for entity management and CRUD operations for the Inkeep Agent Framework. It provides the administrative layer for creating, configuring, and managing agents, graphs, tools, and projects.
+The Agents Manage API is responsible for entity management and CRUD operations for the Inkeep Agent Framework. It provides the administrative layer for creating, configuring, and managing agents, graphs, tools, and projects.
 
 ## Overview
 
@@ -145,14 +145,14 @@ const createAgentSchema = z.object({
 
 ## Integration
 
-### With Execution API
-The Management API provides the configuration that the Execution API reads during runtime. Changes to agents, graphs, or tools are immediately available to the execution layer.
+### With Agents Run API
+The Agents Manage API provides the configuration that the Agents Run API reads during runtime. Changes to agents, graphs, or tools are immediately available to the execution layer.
 
-### With CLI
-The Inkeep CLI uses the Management API for all `push` operations, creating and updating entities from configuration files.
+### With Agents CLI
+The Agents CLI uses the Agents Manage API for all `push` operations, creating and updating entities from configuration files.
 
-### With Agent Builder
-The Agent Builder UI provides a web interface for all Management API operations, offering visual agent and graph creation.
+### With Agents Manage UI
+The Agents Manage UI provides a web interface for all Agents Manage API operations, offering visual agent and graph creation.
 
 ## Error Handling
 
@@ -173,4 +173,4 @@ The Agent Builder UI provides a web interface for all Management API operations,
 - **Database Indexing**: Optimized indexes on frequently queried fields
 - **Connection Pooling**: Efficient database connection management
 - **Caching**: In-memory caching for frequently accessed entities
-- **Parallel Operations**: Concurrent database operations where safe
+- **Parallel Operations**: Concurrent database operations where safe

package/dist/index.cjs

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var agentsCore = require('@inkeep/agents-core');
-var hono = require('hono');
 var zodOpenapi = require('@hono/zod-openapi');
+var hono = require('hono');
 var cors = require('hono/cors');
 var httpException = require('hono/http-exception');
 var requestId = require('hono/request-id');
@@ -67,10 +67,8 @@ loadEnvFile();
 var envSchema = zod.z.object({
   NODE_ENV: zod.z.enum(["development", "production", "test"]).optional(),
   ENVIRONMENT: zod.z.enum(["development", "production", "pentest", "test"]).optional(),
+  AGENTS_MANAGE_API_URL: zod.z.string().optional().default("http://localhost:3002"),
   DB_FILE_NAME: zod.z.string().default("file:../local.db"),
-  PORT: zod.z.coerce.number().optional().default(3002),
-  MANAGEMENT_PORT: zod.z.coerce.number().optional().default(3002),
-  AGENT_BASE_URL: zod.z.string().optional(),
   LOG_LEVEL: zod.z.enum(["trace", "debug", "info", "warn", "error"]).optional().default("debug"),
   NANGO_SECRET_KEY: zod.z.string().optional(),
   INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET: zod.z.string().optional()
@@ -78,9 +76,6 @@ var envSchema = zod.z.object({
 var parseEnv = () => {
   try {
     const parsedEnv = envSchema.parse(process.env);
-    if (!parsedEnv.AGENT_BASE_URL) {
-      parsedEnv.AGENT_BASE_URL = `http://localhost:${parsedEnv.PORT}`;
-    }
     return parsedEnv;
   } catch (error) {
     if (error instanceof zod.z.ZodError) {
@@ -150,19 +145,19 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
   await next();
   return;
 });
-function setupOpenAPIRoutes(app19) {
-  app19.get("/openapi.json", (c) => {
+function setupOpenAPIRoutes(app20) {
+  app20.get("/openapi.json", (c) => {
     try {
-      const document = app19.getOpenAPIDocument({
+      const document = app20.getOpenAPIDocument({
         openapi: "3.0.0",
         info: {
-          title: "Inkeep Agent Framework Management API",
+          title: "Inkeep Agents Manage API",
           version: "1.0.0",
-          description: "Complete REST API for Inkeep Agent Framework Management application including chat completions, A2A agent communication, and comprehensive CRUD operations for all entities"
+          description: "REST API for the management of the Inkeep Agent Framework."
         },
         servers: [
           {
-            url: env.MANAGEMENT_PORT ? `http://localhost:${env.MANAGEMENT_PORT}` : `http://localhost:3002`,
+            url: env.AGENTS_MANAGE_API_URL,
             description: "Development server"
           }
         ]
@@ -174,11 +169,11 @@ function setupOpenAPIRoutes(app19) {
       return c.json({ error: "Failed to generate OpenAPI document", details: errorDetails }, 500);
     }
   });
-  app19.get(
+  app20.get(
     "/docs",
     swaggerUi.swaggerUI({
       url: "/openapi.json",
-      title: "InkeepAgent Framework Management API Documentation"
+      title: "Inkeep Agents Manage API Documentation"
     })
   );
 }
@@ -1931,21 +1926,31 @@ app7.openapi(
       ...keyDataWithoutKey,
       expiresAt: body.expiresAt || void 0
     };
-    const result = await agentsCore.createApiKey(dbClient_default)(insertData);
-    const { keyHash: _, tenantId: __, projectId: ___, ...sanitizedApiKey } = result;
-    return c.json(
-      {
-        data: {
-          apiKey: {
-            ...sanitizedApiKey,
-            lastUsedAt: sanitizedApiKey.lastUsedAt ?? null,
-            expiresAt: sanitizedApiKey.expiresAt ?? null
-          },
-          key
-        }
-      },
-      201
-    );
+    try {
+      const result = await agentsCore.createApiKey(dbClient_default)(insertData);
+      const { keyHash: _, tenantId: __, projectId: ___, ...sanitizedApiKey } = result;
+      return c.json(
+        {
+          data: {
+            apiKey: {
+              ...sanitizedApiKey,
+              lastUsedAt: sanitizedApiKey.lastUsedAt ?? null,
+              expiresAt: sanitizedApiKey.expiresAt ?? null
+            },
+            key
+          }
+        },
+        201
+      );
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_FOREIGNKEY" || error?.cause?.rawCode === 787) {
+        throw agentsCore.createApiError({
+          code: "bad_request",
+          message: "Invalid graphId - graph does not exist"
+        });
+      }
+      throw error;
+    }
   }
 );
 app7.openapi(
@@ -2159,10 +2164,20 @@ app8.openapi(
       summaryProps: body.summaryProps || void 0,
       fullProps: body.fullProps || void 0
     };
-    const artifactComponent = await agentsCore.createArtifactComponent(dbClient_default)({
-      ...componentData
-    });
-    return c.json({ data: artifactComponent }, 201);
+    try {
+      const artifactComponent = await agentsCore.createArtifactComponent(dbClient_default)({
+        ...componentData
+      });
+      return c.json({ data: artifactComponent }, 201);
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_PRIMARYKEY" || error?.cause?.rawCode === 1555) {
+        throw agentsCore.createApiError({
+          code: "conflict",
+          message: `Artifact component with ID '${finalId}' already exists`
+        });
+      }
+      throw error;
+    }
   }
 );
 app8.openapi(
@@ -4696,7 +4711,7 @@ app15.openapi(
   }),
   async (c) => {
     const { tenantId, projectId, id } = c.req.valid("param");
-    const logger8 = getLogger("oauth-login");
+    const logger9 = getLogger("oauth-login");
     try {
       const tool = await agentsCore.getToolById(dbClient_default)({ scopes: { tenantId, projectId }, toolId: id });
       if (!tool) {
@@ -4714,7 +4729,7 @@ app15.openapi(
       });
       return c.redirect(redirectUrl, 302);
     } catch (error) {
-      logger8.error({ toolId: id, error }, "OAuth login failed");
+      logger9.error({ toolId: id, error }, "OAuth login failed");
       if (error && typeof error === "object" && "code" in error) {
         const apiError = error;
         return c.json({ error: apiError.message }, apiError.code === "not_found" ? 404 : 400);
@@ -4919,17 +4934,283 @@ app17.openapi(
   }
 );
 var oauth_default = app17;
+var logger8 = getLogger("projectFull");
+var app18 = new zodOpenapi.OpenAPIHono();
+var ProjectIdParamsSchema = zod.z.object({
+  tenantId: zod.z.string().openapi({
+    description: "Tenant identifier",
+    example: "tenant_123"
+  }),
+  projectId: zod.z.string().openapi({
+    description: "Project identifier",
+    example: "project_456"
+  })
+}).openapi("ProjectIdParams");
+var TenantParamsSchema2 = zod.z.object({
+  tenantId: zod.z.string().openapi({
+    description: "Tenant identifier",
+    example: "tenant_123"
+  })
+}).openapi("TenantParams");
+app18.openapi(
+  zodOpenapi.createRoute({
+    method: "post",
+    path: "/project-full",
+    summary: "Create Full Project",
+    operationId: "create-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Create a complete project with all graphs, agents, tools, and relationships from JSON definition",
+    request: {
+      params: TenantParamsSchema2,
+      body: {
+        content: {
+          "application/json": {
+            schema: agentsCore.FullProjectDefinitionSchema
+          }
+        }
+      }
+    },
+    responses: {
+      201: {
+        description: "Full project created successfully",
+        content: {
+          "application/json": {
+            schema: agentsCore.SingleResponseSchema(agentsCore.FullProjectDefinitionSchema)
+          }
+        }
+      },
+      409: {
+        description: "Project already exists",
+        content: {
+          "application/json": {
+            schema: agentsCore.ErrorResponseSchema
+          }
+        }
+      },
+      ...agentsCore.commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId } = c.req.valid("param");
+    const projectData = c.req.valid("json");
+    const validatedProjectData = agentsCore.FullProjectDefinitionSchema.parse(projectData);
+    try {
+      const createdProject = await agentsCore.createFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId: validatedProjectData.id },
+        validatedProjectData
+      );
+      return c.json({ data: createdProject }, 201);
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_PRIMARYKEY" || error?.cause?.rawCode === 1555) {
+        throw agentsCore.createApiError({
+          code: "conflict",
+          message: `Project with ID '${projectData.id}' already exists`
+        });
+      }
+      throw error;
+    }
+  }
+);
+app18.openapi(
+  zodOpenapi.createRoute({
+    method: "get",
+    path: "/project-full/{projectId}",
+    summary: "Get Full Project",
+    operationId: "get-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Retrieve a complete project definition with all graphs, agents, tools, and relationships",
+    request: {
+      params: ProjectIdParamsSchema
+    },
+    responses: {
+      200: {
+        description: "Full project found",
+        content: {
+          "application/json": {
+            schema: agentsCore.SingleResponseSchema(agentsCore.FullProjectDefinitionSchema)
+          }
+        }
+      },
+      ...agentsCore.commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    try {
+      const project = await agentsCore.getFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      if (!project) {
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      return c.json({ data: project });
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("not found")) {
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      throw agentsCore.createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to retrieve project"
+      });
+    }
+  }
+);
+app18.openapi(
+  zodOpenapi.createRoute({
+    method: "put",
+    path: "/project-full/{projectId}",
+    summary: "Update Full Project",
+    operationId: "update-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Update or create a complete project with all graphs, agents, tools, and relationships from JSON definition",
+    request: {
+      params: ProjectIdParamsSchema,
+      body: {
+        content: {
+          "application/json": {
+            schema: agentsCore.FullProjectDefinitionSchema
+          }
+        }
+      }
+    },
+    responses: {
+      200: {
+        description: "Full project updated successfully",
+        content: {
+          "application/json": {
+            schema: agentsCore.SingleResponseSchema(agentsCore.FullProjectDefinitionSchema)
+          }
+        }
+      },
+      201: {
+        description: "Full project created successfully",
+        content: {
+          "application/json": {
+            schema: agentsCore.SingleResponseSchema(agentsCore.FullProjectDefinitionSchema)
+          }
+        }
+      },
+      ...agentsCore.commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    const projectData = c.req.valid("json");
+    try {
+      const validatedProjectData = agentsCore.FullProjectDefinitionSchema.parse(projectData);
+      if (projectId !== validatedProjectData.id) {
+        throw agentsCore.createApiError({
+          code: "bad_request",
+          message: `Project ID mismatch: expected ${projectId}, got ${validatedProjectData.id}`
+        });
+      }
+      const existingProject = await agentsCore.getFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      const isCreate = !existingProject;
+      const updatedProject = isCreate ? await agentsCore.createFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId },
+        validatedProjectData
+      ) : await agentsCore.updateFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId },
+        validatedProjectData
+      );
+      return c.json({ data: updatedProject }, isCreate ? 201 : 200);
+    } catch (error) {
+      if (error instanceof zod.z.ZodError) {
+        throw agentsCore.createApiError({
+          code: "bad_request",
+          message: "Invalid project definition"
+        });
+      }
+      if (error instanceof Error && error.message.includes("ID mismatch")) {
+        throw agentsCore.createApiError({
+          code: "bad_request",
+          message: error.message
+        });
+      }
+      throw agentsCore.createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to update project"
+      });
+    }
+  }
+);
+app18.openapi(
+  zodOpenapi.createRoute({
+    method: "delete",
+    path: "/project-full/{projectId}",
+    summary: "Delete Full Project",
+    operationId: "delete-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Delete a complete project and cascade to all related entities (graphs, agents, tools, relationships)",
+    request: {
+      params: ProjectIdParamsSchema
+    },
+    responses: {
+      204: {
+        description: "Project deleted successfully"
+      },
+      ...agentsCore.commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    try {
+      const deleted = await agentsCore.deleteFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      if (!deleted) {
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      return c.body(null, 204);
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("not found")) {
+        throw agentsCore.createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      throw agentsCore.createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to delete project"
+      });
+    }
+  }
+);
+var projectFull_default = app18;
 
 // src/app.ts
 function createManagementHono(serverConfig, credentialStores) {
-  const app19 = new zodOpenapi.OpenAPIHono();
-  app19.use("*", requestId.requestId());
-  app19.use("*", async (c, next) => {
+  const app20 = new zodOpenapi.OpenAPIHono();
+  app20.use("*", requestId.requestId());
+  app20.use("*", async (c, next) => {
     c.set("serverConfig", serverConfig);
     c.set("credentialStores", credentialStores);
     return next();
   });
-  app19.use(
+  app20.use(
     honoPino.pinoLogger({
       pino: getLogger(),
       http: {
@@ -4942,7 +5223,7 @@ function createManagementHono(serverConfig, credentialStores) {
       }
     })
   );
-  app19.onError(async (err, c) => {
+  app20.onError(async (err, c) => {
     const isExpectedError = err instanceof httpException.HTTPException;
     const status = isExpectedError ? err.status : 500;
     const requestId2 = c.get("requestId") || "unknown";
@@ -5017,7 +5298,7 @@ function createManagementHono(serverConfig, credentialStores) {
       ...instance && { instance }
     });
   });
-  app19.use(
+  app20.use(
     "*",
     cors.cors({
       origin: (origin) => {
@@ -5031,7 +5312,7 @@ function createManagementHono(serverConfig, credentialStores) {
       credentials: true
     })
   );
-  app19.openapi(
+  app20.openapi(
     zodOpenapi.createRoute({
       method: "get",
       path: "/health",
@@ -5048,12 +5329,13 @@ function createManagementHono(serverConfig, credentialStores) {
       return c.body(null, 204);
     }
   );
-  app19.use("/tenants/*", apiKeyAuth());
-  app19.route("/tenants/:tenantId/crud", routes_default);
-  app19.route("/oauth", oauth_default);
-  setupOpenAPIRoutes(app19);
+  app20.use("/tenants/*", apiKeyAuth());
+  app20.route("/tenants/:tenantId/crud", routes_default);
+  app20.route("/tenants/:tenantId", projectFull_default);
+  app20.route("/oauth", oauth_default);
+  setupOpenAPIRoutes(app20);
   const baseApp = new hono.Hono();
-  baseApp.route("/", app19);
+  baseApp.route("/", app20);
   return baseApp;
 }
 
@@ -5069,8 +5351,8 @@ var defaultConfig = {
 };
 var defaultStores = agentsCore.createDefaultCredentialStores();
 var defaultRegistry = new agentsCore.CredentialStoreRegistry(defaultStores);
-var app18 = createManagementHono(defaultConfig, defaultRegistry);
-var index_default = app18;
+var app19 = createManagementHono(defaultConfig, defaultRegistry);
+var index_default = app19;
 function createManagementApp(config2) {
   const serverConfig = config2?.serverConfig ?? defaultConfig;
   const stores = config2?.credentialStores ?? defaultStores;

package/dist/index.js

@@ -1,6 +1,6 @@
-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, createDefaultCredentialStores, CredentialStoreRegistry, ContextResolver, CredentialStuffer, McpClient, detectAuthenticationRequired, handleApiError, MCPServerType, MCPTransportType } from '@inkeep/agents-core';
-import { Hono } from 'hono';
+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 { OpenAPIHono, createRoute, z as z$1 } from '@hono/zod-openapi';
+import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { HTTPException } from 'hono/http-exception';
 import { requestId } from 'hono/request-id';
@@ -39,10 +39,8 @@ loadEnvFile();
 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"),
-  PORT: z.coerce.number().optional().default(3002),
-  MANAGEMENT_PORT: z.coerce.number().optional().default(3002),
-  AGENT_BASE_URL: z.string().optional(),
   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()
@@ -50,9 +48,6 @@ var envSchema = z.object({
 var parseEnv = () => {
   try {
     const parsedEnv = envSchema.parse(process.env);
-    if (!parsedEnv.AGENT_BASE_URL) {
-      parsedEnv.AGENT_BASE_URL = `http://localhost:${parsedEnv.PORT}`;
-    }
     return parsedEnv;
   } catch (error) {
     if (error instanceof z.ZodError) {
@@ -122,19 +117,19 @@ var apiKeyAuth = () => createMiddleware(async (c, next) => {
   await next();
   return;
 });
-function setupOpenAPIRoutes(app19) {
-  app19.get("/openapi.json", (c) => {
+function setupOpenAPIRoutes(app20) {
+  app20.get("/openapi.json", (c) => {
     try {
-      const document = app19.getOpenAPIDocument({
+      const document = app20.getOpenAPIDocument({
         openapi: "3.0.0",
         info: {
-          title: "Inkeep Agent Framework Management API",
+          title: "Inkeep Agents Manage API",
           version: "1.0.0",
-          description: "Complete REST API for Inkeep Agent Framework Management application including chat completions, A2A agent communication, and comprehensive CRUD operations for all entities"
+          description: "REST API for the management of the Inkeep Agent Framework."
         },
         servers: [
           {
-            url: env.MANAGEMENT_PORT ? `http://localhost:${env.MANAGEMENT_PORT}` : `http://localhost:3002`,
+            url: env.AGENTS_MANAGE_API_URL,
             description: "Development server"
           }
         ]
@@ -146,11 +141,11 @@ function setupOpenAPIRoutes(app19) {
       return c.json({ error: "Failed to generate OpenAPI document", details: errorDetails }, 500);
     }
   });
-  app19.get(
+  app20.get(
     "/docs",
     swaggerUI({
       url: "/openapi.json",
-      title: "InkeepAgent Framework Management API Documentation"
+      title: "Inkeep Agents Manage API Documentation"
     })
   );
 }
@@ -1903,21 +1898,31 @@ app7.openapi(
       ...keyDataWithoutKey,
       expiresAt: body.expiresAt || void 0
     };
-    const result = await createApiKey(dbClient_default)(insertData);
-    const { keyHash: _, tenantId: __, projectId: ___, ...sanitizedApiKey } = result;
-    return c.json(
-      {
-        data: {
-          apiKey: {
-            ...sanitizedApiKey,
-            lastUsedAt: sanitizedApiKey.lastUsedAt ?? null,
-            expiresAt: sanitizedApiKey.expiresAt ?? null
-          },
-          key
-        }
-      },
-      201
-    );
+    try {
+      const result = await createApiKey(dbClient_default)(insertData);
+      const { keyHash: _, tenantId: __, projectId: ___, ...sanitizedApiKey } = result;
+      return c.json(
+        {
+          data: {
+            apiKey: {
+              ...sanitizedApiKey,
+              lastUsedAt: sanitizedApiKey.lastUsedAt ?? null,
+              expiresAt: sanitizedApiKey.expiresAt ?? null
+            },
+            key
+          }
+        },
+        201
+      );
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_FOREIGNKEY" || error?.cause?.rawCode === 787) {
+        throw createApiError({
+          code: "bad_request",
+          message: "Invalid graphId - graph does not exist"
+        });
+      }
+      throw error;
+    }
   }
 );
 app7.openapi(
@@ -2131,10 +2136,20 @@ app8.openapi(
       summaryProps: body.summaryProps || void 0,
       fullProps: body.fullProps || void 0
     };
-    const artifactComponent = await createArtifactComponent(dbClient_default)({
-      ...componentData
-    });
-    return c.json({ data: artifactComponent }, 201);
+    try {
+      const artifactComponent = await createArtifactComponent(dbClient_default)({
+        ...componentData
+      });
+      return c.json({ data: artifactComponent }, 201);
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_PRIMARYKEY" || error?.cause?.rawCode === 1555) {
+        throw createApiError({
+          code: "conflict",
+          message: `Artifact component with ID '${finalId}' already exists`
+        });
+      }
+      throw error;
+    }
   }
 );
 app8.openapi(
@@ -4668,7 +4683,7 @@ app15.openapi(
   }),
   async (c) => {
     const { tenantId, projectId, id } = c.req.valid("param");
-    const logger8 = getLogger("oauth-login");
+    const logger9 = getLogger("oauth-login");
     try {
       const tool = await getToolById(dbClient_default)({ scopes: { tenantId, projectId }, toolId: id });
       if (!tool) {
@@ -4686,7 +4701,7 @@ app15.openapi(
       });
       return c.redirect(redirectUrl, 302);
     } catch (error) {
-      logger8.error({ toolId: id, error }, "OAuth login failed");
+      logger9.error({ toolId: id, error }, "OAuth login failed");
       if (error && typeof error === "object" && "code" in error) {
         const apiError = error;
         return c.json({ error: apiError.message }, apiError.code === "not_found" ? 404 : 400);
@@ -4891,17 +4906,283 @@ app17.openapi(
   }
 );
 var oauth_default = app17;
+var logger8 = getLogger("projectFull");
+var app18 = new OpenAPIHono();
+var ProjectIdParamsSchema = z.object({
+  tenantId: z.string().openapi({
+    description: "Tenant identifier",
+    example: "tenant_123"
+  }),
+  projectId: z.string().openapi({
+    description: "Project identifier",
+    example: "project_456"
+  })
+}).openapi("ProjectIdParams");
+var TenantParamsSchema2 = z.object({
+  tenantId: z.string().openapi({
+    description: "Tenant identifier",
+    example: "tenant_123"
+  })
+}).openapi("TenantParams");
+app18.openapi(
+  createRoute({
+    method: "post",
+    path: "/project-full",
+    summary: "Create Full Project",
+    operationId: "create-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Create a complete project with all graphs, agents, tools, and relationships from JSON definition",
+    request: {
+      params: TenantParamsSchema2,
+      body: {
+        content: {
+          "application/json": {
+            schema: FullProjectDefinitionSchema
+          }
+        }
+      }
+    },
+    responses: {
+      201: {
+        description: "Full project created successfully",
+        content: {
+          "application/json": {
+            schema: SingleResponseSchema(FullProjectDefinitionSchema)
+          }
+        }
+      },
+      409: {
+        description: "Project already exists",
+        content: {
+          "application/json": {
+            schema: ErrorResponseSchema
+          }
+        }
+      },
+      ...commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId } = c.req.valid("param");
+    const projectData = c.req.valid("json");
+    const validatedProjectData = FullProjectDefinitionSchema.parse(projectData);
+    try {
+      const createdProject = await createFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId: validatedProjectData.id },
+        validatedProjectData
+      );
+      return c.json({ data: createdProject }, 201);
+    } catch (error) {
+      if (error?.cause?.code === "SQLITE_CONSTRAINT_PRIMARYKEY" || error?.cause?.rawCode === 1555) {
+        throw createApiError({
+          code: "conflict",
+          message: `Project with ID '${projectData.id}' already exists`
+        });
+      }
+      throw error;
+    }
+  }
+);
+app18.openapi(
+  createRoute({
+    method: "get",
+    path: "/project-full/{projectId}",
+    summary: "Get Full Project",
+    operationId: "get-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Retrieve a complete project definition with all graphs, agents, tools, and relationships",
+    request: {
+      params: ProjectIdParamsSchema
+    },
+    responses: {
+      200: {
+        description: "Full project found",
+        content: {
+          "application/json": {
+            schema: SingleResponseSchema(FullProjectDefinitionSchema)
+          }
+        }
+      },
+      ...commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    try {
+      const project = await getFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      if (!project) {
+        throw createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      return c.json({ data: project });
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("not found")) {
+        throw createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      throw createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to retrieve project"
+      });
+    }
+  }
+);
+app18.openapi(
+  createRoute({
+    method: "put",
+    path: "/project-full/{projectId}",
+    summary: "Update Full Project",
+    operationId: "update-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Update or create a complete project with all graphs, agents, tools, and relationships from JSON definition",
+    request: {
+      params: ProjectIdParamsSchema,
+      body: {
+        content: {
+          "application/json": {
+            schema: FullProjectDefinitionSchema
+          }
+        }
+      }
+    },
+    responses: {
+      200: {
+        description: "Full project updated successfully",
+        content: {
+          "application/json": {
+            schema: SingleResponseSchema(FullProjectDefinitionSchema)
+          }
+        }
+      },
+      201: {
+        description: "Full project created successfully",
+        content: {
+          "application/json": {
+            schema: SingleResponseSchema(FullProjectDefinitionSchema)
+          }
+        }
+      },
+      ...commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    const projectData = c.req.valid("json");
+    try {
+      const validatedProjectData = FullProjectDefinitionSchema.parse(projectData);
+      if (projectId !== validatedProjectData.id) {
+        throw createApiError({
+          code: "bad_request",
+          message: `Project ID mismatch: expected ${projectId}, got ${validatedProjectData.id}`
+        });
+      }
+      const existingProject = await getFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      const isCreate = !existingProject;
+      const updatedProject = isCreate ? await createFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId },
+        validatedProjectData
+      ) : await updateFullProjectServerSide(dbClient_default, logger8)(
+        { tenantId, projectId },
+        validatedProjectData
+      );
+      return c.json({ data: updatedProject }, isCreate ? 201 : 200);
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw createApiError({
+          code: "bad_request",
+          message: "Invalid project definition"
+        });
+      }
+      if (error instanceof Error && error.message.includes("ID mismatch")) {
+        throw createApiError({
+          code: "bad_request",
+          message: error.message
+        });
+      }
+      throw createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to update project"
+      });
+    }
+  }
+);
+app18.openapi(
+  createRoute({
+    method: "delete",
+    path: "/project-full/{projectId}",
+    summary: "Delete Full Project",
+    operationId: "delete-full-project",
+    tags: ["CRUD Full Project"],
+    description: "Delete a complete project and cascade to all related entities (graphs, agents, tools, relationships)",
+    request: {
+      params: ProjectIdParamsSchema
+    },
+    responses: {
+      204: {
+        description: "Project deleted successfully"
+      },
+      ...commonGetErrorResponses
+    }
+  }),
+  async (c) => {
+    const { tenantId, projectId } = c.req.valid("param");
+    try {
+      const deleted = await deleteFullProject(
+        dbClient_default,
+        logger8
+      )({
+        scopes: { tenantId, projectId },
+        projectId
+      });
+      if (!deleted) {
+        throw createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      return c.body(null, 204);
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("not found")) {
+        throw createApiError({
+          code: "not_found",
+          message: "Project not found"
+        });
+      }
+      throw createApiError({
+        code: "internal_server_error",
+        message: error instanceof Error ? error.message : "Failed to delete project"
+      });
+    }
+  }
+);
+var projectFull_default = app18;
 
 // src/app.ts
 function createManagementHono(serverConfig, credentialStores) {
-  const app19 = new OpenAPIHono();
-  app19.use("*", requestId());
-  app19.use("*", async (c, next) => {
+  const app20 = new OpenAPIHono();
+  app20.use("*", requestId());
+  app20.use("*", async (c, next) => {
     c.set("serverConfig", serverConfig);
     c.set("credentialStores", credentialStores);
     return next();
   });
-  app19.use(
+  app20.use(
     pinoLogger({
       pino: getLogger(),
       http: {
@@ -4914,7 +5195,7 @@ function createManagementHono(serverConfig, credentialStores) {
       }
     })
   );
-  app19.onError(async (err, c) => {
+  app20.onError(async (err, c) => {
     const isExpectedError = err instanceof HTTPException;
     const status = isExpectedError ? err.status : 500;
     const requestId2 = c.get("requestId") || "unknown";
@@ -4989,7 +5270,7 @@ function createManagementHono(serverConfig, credentialStores) {
       ...instance && { instance }
     });
   });
-  app19.use(
+  app20.use(
     "*",
     cors({
       origin: (origin) => {
@@ -5003,7 +5284,7 @@ function createManagementHono(serverConfig, credentialStores) {
       credentials: true
     })
   );
-  app19.openapi(
+  app20.openapi(
     createRoute({
       method: "get",
       path: "/health",
@@ -5020,12 +5301,13 @@ function createManagementHono(serverConfig, credentialStores) {
       return c.body(null, 204);
     }
   );
-  app19.use("/tenants/*", apiKeyAuth());
-  app19.route("/tenants/:tenantId/crud", routes_default);
-  app19.route("/oauth", oauth_default);
-  setupOpenAPIRoutes(app19);
+  app20.use("/tenants/*", apiKeyAuth());
+  app20.route("/tenants/:tenantId/crud", routes_default);
+  app20.route("/tenants/:tenantId", projectFull_default);
+  app20.route("/oauth", oauth_default);
+  setupOpenAPIRoutes(app20);
   const baseApp = new Hono();
-  baseApp.route("/", app19);
+  baseApp.route("/", app20);
   return baseApp;
 }
 
@@ -5041,8 +5323,8 @@ var defaultConfig = {
 };
 var defaultStores = createDefaultCredentialStores();
 var defaultRegistry = new CredentialStoreRegistry(defaultStores);
-var app18 = createManagementHono(defaultConfig, defaultRegistry);
-var index_default = app18;
+var app19 = createManagementHono(defaultConfig, defaultRegistry);
+var index_default = app19;
 function createManagementApp(config2) {
   const serverConfig = config2?.serverConfig ?? defaultConfig;
   const stores = config2?.credentialStores ?? defaultStores;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inkeep/agents-manage-api",
-  "version": "0.1.6",
-  "description": "Management API for Inkeep Agent Framework - handles CRUD operations and OAuth",
+  "version": "0.1.8",
+  "description": "Agents Manage API for Inkeep Agent Framework - handles CRUD operations and OAuth",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -24,7 +24,7 @@
     "openid-client": "^6.6.4",
     "pino": "^9.7.0",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.1.6"
+    "@inkeep/agents-core": "^0.1.8"
   },
   "devDependencies": {
     "@hono/vite-dev-server": "^0.20.1",