@plitzi/sdk-mcp 0.37.2 → 0.37.3

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

@@ -19,6 +19,11 @@ export declare const upsertInteractionFlowOp: z.ZodObject<{
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+        whileRunning: z.ZodOptional<z.ZodEnum<{
+            skip: "skip";
+            parallel: "parallel";
+            queue: "queue";
+        }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;

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

@@ -201,6 +201,11 @@ export declare const elementOps: {
             params: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
             enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
             when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+            whileRunning: import('zod').ZodOptional<import('zod').ZodEnum<{
+                skip: "skip";
+                parallel: "parallel";
+                queue: "queue";
+            }>>;
             elementId: import('zod').ZodOptional<import('zod').ZodString>;
             preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
         }, import('zod/v4/core').$strip>>;
@@ -215,6 +220,11 @@ export declare const elementOps: {
         params: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
         enabled: import('zod').ZodOptional<import('zod').ZodBoolean>;
         when: import('zod').ZodOptional<import('zod').ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, import('zod/v4/core').$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+        whileRunning: import('zod').ZodOptional<import('zod').ZodEnum<{
+            skip: "skip";
+            parallel: "parallel";
+            queue: "queue";
+        }>>;
         elementId: import('zod').ZodOptional<import('zod').ZodString>;
         preview: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>;
     }, import('zod/v4/core').$strip>;
@@ -233,6 +243,8 @@ export declare const elementOps: {
             localStorage: "localStorage";
             sessionStorage: "sessionStorage";
         }>>;
+        transientState: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodString>>;
+        paintedState: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodString>>;
         userProvider: import('zod').ZodOptional<import('zod').ZodString>;
         tokenStorage: import('zod').ZodOptional<import('zod').ZodEnum<{
             "": "";
@@ -255,5 +267,20 @@ export declare const elementOps: {
             strict: "strict";
         }>>;
         sessionRevalidateSeconds: import('zod').ZodOptional<import('zod').ZodNumber>;
+        channels: import('zod').ZodOptional<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodNullable<import('zod').ZodObject<{
+            access: import('zod').ZodObject<{
+                mode: import('zod').ZodEnum<{
+                    public: "public";
+                    session: "session";
+                    role: "role";
+                }>;
+                permissions: import('zod').ZodOptional<import('zod').ZodArray<import('zod').ZodString>>;
+            }, import('zod/v4/core').$strip>;
+            publish: import('zod').ZodOptional<import('zod').ZodEnum<{
+                server: "server";
+                clients: "clients";
+            }>>;
+            presence: import('zod').ZodOptional<import('zod').ZodBoolean>;
+        }, import('zod/v4/core').$strip>>>>;
     }, import('zod/v4/core').$strip>;
 };

package/dist/modules/mcp/tools/operations/schema/pages/deleteLayout.js

@@ -1,6 +1,7 @@
-import { descendantIds, findLayoutByRef, indexRemoveLayout, pagesUsingLayout } from "../../../../helpers/space.js";
+import { findLayoutByRef, indexRemoveLayout, pagesUsingLayout } from "../../../../helpers/space.js";
 import { layoutsUri, pageUri } from "../../../../helpers/uris.js";
 import { empty, fail } from "../../../../helpers/opResult.js";
+import { descendants } from "@plitzi/sdk-schema/helpers/elementTree";
 import { z } from "zod";
 //#region src/modules/mcp/tools/operations/schema/pages/deleteLayout.ts
 var deleteLayoutOp = z.object({
@@ -19,10 +20,10 @@ var deleteLayout = (space, env, op) => {
 	*/
 	const inUse = pagesUsingLayout(space.schema, layout.id);
 	if (inUse.length > 0) return fail("ref", `Layout "${op.ref}" is still used by ${inUse.length} page(s): ${inUse.map((page) => page.id).join(", ")}`, "Detach them first with upsertPage { layout: null }, or point them at another shell");
-	const descendantElementIds = descendantIds(space.schema, layout.id);
-	const descendants = descendantElementIds.map((id) => space.schema.flat[id]);
-	for (const id of [...descendantElementIds, layout.id]) Reflect.deleteProperty(space.schema.flat, id);
-	indexRemoveLayout(space.schema, layout, descendants);
+	const removedIds = descendants(space.schema.flat, layout.id);
+	const removed = removedIds.map((id) => space.schema.flat[id]);
+	for (const id of [...removedIds, layout.id]) Reflect.deleteProperty(space.schema.flat, id);
+	indexRemoveLayout(space.schema, layout, removed);
 	return {
 		...empty(),
 		deleted: 1,

package/dist/modules/mcp/tools/operations/schema/pages/deletePage.js

@@ -1,6 +1,7 @@
-import { descendantIds, findPageByRef, indexRemovePage } from "../../../../helpers/space.js";
+import { findPageByRef, indexRemovePage } from "../../../../helpers/space.js";
 import { pageUri, pagesUri } from "../../../../helpers/uris.js";
 import { empty, fail } from "../../../../helpers/opResult.js";
+import { descendants } from "@plitzi/sdk-schema/helpers/elementTree";
 import { z } from "zod";
 //#region src/modules/mcp/tools/operations/schema/pages/deletePage.ts
 var deletePageOp = z.object({
@@ -10,11 +11,11 @@ var deletePageOp = z.object({
 var deletePage = (space, env, op) => {
 	const page = findPageByRef(space.schema, op.ref);
 	if (!page) return fail("ref", `Page "${op.ref}" not found`, "Read the pages resource for valid refs");
-	const descendantElementIds = descendantIds(space.schema, page.id);
-	const descendants = descendantElementIds.map((id) => space.schema.flat[id]);
-	for (const id of [...descendantElementIds, page.id]) Reflect.deleteProperty(space.schema.flat, id);
+	const removedIds = descendants(space.schema.flat, page.id);
+	const removed = removedIds.map((id) => space.schema.flat[id]);
+	for (const id of [...removedIds, page.id]) Reflect.deleteProperty(space.schema.flat, id);
 	space.schema.pages = space.schema.pages.filter((id) => id !== page.id);
-	indexRemovePage(space.schema, page, descendants);
+	indexRemovePage(space.schema, page, removed);
 	return {
 		...empty(),
 		deleted: 1,

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

@@ -9,6 +9,8 @@ export declare const patchSettingsOp: z.ZodObject<{
         localStorage: "localStorage";
         sessionStorage: "sessionStorage";
     }>>;
+    transientState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paintedState: z.ZodOptional<z.ZodArray<z.ZodString>>;
     userProvider: z.ZodOptional<z.ZodString>;
     tokenStorage: z.ZodOptional<z.ZodEnum<{
         "": "";
@@ -31,6 +33,21 @@ export declare const patchSettingsOp: z.ZodObject<{
         strict: "strict";
     }>>;
     sessionRevalidateSeconds: z.ZodOptional<z.ZodNumber>;
+    channels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+        access: z.ZodObject<{
+            mode: z.ZodEnum<{
+                public: "public";
+                session: "session";
+                role: "role";
+            }>;
+            permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        publish: z.ZodOptional<z.ZodEnum<{
+            server: "server";
+            clients: "clients";
+        }>>;
+        presence: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type PatchSettings = z.infer<typeof patchSettingsOp>;
 export declare const patchSettings: (space: Space, env: Env, op: PatchSettings) => OpResult;

package/dist/modules/mcp/tools/operations/schema/settings/patchSettings.js

@@ -1,6 +1,7 @@
 import { settingsUri } from "../../../../helpers/uris.js";
-import { empty } from "../../../../helpers/opResult.js";
+import { empty, fail } from "../../../../helpers/opResult.js";
 import { z } from "zod";
+import { channelProblems } from "@plitzi/sdk-shared/realtime";
 //#region src/modules/mcp/tools/operations/schema/settings/patchSettings.ts
 var userProvider = z.string();
 var storage = z.enum([
@@ -8,11 +9,25 @@ var storage = z.enum([
 	"sessionStorage",
 	""
 ]);
+var channel = z.object({
+	access: z.object({
+		mode: z.enum([
+			"public",
+			"session",
+			"role"
+		]),
+		permissions: z.array(z.string()).optional()
+	}),
+	publish: z.enum(["clients", "server"]).optional(),
+	presence: z.boolean().optional()
+});
 var patchSettingsOp = z.object({
 	type: z.literal("patchSettings"),
 	customCss: z.string().optional().describe("Raw global CSS for the whole space (keyframes, @font-face, resets)"),
-	keepState: z.boolean().optional().describe("Persist element state across reloads"),
+	keepState: z.boolean().optional().describe("Keep runtime state (setState keys) across reloads"),
 	stateStorage: z.enum(["localStorage", "sessionStorage"]).optional(),
+	transientState: z.array(z.string()).optional().describe("Top-level state keys never kept"),
+	paintedState: z.array(z.string()).optional().describe("Kept keys the first paint shows"),
 	userProvider: userProvider.optional().describe("Auth provider: \"basic\" for an HTTP+JSON backend, a registered name, or \"\" to disable auth"),
 	tokenStorage: storage.optional(),
 	loginUrl: z.string().optional(),
@@ -27,12 +42,26 @@ var patchSettingsOp = z.object({
 	sessionHintCookie: z.string().optional().describe("Readable cookie holding only session expiries, so a page can tell nobody is signed in with no request"),
 	sessionExchangeUrl: z.string().optional().describe("Where to hand a browser-obtained credential so the server issues its own session (client-side IdPs)"),
 	sessionGate: z.enum(["optimistic", "strict"]).optional().describe("Render from the stored session and confirm behind it (default), or wait for the confirmation"),
-	sessionRevalidateSeconds: z.number().optional()
-}).describe("Merge space-level settings: the global CSS (customCss) and the state/auth (user-provider) configuration. Only the fields you pass change; the rest are preserved. Use customCss for site-wide CSS, never to style one element (attach a definition for that).");
+	sessionRevalidateSeconds: z.number().optional(),
+	channels: z.record(z.string(), channel.nullable()).optional().describe("Realtime channels by topic pattern (`board:{id}`); null removes one. See the guide")
+}).describe("Merge space-level settings — global CSS, kept state, auth, realtime channels. Only the fields sent change. customCss is for site-wide CSS, never to style one element (attach a definition for that).");
+/** The space's channels with the patch merged in, pattern by pattern — `null` takes one out. */
+var mergeChannels = (current, patch) => {
+	const merged = {
+		...current,
+		...patch
+	};
+	return Object.fromEntries(Object.entries(merged).filter((entry) => entry[1] !== null));
+};
 var patchSettings = (space, env, op) => {
-	const { type, ...patch } = op;
+	const { type, channels, ...patch } = op;
+	for (const [pattern, declaration] of Object.entries(channels ?? {})) {
+		const [problem] = declaration === null ? [] : channelProblems(pattern, declaration);
+		if (problem) return fail(`channels["${pattern}"]`, `Channel "${pattern}": ${problem}.`, "Fix the pattern or declaration and send it again");
+	}
 	const next = { ...space.schema.settings };
 	for (const [key, value] of Object.entries(patch)) next[key] = value;
+	if (channels) next.channels = mergeChannels(space.schema.settings.channels, channels);
 	space.schema.settings = next;
 	return {
 		...empty(),

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

@@ -63,6 +63,7 @@ export declare const position: z.ZodEnum<{
     before: "before";
     after: "after";
 }>;
+export type Position = z.infer<typeof position>;
 export declare const scalar: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
 export declare const bindingCategory: z.ZodEnum<{
     attributes: "attributes";
@@ -100,6 +101,11 @@ export declare const interactionNode: z.ZodObject<{
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     when: z.ZodOptional<z.ZodType<RuleGroup, unknown, z.core.$ZodTypeInternals<RuleGroup, unknown>>>;
+    whileRunning: z.ZodOptional<z.ZodEnum<{
+        skip: "skip";
+        parallel: "parallel";
+        queue: "queue";
+    }>>;
     elementId: z.ZodOptional<z.ZodString>;
     preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;

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

@@ -124,6 +124,11 @@ 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"),
 	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()
 });

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

@@ -1,7 +1,8 @@
 import { computeVersion } from "../../../helpers/computeVersion.js";
-import { descendantCount, descendantIds, elementById, getLayoutElements, getPageElements, nameOf, orderedChildren, pageFoldersOf, pageRefOfElement, pagesUsingLayout, slugRouteParams, spaceIndex, strOr } from "../../../helpers/space.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 { descendants } from "@plitzi/sdk-schema/helpers/elementTree";
 //#region src/modules/mcp/tools/operations/schema/translator.ts
 var splitClasses = (value) => value ? value.split(/\s+/).filter(Boolean) : [];
 var propsOf = (el) => {
@@ -99,7 +100,7 @@ var pageStylesToAI = (schema, style, pageEl) => {
 		types.add(el.definition.type);
 	};
 	collect(pageEl);
-	for (const id of descendantIds(schema, pageEl.id)) {
+	for (const id of descendants(schema.flat, pageEl.id)) {
 		const el = elementById(schema, id);
 		if (el) collect(el);
 	}

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

@@ -1,7 +1,7 @@
-import { ElementInput, InitialStateInput } from './shared';
+import { ElementInput, InitialStateInput, Position } from './shared';
 import { OpResult, Space } from '../../../helpers';
 import { Env } from '../../../types';
-import { Element } from '@plitzi/sdk-shared';
+import { DropPosition, Element } from '@plitzi/sdk-shared';
 export declare const ID_REF_HINT: string;
 /** Every name in an element input tree (the element plus its nested children) — each becomes an element's id. */
 export declare const collectInputRefs: (input: ElementInput) => string[];
@@ -10,10 +10,15 @@ export declare const collectInputRefs: (input: ElementInput) => string[];
  *  the builder and the schema validator enforce. Null when the name is usable. */
 export declare const guardNewRef: (space: Space, ref: string, field: string) => OpResult | null;
 export { folderUri, foldersUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from '../../../helpers';
-export declare const removeFromParent: (space: Space, child: Element) => void;
-export declare const placeChild: (parent: Element, childId: string, index?: number) => void;
+/** Where an op's `position` puts an element, in the vocabulary of the tree operations every writer shares. */
+export declare const DROP_POSITION: Record<Position, DropPosition>;
 export declare const writeInitialState: (el: Element, input: InitialStateInput, merge: boolean) => void;
-export declare const createElement: (space: Space, page: Element, input: ElementInput, parent: Element, index: number | undefined) => void;
+/**
+ * Creates an element from its input, and its children inside it, through `FlatMap` — the same insertion the builder,
+ * the server and `authorSpace` make, so a tree the MCP writes is held to exactly their rules. False when the anchor
+ * cannot take it: before/after an element with no parent, or inside one that holds no items.
+ */
+export declare const createElement: (space: Space, page: Element, input: ElementInput, anchorId: string, drop: DropPosition) => boolean;
 /** The key an interaction node must store to reach a target element — which is simply that element's name, since
  *  the name it is addressed by and the key the runtime registers callbacks under are now the same thing. A target
  *  that resolves to no element is left as written: it is a source module (`space`, `state`) or a key only a plugin

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

@@ -2,6 +2,7 @@ import { findRootByRef, indexAddElement, resolveRef } from "../../../helpers/spa
 import { folderUri, foldersUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from "../../../helpers/uris.js";
 import { fail } from "../../../helpers/opResult.js";
 import { elementIdConflict, isValidElementId } from "@plitzi/sdk-schema/helpers/elementId";
+import FlatMap from "@plitzi/sdk-schema/helpers/FlatMap";
 //#region src/modules/mcp/tools/operations/schema/write.ts
 var ID_REF_HINT = "Start with a letter, then letters, numbers, hyphens and underscores (e.g. \"hero-cta\" or \"food_item\"). The name IS the element id, which the runtime embeds in source names like `apiContainer_<id>.field` and in interaction targets — a dot would split those paths (an underscore is fine: the FIRST `_` separates the type from the id, and element types carry none, so extra underscores are unambiguous).";
 var TAKEN_HINT = "A name must be unique across the space — pick a different one, or address the existing element by this name.";
@@ -15,14 +16,11 @@ var guardNewRef = (space, ref, field) => {
 	if (!conflict) return null;
 	return isValidElementId(ref) ? fail(field, conflict, TAKEN_HINT) : fail(field, conflict, ID_REF_HINT);
 };
-var removeFromParent = (space, child) => {
-	const parent = child.definition.parentId ? space.schema.flat[child.definition.parentId] : void 0;
-	if (parent?.definition.items) parent.definition.items = parent.definition.items.filter((id) => id !== child.id);
-};
-var placeChild = (parent, childId, index) => {
-	const items = parent.definition.items ?? (parent.definition.items = []);
-	if (index === void 0 || index < 0 || index >= items.length) items.push(childId);
-	else items.splice(index, 0, childId);
+/** Where an op's `position` puts an element, in the vocabulary of the tree operations every writer shares. */
+var DROP_POSITION = {
+	inside: "inside",
+	before: "top",
+	after: "bottom"
 };
 var writeInitialState = (el, input, merge) => {
 	const current = el.definition.initialState ?? {};
@@ -40,23 +38,26 @@ var writeInitialState = (el, input, merge) => {
 	if (input.visibility !== void 0) next.visibility = input.visibility;
 	el.definition.initialState = next;
 };
-var createElement = (space, page, input, parent, index) => {
+/**
+* Creates an element from its input, and its children inside it, through `FlatMap` — the same insertion the builder,
+* the server and `authorSpace` make, so a tree the MCP writes is held to exactly their rules. False when the anchor
+* cannot take it: before/after an element with no parent, or inside one that holds no items.
+*/
+var createElement = (space, page, input, anchorId, drop) => {
 	const { subType, ...props } = {
 		subType: input.subType,
 		...input.props
 	};
 	const styleSelectors = { base: (input.style?.base ?? []).join(" ") };
 	for (const [slot, classes] of Object.entries(input.style?.slots ?? {})) styleSelectors[slot] = classes.join(" ");
-	const id = input.ref;
 	const el = {
-		id,
+		id: input.ref,
 		attributes: subType === void 0 ? props : {
 			subType,
 			...props
 		},
 		definition: {
 			rootId: page.id,
-			parentId: parent.id,
 			label: input.label ?? input.ref,
 			type: input.type,
 			items: [],
@@ -64,11 +65,10 @@ var createElement = (space, page, input, parent, index) => {
 			...input.runtime === void 0 ? {} : { runtime: input.runtime }
 		}
 	};
-	space.schema.flat[id] = el;
-	placeChild(parent, id, index);
+	if (!new FlatMap({ flat: space.schema.flat }).addElement(el, anchorId, drop)) return false;
 	indexAddElement(space.schema, el, page.id);
 	if (input.initialState) writeInitialState(el, input.initialState, false);
-	for (const child of input.children ?? []) createElement(space, page, child, el, void 0);
+	return (input.children ?? []).every((child) => createElement(space, page, child, el.id, "inside"));
 };
 /** The key an interaction node must store to reach a target element — which is simply that element's name, since
 *  the name it is addressed by and the key the runtime registers callbacks under are now the same thing. A target
@@ -89,4 +89,4 @@ var resolveElement = (space, env, pageRef, ref) => {
 	return { el };
 };
 //#endregion
-export { ID_REF_HINT, collectInputRefs, createElement, folderUri, foldersUri, guardNewRef, layoutsUri, pageUri, pagesUri, placeChild, removeFromParent, resolveElement, resolveTargetRef, schemaVarsUri, settingsUri, writeInitialState };
+export { DROP_POSITION, ID_REF_HINT, collectInputRefs, createElement, folderUri, foldersUri, guardNewRef, layoutsUri, pageUri, pagesUri, resolveElement, resolveTargetRef, schemaVarsUri, settingsUri, writeInitialState };

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

@@ -187,6 +187,11 @@ export declare const previewShape: {
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             enabled: z.ZodOptional<z.ZodBoolean>;
             when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+            whileRunning: z.ZodOptional<z.ZodEnum<{
+                skip: "skip";
+                parallel: "parallel";
+                queue: "queue";
+            }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
@@ -200,6 +205,11 @@ export declare const previewShape: {
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+        whileRunning: z.ZodOptional<z.ZodEnum<{
+            skip: "skip";
+            parallel: "parallel";
+            queue: "queue";
+        }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>, z.ZodObject<{
@@ -216,6 +226,8 @@ export declare const previewShape: {
             localStorage: "localStorage";
             sessionStorage: "sessionStorage";
         }>>;
+        transientState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        paintedState: z.ZodOptional<z.ZodArray<z.ZodString>>;
         userProvider: z.ZodOptional<z.ZodString>;
         tokenStorage: z.ZodOptional<z.ZodEnum<{
             "": "";
@@ -238,6 +250,21 @@ export declare const previewShape: {
             strict: "strict";
         }>>;
         sessionRevalidateSeconds: z.ZodOptional<z.ZodNumber>;
+        channels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+            access: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    public: "public";
+                    session: "session";
+                    role: "role";
+                }>;
+                permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+            publish: z.ZodOptional<z.ZodEnum<{
+                server: "server";
+                clients: "clients";
+            }>>;
+            presence: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>>;
     }, z.core.$strip>, 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]>>>;

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

@@ -189,6 +189,11 @@ export declare const renderShape: {
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             enabled: z.ZodOptional<z.ZodBoolean>;
             when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+            whileRunning: z.ZodOptional<z.ZodEnum<{
+                skip: "skip";
+                parallel: "parallel";
+                queue: "queue";
+            }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
@@ -202,6 +207,11 @@ export declare const renderShape: {
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+        whileRunning: z.ZodOptional<z.ZodEnum<{
+            skip: "skip";
+            parallel: "parallel";
+            queue: "queue";
+        }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>, z.ZodObject<{
@@ -218,6 +228,8 @@ export declare const renderShape: {
             localStorage: "localStorage";
             sessionStorage: "sessionStorage";
         }>>;
+        transientState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        paintedState: z.ZodOptional<z.ZodArray<z.ZodString>>;
         userProvider: z.ZodOptional<z.ZodString>;
         tokenStorage: z.ZodOptional<z.ZodEnum<{
             "": "";
@@ -240,6 +252,21 @@ export declare const renderShape: {
             strict: "strict";
         }>>;
         sessionRevalidateSeconds: z.ZodOptional<z.ZodNumber>;
+        channels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+            access: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    public: "public";
+                    session: "session";
+                    role: "role";
+                }>;
+                permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+            publish: z.ZodOptional<z.ZodEnum<{
+                server: "server";
+                clients: "clients";
+            }>>;
+            presence: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>>;
     }, z.core.$strip>, 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]>>>;

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

@@ -3,15 +3,11 @@ import { RENDER_APP_URI } from "../apps/render/index.js";
 import { emptySpace } from "../helpers/space.js";
 import { proxifyResources } from "../proxy/rewrite.js";
 import { documentOperations } from "./operations/index.js";
-import { applyOperations } from "./apply/dispatch.js";
-import { expandOperations } from "./shared/expandOperations.js";
+import { draftBatch } from "./shared/draftBatch.js";
 import { defineTool } from "./shared/tool.js";
-import { validateOperations } from "./shared/validator/index.js";
-import { auditResources } from "./shared/validator/audit.js";
 import { interactionReport } from "./shared/interactionReport.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
-import { validateSchema } from "@plitzi/sdk-schema/helpers/schemaValidator";
 import { generateCache } from "@plitzi/sdk-style/StyleHelper";
 //#region src/modules/mcp/tools/render.ts
 var HOST_PAGE_REF = "render";
@@ -43,47 +39,15 @@ var renderShape = {
 	renderId: z.string().optional().describe("Handle returned by a previous render. Required with patch:true; it names the widget being changed.")
 };
 var render = (input, options = {}) => {
-	const space = seedSpace();
-	const expansion = expandOperations(input.operations);
-	if (expansion.errors.length > 0) return {
+	const result = draftBatch(seedSpace(), "main", input.operations, "widget");
+	if (!result.ok) return {
 		rendered: false,
-		errors: expansion.errors
+		errors: result.errors,
+		warnings: noWarnings(result.warnings)
 	};
-	const ops = expansion.operations;
-	const validation = validateOperations(space, ops, "widget");
-	if (!validation.valid) return {
-		rendered: false,
-		errors: validation.errors,
-		warnings: noWarnings(validation.warnings)
-	};
-	const outcome = applyOperations(space, "main", ops);
-	if (outcome.errors.length > 0) return {
-		rendered: false,
-		errors: outcome.errors,
-		warnings: noWarnings(validation.warnings)
-	};
-	const integrity = validateSchema(space.schema);
-	if (!integrity.valid) return {
-		rendered: false,
-		errors: integrity.errors.map((error) => ({
-			path: error.elementId ? `schema.${error.elementId}` : "schema",
-			message: error.message,
-			hint: "The authored widget is structurally inconsistent (broken parent/child link or a cycle)."
-		})),
-		warnings: noWarnings(validation.warnings)
-	};
-	const audit = auditResources(space, ops);
+	const { ops, draft: space } = result;
 	const behaviour = interactionReport(space);
-	const warnings = [
-		...validation.warnings,
-		...audit.warnings,
-		...behaviour.warnings
-	];
-	if (audit.errors.length > 0) return {
-		rendered: false,
-		errors: audit.errors,
-		warnings: noWarnings(warnings)
-	};
+	const warnings = [...result.warnings, ...behaviour.warnings];
 	if (options.proxy) warnings.push(...proxifyResources(space, options.proxy));
 	space.style.cache = generateCache(space.style);
 	return {

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

@@ -187,6 +187,11 @@ export declare const screenshotShape: {
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             enabled: z.ZodOptional<z.ZodBoolean>;
             when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+            whileRunning: z.ZodOptional<z.ZodEnum<{
+                skip: "skip";
+                parallel: "parallel";
+                queue: "queue";
+            }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
@@ -200,6 +205,11 @@ export declare const screenshotShape: {
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         when: z.ZodOptional<z.ZodType<import('@plitzi/sdk-shared').RuleGroup, unknown, z.core.$ZodTypeInternals<import('@plitzi/sdk-shared').RuleGroup, unknown>>>;
+        whileRunning: z.ZodOptional<z.ZodEnum<{
+            skip: "skip";
+            parallel: "parallel";
+            queue: "queue";
+        }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>, z.ZodObject<{
@@ -216,6 +226,8 @@ export declare const screenshotShape: {
             localStorage: "localStorage";
             sessionStorage: "sessionStorage";
         }>>;
+        transientState: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        paintedState: z.ZodOptional<z.ZodArray<z.ZodString>>;
         userProvider: z.ZodOptional<z.ZodString>;
         tokenStorage: z.ZodOptional<z.ZodEnum<{
             "": "";
@@ -238,6 +250,21 @@ export declare const screenshotShape: {
             strict: "strict";
         }>>;
         sessionRevalidateSeconds: z.ZodOptional<z.ZodNumber>;
+        channels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
+            access: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    public: "public";
+                    session: "session";
+                    role: "role";
+                }>;
+                permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+            publish: z.ZodOptional<z.ZodEnum<{
+                server: "server";
+                clients: "clients";
+            }>>;
+            presence: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>>;
     }, z.core.$strip>, 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]>>>;
@@ -990,6 +1017,13 @@ export declare const screenshotShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteAction">;
         ref: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertFunctionFile">;
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteFunctionFile">;
+        path: z.ZodString;
     }, z.core.$strip>], "type">>>;
     viewport: z.ZodOptional<z.ZodEnum<{
         desktop: "desktop";
@@ -997,5 +1031,10 @@ export declare const screenshotShape: {
         both: "both";
     }>>;
     fullPage: z.ZodOptional<z.ZodBoolean>;
+    view: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        accessibility: "accessibility";
+        both: "both";
+    }>>;
 };
 export declare const screenshotTool: import('.').ToolDef;