@inkeep/agents-core 0.0.0-dev-20260119170007 → 0.0.0-dev-20260120193424

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

@@ -0,0 +1,84 @@
+import { AgentScopeConfig, PaginationConfig } from "../../types/utility.js";
+import { AgentsManageDatabaseClient } from "../../db/manage/manage-client.js";
+import { TriggerInsert, TriggerSelect, TriggerUpdate } from "../../types/entities.js";
+
+//#region src/data-access/manage/triggers.d.ts
+
+/**
+ * Get a trigger by ID (agent-scoped)
+ * Uses withBranch to checkout the project's main branch and query using Drizzle ORM,
+ * which handles column name mapping automatically.
+ */
+declare const getTriggerById: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+  /** If true, uses withBranch to read from the project branch. Default: true for non-branch-scoped clients */
+  useBranchScope?: boolean;
+}) => Promise<TriggerSelect | undefined>;
+/**
+ * List all triggers for an agent
+ */
+declare const listTriggers: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+}) => Promise<TriggerSelect[]>;
+/**
+ * List triggers for an agent with pagination
+ */
+declare const listTriggersPaginated: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  pagination?: PaginationConfig;
+}) => Promise<{
+  data: {
+    createdAt: string;
+    updatedAt: string;
+    enabled: boolean;
+    inputSchema: Record<string, unknown> | null;
+    outputTransform: {
+      jmespath?: string;
+      objectTransformation?: Record<string, string>;
+    } | null;
+    messageTemplate: string;
+    authentication: unknown;
+    signingSecret: string | null;
+    name: string;
+    description: string | null;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+/**
+ * Create a new trigger (agent-scoped)
+ */
+declare const createTrigger: (db: AgentsManageDatabaseClient) => (params: TriggerInsert) => Promise<TriggerSelect>;
+/**
+ * Update a trigger (agent-scoped)
+ */
+declare const updateTrigger: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+  data: TriggerUpdate;
+}) => Promise<TriggerSelect>;
+/**
+ * Delete a trigger (agent-scoped)
+ */
+declare const deleteTrigger: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+}) => Promise<void>;
+/**
+ * Upsert a trigger (create or update based on existence)
+ */
+declare const upsertTrigger: (db: AgentsManageDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  data: TriggerInsert;
+}) => Promise<TriggerSelect>;
+//#endregion
+export { createTrigger, deleteTrigger, getTriggerById, listTriggers, listTriggersPaginated, updateTrigger, upsertTrigger };

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

@@ -0,0 +1,95 @@
+import { triggers } from "../../db/manage/manage-schema.js";
+import { getProjectBranchName, withBranch } from "../../dolt/branch.js";
+import { and, count, desc, eq } from "drizzle-orm";
+
+//#region src/data-access/manage/triggers.ts
+/**
+* Get a trigger by ID (agent-scoped)
+* Uses withBranch to checkout the project's main branch and query using Drizzle ORM,
+* which handles column name mapping automatically.
+*/
+const getTriggerById = (db) => async (params) => {
+	const { scopes, triggerId, useBranchScope = true } = params;
+	if (useBranchScope) {
+		const branchName = getProjectBranchName(scopes.tenantId, scopes.projectId);
+		try {
+			return await withBranch(db)({
+				branchName,
+				callback: async (txDb) => {
+					return await txDb.query.triggers.findFirst({ where: and(eq(triggers.tenantId, scopes.tenantId), eq(triggers.projectId, scopes.projectId), eq(triggers.agentId, scopes.agentId), eq(triggers.id, triggerId)) });
+				}
+			});
+		} catch {}
+	}
+	return await db.query.triggers.findFirst({ where: and(eq(triggers.tenantId, scopes.tenantId), eq(triggers.projectId, scopes.projectId), eq(triggers.agentId, scopes.agentId), eq(triggers.id, triggerId)) });
+};
+/**
+* List all triggers for an agent
+*/
+const listTriggers = (db) => async (params) => {
+	return await db.query.triggers.findMany({ where: and(eq(triggers.tenantId, params.scopes.tenantId), eq(triggers.projectId, params.scopes.projectId), eq(triggers.agentId, params.scopes.agentId)) });
+};
+/**
+* List triggers for an agent with pagination
+*/
+const listTriggersPaginated = (db) => async (params) => {
+	const page = params.pagination?.page || 1;
+	const limit = Math.min(params.pagination?.limit || 10, 100);
+	const offset = (page - 1) * limit;
+	const whereClause = and(eq(triggers.tenantId, params.scopes.tenantId), eq(triggers.projectId, params.scopes.projectId), eq(triggers.agentId, params.scopes.agentId));
+	const [data, totalResult] = await Promise.all([db.select().from(triggers).where(whereClause).limit(limit).offset(offset).orderBy(desc(triggers.createdAt)), db.select({ count: count() }).from(triggers).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+/**
+* Create a new trigger (agent-scoped)
+*/
+const createTrigger = (db) => async (params) => {
+	return (await db.insert(triggers).values(params).returning())[0];
+};
+/**
+* Update a trigger (agent-scoped)
+*/
+const updateTrigger = (db) => async (params) => {
+	const updateData = {
+		...params.data,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	return (await db.update(triggers).set(updateData).where(and(eq(triggers.tenantId, params.scopes.tenantId), eq(triggers.projectId, params.scopes.projectId), eq(triggers.agentId, params.scopes.agentId), eq(triggers.id, params.triggerId))).returning())[0];
+};
+/**
+* Delete a trigger (agent-scoped)
+*/
+const deleteTrigger = (db) => async (params) => {
+	await db.delete(triggers).where(and(eq(triggers.tenantId, params.scopes.tenantId), eq(triggers.projectId, params.scopes.projectId), eq(triggers.agentId, params.scopes.agentId), eq(triggers.id, params.triggerId)));
+};
+/**
+* Upsert a trigger (create or update based on existence)
+*/
+const upsertTrigger = (db) => async (params) => {
+	const { scopes, data } = params;
+	if (await db.query.triggers.findFirst({ where: and(eq(triggers.tenantId, scopes.tenantId), eq(triggers.projectId, scopes.projectId), eq(triggers.agentId, scopes.agentId), eq(triggers.id, data.id)) })) {
+		const updateData = {
+			...data,
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		return (await db.update(triggers).set(updateData).where(and(eq(triggers.tenantId, scopes.tenantId), eq(triggers.projectId, scopes.projectId), eq(triggers.agentId, scopes.agentId), eq(triggers.id, data.id))).returning())[0];
+	}
+	return (await db.insert(triggers).values({
+		...data,
+		tenantId: scopes.tenantId,
+		projectId: scopes.projectId,
+		agentId: scopes.agentId
+	}).returning())[0];
+};
+
+//#endregion
+export { createTrigger, deleteTrigger, getTriggerById, listTriggers, listTriggersPaginated, updateTrigger, upsertTrigger };

package/dist/data-access/runtime/evalRuns.d.ts

@@ -1,4 +1,4 @@
-import { EvaluationJobFilterCriteria, ProjectScopeConfig } from "../../types/utility.js";
+import { EvaluationJobFilterCriteria, Filter, ProjectScopeConfig } from "../../types/utility.js";
 import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
 import { ConversationSelect, DatasetRunConversationRelationInsert, DatasetRunConversationRelationSelect, DatasetRunInsert, DatasetRunSelect, EvaluationResultInsert, EvaluationResultSelect, EvaluationResultUpdate, EvaluationRunInsert, EvaluationRunSelect, EvaluationRunUpdate } from "../../types/entities.js";
 
@@ -114,7 +114,7 @@ declare const deleteEvaluationResultsByRun: (db: AgentsRunDatabaseClient) => (pa
  */
 declare const filterConversationsForJob: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
-  jobFilters: EvaluationJobFilterCriteria | null | undefined;
+  jobFilters: Filter<EvaluationJobFilterCriteria> | null | undefined;
 }) => Promise<ConversationSelect[]>;
 //#endregion
 export { createDatasetRun, createDatasetRunConversationRelation, createDatasetRunConversationRelations, createEvaluationResult, createEvaluationResults, createEvaluationRun, deleteDatasetRun, deleteDatasetRunConversationRelation, deleteDatasetRunConversationRelationsByRun, deleteEvaluationResult, deleteEvaluationResultsByRun, deleteEvaluationRun, filterConversationsForJob, getDatasetRunById, getDatasetRunConversationRelationByConversation, getDatasetRunConversationRelations, getEvaluationResultById, getEvaluationRunById, getEvaluationRunByJobConfigId, listDatasetRuns, listDatasetRunsByConfig, listEvaluationResults, listEvaluationResultsByConversation, listEvaluationResultsByRun, listEvaluationRuns, listEvaluationRunsByJobConfigId, updateEvaluationResult, updateEvaluationRun };

package/dist/data-access/runtime/evalRuns.js

@@ -126,10 +126,20 @@ const deleteEvaluationResultsByRun = (db) => async (params) => {
 	return (await db.delete(evaluationResult).where(and(eq(evaluationResult.tenantId, params.scopes.tenantId), eq(evaluationResult.projectId, params.scopes.projectId), eq(evaluationResult.evaluationRunId, params.scopes.evaluationRunId))).returning()).length;
 };
 /**
+* Helper to extract plain filter criteria from a Filter wrapper.
+* Currently only handles plain objects - and/or combinators are not yet supported.
+*/
+function extractPlainFilterCriteria(filter) {
+	if (!filter) return null;
+	if ("and" in filter || "or" in filter) return null;
+	return filter;
+}
+/**
 * Filter conversations based on evaluation job filter criteria
 */
 const filterConversationsForJob = (db) => async (params) => {
-	const { scopes, jobFilters } = params;
+	const { scopes, jobFilters: rawJobFilters } = params;
+	const jobFilters = extractPlainFilterCriteria(rawJobFilters);
 	const { tenantId, projectId } = scopes;
 	const whereConditions = [eq(conversations.tenantId, tenantId), eq(conversations.projectId, projectId)];
 	if (jobFilters?.conversationIds && Array.isArray(jobFilters.conversationIds) && jobFilters.conversationIds.length > 0) whereConditions.push(inArray(conversations.id, jobFilters.conversationIds));

package/dist/data-access/runtime/messages.d.ts

@@ -17,18 +17,18 @@ declare const getMessageById: (db: AgentsRunDatabaseClient) => (params: {
   metadata: MessageMetadata | null;
   content: MessageContent;
   role: string;
+  conversationId: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;
   toExternalAgentId: string | null;
-  taskId: string | null;
-  a2aTaskId: string | null;
-  conversationId: string;
   fromTeamAgentId: string | null;
   toTeamAgentId: string | null;
   visibility: string;
   messageType: string;
+  taskId: string | null;
   parentMessageId: string | null;
+  a2aTaskId: string | null;
   a2aSessionId: string | null;
 } | undefined>;
 declare const listMessages: (db: AgentsRunDatabaseClient) => (params: {
@@ -148,18 +148,18 @@ declare const createMessage: (db: AgentsRunDatabaseClient) => (params: MessageIn
   metadata: MessageMetadata | null;
   content: MessageContent;
   role: string;
+  conversationId: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;
   toExternalAgentId: string | null;
-  taskId: string | null;
-  a2aTaskId: string | null;
-  conversationId: string;
   fromTeamAgentId: string | null;
   toTeamAgentId: string | null;
   visibility: string;
   messageType: string;
+  taskId: string | null;
   parentMessageId: string | null;
+  a2aTaskId: string | null;
   a2aSessionId: string | null;
 }>;
 declare const updateMessage: (db: AgentsRunDatabaseClient) => (params: {
@@ -201,18 +201,18 @@ declare const deleteMessage: (db: AgentsRunDatabaseClient) => (params: {
   metadata: MessageMetadata | null;
   content: MessageContent;
   role: string;
+  conversationId: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;
   toExternalAgentId: string | null;
-  taskId: string | null;
-  a2aTaskId: string | null;
-  conversationId: string;
   fromTeamAgentId: string | null;
   toTeamAgentId: string | null;
   visibility: string;
   messageType: string;
+  taskId: string | null;
   parentMessageId: string | null;
+  a2aTaskId: string | null;
   a2aSessionId: string | null;
 }>;
 declare const countMessagesByConversation: (db: AgentsRunDatabaseClient) => (params: {

package/dist/data-access/runtime/tasks.d.ts

@@ -13,12 +13,12 @@ declare const createTask: (db: AgentsRunDatabaseClient) => (params: TaskInsert)
   createdAt: string;
   updatedAt: string;
   metadata: TaskMetadataConfig | null;
-  status: string;
   ref: {
     type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
+  status: string;
   subAgentId: string;
   contextId: string;
 }>;
@@ -42,8 +42,8 @@ declare const updateTask: (db: AgentsRunDatabaseClient) => (params: {
   } | null;
   status: string;
   metadata: TaskMetadataConfig | null;
-  agentId: string;
   subAgentId: string;
+  agentId: string;
   projectId: string;
   tenantId: string;
   id: string;

package/dist/data-access/runtime/triggerInvocations.d.ts

@@ -0,0 +1,62 @@
+import { AgentScopeConfig, PaginationConfig } from "../../types/utility.js";
+import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
+import { TriggerInvocationInsert, TriggerInvocationSelect, TriggerInvocationUpdate } from "../../types/entities.js";
+
+//#region src/data-access/runtime/triggerInvocations.d.ts
+
+/**
+ * Get a trigger invocation by ID (agent-scoped)
+ */
+declare const getTriggerInvocationById: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+  invocationId: string;
+}) => Promise<TriggerInvocationSelect | undefined>;
+/**
+ * List trigger invocations with optional filtering (agent-scoped)
+ */
+declare const listTriggerInvocationsPaginated: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+  pagination?: PaginationConfig;
+  filters?: {
+    status?: "pending" | "success" | "failed";
+    from?: string;
+    to?: string;
+  };
+}) => Promise<{
+  data: {
+    triggerId: string;
+    conversationId: string | null;
+    status: string;
+    requestPayload: unknown;
+    transformedPayload: unknown;
+    errorMessage: string | null;
+    createdAt: string;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+/**
+ * Create a new trigger invocation (agent-scoped)
+ */
+declare const createTriggerInvocation: (db: AgentsRunDatabaseClient) => (params: TriggerInvocationInsert) => Promise<TriggerInvocationSelect>;
+/**
+ * Update trigger invocation status (agent-scoped)
+ */
+declare const updateTriggerInvocationStatus: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  triggerId: string;
+  invocationId: string;
+  data: TriggerInvocationUpdate;
+}) => Promise<TriggerInvocationSelect>;
+//#endregion
+export { createTriggerInvocation, getTriggerInvocationById, listTriggerInvocationsPaginated, updateTriggerInvocationStatus };

package/dist/data-access/runtime/triggerInvocations.js

@@ -0,0 +1,54 @@
+import { triggerInvocations } from "../../db/runtime/runtime-schema.js";
+import { and, count, desc, eq, gte, lte } from "drizzle-orm";
+
+//#region src/data-access/runtime/triggerInvocations.ts
+/**
+* Get a trigger invocation by ID (agent-scoped)
+*/
+const getTriggerInvocationById = (db) => async (params) => {
+	return await db.query.triggerInvocations.findFirst({ where: and(eq(triggerInvocations.tenantId, params.scopes.tenantId), eq(triggerInvocations.projectId, params.scopes.projectId), eq(triggerInvocations.agentId, params.scopes.agentId), eq(triggerInvocations.triggerId, params.triggerId), eq(triggerInvocations.id, params.invocationId)) });
+};
+/**
+* List trigger invocations with optional filtering (agent-scoped)
+*/
+const listTriggerInvocationsPaginated = (db) => async (params) => {
+	const page = params.pagination?.page || 1;
+	const limit = Math.min(params.pagination?.limit || 10, 100);
+	const offset = (page - 1) * limit;
+	const conditions = [
+		eq(triggerInvocations.tenantId, params.scopes.tenantId),
+		eq(triggerInvocations.projectId, params.scopes.projectId),
+		eq(triggerInvocations.agentId, params.scopes.agentId),
+		eq(triggerInvocations.triggerId, params.triggerId)
+	];
+	if (params.filters?.status) conditions.push(eq(triggerInvocations.status, params.filters.status));
+	if (params.filters?.from) conditions.push(gte(triggerInvocations.createdAt, params.filters.from));
+	if (params.filters?.to) conditions.push(lte(triggerInvocations.createdAt, params.filters.to));
+	const whereClause = and(...conditions);
+	const [data, totalResult] = await Promise.all([db.select().from(triggerInvocations).where(whereClause).limit(limit).offset(offset).orderBy(desc(triggerInvocations.createdAt)), db.select({ count: count() }).from(triggerInvocations).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+/**
+* Create a new trigger invocation (agent-scoped)
+*/
+const createTriggerInvocation = (db) => async (params) => {
+	return (await db.insert(triggerInvocations).values(params).returning())[0];
+};
+/**
+* Update trigger invocation status (agent-scoped)
+*/
+const updateTriggerInvocationStatus = (db) => async (params) => {
+	return (await db.update(triggerInvocations).set(params.data).where(and(eq(triggerInvocations.tenantId, params.scopes.tenantId), eq(triggerInvocations.projectId, params.scopes.projectId), eq(triggerInvocations.agentId, params.scopes.agentId), eq(triggerInvocations.triggerId, params.triggerId), eq(triggerInvocations.id, params.invocationId))).returning())[0];
+};
+
+//#endregion
+export { createTriggerInvocation, getTriggerInvocationById, listTriggerInvocationsPaginated, updateTriggerInvocationStatus };