@inkeep/agents-core 0.63.0 → 0.63.2

package/dist/data-access/manage/skills.js

@@ -1,14 +1,152 @@
-import { skills, subAgentSkills } from "../../db/manage/manage-schema.js";
+import { skillFiles, skills, subAgentSkills } from "../../db/manage/manage-schema.js";
+import { SKILL_ENTRY_FILE_PATH, parseSkillFromMarkdown } from "../../utils/skill-files.js";
+import { SkillFrontmatterSchema } from "../../validation/schemas/skills.js";
 import { getLogger } from "../../utils/logger.js";
-import { deriveRelationId } from "../../utils/conversations.js";
+import { deriveRelationId, generateId } from "../../utils/conversations.js";
 import { agentScopedWhere, projectScopedWhere, subAgentScopedWhere } from "./scope-helpers.js";
 import { and, asc, count, desc, eq, inArray } from "drizzle-orm";
 
 //#region src/data-access/manage/skills.ts
 const logger = getLogger("skills-dal");
+async function replaceSkillFiles(db, params) {
+	const existingFiles = await db.select().from(skillFiles).where(and(eq(skillFiles.tenantId, params.scopes.tenantId), eq(skillFiles.projectId, params.scopes.projectId), eq(skillFiles.skillId, params.skillId)));
+	const nextFilePaths = new Set(params.files.map((file) => file.filePath));
+	const existingByPath = new Map(existingFiles.map((file) => [file.filePath, file]));
+	const fileIdsToDelete = existingFiles.filter((file) => !nextFilePaths.has(file.filePath)).map((file) => file.id);
+	if (fileIdsToDelete.length) await db.delete(skillFiles).where(and(projectScopedWhere(skillFiles, params.scopes), eq(skillFiles.skillId, params.skillId), inArray(skillFiles.id, fileIdsToDelete)));
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const filesToInsert = [];
+	for (const file of params.files) {
+		const existingFile = existingByPath.get(file.filePath);
+		if (!existingFile) {
+			filesToInsert.push({
+				tenantId: params.scopes.tenantId,
+				projectId: params.scopes.projectId,
+				skillId: params.skillId,
+				id: generateId(),
+				filePath: file.filePath,
+				content: file.content,
+				createdAt: now,
+				updatedAt: now
+			});
+			continue;
+		}
+		await db.update(skillFiles).set({
+			content: file.content,
+			updatedAt: now
+		}).where(and(projectScopedWhere(skillFiles, params.scopes), eq(skillFiles.skillId, params.skillId), eq(skillFiles.id, existingFile.id)));
+	}
+	if (filesToInsert.length) await db.insert(skillFiles).values(filesToInsert);
+	return (await getSkillFilesBySkillIds(db)({
+		scopes: params.scopes,
+		skillIds: [params.skillId]
+	}))[params.skillId] ?? [];
+}
+const getSkillFilesBySkillIds = (db) => async (params) => {
+	if (!params.skillIds.length) return {};
+	return (await db.select().from(skillFiles).where(and(eq(skillFiles.tenantId, params.scopes.tenantId), eq(skillFiles.projectId, params.scopes.projectId), inArray(skillFiles.skillId, params.skillIds))).orderBy(asc(skillFiles.filePath))).reduce((acc, file) => {
+		acc[file.skillId] ??= [];
+		acc[file.skillId].push(file);
+		return acc;
+	}, {});
+};
 const getSkillById = (db) => async (params) => {
 	return await db.query.skills.findFirst({ where: and(projectScopedWhere(skills, params.scopes), eq(skills.id, params.skillId)) }) ?? null;
 };
+const getSkillByIdWithFiles = (db) => async (params) => {
+	const skill = await getSkillById(db)(params);
+	if (!skill) return null;
+	const files = await getSkillFilesBySkillIds(db)({
+		scopes: params.scopes,
+		skillIds: [params.skillId]
+	});
+	return {
+		...skill,
+		files: files[params.skillId] ?? []
+	};
+};
+const getSkillFileById = (db) => async (params) => {
+	return await db.query.skillFiles.findFirst({ where: and(projectScopedWhere(skillFiles, params.scopes), eq(skillFiles.skillId, params.skillId), eq(skillFiles.id, params.fileId)) }) ?? null;
+};
+const createSkillFileById = (db) => async (params) => {
+	const skill = await getSkillByIdWithFiles(db)({
+		scopes: params.scopes,
+		skillId: params.skillId
+	});
+	if (!skill) return null;
+	if (params.data.filePath === SKILL_ENTRY_FILE_PATH) throw new Error(`Use the skill update flow to manage ${SKILL_ENTRY_FILE_PATH}`);
+	if (skill.files.some((file) => file.filePath === params.data.filePath)) throw new Error(`Skill file already exists at path "${params.data.filePath}"`);
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const [createdFile] = await db.insert(skillFiles).values({
+		tenantId: params.scopes.tenantId,
+		projectId: params.scopes.projectId,
+		skillId: params.skillId,
+		id: generateId(),
+		filePath: params.data.filePath,
+		content: params.data.content,
+		createdAt: now,
+		updatedAt: now
+	}).returning();
+	return createdFile ?? null;
+};
+function buildEntryFileUpdateData(params) {
+	const parsed = parseSkillFromMarkdown(params.content);
+	const frontmatterResult = SkillFrontmatterSchema.safeParse(parsed.frontmatter);
+	if (!frontmatterResult.success) throw new Error(frontmatterResult.error.issues[0]?.message ?? "Invalid SKILL.md frontmatter");
+	if (frontmatterResult.data.name !== params.skillId) throw new Error("SKILL.md name must match the skill id");
+	return {
+		description: frontmatterResult.data.description,
+		metadata: frontmatterResult.data.metadata ?? null,
+		content: parsed.content,
+		files: params.files
+	};
+}
+const updateSkillFileById = (db) => async (params) => {
+	const skill = await getSkillByIdWithFiles(db)({
+		scopes: params.scopes,
+		skillId: params.skillId
+	});
+	if (!skill) return null;
+	const existingFile = skill.files.find((file) => file.id === params.fileId);
+	if (!existingFile) return null;
+	const files = skill.files.map((file) => ({
+		filePath: file.filePath,
+		content: file.id === params.fileId ? params.content : file.content
+	}));
+	const data = existingFile.filePath === SKILL_ENTRY_FILE_PATH ? buildEntryFileUpdateData({
+		skillId: params.skillId,
+		files,
+		content: params.content
+	}) : { files };
+	if (!await updateSkill(db)({
+		scopes: params.scopes,
+		skillId: params.skillId,
+		data
+	})) return null;
+	return await getSkillFileById(db)({
+		scopes: params.scopes,
+		skillId: params.skillId,
+		fileId: params.fileId
+	});
+};
+const deleteSkillFileById = (db) => async (params) => {
+	const skill = await getSkillByIdWithFiles(db)({
+		scopes: params.scopes,
+		skillId: params.skillId
+	});
+	if (!skill) return null;
+	const existingFile = skill.files.find((file) => file.id === params.fileId);
+	if (!existingFile) return null;
+	if (existingFile.filePath === SKILL_ENTRY_FILE_PATH) throw new Error("Use the skill delete flow to remove SKILL.md");
+	return await updateSkill(db)({
+		scopes: params.scopes,
+		skillId: params.skillId,
+		data: { files: skill.files.filter((file) => file.id !== params.fileId).map((file) => ({
+			filePath: file.filePath,
+			content: file.content
+		})) }
+	}) !== null;
+};
 const listSkills = (db) => async (params) => {
 	const page = params.pagination?.page || 1;
 	const limit = Math.min(params.pagination?.limit || 10, 100);
@@ -26,55 +164,130 @@ const listSkills = (db) => async (params) => {
 		}
 	};
 };
-const createSkill = (db) => async (data) => {
-	const now = (/* @__PURE__ */ new Date()).toISOString();
-	const insertData = {
-		...data,
-		id: data.name,
-		createdAt: now,
-		updatedAt: now
+const listSkillsWithFiles = (db) => async (params) => {
+	const result = await listSkills(db)(params);
+	const skillIds = result.data.map((skill) => skill.id);
+	const filesBySkillId = await getSkillFilesBySkillIds(db)({
+		scopes: params.scopes,
+		skillIds
+	});
+	return {
+		...result,
+		data: result.data.map((skill) => ({
+			...skill,
+			files: filesBySkillId[skill.id] ?? []
+		}))
 	};
-	const [result] = await db.insert(skills).values(insertData).returning();
-	return result;
+};
+const createSkill = (db) => async (data) => {
+	return await db.transaction(async (tx) => {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const insertData = {
+			tenantId: data.tenantId,
+			projectId: data.projectId,
+			id: data.name,
+			name: data.name,
+			description: data.description,
+			content: data.content,
+			metadata: data.metadata ?? null,
+			createdAt: now,
+			updatedAt: now
+		};
+		const [result] = await tx.insert(skills).values(insertData).returning();
+		await replaceSkillFiles(tx, {
+			scopes: {
+				tenantId: data.tenantId,
+				projectId: data.projectId
+			},
+			skillId: result.id,
+			files: data.files
+		});
+		const createdSkill = await getSkillByIdWithFiles(tx)({
+			scopes: {
+				tenantId: data.tenantId,
+				projectId: data.projectId
+			},
+			skillId: result.id
+		});
+		if (!createdSkill) throw new Error(`Failed to load created skill "${result.id}"`);
+		return createdSkill;
+	});
 };
 const upsertSkill = (db) => async (data) => {
-	const now = (/* @__PURE__ */ new Date()).toISOString();
-	const baseData = {
-		...data,
-		id: data.name
-	};
-	const scopes = {
-		tenantId: baseData.tenantId,
-		projectId: baseData.projectId
-	};
-	if (await db.query.skills.findFirst({ where: and(projectScopedWhere(skills, scopes), eq(skills.id, baseData.id)) })) {
-		const [result$1] = await db.update(skills).set({
-			name: baseData.name,
-			description: baseData.description,
-			content: baseData.content,
-			metadata: baseData.metadata,
+	return await db.transaction(async (tx) => {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const baseData = {
+			tenantId: data.tenantId,
+			projectId: data.projectId,
+			id: data.name,
+			name: data.name,
+			description: data.description,
+			content: data.content,
+			metadata: data.metadata ?? null
+		};
+		const scopes = {
+			tenantId: baseData.tenantId,
+			projectId: baseData.projectId
+		};
+		const existing = await tx.query.skills.findFirst({ where: and(projectScopedWhere(skills, scopes), eq(skills.id, baseData.id)) });
+		const files = data.files;
+		if (existing) {
+			const [result$1] = await tx.update(skills).set({
+				name: baseData.name,
+				description: baseData.description,
+				content: baseData.content,
+				metadata: baseData.metadata,
+				updatedAt: now
+			}).where(and(projectScopedWhere(skills, scopes), eq(skills.id, baseData.id))).returning();
+			await replaceSkillFiles(tx, {
+				scopes: {
+					tenantId: baseData.tenantId,
+					projectId: baseData.projectId
+				},
+				skillId: baseData.id,
+				files
+			});
+			logger.info({ skillId: baseData.id }, "Updated skill");
+			return result$1;
+		}
+		const insertData = {
+			...baseData,
+			createdAt: now,
 			updatedAt: now
-		}).where(and(projectScopedWhere(skills, scopes), eq(skills.id, baseData.id))).returning();
-		logger.info({ skillId: baseData.id }, "Updated skill");
-		return result$1;
-	}
-	const insertData = {
-		...baseData,
-		createdAt: now,
-		updatedAt: now
-	};
-	const [result] = await db.insert(skills).values(insertData).returning();
-	logger.info({ skillId: baseData.id }, "Created skill");
-	return result;
+		};
+		const [result] = await tx.insert(skills).values(insertData).returning();
+		await replaceSkillFiles(tx, {
+			scopes: {
+				tenantId: baseData.tenantId,
+				projectId: baseData.projectId
+			},
+			skillId: baseData.id,
+			files
+		});
+		logger.info({ skillId: baseData.id }, "Created skill");
+		return result;
+	});
 };
 const updateSkill = (db) => async (params) => {
-	const { tenantId: _, projectId: _2, ...data } = params.data;
-	const updateData = {
-		...data,
-		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-	const [result] = await db.update(skills).set(updateData).where(and(projectScopedWhere(skills, params.scopes), eq(skills.id, params.skillId))).returning();
-	return result ?? null;
+	return await db.transaction(async (tx) => {
+		if (!await tx.query.skills.findFirst({ where: and(eq(skills.tenantId, params.scopes.tenantId), eq(skills.projectId, params.scopes.projectId), eq(skills.id, params.skillId)) })) return null;
+		const { description, metadata, content } = params.data;
+		const updateData = { updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+		if (description !== void 0) updateData.description = description;
+		if (metadata !== void 0) updateData.metadata = metadata;
+		if (content !== void 0) updateData.content = content;
+		if (!params.data.files) throw new Error("Skill updates must include files");
+		const [result] = await tx.update(skills).set(updateData).where(and(projectScopedWhere(skills, params.scopes), eq(skills.id, params.skillId))).returning();
+		await replaceSkillFiles(tx, {
+			scopes: params.scopes,
+			skillId: params.skillId,
+			files: params.data.files
+		});
+		return result ? await getSkillByIdWithFiles(tx)({
+			scopes: params.scopes,
+			skillId: params.skillId
+		}) : null;
+	});
 };
 const deleteSkill = (db) => async (params) => {
 	return (await db.delete(skills).where(and(projectScopedWhere(skills, params.scopes), eq(skills.id, params.skillId))).returning()).length > 0;
@@ -123,4 +336,4 @@ const deleteSubAgentSkill = (db) => async (params) => {
 };
 
 //#endregion
-export { createSkill, deleteSkill, deleteSubAgentSkill, getSkillById, getSkillsForSubAgents, listSkills, updateSkill, upsertSkill, upsertSubAgentSkill };
+export { createSkill, createSkillFileById, deleteSkill, deleteSkillFileById, deleteSubAgentSkill, getSkillById, getSkillByIdWithFiles, getSkillFileById, getSkillFilesBySkillIds, getSkillsForSubAgents, listSkills, listSkillsWithFiles, updateSkill, updateSkillFileById, upsertSkill, upsertSubAgentSkill };

package/dist/data-access/manage/subAgentExternalAgentRelations.d.ts

@@ -12,11 +12,11 @@ declare const getSubAgentExternalAgentRelationById: (db: AgentsManageDatabaseCli
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 } | undefined>;
 declare const listSubAgentExternalAgentRelations: (db: AgentsManageDatabaseClient) => (params: {
@@ -47,11 +47,11 @@ declare const getSubAgentExternalAgentRelations: (db: AgentsManageDatabaseClient
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 }[]>;
 declare const getSubAgentExternalAgentRelationsByAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -60,11 +60,11 @@ declare const getSubAgentExternalAgentRelationsByAgent: (db: AgentsManageDatabas
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 }[]>;
 declare const getSubAgentExternalAgentRelationsByExternalAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -183,11 +183,11 @@ declare const createSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClie
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 }>;
 /**
@@ -200,11 +200,11 @@ declare const getSubAgentExternalAgentRelationByParams: (db: AgentsManageDatabas
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 } | undefined>;
 /**
@@ -221,11 +221,11 @@ declare const upsertSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClie
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   externalAgentId: string;
 }>;
 declare const updateSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClient) => (params: {

package/dist/data-access/manage/subAgentRelations.d.ts

@@ -12,8 +12,8 @@ declare const getAgentRelationById: (db: AgentsManageDatabaseClient) => (params:
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -47,8 +47,8 @@ declare const getAgentRelations: (db: AgentsManageDatabaseClient) => (params: {
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -60,8 +60,8 @@ declare const getAgentRelationsByAgent: (db: AgentsManageDatabaseClient) => (par
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -129,8 +129,8 @@ declare const createSubAgentRelation: (db: AgentsManageDatabaseClient) => (param
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -148,8 +148,8 @@ declare const getAgentRelationByParams: (db: AgentsManageDatabaseClient) => (par
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -162,8 +162,8 @@ declare const upsertSubAgentRelation: (db: AgentsManageDatabaseClient) => (param
   id: string;
   createdAt: string;
   updatedAt: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   sourceSubAgentId: string;
   targetSubAgentId: string | null;
@@ -207,16 +207,16 @@ declare const createAgentToolRelation: (db: AgentsManageDatabaseClient) => (para
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   toolId: string;
-  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
+  selectedTools: string[] | null;
 }>;
 declare const updateAgentToolRelation: (db: AgentsManageDatabaseClient) => (params: {
   scopes: AgentScopeConfig;
@@ -251,16 +251,16 @@ declare const getAgentToolRelationById: (db: AgentsManageDatabaseClient) => (par
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   toolId: string;
-  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
+  selectedTools: string[] | null;
 } | undefined>;
 declare const getAgentToolRelationByAgent: (db: AgentsManageDatabaseClient) => (params: {
   scopes: SubAgentScopeConfig;

package/dist/data-access/manage/subAgentTeamAgentRelations.d.ts

@@ -12,11 +12,11 @@ declare const getSubAgentTeamAgentRelationById: (db: AgentsManageDatabaseClient)
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 } | undefined>;
 declare const listSubAgentTeamAgentRelations: (db: AgentsManageDatabaseClient) => (params: {
@@ -47,11 +47,11 @@ declare const getSubAgentTeamAgentRelations: (db: AgentsManageDatabaseClient) =>
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 }[]>;
 declare const getSubAgentTeamAgentRelationsByAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -60,11 +60,11 @@ declare const getSubAgentTeamAgentRelationsByAgent: (db: AgentsManageDatabaseCli
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 }[]>;
 declare const getSubAgentTeamAgentRelationsByTeamAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -213,11 +213,11 @@ declare const createSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 }>;
 /**
@@ -230,11 +230,11 @@ declare const getSubAgentTeamAgentRelationByParams: (db: AgentsManageDatabaseCli
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 } | undefined>;
 /**
@@ -251,11 +251,11 @@ declare const upsertSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
   id: string;
   createdAt: string;
   updatedAt: string;
-  headers: Record<string, string> | null;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
   agentId: string;
   subAgentId: string;
+  headers: Record<string, string> | null;
   targetAgentId: string;
 }>;
 declare const updateSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient) => (params: {

package/dist/data-access/manage/subAgents.d.ts

@@ -11,9 +11,10 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  projectId: string;
   tenantId: string;
   models: {
     base?: {
@@ -32,7 +33,6 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  projectId: string;
   agentId: string;
   prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
@@ -42,9 +42,10 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  projectId: string;
   tenantId: string;
   models: {
     base?: {
@@ -63,7 +64,6 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  projectId: string;
   agentId: string;
   prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
@@ -111,9 +111,10 @@ declare const listSubAgentsPaginated: (db: AgentsManageDatabaseClient) => (param
 declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAgentInsert) => Promise<{
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  projectId: string;
   tenantId: string;
   models: {
     base?: {
@@ -132,7 +133,6 @@ declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAg
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  projectId: string;
   agentId: string;
   prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;