@inkeep/agents-core 0.62.2 → 0.63.0

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

@@ -15,8 +15,6 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
   updatedAt: string;
   description: string | null;
   tenantId: string;
-  projectId: string;
-  agentId: string;
   models: {
     base?: {
       model?: string | undefined;
@@ -31,10 +29,12 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
       providerOptions?: Record<string, unknown> | undefined;
     } | undefined;
   } | null;
-  prompt: string | null;
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
+  projectId: string;
+  agentId: string;
+  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 } | undefined>;
 declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
@@ -46,8 +46,6 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
   updatedAt: string;
   description: string | null;
   tenantId: string;
-  projectId: string;
-  agentId: string;
   models: {
     base?: {
       model?: string | undefined;
@@ -62,10 +60,12 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
       providerOptions?: Record<string, unknown> | undefined;
     } | undefined;
   } | null;
-  prompt: string | null;
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
+  projectId: string;
+  agentId: string;
+  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 }[]>;
 declare const listSubAgentsPaginated: (db: AgentsManageDatabaseClient) => (params: {
@@ -115,8 +115,6 @@ declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAg
   updatedAt: string;
   description: string | null;
   tenantId: string;
-  projectId: string;
-  agentId: string;
   models: {
     base?: {
       model?: string | undefined;
@@ -131,10 +129,12 @@ declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAg
       providerOptions?: Record<string, unknown> | undefined;
     } | undefined;
   } | null;
-  prompt: string | null;
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
+  projectId: string;
+  agentId: string;
+  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 }>;
 declare const updateSubAgent: (db: AgentsManageDatabaseClient) => (params: {

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

@@ -28,11 +28,11 @@ declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
   headers: Record<string, string> | null;
   tenantId: string;
   projectId: string;
+  credentialReferenceId: string | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
-  credentialReferenceId: string | null;
   credentialScope: string;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;
@@ -86,11 +86,11 @@ declare const createTool: (db: AgentsManageDatabaseClient) => (params: ToolInser
   headers: Record<string, string> | null;
   tenantId: string;
   projectId: string;
+  credentialReferenceId: string | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
-  credentialReferenceId: string | null;
   credentialScope: string;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;
@@ -144,10 +144,10 @@ declare const addToolToAgent: (db: AgentsManageDatabaseClient) => (params: {
   agentId: string;
   subAgentId: string;
   toolId: string;
+  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
-  selectedTools: string[] | null;
 }>;
 declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params: {
   scopes: AgentScopeConfig;
@@ -163,10 +163,10 @@ declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params:
   agentId: string;
   subAgentId: string;
   toolId: string;
+  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
-  selectedTools: string[] | null;
 }>;
 /**
  * Upsert agent-tool relation (create if it doesn't exist, update if it does)
@@ -191,10 +191,10 @@ declare const upsertSubAgentToolRelation: (db: AgentsManageDatabaseClient) => (p
   agentId: string;
   subAgentId: string;
   toolId: string;
+  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
-  selectedTools: string[] | null;
 }>;
 /**
  * Upsert a tool (create if it doesn't exist, update if it does)
@@ -210,11 +210,11 @@ declare const upsertTool: (db: AgentsManageDatabaseClient) => (params: {
   headers: Record<string, string> | null;
   tenantId: string;
   projectId: string;
+  credentialReferenceId: string | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
-  credentialReferenceId: string | null;
   credentialScope: string;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;

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

@@ -2,8 +2,8 @@ import { manage_schema_exports } from "../../db/manage/manage-schema.js";
 import { getLogger } from "../../utils/logger.js";
 import { resolveProjectMainRefs } from "../../dolt/ref-helpers.js";
 import { listProjectsMetadata } from "../runtime/projects.js";
-import { deleteScheduledTriggersByRunAsUserId } from "./scheduledTriggers.js";
 import { deleteTriggersByRunAsUserId } from "./triggers.js";
+import { deleteScheduledTriggersByRunAsUserId } from "../runtime/scheduledTriggers.js";
 import { withRef } from "../../dolt/ref-scope.js";
 import { drizzle } from "drizzle-orm/node-postgres";
 
@@ -13,6 +13,22 @@ async function cleanupUserTriggers(params) {
 	const { tenantId, userId, runDb, manageDbPool } = params;
 	const projects = await listProjectsMetadata(runDb)({ tenantId });
 	if (projects.length === 0) return;
+	await Promise.allSettled(projects.map(async (project) => {
+		try {
+			await deleteScheduledTriggersByRunAsUserId(runDb)({
+				tenantId,
+				projectId: project.id,
+				runAsUserId: userId
+			});
+		} catch (err) {
+			logger.error({
+				tenantId,
+				projectId: project.id,
+				userId,
+				error: err
+			}, "Failed to clean up scheduled triggers for project");
+		}
+	}));
 	const connection = await manageDbPool.connect();
 	let resolvedRefs;
 	try {
@@ -21,11 +37,6 @@ async function cleanupUserTriggers(params) {
 		connection.release();
 	}
 	const results = await Promise.allSettled(resolvedRefs.map(({ projectId, ref }) => withRef(manageDbPool, ref, async (db) => {
-		await deleteScheduledTriggersByRunAsUserId(db)({
-			tenantId,
-			projectId,
-			runAsUserId: userId
-		});
 		await deleteTriggersByRunAsUserId(db)({
 			tenantId,
 			projectId,
@@ -43,7 +54,7 @@ async function cleanupUserTriggers(params) {
 			projectId,
 			userId,
 			error: result.reason
-		}, "Failed to clean up scheduled triggers for project");
+		}, "Failed to clean up webhook triggers for project");
 	}
 }
 

package/dist/data-access/runtime/cascade-delete.d.ts

@@ -19,6 +19,7 @@ type CascadeDeleteResult = {
   slackWorkspaceDefaultsCleared: number;
   appsDeleted: number;
   appDefaultsCleared: number;
+  scheduledTriggersDeleted: number;
 };
 /**
  * Delete all runtime entities for a specific branch.
@@ -30,6 +31,7 @@ type CascadeDeleteResult = {
 declare const cascadeDeleteByBranch: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
   fullBranchName: string;
+  ref: string;
 }) => Promise<CascadeDeleteResult>;
 /**
  * Delete all runtime entities for a project on a specific branch.

package/dist/data-access/runtime/cascade-delete.js

@@ -1,4 +1,4 @@
-import { apiKeys, contextCache, conversations, datasetRun, evaluationRun, scheduledTriggerInvocations, tasks, triggerInvocations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess } from "../../db/runtime/runtime-schema.js";
+import { apiKeys, contextCache, conversations, datasetRun, evaluationRun, scheduledTriggerInvocations, scheduledTriggers, tasks, triggerInvocations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess } from "../../db/runtime/runtime-schema.js";
 import { projectScopedWhere } from "../manage/scope-helpers.js";
 import { clearAppDefaultsByAgent, clearAppDefaultsByProject, deleteAppsByProject } from "./apps.js";
 import { deleteSlackMcpToolAccessConfig } from "./slack-work-app-mcp.js";
@@ -14,7 +14,7 @@ import { and, eq, inArray, sql } from "drizzle-orm";
 * @returns Function that performs the cascade delete
 */
 const cascadeDeleteByBranch = (db) => async (params) => {
-	const { scopes, fullBranchName } = params;
+	const { scopes, fullBranchName, ref } = params;
 	const contextCacheResult = await db.delete(contextCache).where(and(projectScopedWhere(contextCache, scopes), sql`${contextCache.ref}->>'name' = ${fullBranchName}`)).returning();
 	const conversationsResult = await db.delete(conversations).where(and(projectScopedWhere(conversations, scopes), sql`${conversations.ref}->>'name' = ${fullBranchName}`)).returning();
 	const tasksResult = await db.delete(tasks).where(and(projectScopedWhere(tasks, scopes), sql`${tasks.ref}->>'name' = ${fullBranchName}`)).returning();
@@ -22,6 +22,7 @@ const cascadeDeleteByBranch = (db) => async (params) => {
 	const scheduledTriggerInvocationsResult = await db.delete(scheduledTriggerInvocations).where(and(eq(scheduledTriggerInvocations.tenantId, scopes.tenantId), eq(scheduledTriggerInvocations.projectId, scopes.projectId), sql`${scheduledTriggerInvocations.ref}->>'name' = ${fullBranchName}`)).returning();
 	const datasetRunsResult = await db.delete(datasetRun).where(and(eq(datasetRun.tenantId, scopes.tenantId), eq(datasetRun.projectId, scopes.projectId), sql`${datasetRun.ref}->>'name' = ${fullBranchName}`)).returning();
 	const evaluationRunsResult = await db.delete(evaluationRun).where(and(eq(evaluationRun.tenantId, scopes.tenantId), eq(evaluationRun.projectId, scopes.projectId), sql`${evaluationRun.ref}->>'name' = ${fullBranchName}`)).returning();
+	const scheduledTriggersResult = await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, scopes.tenantId), eq(scheduledTriggers.projectId, scopes.projectId), eq(scheduledTriggers.ref, ref))).returning();
 	return {
 		conversationsDeleted: conversationsResult.length,
 		tasksDeleted: tasksResult.length,
@@ -34,7 +35,8 @@ const cascadeDeleteByBranch = (db) => async (params) => {
 		slackChannelConfigsDeleted: 0,
 		slackWorkspaceDefaultsCleared: 0,
 		appsDeleted: 0,
-		appDefaultsCleared: 0
+		appDefaultsCleared: 0,
+		scheduledTriggersDeleted: scheduledTriggersResult.length
 	};
 };
 /**
@@ -64,6 +66,7 @@ const cascadeDeleteByProject = (db) => async (params) => {
 	const slackChannelConfigsDeleted = await deleteWorkAppSlackChannelAgentConfigsByProject(db)(scopes.tenantId, scopes.projectId);
 	const slackWorkspaceDefaultsCleared = await clearWorkspaceDefaultsByProject(db)(scopes.tenantId, scopes.projectId);
 	clearDevConfigWorkspaceDefaultsByProject(scopes.projectId);
+	const scheduledTriggersResult = await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, scopes.tenantId), eq(scheduledTriggers.projectId, scopes.projectId))).returning();
 	return {
 		conversationsDeleted: conversationsResult.length,
 		tasksDeleted: tasksResult.length,
@@ -76,7 +79,8 @@ const cascadeDeleteByProject = (db) => async (params) => {
 		slackChannelConfigsDeleted,
 		slackWorkspaceDefaultsCleared,
 		appsDeleted,
-		appDefaultsCleared
+		appDefaultsCleared,
+		scheduledTriggersDeleted: scheduledTriggersResult.length
 	};
 };
 /**
@@ -108,6 +112,7 @@ const cascadeDeleteByAgent = (db) => async (params) => {
 	const slackChannelConfigsDeleted = await deleteWorkAppSlackChannelAgentConfigsByAgent(db)(scopes.tenantId, scopes.projectId, scopes.agentId);
 	const slackWorkspaceDefaultsCleared = await clearWorkspaceDefaultsByAgent(db)(scopes.tenantId, scopes.projectId, scopes.agentId);
 	clearDevConfigWorkspaceDefaultsByAgent(scopes.projectId, scopes.agentId);
+	const scheduledTriggersResult = await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, scopes.tenantId), eq(scheduledTriggers.projectId, scopes.projectId), eq(scheduledTriggers.agentId, scopes.agentId))).returning();
 	return {
 		conversationsDeleted,
 		tasksDeleted,
@@ -120,7 +125,8 @@ const cascadeDeleteByAgent = (db) => async (params) => {
 		slackChannelConfigsDeleted,
 		slackWorkspaceDefaultsCleared,
 		appsDeleted: 0,
-		appDefaultsCleared
+		appDefaultsCleared,
+		scheduledTriggersDeleted: scheduledTriggersResult.length
 	};
 };
 /**
@@ -151,7 +157,8 @@ const cascadeDeleteBySubAgent = (db) => async (params) => {
 		slackChannelConfigsDeleted: 0,
 		slackWorkspaceDefaultsCleared: 0,
 		appsDeleted: 0,
-		appDefaultsCleared: 0
+		appDefaultsCleared: 0,
+		scheduledTriggersDeleted: 0
 	};
 };
 /**

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

@@ -25,8 +25,8 @@ declare const createConversation: (db: AgentsRunDatabaseClient) => (params: Conv
   } | null;
   userId: string | null;
   metadata: ConversationMetadata | null;
-  title: string | null;
   tenantId: string;
+  title: string | null;
   projectId: string;
   agentId: string | null;
   activeSubAgentId: string;
@@ -94,8 +94,8 @@ declare const getConversation: (db: AgentsRunDatabaseClient) => (params: {
   } | null;
   userId: string | null;
   metadata: ConversationMetadata | null;
-  title: string | null;
   tenantId: string;
+  title: string | null;
   projectId: string;
   agentId: string | null;
   activeSubAgentId: string;
@@ -130,8 +130,8 @@ declare const createOrGetConversation: (db: AgentsRunDatabaseClient) => (input:
   } | null;
   userId: string | null;
   metadata: ConversationMetadata | null;
-  title: string | null;
   tenantId: string;
+  title: string | null;
   projectId: string;
   agentId: string | null;
   activeSubAgentId: string;
@@ -162,8 +162,8 @@ declare const getActiveAgentForConversation: (db: AgentsRunDatabaseClient) => (p
   } | null;
   userId: string | null;
   metadata: ConversationMetadata | null;
-  title: string | null;
   tenantId: string;
+  title: string | null;
   projectId: string;
   agentId: string | null;
   activeSubAgentId: string;

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

@@ -15,21 +15,21 @@ declare const getMessageById: (db: AgentsRunDatabaseClient) => (params: {
   updatedAt: string;
   metadata: MessageMetadata | null;
   role: string;
-  content: MessageContent;
   tenantId: string;
+  content: MessageContent;
   projectId: 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: {
@@ -149,21 +149,21 @@ declare const createMessage: (db: AgentsRunDatabaseClient) => (params: {
   updatedAt: string;
   metadata: MessageMetadata | null;
   role: string;
-  content: MessageContent;
   tenantId: string;
+  content: MessageContent;
   projectId: 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: {
@@ -202,21 +202,21 @@ declare const deleteMessage: (db: AgentsRunDatabaseClient) => (params: {
   updatedAt: string;
   metadata: MessageMetadata | null;
   role: string;
-  content: MessageContent;
   tenantId: string;
+  content: MessageContent;
   projectId: 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/scheduledTriggerInvocations.d.ts

@@ -1,7 +1,8 @@
 import { AgentScopeConfig } from "../../db/manage/scope-definitions.js";
 import { PaginationConfig } from "../../types/utility.js";
 import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
-import { ScheduledTriggerInvocation, ScheduledTriggerInvocationInsert, ScheduledTriggerInvocationStatus, ScheduledTriggerInvocationUpdate } from "../../validation/schemas.js";
+import { ScheduledTriggerInvocationStatus } from "../../validation/schemas.js";
+import { ScheduledTriggerInvocation, ScheduledTriggerInvocationInsert, ScheduledTriggerInvocationUpdate } from "../../types/entities.js";
 
 //#region src/data-access/runtime/scheduledTriggerInvocations.d.ts
 /**
@@ -39,7 +40,7 @@ declare const listScheduledTriggerInvocationsPaginated: (db: AgentsRunDatabaseCl
       name: string;
       hash: string;
     } | null;
-    status: "pending" | "failed" | "running" | "completed" | "cancelled";
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
     scheduledFor: string;
     startedAt: string | null;
     completedAt: string | null;
@@ -193,7 +194,7 @@ declare const listUpcomingInvocationsForAgentPaginated: (db: AgentsRunDatabaseCl
       name: string;
       hash: string;
     } | null;
-    status: "pending" | "failed" | "running" | "completed" | "cancelled";
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
     scheduledFor: string;
     startedAt: string | null;
     completedAt: string | null;
@@ -232,7 +233,7 @@ declare const listProjectScheduledTriggerInvocationsPaginated: (db: AgentsRunDat
       name: string;
       hash: string;
     } | null;
-    status: "pending" | "failed" | "running" | "completed" | "cancelled";
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
     scheduledFor: string;
     startedAt: string | null;
     completedAt: string | null;

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

@@ -0,0 +1,89 @@
+import { AgentScopeConfig } from "../../db/manage/scope-definitions.js";
+import { PaginationConfig } from "../../types/utility.js";
+import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
+import { ScheduledTrigger, ScheduledTriggerInsert } from "../../types/entities.js";
+
+//#region src/data-access/runtime/scheduledTriggers.d.ts
+declare const getScheduledTriggerById: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+}) => Promise<ScheduledTrigger | undefined>;
+declare const listScheduledTriggersPaginated: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  pagination?: PaginationConfig;
+}) => Promise<{
+  data: {
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    description: string | null;
+    enabled: boolean;
+    cronExpression: string | null;
+    cronTimezone: string | null;
+    runAt: string | null;
+    payload: Record<string, unknown> | null;
+    messageTemplate: string | null;
+    maxRetries: number;
+    retryDelaySeconds: number;
+    timeoutSeconds: number;
+    runAsUserId: string | null;
+    createdBy: string | null;
+    nextRunAt: string | null;
+    ref: string;
+    agentId: string;
+    projectId: string;
+    tenantId: string;
+    id: string;
+  }[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+  };
+}>;
+declare const createScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: ScheduledTriggerInsert & {
+  nextRunAt?: string | null;
+}) => Promise<ScheduledTrigger>;
+declare const updateScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  data: Partial<ScheduledTriggerInsert> & {
+    nextRunAt?: string | null;
+  };
+}) => Promise<ScheduledTrigger>;
+declare const deleteScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+}) => Promise<void>;
+declare const upsertScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  data: ScheduledTriggerInsert;
+}) => Promise<ScheduledTrigger>;
+declare const deleteScheduledTriggersByRunAsUserId: (db: AgentsRunDatabaseClient) => (params: {
+  tenantId: string;
+  projectId: string;
+  runAsUserId: string;
+}) => Promise<void>;
+declare const listScheduledTriggers: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+}) => Promise<ScheduledTrigger[]>;
+/**
+ * Query due scheduled triggers across all projects directly from the runtime DB.
+ * No AS OF queries needed - simple WHERE clause on enabled + nextRunAt.
+ */
+declare const findDueScheduledTriggersAcrossProjects: (db: AgentsRunDatabaseClient) => (params: {
+  asOf: string;
+}) => Promise<ScheduledTrigger[]>;
+/**
+ * Advance the next_run_at timestamp for a scheduled trigger in the runtime DB.
+ * No withRef scope needed - direct update.
+ */
+declare const advanceScheduledTriggerNextRunAt: (db: AgentsRunDatabaseClient) => (params: {
+  scopes: AgentScopeConfig;
+  scheduledTriggerId: string;
+  nextRunAt: string | null;
+  enabled?: boolean;
+}) => Promise<void>;
+//#endregion
+export { advanceScheduledTriggerNextRunAt, createScheduledTrigger, deleteScheduledTrigger, deleteScheduledTriggersByRunAsUserId, findDueScheduledTriggersAcrossProjects, getScheduledTriggerById, listScheduledTriggers, listScheduledTriggersPaginated, updateScheduledTrigger, upsertScheduledTrigger };

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

@@ -0,0 +1,91 @@
+import { scheduledTriggers } from "../../db/runtime/runtime-schema.js";
+import { computeNextRunAt } from "../../utils/compute-next-run-at.js";
+import { and, count, desc, eq, isNotNull, lte } from "drizzle-orm";
+
+//#region src/data-access/runtime/scheduledTriggers.ts
+const getScheduledTriggerById = (db) => async (params) => {
+	return await db.query.scheduledTriggers.findFirst({ where: and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId), eq(scheduledTriggers.id, params.scheduledTriggerId)) });
+};
+const listScheduledTriggersPaginated = (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(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId));
+	const [data, totalResult] = await Promise.all([db.select().from(scheduledTriggers).where(whereClause).limit(limit).offset(offset).orderBy(desc(scheduledTriggers.createdAt)), db.select({ count: count() }).from(scheduledTriggers).where(whereClause)]);
+	const total = totalResult[0]?.count || 0;
+	return {
+		data,
+		pagination: {
+			page,
+			limit,
+			total,
+			pages: Math.ceil(total / limit)
+		}
+	};
+};
+const createScheduledTrigger = (db) => async (params) => {
+	const created = (await db.insert(scheduledTriggers).values(params).returning())[0];
+	if (!created) throw new Error("Failed to create scheduled trigger");
+	return created;
+};
+const updateScheduledTrigger = (db) => async (params) => {
+	const updateData = {
+		...params.data,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	const updated = (await db.update(scheduledTriggers).set(updateData).where(and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId), eq(scheduledTriggers.id, params.scheduledTriggerId))).returning())[0];
+	if (!updated) throw new Error(`Scheduled trigger ${params.scheduledTriggerId} not found for update`);
+	return updated;
+};
+const deleteScheduledTrigger = (db) => async (params) => {
+	await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId), eq(scheduledTriggers.id, params.scheduledTriggerId)));
+};
+const upsertScheduledTrigger = (db) => async (params) => {
+	const nextRunAt = params.data.enabled ?? true ? computeNextRunAt({
+		cronExpression: params.data.cronExpression,
+		cronTimezone: params.data.cronTimezone,
+		runAt: params.data.runAt
+	}) : null;
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const values = {
+		...params.data,
+		nextRunAt
+	};
+	const upserted = (await db.insert(scheduledTriggers).values(values).onConflictDoUpdate({
+		target: [scheduledTriggers.tenantId, scheduledTriggers.id],
+		set: {
+			...values,
+			updatedAt: now
+		}
+	}).returning())[0];
+	if (!upserted) throw new Error(`Failed to upsert scheduled trigger ${params.data.id}`);
+	return upserted;
+};
+const deleteScheduledTriggersByRunAsUserId = (db) => async (params) => {
+	await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, params.tenantId), eq(scheduledTriggers.projectId, params.projectId), eq(scheduledTriggers.runAsUserId, params.runAsUserId)));
+};
+const listScheduledTriggers = (db) => async (params) => {
+	return await db.select().from(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId)));
+};
+/**
+* Query due scheduled triggers across all projects directly from the runtime DB.
+* No AS OF queries needed - simple WHERE clause on enabled + nextRunAt.
+*/
+const findDueScheduledTriggersAcrossProjects = (db) => async (params) => {
+	return await db.select().from(scheduledTriggers).where(and(eq(scheduledTriggers.enabled, true), isNotNull(scheduledTriggers.nextRunAt), lte(scheduledTriggers.nextRunAt, params.asOf)));
+};
+/**
+* Advance the next_run_at timestamp for a scheduled trigger in the runtime DB.
+* No withRef scope needed - direct update.
+*/
+const advanceScheduledTriggerNextRunAt = (db) => async (params) => {
+	const set = {
+		nextRunAt: params.nextRunAt,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (params.enabled !== void 0) set.enabled = params.enabled;
+	await db.update(scheduledTriggers).set(set).where(and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId), eq(scheduledTriggers.id, params.scheduledTriggerId)));
+};
+
+//#endregion
+export { advanceScheduledTriggerNextRunAt, createScheduledTrigger, deleteScheduledTrigger, deleteScheduledTriggersByRunAsUserId, findDueScheduledTriggersAcrossProjects, getScheduledTriggerById, listScheduledTriggers, listScheduledTriggersPaginated, updateScheduledTrigger, upsertScheduledTrigger };

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

@@ -0,0 +1,11 @@
+import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
+import { SchedulerState } from "../../types/entities.js";
+
+//#region src/data-access/runtime/schedulerState.d.ts
+declare const getSchedulerState: (db: AgentsRunDatabaseClient) => () => Promise<SchedulerState | undefined>;
+declare const upsertSchedulerState: (db: AgentsRunDatabaseClient) => (params: {
+  currentRunId: string;
+}) => Promise<SchedulerState>;
+declare const clearSchedulerState: (db: AgentsRunDatabaseClient) => () => Promise<void>;
+//#endregion
+export { clearSchedulerState, getSchedulerState, upsertSchedulerState };

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

@@ -0,0 +1,30 @@
+import { schedulerState } from "../../db/runtime/runtime-schema.js";
+import { eq, sql } from "drizzle-orm";
+
+//#region src/data-access/runtime/schedulerState.ts
+const SINGLETON_ID = "singleton";
+const getSchedulerState = (db) => async () => {
+	return await db.query.schedulerState.findFirst({ where: eq(schedulerState.id, SINGLETON_ID) });
+};
+const upsertSchedulerState = (db) => async (params) => {
+	const [row] = await db.insert(schedulerState).values({
+		id: SINGLETON_ID,
+		currentRunId: params.currentRunId
+	}).onConflictDoUpdate({
+		target: schedulerState.id,
+		set: {
+			currentRunId: params.currentRunId,
+			updatedAt: sql`now()`.mapWith(String)
+		}
+	}).returning();
+	return row;
+};
+const clearSchedulerState = (db) => async () => {
+	await db.update(schedulerState).set({
+		currentRunId: null,
+		updatedAt: sql`now()`.mapWith(String)
+	}).where(eq(schedulerState.id, SINGLETON_ID));
+};
+
+//#endregion
+export { clearSchedulerState, getSchedulerState, upsertSchedulerState };