@plitzi/sdk-mcp 0.38.3 → 0.38.5

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

@@ -53,6 +53,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     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<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -207,6 +208,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -225,6 +227,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -838,6 +841,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     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<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -992,6 +996,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1010,6 +1015,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1598,11 +1604,11 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
             file: "file";
             text: "text";
             color: "color";
+            image: "image";
             switch: "switch";
             email: "email";
             date: "date";
             richText: "richText";
-            image: "image";
             multiImage: "multiImage";
             video: "video";
             link: "link";
@@ -1686,11 +1692,11 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
             file: "file";
             text: "text";
             color: "color";
+            image: "image";
             switch: "switch";
             email: "email";
             date: "date";
             richText: "richText";
-            image: "image";
             multiImage: "multiImage";
             video: "video";
             link: "link";
@@ -1837,6 +1843,13 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteFunctionFile">;
     path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertDataFile">;
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteDataFile">;
+    path: z.ZodString;
 }, z.core.$strip>], "type">;
 export type Operation = z.infer<typeof operation>;
 export type OperationType = Operation['type'];
@@ -1895,6 +1908,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     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<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -2049,6 +2063,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -2067,6 +2082,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -2655,11 +2671,11 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
             file: "file";
             text: "text";
             color: "color";
+            image: "image";
             switch: "switch";
             email: "email";
             date: "date";
             richText: "richText";
-            image: "image";
             multiImage: "multiImage";
             video: "video";
             link: "link";
@@ -2743,11 +2759,11 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
             file: "file";
             text: "text";
             color: "color";
+            image: "image";
             switch: "switch";
             email: "email";
             date: "date";
             richText: "richText";
-            image: "image";
             multiImage: "multiImage";
             video: "video";
             link: "link";
@@ -2894,6 +2910,13 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteFunctionFile">;
     path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertDataFile">;
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteDataFile">;
+    path: z.ZodString;
 }, z.core.$strip>], "type">>;
 export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"upsertElement">;
@@ -2947,6 +2970,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     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<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -3101,6 +3125,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -3119,6 +3144,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

@@ -1,5 +1,6 @@
 import { actionOps } from "./actions/index.js";
 import { connectorOps } from "./connectors/index.js";
+import { dataOps } from "./data/index.js";
 import { functionOps } from "./functions/index.js";
 import { elementOps } from "./schema/operations.js";
 import { registerSharedSchemaIds } from "./schemaIds.js";
@@ -57,7 +58,9 @@ var operation = z.discriminatedUnion("type", [
 	actionOps.patchAction,
 	actionOps.deleteAction,
 	functionOps.upsertFunctionFile,
-	functionOps.deleteFunctionFile
+	functionOps.deleteFunctionFile,
+	dataOps.upsertDataFile,
+	dataOps.deleteDataFile
 ]);
 var STYLE_OP_TYPES = new Set(Object.keys(styleOps));
 var isStyleOp = (type) => STYLE_OP_TYPES.has(type);

package/dist/modules/mcp/tools/operations/schema/elements/patchElement.d.ts

@@ -25,6 +25,7 @@ export declare const patchElementOp: z.ZodObject<{
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     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>;
 export type PatchElement = z.infer<typeof patchElementOp>;
 export declare const patchElement: (space: Space, env: Env, op: PatchElement) => OpResult;

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

@@ -1,7 +1,7 @@
 import { findRootByRef, invalidateIndex, resolveRef } from "../../../../helpers/space.js";
 import { pageUri } from "../../../../helpers/uris.js";
 import { empty, fail } from "../../../../helpers/opResult.js";
-import { elementAnchor, elementFlag, elementMotion, elementRuntime, initialStateInput, styleRefs } from "../shared.js";
+import { elementAnchor, elementFlag, elementMotion, elementQuiet, elementRuntime, initialStateInput, styleRefs } from "../shared.js";
 import { guardNewRef, writeInitialState } from "../write.js";
 import { flagGateOf } from "@plitzi/sdk-authoring";
 import { z } from "zod";
@@ -21,7 +21,8 @@ var patchElementOp = z.object({
 	runtime: elementRuntime.optional(),
 	flag: elementFlag.nullable().optional(),
 	anchor: elementAnchor.nullable().optional().describe("null removes it"),
-	motion: elementMotion.nullable().optional().describe("null removes it")
+	motion: elementMotion.nullable().optional().describe("null removes it"),
+	quiet: elementQuiet.nullable().optional()
 }).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 = findRootByRef(space.schema, op.pageRef);
@@ -59,6 +60,8 @@ var patchElement = (space, env, op) => {
 	else if (op.anchor !== void 0) el.definition.anchor = op.anchor;
 	if (op.motion === null) Reflect.deleteProperty(el.definition, "motion");
 	else if (isMotion(op.motion)) el.definition.motion = op.motion;
+	if (op.quiet === null) Reflect.deleteProperty(el.definition, "quiet");
+	else if (op.quiet !== void 0) el.definition.quiet = op.quiet;
 	return {
 		...empty(),
 		updated: 1,

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

@@ -37,6 +37,7 @@ var upsertElement = (space, env, op) => {
 		if (op.element.flag !== void 0) existing.definition.flag = flagGateOf(op.element.flag, `Element "${op.element.ref}"`);
 		if (op.element.anchor !== void 0) existing.definition.anchor = op.element.anchor;
 		if (isMotion(op.element.motion)) existing.definition.motion = op.element.motion;
+		if (op.element.quiet !== void 0) existing.definition.quiet = op.element.quiet;
 		return {
 			...empty(),
 			updated: 1,

package/dist/modules/mcp/tools/operations/schema/interactions/patchInteractionNode.d.ts

@@ -15,6 +15,7 @@ export declare const patchInteractionNodeOp: z.ZodObject<{
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/modules/mcp/tools/operations/schema/interactions/upsertInteractionFlow.d.ts

@@ -23,6 +23,7 @@ export declare const upsertInteractionFlowOp: z.ZodObject<{
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/modules/mcp/tools/operations/schema/operations.d.ts

@@ -53,6 +53,7 @@ export declare const elementOps: {
         flag: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         anchor: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         motion: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>>;
+        quiet: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodArray<import('zod').ZodString>>>;
     }, import('zod/v4/core').$strip>;
     deleteElement: import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteElement">;
@@ -223,6 +224,7 @@ export declare const elementOps: {
                 skip: "skip";
                 parallel: "parallel";
                 queue: "queue";
+                latest: "latest";
             }>>;
             elementId: import('zod').ZodOptional<import('zod').ZodString>;
             preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
@@ -242,6 +244,7 @@ export declare const elementOps: {
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: import('zod').ZodOptional<import('zod').ZodString>;
         preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;

package/dist/modules/mcp/tools/operations/schema/shared.d.ts

@@ -22,6 +22,7 @@ export interface ElementInput {
     anchor?: string;
     /** Checked by `motionProblems`: what arrives here is one, which `isMotion` narrows it to where it is written. */
     motion?: Record<string, unknown>;
+    quiet?: string[];
     children?: ElementInput[];
 }
 export declare const styleRefs: z.ZodObject<{
@@ -49,6 +50,8 @@ export declare const elementAnchor: z.ZodString;
  * refused with the list of right ones, and the guide's Motion section names them all.
  */
 export declare const elementMotion: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** Suggestions' codes an element is not offered, written that way on purpose; never a problem's code. */
+export declare const elementQuiet: z.ZodArray<z.ZodString>;
 export declare const initialStateInput: z.ZodObject<{
     styleVariant: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>>;
     visibility: z.ZodOptional<z.ZodBoolean>;
@@ -75,6 +78,7 @@ export declare const elementShape: {
     flag: z.ZodOptional<z.ZodString>;
     anchor: z.ZodOptional<z.ZodString>;
     motion: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    quiet: z.ZodOptional<z.ZodArray<z.ZodString>>;
 };
 export declare const elementInput: z.ZodType<ElementInput>;
 export declare const position: z.ZodEnum<{
@@ -124,6 +128,7 @@ export declare const interactionNode: z.ZodObject<{
         skip: "skip";
         parallel: "parallel";
         queue: "queue";
+        latest: "latest";
     }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/modules/mcp/tools/operations/schema/shared.js

@@ -1,7 +1,9 @@
+import { isSuggestionCode } from "@plitzi/sdk-authoring";
 import { z } from "zod";
 import { FLAG_GATE_PATTERN } from "@plitzi/sdk-shared/flags";
 import { ANCHOR_PATTERN } from "@plitzi/sdk-shared/schema/anchor";
 import { motionProblems } from "@plitzi/sdk-shared/schema/motion";
+import { WHILE_RUNNING_MODES } from "@plitzi/sdk-shared/types/SchemaTypes";
 //#region src/modules/mcp/tools/operations/schema/shared.ts
 var combinator = z.enum(["and", "or"]);
 var operator = z.enum([
@@ -84,6 +86,13 @@ var elementMotion = z.record(z.string(), z.unknown()).superRefine((motion, ctx)
 		message: problem
 	});
 }).describe("{enter,on,duration,delay,stagger,loop} — guide: Motion");
+/** Suggestions' codes an element is not offered, written that way on purpose; never a problem's code. */
+var elementQuiet = z.array(z.string()).superRefine((codes, ctx) => {
+	for (const code of codes.filter((code) => !isSuggestionCode(code))) ctx.addIssue({
+		code: "custom",
+		message: `"${code}" is no suggestion's code`
+	});
+}).describe("Suggestion codes not offered on it, e.g. [\"repeated-shape\"]");
 var initialStateInput = z.object({
 	styleVariant: styleVariantInput.optional().describe("Variant each attached class uses: { className: { base|slot: variantName | [names] } }"),
 	visibility: z.boolean().optional().describe("Initial visibility of the element")
@@ -99,7 +108,8 @@ var elementShape = {
 	runtime: elementRuntime.optional(),
 	flag: elementFlag.optional(),
 	anchor: elementAnchor.optional(),
-	motion: elementMotion.optional()
+	motion: elementMotion.optional(),
+	quiet: elementQuiet.optional()
 };
 var elementInput = z.lazy(() => z.object({
 	...elementShape,
@@ -147,13 +157,9 @@ var interactionNode = z.object({
 	params: z.record(z.string(), z.unknown()).optional(),
 	enabled: z.boolean().optional(),
 	when: ruleGroup.optional().describe("QueryBuilder RuleGroup gating this step (validated structurally)"),
-	whileRunning: z.enum([
-		"skip",
-		"parallel",
-		"queue"
-	]).optional().describe("Trigger only: a refiring while this flow runs"),
+	whileRunning: z.enum(WHILE_RUNNING_MODES).optional().describe("Trigger only: a refiring while this flow runs"),
 	elementId: z.string().optional().describe("Element whose callback this step invokes, by name; defaults to this element"),
 	preview: z.record(z.string(), z.unknown()).optional()
 });
 //#endregion
-export { bindingCategory, bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, elementRuntime, elementShape, initialStateInput, interactionNode, interactionNodeType, position, ruleGroup, scalar, styleRefs, styleVariantInput };
+export { bindingCategory, bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, elementQuiet, elementRuntime, elementShape, initialStateInput, interactionNode, interactionNodeType, position, ruleGroup, scalar, styleRefs, styleVariantInput };

package/dist/modules/mcp/tools/operations/schema/translator.js

@@ -2,8 +2,8 @@ import { computeVersion } from "../../../helpers/computeVersion.js";
 import { descendantCount, elementById, getLayoutElements, getPageElements, nameOf, orderedChildren, pageFoldersOf, pageRefOfElement, pagesUsingLayout, slugRouteParams, spaceIndex, strOr } from "../../../helpers/space.js";
 import { bindingsToAI, flowsFromInteractions } from "../../../helpers/interactions.js";
 import { definitionToAI, globalStylesForType, idStyleToAI } from "../style/translator.js";
-import { flagSpecOf, splitNotificationsCss } from "@plitzi/sdk-authoring";
 import { descendants } from "@plitzi/sdk-schema/helpers/elementTree";
+import { flagSpecOf, splitNotificationsCss } from "@plitzi/sdk-authoring";
 //#region src/modules/mcp/tools/operations/schema/translator.ts
 var splitClasses = (value) => value ? value.split(/\s+/).filter(Boolean) : [];
 var propsOf = (el) => {

package/dist/modules/mcp/tools/operations/schema/write.js

@@ -1,8 +1,8 @@
 import { findRootByRef, indexAddElement, resolveRef } from "../../../helpers/space.js";
 import { folderUri, foldersUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from "../../../helpers/uris.js";
 import { fail } from "../../../helpers/opResult.js";
-import { flagGateOf } from "@plitzi/sdk-authoring";
 import { documentIds } from "@plitzi/sdk-schema/helpers/components";
+import { flagGateOf } from "@plitzi/sdk-authoring";
 import { isMotion } from "@plitzi/sdk-shared/schema/motion";
 import { elementIdConflict, isValidElementId } from "@plitzi/sdk-schema/helpers/elementId";
 import FlatMap from "@plitzi/sdk-schema/helpers/FlatMap";
@@ -69,7 +69,8 @@ var createElement = (space, page, input, anchorId, drop) => {
 			...input.runtime === void 0 ? {} : { runtime: input.runtime },
 			...input.flag === void 0 ? {} : { flag: flagGateOf(input.flag, `Element "${input.ref}"`) },
 			...input.anchor === void 0 ? {} : { anchor: input.anchor },
-			...isMotion(input.motion) ? { motion: input.motion } : {}
+			...isMotion(input.motion) ? { motion: input.motion } : {},
+			...input.quiet === void 0 ? {} : { quiet: input.quiet }
 		}
 	};
 	if (!new FlatMap({ flat: space.schema.flat }).addElement(el, anchorId, drop)) return false;

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

@@ -1,6 +1,6 @@
 import { actionAccess, actionField, actionLimits, actionNode, actionTriggerParams } from "./actions/document.js";
 import { connectorConnection, readEndpoint, writeEndpoint } from "./connectors/manifest.js";
-import { bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, initialStateInput, interactionNode, position, ruleGroup, styleRefs, styleVariantInput } from "./schema/shared.js";
+import { bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, elementQuiet, initialStateInput, interactionNode, position, ruleGroup, styleRefs, styleVariantInput } from "./schema/shared.js";
 import { ancestors, ancestorsPatch, cssMap, cssPatchMap, definitionSlot, definitionSlotPatch, displayModeCss, displayModeCssPatch, themeValue } from "./style/shared.js";
 import { z } from "zod";
 //#region src/modules/mcp/tools/operations/schemaIds.ts
@@ -19,13 +19,13 @@ import { z } from "zod";
 *  because the `definitions` entry and the ref cost more than the single copy they replace (measured, and reverted).
 *
 *  The ids are the names the MODEL reads in the refs, so they are written for it: `Element`, not `ElementInput`.
-*  This runs once, at module load of the op vocabulary, so every conversion path benefits — the MCP tools list and
-*  the co-worker's own tool-schema converter alike. */
+*  This runs once, at module load of the op vocabulary, so every conversion path benefits. */
 var SHARED_SCHEMAS = [
 	[elementInput, "Element"],
 	[elementFlag, "ElementFlag"],
 	[elementAnchor, "ElementAnchor"],
 	[elementMotion, "ElementMotion"],
+	[elementQuiet, "ElementQuiet"],
 	[ruleGroup, "RuleGroup"],
 	[styleRefs, "StyleRefs"],
 	[initialStateInput, "InitialState"],

package/dist/modules/mcp/tools/operations/style/write.js

@@ -1,5 +1,5 @@
-import { expandShorthand, expandShorthandPatch } from "../../../catalogs/index.js";
 import { defUri, defsUri, globalUri, globalsUri, idUri, idsUri, styleVarUri, styleVarsUri } from "../../../helpers/uris.js";
+import { expandShorthand, expandShorthandPatch } from "../../../catalogs/index.js";
 import { fail } from "../../../helpers/opResult.js";
 import processSelector from "@plitzi/sdk-style/helpers/processSelector";
 //#region src/modules/mcp/tools/operations/style/write.ts

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

@@ -53,6 +53,7 @@ export declare const previewShape: {
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         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<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -207,6 +208,7 @@ export declare const previewShape: {
                 skip: "skip";
                 parallel: "parallel";
                 queue: "queue";
+                latest: "latest";
             }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -225,6 +227,7 @@ export declare const previewShape: {
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

@@ -55,6 +55,7 @@ export declare const renderShape: {
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         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<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -209,6 +210,7 @@ export declare const renderShape: {
                 skip: "skip";
                 parallel: "parallel";
                 queue: "queue";
+                latest: "latest";
             }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -227,6 +229,7 @@ export declare const renderShape: {
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

@@ -53,6 +53,7 @@ export declare const screenshotShape: {
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         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<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -207,6 +208,7 @@ export declare const screenshotShape: {
                 skip: "skip";
                 parallel: "parallel";
                 queue: "queue";
+                latest: "latest";
             }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -225,6 +227,7 @@ export declare const screenshotShape: {
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -813,11 +816,11 @@ export declare const screenshotShape: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";
@@ -901,11 +904,11 @@ export declare const screenshotShape: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";
@@ -1052,6 +1055,13 @@ export declare const screenshotShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteFunctionFile">;
         path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertDataFile">;
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteDataFile">;
+        path: z.ZodString;
     }, z.core.$strip>], "type">>>;
     viewport: z.ZodOptional<z.ZodEnum<{
         desktop: "desktop";

package/dist/modules/mcp/tools/shared/newSuggestions.d.ts

@@ -1,7 +1,7 @@
 import { Space } from '../../helpers';
 /**
  * The shorter ways to the same page a batch opened up — a header the agent just copied onto a third page, a button it
- * gave a text child — and none the space already had: those were said when they appeared, and saying them on every
- * batch would bury the new ones. Not problems: nothing here blocks anything.
+ * gave a text child, a class it left nothing wearing — and none the space already had: those were said when they
+ * appeared, and saying them on every batch would bury the new ones. Not problems: nothing here blocks anything.
  */
 export declare const newSuggestions: (before: Space, after: Space) => string[];

package/dist/modules/mcp/tools/shared/newSuggestions.js

@@ -1,20 +1,25 @@
 import { suggestSpace } from "@plitzi/sdk-authoring";
 //#region src/modules/mcp/tools/shared/newSuggestions.ts
-var keyOf = ({ code, elementIds }) => `${code}|${[...elementIds].sort().join(",")}`;
+/**
+* What a suggestion is about, one key each: its elements together, or — for one about declarations, which names many
+* at once — each class, token or component on its own, so the one a batch just left unused is new beside the ones the
+* space already had.
+*/
+var keysOf = ({ code, elementIds, subjects }) => subjects?.length ? subjects.map((subject) => `${code}|${subject}`) : [`${code}|${[...elementIds].sort().join(",")}`];
 /**
 * The shorter ways to the same page a batch opened up — a header the agent just copied onto a third page, a button it
-* gave a text child — and none the space already had: those were said when they appeared, and saying them on every
-* batch would bury the new ones. Not problems: nothing here blocks anything.
+* gave a text child, a class it left nothing wearing — and none the space already had: those were said when they
+* appeared, and saying them on every batch would bury the new ones. Not problems: nothing here blocks anything.
 */
 var newSuggestions = (before, after) => {
 	const had = new Set(suggestSpace({
 		schema: before.schema,
 		style: before.style
-	}).map(keyOf));
+	}).flatMap(keysOf));
 	return suggestSpace({
 		schema: after.schema,
 		style: after.style
-	}).filter((suggestion) => !had.has(keyOf(suggestion))).map(({ code, message, saves }) => `[${code}] ${message}${saves > 0 ? ` (saves ${String(saves)} element${saves === 1 ? "" : "s"})` : ""}`);
+	}).filter((suggestion) => keysOf(suggestion).some((key) => !had.has(key))).map(({ code, message, saves }) => `[${code}] ${message}${saves > 0 ? ` (saves ${String(saves)} element${saves === 1 ? "" : "s"})` : ""}`);
 };
 //#endregion
 export { newSuggestions };

package/dist/modules/mcp/tools/shared/newSuggestions.test.d.ts

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

package/dist/modules/mcp/tools/shared/tool.d.ts

@@ -6,9 +6,9 @@ import { McpUiToolMeta } from '@modelcontextprotocol/ext-apps';
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { ActionRunReport } from '@plitzi/sdk-shared';
 /** Everything a tool needs at call time: the loaded space, the target environment, and the persisters (only the
- *  write tools use them). Built by whoever hosts the tools — the standalone MCP server or the in-process AI
- *  engine — so a tool's behavior never touches spaceId resolution or adapters directly. `spaceId`, `preview` and
- *  `screenshot` are present only when the host wired them (the visual-preview tools need them). */
+ *  write tools use them). Built by whoever hosts the tools — the MCP server, or a host calling them in-process — so
+ *  a tool's behavior never touches spaceId resolution or adapters directly. `spaceId`, `preview` and `screenshot`
+ *  are present only when the host wired them (the visual-preview tools need them). */
 export interface ToolContext {
     space: Space;
     env: Env;
@@ -16,7 +16,7 @@ export interface ToolContext {
     spaceId?: number;
     preview?: PreviewClient;
     screenshot?: ScreenshotClient;
-    /** Where a rendered widget loads its external resources from, when the host wired one (see `mcpAi.proxy`). Only
+    /** Where a rendered widget loads its external resources from, when the host wired one (see `McpOptions.proxy`). Only
      *  plitzi_render uses it: a widget renders inside the host's sandbox, where an undeclared origin cannot be
      *  reached at all. */
     proxy?: ResourceProxy;
@@ -32,7 +32,8 @@ export type ToolRequires = 'screenshot';
 export declare const imageResult: (images: ScreenshotImage[], meta: unknown) => CallToolResult;
 /** What a tool author writes: identity, the input schema that is the contract sent to the agent, and a typed
  *  `run` (its args are inferred from `inputShape`, so no cast). `access` marks whether it persists — a 'write'
- *  tool previews (dryRun) in plan mode and can persist in build mode; a 'read' tool never writes. */
+ *  tool can persist (or only preview, with `dryRun`); a 'read' tool never writes. The server advertises it as the
+ *  tool's `readOnlyHint`. */
 export interface ToolSpec<Shape extends ZodRawShape> {
     name: string;
     title: string;
@@ -54,7 +55,7 @@ export interface ToolSpec<Shape extends ZodRawShape> {
      *  something that cannot work. */
     runPublic?: (input: z.infer<ZodObject<Shape>>, env: Env) => unknown;
 }
-/** What the registry holds and the hosts register from: the same metadata plus a type-erased `execute` that
+/** What the registry holds and the server registers from: the same metadata plus a type-erased `execute` that
  *  validates raw args against the shape and delegates to the typed `run`. Produced by `defineTool`. */
 export interface ToolDef {
     name: string;

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

@@ -1,8 +1,8 @@
+import { componentView, findComponentByRef } from "../../../helpers/components.js";
+import { findElementByRef, findFolderByRef, findPageByRef, findRootByRef, folderAncestorIds, getLayoutElements, getPageElements, pageFoldersOf, resolveRef, routeParamNames } from "../../../helpers/space.js";
 import { observedDataSources, observedInteractionActions } from "../../../catalogs/observed.js";
 import { buildTypeRegistry } from "../../../catalogs/registry.js";
 import { elementTypeNames } from "../../../catalogs/index.js";
-import { componentView, findComponentByRef } from "../../../helpers/components.js";
-import { findElementByRef, findFolderByRef, findPageByRef, findRootByRef, folderAncestorIds, getLayoutElements, getPageElements, pageFoldersOf, resolveRef, routeParamNames } from "../../../helpers/space.js";
 import { MAX_OPS } from "../../operations/index.js";
 import { batchDeclaredElements, batchDeclaredFolders, batchDeclaredPages, batchDeclaredVariants, batchDeclaredVars } from "./batch.js";
 import { checkObservedName, warnOnce } from "./context.js";