@inkeep/agents-api 0.0.1

package/dist/domains/manage/routes/artifactComponents.js

@@ -0,0 +1,210 @@
+import { requireProjectPermission } from "../../../middleware/projectAccess.js";
+import { speakeasyOffsetLimitPagination } from "../../../utils/speakeasy.js";
+import { OpenAPIHono, createRoute } from "@hono/zod-openapi";
+import { ArtifactComponentApiInsertSchema, ArtifactComponentApiUpdateSchema, ArtifactComponentListResponse, ArtifactComponentResponse, ErrorResponseSchema, PaginationQueryParamsSchema, TenantProjectIdParamsSchema, TenantProjectParamsSchema, commonGetErrorResponses, createApiError, createArtifactComponent, deleteArtifactComponent, generateId, getArtifactComponentById, listArtifactComponentsPaginated, updateArtifactComponent, validatePropsAsJsonSchema } from "@inkeep/agents-core";
+
+//#region src/domains/manage/routes/artifactComponents.ts
+const app = new OpenAPIHono();
+app.use("/", async (c, next) => {
+	if (c.req.method === "POST") return requireProjectPermission("edit")(c, next);
+	return next();
+});
+app.use("/:id", async (c, next) => {
+	if (c.req.method === "PATCH" || c.req.method === "PUT") return requireProjectPermission("edit")(c, next);
+	if (c.req.method === "DELETE") return requireProjectPermission("edit")(c, next);
+	return next();
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/",
+	summary: "List Artifact Components",
+	operationId: "list-artifact-components",
+	tags: ["Artifact Component"],
+	request: {
+		params: TenantProjectParamsSchema,
+		query: PaginationQueryParamsSchema
+	},
+	responses: {
+		200: {
+			description: "List of artifact components retrieved successfully",
+			content: { "application/json": { schema: ArtifactComponentListResponse } }
+		},
+		...commonGetErrorResponses
+	},
+	...speakeasyOffsetLimitPagination
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId } = 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 listArtifactComponentsPaginated(db)({
+		scopes: {
+			tenantId,
+			projectId
+		},
+		pagination: {
+			page,
+			limit
+		}
+	});
+	return c.json(result);
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/{id}",
+	summary: "Get Artifact Component",
+	operationId: "get-artifact-component-by-id",
+	tags: ["Artifact Component"],
+	request: { params: TenantProjectIdParamsSchema },
+	responses: {
+		200: {
+			description: "Artifact component found",
+			content: { "application/json": { schema: ArtifactComponentResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, id } = c.req.valid("param");
+	const artifactComponent = await getArtifactComponentById(db)({
+		scopes: {
+			tenantId,
+			projectId
+		},
+		id
+	});
+	if (!artifactComponent) throw createApiError({
+		code: "not_found",
+		message: "Artifact component not found"
+	});
+	return c.json({ data: artifactComponent });
+});
+app.openapi(createRoute({
+	method: "post",
+	path: "/",
+	summary: "Create Artifact Component",
+	operationId: "create-artifact-component",
+	tags: ["Artifact Component"],
+	request: {
+		params: TenantProjectParamsSchema,
+		body: { content: { "application/json": { schema: ArtifactComponentApiInsertSchema } } }
+	},
+	responses: {
+		201: {
+			description: "Artifact component created successfully",
+			content: { "application/json": { schema: ArtifactComponentResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId } = c.req.valid("param");
+	const body = c.req.valid("json");
+	if (body.props !== null && body.props !== void 0) {
+		const propsValidation = validatePropsAsJsonSchema(body.props);
+		if (!propsValidation.isValid) throw createApiError({
+			code: "bad_request",
+			message: `Invalid props schema: ${propsValidation.errors.map((e) => `${e.field}: ${e.message}`).join(", ")}`
+		});
+	}
+	const finalId = body.id ? String(body.id) : generateId();
+	const componentData = {
+		tenantId,
+		projectId,
+		id: finalId,
+		name: String(body.name),
+		description: String(body.description),
+		props: body.props ?? null,
+		render: body.render ?? null
+	};
+	try {
+		const artifactComponent = await createArtifactComponent(db)({ ...componentData });
+		return c.json({ data: artifactComponent }, 201);
+	} catch (error) {
+		if (error?.cause?.code === "23505") throw createApiError({
+			code: "conflict",
+			message: `Artifact component with ID '${finalId}' already exists`
+		});
+		throw error;
+	}
+});
+app.openapi(createRoute({
+	method: "put",
+	path: "/{id}",
+	summary: "Update Artifact Component",
+	operationId: "update-artifact-component",
+	tags: ["Artifact Component"],
+	request: {
+		params: TenantProjectIdParamsSchema,
+		body: { content: { "application/json": { schema: ArtifactComponentApiUpdateSchema } } }
+	},
+	responses: {
+		200: {
+			description: "Artifact component updated successfully",
+			content: { "application/json": { schema: ArtifactComponentResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, id } = c.req.valid("param");
+	const body = c.req.valid("json");
+	if (body.props !== void 0 && body.props !== null) {
+		const propsValidation = validatePropsAsJsonSchema(body.props);
+		if (!propsValidation.isValid) throw createApiError({
+			code: "bad_request",
+			message: `Invalid props schema: ${propsValidation.errors.map((e) => `${e.field}: ${e.message}`).join(", ")}`
+		});
+	}
+	const updateData = {};
+	if (body.name !== void 0) updateData.name = String(body.name);
+	if (body.description !== void 0) updateData.description = String(body.description);
+	if (body.props !== void 0) updateData.props = body.props ?? null;
+	if (body.render !== void 0) updateData.render = body.render ?? null;
+	const updatedArtifactComponent = await updateArtifactComponent(db)({
+		scopes: {
+			tenantId,
+			projectId
+		},
+		id,
+		data: updateData
+	});
+	if (!updatedArtifactComponent) throw createApiError({
+		code: "not_found",
+		message: "Artifact component not found"
+	});
+	return c.json({ data: updatedArtifactComponent });
+});
+app.openapi(createRoute({
+	method: "delete",
+	path: "/{id}",
+	summary: "Delete Artifact Component",
+	operationId: "delete-artifact-component",
+	tags: ["Artifact Component"],
+	request: { params: TenantProjectIdParamsSchema },
+	responses: {
+		204: { description: "Artifact component deleted successfully" },
+		404: {
+			description: "Artifact component not found",
+			content: { "application/json": { schema: ErrorResponseSchema } }
+		}
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, id } = c.req.valid("param");
+	if (!await deleteArtifactComponent(db)({
+		scopes: {
+			tenantId,
+			projectId
+		},
+		id
+	})) throw createApiError({
+		code: "not_found",
+		message: "Artifact component not found"
+	});
+	return c.body(null, 204);
+});
+var artifactComponents_default = app;
+
+//#endregion
+export { artifactComponents_default as default };

package/dist/domains/manage/routes/branches.d.ts

@@ -0,0 +1,9 @@
+import { ManageAppVariables } from "../../../types/app.js";
+import { OpenAPIHono } from "@hono/zod-openapi";
+
+//#region src/domains/manage/routes/branches.d.ts
+declare const app: OpenAPIHono<{
+  Variables: ManageAppVariables;
+}, {}, "/">;
+//#endregion
+export { app as default };

package/dist/domains/manage/routes/branches.js

@@ -0,0 +1,182 @@
+import runDbClient_default from "../../../data/db/runDbClient.js";
+import { OpenAPIHono, createRoute } from "@hono/zod-openapi";
+import { BranchListResponseSchema, BranchNameParamsSchema, BranchResponseSchema, CreateBranchRequestSchema, ErrorResponseSchema, TenantProjectAgentParamsSchema, TenantProjectParamsSchema, cascadeDeleteByBranch, commonGetErrorResponses, createApiError, createBranch, deleteBranch, getBranch, listBranches, listBranchesForAgent } from "@inkeep/agents-core";
+
+//#region src/domains/manage/routes/branches.ts
+const app = new OpenAPIHono();
+app.openapi(createRoute({
+	method: "get",
+	path: "/",
+	summary: "List Branches",
+	description: "List all branches within a project",
+	operationId: "list-branches",
+	tags: ["Branches"],
+	request: { params: TenantProjectParamsSchema },
+	responses: {
+		200: {
+			description: "List of branches retrieved successfully",
+			content: { "application/json": { schema: BranchListResponseSchema } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId } = c.req.valid("param");
+	const branches = await listBranches(db)({
+		tenantId,
+		projectId
+	});
+	return c.json({ data: branches });
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/{branchName}",
+	summary: "Get Branch",
+	description: "Get a single branch by name",
+	operationId: "get-branch",
+	tags: ["Branches"],
+	request: { params: BranchNameParamsSchema },
+	responses: {
+		200: {
+			description: "Branch found",
+			content: { "application/json": { schema: BranchResponseSchema } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, branchName } = c.req.valid("param");
+	const branch = await getBranch(db)({
+		tenantId,
+		projectId,
+		name: branchName
+	});
+	if (!branch) throw createApiError({
+		code: "not_found",
+		message: `Branch '${branchName}' not found`
+	});
+	return c.json({ data: branch });
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/agents/{agentId}",
+	summary: "List Branches for Agent",
+	description: "List all branches within a project that contain the agent",
+	operationId: "list-branches-for-agent",
+	tags: ["Branches"],
+	request: { params: TenantProjectAgentParamsSchema },
+	responses: {
+		200: {
+			description: "List of branches retrieved successfully",
+			content: { "application/json": { schema: BranchListResponseSchema } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, agentId } = c.req.valid("param");
+	const branches = await listBranchesForAgent(db)({
+		tenantId,
+		projectId,
+		agentId
+	});
+	return c.json({ data: branches });
+});
+app.openapi(createRoute({
+	method: "post",
+	path: "/",
+	summary: "Create Branch",
+	description: "Create a new branch",
+	operationId: "create-branch",
+	tags: ["Branches"],
+	request: {
+		params: TenantProjectParamsSchema,
+		body: { content: { "application/json": { schema: CreateBranchRequestSchema } } }
+	},
+	responses: {
+		201: {
+			description: "Branch created successfully",
+			content: { "application/json": { schema: BranchResponseSchema } }
+		},
+		409: {
+			description: "Branch already exists",
+			content: { "application/json": { schema: ErrorResponseSchema } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId } = c.req.valid("param");
+	const { name, from } = c.req.valid("json");
+	try {
+		const branch = await createBranch(db)({
+			tenantId,
+			projectId,
+			name,
+			from
+		});
+		return c.json({ data: branch }, 201);
+	} catch (error) {
+		const message = error?.message || "Unknown error";
+		if (message.includes("already exists")) throw createApiError({
+			code: "conflict",
+			message: `Branch '${name}' already exists`
+		});
+		if (message.includes("cannot be empty") || message.includes("invalid")) throw createApiError({
+			code: "bad_request",
+			message
+		});
+		throw error;
+	}
+});
+app.openapi(createRoute({
+	method: "delete",
+	path: "/{branchName}",
+	summary: "Delete Branch",
+	description: "Delete a branch. Cannot delete protected branches like main.",
+	operationId: "delete-branch",
+	tags: ["Branches"],
+	request: { params: BranchNameParamsSchema },
+	responses: {
+		204: { description: "Branch deleted successfully" },
+		...commonGetErrorResponses,
+		403: {
+			description: "Cannot delete protected branch",
+			content: { "application/json": { schema: ErrorResponseSchema } }
+		}
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, branchName } = c.req.valid("param");
+	try {
+		const fullBranchName = `${tenantId}_${projectId}_${branchName}`;
+		await cascadeDeleteByBranch(runDbClient_default)({
+			scopes: {
+				tenantId,
+				projectId
+			},
+			fullBranchName
+		});
+		await deleteBranch(db)({
+			tenantId,
+			projectId,
+			name: branchName
+		});
+		return c.body(null, 204);
+	} catch (error) {
+		const message = error?.message || "Unknown error";
+		if (message.includes("protected branch")) throw createApiError({
+			code: "forbidden",
+			message
+		});
+		if (message.includes("not found")) throw createApiError({
+			code: "not_found",
+			message: `Branch '${branchName}' not found`
+		});
+		throw error;
+	}
+});
+var branches_default = app;
+
+//#endregion
+export { branches_default as default };

package/dist/domains/manage/routes/cliAuth.d.ts

@@ -0,0 +1,9 @@
+import { ManageAppVariables } from "../../../types/app.js";
+import { OpenAPIHono } from "@hono/zod-openapi";
+
+//#region src/domains/manage/routes/cliAuth.d.ts
+declare const cliAuthRoutes: OpenAPIHono<{
+  Variables: ManageAppVariables;
+}, {}, "/">;
+//#endregion
+export { cliAuthRoutes as default };

package/dist/domains/manage/routes/cliAuth.js

@@ -0,0 +1,60 @@
+import runDbClient_default from "../../../data/db/runDbClient.js";
+import { sessionAuth } from "../../../middleware/sessionAuth.js";
+import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
+import { getUserOrganizations } from "@inkeep/agents-core";
+
+//#region src/domains/manage/routes/cliAuth.ts
+const cliAuthRoutes = new OpenAPIHono();
+const CLIMeResponseSchema = z.object({
+	user: z.object({
+		id: z.string(),
+		email: z.string(),
+		name: z.string().nullable()
+	}),
+	organization: z.object({
+		id: z.string(),
+		name: z.string(),
+		slug: z.string(),
+		role: z.string()
+	})
+});
+cliAuthRoutes.openapi(createRoute({
+	method: "get",
+	path: "/me",
+	tags: ["cli"],
+	summary: "Get CLI user info",
+	description: "Get the current authenticated user and their organization for CLI usage",
+	middleware: [sessionAuth()],
+	responses: {
+		200: {
+			description: "User info with organization",
+			content: { "application/json": { schema: CLIMeResponseSchema } }
+		},
+		401: { description: "Not authenticated" },
+		404: { description: "User has no organization" }
+	}
+}), async (c) => {
+	const user = c.get("user");
+	const userId = c.get("userId");
+	if (!user || !userId) return c.json({ error: "Not authenticated" }, 401);
+	const organizations = await getUserOrganizations(runDbClient_default)(userId);
+	if (organizations.length === 0) return c.json({ error: "User has no organization" }, 404);
+	const org = organizations[0];
+	return c.json({
+		user: {
+			id: user.id,
+			email: user.email,
+			name: user.name || null
+		},
+		organization: {
+			id: org.organizationId,
+			name: org.organizationName || "",
+			slug: org.organizationSlug || "",
+			role: org.role
+		}
+	});
+});
+var cliAuth_default = cliAuthRoutes;
+
+//#endregion
+export { cliAuth_default as default };

package/dist/domains/manage/routes/contextConfigs.d.ts

@@ -0,0 +1,9 @@
+import { ManageAppVariables } from "../../../types/app.js";
+import { OpenAPIHono } from "@hono/zod-openapi";
+
+//#region src/domains/manage/routes/contextConfigs.d.ts
+declare const app: OpenAPIHono<{
+  Variables: ManageAppVariables;
+}, {}, "/">;
+//#endregion
+export { app as default };

package/dist/domains/manage/routes/contextConfigs.js

@@ -0,0 +1,189 @@
+import runDbClient_default from "../../../data/db/runDbClient.js";
+import { requireProjectPermission } from "../../../middleware/projectAccess.js";
+import { speakeasyOffsetLimitPagination } from "../../../utils/speakeasy.js";
+import { OpenAPIHono, createRoute } from "@hono/zod-openapi";
+import { ContextConfigApiInsertSchema, ContextConfigApiUpdateSchema, ContextConfigListResponse, ContextConfigResponse, PaginationQueryParamsSchema, TenantProjectAgentIdParamsSchema, TenantProjectAgentParamsSchema, cascadeDeleteByContextConfig, commonDeleteErrorResponses, commonGetErrorResponses, commonUpdateErrorResponses, createApiError, createContextConfig, deleteContextConfig, getContextConfigById, listContextConfigsPaginated, updateContextConfig } from "@inkeep/agents-core";
+
+//#region src/domains/manage/routes/contextConfigs.ts
+const app = new OpenAPIHono();
+app.use("/", async (c, next) => {
+	if (c.req.method === "POST") return requireProjectPermission("edit")(c, next);
+	return next();
+});
+app.use("/:id", async (c, next) => {
+	if (c.req.method === "PUT") return requireProjectPermission("edit")(c, next);
+	if (c.req.method === "DELETE") return requireProjectPermission("edit")(c, next);
+	return next();
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/",
+	summary: "List Context Configurations",
+	operationId: "list-context-configs",
+	tags: ["Context Config"],
+	request: {
+		params: TenantProjectAgentParamsSchema,
+		query: PaginationQueryParamsSchema
+	},
+	responses: {
+		200: {
+			description: "List of context configurations retrieved successfully",
+			content: { "application/json": { schema: ContextConfigListResponse } }
+		},
+		...commonGetErrorResponses
+	},
+	...speakeasyOffsetLimitPagination
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, agentId } = 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 listContextConfigsPaginated(db)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		pagination: {
+			page,
+			limit
+		}
+	});
+	return c.json(result);
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/{id}",
+	summary: "Get Context Configuration",
+	operationId: "get-context-config-by-id",
+	tags: ["Context Config"],
+	request: { params: TenantProjectAgentIdParamsSchema },
+	responses: {
+		200: {
+			description: "Context configuration found",
+			content: { "application/json": { schema: ContextConfigResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	const contextConfig = await getContextConfigById(db)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		id
+	});
+	if (!contextConfig) throw createApiError({
+		code: "not_found",
+		message: "Context configuration not found"
+	});
+	return c.json({ data: contextConfig });
+});
+app.openapi(createRoute({
+	method: "post",
+	path: "/",
+	summary: "Create Context Configuration",
+	operationId: "create-context-config",
+	tags: ["Context Config"],
+	request: {
+		params: TenantProjectAgentParamsSchema,
+		body: { content: { "application/json": { schema: ContextConfigApiInsertSchema } } }
+	},
+	responses: {
+		201: {
+			description: "Context configuration created successfully",
+			content: { "application/json": { schema: ContextConfigResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, agentId } = c.req.valid("param");
+	const configData = {
+		tenantId,
+		projectId,
+		agentId,
+		...c.req.valid("json")
+	};
+	const contextConfig = await createContextConfig(db)(configData);
+	return c.json({ data: contextConfig }, 201);
+});
+app.openapi(createRoute({
+	method: "put",
+	path: "/{id}",
+	summary: "Update Context Configuration",
+	operationId: "update-context-config",
+	tags: ["Context Config"],
+	request: {
+		params: TenantProjectAgentIdParamsSchema,
+		body: { content: { "application/json": { schema: ContextConfigApiUpdateSchema } } }
+	},
+	responses: {
+		200: {
+			description: "Context configuration updated successfully",
+			content: { "application/json": { schema: ContextConfigResponse } }
+		},
+		...commonUpdateErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	const body = c.req.valid("json");
+	const updatedContextConfig = await updateContextConfig(db)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		id,
+		data: body
+	});
+	if (!updatedContextConfig) throw createApiError({
+		code: "not_found",
+		message: "Context configuration not found"
+	});
+	return c.json({ data: updatedContextConfig });
+});
+app.openapi(createRoute({
+	method: "delete",
+	path: "/{id}",
+	summary: "Delete Context Configuration",
+	operationId: "delete-context-config",
+	tags: ["Context Config"],
+	request: { params: TenantProjectAgentIdParamsSchema },
+	responses: {
+		204: { description: "Context configuration deleted successfully" },
+		...commonDeleteErrorResponses
+	}
+}), async (c) => {
+	const db = c.get("db");
+	const resolvedRef = c.get("resolvedRef");
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	await cascadeDeleteByContextConfig(runDbClient_default)({
+		scopes: {
+			tenantId,
+			projectId
+		},
+		contextConfigId: id,
+		fullBranchName: resolvedRef.name
+	});
+	if (!await deleteContextConfig(db)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		id
+	})) throw createApiError({
+		code: "not_found",
+		message: "Context configuration not found"
+	});
+	return c.body(null, 204);
+});
+var contextConfigs_default = app;
+
+//#endregion
+export { contextConfigs_default as default };

package/dist/domains/manage/routes/conversations.d.ts

@@ -0,0 +1,7 @@
+import { OpenAPIHono } from "@hono/zod-openapi";
+import * as hono17 from "hono";
+
+//#region src/domains/manage/routes/conversations.d.ts
+declare const app: OpenAPIHono<hono17.Env, {}, "/">;
+//#endregion
+export { app as default };