@plitzi/sdk-mcp 0.38.7 → 0.38.9

package/dist/modules/mcp/tools/apply/index.d.ts

@@ -15,7 +15,7 @@ export declare const applyShape: {
             after: "after";
             inside: "inside";
         }>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"repeatElement">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -33,7 +33,7 @@ export declare const applyShape: {
         }>>;
         template: z.ZodType<import('../operations/schema').TemplateElement, unknown, z.core.$ZodTypeInternals<import('../operations/schema').TemplateElement, unknown>>;
         items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchElement">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -58,11 +58,11 @@ export declare const applyShape: {
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         quiet: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"moveElement">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -72,7 +72,7 @@ export declare const applyShape: {
             after: "after";
             inside: "inside";
         }>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertPage">;
         ref: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -83,10 +83,10 @@ export declare const applyShape: {
         layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deletePage">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertLayout">;
         ref: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -102,19 +102,19 @@ export declare const applyShape: {
             address: "address";
             figure: "figure";
         }>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteLayout">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertFolder">;
         ref: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
         slug: z.ZodOptional<z.ZodString>;
         parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteFolder">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertVariable">;
         name: z.ZodString;
         variableType: z.ZodString;
@@ -124,10 +124,10 @@ export declare const applyShape: {
             when: z.ZodUnknown;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
         }, z.core.$strip>>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteVariable">;
         name: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertFlag">;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -136,10 +136,10 @@ export declare const applyShape: {
             when: z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>;
             value: z.ZodBoolean;
         }, z.core.$strip>>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteFlag">;
         name: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertBinding">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -159,8 +159,8 @@ export declare const applyShape: {
             }, z.core.$strip>>>;
             when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
             enabled: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchBinding">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -179,7 +179,7 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteBinding">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -190,7 +190,7 @@ export declare const applyShape: {
         }>;
         to: z.ZodString;
         id: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertInteractionFlow">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -216,8 +216,8 @@ export declare const applyShape: {
             }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchInteractionNode">;
         pageRef: z.ZodString;
         ref: z.ZodString;
@@ -235,13 +235,13 @@ export declare const applyShape: {
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteInteraction">;
         pageRef: z.ZodString;
         ref: z.ZodString;
         flowId: z.ZodOptional<z.ZodString>;
         nodeId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchSettings">;
         customCss: z.ZodOptional<z.ZodString>;
         notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
@@ -289,7 +289,7 @@ export declare const applyShape: {
             }>>;
             presence: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertComponent">;
         ref: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -297,10 +297,10 @@ export declare const applyShape: {
         slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
         fromRef: z.ZodOptional<z.ZodString>;
         instanceRef: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteComponent">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -451,7 +451,7 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"upsertDefinition">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertDefinitions">;
         definitions: z.ZodRecord<z.ZodString, z.ZodObject<{
             desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -603,7 +603,7 @@ export declare const applyShape: {
                 }, z.core.$strip>>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
@@ -754,10 +754,10 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"patchDefinition">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteDefinition">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -908,7 +908,7 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"upsertGlobalStyle">;
         componentType: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
@@ -1059,10 +1059,10 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"patchGlobalStyle">;
         componentType: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteGlobalStyle">;
         componentType: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -1213,7 +1213,7 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"upsertIdStyle">;
         targetId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
         mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>>;
@@ -1364,10 +1364,10 @@ export declare const applyShape: {
         }, z.core.$strip>>>;
         type: z.ZodLiteral<"patchIdStyle">;
         targetId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteIdStyle">;
         targetId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertStyleVariable">;
         category: z.ZodEnum<{
             color: "color";
@@ -1381,7 +1381,7 @@ export declare const applyShape: {
             dark: z.ZodOptional<z.ZodString>;
             default: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>]>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteStyleVariable">;
         category: z.ZodEnum<{
             color: "color";
@@ -1390,7 +1390,7 @@ export declare const applyShape: {
             custom: "custom";
         }>;
         name: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertFont">;
         family: z.ZodString;
         source: z.ZodEnum<{
@@ -1419,10 +1419,10 @@ export declare const applyShape: {
             url: z.ZodOptional<z.ZodString>;
             path: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteFont">;
         family: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertConnector">;
         ref: z.ZodString;
         name: z.ZodString;
@@ -1510,7 +1510,7 @@ export declare const applyShape: {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchConnector">;
         ref: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -1598,10 +1598,10 @@ export declare const applyShape: {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteConnector">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertAction">;
         ref: z.ZodString;
         name: z.ZodString;
@@ -1640,7 +1640,7 @@ export declare const applyShape: {
             maxNodes: z.ZodOptional<z.ZodNumber>;
             maxRequests: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"patchAction">;
         ref: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -1679,24 +1679,38 @@ export declare const applyShape: {
             maxNodes: z.ZodOptional<z.ZodNumber>;
             maxRequests: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteAction">;
         ref: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertFunctionFile">;
         path: z.ZodString;
         content: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteFunctionFile">;
         path: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertDataFile">;
         path: z.ZodString;
         content: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"deleteDataFile">;
         path: z.ZodString;
-    }, z.core.$strip>], "type">>;
+    }, z.core.$strict>], "type">>;
+    look: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        accessibility: "accessibility";
+        html: "html";
+        both: "both";
+    }>>;
+    pageRef: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodEnum<{
+        desktop: "desktop";
+        mobile: "mobile";
+        both: "both";
+    }>>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
 };
+export declare const NOTHING_CHANGED = "Nothing changed: every operation left the space as it was.";
 export declare const apply: (input: ApplyInput, space: Space, persisters?: Persisters) => Promise<WriteResponse>;
 export declare const applyTool: import('..').ToolDef;

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

@@ -2,7 +2,10 @@ import { dataFileUri, dataUri, functionFileUri, functionsUri } from "../../helpe
 import { changedResources, conflictMessage, detectConflicts, resolvedElements } from "./writeResult.js";
 import { environment, operations } from "../operations/index.js";
 import { draftBatch } from "../shared/draftBatch.js";
-import { defineTool } from "../shared/tool.js";
+import { effectsOf } from "../shared/effects.js";
+import { fullPage, lookAt, pageRef, viewport } from "../shared/look.js";
+import { AGAIN, REPEATED, batchKey, forgetRefused, noteRefused, timesRefused } from "../shared/repeats.js";
+import { defineTool, imageResult } from "../shared/tool.js";
 import { z } from "zod";
 import { generateCache } from "@plitzi/sdk-style/StyleHelper";
 //#region src/modules/mcp/tools/apply/index.ts
@@ -10,8 +13,18 @@ var applyShape = {
 	environment,
 	dryRun: z.boolean().optional().describe("Validate and apply in memory only, WITHOUT persisting. Returns the same result (changed versions + full element detail) so you can inspect the outcome and decide on more changes before committing for real."),
 	expectedResourceVersions: z.record(z.string(), z.string()).optional().describe("Resource URI → the stateVersion you read; guards against concurrent edits"),
-	operations
+	operations,
+	look: z.enum([
+		"html",
+		"image",
+		"accessibility",
+		"both"
+	]).optional().describe("Also render the page: with dryRun, as the batch would leave it (nothing saved); without, as it was saved. \"html\" the markup, \"image\" a PNG, \"accessibility\" the outline a screen reader reads (text, far cheaper than an image), \"both\" image and outline. Check, look and then save with the same operations — written once."),
+	pageRef,
+	viewport,
+	fullPage
 };
+var NOTHING_CHANGED = "Nothing changed: every operation left the space as it was.";
 var noWarnings = (warnings) => warnings.length > 0 ? warnings : void 0;
 /** Why the platform did not save the functions, as the batch's errors: each problem where it is, or the refusal. */
 var functionsErrors = (saved, env) => "problems" in saved ? saved.problems.map((problem) => ({
@@ -62,7 +75,9 @@ var apply = async (input, space, persisters) => {
 		errors: result.errors,
 		warnings: noWarnings(result.warnings)
 	};
-	const { draft, outcome, warnings, suggestions } = result;
+	const { draft, outcome, suggestions } = result;
+	const effects = effectsOf(space, draft);
+	const warnings = effects.length > 0 ? result.warnings : [NOTHING_CHANGED, ...result.warnings];
 	if (input.dryRun) return {
 		applied: false,
 		dryRun: true,
@@ -71,12 +86,13 @@ var apply = async (input, space, persisters) => {
 			updated: outcome.updated,
 			deleted: outcome.deleted
 		},
+		effects,
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
 		warnings: noWarnings(warnings),
 		suggestions: noWarnings(suggestions)
 	};
-	let persisted = true;
+	const unsaved = [];
 	if (outcome.changedFunctions && draft.functions) {
 		if (persisters?.saveFunctions) {
 			const saved = await persisters.saveFunctions(draft.functions.files, space.functions?.version ?? "");
@@ -92,7 +108,7 @@ var apply = async (input, space, persisters) => {
 				errors: functionsErrors(saved, env),
 				warnings: noWarnings(warnings)
 			};
-		} else persisted = false;
+		} else unsaved.push("the functions");
 	}
 	if (outcome.changedData && draft.data) {
 		if (persisters?.saveData) {
@@ -109,56 +125,90 @@ var apply = async (input, space, persisters) => {
 				errors: dataErrors(saved, env),
 				warnings: noWarnings([...outcome.changedFunctions && persisters.saveFunctions ? ["The functions of this batch were saved; the data was not — apply the data again once fixed"] : [], ...warnings])
 			};
-		} else persisted = false;
+		} else unsaved.push("the data");
 	}
 	if (outcome.changedSchema) {
 		if (persisters?.schema) await persisters.schema(draft.schema);
-		else persisted = false;
+		else unsaved.push("the schema");
 	}
 	if (outcome.changedStyle) {
 		if (persisters?.style) {
 			draft.style.cache = generateCache(draft.style);
 			await persisters.style(draft.style);
-		} else persisted = false;
+		} else unsaved.push("the style");
 	}
 	for (const id of outcome.changedConnectors) {
 		const entry = draft.connectors.find((item) => item.id === id);
 		if (entry && persisters?.saveConnector) await persisters.saveConnector(entry);
-		else persisted = false;
+		else unsaved.push(`connector ${id}`);
 	}
 	for (const id of outcome.deletedConnectors) if (persisters?.deleteConnector) await persisters.deleteConnector(id);
-	else persisted = false;
+	else unsaved.push(`the removal of connector ${id}`);
 	for (const id of outcome.changedActions) {
 		const entry = draft.actions.find((item) => item.id === id);
 		if (entry && persisters?.saveAction) await persisters.saveAction(entry);
-		else persisted = false;
+		else unsaved.push(`action ${id}`);
 	}
 	for (const id of outcome.deletedActions) if (persisters?.deleteAction) await persisters.deleteAction(id);
-	else persisted = false;
+	else unsaved.push(`the removal of action ${id}`);
 	return {
 		applied: true,
-		persisted,
+		persisted: unsaved.length === 0,
 		summary: {
 			created: outcome.created,
 			updated: outcome.updated,
 			deleted: outcome.deleted
 		},
+		effects,
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
-		warnings: noWarnings(warnings),
+		warnings: noWarnings([...unsaved.length > 0 ? [`NOT saved: ${unsaved.join(", ")} — this server has no store to save it in`] : [], ...warnings]),
 		suggestions: noWarnings(suggestions)
 	};
 };
 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 — INCLUDING a pre-existing malformation in any resource the batch touches (fix it in the same batch to unblock the save).",
+	description: "Validate, apply and persist a batch of operations atomically. Returns `effects` (what it changed, read off the space), the changed resources’ new versions and each created or updated element’s detail. Pass dryRun to apply in memory only (inspect the outcome without committing), and `look` to see the page as the batch leaves it. 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,
+	carriesOperations: true,
 	access: "write",
-	run: (input, ctx) => apply({
-		...input,
-		environment: ctx.env
-	}, ctx.space, ctx.persisters)
+	run: async (input, ctx) => {
+		const key = batchKey(`${String(ctx.spaceId ?? "")}:${ctx.env}`, input.operations);
+		const before = timesRefused(key);
+		if (before >= 2) return REPEATED;
+		const result = await apply({
+			...input,
+			environment: ctx.env
+		}, ctx.space, ctx.persisters);
+		if (result.errors?.length) {
+			noteRefused(key);
+			return before === 1 ? {
+				...result,
+				again: AGAIN
+			} : result;
+		}
+		forgetRefused(key);
+		if (!input.look || !result.applied && !result.dryRun) return result;
+		const look = await lookAt(ctx, {
+			pageRef: input.pageRef,
+			operations: result.dryRun ? input.operations : void 0,
+			view: input.look,
+			viewport: input.viewport,
+			fullPage: input.fullPage
+		});
+		if ("refused" in look) return {
+			...result,
+			look: look.refused
+		};
+		return look.images.length > 0 ? imageResult(look.images, {
+			...result,
+			look: look.meta
+		}) : {
+			...result,
+			look: look.meta
+		};
+	}
 });
 //#endregion
-export { apply, applyShape, applyTool };
+export { NOTHING_CHANGED, apply, applyShape, applyTool };

package/dist/modules/mcp/tools/describeOperation.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const describeOperationShape: {
+    type: z.ZodOptional<z.ZodString>;
+};
+/**
+ * One operation's schema, by its type — the low level asked for one piece at a time, so a connection does not have to
+ * load all of it to write one operation. A type that does not exist is answered with the closed list and the nearest
+ * name: an agent that guessed is told what there is, never left to guess again.
+ */
+export declare const describeOperation: (type: string | undefined) => Record<string, unknown>;
+export declare const describeOperationTool: import('.').ToolDef;

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

@@ -0,0 +1,40 @@
+import { OPERATIONS_BY_TYPE } from "./operations/index.js";
+import { defineTool } from "./shared/tool.js";
+import { closest } from "@plitzi/sdk-authoring";
+import { z } from "zod";
+//#region src/modules/mcp/tools/describeOperation.ts
+var describeOperationShape = { type: z.string().optional().describe("The operation type, as in a batch: \"upsertElement\", \"patchDefinition\"… Left out, every type is listed.") };
+/**
+* One operation's schema, by its type — the low level asked for one piece at a time, so a connection does not have to
+* load all of it to write one operation. A type that does not exist is answered with the closed list and the nearest
+* name: an agent that guessed is told what there is, never left to guess again.
+*/
+var describeOperation = (type) => {
+	const types = [...OPERATIONS_BY_TYPE.keys()];
+	if (type === void 0) return { types };
+	const schema = OPERATIONS_BY_TYPE.get(type);
+	if (!schema) {
+		const nearest = closest(type, types);
+		return {
+			error: "UNKNOWN_OPERATION",
+			message: `There is no "${type}" operation${nearest ? ` — did you mean "${nearest}"?` : ""}`,
+			...nearest ? { describe: { type: nearest } } : {},
+			types
+		};
+	}
+	return {
+		type,
+		schema: z.toJSONSchema(schema)
+	};
+};
+var describeOperationTool = defineTool({
+	name: "plitzi_describe_operation",
+	title: "Describe an operation",
+	description: "The schema of one operation plitzi_apply or plitzi_render takes, by its type: every field, which are required, what each means. Without a type, every operation type there is.",
+	inputShape: describeOperationShape,
+	access: "read",
+	spaceless: true,
+	run: (input) => describeOperation(input.type)
+});
+//#endregion
+export { describeOperation, describeOperationShape, describeOperationTool };

package/dist/modules/mcp/tools/describeOperation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/mcp/tools/index.d.ts

@@ -1,12 +1,7 @@
 import { ToolDef } from './shared/tool';
 export { apply, applyShape } from './apply';
-export { validate, validateShape } from './validate';
 export { search, searchShape } from './search';
 export { read, readShape } from './read';
-export { previewShape } from './preview';
-export { render, renderShape } from './render';
-export { screenshotShape } from './screenshot';
-export { applyOperations } from './apply/dispatch';
 export { validateOperations } from './shared/validator';
 export { operation } from './operations';
 /** The MCP tool registry — the single source the server registers from. Adding a tool is: create its file with a
@@ -15,4 +10,4 @@ export declare const tools: ToolDef[];
 export type { ToolContext, ToolDef } from './shared/tool';
 export type { OpResult } from '../helpers';
 export type { DefinitionSlotInput, DefinitionSlotPatch, ElementInput, Operation, OperationType } from './operations';
-export type { ApplyInput, ChangedResource, Conflict, Persisters, WriteElement, WriteResponse, ValidateInput, ValidationResult, MutationOutcome, SearchHit, SearchInput, SearchResponse, SearchPageHit, ReadInput, ReadResponse, ReadHit } from '../types';
+export type { ApplyInput, ChangedResource, Conflict, Persisters, WriteElement, WriteResponse, ValidationResult, MutationOutcome, SearchHit, SearchInput, SearchResponse, SearchPageHit, ReadInput, ReadResponse, ReadHit } from '../types';

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

@@ -1,26 +1,29 @@
 import { operation } from "./operations/index.js";
-import { validateOperations } from "./shared/validator/index.js";
-import { applyOperations } from "./apply/dispatch.js";
+import "./shared/validator/index.js";
 import { apply, applyShape, applyTool } from "./apply/index.js";
-import { previewTool } from "./preview.js";
+import { describeOperationTool } from "./describeOperation.js";
+import { addPageTool, bindAttributeTool, placeComponentTool, setAttributesTool, setClassesTool } from "./intents.js";
+import { lookTool } from "./look.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 { tryFunctionTool } from "./tryFunction.js";
-import { validate, validateShape, validateTool } from "./validate.js";
 //#region src/modules/mcp/tools/index.ts
 /** The MCP tool registry — the single source the server registers from. Adding a tool is: create its file with a
 *  ToolDef descriptor and append it here. */
 var tools = [
 	applyTool,
-	validateTool,
+	setAttributesTool,
+	setClassesTool,
+	bindAttributeTool,
+	placeComponentTool,
+	addPageTool,
 	searchTool,
+	describeOperationTool,
 	readTool,
 	renderTool,
-	previewTool,
-	screenshotTool,
+	lookTool,
 	tryFunctionTool
 ];
 //#endregion
-export { apply, applyOperations, applyShape, operation, read, readShape, search, searchShape, tools, validate, validateOperations, validateShape };
+export { apply, applyShape, operation, read, readShape, search, searchShape, tools };

package/dist/modules/mcp/tools/intents.d.ts

@@ -0,0 +1,5 @@
+export declare const setAttributesTool: import('.').ToolDef;
+export declare const setClassesTool: import('.').ToolDef;
+export declare const bindAttributeTool: import('.').ToolDef;
+export declare const placeComponentTool: import('.').ToolDef;
+export declare const addPageTool: import('.').ToolDef;