@inkeep/agents-manage-api 0.39.4 → 0.40.0

package/dist/routes/subAgentTeamAgentRelations.d.ts

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

package/dist/routes/subAgentTeamAgentRelations.js

@@ -0,0 +1,213 @@
+import dbClient_default from "../data/db/dbClient.js";
+import { requirePermission } from "../middleware/require-permission.js";
+import { speakeasyOffsetLimitPagination } from "./shared.js";
+import { OpenAPIHono, createRoute } from "@hono/zod-openapi";
+import { ErrorResponseSchema, PaginationQueryParamsSchema, SubAgentTeamAgentRelationApiInsertSchema, SubAgentTeamAgentRelationApiUpdateSchema, SubAgentTeamAgentRelationListResponse, SubAgentTeamAgentRelationResponse, TenantProjectAgentSubAgentIdParamsSchema, TenantProjectAgentSubAgentParamsSchema, commonGetErrorResponses, createApiError, createSubAgentTeamAgentRelation, deleteSubAgentTeamAgentRelation, getSubAgentTeamAgentRelationById, listSubAgentTeamAgentRelations, updateSubAgentTeamAgentRelation } from "@inkeep/agents-core";
+import { nanoid } from "nanoid";
+
+//#region src/routes/subAgentTeamAgentRelations.ts
+const app = new OpenAPIHono();
+app.use("/", async (c, next) => {
+	if (c.req.method === "POST") return requirePermission({ sub_agent: ["create"] })(c, next);
+	return next();
+});
+app.use("/:id", async (c, next) => {
+	if (c.req.method === "PUT") return requirePermission({ sub_agent: ["update"] })(c, next);
+	if (c.req.method === "DELETE") return requirePermission({ sub_agent: ["delete"] })(c, next);
+	return next();
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/",
+	summary: "List Sub Agent Team Agent Relations",
+	operationId: "list-sub-agent-team-agent-relations",
+	tags: ["Sub Agent Team Agent Relations"],
+	request: {
+		params: TenantProjectAgentSubAgentParamsSchema,
+		query: PaginationQueryParamsSchema
+	},
+	responses: {
+		200: {
+			description: "List of sub agent team agent relations retrieved successfully",
+			content: { "application/json": { schema: SubAgentTeamAgentRelationListResponse } }
+		},
+		...commonGetErrorResponses
+	},
+	...speakeasyOffsetLimitPagination
+}), async (c) => {
+	const { tenantId, projectId, agentId, subAgentId } = c.req.valid("param");
+	const { page = 1, limit = 10 } = c.req.valid("query");
+	const pageNum = Number(page);
+	const limitNum = Math.min(Number(limit), 100);
+	try {
+		const result = await listSubAgentTeamAgentRelations(dbClient_default)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId,
+				subAgentId
+			},
+			pagination: {
+				page: pageNum,
+				limit: limitNum
+			}
+		});
+		return c.json(result);
+	} catch (_error) {
+		throw createApiError({
+			code: "internal_server_error",
+			message: "Failed to retrieve sub agent team agent relations"
+		});
+	}
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/{id}",
+	summary: "Get Sub Agent Team Agent Relation",
+	operationId: "get-sub-agent-team-agent-relation-by-id",
+	tags: ["Sub Agent Team Agent Relations"],
+	request: { params: TenantProjectAgentSubAgentIdParamsSchema },
+	responses: {
+		200: {
+			description: "Sub Agent team agent relation found",
+			content: { "application/json": { schema: SubAgentTeamAgentRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, subAgentId, id } = c.req.valid("param");
+	const relation = await getSubAgentTeamAgentRelationById(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId
+		},
+		relationId: id
+	});
+	if (!relation) throw createApiError({
+		code: "not_found",
+		message: "Sub Agent Team Agent Relation not found"
+	});
+	return c.json({ data: relation });
+});
+app.openapi(createRoute({
+	method: "post",
+	path: "/",
+	summary: "Create Sub Agent Team Agent Relation",
+	operationId: "create-sub-agent-team-agent-relation",
+	tags: ["Sub Agent Team Agent Relations"],
+	request: {
+		params: TenantProjectAgentSubAgentParamsSchema,
+		body: { content: { "application/json": { schema: SubAgentTeamAgentRelationApiInsertSchema } } }
+	},
+	responses: {
+		201: {
+			description: "Sub Agent Team Agent Relation created successfully",
+			content: { "application/json": { schema: SubAgentTeamAgentRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, subAgentId } = c.req.valid("param");
+	const body = await c.req.valid("json");
+	if ((await listSubAgentTeamAgentRelations(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId
+		},
+		pagination: {
+			page: 1,
+			limit: 1e3
+		}
+	})).data.some((relation$1) => relation$1.targetAgentId === body.targetAgentId && relation$1.subAgentId === subAgentId)) throw createApiError({
+		code: "unprocessable_entity",
+		message: `A relation between this sub-agent and team agent already exists`
+	});
+	const relation = await createSubAgentTeamAgentRelation(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId
+		},
+		relationId: nanoid(),
+		data: {
+			targetAgentId: body.targetAgentId,
+			headers: body.headers || null
+		}
+	});
+	return c.json({ data: relation }, 201);
+});
+app.openapi(createRoute({
+	method: "put",
+	path: "/{id}",
+	summary: "Update Sub Agent Team Agent Relation",
+	operationId: "update-sub-agent-team-agent-relation",
+	tags: ["Sub Agent Team Agent Relations"],
+	request: {
+		params: TenantProjectAgentSubAgentIdParamsSchema,
+		body: { content: { "application/json": { schema: SubAgentTeamAgentRelationApiUpdateSchema } } }
+	},
+	responses: {
+		200: {
+			description: "Sub Agent team agent relation updated successfully",
+			content: { "application/json": { schema: SubAgentTeamAgentRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, subAgentId, id } = c.req.valid("param");
+	const body = await c.req.valid("json");
+	const updatedRelation = await updateSubAgentTeamAgentRelation(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId
+		},
+		relationId: id,
+		data: body
+	});
+	if (!updatedRelation) throw createApiError({
+		code: "not_found",
+		message: "Sub Agent Team Agent Relation not found"
+	});
+	return c.json({ data: updatedRelation });
+});
+app.openapi(createRoute({
+	method: "delete",
+	path: "/{id}",
+	summary: "Delete Sub Agent Team Agent Relation",
+	operationId: "delete-sub-agent-team-agent-relation",
+	tags: ["Sub Agent Team Agent Relations"],
+	request: { params: TenantProjectAgentSubAgentIdParamsSchema },
+	responses: {
+		204: { description: "Sub Agent Team Agent Relation deleted successfully" },
+		404: {
+			description: "Sub Agent Team Agent Relation not found",
+			content: { "application/json": { schema: ErrorResponseSchema } }
+		}
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, subAgentId, id } = c.req.valid("param");
+	if (!await deleteSubAgentTeamAgentRelation(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId
+		},
+		relationId: id
+	})) throw createApiError({
+		code: "not_found",
+		message: "Sub Agent Team Agent Relation not found"
+	});
+	return c.body(null, 204);
+});
+var subAgentTeamAgentRelations_default = app;
+
+//#endregion
+export { subAgentTeamAgentRelations_default as default };

package/dist/routes/subAgentToolRelations.d.ts

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

package/dist/routes/subAgentToolRelations.js

@@ -0,0 +1,284 @@
+import dbClient_default from "../data/db/dbClient.js";
+import { requirePermission } from "../middleware/require-permission.js";
+import { speakeasyOffsetLimitPagination } from "./shared.js";
+import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
+import { ErrorResponseSchema, PaginationQueryParamsSchema, SubAgentToolRelationApiInsertSchema, SubAgentToolRelationApiUpdateSchema, SubAgentToolRelationListResponse, SubAgentToolRelationResponse, TenantProjectAgentIdParamsSchema, TenantProjectAgentParamsSchema, commonGetErrorResponses, createAgentToolRelation, createApiError, deleteAgentToolRelation, getAgentToolRelationByAgent, getAgentToolRelationById, getAgentToolRelationByTool, getAgentsForTool, listAgentToolRelations, updateAgentToolRelation } from "@inkeep/agents-core";
+
+//#region src/routes/subAgentToolRelations.ts
+const app = new OpenAPIHono();
+app.use("/", async (c, next) => {
+	if (c.req.method === "POST") return requirePermission({ sub_agent: ["create"] })(c, next);
+	return next();
+});
+app.use("/:id", async (c, next) => {
+	if (c.req.method === "PUT") return requirePermission({ sub_agent: ["update"] })(c, next);
+	if (c.req.method === "DELETE") return requirePermission({ sub_agent: ["delete"] })(c, next);
+	return next();
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/",
+	summary: "List SubAgent Tool Relations",
+	operationId: "list-subagent-tool-relations",
+	tags: ["SubAgent Tool Relations"],
+	request: {
+		params: TenantProjectAgentParamsSchema,
+		query: PaginationQueryParamsSchema.extend({
+			subAgentId: z.string().optional(),
+			toolId: z.string().optional()
+		})
+	},
+	responses: {
+		200: {
+			description: "List of subAgent tool relations retrieved successfully",
+			content: { "application/json": { schema: SubAgentToolRelationListResponse } }
+		},
+		...commonGetErrorResponses
+	},
+	...speakeasyOffsetLimitPagination
+}), async (c) => {
+	const { tenantId, projectId, agentId } = c.req.valid("param");
+	const { page, limit, subAgentId, toolId } = c.req.valid("query");
+	let result;
+	if (subAgentId) {
+		const dbResult = await getAgentToolRelationByAgent(dbClient_default)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId,
+				subAgentId
+			},
+			pagination: {
+				page,
+				limit
+			}
+		});
+		result = {
+			data: dbResult.data,
+			pagination: dbResult.pagination
+		};
+	} else if (toolId) {
+		const dbResult = await getAgentToolRelationByTool(dbClient_default)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId
+			},
+			toolId,
+			pagination: {
+				page,
+				limit
+			}
+		});
+		result = {
+			data: dbResult.data,
+			pagination: dbResult.pagination
+		};
+	} else {
+		const dbResult = await listAgentToolRelations(dbClient_default)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId
+			},
+			pagination: {
+				page,
+				limit
+			}
+		});
+		result = {
+			data: dbResult.data,
+			pagination: dbResult.pagination
+		};
+	}
+	return c.json(result);
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/{id}",
+	summary: "Get SubAgent Tool Relation",
+	operationId: "get-subagent-tool-relation",
+	tags: ["SubAgent Tool Relations"],
+	request: { params: TenantProjectAgentIdParamsSchema },
+	responses: {
+		200: {
+			description: "SubAgent tool relation found",
+			content: { "application/json": { schema: SubAgentToolRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	const agentToolRelation = await getAgentToolRelationById(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId,
+			subAgentId: id
+		},
+		relationId: id
+	});
+	if (!agentToolRelation) throw createApiError({
+		code: "not_found",
+		message: "SubAgent tool relation not found"
+	});
+	return c.json({ data: agentToolRelation });
+});
+app.openapi(createRoute({
+	method: "get",
+	path: "/tool/{toolId}/sub-agents",
+	summary: "Get SubAgents for Tool",
+	operationId: "get-subagents-for-tool",
+	tags: ["SubAgent Tool Relations"],
+	request: {
+		params: TenantProjectAgentParamsSchema.extend({ toolId: z.string() }),
+		query: PaginationQueryParamsSchema
+	},
+	responses: {
+		200: {
+			description: "SubAgents for tool retrieved successfully",
+			content: { "application/json": { schema: SubAgentToolRelationListResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, toolId } = c.req.valid("param");
+	const { page, limit } = c.req.valid("query");
+	const dbResult = await getAgentsForTool(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		toolId,
+		pagination: {
+			page,
+			limit
+		}
+	});
+	return c.json(dbResult);
+});
+app.openapi(createRoute({
+	method: "post",
+	path: "/",
+	summary: "Create SubAgent Tool Relation",
+	operationId: "create-subagent-tool-relation",
+	tags: ["SubAgent Tool Relations"],
+	request: {
+		params: TenantProjectAgentParamsSchema,
+		body: { content: { "application/json": { schema: SubAgentToolRelationApiInsertSchema } } }
+	},
+	responses: {
+		201: {
+			description: "SubAgent tool relation created successfully",
+			content: { "application/json": { schema: SubAgentToolRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId } = c.req.valid("param");
+	const body = c.req.valid("json");
+	if ((await listAgentToolRelations(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		pagination: { limit: 1e3 }
+	})).data.some((relation) => {
+		const typedRelation = relation;
+		return typedRelation.subAgentId === body.subAgentId && typedRelation.toolId === body.toolId;
+	})) throw createApiError({
+		code: "unprocessable_entity",
+		message: "SubAgent tool relation already exists"
+	});
+	try {
+		const agentToolRelation = await createAgentToolRelation(dbClient_default)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId
+			},
+			data: body
+		});
+		return c.json({ data: agentToolRelation }, 201);
+	} catch (error) {
+		if (error?.cause?.code === "23503") throw createApiError({
+			code: "bad_request",
+			message: "Invalid subAgent ID or tool ID - referenced entity does not exist"
+		});
+		throw error;
+	}
+});
+app.openapi(createRoute({
+	method: "put",
+	path: "/{id}",
+	summary: "Update SubAgent Tool Relation",
+	operationId: "update-subagent-tool-relation",
+	tags: ["SubAgent Tool Relations"],
+	request: {
+		params: TenantProjectAgentIdParamsSchema,
+		body: { content: { "application/json": { schema: SubAgentToolRelationApiUpdateSchema } } }
+	},
+	responses: {
+		200: {
+			description: "SubAgent tool relation updated successfully",
+			content: { "application/json": { schema: SubAgentToolRelationResponse } }
+		},
+		...commonGetErrorResponses
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	const body = await c.req.valid("json");
+	if (Object.keys(body).length === 0) throw createApiError({
+		code: "bad_request",
+		message: "No fields to update"
+	});
+	const updatedAgentToolRelation = await updateAgentToolRelation(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		relationId: id,
+		data: body
+	});
+	if (!updatedAgentToolRelation) throw createApiError({
+		code: "not_found",
+		message: "SubAgent tool relation not found"
+	});
+	return c.json({ data: updatedAgentToolRelation });
+});
+app.openapi(createRoute({
+	method: "delete",
+	path: "/{id}",
+	summary: "Delete SubAgent Tool Relation",
+	operationId: "delete-subagent-tool-relation",
+	tags: ["SubAgent Tool Relations"],
+	request: { params: TenantProjectAgentIdParamsSchema },
+	responses: {
+		204: { description: "SubAgent tool relation deleted successfully" },
+		404: {
+			description: "SubAgent tool relation not found",
+			content: { "application/json": { schema: ErrorResponseSchema } }
+		}
+	}
+}), async (c) => {
+	const { tenantId, projectId, agentId, id } = c.req.valid("param");
+	if (!await deleteAgentToolRelation(dbClient_default)({
+		scopes: {
+			tenantId,
+			projectId,
+			agentId
+		},
+		relationId: id
+	})) throw createApiError({
+		code: "not_found",
+		message: "SubAgent tool relation not found"
+	});
+	return c.body(null, 204);
+});
+var subAgentToolRelations_default = app;
+
+//#endregion
+export { subAgentToolRelations_default as default };

package/dist/routes/subAgents.d.ts

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