@plitzi/sdk-server 0.32.25 → 0.33.1

package/dist/modules/mcp/tools/operations/schema/bindings/patchBinding.js

@@ -1,36 +0,0 @@
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { bindingCategory, bindingInput } from "../shared.js";
-import { resolveElement } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/bindings/patchBinding.ts
-var patchBindingOp = z.object({
-	type: z.literal("patchBinding"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Element ref or id"),
-	category: bindingCategory,
-	to: z.string().describe("Target of the binding to patch"),
-	id: z.string().optional().describe("Match by id instead of to"),
-	source: bindingInput.shape.source.optional(),
-	transformers: bindingInput.shape.transformers,
-	when: bindingInput.shape.when,
-	enabled: bindingInput.shape.enabled
-}).describe("Partially update an EXISTING binding (matched by id when given, else by to): only the fields you pass change. Never creates — fails if no binding matches.");
-var patchBinding = (space, env, op) => {
-	const found = resolveElement(space, env, op.pageRef, op.ref);
-	if ("error" in found) return found.error;
-	const binding = (found.el.definition.bindings?.[op.category])?.find((b) => op.id ? b.id === op.id : b.to === op.to);
-	if (!binding) return fail("to", `No ${op.category} binding matching "${op.id ?? op.to}" on "${op.ref}"`, "Use upsertBinding to add it");
-	if (op.source !== void 0) binding.source = op.source;
-	if (op.transformers !== void 0) binding.transformers = op.transformers;
-	if (op.when !== void 0) binding.when = op.when;
-	if (op.enabled !== void 0) binding.enabled = op.enabled;
-	return {
-		...empty(),
-		updated: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { patchBinding, patchBindingOp };

package/dist/modules/mcp/tools/operations/schema/bindings/upsertBinding.js

@@ -1,47 +0,0 @@
-import { generateObjectId } from "../../../../helpers/space.js";
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty } from "../../../../helpers/opResult.js";
-import { bindingCategory, bindingInput } from "../shared.js";
-import { resolveElement } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/bindings/upsertBinding.ts
-var upsertBindingOp = z.object({
-	type: z.literal("upsertBinding"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Element ref or id"),
-	category: bindingCategory,
-	binding: bindingInput
-}).describe("Add a data binding to an element, or replace the one already feeding the same target (matched by binding.id when given, else by binding.to). Connects a data source to a prop, style value, or initialState key.");
-var upsertBinding = (space, env, op) => {
-	const found = resolveElement(space, env, op.pageRef, op.ref);
-	if ("error" in found) return found.error;
-	const bindings = found.el.definition.bindings ??= {};
-	const list = bindings[op.category] ??= [];
-	const index = list.findIndex((b) => op.binding.id ? b.id === op.binding.id : b.to === op.binding.to);
-	const binding = {
-		id: op.binding.id ?? (index >= 0 ? list[index].id : generateObjectId()),
-		to: op.binding.to,
-		source: op.binding.source
-	};
-	if (op.binding.transformers) binding.transformers = op.binding.transformers;
-	if (op.binding.when !== void 0) binding.when = op.binding.when;
-	if (op.binding.enabled !== void 0) binding.enabled = op.binding.enabled;
-	if (index >= 0) {
-		list[index] = binding;
-		return {
-			...empty(),
-			updated: 1,
-			staleResources: [pageUri(env, op.pageRef)],
-			elementRefs: [op.ref]
-		};
-	}
-	list.push(binding);
-	return {
-		...empty(),
-		created: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { upsertBinding, upsertBindingOp };

package/dist/modules/mcp/tools/operations/schema/elements/deleteElement.js

@@ -1,29 +0,0 @@
-import { descendantIds, findPageByRef, indexRemoveElements, resolveRef } from "../../../../helpers/space.js";
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { removeFromParent } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/elements/deleteElement.ts
-var deleteElementOp = z.object({
-	type: z.literal("deleteElement"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Ref or id of the element to delete")
-}).describe("Delete an element and all of its descendants from a page.");
-var deleteElement = (space, env, op) => {
-	const page = findPageByRef(space.schema, op.pageRef);
-	if (!page) return fail("pageRef", `Page "${op.pageRef}" not found`, "Read the pages resource for valid refs");
-	const el = resolveRef(space.schema, page, op.ref);
-	if (!el || el.id === page.id) return fail("ref", `Element "${op.ref}" not found in page "${op.pageRef}"`, "Read the page resource for valid refs");
-	const ids = [...descendantIds(space.schema, el.id), el.id];
-	const removed = ids.map((id) => space.schema.flat[id]);
-	for (const id of ids) Reflect.deleteProperty(space.schema.flat, id);
-	removeFromParent(space, el);
-	indexRemoveElements(space.schema, removed);
-	return {
-		...empty(),
-		deleted: 1,
-		staleResources: [pageUri(env, op.pageRef)]
-	};
-};
-//#endregion
-export { deleteElement, deleteElementOp };

package/dist/modules/mcp/tools/operations/schema/elements/moveElement.js

@@ -1,41 +0,0 @@
-import { findPageByRef, indexInvalidateDetails, resolveRef } from "../../../../helpers/space.js";
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { position } from "../shared.js";
-import { placeChild, removeFromParent } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/elements/moveElement.ts
-var moveElementOp = z.object({
-	type: z.literal("moveElement"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Ref or id of the element to move"),
-	toParentRef: z.string().describe("Ref or id of the anchor the element moves relative to (see position)"),
-	position
-}).describe("Move an existing element to a new parent, or reorder it — its placement is set by position.");
-var moveElement = (space, env, op) => {
-	const page = findPageByRef(space.schema, op.pageRef);
-	if (!page) return fail("pageRef", `Page "${op.pageRef}" not found`, "Read the pages resource for valid refs");
-	const el = resolveRef(space.schema, page, op.ref);
-	const anchor = resolveRef(space.schema, page, op.toParentRef);
-	if (!el || el.id === page.id) return fail("ref", `Element "${op.ref}" not found`, "Read the page resource for valid refs");
-	if (!anchor) return fail("toParentRef", `Target "${op.toParentRef}" not found`, "Read the page resource for valid refs");
-	removeFromParent(space, el);
-	let parent = anchor;
-	let index;
-	if (op.position === "before" || op.position === "after") {
-		parent = anchor.definition.parentId ? space.schema.flat[anchor.definition.parentId] ?? page : page;
-		const at = (parent.definition.items ?? []).indexOf(anchor.id);
-		index = at < 0 ? void 0 : op.position === "after" ? at + 1 : at;
-	}
-	el.definition.parentId = parent.id;
-	placeChild(parent, el.id, index);
-	indexInvalidateDetails(space.schema);
-	return {
-		...empty(),
-		updated: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { moveElement, moveElementOp };

package/dist/modules/mcp/tools/operations/schema/elements/patchElement.js

@@ -1,58 +0,0 @@
-import { findPageByRef, resolveRef } from "../../../../helpers/space.js";
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { initialStateInput, styleRefs } from "../shared.js";
-import { guardNewRef, writeInitialState } from "../write.js";
-import { z } from "zod";
-import { repointIdRefs } from "@plitzi/sdk-schema/helpers/idRef";
-//#region src/modules/mcp/tools/operations/schema/elements/patchElement.ts
-var patchElementOp = z.object({
-	type: z.literal("patchElement"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Existing element ref or id"),
-	idRef: z.string().optional().describe("Assign or rename this element idRef ([A-Za-z0-9_-], starting with a letter, unique in the space). Without one an element publishes no data source, so it is not bindable. A rename moves the source name with it: every binding and interaction that targeted the old one is repointed for you."),
-	label: z.string().optional(),
-	subType: z.string().optional(),
-	props: z.record(z.string(), z.unknown()).optional().describe("Merged onto existing props: listed keys change, null unsets a key, others are preserved"),
-	style: styleRefs.optional().describe("Merged onto existing style: base replaces base, listed slots replace slots"),
-	initialState: initialStateInput.optional().describe("Merged onto existing initialState: styleVariant overlays per class/selector, visibility overrides")
-}).describe("Partially update an EXISTING element: only the fields you pass change (props/style/initialState are merged, not replaced). Never creates — fails if ref does not resolve. Use upsertElement to create or fully replace.");
-var patchElement = (space, env, op) => {
-	const page = findPageByRef(space.schema, op.pageRef);
-	if (!page) return fail("pageRef", `Page "${op.pageRef}" not found`, "Read plitzi://schema/" + env + "/pages for valid refs");
-	const el = resolveRef(space.schema, page, op.ref);
-	if (!el || el.id === page.id) return fail("ref", `Element "${op.ref}" not found in page "${op.pageRef}"`, "patchElement only updates an existing element; use upsertElement to create one");
-	if (op.idRef !== void 0 && op.idRef !== el.idRef) {
-		const guard = guardNewRef(space, op.idRef, "idRef");
-		if (guard) return guard;
-		const previous = el.idRef;
-		el.idRef = op.idRef;
-		if (previous) repointIdRefs(space.schema.flat, { [previous]: op.idRef });
-	}
-	if (op.label !== void 0) el.definition.label = op.label;
-	if (op.subType !== void 0) el.attributes = {
-		...el.attributes,
-		subType: op.subType
-	};
-	if (op.props !== void 0) {
-		const merged = { ...el.attributes };
-		for (const [key, value] of Object.entries(op.props)) if (value === null) Reflect.deleteProperty(merged, key);
-		else merged[key] = value;
-		el.attributes = merged;
-	}
-	if (op.style !== void 0) {
-		const selectors = { ...el.definition.styleSelectors };
-		if (op.style.base !== void 0) selectors.base = op.style.base.join(" ");
-		for (const [slot, classes] of Object.entries(op.style.slots ?? {})) selectors[slot] = classes.join(" ");
-		el.definition.styleSelectors = selectors;
-	}
-	if (op.initialState !== void 0) writeInitialState(el, op.initialState, true);
-	return {
-		...empty(),
-		updated: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { patchElement, patchElementOp };

package/dist/modules/mcp/tools/operations/schema/elements/repeatElement.js

@@ -1,148 +0,0 @@
-import { elementInput, elementShape, position, styleRefs } from "../shared.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/elements/repeatElement.ts
-var item = z.record(z.string(), z.unknown());
-var MAX_ITEMS = 100;
-var MAX_ROWS = 500;
-var templateElement = z.lazy(() => z.object({
-	...elementShape,
-	children: z.array(templateElement).optional(),
-	repeat: z.object({
-		items: z.string().describe("The row field holding the sub-list, as \"{{item.<field>}}\" (or just the field path)"),
-		template: elementInput.describe("Rendered once per entry of that sub-list (a plain element tree)")
-	}).optional().describe("Makes THIS element the wrapper of a nested list — a list inside each row")
-}));
-var repeatElementOp = z.object({
-	type: z.literal("repeatElement"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Ref of the WRAPPER element this creates; the rows become its children"),
-	elementType: z.string().optional().describe("Type of the wrapper; defaults to container"),
-	label: z.string().optional(),
-	style: styleRefs.optional().describe("Classes for the wrapper — this is where the row/grid layout goes"),
-	parentRef: z.string().optional().describe("Anchor ref/id; defaults to page root"),
-	position: position.optional(),
-	template: templateElement.describe("The subtree ONE row renders, with {{item.field}} placeholders"),
-	items: z.array(item).min(1).max(MAX_ITEMS).describe("One object per row; its fields fill the {{item.field}} placeholders of the template")
-}).describe("Build a LIST from one template plus its `items` data, instead of repeating near-identical elements. Creates a wrapper whose children are the template rendered once per row. `{{item.<field>}}` is replaced by that row field — alone as the whole value it keeps the field type, mixed with text it interpolates. Every ref gets the row number appended (\"day\" → \"day-1\"), which is how you address a row later. A template node may carry `repeat: { items: \"{{item.<list>}}\", template: … }` to nest a list inside each row: it becomes the sub-list wrapper, refs number both levels (\"step-2-3\"), and `{{item.…}}` there reads the SUB-row. Other {{…}} names are untouched, so schema variables still work.");
-var PLACEHOLDER = /\{\{\s*item\.([A-Za-z0-9_.-]+)\s*\}\}/g;
-var WHOLE_PLACEHOLDER = /^\{\{\s*item\.([A-Za-z0-9_.-]+)\s*\}\}$/;
-var lookup = (row, path) => path.split(".").reduce((value, key) => {
-	if (value === null || typeof value !== "object") return;
-	return value[key];
-}, row);
-/** One string of the template, with its placeholders resolved. A placeholder that IS the whole string yields the
-*  field's own value (a number stays a number, an array stays an array); mixed text interpolates. */
-var fillString = (text, row) => {
-	const whole = WHOLE_PLACEHOLDER.exec(text);
-	if (whole) {
-		const value = lookup(row, whole[1]);
-		return value === void 0 ? {
-			value: text,
-			missing: whole[1]
-		} : { value };
-	}
-	let missing;
-	const value = text.replace(PLACEHOLDER, (match, path) => {
-		const found = lookup(row, path);
-		if (found === void 0) {
-			missing ??= path;
-			return match;
-		}
-		if (typeof found === "string") return found;
-		return typeof found === "number" || typeof found === "boolean" ? found.toString() : JSON.stringify(found);
-	});
-	return missing === void 0 ? { value } : {
-		value,
-		missing
-	};
-};
-var fillValue = (value, row, missing) => {
-	if (typeof value === "string") {
-		const filled = fillString(value, row);
-		if (filled.missing) missing.add(filled.missing);
-		return filled.value;
-	}
-	if (Array.isArray(value)) return value.map((entry) => fillValue(entry, row, missing));
-	if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, fillValue(entry, row, missing)]));
-	return value;
-};
-var listOf = (row, spec) => {
-	const whole = WHOLE_PLACEHOLDER.exec(spec);
-	const value = lookup(row, whole ? whole[1] : spec);
-	if (!Array.isArray(value)) return;
-	return value.map((entry) => entry !== null && typeof entry === "object" ? entry : { value: entry });
-};
-/** One template node against one row. `suffix` is the row numbering accumulated from the OUTSIDE in, so a nested
-*  row reads "step-2-3" (row 2, sub-row 3) rather than the other way round. */
-var expandNode = (node, row, suffix, state) => {
-	const { children, repeat, ...own } = node;
-	const filled = fillValue(own, row, state.missing);
-	const element = {
-		...filled,
-		ref: `${filled.ref}${suffix}`
-	};
-	if (repeat) {
-		const rows = listOf(row, repeat.items);
-		if (!rows) {
-			state.notAList.add(repeat.items);
-			return element;
-		}
-		const capped = rows.slice(0, MAX_ITEMS);
-		state.rows += capped.length;
-		element.children = capped.map((subRow, index) => expandNode(repeat.template, subRow, `${suffix}-${index + 1}`, state));
-		return element;
-	}
-	if (children) element.children = children.map((child) => expandNode(child, row, suffix, state));
-	return element;
-};
-var rowError = (index, message, hint) => ({
-	path: `items[${index}]`,
-	message,
-	hint
-});
-var keysOf = (row) => Object.keys(row).join(", ") || "(nothing)";
-/** Expand one repeat into the single upsertElement it stands for: the wrapper, with the template rendered once per
-*  row as its children. Returns the errors instead of throwing, so a bad row reads like every other op error. */
-var expandRepeat = (op) => {
-	const errors = [];
-	const children = [];
-	let total = op.items.length;
-	for (const [index, row] of op.items.entries()) {
-		const state = {
-			missing: /* @__PURE__ */ new Set(),
-			notAList: /* @__PURE__ */ new Set(),
-			rows: 0
-		};
-		const expanded = expandNode(op.template, row, `-${index + 1}`, state);
-		total += state.rows;
-		if (state.missing.size > 0) {
-			const fields = [...state.missing];
-			errors.push(rowError(index, `Row ${index + 1} has no ${fields.map((field) => `"${field}"`).join(", ")}`, `The template reads it as {{item.${fields[0]}}}. This row carries: ${keysOf(row)}`));
-			continue;
-		}
-		if (state.notAList.size > 0) {
-			const [spec] = [...state.notAList];
-			errors.push(rowError(index, `Row ${index + 1} has no list at ${spec}`, `A nested repeat needs an ARRAY in that field. This row carries: ${keysOf(row)}`));
-			continue;
-		}
-		children.push(expanded);
-	}
-	if (errors.length > 0) return { errors };
-	if (total > MAX_ROWS) return { errors: [{
-		path: "items",
-		message: `This repeat expands to ${total} rows (max ${MAX_ROWS})`,
-		hint: "Shorten the lists, or split the widget into several repeats."
-	}] };
-	return {
-		element: {
-			ref: op.ref,
-			type: op.elementType ?? "container",
-			...op.label === void 0 ? {} : { label: op.label },
-			...op.style === void 0 ? {} : { style: op.style },
-			children
-		},
-		errors
-	};
-};
-//#endregion
-export { expandRepeat, repeatElementOp };

package/dist/modules/mcp/tools/operations/schema/elements/upsertElement.js

@@ -1,65 +0,0 @@
-import { findPageByRef, resolveRef } from "../../../../helpers/space.js";
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { elementInput, position } from "../shared.js";
-import { collectInputRefs, createElement, guardNewRef, writeInitialState } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/elements/upsertElement.ts
-var upsertElementOp = z.object({
-	type: z.literal("upsertElement"),
-	pageRef: z.string().describe("Page ref or id"),
-	element: elementInput,
-	parentRef: z.string().optional().describe("Anchor ref/id; defaults to page root"),
-	position: position.optional()
-}).describe("Add an element to a page, or fully update it when element.ref already exists (props and style are REPLACED, not merged). To change only some fields of an existing element, use patchElement instead.");
-var upsertElement = (space, env, op) => {
-	const page = findPageByRef(space.schema, op.pageRef);
-	if (!page) return fail("pageRef", `Page "${op.pageRef}" not found`, "Read plitzi://schema/" + env + "/pages for valid refs");
-	const existing = resolveRef(space.schema, page, op.element.ref);
-	if (existing && existing.id !== page.id) {
-		if (op.element.label !== void 0) existing.definition.label = op.element.label;
-		if (op.element.props !== void 0 || op.element.subType !== void 0) {
-			const subType = op.element.subType ?? existing.attributes.subType;
-			existing.attributes = subType === void 0 ? { ...op.element.props } : {
-				subType,
-				...op.element.props
-			};
-		}
-		if (op.element.style !== void 0) {
-			const selectors = { base: (op.element.style.base ?? []).join(" ") };
-			for (const [slot, classes] of Object.entries(op.element.style.slots ?? {})) selectors[slot] = classes.join(" ");
-			existing.definition.styleSelectors = selectors;
-		}
-		if (op.element.initialState !== void 0) writeInitialState(existing, op.element.initialState, false);
-		return {
-			...empty(),
-			updated: 1,
-			staleResources: [pageUri(env, op.pageRef)],
-			elementRefs: [op.element.ref]
-		};
-	}
-	for (const ref of collectInputRefs(op.element)) {
-		const guard = guardNewRef(space, ref, "element.ref");
-		if (guard) return guard;
-	}
-	let parent = page;
-	let index;
-	if (op.parentRef) {
-		const anchor = resolveRef(space.schema, page, op.parentRef);
-		if (!anchor) return fail("parentRef", `Parent "${op.parentRef}" not found in page "${op.pageRef}"`, "Use an existing ref");
-		if (op.position === "before" || op.position === "after") {
-			parent = anchor.definition.parentId ? space.schema.flat[anchor.definition.parentId] : page;
-			const at = (parent.definition.items ?? []).indexOf(anchor.id);
-			index = at < 0 ? void 0 : op.position === "after" ? at + 1 : at;
-		} else parent = anchor;
-	}
-	createElement(space, page, op.element, parent, index);
-	return {
-		...empty(),
-		created: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.element.ref]
-	};
-};
-//#endregion
-export { upsertElement, upsertElementOp };

package/dist/modules/mcp/tools/operations/schema/folders/deleteFolder.js

@@ -1,30 +0,0 @@
-import { findFolderByRef, isPageElement, pageFoldersOf, sortFolders } from "../../../../helpers/space.js";
-import { folderUri, foldersUri, pagesUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/folders/deleteFolder.ts
-var deleteFolderOp = z.object({
-	type: z.literal("deleteFolder"),
-	ref: z.string()
-}).describe("Delete a folder; its child folders and pages move up to its parent (or the root)");
-var deleteFolder = (space, env, op) => {
-	const folders = pageFoldersOf(space.schema);
-	const folder = findFolderByRef(space.schema, op.ref);
-	if (!folder) return fail("ref", `Folder "${op.ref}" not found`, "Read plitzi://folders for valid refs");
-	const newParent = folder.parentId;
-	for (const child of folders) if (child.parentId === folder.id) if (newParent === void 0) Reflect.deleteProperty(child, "parentId");
-	else child.parentId = newParent;
-	for (const el of Object.values(space.schema.flat)) if (isPageElement(space.schema, el) && el.attributes.folder === folder.id) el.attributes.folder = newParent ?? "";
-	space.schema.pageFolders = sortFolders(folders.filter((f) => f.id !== folder.id));
-	return {
-		...empty(),
-		deleted: 1,
-		staleResources: [
-			folderUri(env, folder.id),
-			foldersUri(env),
-			pagesUri(env)
-		]
-	};
-};
-//#endregion
-export { deleteFolder, deleteFolderOp };

package/dist/modules/mcp/tools/operations/schema/folders/upsertFolder.js

@@ -1,49 +0,0 @@
-import { findFolderByRef, pageFoldersOf, slugify, sortFolders } from "../../../../helpers/space.js";
-import { folderUri, foldersUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/folders/upsertFolder.ts
-var upsertFolderOp = z.object({
-	type: z.literal("upsertFolder"),
-	ref: z.string().describe("Folder ref: an existing folder id/name/slug to update, or a new id you choose"),
-	name: z.string().optional(),
-	slug: z.string().optional(),
-	parentId: z.string().nullable().optional().describe("Ref of the parent folder for nesting; null keeps it at root")
-}).describe("Create a sidebar page-folder, or update it when ref already exists. Nest it under another via parentId.");
-var upsertFolder = (space, env, op) => {
-	const folders = pageFoldersOf(space.schema);
-	let parentId;
-	if (op.parentId !== void 0 && op.parentId !== null) {
-		const parent = findFolderByRef(space.schema, op.parentId);
-		if (!parent) return fail("parentId", `Parent folder "${op.parentId}" not found`, "Create it with upsertFolder first");
-		parentId = parent.id;
-	}
-	const existing = findFolderByRef(space.schema, op.ref);
-	if (existing) {
-		if (op.name !== void 0) existing.name = op.name;
-		if (op.slug !== void 0) existing.slug = op.slug;
-		if (op.parentId === null) Reflect.deleteProperty(existing, "parentId");
-		else if (op.parentId !== void 0) existing.parentId = parentId;
-		space.schema.pageFolders = sortFolders(folders);
-		return {
-			...empty(),
-			updated: 1,
-			staleResources: [folderUri(env, existing.id), foldersUri(env)]
-		};
-	}
-	const folder = {
-		id: op.ref,
-		name: op.name ?? op.ref,
-		slug: op.slug ?? slugify(op.ref)
-	};
-	if (parentId !== void 0) folder.parentId = parentId;
-	folders.push(folder);
-	space.schema.pageFolders = sortFolders(folders);
-	return {
-		...empty(),
-		created: 1,
-		staleResources: [folderUri(env, folder.id), foldersUri(env)]
-	};
-};
-//#endregion
-export { upsertFolder, upsertFolderOp };

package/dist/modules/mcp/tools/operations/schema/interactions/deleteInteraction.js

@@ -1,52 +0,0 @@
-import { pageUri } from "../../../../helpers/uris.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { resolveElement } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/interactions/deleteInteraction.ts
-var deleteInteractionOp = z.object({
-	type: z.literal("deleteInteraction"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Element ref or id"),
-	flowId: z.string().optional().describe("Remove the whole flow with this id (the trigger node id)"),
-	nodeId: z.string().optional().describe("Remove a single step; its neighbors are re-linked. Deleting a trigger removes its flow")
-}).describe("DESTRUCTIVE, not undoable — remove a flow (by flowId) or a single step (by nodeId); provide exactly one. To turn a step OFF instead, patchInteractionNode { enabled: false }. Confirm with the user first.");
-var removeFlow = (interactions, flowId) => {
-	let deleted = 0;
-	for (const [nodeId, node] of Object.entries(interactions)) if ((node.flowId || node.id) === flowId) {
-		Reflect.deleteProperty(interactions, nodeId);
-		deleted++;
-	}
-	return deleted;
-};
-var deleteInteraction = (space, env, op) => {
-	if (Boolean(op.flowId) === Boolean(op.nodeId)) return fail("nodeId", "Provide exactly one of flowId or nodeId", "flowId removes a whole flow; nodeId removes a step");
-	const found = resolveElement(space, env, op.pageRef, op.ref);
-	if ("error" in found) return found.error;
-	const interactions = found.el.definition.interactions;
-	if (!interactions) return fail("ref", `Element "${op.ref}" has no interactions`, "Nothing to delete");
-	let deleted = 0;
-	if (op.flowId) deleted = removeFlow(interactions, op.flowId);
-	else if (op.nodeId) {
-		if (!(op.nodeId in interactions)) return fail("nodeId", `Interaction node "${op.nodeId}" not found on "${op.ref}"`, "Read the element to list nodes");
-		const node = interactions[op.nodeId];
-		if (node.type === "trigger") deleted = removeFlow(interactions, node.flowId || node.id);
-		else {
-			const before = node.beforeNode ? interactions[node.beforeNode] : void 0;
-			const after = node.afterNode ? interactions[node.afterNode] : void 0;
-			if (before) before.afterNode = node.afterNode;
-			if (after) after.beforeNode = node.beforeNode;
-			Reflect.deleteProperty(interactions, op.nodeId);
-			deleted = 1;
-		}
-	}
-	if (deleted === 0) return fail("flowId", `No interaction matching "${op.flowId ?? op.nodeId}" on "${op.ref}"`, "Nothing to delete");
-	if (Object.keys(interactions).length === 0) Reflect.deleteProperty(found.el.definition, "interactions");
-	return {
-		...empty(),
-		deleted,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { deleteInteraction, deleteInteractionOp };

package/dist/modules/mcp/tools/operations/schema/interactions/patchInteractionNode.js

@@ -1,47 +0,0 @@
-import { pageUri } from "../../../../helpers/uris.js";
-import { NULLISH_ELEMENT_IDS } from "../../../../helpers/interactions.js";
-import { empty, fail } from "../../../../helpers/opResult.js";
-import { interactionNode } from "../shared.js";
-import { resolveElement, resolveTargetRef } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/interactions/patchInteractionNode.ts
-var { title, action, params, enabled, when, elementId, preview } = interactionNode.shape;
-var patchInteractionNodeOp = z.object({
-	type: z.literal("patchInteractionNode"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Element ref or id"),
-	nodeId: z.string().describe("Id of the interaction node to update"),
-	title: title.optional(),
-	action: action.optional(),
-	params: params.describe("Merged onto the node params: listed keys change, others are preserved"),
-	enabled,
-	when,
-	elementId,
-	preview
-}).describe("Partially update ONE step of a flow (found by nodeId): only the fields you pass change, the order/links are untouched. This is how you DISABLE a step without removing it — { enabled: false } keeps it in the flow. deleteInteraction is for actually removing one. Fails if the node does not exist.");
-var patchInteractionNode = (space, env, op) => {
-	const found = resolveElement(space, env, op.pageRef, op.ref);
-	if ("error" in found) return found.error;
-	const node = found.el.definition.interactions?.[op.nodeId];
-	if (!node) return fail("nodeId", `Interaction node "${op.nodeId}" not found on "${op.ref}"`, "Read the element to list nodes");
-	if (op.title !== void 0) node.title = op.title;
-	if (op.action !== void 0) node.action = op.action;
-	if (op.params !== void 0) node.params = {
-		...node.params,
-		...op.params
-	};
-	if (op.enabled !== void 0) node.enabled = op.enabled;
-	if (op.when !== void 0) node.when = op.when;
-	if (op.elementId !== void 0) node.elementId = resolveTargetRef(space, op.elementId);
-	if (node.type === "utility") node.elementId = null;
-	else if (typeof node.elementId === "string" && NULLISH_ELEMENT_IDS.has(node.elementId)) node.elementId = null;
-	if (op.preview !== void 0) node.preview = op.preview;
-	return {
-		...empty(),
-		updated: 1,
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { patchInteractionNode, patchInteractionNodeOp };

package/dist/modules/mcp/tools/operations/schema/interactions/upsertInteractionFlow.js

@@ -1,44 +0,0 @@
-import { pageUri } from "../../../../helpers/uris.js";
-import { materializeFlow } from "../../../../helpers/interactions.js";
-import { empty } from "../../../../helpers/opResult.js";
-import { interactionNode } from "../shared.js";
-import { ensureIdRef, resolveElement, resolveTargetRef } from "../write.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/operations/schema/interactions/upsertInteractionFlow.ts
-var upsertInteractionFlowOp = z.object({
-	type: z.literal("upsertInteractionFlow"),
-	pageRef: z.string().describe("Page ref or id"),
-	ref: z.string().describe("Element ref or id"),
-	flowId: z.string().optional().describe("Existing flow to replace (the trigger node id). Omit to create a new flow"),
-	nodes: z.array(interactionNode).min(1).describe("Ordered steps of the flow: the FIRST must be a trigger, the rest run after it in order")
-}).describe("Create or replace one interaction flow on an element from an ordered list of steps — pass them in execution order, the beforeNode/afterNode/flowId links are computed for you. For a globalCallback OMIT elementId: it is registered on a source module, not the host element, and the source and default params are filled in for you. To edit a single step in place use patchInteractionNode.");
-var upsertInteractionFlow = (space, env, op) => {
-	const found = resolveElement(space, env, op.pageRef, op.ref);
-	if ("error" in found) return found.error;
-	const ownerRef = ensureIdRef(space, found.el);
-	const nodes = (op.flowId && !op.nodes[0].id ? [{
-		...op.nodes[0],
-		id: op.flowId
-	}, ...op.nodes.slice(1)] : op.nodes).map((node) => node.elementId === void 0 || node.nodeType === "utility" ? node : {
-		...node,
-		elementId: resolveTargetRef(space, node.elementId)
-	});
-	const { flowId, record } = materializeFlow(nodes, ownerRef);
-	const interactions = found.el.definition.interactions ?? {};
-	const targetFlow = op.flowId ?? flowId;
-	let replaced = false;
-	for (const [nodeId, node] of Object.entries(interactions)) if ((node.flowId || node.id) === targetFlow) {
-		Reflect.deleteProperty(interactions, nodeId);
-		replaced = true;
-	}
-	Object.assign(interactions, record);
-	found.el.definition.interactions = interactions;
-	return {
-		...empty(),
-		...replaced ? { updated: 1 } : { created: 1 },
-		staleResources: [pageUri(env, op.pageRef)],
-		elementRefs: [op.ref]
-	};
-};
-//#endregion
-export { upsertInteractionFlow, upsertInteractionFlowOp };