@plitzi/sdk-server 0.32.5 → 0.32.7

package/dist/modules/mcp/server.js

@@ -1,5 +1,6 @@
-import { emptySpaceMessage, unauthorizedSpaceMessage } from "./helpers/space.js";
+import { emptySpace, emptySpaceMessage, unauthorizedSpaceMessage } from "./helpers/space.js";
 import { serverInstructions } from "./helpers/guide.js";
+import { createMcpLog } from "./helpers/log.js";
 import { registerResources } from "./resources/register.js";
 import { tools } from "./tools/index.js";
 import { isCallToolResult } from "../ai/toolkit.js";
@@ -10,7 +11,8 @@ var asText = (data) => ({ content: [{
 	type: "text",
 	text: JSON.stringify(data)
 }] });
-var createMcpServer = ({ adapters, getSpaceId, preview, screenshot }) => {
+var createMcpServer = ({ adapters, getSpaceId, preview, screenshot, logger }) => {
+	const log = createMcpLog(logger);
 	let spaceIdPromise;
 	const requireSpaceId = () => spaceIdPromise ??= getSpaceId().then((id) => {
 		if (!id) throw new Error(unauthorizedSpaceMessage);
@@ -18,11 +20,16 @@ var createMcpServer = ({ adapters, getSpaceId, preview, screenshot }) => {
 	});
 	const loadSpace = async () => {
 		const spaceId = await requireSpaceId();
-		const [schema, style] = await Promise.all([adapters.getSchema?.(spaceId, MCP_ENV), adapters.getStyle?.(spaceId, MCP_ENV)]);
+		const [schema, style, catalog] = await Promise.all([
+			adapters.getSchema?.(spaceId, MCP_ENV),
+			adapters.getStyle?.(spaceId, MCP_ENV),
+			adapters.getComponentCatalog?.(spaceId, MCP_ENV).catch(() => void 0)
+		]);
 		if (!schema || !style) throw new Error(emptySpaceMessage);
 		return {
 			schema,
-			style
+			style,
+			catalog
 		};
 	};
 	const { saveSchema, saveStyle } = adapters;
@@ -34,9 +41,9 @@ var createMcpServer = ({ adapters, getSpaceId, preview, screenshot }) => {
 	const getSpace = () => spacePromise ??= loadSpace();
 	const server = new McpServer({
 		name: "plitzi-mcp",
-		version: "0.3.0"
+		version: "0.32.7"
 	}, { instructions: serverInstructions });
-	registerResources(server, getSpace, MCP_ENV);
+	registerResources(server, getSpace, MCP_ENV, log);
 	const toolContext = async () => ({
 		space: await getSpace(),
 		env: MCP_ENV,
@@ -45,6 +52,13 @@ var createMcpServer = ({ adapters, getSpaceId, preview, screenshot }) => {
 		preview,
 		screenshot
 	});
+	const spacelessContext = () => ({
+		space: emptySpace(),
+		env: MCP_ENV,
+		persisters,
+		preview,
+		screenshot
+	});
 	for (const tool of tools) {
 		if (tool.requires === "screenshot" && !screenshot) continue;
 		server.registerTool(tool.name, {
@@ -52,8 +66,15 @@ var createMcpServer = ({ adapters, getSpaceId, preview, screenshot }) => {
 			description: tool.description,
 			inputSchema: tool.inputShape
 		}, async (args) => {
-			const result = await tool.execute(args, await toolContext());
-			return isCallToolResult(result) ? result : asText(result);
+			const start = performance.now();
+			try {
+				const result = await tool.execute(args, tool.spaceless ? spacelessContext() : await toolContext());
+				log.toolCall(tool.name, args, performance.now() - start);
+				return isCallToolResult(result) ? result : asText(result);
+			} catch (error) {
+				log.toolCall(tool.name, args, performance.now() - start, error);
+				throw error;
+			}
 		});
 	}
 	return server;

package/dist/modules/mcp/tools/apply/dispatch.js

@@ -1,22 +1,32 @@
 import { fail } from "../../helpers/opResult.js";
-import { deleteElement } from "../operations/schema/deleteElement.js";
-import { deleteFolder } from "../operations/schema/deleteFolder.js";
-import { deletePage } from "../operations/schema/deletePage.js";
-import { deleteVariable } from "../operations/schema/deleteVariable.js";
-import { moveElement } from "../operations/schema/moveElement.js";
-import { patchElement } from "../operations/schema/patchElement.js";
-import { upsertElement } from "../operations/schema/upsertElement.js";
-import { upsertFolder } from "../operations/schema/upsertFolder.js";
-import { upsertPage } from "../operations/schema/upsertPage.js";
-import { upsertVariable } from "../operations/schema/upsertVariable.js";
-import { deleteDefinition } from "../operations/style/deleteDefinition.js";
-import { deleteGlobalStyle } from "../operations/style/deleteGlobalStyle.js";
-import { deleteStyleVariable } from "../operations/style/deleteStyleVariable.js";
-import { patchDefinition } from "../operations/style/patchDefinition.js";
-import { patchGlobalStyle } from "../operations/style/patchGlobalStyle.js";
-import { upsertDefinition } from "../operations/style/upsertDefinition.js";
-import { upsertGlobalStyle } from "../operations/style/upsertGlobalStyle.js";
-import { upsertStyleVariable } from "../operations/style/upsertStyleVariable.js";
+import { deleteBinding } from "../operations/schema/bindings/deleteBinding.js";
+import { patchBinding } from "../operations/schema/bindings/patchBinding.js";
+import { upsertBinding } from "../operations/schema/bindings/upsertBinding.js";
+import { deleteElement } from "../operations/schema/elements/deleteElement.js";
+import { moveElement } from "../operations/schema/elements/moveElement.js";
+import { patchElement } from "../operations/schema/elements/patchElement.js";
+import { upsertElement } from "../operations/schema/elements/upsertElement.js";
+import { deleteFolder } from "../operations/schema/folders/deleteFolder.js";
+import { upsertFolder } from "../operations/schema/folders/upsertFolder.js";
+import { deleteInteraction } from "../operations/schema/interactions/deleteInteraction.js";
+import { patchInteractionNode } from "../operations/schema/interactions/patchInteractionNode.js";
+import { upsertInteractionFlow } from "../operations/schema/interactions/upsertInteractionFlow.js";
+import { deletePage } from "../operations/schema/pages/deletePage.js";
+import { upsertPage } from "../operations/schema/pages/upsertPage.js";
+import { patchSettings } from "../operations/schema/settings/patchSettings.js";
+import { deleteVariable } from "../operations/schema/variables/deleteVariable.js";
+import { upsertVariable } from "../operations/schema/variables/upsertVariable.js";
+import { deleteDefinition } from "../operations/style/definitions/deleteDefinition.js";
+import { patchDefinition } from "../operations/style/definitions/patchDefinition.js";
+import { upsertDefinition } from "../operations/style/definitions/upsertDefinition.js";
+import { deleteGlobalStyle } from "../operations/style/globalStyles/deleteGlobalStyle.js";
+import { patchGlobalStyle } from "../operations/style/globalStyles/patchGlobalStyle.js";
+import { upsertGlobalStyle } from "../operations/style/globalStyles/upsertGlobalStyle.js";
+import { deleteIdStyle } from "../operations/style/idStyles/deleteIdStyle.js";
+import { patchIdStyle } from "../operations/style/idStyles/patchIdStyle.js";
+import { upsertIdStyle } from "../operations/style/idStyles/upsertIdStyle.js";
+import { deleteStyleVariable } from "../operations/style/variables/deleteStyleVariable.js";
+import { upsertStyleVariable } from "../operations/style/variables/upsertStyleVariable.js";
 import { isStyleOp } from "../operations/index.js";
 //#region src/modules/mcp/tools/apply/dispatch.ts
 var executeOp = (space, env, op) => {
@@ -31,12 +41,22 @@ var executeOp = (space, env, op) => {
 		case "deleteFolder": return deleteFolder(space, env, op);
 		case "upsertVariable": return upsertVariable(space, env, op);
 		case "deleteVariable": return deleteVariable(space, env, op);
+		case "upsertBinding": return upsertBinding(space, env, op);
+		case "patchBinding": return patchBinding(space, env, op);
+		case "deleteBinding": return deleteBinding(space, env, op);
+		case "upsertInteractionFlow": return upsertInteractionFlow(space, env, op);
+		case "patchInteractionNode": return patchInteractionNode(space, env, op);
+		case "deleteInteraction": return deleteInteraction(space, env, op);
+		case "patchSettings": return patchSettings(space, env, op);
 		case "upsertDefinition": return upsertDefinition(space, env, op);
 		case "patchDefinition": return patchDefinition(space, env, op);
 		case "deleteDefinition": return deleteDefinition(space, env, op);
 		case "upsertGlobalStyle": return upsertGlobalStyle(space, env, op);
 		case "patchGlobalStyle": return patchGlobalStyle(space, env, op);
 		case "deleteGlobalStyle": return deleteGlobalStyle(space, env, op);
+		case "upsertIdStyle": return upsertIdStyle(space, env, op);
+		case "patchIdStyle": return patchIdStyle(space, env, op);
+		case "deleteIdStyle": return deleteIdStyle(space, env, op);
 		case "upsertStyleVariable": return upsertStyleVariable(space, env, op);
 		case "deleteStyleVariable": return deleteStyleVariable(space, env, op);
 		default: return fail("type", `Unknown operation "${op.type}"`, "See the Operation union");

package/dist/modules/mcp/tools/apply/index.js

@@ -3,7 +3,8 @@ import { environment, operations } from "../operations/index.js";
 import { applyOperations } from "./dispatch.js";
 import { changedResources, conflictMessage, detectConflicts, resolvedElements } from "./writeResult.js";
 import { defineTool } from "../shared/tool.js";
-import { validateOperations } from "../shared/validator.js";
+import { validateOperations } from "../shared/validator/index.js";
+import { auditResources } from "../shared/validator/audit.js";
 import { z } from "zod";
 import { validateSchema } from "@plitzi/sdk-schema";
 //#region src/modules/mcp/tools/apply/index.ts
@@ -76,6 +77,20 @@ var apply = async (input, space, persisters) => {
 		errors: integrity.errors.map(schemaErrorToValidation),
 		warnings: noWarnings(validation.warnings)
 	};
+	const audit = auditResources(draft, input.operations);
+	const warnings = [...validation.warnings, ...audit.warnings];
+	if (audit.errors.length > 0) return {
+		applied: false,
+		persisted: false,
+		summary: {
+			created: 0,
+			updated: 0,
+			deleted: 0
+		},
+		changed: [],
+		errors: audit.errors,
+		warnings: noWarnings(warnings)
+	};
 	if (input.dryRun) return {
 		applied: false,
 		dryRun: true,
@@ -86,7 +101,7 @@ var apply = async (input, space, persisters) => {
 		},
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
-		warnings: noWarnings(validation.warnings)
+		warnings: noWarnings(warnings)
 	};
 	let persisted = true;
 	if (outcome.changedSchema) if (persisters?.schema) await persisters.schema(draft.schema);
@@ -103,13 +118,13 @@ var apply = async (input, space, persisters) => {
 		},
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
-		warnings: noWarnings(validation.warnings)
+		warnings: noWarnings(warnings)
 	};
 };
 var applyTool = defineTool({
 	name: "plitzi_apply",
 	title: "Apply",
-	description: "Validate, apply and persist a batch of operations atomically. Returns the changed resources and their new versions, plus the full detail of every element it created or updated. Pass dryRun to apply in memory only (inspect the outcome without committing). Rejects the whole batch on any error or version conflict.",
+	description: "Validate, apply and persist a batch of operations atomically. Returns the changed resources and their new versions, plus the full detail of every element it created or updated. Pass dryRun to apply in memory only (inspect the outcome without committing). Rejects the whole batch on any error or version conflict — INCLUDING a pre-existing malformation in any resource the batch touches (fix it in the same batch to unblock the save).",
 	inputShape: applyShape,
 	access: "write",
 	run: (input, ctx) => apply({

package/dist/modules/mcp/tools/apply/writeResult.js

@@ -1,3 +1,4 @@
+import { elementUri } from "../../helpers/uris.js";
 import { readResource, resourceVersion } from "../../resources/router.js";
 //#region src/modules/mcp/tools/apply/writeResult.ts
 var detectConflicts = (space, env, expected) => {
@@ -21,7 +22,7 @@ var changedResources = (space, env, uris) => uris.map((uri) => ({
 *  in the same batch). Returns undefined when there is nothing, so the field stays off the response. */
 var resolvedElements = (space, env, refs) => {
 	const elements = refs.map((ref) => {
-		const uri = `plitzi://schema/${env}/elements/${ref}`;
+		const uri = elementUri(env, ref);
 		const res = readResource(space, env, uri);
 		return res ? {
 			uri,

package/dist/modules/mcp/tools/index.js

@@ -1,9 +1,10 @@
 import { operation } from "./operations/index.js";
 import { applyOperations } from "./apply/dispatch.js";
-import { validateOperations } from "./shared/validator.js";
+import { validateOperations } from "./shared/validator/index.js";
 import { apply, applyShape, applyTool } from "./apply/index.js";
 import { previewTool } from "./preview.js";
 import { read, readShape, readTool } from "./read.js";
+import { renderTool } from "./render.js";
 import { screenshotTool } from "./screenshot.js";
 import { search, searchShape, searchTool } from "./search.js";
 import { validate, validateShape, validateTool } from "./validate.js";
@@ -15,6 +16,7 @@ var tools = [
 	validateTool,
 	searchTool,
 	readTool,
+	renderTool,
 	previewTool,
 	screenshotTool
 ];

package/dist/modules/mcp/tools/operations/index.js

@@ -13,18 +13,29 @@ var operation = z.discriminatedUnion("type", [
 	elementOps.deleteFolder,
 	elementOps.upsertVariable,
 	elementOps.deleteVariable,
+	elementOps.upsertBinding,
+	elementOps.patchBinding,
+	elementOps.deleteBinding,
+	elementOps.upsertInteractionFlow,
+	elementOps.patchInteractionNode,
+	elementOps.deleteInteraction,
+	elementOps.patchSettings,
 	styleOps.upsertDefinition,
 	styleOps.patchDefinition,
 	styleOps.deleteDefinition,
 	styleOps.upsertGlobalStyle,
 	styleOps.patchGlobalStyle,
 	styleOps.deleteGlobalStyle,
+	styleOps.upsertIdStyle,
+	styleOps.patchIdStyle,
+	styleOps.deleteIdStyle,
 	styleOps.upsertStyleVariable,
 	styleOps.deleteStyleVariable
 ]);
 var STYLE_OP_TYPES = new Set(Object.keys(styleOps));
 var isStyleOp = (type) => STYLE_OP_TYPES.has(type);
+var MAX_OPS = 1e3;
 var environment = z.string().optional().describe("Environment; default main");
-var operations = z.array(operation).max(100).describe("Operations applied atomically, in order (max 100)");
+var operations = z.array(operation).max(MAX_OPS).describe(`Operations applied atomically, in order (max ${MAX_OPS})`);
 //#endregion
-export { environment, isStyleOp, operation, operations };
+export { MAX_OPS, environment, isStyleOp, operation, operations };

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

@@ -0,0 +1,32 @@
+import { pageUri } from "../../../../helpers/uris.js";
+import { empty, fail } from "../../../../helpers/opResult.js";
+import { bindingCategory } from "../shared.js";
+import { resolveElement } from "../write.js";
+import { z } from "zod";
+//#region src/modules/mcp/tools/operations/schema/bindings/deleteBinding.ts
+var deleteBindingOp = z.object({
+	type: z.literal("deleteBinding"),
+	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 remove"),
+	id: z.string().optional().describe("Match by id instead of to")
+}).describe("Remove a data binding from an element (matched by id when given, else by to). Fails if none matches.");
+var deleteBinding = (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 ? list.findIndex((b) => op.id ? b.id === op.id : b.to === op.to) : -1;
+	if (!bindings || !list || index < 0) return fail("to", `No ${op.category} binding matching "${op.id ?? op.to}" on "${op.ref}"`, "Nothing to delete");
+	list.splice(index, 1);
+	if (list.length === 0) Reflect.deleteProperty(bindings, op.category);
+	return {
+		...empty(),
+		deleted: 1,
+		staleResources: [pageUri(env, op.pageRef)],
+		elementRefs: [op.ref]
+	};
+};
+//#endregion
+export { deleteBinding, deleteBindingOp };

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

@@ -0,0 +1,36 @@
+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

@@ -0,0 +1,47 @@
+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/{deleteElement.js → elements/deleteElement.js}

@@ -1,8 +1,9 @@
-import { descendantIds, findPageByRef, resolveRef } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { pageUri, removeFromParent } from "./write.js";
+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/deleteElement.ts
+//#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"),
@@ -13,8 +14,11 @@ var deleteElement = (space, env, op) => {
 	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");
-	for (const id of [...descendantIds(space.schema, el.id), el.id]) Reflect.deleteProperty(space.schema.flat, id);
-	removeFromParent(space, el.id);
+	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,

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

@@ -1,9 +1,10 @@
-import { findPageByRef, resolveRef } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { pageUri, placeChild, removeFromParent } from "./write.js";
-import { position } from "./shared.js";
+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/moveElement.ts
+//#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"),
@@ -18,7 +19,7 @@ var moveElement = (space, env, op) => {
 	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.id);
+	removeFromParent(space, el);
 	let parent = anchor;
 	let index;
 	if (op.position === "before" || op.position === "after") {
@@ -28,6 +29,7 @@ var moveElement = (space, env, op) => {
 	}
 	el.definition.parentId = parent.id;
 	placeChild(parent, el.id, index);
+	indexInvalidateDetails(space.schema);
 	return {
 		...empty(),
 		updated: 1,

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

@@ -1,23 +1,34 @@
-import { findPageByRef, resolveRef } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { pageUri } from "./write.js";
-import { styleRefs } from "./shared.js";
+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";
-//#region src/modules/mcp/tools/operations/schema/patchElement.ts
+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 the idRef of this element ([A-Za-z0-9_-], starting with a letter, unique in the space). Give an element one to make it bindable: without an idRef it publishes no data source. Renaming one moves its source name with it — every binding and interaction across the space that targeted the old name is repointed for you, so the wiring survives the rename."),
 	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")
-}).describe("Partially update an EXISTING element: only the fields you pass change (props/style are merged, not replaced). Never creates — fails if ref does not resolve. Use upsertElement to create or fully replace.");
+	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,
@@ -35,6 +46,7 @@ var patchElement = (space, env, op) => {
 		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,

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

@@ -1,9 +1,10 @@
-import { findPageByRef, resolveRef } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { createElement, pageUri } from "./write.js";
-import { elementInput, position } from "./shared.js";
+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/upsertElement.ts
+//#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"),
@@ -29,6 +30,7 @@ var upsertElement = (space, env, op) => {
 			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,
@@ -36,6 +38,10 @@ var upsertElement = (space, env, op) => {
 			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) {

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

@@ -1,8 +1,8 @@
-import { findFolderByRef, isPageElement, pageFoldersOf, sortFolders } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { folderUri, foldersUri, pagesUri } from "./write.js";
+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/deleteFolder.ts
+//#region src/modules/mcp/tools/operations/schema/folders/deleteFolder.ts
 var deleteFolderOp = z.object({
 	type: z.literal("deleteFolder"),
 	ref: z.string()

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

@@ -1,8 +1,8 @@
-import { findFolderByRef, pageFoldersOf, slugify, sortFolders } from "../../../helpers/space.js";
-import { empty, fail } from "../../../helpers/opResult.js";
-import { folderUri, foldersUri } from "./write.js";
+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/upsertFolder.ts
+//#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"),

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

@@ -0,0 +1,52 @@
+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 an interaction flow (by flowId) or a single step (by nodeId). Provide exactly one. To merely turn a step OFF without removing it, use patchInteractionNode { enabled: false } instead. Confirm with the user before deleting.");
+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 };