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

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

@@ -20,12 +20,12 @@ declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string;
-  description: string | null;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
+  description: string | null;
   headers: Record<string, string> | null;
+  projectId: string;
+  tenantId: string;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
@@ -78,12 +78,12 @@ declare const listTools: (db: AgentsManageDatabaseClient) => (params: {
 declare const createTool: (db: AgentsManageDatabaseClient) => (params: ToolInsert) => Promise<{
   id: string;
   name: string;
-  description: string | null;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
+  description: string | null;
   headers: Record<string, string> | null;
+  projectId: string;
+  tenantId: string;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
@@ -134,13 +134,13 @@ declare const addToolToAgent: (db: AgentsManageDatabaseClient) => (params: {
   }> | null;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
-  toolId: string;
   headers: Record<string, string> | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  toolId: string;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
@@ -153,13 +153,13 @@ declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params:
   toolId: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
-  toolId: string;
   headers: Record<string, string> | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  toolId: string;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
@@ -181,13 +181,13 @@ declare const upsertSubAgentToolRelation: (db: AgentsManageDatabaseClient) => (p
   relationId?: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
-  toolId: string;
   headers: Record<string, string> | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  toolId: string;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
@@ -202,12 +202,12 @@ declare const upsertTool: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string;
-  description: string | null;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
+  description: string | null;
   headers: Record<string, string> | null;
+  projectId: string;
+  tenantId: string;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;

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

@@ -9,30 +9,30 @@ declare const getApiKeyById: (db: AgentsRunDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string | null;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  lastUsedAt: string | null;
   publicId: string;
   keyHash: string;
   keyPrefix: string;
-  lastUsedAt: string | null;
 } | undefined>;
 declare const getApiKeyByPublicId: (db: AgentsRunDatabaseClient) => (publicId: string) => Promise<{
   id: string;
   name: string | null;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  lastUsedAt: string | null;
   publicId: string;
   keyHash: string;
   keyPrefix: string;
-  lastUsedAt: string | null;
 } | undefined>;
 declare const listApiKeys: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
@@ -40,16 +40,16 @@ declare const listApiKeys: (db: AgentsRunDatabaseClient) => (params: {
 }) => Promise<{
   id: string;
   name: string | null;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  lastUsedAt: string | null;
   publicId: string;
   keyHash: string;
   keyPrefix: string;
-  lastUsedAt: string | null;
 }[]>;
 declare const listApiKeysPaginated: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
@@ -67,16 +67,16 @@ declare const listApiKeysPaginated: (db: AgentsRunDatabaseClient) => (params: {
 declare const createApiKey: (db: AgentsRunDatabaseClient) => (params: ApiKeyInsert) => Promise<{
   id: string;
   name: string | null;
-  tenantId: string;
-  projectId: string;
-  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
+  agentId: string;
+  projectId: string;
+  tenantId: string;
+  lastUsedAt: string | null;
   publicId: string;
   keyHash: string;
   keyPrefix: string;
-  lastUsedAt: string | null;
 }>;
 declare const updateApiKey: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;

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

@@ -16,19 +16,19 @@ declare const listConversations: (db: AgentsRunDatabaseClient) => (params: {
 }>;
 declare const createConversation: (db: AgentsRunDatabaseClient) => (params: ConversationInsert) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string | null;
-  title: string | null;
   createdAt: string;
   updatedAt: string;
-  metadata: ConversationMetadata | null;
-  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  metadata: ConversationMetadata | null;
+  title: string | null;
+  agentId: string | null;
+  projectId: string;
+  tenantId: string;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 }>;
@@ -43,7 +43,7 @@ declare const updateConversation: (db: AgentsRunDatabaseClient) => (params: {
   agentId: string | null;
   activeSubAgentId: string;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
@@ -69,7 +69,7 @@ declare const updateConversationActiveSubAgent: (db: AgentsRunDatabaseClient) =>
   agentId: string | null;
   activeSubAgentId: string;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
@@ -85,19 +85,19 @@ declare const getConversation: (db: AgentsRunDatabaseClient) => (params: {
   conversationId: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string | null;
-  title: string | null;
   createdAt: string;
   updatedAt: string;
-  metadata: ConversationMetadata | null;
-  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  metadata: ConversationMetadata | null;
+  title: string | null;
+  agentId: string | null;
+  projectId: string;
+  tenantId: string;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 } | undefined>;
@@ -107,7 +107,7 @@ declare const createOrGetConversation: (db: AgentsRunDatabaseClient) => (input:
   tenantId: string;
   id: string;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   };
@@ -121,19 +121,19 @@ declare const createOrGetConversation: (db: AgentsRunDatabaseClient) => (input:
   contextConfigId?: string | undefined;
 } | {
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string | null;
-  title: string | null;
   createdAt: string;
   updatedAt: string;
-  metadata: ConversationMetadata | null;
-  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  metadata: ConversationMetadata | null;
+  title: string | null;
+  agentId: string | null;
+  projectId: string;
+  tenantId: string;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 }>;
@@ -153,19 +153,19 @@ declare const getActiveAgentForConversation: (db: AgentsRunDatabaseClient) => (p
   conversationId: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
-  agentId: string | null;
-  title: string | null;
   createdAt: string;
   updatedAt: string;
-  metadata: ConversationMetadata | null;
-  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  metadata: ConversationMetadata | null;
+  title: string | null;
+  agentId: string | null;
+  projectId: string;
+  tenantId: string;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 } | undefined>;

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

@@ -10,25 +10,25 @@ declare const getMessageById: (db: AgentsRunDatabaseClient) => (params: {
   messageId: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
   metadata: MessageMetadata | null;
-  content: MessageContent;
   role: string;
+  projectId: string;
+  tenantId: string;
+  content: MessageContent;
+  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: {
@@ -141,25 +141,25 @@ declare const getVisibleMessages: (db: AgentsRunDatabaseClient) => (params: {
 }[]>;
 declare const createMessage: (db: AgentsRunDatabaseClient) => (params: MessageInsert) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
   metadata: MessageMetadata | null;
-  content: MessageContent;
   role: string;
+  projectId: string;
+  tenantId: string;
+  content: MessageContent;
+  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: {
@@ -194,25 +194,25 @@ declare const deleteMessage: (db: AgentsRunDatabaseClient) => (params: {
   messageId: string;
 }) => Promise<{
   id: string;
-  tenantId: string;
-  projectId: string;
   createdAt: string;
   updatedAt: string;
   metadata: MessageMetadata | null;
-  content: MessageContent;
   role: string;
+  projectId: string;
+  tenantId: string;
+  content: MessageContent;
+  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

@@ -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 };