@inkeep/agents-core 0.0.0-dev-20260312173738 → 0.0.0-dev-20260312190837

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

@@ -16,17 +16,17 @@ declare const listConversations: (db: AgentsRunDatabaseClient) => (params: {
   total: number;
 }>;
 declare const createConversation: (db: AgentsRunDatabaseClient) => (params: ConversationInsert) => Promise<{
-  metadata: ConversationMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  userId: string | null;
-  title: string | null;
-  tenantId: string;
-  projectId: string;
   agentId: string | null;
+  projectId: string;
+  tenantId: string;
+  title: string | null;
+  metadata: ConversationMetadata | null;
+  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
@@ -44,7 +44,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;
@@ -70,7 +70,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,17 +85,17 @@ declare const getConversation: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
   conversationId: string;
 }) => Promise<{
-  metadata: ConversationMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  userId: string | null;
-  title: string | null;
-  tenantId: string;
-  projectId: string;
   agentId: string | null;
+  projectId: string;
+  tenantId: string;
+  title: string | null;
+  metadata: ConversationMetadata | null;
+  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
@@ -108,7 +108,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,17 +121,17 @@ declare const createOrGetConversation: (db: AgentsRunDatabaseClient) => (input:
   metadata?: ConversationMetadata | null | undefined;
   contextConfigId?: string | undefined;
 } | {
-  metadata: ConversationMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  userId: string | null;
-  title: string | null;
-  tenantId: string;
-  projectId: string;
   agentId: string | null;
+  projectId: string;
+  tenantId: string;
+  title: string | null;
+  metadata: ConversationMetadata | null;
+  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
@@ -153,17 +153,17 @@ declare const getActiveAgentForConversation: (db: AgentsRunDatabaseClient) => (p
   scopes: ProjectScopeConfig;
   conversationId: string;
 }) => Promise<{
-  metadata: ConversationMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  userId: string | null;
-  title: string | null;
-  tenantId: string;
-  projectId: string;
   agentId: string | null;
+  projectId: string;
+  tenantId: string;
+  title: string | null;
+  metadata: ConversationMetadata | null;
+  userId: string | null;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;

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

@@ -10,14 +10,14 @@ declare const getMessageById: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
   messageId: string;
 }) => Promise<{
-  metadata: MessageMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  role: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
+  metadata: MessageMetadata | null;
   content: MessageContent;
+  role: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;
@@ -141,14 +141,14 @@ declare const getVisibleMessages: (db: AgentsRunDatabaseClient) => (params: {
   id: string;
 }[]>;
 declare const createMessage: (db: AgentsRunDatabaseClient) => (params: MessageInsert) => Promise<{
-  metadata: MessageMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  role: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
+  metadata: MessageMetadata | null;
   content: MessageContent;
+  role: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;
@@ -194,14 +194,14 @@ declare const deleteMessage: (db: AgentsRunDatabaseClient) => (params: {
   scopes: ProjectScopeConfig;
   messageId: string;
 }) => Promise<{
-  metadata: MessageMetadata | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  role: string;
-  tenantId: string;
   projectId: string;
+  tenantId: string;
+  metadata: MessageMetadata | null;
   content: MessageContent;
+  role: string;
   fromSubAgentId: string | null;
   toSubAgentId: string | null;
   fromExternalAgentId: string | null;

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

@@ -6,21 +6,21 @@ import { TaskInsert, TaskSelect } from "../../types/entities.js";
 
 //#region src/data-access/runtime/tasks.d.ts
 declare const createTask: (db: AgentsRunDatabaseClient) => (params: TaskInsert) => Promise<{
-  metadata: TaskMetadataConfig | null;
   id: string;
   createdAt: string;
   updatedAt: string;
-  status: string;
-  tenantId: string;
-  projectId: string;
   agentId: string;
+  projectId: string;
+  tenantId: string;
+  metadata: TaskMetadataConfig | null;
+  status: string;
   subAgentId: string;
+  contextId: string;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;
-  contextId: string;
 }>;
 declare const getTask: (db: AgentsRunDatabaseClient) => (params: {
   id: string;
@@ -36,7 +36,7 @@ declare const updateTask: (db: AgentsRunDatabaseClient) => (params: {
   updatedAt: string;
   contextId: string;
   ref: {
-    type: "commit" | "tag" | "branch";
+    type: "tag" | "commit" | "branch";
     name: string;
     hash: string;
   } | null;

package/dist/data-reconciliation/audit.d.ts

@@ -0,0 +1,6 @@
+import { AuditContext, AuditReport, EntityEffectRegistry } from "./types.js";
+
+//#region src/data-reconciliation/audit.d.ts
+declare function audit(registry: EntityEffectRegistry, ctx: AuditContext): Promise<AuditReport>;
+//#endregion
+export { audit };

package/dist/data-reconciliation/audit.js

@@ -0,0 +1,37 @@
+//#region src/data-reconciliation/audit.ts
+async function audit(registry, ctx) {
+	const report = {
+		entries: [],
+		checkedEntities: [],
+		skippedEntities: []
+	};
+	for (const [table, handlers] of Object.entries(registry)) {
+		if (!handlers?.check) {
+			report.skippedEntities.push(table);
+			continue;
+		}
+		report.checkedEntities.push(table);
+		try {
+			const result = await handlers.check(ctx);
+			report.entries.push({
+				table,
+				result
+			});
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			ctx.logger.warn({
+				table,
+				error: errorMessage
+			}, `Audit check failed for entity: ${table}`);
+			report.entries.push({
+				table,
+				result: null,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	return report;
+}
+
+//#endregion
+export { audit };

package/dist/data-reconciliation/index.d.ts

@@ -0,0 +1,4 @@
+import { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, defineHandlers } from "./types.js";
+import { audit } from "./audit.js";
+import { reconcile } from "./reconcile.js";
+export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, audit, defineHandlers, reconcile };

package/dist/data-reconciliation/index.js

@@ -0,0 +1,5 @@
+import { audit } from "./audit.js";
+import { reconcile } from "./reconcile.js";
+import { defineHandlers } from "./types.js";
+
+export { audit, defineHandlers, reconcile };

package/dist/data-reconciliation/reconcile.d.ts

@@ -0,0 +1,6 @@
+import { EntityDiff, EntityEffectRegistry, ReconcileContext, ReconcileResult } from "./types.js";
+
+//#region src/data-reconciliation/reconcile.d.ts
+declare function reconcile(registry: EntityEffectRegistry, diffs: EntityDiff[], ctx: ReconcileContext): Promise<ReconcileResult>;
+//#endregion
+export { reconcile };

package/dist/data-reconciliation/reconcile.js

@@ -0,0 +1,58 @@
+//#region src/data-reconciliation/reconcile.ts
+async function reconcile(registry, diffs, ctx) {
+	const result = {
+		applied: [],
+		skipped: [],
+		failed: []
+	};
+	const operations = diffs.map(async (diff) => {
+		const handlers = registry[diff.table];
+		if (!handlers) {
+			result.skipped.push({
+				table: diff.table,
+				operation: diff.operation,
+				primaryKey: diff.primaryKey,
+				reason: "no registry entry"
+			});
+			return;
+		}
+		try {
+			if (diff.operation === "insert" && handlers.onCreated && diff.after) await handlers.onCreated(diff.after, ctx);
+			else if (diff.operation === "update" && handlers.onUpdated && diff.before && diff.after) await handlers.onUpdated(diff.before, diff.after, ctx);
+			else if (diff.operation === "delete" && handlers.onDeleted && diff.before) await handlers.onDeleted(diff.before, ctx);
+			else {
+				result.skipped.push({
+					table: diff.table,
+					operation: diff.operation,
+					primaryKey: diff.primaryKey,
+					reason: `no handler for ${diff.operation}`
+				});
+				return;
+			}
+			result.applied.push({
+				table: diff.table,
+				operation: diff.operation,
+				primaryKey: diff.primaryKey
+			});
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			ctx.logger.error({
+				table: diff.table,
+				operation: diff.operation,
+				primaryKey: diff.primaryKey,
+				error: errorMessage
+			}, `Reconcile effect failed for ${diff.table}.${diff.operation}`);
+			result.failed.push({
+				table: diff.table,
+				operation: diff.operation,
+				primaryKey: diff.primaryKey,
+				error: errorMessage
+			});
+		}
+	});
+	await Promise.allSettled(operations);
+	return result;
+}
+
+//#endregion
+export { reconcile };

package/dist/data-reconciliation/types.d.ts

@@ -0,0 +1,116 @@
+import { PinoLogger } from "../utils/logger.js";
+import { AgentsManageDatabaseClient } from "../db/manage/manage-client.js";
+import { AgentsRunDatabaseClient } from "../db/runtime/runtime-client.js";
+import { ScheduledTrigger } from "../validation/schemas.js";
+import { AgentSelect, ContextConfigSelect, SubAgentSelect, ToolSelect } from "../types/entities.js";
+
+//#region src/data-reconciliation/types.d.ts
+type EntityRowByTable = {
+  scheduled_triggers: ScheduledTrigger;
+  tools: ToolSelect;
+  context_configs: ContextConfigSelect;
+  agent: AgentSelect;
+  sub_agents: SubAgentSelect;
+};
+type EntityOperation = 'insert' | 'update' | 'delete';
+type EntityDiff<TTable extends keyof EntityRowByTable = keyof EntityRowByTable> = {
+  table: TTable;
+  operation: 'insert';
+  primaryKey: Record<string, string>;
+  before: null;
+  after: EntityRowByTable[TTable];
+} | {
+  table: TTable;
+  operation: 'update';
+  primaryKey: Record<string, string>;
+  before: EntityRowByTable[TTable];
+  after: EntityRowByTable[TTable];
+} | {
+  table: TTable;
+  operation: 'delete';
+  primaryKey: Record<string, string>;
+  before: EntityRowByTable[TTable];
+  after: null;
+};
+type EntityEffectHandlers<TTable extends keyof EntityRowByTable> = {
+  onCreated?: (after: EntityRowByTable[TTable], ctx: ReconcileContext) => Promise<void>;
+  onUpdated?: (before: EntityRowByTable[TTable], after: EntityRowByTable[TTable], ctx: ReconcileContext) => Promise<void>;
+  onDeleted?: (before: EntityRowByTable[TTable], ctx: ReconcileContext) => Promise<void>;
+  check?: (ctx: AuditContext) => Promise<unknown>;
+};
+type EntityEffectRegistry = { [K in keyof EntityRowByTable]?: EntityEffectHandlers<K> };
+declare function defineHandlers<TTable extends keyof EntityRowByTable>(_table: TTable, handlers: EntityEffectHandlers<TTable>): EntityEffectHandlers<TTable>;
+type ReconcileContext = {
+  manageDb: AgentsManageDatabaseClient;
+  runDb: AgentsRunDatabaseClient;
+  scopes: {
+    tenantId: string;
+    projectId: string;
+  };
+  fullBranchName: string;
+  logger: PinoLogger;
+};
+type AuditContext = ReconcileContext;
+type AppliedEffect = {
+  table: string;
+  operation: EntityOperation;
+  primaryKey: Record<string, string>;
+};
+type FailedEffect = AppliedEffect & {
+  error: string;
+};
+type SkippedDiff = {
+  table: string;
+  operation: EntityOperation;
+  primaryKey: Record<string, string>;
+  reason: string;
+};
+type ReconcileResult = {
+  applied: AppliedEffect[];
+  skipped: SkippedDiff[];
+  failed: FailedEffect[];
+};
+type EntityAuditEntry<TResult = unknown> = {
+  table: string;
+  result: TResult;
+  error?: string;
+};
+type AuditReport = {
+  entries: EntityAuditEntry[];
+  checkedEntities: string[];
+  skippedEntities: string[];
+};
+type ScheduledTriggerAuditResult = {
+  missingWorkflows: Array<{
+    triggerId: string;
+    triggerName: string;
+  }>;
+  orphanedWorkflows: Array<{
+    workflowRunId: string;
+    scheduledTriggerId: string;
+  }>;
+  staleWorkflows: Array<{
+    triggerId: string;
+    triggerName: string;
+    workflowId: string;
+  }>;
+  deadWorkflows: Array<{
+    triggerId: string;
+    triggerName: string;
+    workflowRunId: string;
+    runStatus: string;
+  }>;
+  verificationFailures: Array<{
+    workflowRunId: string;
+    error: string;
+  }>;
+};
+type OrphanedRuntimeRowsResult = {
+  orphanedRows: Array<{
+    table: string;
+    id: string;
+    referencedEntityId: string;
+  }>;
+};
+//#endregion
+export { AppliedEffect, AuditContext, AuditReport, EntityAuditEntry, EntityDiff, EntityEffectHandlers, EntityEffectRegistry, EntityOperation, EntityRowByTable, FailedEffect, OrphanedRuntimeRowsResult, ReconcileContext, ReconcileResult, ScheduledTriggerAuditResult, SkippedDiff, defineHandlers };

package/dist/data-reconciliation/types.js

@@ -0,0 +1,7 @@
+//#region src/data-reconciliation/types.ts
+function defineHandlers(_table, handlers) {
+	return handlers;
+}
+
+//#endregion
+export { defineHandlers };