@legatoacc3/workflow-builder 0.1.0-alpha.0

package/dist/session/create-builder-session.js

@@ -0,0 +1,670 @@
+import { defaultWorkflowCanvasConditionalBranches, getWorkflowCanvasNodeTemplate, workflowCanvasContainerStartHandleId, workflowCanvasDefaultOutputHandleId } from "@legatoacc3/workflow-canvas";
+import { createDraftMutation } from "@legatoacc3/workflow-canvas/commands";
+import { createWorkflowGraph } from "@legatoacc3/workflow-canvas/graph";
+import { buildGraphEdgeId, buildGraphNodeId } from "@legatoacc3/workflow-canvas/ids";
+//#region src/session/create-builder-session.ts
+var terminalNodeKinds = ["end", "answer"];
+var explicitWorkflowEndNodeKinds = ["end"];
+var containerNodeKinds = ["iteration", "loop"];
+var containerStartNodeKinds = ["iteration-start", "loop-start"];
+var userInputNodeKinds = ["start"];
+var triggerNodeKinds = ["schedule-trigger", "webhook-trigger"];
+var containerNodeSize = {
+	width: 760,
+	height: 280
+};
+var noteNodeSize = {
+	width: 180,
+	height: 120
+};
+var containerStartNodePosition = {
+	x: 28,
+	y: 144
+};
+var containerChildBounds = {
+	minX: 128,
+	minY: 100,
+	width: 240,
+	height: 132,
+	gutter: 56
+};
+var defaultIfElseBranches = defaultWorkflowCanvasConditionalBranches;
+var maxUndoStackSize = 50;
+var maxHistoryEntries = 30;
+function cloneDraft(draft) {
+	const nextDraft = {
+		...structuredClone({
+			...draft,
+			graphState: void 0
+		}),
+		graphState: createWorkflowGraph(draft.graphState)
+	};
+	normalizeAutoGeneratedNodeDescriptions(nextDraft);
+	normalizeContainerGraphState(nextDraft);
+	return nextDraft;
+}
+function isContainerNodeKind(kind) {
+	return kind ? containerNodeKinds.includes(kind) : false;
+}
+function isContainerStartNodeKind(kind) {
+	return kind ? containerStartNodeKinds.includes(kind) : false;
+}
+function isUserInputNodeKind(kind) {
+	return kind ? userInputNodeKinds.includes(kind) : false;
+}
+function isTriggerNodeKind(kind) {
+	return kind ? triggerNodeKinds.includes(kind) : false;
+}
+function isEntryNodeKind(kind) {
+	return isUserInputNodeKind(kind) || isTriggerNodeKind(kind);
+}
+function canCreateEntryNode(draft, kind) {
+	if (!isEntryNodeKind(kind)) return true;
+	const hasUserInputNode = draft.graphState.nodes.some((node) => isUserInputNodeKind(node.data?.kind));
+	const hasTriggerNode = draft.graphState.nodes.some((node) => isTriggerNodeKind(node.data?.kind));
+	if (isUserInputNodeKind(kind)) return !hasUserInputNode && !hasTriggerNode;
+	return !hasUserInputNode;
+}
+function canCreateInsideParent(draft, kind, parentNodeId) {
+	if (!parentNodeId) return true;
+	const parentNode = draft.graphState.nodes.find((node) => node.id === parentNodeId);
+	return Boolean(parentNode && isContainerNodeKind(parentNode.data?.kind) && !explicitWorkflowEndNodeKinds.includes(kind));
+}
+function getContainerStartNodeKind(containerKind) {
+	if (containerKind === "iteration") return "iteration-start";
+	if (containerKind === "loop") return "loop-start";
+	return null;
+}
+function getNodeParentId(node) {
+	return node.parentNodeId ?? node.parentNode;
+}
+function clamp(value, min, max) {
+	return Math.min(Math.max(value, min), max);
+}
+function parsePixelDimension(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "string") {
+		const parsed = Number.parseFloat(value);
+		return Number.isFinite(parsed) ? parsed : void 0;
+	}
+}
+function getContainerFrameSize(containerNode) {
+	if (!containerNode || !isContainerNodeKind(containerNode.data?.kind)) return containerNodeSize;
+	const style = containerNode.style;
+	return {
+		width: parsePixelDimension(style?.width) ?? containerNodeSize.width,
+		height: parsePixelDimension(style?.height) ?? containerNodeSize.height
+	};
+}
+function clampContainerChildPosition(position, containerNode) {
+	const frameSize = getContainerFrameSize(containerNode);
+	return {
+		x: clamp(position.x, containerChildBounds.minX, frameSize.width - containerChildBounds.width - containerChildBounds.gutter),
+		y: clamp(position.y, containerChildBounds.minY, Math.max(containerChildBounds.minY, frameSize.height - containerChildBounds.height - containerChildBounds.gutter))
+	};
+}
+function getDefaultSourceHandleId(sourceNode, requestedSourceHandleId) {
+	if (requestedSourceHandleId) return requestedSourceHandleId;
+	if (sourceNode && isContainerNodeKind(sourceNode.data?.kind)) return workflowCanvasDefaultOutputHandleId;
+	return requestedSourceHandleId;
+}
+function resolveEdgeSourceHandle(draft, sourceNodeId, targetNodeId, sourceHandleId) {
+	const sourceNode = draft.graphState.nodes.find((node) => node.id === sourceNodeId);
+	const targetNode = draft.graphState.nodes.find((node) => node.id === targetNodeId);
+	if (sourceHandleId === workflowCanvasContainerStartHandleId) return targetNode && getNodeParentId(targetNode) === sourceNodeId ? workflowCanvasContainerStartHandleId : workflowCanvasDefaultOutputHandleId;
+	if (!sourceHandleId && isContainerNodeKind(sourceNode?.data?.kind)) return workflowCanvasDefaultOutputHandleId;
+	return getDefaultSourceHandleId(sourceNode, sourceHandleId);
+}
+function buildContainerStartNodeId(containerNodeId) {
+	return `${containerNodeId}__start`;
+}
+function getContainerStartNode(draft, containerNodeId) {
+	return draft.graphState.nodes.find((node) => getNodeParentId(node) === containerNodeId && isContainerStartNodeKind(node.data?.kind));
+}
+function buildContainerStartNode(containerNode) {
+	const kind = getContainerStartNodeKind(containerNode.data?.kind);
+	if (!kind) return null;
+	return {
+		id: buildContainerStartNodeId(containerNode.id),
+		type: "default",
+		position: { ...containerStartNodePosition },
+		parentNode: containerNode.id,
+		parentNodeId: containerNode.id,
+		extent: "parent",
+		expandParent: false,
+		data: {
+			label: kind === "loop-start" ? "Loop Start" : "Iteration Start",
+			kind,
+			description: "Entry point for this sub-workflow."
+		}
+	};
+}
+function ensureContainerStartNodes(draft) {
+	const nextStartNodes = [];
+	for (const node of draft.graphState.nodes) {
+		if (!isContainerNodeKind(node.data?.kind) || getContainerStartNode(draft, node.id)) continue;
+		const startNode = buildContainerStartNode(node);
+		if (startNode) nextStartNodes.push(startNode);
+	}
+	draft.graphState.nodes.push(...nextStartNodes);
+}
+function normalizeContainerGraphState(draft) {
+	ensureContainerStartNodes(draft);
+	for (const node of draft.graphState.nodes) {
+		const parentNodeId = getNodeParentId(node);
+		if (!parentNodeId) continue;
+		node.parentNode = parentNodeId;
+		node.parentNodeId = parentNodeId;
+		node.extent = "parent";
+		node.expandParent = false;
+		const parentNode = draft.graphState.nodes.find((entry) => entry.id === parentNodeId);
+		node.position = isContainerStartNodeKind(node.data?.kind) ? { ...containerStartNodePosition } : clampContainerChildPosition(node.position, parentNode);
+	}
+	const seenEdgeKeys = /* @__PURE__ */ new Set();
+	const nextEdges = [];
+	for (const edge of draft.graphState.edges) {
+		const targetNode = draft.graphState.nodes.find((node) => node.id === edge.target);
+		const legacyContainerStart = edge.sourceHandle === workflowCanvasContainerStartHandleId;
+		const sourceNodeId = legacyContainerStart && targetNode && getNodeParentId(targetNode) === edge.source ? getContainerStartNode(draft, edge.source)?.id ?? edge.source : edge.source;
+		const sourceHandle = resolveEdgeSourceHandle(draft, sourceNodeId, edge.target, legacyContainerStart ? workflowCanvasDefaultOutputHandleId : edge.sourceHandle);
+		const edgeKey = `${sourceNodeId}:${sourceHandle ?? ""}->${edge.target}:${edge.targetHandle ?? ""}`;
+		if (seenEdgeKeys.has(edgeKey)) continue;
+		seenEdgeKeys.add(edgeKey);
+		nextEdges.push({
+			...edge,
+			id: buildGraphEdgeId(sourceNodeId, edge.target, sourceHandle),
+			source: sourceNodeId,
+			sourceHandle
+		});
+	}
+	draft.graphState.edges = nextEdges;
+}
+function buildHistoryId() {
+	return `history-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function formatHistoryTimestamp() {
+	return (/* @__PURE__ */ new Date()).toLocaleTimeString([], {
+		hour: "2-digit",
+		minute: "2-digit",
+		second: "2-digit"
+	});
+}
+function getMutationHistoryLabel(mutation) {
+	switch (mutation.type) {
+		case "nodes-repositioned": return "Moved node";
+		case "nodes-resized": return "Resized node";
+		case "node-remove-requested": return "Deleted node";
+		case "node-note-updated": return "Updated note";
+		case "node-label-updated": return "Updated node title";
+		case "conditional-branch-create-requested": return "Added ELIF case";
+		case "conditional-branch-remove-requested": return "Removed ELIF case";
+		case "edge-connected": return "Connected nodes";
+		case "edge-remove-requested": return "Deleted connection";
+		case "node-create-requested": return "Added node";
+		default: return "Updated canvas";
+	}
+}
+function isUndoableMutation(mutation) {
+	return !["selection-changed", "viewport-changed"].includes(mutation.type);
+}
+function buildBranchLabel(sourceHandleId) {
+	if (!sourceHandleId) return;
+	if (sourceHandleId === "if-branch") return "IF";
+	if (sourceHandleId === "else-branch") return "ELSE";
+	if (sourceHandleId === "elif-branch") return "ELIF 1";
+	const dynamicElifMatch = /^elif-branch-(\d+)$/.exec(sourceHandleId);
+	return dynamicElifMatch ? `ELIF ${dynamicElifMatch[1]}` : void 0;
+}
+function getElifBranchNumber(branchId) {
+	if (branchId === "elif-branch") return 1;
+	const dynamicElifMatch = /^elif-branch-(\d+)$/.exec(branchId);
+	return dynamicElifMatch ? Number(dynamicElifMatch[1]) : 0;
+}
+function buildNodePresentation(kind) {
+	const template = getWorkflowCanvasNodeTemplate(kind);
+	const presentation = {
+		labelBase: template.labelBase,
+		kind: template.kind,
+		description: template.description
+	};
+	if ("noteContent" in template && template.noteContent !== void 0) presentation.noteContent = template.noteContent;
+	return presentation;
+}
+function normalizeAutoGeneratedNodeDescriptions(draft) {
+	for (const node of draft.graphState.nodes) {
+		const kind = node.data?.kind;
+		if (!node.data || !kind || kind === "note") continue;
+		const generatedDescription = buildNodePresentation(kind).description;
+		if (node.data.description === generatedDescription) node.data = {
+			...node.data,
+			description: void 0
+		};
+	}
+}
+function buildWorkflowNode(draft, kind, position, parentNodeId) {
+	const kindCount = draft.graphState.nodes.filter((node) => node.data?.kind === kind).length + 1;
+	const presentation = buildNodePresentation(kind);
+	return {
+		id: buildGraphNodeId(kindCount, kind),
+		type: kind === "note" ? "default" : isEntryNodeKind(kind) ? "input" : terminalNodeKinds.includes(kind) ? "output" : "default",
+		position: parentNodeId ? isContainerStartNodeKind(kind) ? { ...containerStartNodePosition } : { ...position } : position,
+		parentNode: parentNodeId,
+		parentNodeId,
+		extent: parentNodeId ? "parent" : void 0,
+		expandParent: false,
+		data: {
+			label: `${presentation.labelBase} ${kindCount}`,
+			kind: presentation.kind,
+			description: kind === "note" ? presentation.description : void 0,
+			noteContent: "noteContent" in presentation ? presentation.noteContent : void 0,
+			conditionalBranches: kind === "if-else" ? structuredClone(defaultIfElseBranches) : void 0,
+			toolReferenceId: kind === "tool" ? void 0 : void 0,
+			toolReferenceLabel: kind === "tool" ? void 0 : void 0,
+			toolReferenceSource: kind === "tool" ? void 0 : void 0,
+			toolReferenceVersion: kind === "tool" ? void 0 : void 0
+		}
+	};
+}
+function buildEdge(sourceNodeId, targetNodeId, sourceHandleId) {
+	const branchLabel = buildBranchLabel(sourceHandleId);
+	return {
+		id: buildGraphEdgeId(sourceNodeId, targetNodeId, sourceHandleId),
+		source: sourceNodeId,
+		sourceHandle: sourceHandleId,
+		target: targetNodeId,
+		type: "default",
+		animated: false,
+		data: branchLabel ? { branchLabel } : void 0
+	};
+}
+function addConditionalBranchToDraft(draft, nodeId) {
+	const node = draft.graphState.nodes.find((entry) => entry.id === nodeId);
+	if (node?.data?.kind !== "if-else") return false;
+	const currentBranches = node.data.conditionalBranches?.length ? structuredClone(node.data.conditionalBranches) : structuredClone(defaultIfElseBranches);
+	const nextElifNumber = Math.max(0, ...currentBranches.map((branch) => getElifBranchNumber(branch.id))) + 1;
+	const nextBranch = {
+		id: nextElifNumber === 1 ? "elif-branch" : `elif-branch-${nextElifNumber}`,
+		type: "elif",
+		label: `ELIF ${nextElifNumber}`,
+		description: "Additional condition path"
+	};
+	const elseIndex = currentBranches.findIndex((branch) => branch.type === "else");
+	if (currentBranches.some((branch) => branch.id === nextBranch.id)) return false;
+	if (elseIndex === -1) currentBranches.push(nextBranch);
+	else currentBranches.splice(elseIndex, 0, nextBranch);
+	node.data = {
+		...node.data,
+		conditionalBranches: currentBranches
+	};
+	return true;
+}
+function removeConditionalBranchFromDraft(draft, nodeId, branchId) {
+	const node = draft.graphState.nodes.find((entry) => entry.id === nodeId);
+	if (node?.data?.kind !== "if-else") return false;
+	const currentBranches = node.data.conditionalBranches?.length ? structuredClone(node.data.conditionalBranches) : structuredClone(defaultIfElseBranches);
+	if (currentBranches.find((entry) => entry.id === branchId)?.type !== "elif") return false;
+	node.data = {
+		...node.data,
+		conditionalBranches: currentBranches.filter((entry) => entry.id !== branchId)
+	};
+	draft.graphState.edges = draft.graphState.edges.filter((edge) => !(edge.source === nodeId && edge.sourceHandle === branchId));
+	return true;
+}
+function appendStandaloneNode(draft, node) {
+	draft.graphState.nodes.push(node);
+	const startNode = buildContainerStartNode(node);
+	if (startNode) draft.graphState.nodes.push(startNode);
+}
+function buildAppendNodePosition(draft, sourceNode) {
+	const parentNodeId = getNodeParentId(sourceNode);
+	if (parentNodeId) {
+		const parentNode = draft.graphState.nodes.find((entry) => entry.id === parentNodeId);
+		if (isContainerStartNodeKind(sourceNode.data?.kind)) return clampContainerChildPosition({
+			x: containerChildBounds.minX,
+			y: containerChildBounds.minY
+		}, parentNode);
+		return clampContainerChildPosition({
+			x: sourceNode.position.x + containerChildBounds.width + containerChildBounds.gutter,
+			y: sourceNode.position.y
+		}, parentNode);
+	}
+	return {
+		x: sourceNode.position.x + 320,
+		y: sourceNode.position.y
+	};
+}
+function removeNodeFromDraft(draft, nodeId) {
+	const node = draft.graphState.nodes.find((entry) => entry.id === nodeId);
+	if (!node || isContainerStartNodeKind(node.data?.kind)) return false;
+	const removedNodeIds = new Set([nodeId]);
+	let didAddDescendant = true;
+	while (didAddDescendant) {
+		didAddDescendant = false;
+		for (const entry of draft.graphState.nodes) {
+			const parentNodeId = getNodeParentId(entry);
+			if (parentNodeId && removedNodeIds.has(parentNodeId) && !removedNodeIds.has(entry.id)) {
+				removedNodeIds.add(entry.id);
+				didAddDescendant = true;
+			}
+		}
+	}
+	draft.graphState.nodes = draft.graphState.nodes.filter((entry) => !removedNodeIds.has(entry.id));
+	draft.graphState.edges = draft.graphState.edges.filter((edge) => !removedNodeIds.has(edge.source) && !removedNodeIds.has(edge.target));
+	return true;
+}
+function appendNodeFromSource(draft, node, sourceNodeId, sourceHandleId, options = {}) {
+	const sourceNode = draft.graphState.nodes.find((entry) => entry.id === sourceNodeId);
+	if (sourceNode && !options.preserveExistingPosition) node.position = buildAppendNodePosition(draft, sourceNode);
+	draft.graphState.nodes.push(node);
+	const startNode = buildContainerStartNode(node);
+	if (startNode) draft.graphState.nodes.push(startNode);
+	const resolvedSourceHandleId = resolveEdgeSourceHandle(draft, sourceNodeId, node.id, sourceHandleId);
+	draft.graphState.edges = draft.graphState.edges.concat(buildEdge(sourceNodeId, node.id, resolvedSourceHandleId));
+}
+function prependNodeToTarget(draft, node, targetNodeId) {
+	const incomingEdges = draft.graphState.edges.filter((edge) => edge.target === targetNodeId);
+	if (incomingEdges.length > 1) return false;
+	draft.graphState.nodes.push(node);
+	const startNode = buildContainerStartNode(node);
+	if (startNode) draft.graphState.nodes.push(startNode);
+	const workflowNodeSourceHandleId = getDefaultSourceHandleId(node);
+	draft.graphState.edges = draft.graphState.edges.filter((edge) => edge.target !== targetNodeId).concat(incomingEdges.map((edge) => buildEdge(edge.source, node.id, resolveEdgeSourceHandle(draft, edge.source, node.id, edge.sourceHandle)))).concat(buildEdge(node.id, targetNodeId, workflowNodeSourceHandleId));
+	return true;
+}
+function cloneNodeData(data) {
+	return data ? structuredClone(data) : void 0;
+}
+function buildNodeDuplicate(draft, sourceNode) {
+	const nextKind = sourceNode.data?.kind ?? "approval";
+	const nextCount = draft.graphState.nodes.filter((node) => node.data?.kind === nextKind).length + 1;
+	const labelBase = buildNodePresentation(nextKind).labelBase;
+	const nextData = cloneNodeData(sourceNode.data);
+	if (nextData) nextData.label = `${labelBase} ${nextCount}`;
+	return {
+		...sourceNode,
+		id: buildGraphNodeId(nextCount, nextKind),
+		position: {
+			x: sourceNode.position.x + 48,
+			y: sourceNode.position.y + 48
+		},
+		data: nextData,
+		parentNode: void 0,
+		parentNodeId: void 0,
+		extent: void 0,
+		expandParent: false
+	};
+}
+function duplicateNodeInDraft(draft, nodeId) {
+	const sourceNode = draft.graphState.nodes.find((entry) => entry.id === nodeId);
+	if (!sourceNode || isContainerStartNodeKind(sourceNode.data?.kind)) return false;
+	appendStandaloneNode(draft, buildNodeDuplicate(draft, sourceNode));
+	return true;
+}
+function pasteNodeInDraft(draft, sourceNodeId, node, position) {
+	const nextKind = node.data?.kind ?? "approval";
+	const nextCount = draft.graphState.nodes.filter((entry) => entry.data?.kind === nextKind).length + 1;
+	const labelBase = buildNodePresentation(nextKind).labelBase;
+	const nextData = cloneNodeData(node.data);
+	if (nextData) nextData.label = `${labelBase} ${nextCount}`;
+	appendStandaloneNode(draft, {
+		...node,
+		id: buildGraphNodeId(nextCount, nextKind),
+		position,
+		data: nextData,
+		parentNode: void 0,
+		parentNodeId: void 0,
+		extent: void 0,
+		expandParent: false
+	});
+	return sourceNodeId !== "";
+}
+function changeNodeKindInDraft(draft, nodeId, nodeKind, toolReference) {
+	const node = draft.graphState.nodes.find((entry) => entry.id === nodeId);
+	if (!node || isContainerStartNodeKind(node.data?.kind)) return false;
+	const presentation = buildNodePresentation(nodeKind);
+	node.type = nodeKind === "note" ? "default" : isEntryNodeKind(nodeKind) ? "input" : terminalNodeKinds.includes(nodeKind) ? "output" : "default";
+	node.data = {
+		label: toolReference?.label ?? presentation.labelBase,
+		kind: presentation.kind,
+		description: toolReference?.description ?? presentation.description,
+		noteContent: "noteContent" in presentation ? presentation.noteContent : void 0,
+		conditionalBranches: nodeKind === "if-else" ? structuredClone(defaultIfElseBranches) : void 0,
+		toolReferenceId: nodeKind === "tool" ? toolReference?.id : void 0,
+		toolReferenceLabel: nodeKind === "tool" ? toolReference?.label : void 0,
+		toolReferenceSource: nodeKind === "tool" ? toolReference?.source : void 0,
+		toolReferenceVersion: nodeKind === "tool" ? toolReference?.version : void 0
+	};
+	return true;
+}
+function applyDraftGraphMutation(draft, mutation) {
+	switch (mutation.type) {
+		case "selection-changed": return false;
+		case "viewport-changed":
+			draft.graphState.viewport = mutation.payload.viewport;
+			return true;
+		case "nodes-repositioned":
+			for (const positionChange of mutation.payload.positions) {
+				const node = draft.graphState.nodes.find((entry) => entry.id === positionChange.id);
+				if (node) node.position = positionChange.position;
+			}
+			return true;
+		case "nodes-resized":
+			for (const sizeChange of mutation.payload.sizes) {
+				const node = draft.graphState.nodes.find((entry) => entry.id === sizeChange.id);
+				if (node && isContainerNodeKind(node.data?.kind)) node.style = {
+					...node.style ?? {},
+					width: `${Math.max(containerNodeSize.width, sizeChange.width)}px`,
+					height: `${Math.max(containerNodeSize.height, sizeChange.height)}px`
+				};
+				else if (node?.data?.kind === "note") node.style = {
+					...node.style ?? {},
+					width: `${Math.max(noteNodeSize.width, sizeChange.width)}px`,
+					height: `${Math.max(noteNodeSize.height, sizeChange.height)}px`
+				};
+			}
+			return true;
+		case "node-remove-requested": return removeNodeFromDraft(draft, mutation.payload.nodeId);
+		case "node-duplicate-requested": return duplicateNodeInDraft(draft, mutation.payload.nodeId);
+		case "node-paste-requested": return pasteNodeInDraft(draft, mutation.payload.sourceNodeId, mutation.payload.node, mutation.payload.position);
+		case "node-kind-change-requested": return changeNodeKindInDraft(draft, mutation.payload.nodeId, mutation.payload.nodeKind, mutation.payload.toolReference);
+		case "node-note-updated": {
+			const node = draft.graphState.nodes.find((entry) => entry.id === mutation.payload.nodeId);
+			if (!node || node.data?.kind !== "note") return false;
+			node.data = {
+				...node.data,
+				label: mutation.payload.label ?? node.data.label,
+				description: mutation.payload.noteContent ? node.data.description : "Write your note...",
+				noteContent: mutation.payload.noteContent
+			};
+			return true;
+		}
+		case "node-label-updated": {
+			const node = draft.graphState.nodes.find((entry) => entry.id === mutation.payload.nodeId);
+			if (!node?.data) return false;
+			node.data = {
+				...node.data,
+				label: mutation.payload.label
+			};
+			return true;
+		}
+		case "node-description-updated": {
+			const node = draft.graphState.nodes.find((entry) => entry.id === mutation.payload.nodeId);
+			if (!node?.data) return false;
+			node.data = {
+				...node.data,
+				description: mutation.payload.description
+			};
+			return true;
+		}
+		case "conditional-branch-create-requested": return addConditionalBranchToDraft(draft, mutation.payload.nodeId);
+		case "conditional-branch-remove-requested": return removeConditionalBranchFromDraft(draft, mutation.payload.nodeId, mutation.payload.branchId);
+		case "edge-connected": {
+			const sourceHandle = resolveEdgeSourceHandle(draft, mutation.payload.edge.source, mutation.payload.edge.target, mutation.payload.edge.sourceHandle);
+			const nextEdge = {
+				...mutation.payload.edge,
+				id: buildGraphEdgeId(mutation.payload.edge.source, mutation.payload.edge.target, sourceHandle),
+				sourceHandle,
+				data: buildBranchLabel(sourceHandle) ? { branchLabel: buildBranchLabel(sourceHandle) } : mutation.payload.edge.data
+			};
+			const exists = draft.graphState.edges.some((edge) => edge.source === nextEdge.source && edge.sourceHandle === nextEdge.sourceHandle && edge.target === nextEdge.target && edge.targetHandle === nextEdge.targetHandle);
+			if (!exists) draft.graphState.edges.push(nextEdge);
+			return !exists;
+		}
+		case "edge-remove-requested": {
+			const nextEdges = draft.graphState.edges.filter((edge) => edge.id !== mutation.payload.edgeId);
+			const didRemoveEdge = nextEdges.length !== draft.graphState.edges.length;
+			if (didRemoveEdge) draft.graphState.edges = nextEdges;
+			return didRemoveEdge;
+		}
+		case "node-create-requested": {
+			const isEntryNodeCreateRequest = isEntryNodeKind(mutation.payload.nodeKind);
+			if (!canCreateEntryNode(draft, mutation.payload.nodeKind) || !canCreateInsideParent(draft, mutation.payload.nodeKind, mutation.payload.parentNodeId) || isEntryNodeCreateRequest && (mutation.payload.parentNodeId || mutation.payload.appendFromNodeId || mutation.payload.insertBetween)) return false;
+			const workflowNode = buildWorkflowNode(draft, mutation.payload.nodeKind, mutation.payload.position, mutation.payload.parentNodeId);
+			if (mutation.payload.nodeKind === "tool" && mutation.payload.toolReference) {
+				const nodeData = workflowNode.data;
+				if (!nodeData) return false;
+				workflowNode.data = {
+					...nodeData,
+					kind: nodeData.kind,
+					label: mutation.payload.toolReference.label,
+					description: void 0,
+					toolReferenceId: mutation.payload.toolReference.id,
+					toolReferenceLabel: mutation.payload.toolReference.label,
+					toolReferenceSource: mutation.payload.toolReference.source,
+					toolReferenceVersion: mutation.payload.toolReference.version
+				};
+			}
+			if (mutation.payload.insertBetween) {
+				appendStandaloneNode(draft, workflowNode);
+				const insertedSourceHandleId = resolveEdgeSourceHandle(draft, mutation.payload.insertBetween.sourceNodeId, workflowNode.id, mutation.payload.insertBetween.sourceHandleId);
+				const workflowNodeSourceHandleId = getDefaultSourceHandleId(workflowNode);
+				draft.graphState.edges = draft.graphState.edges.filter((edge) => !(edge.source === mutation.payload.insertBetween?.sourceNodeId && resolveEdgeSourceHandle(draft, edge.source, edge.target, edge.sourceHandle) === insertedSourceHandleId && edge.target === mutation.payload.insertBetween?.targetNodeId)).concat([buildEdge(mutation.payload.insertBetween.sourceNodeId, workflowNode.id, insertedSourceHandleId), buildEdge(workflowNode.id, mutation.payload.insertBetween.targetNodeId, workflowNodeSourceHandleId)]);
+			} else if (mutation.payload.prependToNodeId) return prependNodeToTarget(draft, workflowNode, mutation.payload.prependToNodeId);
+			else if (mutation.payload.parentNodeId) if (mutation.payload.appendFromNodeId) appendNodeFromSource(draft, workflowNode, mutation.payload.appendFromNodeId, mutation.payload.appendFromHandleId, { preserveExistingPosition: true });
+			else appendStandaloneNode(draft, workflowNode);
+			else if (mutation.payload.appendFromNodeId) appendNodeFromSource(draft, workflowNode, mutation.payload.appendFromNodeId, mutation.payload.appendFromHandleId);
+			else appendStandaloneNode(draft, workflowNode);
+			return true;
+		}
+		default: return false;
+	}
+}
+function createBuilderSession(inputDraft) {
+	const undoStack = [];
+	const redoStack = [];
+	const state = {
+		draft: cloneDraft(inputDraft),
+		selectedNodeId: null,
+		saveState: "idle",
+		history: {
+			canUndo: false,
+			canRedo: false,
+			entries: []
+		}
+	};
+	function refreshHistoryState() {
+		state.history = {
+			...state.history,
+			canUndo: undoStack.length > 0,
+			canRedo: redoStack.length > 0
+		};
+	}
+	function prependHistoryEntry(label) {
+		state.history = {
+			...state.history,
+			entries: [{
+				id: buildHistoryId(),
+				label,
+				timestamp: formatHistoryTimestamp()
+			}, ...state.history.entries].slice(0, maxHistoryEntries)
+		};
+	}
+	function pushUndoSnapshot(previousDraft, mutation) {
+		undoStack.push(cloneDraft(previousDraft));
+		if (undoStack.length > maxUndoStackSize) undoStack.shift();
+		redoStack.length = 0;
+		prependHistoryEntry(getMutationHistoryLabel(mutation));
+		refreshHistoryState();
+	}
+	function resetHistory() {
+		undoStack.length = 0;
+		redoStack.length = 0;
+		state.history = {
+			canUndo: false,
+			canRedo: false,
+			entries: []
+		};
+	}
+	return {
+		state,
+		replaceDraft(nextDraft, options = {}) {
+			const selectedNodeId = state.selectedNodeId;
+			state.draft = cloneDraft(nextDraft);
+			state.selectedNodeId = options.preserveHistory && selectedNodeId && nextDraft.graphState.nodes.some((node) => node.id === selectedNodeId) ? selectedNodeId : null;
+			state.saveState = "idle";
+			if (!options.preserveHistory) resetHistory();
+			else refreshHistoryState();
+		},
+		updateMetadata(patch) {
+			state.draft = {
+				...state.draft,
+				metadata: {
+					...state.draft.metadata,
+					...patch
+				},
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+			};
+		},
+		applyCanvasMutation(mutation) {
+			if (mutation.type === "selection-changed") {
+				state.selectedNodeId = mutation.payload.nodeId;
+				return false;
+			}
+			const previousDraft = cloneDraft(state.draft);
+			const nextDraft = cloneDraft(state.draft);
+			const didChangeDraft = applyDraftGraphMutation(nextDraft, mutation);
+			if (didChangeDraft) {
+				normalizeContainerGraphState(nextDraft);
+				state.draft = {
+					...nextDraft,
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+				};
+				if (mutation.type === "node-remove-requested" && state.selectedNodeId === mutation.payload.nodeId) state.selectedNodeId = null;
+				if (isUndoableMutation(mutation)) pushUndoSnapshot(previousDraft, mutation);
+			}
+			return didChangeDraft;
+		},
+		undo() {
+			const previousDraft = undoStack.pop();
+			if (!previousDraft) {
+				refreshHistoryState();
+				return false;
+			}
+			redoStack.push(cloneDraft(state.draft));
+			state.draft = cloneDraft(previousDraft);
+			state.selectedNodeId = null;
+			prependHistoryEntry("Undid last change");
+			refreshHistoryState();
+			return true;
+		},
+		redo() {
+			const nextDraft = redoStack.pop();
+			if (!nextDraft) {
+				refreshHistoryState();
+				return false;
+			}
+			undoStack.push(cloneDraft(state.draft));
+			state.draft = cloneDraft(nextDraft);
+			state.selectedNodeId = null;
+			prependHistoryEntry("Redid last change");
+			refreshHistoryState();
+			return true;
+		},
+		clearSelection() {
+			state.selectedNodeId = null;
+			return createDraftMutation("selection-changed", { nodeId: null });
+		}
+	};
+}
+//#endregion
+export { createBuilderSession };