@inkeep/agents-core 0.47.4 → 0.48.0

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

@@ -0,0 +1,233 @@
+import { AgentScopeConfig, PaginationConfig } from "../../types/utility.js";
+import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
+import { ScheduledTriggerInvocation, ScheduledTriggerInvocationInsert, ScheduledTriggerInvocationStatus, ScheduledTriggerInvocationUpdate } from "../../validation/schemas.js";
+
+//#region src/data-access/runtime/scheduledTriggerInvocations.d.ts
+
+/**
+ * Get a scheduled trigger invocation by ID (agent-scoped)
+ */
+declare const getScheduledTriggerInvocationById: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+}) => Promise<ScheduledTriggerInvocation | undefined>;
+/**
+ * Get a scheduled trigger invocation by idempotency key
+ * Used to check if an invocation already exists for a given schedule
+ */
+declare const getScheduledTriggerInvocationByIdempotencyKey: (db: AgentsRunDatabaseClient) => (params: {
+  idempotencyKey: string;
+}) => Promise<ScheduledTriggerInvocation | undefined>;
+/**
+ * List scheduled trigger invocations with optional filtering (agent-scoped)
+ */
+declare const listScheduledTriggerInvocationsPaginated: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  pagination?: PaginationConfig;
+  filters?: {
+    status?: ScheduledTriggerInvocationStatus;
+    from?: string;
+    to?: string;
+  };
+}) => Promise<{
+  data: {
+    scheduledTriggerId: string;
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    scheduledFor: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    resolvedPayload: Record<string, unknown> | null;
+    conversationIds: string[] | null;
+    attemptNumber: number;
+    idempotencyKey: string;
+    createdAt: string;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+/**
+ * List pending invocations for a trigger, ordered by scheduledFor (earliest first)
+ * Used by workflow to get the next invocation to execute
+ */
+declare const listPendingScheduledTriggerInvocations: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  limit?: number;
+}) => Promise<ScheduledTriggerInvocation[]>;
+/**
+ * Delete all pending invocations for a trigger
+ * Used when cron expression changes or trigger is disabled
+ */
+declare const deletePendingInvocationsForTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+}) => Promise<number>;
+/**
+ * Create a new scheduled trigger invocation (agent-scoped)
+ */
+declare const createScheduledTriggerInvocation: (db: AgentsRunDatabaseClient) => (params: ScheduledTriggerInvocationInsert) => Promise<ScheduledTriggerInvocation>;
+/**
+ * Update scheduled trigger invocation status (agent-scoped)
+ */
+declare const updateScheduledTriggerInvocationStatus: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+  data: ScheduledTriggerInvocationUpdate;
+}) => Promise<ScheduledTriggerInvocation>;
+/**
+ * Mark invocation as running
+ */
+declare const markScheduledTriggerInvocationRunning: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+}) => Promise<ScheduledTriggerInvocation>;
+/**
+ * Mark invocation as completed
+ * Note: Will not update if status is already 'cancelled' to respect user cancellation
+ */
+declare const markScheduledTriggerInvocationCompleted: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+}) => Promise<ScheduledTriggerInvocation | undefined>;
+/**
+ * Mark invocation as failed
+ * Note: Will not update if status is already 'cancelled' to respect user cancellation
+ */
+declare const markScheduledTriggerInvocationFailed: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+}) => Promise<ScheduledTriggerInvocation | undefined>;
+/**
+ * Add a conversation ID to the invocation's conversationIds array
+ * Used to track all conversations created during retries
+ */
+declare const addConversationIdToInvocation: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+  conversationId: string;
+}) => Promise<ScheduledTriggerInvocation | undefined>;
+/**
+ * Mark invocation as cancelled
+ */
+declare const markScheduledTriggerInvocationCancelled: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  invocationId: string;
+}) => Promise<ScheduledTriggerInvocation>;
+/**
+ * Cancel all pending invocations for a trigger
+ * Used when a trigger is deleted
+ */
+declare const cancelPendingInvocationsForTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+}) => Promise<number>;
+/**
+ * Cancel only PAST pending invocations for a trigger (scheduledFor <= now)
+ * Used when a trigger is disabled - keeps future invocations pending
+ */
+declare const cancelPastPendingInvocationsForTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+}) => Promise<number>;
+/**
+ * Get run info for multiple scheduled triggers in a single query
+ * Returns last run (completed/failed) and next pending run for each trigger
+ */
+declare const getScheduledTriggerRunInfoBatch: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: Omit<AgentScopeConfig, "agentId">;
+  triggerIds: Array<{
+    agentId: string;
+    triggerId: string;
+  }>;
+}) => Promise<Map<string, {
+  lastRunAt: string | null;
+  lastRunStatus: "completed" | "failed" | null;
+  lastRunConversationIds: string[];
+  nextRunAt: string | null;
+}>>;
+/**
+ * List upcoming invocations across ALL triggers for an agent with pagination
+ * Used for the upcoming runs dashboard with full pagination support
+ */
+declare const listUpcomingInvocationsForAgentPaginated: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: Omit<AgentScopeConfig, "agentId"> & {
+    agentId: string;
+  };
+  pagination?: PaginationConfig;
+  includeRunning?: boolean;
+}) => Promise<{
+  data: {
+    scheduledTriggerId: string;
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    scheduledFor: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    resolvedPayload: Record<string, unknown> | null;
+    conversationIds: string[] | null;
+    attemptNumber: number;
+    idempotencyKey: string;
+    createdAt: string;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+/**
+ * List all invocations across ALL triggers for a PROJECT with pagination
+ * Used for the project-level invocations dashboard
+ */
+declare const listProjectScheduledTriggerInvocationsPaginated: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: Omit<AgentScopeConfig, "agentId">;
+  pagination?: PaginationConfig;
+  filters?: {
+    status?: ScheduledTriggerInvocationStatus;
+  };
+}) => Promise<{
+  data: {
+    scheduledTriggerId: string;
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    scheduledFor: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    resolvedPayload: Record<string, unknown> | null;
+    conversationIds: string[] | null;
+    attemptNumber: number;
+    idempotencyKey: string;
+    createdAt: string;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+//#endregion
+export { addConversationIdToInvocation, cancelPastPendingInvocationsForTrigger, cancelPendingInvocationsForTrigger, createScheduledTriggerInvocation, deletePendingInvocationsForTrigger, getScheduledTriggerInvocationById, getScheduledTriggerInvocationByIdempotencyKey, getScheduledTriggerRunInfoBatch, listPendingScheduledTriggerInvocations, listProjectScheduledTriggerInvocationsPaginated, listScheduledTriggerInvocationsPaginated, listUpcomingInvocationsForAgentPaginated, markScheduledTriggerInvocationCancelled, markScheduledTriggerInvocationCompleted, markScheduledTriggerInvocationFailed, markScheduledTriggerInvocationRunning, updateScheduledTriggerInvocationStatus };

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

@@ -0,0 +1,226 @@
+import { scheduledTriggerInvocations } from "../../db/runtime/runtime-schema.js";
+import { and, asc, count, desc, eq, gte, inArray, lte, ne, sql } from "drizzle-orm";
+
+//#region src/data-access/runtime/scheduledTriggerInvocations.ts
+/**
+* Get a scheduled trigger invocation by ID (agent-scoped)
+*/
+const getScheduledTriggerInvocationById = (db) => async (params) => {
+	return await db.query.scheduledTriggerInvocations.findFirst({ where: and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId)) });
+};
+/**
+* Get a scheduled trigger invocation by idempotency key
+* Used to check if an invocation already exists for a given schedule
+*/
+const getScheduledTriggerInvocationByIdempotencyKey = (db) => async (params) => {
+	return await db.query.scheduledTriggerInvocations.findFirst({ where: eq(scheduledTriggerInvocations.idempotencyKey, params.idempotencyKey) });
+};
+/**
+* List scheduled trigger invocations with optional filtering (agent-scoped)
+*/
+const listScheduledTriggerInvocationsPaginated = (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(scheduledTriggerInvocations.tenantId, params.scopes.tenantId),
+		eq(scheduledTriggerInvocations.projectId, params.scopes.projectId),
+		eq(scheduledTriggerInvocations.agentId, params.scopes.agentId),
+		eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId)
+	];
+	if (params.filters?.status) conditions.push(eq(scheduledTriggerInvocations.status, params.filters.status));
+	if (params.filters?.from) conditions.push(gte(scheduledTriggerInvocations.scheduledFor, params.filters.from));
+	if (params.filters?.to) conditions.push(lte(scheduledTriggerInvocations.scheduledFor, params.filters.to));
+	const whereClause = and(...conditions);
+	const [data, totalResult] = await Promise.all([db.select().from(scheduledTriggerInvocations).where(whereClause).limit(limit).offset(offset).orderBy(desc(scheduledTriggerInvocations.scheduledFor)), db.select({ count: count() }).from(scheduledTriggerInvocations).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+/**
+* List pending invocations for a trigger, ordered by scheduledFor (earliest first)
+* Used by workflow to get the next invocation to execute
+*/
+const listPendingScheduledTriggerInvocations = (db) => async (params) => {
+	const maxLimit = Math.min(params.limit || 10, 100);
+	return await db.select().from(scheduledTriggerInvocations).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.status, "pending"))).orderBy(asc(scheduledTriggerInvocations.scheduledFor)).limit(maxLimit);
+};
+/**
+* Delete all pending invocations for a trigger
+* Used when cron expression changes or trigger is disabled
+*/
+const deletePendingInvocationsForTrigger = (db) => async (params) => {
+	return (await db.delete(scheduledTriggerInvocations).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.status, "pending"))).returning()).length;
+};
+/**
+* Create a new scheduled trigger invocation (agent-scoped)
+*/
+const createScheduledTriggerInvocation = (db) => async (params) => {
+	return (await db.insert(scheduledTriggerInvocations).values(params).returning())[0];
+};
+/**
+* Update scheduled trigger invocation status (agent-scoped)
+*/
+const updateScheduledTriggerInvocationStatus = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set(params.data).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId))).returning())[0];
+};
+/**
+* Mark invocation as running
+*/
+const markScheduledTriggerInvocationRunning = (db) => async (params) => {
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "running",
+		startedAt: sql`COALESCE(${scheduledTriggerInvocations.startedAt}, ${now})`
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId))).returning())[0];
+};
+/**
+* Mark invocation as completed
+* Note: Will not update if status is already 'cancelled' to respect user cancellation
+*/
+const markScheduledTriggerInvocationCompleted = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "completed",
+		completedAt: (/* @__PURE__ */ new Date()).toISOString()
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId), ne(scheduledTriggerInvocations.status, "cancelled"))).returning())[0];
+};
+/**
+* Mark invocation as failed
+* Note: Will not update if status is already 'cancelled' to respect user cancellation
+*/
+const markScheduledTriggerInvocationFailed = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "failed",
+		completedAt: (/* @__PURE__ */ new Date()).toISOString()
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId), ne(scheduledTriggerInvocations.status, "cancelled"))).returning())[0];
+};
+/**
+* Add a conversation ID to the invocation's conversationIds array
+* Used to track all conversations created during retries
+*/
+const addConversationIdToInvocation = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set({ conversationIds: sql`${scheduledTriggerInvocations.conversationIds} || ${JSON.stringify([params.conversationId])}::jsonb` }).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId))).returning())[0];
+};
+/**
+* Mark invocation as cancelled
+*/
+const markScheduledTriggerInvocationCancelled = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "cancelled",
+		completedAt: (/* @__PURE__ */ new Date()).toISOString()
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), eq(scheduledTriggerInvocations.id, params.invocationId))).returning())[0];
+};
+/**
+* Cancel all pending invocations for a trigger
+* Used when a trigger is deleted
+*/
+const cancelPendingInvocationsForTrigger = (db) => async (params) => {
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "cancelled",
+		completedAt: (/* @__PURE__ */ new Date()).toISOString()
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), inArray(scheduledTriggerInvocations.status, ["pending", "running"]))).returning()).length;
+};
+/**
+* Cancel only PAST pending invocations for a trigger (scheduledFor <= now)
+* Used when a trigger is disabled - keeps future invocations pending
+*/
+const cancelPastPendingInvocationsForTrigger = (db) => async (params) => {
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	return (await db.update(scheduledTriggerInvocations).set({
+		status: "cancelled",
+		completedAt: now
+	}).where(and(eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId), eq(scheduledTriggerInvocations.agentId, params.scopes.agentId), eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId), inArray(scheduledTriggerInvocations.status, ["pending", "running"]), lte(scheduledTriggerInvocations.scheduledFor, now))).returning()).length;
+};
+/**
+* Get run info for multiple scheduled triggers in a single query
+* Returns last run (completed/failed) and next pending run for each trigger
+*/
+const getScheduledTriggerRunInfoBatch = (db) => async (params) => {
+	if (params.triggerIds.length === 0) return /* @__PURE__ */ new Map();
+	const { tenantId, projectId } = params.scopes;
+	const allInvocations = await db.select({
+		scheduledTriggerId: scheduledTriggerInvocations.scheduledTriggerId,
+		status: scheduledTriggerInvocations.status,
+		scheduledFor: scheduledTriggerInvocations.scheduledFor,
+		completedAt: scheduledTriggerInvocations.completedAt,
+		conversationIds: scheduledTriggerInvocations.conversationIds
+	}).from(scheduledTriggerInvocations).where(and(eq(scheduledTriggerInvocations.tenantId, tenantId), eq(scheduledTriggerInvocations.projectId, projectId), inArray(scheduledTriggerInvocations.scheduledTriggerId, params.triggerIds.map((t) => t.triggerId)))).orderBy(desc(scheduledTriggerInvocations.completedAt));
+	const result = /* @__PURE__ */ new Map();
+	for (const trigger of params.triggerIds) result.set(trigger.triggerId, {
+		lastRunAt: null,
+		lastRunStatus: null,
+		lastRunConversationIds: [],
+		nextRunAt: null
+	});
+	for (const inv of allInvocations) {
+		const triggerInfo = result.get(inv.scheduledTriggerId);
+		if (!triggerInfo) continue;
+		if (inv.status === "pending" && !triggerInfo.nextRunAt) triggerInfo.nextRunAt = inv.scheduledFor;
+		if ((inv.status === "completed" || inv.status === "failed") && !triggerInfo.lastRunAt) {
+			triggerInfo.lastRunAt = inv.completedAt;
+			triggerInfo.lastRunStatus = inv.status;
+			triggerInfo.lastRunConversationIds = inv.conversationIds || [];
+		}
+	}
+	return result;
+};
+/**
+* List upcoming invocations across ALL triggers for an agent with pagination
+* Used for the upcoming runs dashboard with full pagination support
+*/
+const listUpcomingInvocationsForAgentPaginated = (db) => async (params) => {
+	const page = params.pagination?.page || 1;
+	const limit = Math.min(params.pagination?.limit || 20, 100);
+	const offset = (page - 1) * limit;
+	const statusCondition = params.includeRunning ? inArray(scheduledTriggerInvocations.status, ["pending", "running"]) : eq(scheduledTriggerInvocations.status, "pending");
+	const whereClause = and(...[
+		eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId),
+		eq(scheduledTriggerInvocations.projectId, params.scopes.projectId),
+		eq(scheduledTriggerInvocations.agentId, params.scopes.agentId),
+		statusCondition
+	]);
+	const [data, totalResult] = await Promise.all([db.select().from(scheduledTriggerInvocations).where(whereClause).limit(limit).offset(offset).orderBy(asc(scheduledTriggerInvocations.scheduledFor)), db.select({ count: count() }).from(scheduledTriggerInvocations).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+/**
+* List all invocations across ALL triggers for a PROJECT with pagination
+* Used for the project-level invocations dashboard
+*/
+const listProjectScheduledTriggerInvocationsPaginated = (db) => async (params) => {
+	const page = params.pagination?.page || 1;
+	const limit = Math.min(params.pagination?.limit || 20, 100);
+	const offset = (page - 1) * limit;
+	const conditions = [eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId)];
+	if (params.filters?.status) conditions.push(eq(scheduledTriggerInvocations.status, params.filters.status));
+	const whereClause = and(...conditions);
+	const [data, totalResult] = await Promise.all([db.select().from(scheduledTriggerInvocations).where(whereClause).limit(limit).offset(offset).orderBy(desc(scheduledTriggerInvocations.createdAt)), db.select({ count: count() }).from(scheduledTriggerInvocations).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+
+//#endregion
+export { addConversationIdToInvocation, cancelPastPendingInvocationsForTrigger, cancelPendingInvocationsForTrigger, createScheduledTriggerInvocation, deletePendingInvocationsForTrigger, getScheduledTriggerInvocationById, getScheduledTriggerInvocationByIdempotencyKey, getScheduledTriggerRunInfoBatch, listPendingScheduledTriggerInvocations, listProjectScheduledTriggerInvocationsPaginated, listScheduledTriggerInvocationsPaginated, listUpcomingInvocationsForAgentPaginated, markScheduledTriggerInvocationCancelled, markScheduledTriggerInvocationCompleted, markScheduledTriggerInvocationFailed, markScheduledTriggerInvocationRunning, updateScheduledTriggerInvocationStatus };

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

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

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

@@ -0,0 +1,55 @@
+import { workAppSlackChannelAgentConfigs, workAppSlackUserMappings, workAppSlackWorkspaces } from "../../db/runtime/runtime-schema.js";
+import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
+
+//#region src/data-access/runtime/workAppSlack.d.ts
+type WorkAppSlackWorkspaceInsert = typeof workAppSlackWorkspaces.$inferInsert;
+type WorkAppSlackWorkspaceSelect = typeof workAppSlackWorkspaces.$inferSelect;
+type WorkAppSlackUserMappingInsert = typeof workAppSlackUserMappings.$inferInsert;
+type WorkAppSlackUserMappingSelect = typeof workAppSlackUserMappings.$inferSelect;
+type WorkAppSlackChannelAgentConfigInsert = typeof workAppSlackChannelAgentConfigs.$inferInsert;
+type WorkAppSlackChannelAgentConfigSelect = typeof workAppSlackChannelAgentConfigs.$inferSelect;
+declare const createWorkAppSlackWorkspace: (db: AgentsRunDatabaseClient) => (data: Omit<WorkAppSlackWorkspaceInsert, "id" | "createdAt" | "updatedAt">) => Promise<WorkAppSlackWorkspaceSelect>;
+declare const findWorkAppSlackWorkspaceByTeamId: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string) => Promise<WorkAppSlackWorkspaceSelect | null>;
+/**
+ * Find a workspace by Slack team ID only (without tenant filter).
+ * Slack team IDs are globally unique, so this is safe for resolving
+ * the tenant from an incoming Slack event where tenant is unknown.
+ */
+declare const findWorkAppSlackWorkspaceBySlackTeamId: (db: AgentsRunDatabaseClient) => (slackTeamId: string) => Promise<WorkAppSlackWorkspaceSelect | null>;
+/**
+ * Find a workspace by its Nango connection ID.
+ *
+ * One Nango connection = one OAuth token = one Slack workspace.
+ * The nangoConnectionId should be globally unique (not per-tenant).
+ * The schema has a unique constraint on nangoConnectionId ensuring this.
+ */
+declare const findWorkAppSlackWorkspaceByNangoConnectionId: (db: AgentsRunDatabaseClient) => (nangoConnectionId: string) => Promise<WorkAppSlackWorkspaceSelect | null>;
+declare const listWorkAppSlackWorkspacesByTenant: (db: AgentsRunDatabaseClient) => (tenantId: string) => Promise<WorkAppSlackWorkspaceSelect[]>;
+declare const updateWorkAppSlackWorkspace: (db: AgentsRunDatabaseClient) => (id: string, data: Partial<Pick<WorkAppSlackWorkspaceInsert, "status" | "slackTeamName">>) => Promise<WorkAppSlackWorkspaceSelect | null>;
+declare const deleteWorkAppSlackWorkspace: (db: AgentsRunDatabaseClient) => (id: string) => Promise<boolean>;
+declare const deleteWorkAppSlackWorkspaceByNangoConnectionId: (db: AgentsRunDatabaseClient) => (nangoConnectionId: string) => Promise<boolean>;
+declare const findWorkAppSlackUserMapping: (db: AgentsRunDatabaseClient) => (tenantId: string, slackUserId: string, slackTeamId: string, clientId?: string) => Promise<WorkAppSlackUserMappingSelect | null>;
+declare const findWorkAppSlackUserMappingByInkeepUserId: (db: AgentsRunDatabaseClient) => (inkeepUserId: string) => Promise<WorkAppSlackUserMappingSelect[]>;
+/**
+ * Find a user mapping by Slack user ID and team ID only (ignores tenant).
+ * Use this when you need to find the user's tenant from their mapping.
+ */
+declare const findWorkAppSlackUserMappingBySlackUser: (db: AgentsRunDatabaseClient) => (slackUserId: string, slackTeamId: string, clientId?: string) => Promise<WorkAppSlackUserMappingSelect | null>;
+declare const listWorkAppSlackUserMappingsByTeam: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string) => Promise<WorkAppSlackUserMappingSelect[]>;
+declare const createWorkAppSlackUserMapping: (db: AgentsRunDatabaseClient) => (data: Omit<WorkAppSlackUserMappingInsert, "id" | "clientId" | "createdAt" | "updatedAt"> & {
+  clientId?: string;
+}) => Promise<WorkAppSlackUserMappingSelect>;
+declare const deleteWorkAppSlackUserMapping: (db: AgentsRunDatabaseClient) => (tenantId: string, slackUserId: string, slackTeamId: string, clientId?: string) => Promise<boolean>;
+declare const deleteAllWorkAppSlackUserMappingsByTeam: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string, clientId?: string) => Promise<number>;
+declare const createWorkAppSlackChannelAgentConfig: (db: AgentsRunDatabaseClient) => (data: Omit<WorkAppSlackChannelAgentConfigInsert, "id" | "createdAt" | "updatedAt">) => Promise<WorkAppSlackChannelAgentConfigSelect>;
+declare const findWorkAppSlackChannelAgentConfig: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string, slackChannelId: string) => Promise<WorkAppSlackChannelAgentConfigSelect | null>;
+declare const listWorkAppSlackChannelAgentConfigsByTeam: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string) => Promise<WorkAppSlackChannelAgentConfigSelect[]>;
+/**
+ * Atomic upsert using onConflictDoUpdate to avoid TOCTOU race conditions.
+ * Uses the unique constraint on (tenantId, slackTeamId, slackChannelId).
+ */
+declare const upsertWorkAppSlackChannelAgentConfig: (db: AgentsRunDatabaseClient) => (data: Omit<WorkAppSlackChannelAgentConfigInsert, "id" | "createdAt" | "updatedAt">) => Promise<WorkAppSlackChannelAgentConfigSelect>;
+declare const deleteWorkAppSlackChannelAgentConfig: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string, slackChannelId: string) => Promise<boolean>;
+declare const deleteAllWorkAppSlackChannelAgentConfigsByTeam: (db: AgentsRunDatabaseClient) => (tenantId: string, slackTeamId: string) => Promise<number>;
+//#endregion
+export { WorkAppSlackChannelAgentConfigInsert, WorkAppSlackChannelAgentConfigSelect, WorkAppSlackUserMappingInsert, WorkAppSlackUserMappingSelect, WorkAppSlackWorkspaceInsert, WorkAppSlackWorkspaceSelect, createWorkAppSlackChannelAgentConfig, createWorkAppSlackUserMapping, createWorkAppSlackWorkspace, deleteAllWorkAppSlackChannelAgentConfigsByTeam, deleteAllWorkAppSlackUserMappingsByTeam, deleteWorkAppSlackChannelAgentConfig, deleteWorkAppSlackUserMapping, deleteWorkAppSlackWorkspace, deleteWorkAppSlackWorkspaceByNangoConnectionId, findWorkAppSlackChannelAgentConfig, findWorkAppSlackUserMapping, findWorkAppSlackUserMappingByInkeepUserId, findWorkAppSlackUserMappingBySlackUser, findWorkAppSlackWorkspaceByNangoConnectionId, findWorkAppSlackWorkspaceBySlackTeamId, findWorkAppSlackWorkspaceByTeamId, listWorkAppSlackChannelAgentConfigsByTeam, listWorkAppSlackUserMappingsByTeam, listWorkAppSlackWorkspacesByTenant, updateWorkAppSlackWorkspace, upsertWorkAppSlackChannelAgentConfig };