@inkeep/agents-manage-api 0.0.0-dev-20250912174511 → 0.0.0-dev-20250912184011

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');
@@ -145,10 +145,10 @@ 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 Agents Manage API",
@@ -169,7 +169,7 @@ 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",
@@ -1926,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(
@@ -2154,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(
@@ -4691,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) {
@@ -4709,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);
@@ -4914,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: {
@@ -4937,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";
@@ -5012,7 +5298,7 @@ function createManagementHono(serverConfig, credentialStores) {
       ...instance && { instance }
     });
   });
-  app19.use(
+  app20.use(
     "*",
     cors.cors({
       origin: (origin) => {
@@ -5026,7 +5312,7 @@ function createManagementHono(serverConfig, credentialStores) {
       credentials: true
     })
   );
-  app19.openapi(
+  app20.openapi(
     zodOpenapi.createRoute({
       method: "get",
       path: "/health",
@@ -5043,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;
 }
 
@@ -5064,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';
@@ -117,10 +117,10 @@ 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 Agents Manage API",
@@ -141,7 +141,7 @@ function setupOpenAPIRoutes(app19) {
       return c.json({ error: "Failed to generate OpenAPI document", details: errorDetails }, 500);
     }
   });
-  app19.get(
+  app20.get(
     "/docs",
     swaggerUI({
       url: "/openapi.json",
@@ -1898,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(
@@ -2126,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(
@@ -4663,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) {
@@ -4681,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);
@@ -4886,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: {
@@ -4909,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";
@@ -4984,7 +5270,7 @@ function createManagementHono(serverConfig, credentialStores) {
       ...instance && { instance }
     });
   });
-  app19.use(
+  app20.use(
     "*",
     cors({
       origin: (origin) => {
@@ -4998,7 +5284,7 @@ function createManagementHono(serverConfig, credentialStores) {
       credentials: true
     })
   );
-  app19.openapi(
+  app20.openapi(
     createRoute({
       method: "get",
       path: "/health",
@@ -5015,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;
 }
 
@@ -5036,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,6 +1,6 @@
 {
   "name": "@inkeep/agents-manage-api",
-  "version": "0.0.0-dev-20250912174511",
+  "version": "0.0.0-dev-20250912184011",
   "description": "Agents Manage API for Inkeep Agent Framework - handles CRUD operations and OAuth",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
     "openid-client": "^6.6.4",
     "pino": "^9.7.0",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250912174511"
+    "@inkeep/agents-core": "^0.0.0-dev-20250912184011"
   },
   "devDependencies": {
     "@hono/vite-dev-server": "^0.20.1",