@inkeep/agents-core 0.59.3 → 0.60.0

package/dist/db/runtime/runtime-schema.js

@@ -1,10 +1,12 @@
 import { __exportAll } from "../../_virtual/rolldown_runtime.js";
 import { account, deviceCode, invitation, member, organization, session, ssoProvider, user, verification } from "../../auth/auth-schema.js";
+import { USAGE_GENERATION_TYPES } from "../../constants/otel-attributes.js";
 import { relations } from "drizzle-orm";
 import { boolean, foreignKey, index, integer, jsonb, pgTable, primaryKey, text, timestamp, unique, uniqueIndex, varchar } from "drizzle-orm/pg-core";
 
 //#region src/db/runtime/runtime-schema.ts
 var runtime_schema_exports = /* @__PURE__ */ __exportAll({
+	USAGE_GENERATION_TYPES: () => USAGE_GENERATION_TYPES,
 	account: () => account,
 	apiKeys: () => apiKeys,
 	apps: () => apps,
@@ -150,6 +152,7 @@ const apps = pgTable("apps", {
 	type: varchar("type", { length: 64 }).$type().notNull(),
 	defaultProjectId: varchar("default_project_id", { length: 256 }),
 	defaultAgentId: varchar("default_agent_id", { length: 256 }),
+	prompt: text("prompt"),
 	enabled: boolean("enabled").notNull().default(true),
 	config: jsonb("config").$type().notNull(),
 	lastUsedAt: timestamp("last_used_at", { mode: "string" }),
@@ -822,4 +825,4 @@ const workAppSlackMcpToolAccessConfig = pgTable("work_app_slack_mcp_tool_access_
 ]);
 
 //#endregion
-export { account, apiKeys, apps, contextCache, conversations, conversationsRelations, datasetRun, datasetRunConversationRelations, deviceCode, evaluationResult, evaluationRun, invitation, ledgerArtifacts, ledgerArtifactsRelations, member, messages, messagesRelations, organization, projectMetadata, runtime_schema_exports, scheduledTriggerInvocations, session, ssoProvider, taskRelations, taskRelationsRelations, tasks, tasksRelations, triggerInvocations, user, userProfile, userProfileRelations, verification, workAppGitHubInstallations, workAppGitHubInstallationsRelations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubMcpToolRepositoryAccessRelations, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess, workAppGitHubProjectRepositoryAccessRelations, workAppGitHubRepositories, workAppGitHubRepositoriesRelations, workAppSlackChannelAgentConfigs, workAppSlackMcpToolAccessConfig, workAppSlackUserMappings, workAppSlackWorkspaces };
+export { USAGE_GENERATION_TYPES, account, apiKeys, apps, contextCache, conversations, conversationsRelations, datasetRun, datasetRunConversationRelations, deviceCode, evaluationResult, evaluationRun, invitation, ledgerArtifacts, ledgerArtifactsRelations, member, messages, messagesRelations, organization, projectMetadata, runtime_schema_exports, scheduledTriggerInvocations, session, ssoProvider, taskRelations, taskRelationsRelations, tasks, tasksRelations, triggerInvocations, user, userProfile, userProfileRelations, verification, workAppGitHubInstallations, workAppGitHubInstallationsRelations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubMcpToolRepositoryAccessRelations, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess, workAppGitHubProjectRepositoryAccessRelations, workAppGitHubRepositories, workAppGitHubRepositoriesRelations, workAppSlackChannelAgentConfigs, workAppSlackMcpToolAccessConfig, workAppSlackUserMappings, workAppSlackWorkspaces };

package/dist/db/runtime/test-runtime-client.js

@@ -57,7 +57,7 @@ async function closeTestRuntimeDatabase(db) {
 * This is a helper for tests that need organization records before creating projects/agents
 */
 async function createTestOrganization(db, tenantId) {
-	const slug = tenantId.replace(/^test-tenant-/, "").substring(0, 50);
+	const slug = tenantId.replace(/^test-tenant-/, "");
 	await db.insert(organization).values({
 		id: tenantId,
 		name: `Test Organization ${tenantId}`,

package/dist/dolt/advisory-lock.d.ts

@@ -0,0 +1,7 @@
+import { AgentsManageDatabaseClient } from "../db/manage/manage-client.js";
+
+//#region src/dolt/advisory-lock.d.ts
+declare const tryAdvisoryLock: (db: AgentsManageDatabaseClient) => (prefix: string, identifier: string) => Promise<boolean>;
+declare const releaseAdvisoryLock: (db: AgentsManageDatabaseClient) => (prefix: string, identifier: string) => Promise<void>;
+//#endregion
+export { releaseAdvisoryLock, tryAdvisoryLock };

package/dist/dolt/advisory-lock.js

@@ -0,0 +1,18 @@
+import { sql } from "drizzle-orm";
+import { createHash } from "node:crypto";
+
+//#region src/dolt/advisory-lock.ts
+function computeLockKey(prefix, identifier) {
+	return createHash("sha256").update(`${prefix}${identifier}`).digest().readBigInt64BE(0);
+}
+const tryAdvisoryLock = (db) => async (prefix, identifier) => {
+	const key = computeLockKey(prefix, identifier);
+	return (await db.execute(sql`SELECT pg_try_advisory_lock(CAST(${key} AS bigint)) as acquired`)).rows[0]?.acquired === true;
+};
+const releaseAdvisoryLock = (db) => async (prefix, identifier) => {
+	const key = computeLockKey(prefix, identifier);
+	await db.execute(sql`SELECT pg_advisory_unlock(CAST(${key} AS bigint))`);
+};
+
+//#endregion
+export { releaseAdvisoryLock, tryAdvisoryLock };

package/dist/dolt/branches-api.d.ts

@@ -5,6 +5,9 @@ import { AgentsManageDatabaseClient } from "../db/manage/manage-client.js";
 
 //#region src/dolt/branches-api.d.ts
 declare const MAIN_BRANCH_SUFFIX = "main";
+declare class invalidBranchParamsError extends Error {
+  constructor(message: string);
+}
 /**
  * Get the tenant-scoped main branch name
  */
@@ -13,24 +16,23 @@ declare const getTenantMainBranch: (tenantId: string) => string;
  * Check if a branch name (without tenant/project prefix) is a protected branch
  */
 declare const isProtectedBranchName: (branchName: string) => boolean;
+declare const getTempBranchSuffix: (prefix: string) => string;
+declare const isTempBranchName: (fullName: string) => boolean;
 type CreateBranchParams = {
   tenantId: string;
   projectId: string;
   name: string;
-  /** Branch to create from. Defaults to tenant main branch. */
-  from?: string;
+  /** Branch name to create from. Defaults to tenant main branch. */
+  fromBranch?: string;
+  /** Commit hash to create from. Mutually exclusive with fromBranch. */
+  fromCommit?: string;
   /**
    * Whether to sync schema on the source branch before creating.
    * This ensures the new branch starts with the latest schema from main.
-   * Default: true
+   * Default: true. Ignored when fromCommit is set.
    */
   syncSchemaOnSource?: boolean;
 };
-type DeleteBranchParams = {
-  tenantId: string;
-  projectId: string;
-  name: string;
-};
 type GetBranchParams = {
   tenantId: string;
   projectId: string;
@@ -79,6 +81,7 @@ type CheckoutBranchResult = {
  * @returns Function that takes checkout params and returns checkout result
  */
 declare const checkoutBranch: (db: AgentsManageDatabaseClient) => (params: CheckoutBranchParams) => Promise<CheckoutBranchResult>;
+declare const syncSchemaOnBranch: (db: AgentsManageDatabaseClient) => (branchName: string) => Promise<void>;
 /**
  * Create a new branch with optional schema synchronization.
  *
@@ -88,8 +91,15 @@ declare const checkoutBranch: (db: AgentsManageDatabaseClient) => (params: Check
  *
  * By syncing schema on the source branch first, we ensure the new branch
  * starts with the latest schema, avoiding schema conflicts later.
+ * If you want to create a branch from a commit hash, use the fromCommit parameter.
  */
 declare const createBranch: (db: AgentsManageDatabaseClient) => (params: CreateBranchParams) => Promise<BranchInfo>;
+type DeleteBranchParams = {
+  tenantId: string;
+  projectId: string;
+  branchName: string;
+  force?: boolean;
+};
 /**
  * Delete a branch
  */
@@ -106,4 +116,4 @@ declare const getBranch: (db: AgentsManageDatabaseClient) => (params: GetBranchP
 declare const listBranches: (db: AgentsManageDatabaseClient) => (params: ProjectScopeConfig) => Promise<BranchInfo[]>;
 declare const listBranchesForAgent: (db: AgentsManageDatabaseClient) => (params: AgentScopeConfig) => Promise<BranchInfo[]>;
 //#endregion
-export { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, GetBranchParams, MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTenantMainBranch, isProtectedBranchName, listBranches, listBranchesForAgent };
+export { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, GetBranchParams, MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTempBranchSuffix, getTenantMainBranch, invalidBranchParamsError, isProtectedBranchName, isTempBranchName, listBranches, listBranchesForAgent, syncSchemaOnBranch };

package/dist/dolt/branches-api.js

@@ -1,9 +1,16 @@
+import { doltHashOf } from "./commit.js";
 import { SCHEMA_SOURCE_BRANCH, ensureSchemaSync, getSchemaDiff, syncSchemaFromMain } from "./schema-sync.js";
 import { doltBranch, doltCheckout, doltDeleteBranch, doltGetBranchNamespace, doltListBranches } from "./branch.js";
 import { sql } from "drizzle-orm";
 
 //#region src/dolt/branches-api.ts
 const MAIN_BRANCH_SUFFIX = "main";
+var invalidBranchParamsError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "invalidBranchParamsError";
+	}
+};
 /**
 * Get the tenant-scoped main branch name
 */
@@ -14,6 +21,12 @@ const getTenantMainBranch = (tenantId) => `${tenantId}_${MAIN_BRANCH_SUFFIX}`;
 const isProtectedBranchName = (branchName) => {
 	return branchName === MAIN_BRANCH_SUFFIX;
 };
+const getTempBranchSuffix = (prefix) => {
+	return `temp-${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+};
+const isTempBranchName = (fullName) => {
+	return /temp-[a-z-]+_\d+_[a-z0-9]+$/.test(fullName);
+};
 /**
 * Checkout a branch with optional schema synchronization from main.
 *
@@ -49,6 +62,13 @@ const checkoutBranch = (db) => async (params) => {
 		}
 	};
 };
+const syncSchemaOnBranch = (db) => async (branchName) => {
+	if ((await getSchemaDiff(db)(branchName)).length > 0) {
+		await doltCheckout(db)({ branch: branchName });
+		const syncResult = await syncSchemaFromMain(db)({ autoCommitPending: true });
+		if (syncResult.error && !syncResult.synced) throw new Error(`Failed to sync schema on source branch '${branchName}': ${syncResult.error}`);
+	}
+};
 /**
 * Create a new branch with optional schema synchronization.
 *
@@ -58,55 +78,64 @@ const checkoutBranch = (db) => async (params) => {
 *
 * By syncing schema on the source branch first, we ensure the new branch
 * starts with the latest schema, avoiding schema conflicts later.
+* If you want to create a branch from a commit hash, use the fromCommit parameter.
 */
 const createBranch = (db) => async (params) => {
-	const { tenantId, projectId, name, from, syncSchemaOnSource = true } = params;
-	if (!name || name.trim() === "") throw new Error("Branch name cannot be empty");
+	const { tenantId, projectId, name, fromBranch, fromCommit, syncSchemaOnSource = true } = params;
+	if (fromBranch && fromCommit) throw new invalidBranchParamsError("Cannot specify both fromBranch and fromCommit");
+	if (!name || name.trim() === "") throw new invalidBranchParamsError("Branch name cannot be empty");
 	const fullName = doltGetBranchNamespace({
 		tenantId,
 		projectId,
 		branchName: name
 	})();
-	if ((await doltListBranches(db)()).some((b) => b.name === fullName)) throw new Error(`Branch '${name}' already exists`);
-	let fromFullBranchName;
-	if (from && from !== MAIN_BRANCH_SUFFIX) fromFullBranchName = doltGetBranchNamespace({
-		tenantId,
-		projectId,
-		branchName: from
-	})();
-	else fromFullBranchName = getTenantMainBranch(tenantId);
-	if (syncSchemaOnSource && fromFullBranchName !== SCHEMA_SOURCE_BRANCH) {
-		if ((await getSchemaDiff(db)(fromFullBranchName)).length > 0) {
-			await doltCheckout(db)({ branch: fromFullBranchName });
-			const syncResult = await syncSchemaFromMain(db)({ autoCommitPending: true });
-			if (syncResult.error && !syncResult.synced) throw new Error(`Failed to sync schema on source branch '${fromFullBranchName}': ${syncResult.error}`);
-		}
+	if ((await doltListBranches(db)()).some((b) => b.name === fullName)) throw new invalidBranchParamsError(`Branch '${name}' already exists`);
+	if (fromCommit) {
+		await doltBranch(db)({
+			name: fullName,
+			startPoint: fromCommit
+		});
+		if (syncSchemaOnSource) await syncSchemaOnBranch(db)(fullName);
+	} else {
+		let fromFullBranchName;
+		if (fromBranch) fromFullBranchName = doltGetBranchNamespace({
+			tenantId,
+			projectId,
+			branchName: fromBranch
+		})();
+		else fromFullBranchName = doltGetBranchNamespace({
+			tenantId,
+			projectId,
+			branchName: MAIN_BRANCH_SUFFIX
+		})();
+		if (syncSchemaOnSource && fromFullBranchName !== SCHEMA_SOURCE_BRANCH) await syncSchemaOnBranch(db)(fromFullBranchName);
+		await doltBranch(db)({
+			name: fullName,
+			startPoint: fromFullBranchName
+		});
 	}
-	await doltBranch(db)({
-		name: fullName,
-		startPoint: fromFullBranchName
-	});
-	const newBranch = (await doltListBranches(db)()).find((b) => b.name === fullName);
-	if (!newBranch) throw new Error("Failed to create branch");
 	return {
 		baseName: name,
 		fullName,
-		hash: newBranch.hash
+		hash: await doltHashOf(db)({ revision: fullName })
 	};
 };
 /**
 * Delete a branch
 */
 const deleteBranch = (db) => async (params) => {
-	const { tenantId, projectId, name } = params;
-	if (isProtectedBranchName(name)) throw new Error(`Cannot delete protected branch '${name}'`);
+	const { tenantId, projectId, branchName, force } = params;
+	if (isProtectedBranchName(branchName)) throw new invalidBranchParamsError(`Cannot delete protected branch '${branchName}'`);
 	const fullName = doltGetBranchNamespace({
 		tenantId,
 		projectId,
-		branchName: name
+		branchName
 	})();
-	if (!(await doltListBranches(db)()).some((b) => b.name === fullName)) throw new Error(`Branch '${name}' not found`);
-	await doltDeleteBranch(db)({ name: fullName });
+	if (!(await doltListBranches(db)()).some((b) => b.name === fullName)) throw new invalidBranchParamsError(`Branch '${branchName}' not found`);
+	await doltDeleteBranch(db)({
+		name: fullName,
+		force
+	});
 };
 /**
 * Get a single branch
@@ -159,4 +188,4 @@ const listBranchesForAgent = (db) => async (params) => {
 };
 
 //#endregion
-export { MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTenantMainBranch, isProtectedBranchName, listBranches, listBranchesForAgent };
+export { MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTempBranchSuffix, getTenantMainBranch, invalidBranchParamsError, isProtectedBranchName, isTempBranchName, listBranches, listBranchesForAgent, syncSchemaOnBranch };

package/dist/dolt/fk-map.d.ts

@@ -0,0 +1,5 @@
+//#region src/dolt/fk-map.d.ts
+type FkDeps = Record<string, string[]>;
+declare const manageFkDeps: FkDeps;
+//#endregion
+export { FkDeps, manageFkDeps };

package/dist/dolt/fk-map.js

@@ -0,0 +1,34 @@
+import { manage_schema_exports } from "../db/manage/manage-schema.js";
+import { getTableConfig } from "drizzle-orm/pg-core";
+
+//#region src/dolt/fk-map.ts
+function buildFkDepsFromSchema() {
+	const deps = {};
+	for (const value of Object.values(manage_schema_exports)) {
+		if (value == null || typeof value !== "object") continue;
+		let config;
+		try {
+			config = getTableConfig(value);
+		} catch {
+			continue;
+		}
+		if (!config?.name) continue;
+		const tableDeps = /* @__PURE__ */ new Set();
+		for (const fk of config.foreignKeys ?? []) {
+			const ref = fk.reference();
+			let refName;
+			try {
+				refName = getTableConfig(ref.foreignTable).name;
+			} catch {
+				continue;
+			}
+			if (refName && refName !== config.name) tableDeps.add(refName);
+		}
+		if (tableDeps.size > 0) deps[config.name] = [...tableDeps];
+	}
+	return deps;
+}
+const manageFkDeps = buildFkDepsFromSchema();
+
+//#endregion
+export { manageFkDeps };

package/dist/dolt/index.d.ts

@@ -1,10 +1,14 @@
+import { releaseAdvisoryLock, tryAdvisoryLock } from "./advisory-lock.js";
 import { branchScopes, doltActiveBranch, doltBranch, doltBranchExists, doltCheckout, doltDeleteBranch, doltGetBranchNamespace, doltListBranches, doltRenameBranch, ensureBranchExists } from "./branch.js";
-import { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, GetBranchParams, MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTenantMainBranch, isProtectedBranchName, listBranches, listBranchesForAgent } from "./branches-api.js";
+import { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, GetBranchParams, MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTempBranchSuffix, getTenantMainBranch, invalidBranchParamsError, isProtectedBranchName, isTempBranchName, listBranches, listBranchesForAgent, syncSchemaOnBranch } from "./branches-api.js";
 import { doltAdd, doltAddAndCommit, doltCommit, doltDeleteTag, doltHashOf, doltListTags, doltLog, doltReset, doltStatus, doltTag } from "./commit.js";
 import { doltDiff, doltDiffSummary } from "./diff.js";
-import { doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts } from "./merge.js";
+import { FkDeps, manageFkDeps } from "./fk-map.js";
+import { MergeConflictError, doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltPreviewMergeConflicts, doltPreviewMergeConflictsSummary, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts } from "./merge.js";
+import { PkMap, isValidManageTable, managePkMap } from "./pk-map.js";
 import { RefType, checkoutRef, getCurrentBranchOrCommit, getProjectMainResolvedRef, getProjectScopedRef, getTenantScopedRef, isRefWritable, isValidCommitHash, resolveProjectMainRefs, resolveRef } from "./ref-helpers.js";
-import { RefContext, RefMiddlewareOptions, createRefMiddleware, createWriteProtectionMiddleware, refMiddlewareFactory, writeProtectionMiddlewareFactory } from "./ref-middleware.js";
+import { RefContext, RefMiddlewareOptions, createRefMiddleware, createWriteProtectionMiddleware, isMergeRoute, refMiddlewareFactory, writeProtectionMiddlewareFactory } from "./ref-middleware.js";
 import { NestedRefScopeError, WithRefOptions, getCurrentRefScope, getRefScopedDb, isInRefScope, withRef } from "./ref-scope.js";
+import { ResolutionValidationError, applyResolutions, computeTableInsertOrder, sortByFkDependencyOrder } from "./resolve-conflicts.js";
 import { EnsureSchemaSyncOptions, SCHEMA_SOURCE_BRANCH, SchemaDiff, SchemaSyncOptions, SchemaSyncResult, areBranchesSchemaCompatible, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getSchemaDiff, hasSchemaDifferences, hasUncommittedChanges, isLocalhostUrl, syncSchemaFromMain } from "./schema-sync.js";
-export { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, EnsureSchemaSyncOptions, GetBranchParams, MAIN_BRANCH_SUFFIX, NestedRefScopeError, RefContext, RefMiddlewareOptions, RefType, SCHEMA_SOURCE_BRANCH, SchemaDiff, SchemaSyncOptions, SchemaSyncResult, WithRefOptions, areBranchesSchemaCompatible, branchScopes, checkoutBranch, checkoutRef, createBranch, createRefMiddleware, createWriteProtectionMiddleware, deleteBranch, doltAbortMerge, doltActiveBranch, doltAdd, doltAddAndCommit, doltBranch, doltBranchExists, doltCheckout, doltCommit, doltConflicts, doltDeleteBranch, doltDeleteTag, doltDiff, doltDiffSummary, doltGetBranchNamespace, doltHashOf, doltListBranches, doltListTags, doltLog, doltMerge, doltMergeStatus, doltRenameBranch, doltReset, doltResolveConflicts, doltSchemaConflicts, doltStatus, doltTableConflicts, doltTag, ensureBranchExists, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getBranch, getCurrentBranchOrCommit, getCurrentRefScope, getProjectMainResolvedRef, getProjectScopedRef, getRefScopedDb, getSchemaDiff, getTenantMainBranch, getTenantScopedRef, hasSchemaDifferences, hasUncommittedChanges, isInRefScope, isLocalhostUrl, isProtectedBranchName, isRefWritable, isValidCommitHash, listBranches, listBranchesForAgent, refMiddlewareFactory, resolveProjectMainRefs, resolveRef, syncSchemaFromMain, withRef, writeProtectionMiddlewareFactory };
+export { CheckoutBranchParams, CheckoutBranchResult, CreateBranchParams, DeleteBranchParams, EnsureSchemaSyncOptions, FkDeps, GetBranchParams, MAIN_BRANCH_SUFFIX, MergeConflictError, NestedRefScopeError, PkMap, RefContext, RefMiddlewareOptions, RefType, ResolutionValidationError, SCHEMA_SOURCE_BRANCH, SchemaDiff, SchemaSyncOptions, SchemaSyncResult, WithRefOptions, applyResolutions, areBranchesSchemaCompatible, branchScopes, checkoutBranch, checkoutRef, computeTableInsertOrder, createBranch, createRefMiddleware, createWriteProtectionMiddleware, deleteBranch, doltAbortMerge, doltActiveBranch, doltAdd, doltAddAndCommit, doltBranch, doltBranchExists, doltCheckout, doltCommit, doltConflicts, doltDeleteBranch, doltDeleteTag, doltDiff, doltDiffSummary, doltGetBranchNamespace, doltHashOf, doltListBranches, doltListTags, doltLog, doltMerge, doltMergeStatus, doltPreviewMergeConflicts, doltPreviewMergeConflictsSummary, doltRenameBranch, doltReset, doltResolveConflicts, doltSchemaConflicts, doltStatus, doltTableConflicts, doltTag, ensureBranchExists, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getBranch, getCurrentBranchOrCommit, getCurrentRefScope, getProjectMainResolvedRef, getProjectScopedRef, getRefScopedDb, getSchemaDiff, getTempBranchSuffix, getTenantMainBranch, getTenantScopedRef, hasSchemaDifferences, hasUncommittedChanges, invalidBranchParamsError, isInRefScope, isLocalhostUrl, isMergeRoute, isProtectedBranchName, isRefWritable, isTempBranchName, isValidCommitHash, isValidManageTable, listBranches, listBranchesForAgent, manageFkDeps, managePkMap, refMiddlewareFactory, releaseAdvisoryLock, resolveProjectMainRefs, resolveRef, sortByFkDependencyOrder, syncSchemaFromMain, syncSchemaOnBranch, tryAdvisoryLock, withRef, writeProtectionMiddlewareFactory };

package/dist/dolt/index.js

@@ -1,11 +1,15 @@
 import { doltAdd, doltAddAndCommit, doltCommit, doltDeleteTag, doltHashOf, doltListTags, doltLog, doltReset, doltStatus, doltTag } from "./commit.js";
-import { doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts } from "./merge.js";
+import { isValidManageTable, managePkMap } from "./pk-map.js";
+import { manageFkDeps } from "./fk-map.js";
+import { ResolutionValidationError, applyResolutions, computeTableInsertOrder, sortByFkDependencyOrder } from "./resolve-conflicts.js";
+import { MergeConflictError, doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltPreviewMergeConflicts, doltPreviewMergeConflictsSummary, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts } from "./merge.js";
 import { SCHEMA_SOURCE_BRANCH, areBranchesSchemaCompatible, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getSchemaDiff, hasSchemaDifferences, hasUncommittedChanges, isLocalhostUrl, syncSchemaFromMain } from "./schema-sync.js";
-import { MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTenantMainBranch, isProtectedBranchName, listBranches, listBranchesForAgent } from "./branches-api.js";
+import { MAIN_BRANCH_SUFFIX, checkoutBranch, createBranch, deleteBranch, getBranch, getTempBranchSuffix, getTenantMainBranch, invalidBranchParamsError, isProtectedBranchName, isTempBranchName, listBranches, listBranchesForAgent, syncSchemaOnBranch } from "./branches-api.js";
 import { checkoutRef, getCurrentBranchOrCommit, getProjectMainResolvedRef, getProjectScopedRef, getTenantScopedRef, isRefWritable, isValidCommitHash, resolveProjectMainRefs, resolveRef } from "./ref-helpers.js";
 import { doltActiveBranch, doltBranch, doltBranchExists, doltCheckout, doltDeleteBranch, doltGetBranchNamespace, doltListBranches, doltRenameBranch, ensureBranchExists } from "./branch.js";
+import { releaseAdvisoryLock, tryAdvisoryLock } from "./advisory-lock.js";
 import { doltDiff, doltDiffSummary } from "./diff.js";
-import { createRefMiddleware, createWriteProtectionMiddleware, refMiddlewareFactory, writeProtectionMiddlewareFactory } from "./ref-middleware.js";
+import { createRefMiddleware, createWriteProtectionMiddleware, isMergeRoute, refMiddlewareFactory, writeProtectionMiddlewareFactory } from "./ref-middleware.js";
 import { NestedRefScopeError, getCurrentRefScope, getRefScopedDb, isInRefScope, withRef } from "./ref-scope.js";
 
-export { MAIN_BRANCH_SUFFIX, NestedRefScopeError, SCHEMA_SOURCE_BRANCH, areBranchesSchemaCompatible, checkoutBranch, checkoutRef, createBranch, createRefMiddleware, createWriteProtectionMiddleware, deleteBranch, doltAbortMerge, doltActiveBranch, doltAdd, doltAddAndCommit, doltBranch, doltBranchExists, doltCheckout, doltCommit, doltConflicts, doltDeleteBranch, doltDeleteTag, doltDiff, doltDiffSummary, doltGetBranchNamespace, doltHashOf, doltListBranches, doltListTags, doltLog, doltMerge, doltMergeStatus, doltRenameBranch, doltReset, doltResolveConflicts, doltSchemaConflicts, doltStatus, doltTableConflicts, doltTag, ensureBranchExists, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getBranch, getCurrentBranchOrCommit, getCurrentRefScope, getProjectMainResolvedRef, getProjectScopedRef, getRefScopedDb, getSchemaDiff, getTenantMainBranch, getTenantScopedRef, hasSchemaDifferences, hasUncommittedChanges, isInRefScope, isLocalhostUrl, isProtectedBranchName, isRefWritable, isValidCommitHash, listBranches, listBranchesForAgent, refMiddlewareFactory, resolveProjectMainRefs, resolveRef, syncSchemaFromMain, withRef, writeProtectionMiddlewareFactory };
+export { MAIN_BRANCH_SUFFIX, MergeConflictError, NestedRefScopeError, ResolutionValidationError, SCHEMA_SOURCE_BRANCH, applyResolutions, areBranchesSchemaCompatible, checkoutBranch, checkoutRef, computeTableInsertOrder, createBranch, createRefMiddleware, createWriteProtectionMiddleware, deleteBranch, doltAbortMerge, doltActiveBranch, doltAdd, doltAddAndCommit, doltBranch, doltBranchExists, doltCheckout, doltCommit, doltConflicts, doltDeleteBranch, doltDeleteTag, doltDiff, doltDiffSummary, doltGetBranchNamespace, doltHashOf, doltListBranches, doltListTags, doltLog, doltMerge, doltMergeStatus, doltPreviewMergeConflicts, doltPreviewMergeConflictsSummary, doltRenameBranch, doltReset, doltResolveConflicts, doltSchemaConflicts, doltStatus, doltTableConflicts, doltTag, ensureBranchExists, ensureSchemaSync, formatSchemaDiffSummary, getActiveBranch, getBranch, getCurrentBranchOrCommit, getCurrentRefScope, getProjectMainResolvedRef, getProjectScopedRef, getRefScopedDb, getSchemaDiff, getTempBranchSuffix, getTenantMainBranch, getTenantScopedRef, hasSchemaDifferences, hasUncommittedChanges, invalidBranchParamsError, isInRefScope, isLocalhostUrl, isMergeRoute, isProtectedBranchName, isRefWritable, isTempBranchName, isValidCommitHash, isValidManageTable, listBranches, listBranchesForAgent, manageFkDeps, managePkMap, refMiddlewareFactory, releaseAdvisoryLock, resolveProjectMainRefs, resolveRef, sortByFkDependencyOrder, syncSchemaFromMain, syncSchemaOnBranch, tryAdvisoryLock, withRef, writeProtectionMiddlewareFactory };

package/dist/dolt/merge.d.ts

@@ -1,10 +1,24 @@
+import { ConflictResolution } from "../validation/dolt-schemas.js";
 import { AgentsManageDatabaseClient } from "../db/manage/manage-client.js";
 
 //#region src/dolt/merge.d.ts
-
+declare class MergeConflictError extends Error {
+  readonly conflictCount: number;
+  readonly fromBranch: string;
+  readonly toBranch: string;
+  constructor(message: string, conflictCount: number, fromBranch: string, toBranch: string);
+}
 /**
- * Merge another branch into the current branch
- * Returns merge status and handles conflicts by allowing commit with conflicts
+ * Merge a branch into the currently checked out branch.
+ *
+ * Runs inside an explicit transaction so that conflicts and
+ * constraint-violations are surfaced to the caller instead of being
+ * auto-rolled-back by Dolt's AUTOCOMMIT mode.
+ *
+ * If conflicts arise and `resolutions` are provided, they are applied
+ * and the merge is committed. If conflicts arise without resolutions
+ * (or with insufficient resolutions), the transaction is rolled back
+ * and a `MergeConflictError` is thrown.
  */
 declare const doltMerge: (db: AgentsManageDatabaseClient) => (params: {
   fromBranch: string;
@@ -15,8 +29,9 @@ declare const doltMerge: (db: AgentsManageDatabaseClient) => (params: {
     name: string;
     email: string;
   };
+  resolutions?: ConflictResolution[];
 }) => Promise<{
-  status: "success" | "conflicts";
+  status: "success";
   from: string;
   to: string;
   toHead?: string;
@@ -52,6 +67,27 @@ declare const doltTableConflicts: (db: AgentsManageDatabaseClient) => (params: {
  * Get schema conflicts
  */
 declare const doltSchemaConflicts: (db: AgentsManageDatabaseClient) => () => Promise<any[]>;
+/**
+ * Preview merge conflicts without modifying the database (dry-run).
+ * Returns a summary of which tables have conflicts.
+ */
+declare const doltPreviewMergeConflictsSummary: (db: AgentsManageDatabaseClient) => (params: {
+  baseBranch: string;
+  mergeBranch: string;
+}) => Promise<{
+  table: string;
+  numDataConflicts: number;
+  numSchemaConflicts: number;
+}[]>;
+/**
+ * Preview detailed merge conflicts for a specific table without modifying the database (dry-run).
+ * Returns the same column shape as dolt_conflicts_$table.
+ */
+declare const doltPreviewMergeConflicts: (db: AgentsManageDatabaseClient) => (params: {
+  baseBranch: string;
+  mergeBranch: string;
+  tableName: string;
+}) => Promise<Record<string, unknown>[]>;
 /**
  * Resolve conflicts for a table using a strategy
  */
@@ -60,4 +96,4 @@ declare const doltResolveConflicts: (db: AgentsManageDatabaseClient) => (params:
   strategy: "ours" | "theirs";
 }) => Promise<void>;
 //#endregion
-export { doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts };
+export { MergeConflictError, doltAbortMerge, doltConflicts, doltMerge, doltMergeStatus, doltPreviewMergeConflicts, doltPreviewMergeConflictsSummary, doltResolveConflicts, doltSchemaConflicts, doltTableConflicts };