@inkeep/agents-core 0.0.0-dev-20260212154015 → 0.0.0-dev-20260212170401

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 (47) hide show
  1. package/dist/auth/auth.d.ts +18 -18
  2. package/dist/auth/permissions.d.ts +9 -9
  3. package/dist/client-exports.d.ts +10 -5
  4. package/dist/client-exports.js +2 -2
  5. package/dist/data-access/index.d.ts +4 -1
  6. package/dist/data-access/index.js +4 -1
  7. package/dist/data-access/manage/agentFull.js +116 -0
  8. package/dist/data-access/manage/agents.d.ts +42 -42
  9. package/dist/data-access/manage/agents.js +28 -0
  10. package/dist/data-access/manage/artifactComponents.d.ts +12 -12
  11. package/dist/data-access/manage/contextConfigs.d.ts +12 -12
  12. package/dist/data-access/manage/dataComponents.d.ts +6 -6
  13. package/dist/data-access/manage/functionTools.d.ts +14 -14
  14. package/dist/data-access/manage/scheduledTriggers.d.ts +80 -0
  15. package/dist/data-access/manage/scheduledTriggers.js +76 -0
  16. package/dist/data-access/manage/scheduledWorkflows.d.ts +29 -0
  17. package/dist/data-access/manage/scheduledWorkflows.js +32 -0
  18. package/dist/data-access/manage/skills.d.ts +13 -13
  19. package/dist/data-access/manage/subAgentExternalAgentRelations.d.ts +18 -18
  20. package/dist/data-access/manage/subAgentRelations.d.ts +26 -26
  21. package/dist/data-access/manage/subAgentTeamAgentRelations.d.ts +18 -18
  22. package/dist/data-access/manage/subAgents.d.ts +18 -18
  23. package/dist/data-access/manage/tools.d.ts +21 -21
  24. package/dist/data-access/runtime/apiKeys.d.ts +16 -16
  25. package/dist/data-access/runtime/conversations.d.ts +31 -31
  26. package/dist/data-access/runtime/messages.d.ts +18 -18
  27. package/dist/data-access/runtime/scheduledTriggerInvocations.d.ts +233 -0
  28. package/dist/data-access/runtime/scheduledTriggerInvocations.js +226 -0
  29. package/dist/data-access/runtime/tasks.d.ts +8 -8
  30. package/dist/db/manage/manage-schema.d.ts +534 -2
  31. package/dist/db/manage/manage-schema.js +128 -2
  32. package/dist/db/runtime/runtime-schema.d.ts +549 -281
  33. package/dist/db/runtime/runtime-schema.js +32 -2
  34. package/dist/index.d.ts +7 -4
  35. package/dist/index.js +7 -4
  36. package/dist/validation/dolt-schemas.d.ts +1 -1
  37. package/dist/validation/index.d.ts +2 -2
  38. package/dist/validation/index.js +2 -2
  39. package/dist/validation/schemas.d.ts +4232 -1605
  40. package/dist/validation/schemas.js +96 -3
  41. package/drizzle/manage/0009_chilly_old_lace.sql +39 -0
  42. package/drizzle/manage/meta/0009_snapshot.json +3670 -0
  43. package/drizzle/manage/meta/_journal.json +7 -0
  44. package/drizzle/runtime/0013_huge_white_queen.sql +19 -0
  45. package/drizzle/runtime/meta/0013_snapshot.json +3746 -0
  46. package/drizzle/runtime/meta/_journal.json +7 -0
  47. package/package.json +1 -1
@@ -0,0 +1,226 @@
1
+ import { scheduledTriggerInvocations } from "../../db/runtime/runtime-schema.js";
2
+ import { and, asc, count, desc, eq, gte, inArray, lte, ne, sql } from "drizzle-orm";
3
+
4
+ //#region src/data-access/runtime/scheduledTriggerInvocations.ts
5
+ /**
6
+ * Get a scheduled trigger invocation by ID (agent-scoped)
7
+ */
8
+ const getScheduledTriggerInvocationById = (db) => async (params) => {
9
+ 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)) });
10
+ };
11
+ /**
12
+ * Get a scheduled trigger invocation by idempotency key
13
+ * Used to check if an invocation already exists for a given schedule
14
+ */
15
+ const getScheduledTriggerInvocationByIdempotencyKey = (db) => async (params) => {
16
+ return await db.query.scheduledTriggerInvocations.findFirst({ where: eq(scheduledTriggerInvocations.idempotencyKey, params.idempotencyKey) });
17
+ };
18
+ /**
19
+ * List scheduled trigger invocations with optional filtering (agent-scoped)
20
+ */
21
+ const listScheduledTriggerInvocationsPaginated = (db) => async (params) => {
22
+ const page = params.pagination?.page || 1;
23
+ const limit = Math.min(params.pagination?.limit || 10, 100);
24
+ const offset = (page - 1) * limit;
25
+ const conditions = [
26
+ eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId),
27
+ eq(scheduledTriggerInvocations.projectId, params.scopes.projectId),
28
+ eq(scheduledTriggerInvocations.agentId, params.scopes.agentId),
29
+ eq(scheduledTriggerInvocations.scheduledTriggerId, params.scheduledTriggerId)
30
+ ];
31
+ if (params.filters?.status) conditions.push(eq(scheduledTriggerInvocations.status, params.filters.status));
32
+ if (params.filters?.from) conditions.push(gte(scheduledTriggerInvocations.scheduledFor, params.filters.from));
33
+ if (params.filters?.to) conditions.push(lte(scheduledTriggerInvocations.scheduledFor, params.filters.to));
34
+ const whereClause = and(...conditions);
35
+ 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)]);
36
+ const total = totalResult[0]?.count || 0;
37
+ return {
38
+ data,
39
+ pagination: {
40
+ page,
41
+ limit,
42
+ total,
43
+ pages: Math.ceil(total / limit)
44
+ }
45
+ };
46
+ };
47
+ /**
48
+ * List pending invocations for a trigger, ordered by scheduledFor (earliest first)
49
+ * Used by workflow to get the next invocation to execute
50
+ */
51
+ const listPendingScheduledTriggerInvocations = (db) => async (params) => {
52
+ const maxLimit = Math.min(params.limit || 10, 100);
53
+ 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);
54
+ };
55
+ /**
56
+ * Delete all pending invocations for a trigger
57
+ * Used when cron expression changes or trigger is disabled
58
+ */
59
+ const deletePendingInvocationsForTrigger = (db) => async (params) => {
60
+ 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;
61
+ };
62
+ /**
63
+ * Create a new scheduled trigger invocation (agent-scoped)
64
+ */
65
+ const createScheduledTriggerInvocation = (db) => async (params) => {
66
+ return (await db.insert(scheduledTriggerInvocations).values(params).returning())[0];
67
+ };
68
+ /**
69
+ * Update scheduled trigger invocation status (agent-scoped)
70
+ */
71
+ const updateScheduledTriggerInvocationStatus = (db) => async (params) => {
72
+ 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];
73
+ };
74
+ /**
75
+ * Mark invocation as running
76
+ */
77
+ const markScheduledTriggerInvocationRunning = (db) => async (params) => {
78
+ const now = (/* @__PURE__ */ new Date()).toISOString();
79
+ return (await db.update(scheduledTriggerInvocations).set({
80
+ status: "running",
81
+ startedAt: sql`COALESCE(${scheduledTriggerInvocations.startedAt}, ${now})`
82
+ }).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];
83
+ };
84
+ /**
85
+ * Mark invocation as completed
86
+ * Note: Will not update if status is already 'cancelled' to respect user cancellation
87
+ */
88
+ const markScheduledTriggerInvocationCompleted = (db) => async (params) => {
89
+ return (await db.update(scheduledTriggerInvocations).set({
90
+ status: "completed",
91
+ completedAt: (/* @__PURE__ */ new Date()).toISOString()
92
+ }).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];
93
+ };
94
+ /**
95
+ * Mark invocation as failed
96
+ * Note: Will not update if status is already 'cancelled' to respect user cancellation
97
+ */
98
+ const markScheduledTriggerInvocationFailed = (db) => async (params) => {
99
+ return (await db.update(scheduledTriggerInvocations).set({
100
+ status: "failed",
101
+ completedAt: (/* @__PURE__ */ new Date()).toISOString()
102
+ }).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];
103
+ };
104
+ /**
105
+ * Add a conversation ID to the invocation's conversationIds array
106
+ * Used to track all conversations created during retries
107
+ */
108
+ const addConversationIdToInvocation = (db) => async (params) => {
109
+ 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];
110
+ };
111
+ /**
112
+ * Mark invocation as cancelled
113
+ */
114
+ const markScheduledTriggerInvocationCancelled = (db) => async (params) => {
115
+ return (await db.update(scheduledTriggerInvocations).set({
116
+ status: "cancelled",
117
+ completedAt: (/* @__PURE__ */ new Date()).toISOString()
118
+ }).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];
119
+ };
120
+ /**
121
+ * Cancel all pending invocations for a trigger
122
+ * Used when a trigger is deleted
123
+ */
124
+ const cancelPendingInvocationsForTrigger = (db) => async (params) => {
125
+ return (await db.update(scheduledTriggerInvocations).set({
126
+ status: "cancelled",
127
+ completedAt: (/* @__PURE__ */ new Date()).toISOString()
128
+ }).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;
129
+ };
130
+ /**
131
+ * Cancel only PAST pending invocations for a trigger (scheduledFor <= now)
132
+ * Used when a trigger is disabled - keeps future invocations pending
133
+ */
134
+ const cancelPastPendingInvocationsForTrigger = (db) => async (params) => {
135
+ const now = (/* @__PURE__ */ new Date()).toISOString();
136
+ return (await db.update(scheduledTriggerInvocations).set({
137
+ status: "cancelled",
138
+ completedAt: now
139
+ }).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;
140
+ };
141
+ /**
142
+ * Get run info for multiple scheduled triggers in a single query
143
+ * Returns last run (completed/failed) and next pending run for each trigger
144
+ */
145
+ const getScheduledTriggerRunInfoBatch = (db) => async (params) => {
146
+ if (params.triggerIds.length === 0) return /* @__PURE__ */ new Map();
147
+ const { tenantId, projectId } = params.scopes;
148
+ const allInvocations = await db.select({
149
+ scheduledTriggerId: scheduledTriggerInvocations.scheduledTriggerId,
150
+ status: scheduledTriggerInvocations.status,
151
+ scheduledFor: scheduledTriggerInvocations.scheduledFor,
152
+ completedAt: scheduledTriggerInvocations.completedAt,
153
+ conversationIds: scheduledTriggerInvocations.conversationIds
154
+ }).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));
155
+ const result = /* @__PURE__ */ new Map();
156
+ for (const trigger of params.triggerIds) result.set(trigger.triggerId, {
157
+ lastRunAt: null,
158
+ lastRunStatus: null,
159
+ lastRunConversationIds: [],
160
+ nextRunAt: null
161
+ });
162
+ for (const inv of allInvocations) {
163
+ const triggerInfo = result.get(inv.scheduledTriggerId);
164
+ if (!triggerInfo) continue;
165
+ if (inv.status === "pending" && !triggerInfo.nextRunAt) triggerInfo.nextRunAt = inv.scheduledFor;
166
+ if ((inv.status === "completed" || inv.status === "failed") && !triggerInfo.lastRunAt) {
167
+ triggerInfo.lastRunAt = inv.completedAt;
168
+ triggerInfo.lastRunStatus = inv.status;
169
+ triggerInfo.lastRunConversationIds = inv.conversationIds || [];
170
+ }
171
+ }
172
+ return result;
173
+ };
174
+ /**
175
+ * List upcoming invocations across ALL triggers for an agent with pagination
176
+ * Used for the upcoming runs dashboard with full pagination support
177
+ */
178
+ const listUpcomingInvocationsForAgentPaginated = (db) => async (params) => {
179
+ const page = params.pagination?.page || 1;
180
+ const limit = Math.min(params.pagination?.limit || 20, 100);
181
+ const offset = (page - 1) * limit;
182
+ const statusCondition = params.includeRunning ? inArray(scheduledTriggerInvocations.status, ["pending", "running"]) : eq(scheduledTriggerInvocations.status, "pending");
183
+ const whereClause = and(...[
184
+ eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId),
185
+ eq(scheduledTriggerInvocations.projectId, params.scopes.projectId),
186
+ eq(scheduledTriggerInvocations.agentId, params.scopes.agentId),
187
+ statusCondition
188
+ ]);
189
+ 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)]);
190
+ const total = totalResult[0]?.count || 0;
191
+ return {
192
+ data,
193
+ pagination: {
194
+ page,
195
+ limit,
196
+ total,
197
+ pages: Math.ceil(total / limit)
198
+ }
199
+ };
200
+ };
201
+ /**
202
+ * List all invocations across ALL triggers for a PROJECT with pagination
203
+ * Used for the project-level invocations dashboard
204
+ */
205
+ const listProjectScheduledTriggerInvocationsPaginated = (db) => async (params) => {
206
+ const page = params.pagination?.page || 1;
207
+ const limit = Math.min(params.pagination?.limit || 20, 100);
208
+ const offset = (page - 1) * limit;
209
+ const conditions = [eq(scheduledTriggerInvocations.tenantId, params.scopes.tenantId), eq(scheduledTriggerInvocations.projectId, params.scopes.projectId)];
210
+ if (params.filters?.status) conditions.push(eq(scheduledTriggerInvocations.status, params.filters.status));
211
+ const whereClause = and(...conditions);
212
+ 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)]);
213
+ const total = totalResult[0]?.count || 0;
214
+ return {
215
+ data,
216
+ pagination: {
217
+ page,
218
+ limit,
219
+ total,
220
+ pages: Math.ceil(total / limit)
221
+ }
222
+ };
223
+ };
224
+
225
+ //#endregion
226
+ export { addConversationIdToInvocation, cancelPastPendingInvocationsForTrigger, cancelPendingInvocationsForTrigger, createScheduledTriggerInvocation, deletePendingInvocationsForTrigger, getScheduledTriggerInvocationById, getScheduledTriggerInvocationByIdempotencyKey, getScheduledTriggerRunInfoBatch, listPendingScheduledTriggerInvocations, listProjectScheduledTriggerInvocationsPaginated, listScheduledTriggerInvocationsPaginated, listUpcomingInvocationsForAgentPaginated, markScheduledTriggerInvocationCancelled, markScheduledTriggerInvocationCompleted, markScheduledTriggerInvocationFailed, markScheduledTriggerInvocationRunning, updateScheduledTriggerInvocationStatus };
@@ -7,20 +7,20 @@ import { TaskInsert, TaskSelect } from "../../types/entities.js";
7
7
  //#region src/data-access/runtime/tasks.d.ts
8
8
  declare const createTask: (db: AgentsRunDatabaseClient) => (params: TaskInsert) => Promise<{
9
9
  id: string;
10
- tenantId: string;
11
- projectId: string;
12
- agentId: string;
13
10
  createdAt: string;
14
11
  updatedAt: string;
15
- metadata: TaskMetadataConfig | null;
16
- status: string;
17
12
  ref: {
18
- type: "commit" | "tag" | "branch";
13
+ type: "tag" | "commit" | "branch";
19
14
  name: string;
20
15
  hash: string;
21
16
  } | null;
22
- subAgentId: string;
17
+ metadata: TaskMetadataConfig | null;
18
+ status: string;
19
+ agentId: string;
20
+ projectId: string;
21
+ tenantId: string;
23
22
  contextId: string;
23
+ subAgentId: string;
24
24
  }>;
25
25
  declare const getTask: (db: AgentsRunDatabaseClient) => (params: {
26
26
  id: string;
@@ -36,7 +36,7 @@ declare const updateTask: (db: AgentsRunDatabaseClient) => (params: {
36
36
  updatedAt: string;
37
37
  contextId: string;
38
38
  ref: {
39
- type: "commit" | "tag" | "branch";
39
+ type: "tag" | "commit" | "branch";
40
40
  name: string;
41
41
  hash: string;
42
42
  } | null;