@inkeep/agents-core 0.62.2 → 0.63.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/dist/auth/auth-config-utils.js +1 -1
  2. package/dist/auth/auth.d.ts +6 -6
  3. package/dist/auth/auth.js +1 -1
  4. package/dist/auth/permissions.d.ts +13 -13
  5. package/dist/client-exports.d.ts +2 -2
  6. package/dist/client-exports.js +2 -2
  7. package/dist/data-access/index.d.ts +4 -7
  8. package/dist/data-access/index.js +4 -7
  9. package/dist/data-access/manage/agentFull.js +0 -116
  10. package/dist/data-access/manage/agents.d.ts +41 -41
  11. package/dist/data-access/manage/agents.js +0 -30
  12. package/dist/data-access/manage/artifactComponents.d.ts +10 -10
  13. package/dist/data-access/manage/audit-queries.d.ts +1 -14
  14. package/dist/data-access/manage/audit-queries.js +2 -16
  15. package/dist/data-access/manage/contextConfigs.d.ts +12 -12
  16. package/dist/data-access/manage/dataComponents.d.ts +4 -4
  17. package/dist/data-access/manage/functionTools.d.ts +16 -16
  18. package/dist/data-access/manage/skills.d.ts +14 -14
  19. package/dist/data-access/manage/subAgentExternalAgentRelations.d.ts +24 -24
  20. package/dist/data-access/manage/subAgentRelations.d.ts +28 -28
  21. package/dist/data-access/manage/subAgentTeamAgentRelations.d.ts +24 -24
  22. package/dist/data-access/manage/subAgents.d.ts +15 -15
  23. package/dist/data-access/manage/tools.d.ts +30 -30
  24. package/dist/data-access/manage/triggerCleanup.js +18 -7
  25. package/dist/data-access/manage/triggers.d.ts +2 -2
  26. package/dist/data-access/runtime/apiKeys.d.ts +12 -12
  27. package/dist/data-access/runtime/apps.d.ts +8 -8
  28. package/dist/data-access/runtime/cascade-delete.d.ts +2 -0
  29. package/dist/data-access/runtime/cascade-delete.js +13 -6
  30. package/dist/data-access/runtime/conversations.d.ts +24 -24
  31. package/dist/data-access/runtime/messages.d.ts +18 -18
  32. package/dist/data-access/runtime/scheduledTriggerInvocations.d.ts +2 -1
  33. package/dist/data-access/runtime/scheduledTriggers.d.ts +89 -0
  34. package/dist/data-access/runtime/scheduledTriggers.js +91 -0
  35. package/dist/data-access/runtime/schedulerState.d.ts +11 -0
  36. package/dist/data-access/runtime/schedulerState.js +30 -0
  37. package/dist/data-access/runtime/tasks.d.ts +6 -6
  38. package/dist/data-reconciliation/index.d.ts +2 -2
  39. package/dist/data-reconciliation/types.d.ts +1 -28
  40. package/dist/db/manage/manage-schema.d.ts +433 -787
  41. package/dist/db/manage/manage-schema.js +2 -4
  42. package/dist/db/runtime/runtime-schema.d.ts +807 -346
  43. package/dist/db/runtime/runtime-schema.js +38 -5
  44. package/dist/index.d.ts +11 -12
  45. package/dist/index.js +8 -10
  46. package/dist/types/entities.d.ts +12 -2
  47. package/dist/types/index.d.ts +2 -2
  48. package/dist/utils/compute-next-run-at.d.ts +9 -0
  49. package/dist/utils/compute-next-run-at.js +18 -0
  50. package/dist/utils/error.d.ts +51 -51
  51. package/dist/utils/index.d.ts +2 -1
  52. package/dist/utils/index.js +2 -1
  53. package/dist/validation/index.d.ts +2 -2
  54. package/dist/validation/index.js +2 -2
  55. package/dist/validation/schemas.d.ts +1062 -2042
  56. package/dist/validation/schemas.js +16 -32
  57. package/drizzle/runtime/0028_thick_squirrel_girl.sql +36 -0
  58. package/drizzle/runtime/meta/0028_snapshot.json +4661 -0
  59. package/drizzle/runtime/meta/_journal.json +7 -0
  60. package/package.json +2 -1
  61. package/dist/data-access/manage/scheduledTriggers.d.ts +0 -91
  62. package/dist/data-access/manage/scheduledTriggers.js +0 -87
  63. package/dist/data-access/manage/scheduledWorkflows.d.ts +0 -29
  64. package/dist/data-access/manage/scheduledWorkflows.js +0 -33
@@ -0,0 +1,89 @@
1
+ import { AgentScopeConfig } from "../../db/manage/scope-definitions.js";
2
+ import { PaginationConfig } from "../../types/utility.js";
3
+ import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
4
+ import { ScheduledTrigger, ScheduledTriggerInsert } from "../../types/entities.js";
5
+
6
+ //#region src/data-access/runtime/scheduledTriggers.d.ts
7
+ declare const getScheduledTriggerById: (db: AgentsRunDatabaseClient) => (params: {
8
+ scopes: AgentScopeConfig;
9
+ scheduledTriggerId: string;
10
+ }) => Promise<ScheduledTrigger | undefined>;
11
+ declare const listScheduledTriggersPaginated: (db: AgentsRunDatabaseClient) => (params: {
12
+ scopes: AgentScopeConfig;
13
+ pagination?: PaginationConfig;
14
+ }) => Promise<{
15
+ data: {
16
+ createdAt: string;
17
+ updatedAt: string;
18
+ name: string;
19
+ description: string | null;
20
+ enabled: boolean;
21
+ cronExpression: string | null;
22
+ cronTimezone: string | null;
23
+ runAt: string | null;
24
+ payload: Record<string, unknown> | null;
25
+ messageTemplate: string | null;
26
+ maxRetries: number;
27
+ retryDelaySeconds: number;
28
+ timeoutSeconds: number;
29
+ runAsUserId: string | null;
30
+ createdBy: string | null;
31
+ nextRunAt: string | null;
32
+ ref: string;
33
+ agentId: string;
34
+ projectId: string;
35
+ tenantId: string;
36
+ id: string;
37
+ }[];
38
+ pagination: {
39
+ page: number;
40
+ limit: number;
41
+ total: number;
42
+ pages: number;
43
+ };
44
+ }>;
45
+ declare const createScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: ScheduledTriggerInsert & {
46
+ nextRunAt?: string | null;
47
+ }) => Promise<ScheduledTrigger>;
48
+ declare const updateScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
49
+ scopes: AgentScopeConfig;
50
+ scheduledTriggerId: string;
51
+ data: Partial<ScheduledTriggerInsert> & {
52
+ nextRunAt?: string | null;
53
+ };
54
+ }) => Promise<ScheduledTrigger>;
55
+ declare const deleteScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
56
+ scopes: AgentScopeConfig;
57
+ scheduledTriggerId: string;
58
+ }) => Promise<void>;
59
+ declare const upsertScheduledTrigger: (db: AgentsRunDatabaseClient) => (params: {
60
+ scopes: AgentScopeConfig;
61
+ data: ScheduledTriggerInsert;
62
+ }) => Promise<ScheduledTrigger>;
63
+ declare const deleteScheduledTriggersByRunAsUserId: (db: AgentsRunDatabaseClient) => (params: {
64
+ tenantId: string;
65
+ projectId: string;
66
+ runAsUserId: string;
67
+ }) => Promise<void>;
68
+ declare const listScheduledTriggers: (db: AgentsRunDatabaseClient) => (params: {
69
+ scopes: AgentScopeConfig;
70
+ }) => Promise<ScheduledTrigger[]>;
71
+ /**
72
+ * Query due scheduled triggers across all projects directly from the runtime DB.
73
+ * No AS OF queries needed - simple WHERE clause on enabled + nextRunAt.
74
+ */
75
+ declare const findDueScheduledTriggersAcrossProjects: (db: AgentsRunDatabaseClient) => (params: {
76
+ asOf: string;
77
+ }) => Promise<ScheduledTrigger[]>;
78
+ /**
79
+ * Advance the next_run_at timestamp for a scheduled trigger in the runtime DB.
80
+ * No withRef scope needed - direct update.
81
+ */
82
+ declare const advanceScheduledTriggerNextRunAt: (db: AgentsRunDatabaseClient) => (params: {
83
+ scopes: AgentScopeConfig;
84
+ scheduledTriggerId: string;
85
+ nextRunAt: string | null;
86
+ enabled?: boolean;
87
+ }) => Promise<void>;
88
+ //#endregion
89
+ export { advanceScheduledTriggerNextRunAt, createScheduledTrigger, deleteScheduledTrigger, deleteScheduledTriggersByRunAsUserId, findDueScheduledTriggersAcrossProjects, getScheduledTriggerById, listScheduledTriggers, listScheduledTriggersPaginated, updateScheduledTrigger, upsertScheduledTrigger };
@@ -0,0 +1,91 @@
1
+ import { scheduledTriggers } from "../../db/runtime/runtime-schema.js";
2
+ import { computeNextRunAt } from "../../utils/compute-next-run-at.js";
3
+ import { and, count, desc, eq, isNotNull, lte } from "drizzle-orm";
4
+
5
+ //#region src/data-access/runtime/scheduledTriggers.ts
6
+ const getScheduledTriggerById = (db) => async (params) => {
7
+ 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)) });
8
+ };
9
+ const listScheduledTriggersPaginated = (db) => async (params) => {
10
+ const page = params.pagination?.page || 1;
11
+ const limit = Math.min(params.pagination?.limit || 10, 100);
12
+ const offset = (page - 1) * limit;
13
+ const whereClause = and(eq(scheduledTriggers.tenantId, params.scopes.tenantId), eq(scheduledTriggers.projectId, params.scopes.projectId), eq(scheduledTriggers.agentId, params.scopes.agentId));
14
+ 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)]);
15
+ const total = totalResult[0]?.count || 0;
16
+ return {
17
+ data,
18
+ pagination: {
19
+ page,
20
+ limit,
21
+ total,
22
+ pages: Math.ceil(total / limit)
23
+ }
24
+ };
25
+ };
26
+ const createScheduledTrigger = (db) => async (params) => {
27
+ const created = (await db.insert(scheduledTriggers).values(params).returning())[0];
28
+ if (!created) throw new Error("Failed to create scheduled trigger");
29
+ return created;
30
+ };
31
+ const updateScheduledTrigger = (db) => async (params) => {
32
+ const updateData = {
33
+ ...params.data,
34
+ updatedAt: (/* @__PURE__ */ new Date()).toISOString()
35
+ };
36
+ 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];
37
+ if (!updated) throw new Error(`Scheduled trigger ${params.scheduledTriggerId} not found for update`);
38
+ return updated;
39
+ };
40
+ const deleteScheduledTrigger = (db) => async (params) => {
41
+ 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)));
42
+ };
43
+ const upsertScheduledTrigger = (db) => async (params) => {
44
+ const nextRunAt = params.data.enabled ?? true ? computeNextRunAt({
45
+ cronExpression: params.data.cronExpression,
46
+ cronTimezone: params.data.cronTimezone,
47
+ runAt: params.data.runAt
48
+ }) : null;
49
+ const now = (/* @__PURE__ */ new Date()).toISOString();
50
+ const values = {
51
+ ...params.data,
52
+ nextRunAt
53
+ };
54
+ const upserted = (await db.insert(scheduledTriggers).values(values).onConflictDoUpdate({
55
+ target: [scheduledTriggers.tenantId, scheduledTriggers.id],
56
+ set: {
57
+ ...values,
58
+ updatedAt: now
59
+ }
60
+ }).returning())[0];
61
+ if (!upserted) throw new Error(`Failed to upsert scheduled trigger ${params.data.id}`);
62
+ return upserted;
63
+ };
64
+ const deleteScheduledTriggersByRunAsUserId = (db) => async (params) => {
65
+ await db.delete(scheduledTriggers).where(and(eq(scheduledTriggers.tenantId, params.tenantId), eq(scheduledTriggers.projectId, params.projectId), eq(scheduledTriggers.runAsUserId, params.runAsUserId)));
66
+ };
67
+ const listScheduledTriggers = (db) => async (params) => {
68
+ 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)));
69
+ };
70
+ /**
71
+ * Query due scheduled triggers across all projects directly from the runtime DB.
72
+ * No AS OF queries needed - simple WHERE clause on enabled + nextRunAt.
73
+ */
74
+ const findDueScheduledTriggersAcrossProjects = (db) => async (params) => {
75
+ return await db.select().from(scheduledTriggers).where(and(eq(scheduledTriggers.enabled, true), isNotNull(scheduledTriggers.nextRunAt), lte(scheduledTriggers.nextRunAt, params.asOf)));
76
+ };
77
+ /**
78
+ * Advance the next_run_at timestamp for a scheduled trigger in the runtime DB.
79
+ * No withRef scope needed - direct update.
80
+ */
81
+ const advanceScheduledTriggerNextRunAt = (db) => async (params) => {
82
+ const set = {
83
+ nextRunAt: params.nextRunAt,
84
+ updatedAt: (/* @__PURE__ */ new Date()).toISOString()
85
+ };
86
+ if (params.enabled !== void 0) set.enabled = params.enabled;
87
+ 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)));
88
+ };
89
+
90
+ //#endregion
91
+ export { advanceScheduledTriggerNextRunAt, createScheduledTrigger, deleteScheduledTrigger, deleteScheduledTriggersByRunAsUserId, findDueScheduledTriggersAcrossProjects, getScheduledTriggerById, listScheduledTriggers, listScheduledTriggersPaginated, updateScheduledTrigger, upsertScheduledTrigger };
@@ -0,0 +1,11 @@
1
+ import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
2
+ import { SchedulerState } from "../../types/entities.js";
3
+
4
+ //#region src/data-access/runtime/schedulerState.d.ts
5
+ declare const getSchedulerState: (db: AgentsRunDatabaseClient) => () => Promise<SchedulerState | undefined>;
6
+ declare const upsertSchedulerState: (db: AgentsRunDatabaseClient) => (params: {
7
+ currentRunId: string;
8
+ }) => Promise<SchedulerState>;
9
+ declare const clearSchedulerState: (db: AgentsRunDatabaseClient) => () => Promise<void>;
10
+ //#endregion
11
+ export { clearSchedulerState, getSchedulerState, upsertSchedulerState };
@@ -0,0 +1,30 @@
1
+ import { schedulerState } from "../../db/runtime/runtime-schema.js";
2
+ import { eq, sql } from "drizzle-orm";
3
+
4
+ //#region src/data-access/runtime/schedulerState.ts
5
+ const SINGLETON_ID = "singleton";
6
+ const getSchedulerState = (db) => async () => {
7
+ return await db.query.schedulerState.findFirst({ where: eq(schedulerState.id, SINGLETON_ID) });
8
+ };
9
+ const upsertSchedulerState = (db) => async (params) => {
10
+ const [row] = await db.insert(schedulerState).values({
11
+ id: SINGLETON_ID,
12
+ currentRunId: params.currentRunId
13
+ }).onConflictDoUpdate({
14
+ target: schedulerState.id,
15
+ set: {
16
+ currentRunId: params.currentRunId,
17
+ updatedAt: sql`now()`.mapWith(String)
18
+ }
19
+ }).returning();
20
+ return row;
21
+ };
22
+ const clearSchedulerState = (db) => async () => {
23
+ await db.update(schedulerState).set({
24
+ currentRunId: null,
25
+ updatedAt: sql`now()`.mapWith(String)
26
+ }).where(eq(schedulerState.id, SINGLETON_ID));
27
+ };
28
+
29
+ //#endregion
30
+ export { clearSchedulerState, getSchedulerState, upsertSchedulerState };
@@ -7,20 +7,20 @@ import { TaskInsert, TaskSelect } from "../../types/entities.js";
7
7
 
8
8
  //#region src/data-access/runtime/tasks.d.ts
9
9
  declare const createTask: (db: AgentsRunDatabaseClient) => (params: TaskInsert) => Promise<{
10
+ tenantId: string;
11
+ projectId: string;
12
+ agentId: string;
13
+ subAgentId: string;
10
14
  id: string;
11
15
  createdAt: string;
12
16
  updatedAt: string;
17
+ status: string;
18
+ metadata: TaskMetadataConfig | null;
13
19
  ref: {
14
20
  type: "commit" | "tag" | "branch";
15
21
  name: string;
16
22
  hash: string;
17
23
  } | null;
18
- metadata: TaskMetadataConfig | null;
19
- status: string;
20
- tenantId: string;
21
- projectId: string;
22
- agentId: string;
23
- subAgentId: string;
24
24
  contextId: string;
25
25
  }>;
26
26
  declare const getTask: (db: AgentsRunDatabaseClient) => (params: {
@@ -1,4 +1,4 @@
1
- import { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, defineHandlers } from "./types.js";
1
+ import { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, SkippedDiff, defineHandlers } from "./types.js";
2
2
  import { audit } from "./audit.js";
3
3
  import { reconcile } from "./reconcile.js";
4
- export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, audit, defineHandlers, reconcile };
4
+ export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, SkippedDiff, audit, defineHandlers, reconcile };
@@ -1,12 +1,10 @@
1
1
  import { PinoLogger } from "../utils/logger.js";
2
2
  import { AgentsManageDatabaseClient } from "../db/manage/manage-client.js";
3
3
  import { AgentsRunDatabaseClient } from "../db/runtime/runtime-client.js";
4
- import { ScheduledTrigger } from "../validation/schemas.js";
5
4
  import { AgentSelect, ContextConfigSelect, SubAgentSelect, ToolSelect } from "../types/entities.js";
6
5
 
7
6
  //#region src/data-reconciliation/types.d.ts
8
7
  type EntityRowByTable = {
9
- scheduled_triggers: ScheduledTrigger;
10
8
  tools: ToolSelect;
11
9
  context_configs: ContextConfigSelect;
12
10
  agent: AgentSelect;
@@ -80,31 +78,6 @@ type AuditReport = {
80
78
  checkedEntities: string[];
81
79
  skippedEntities: string[];
82
80
  };
83
- type ScheduledTriggerAuditResult = {
84
- missingWorkflows: Array<{
85
- triggerId: string;
86
- triggerName: string;
87
- }>;
88
- orphanedWorkflows: Array<{
89
- workflowRunId: string;
90
- scheduledTriggerId: string;
91
- }>;
92
- staleWorkflows: Array<{
93
- triggerId: string;
94
- triggerName: string;
95
- workflowId: string;
96
- }>;
97
- deadWorkflows: Array<{
98
- triggerId: string;
99
- triggerName: string;
100
- workflowRunId: string;
101
- runStatus: string;
102
- }>;
103
- verificationFailures: Array<{
104
- workflowRunId: string;
105
- error: string;
106
- }>;
107
- };
108
81
  type OrphanedRuntimeRowsResult = {
109
82
  orphanedRows: Array<{
110
83
  table: string;
@@ -113,4 +86,4 @@ type OrphanedRuntimeRowsResult = {
113
86
  }>;
114
87
  };
115
88
  //#endregion
116
- export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, defineHandlers };
89
+ export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, SkippedDiff, defineHandlers };