@plitzi/sdk-mcp 0.37.8 → 0.37.10

package/dist/modules/mcp/resources/schema.js

@@ -1,14 +1,17 @@
 import { buildDataSourceCatalog, buildInteractionCatalog } from "../catalogs/observed.js";
+import { componentSummariesToAI, componentView, findComponentByRef } from "../helpers/components.js";
 import { findElementByRef, findRootByRef } from "../helpers/space.js";
-import { afterPrefix, dataSourcesUri, elementUri, folderUri, foldersUri, interactionsUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from "../helpers/uris.js";
+import { afterPrefix, componentsUri, dataSourcesUri, elementUri, flagsUri, folderUri, foldersUri, interactionsUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from "../helpers/uris.js";
 import { envelope } from "./envelope.js";
 import { elementView, folderRefToAI, foldersToAI, layoutSummariesToAI, pageSkeletonToAI, pageStylesToAI, pageSummariesToAI, schemaVariablesToAI, settingsToAI } from "../tools/operations/schema/translator.js";
+import { treeOf } from "@plitzi/sdk-schema/helpers/components";
 //#region src/modules/mcp/resources/schema.ts
 /** Element-schema reads: page listings/skeletons/styles, folders, single elements and schema variables. Returns
 *  undefined when the URI belongs to another domain, null when the shape is ours but the ref does not resolve. */
 var readSchemaResource = (space, env, uri) => {
 	if (uri === pagesUri(env)) return envelope(pageSummariesToAI(space.schema));
 	if (uri === layoutsUri(env)) return envelope(layoutSummariesToAI(space.schema));
+	if (uri === componentsUri(env)) return envelope(componentSummariesToAI(space.schema));
 	if (uri === foldersUri(env)) return envelope(foldersToAI(space.schema));
 	const folderRef = afterPrefix(uri, folderUri(env, ""));
 	if (folderRef !== void 0) {
@@ -17,25 +20,29 @@ var readSchemaResource = (space, env, uri) => {
 	}
 	const pageItem = afterPrefix(uri, pageUri(env, ""));
 	if (pageItem !== void 0) {
-		if (pageItem.endsWith("/styles")) {
-			const ref = pageItem.slice(0, -7);
-			const page = findRootByRef(space.schema, ref);
-			return page ? envelope(pageStylesToAI(space.schema, space.style, page)) : null;
-		}
-		const page = findRootByRef(space.schema, pageItem);
-		return page ? envelope(pageSkeletonToAI(space.schema, page, space.style)) : null;
+		const styles = pageItem.endsWith("/styles");
+		const ref = styles ? pageItem.slice(0, -7) : pageItem;
+		const component = findComponentByRef(space.schema, ref);
+		const target = component ? componentView(space, component) : space;
+		const page = findRootByRef(target.schema, component ? component.rootId : ref);
+		if (!page) return null;
+		return envelope(styles ? pageStylesToAI(target.schema, target.style, page) : pageSkeletonToAI(target.schema, page, target.style));
 	}
 	const elementRef = afterPrefix(uri, elementUri(env, ""));
 	if (elementRef !== void 0) {
-		const el = findElementByRef(space.schema, elementRef);
+		const componentId = treeOf(space.schema, elementRef)?.componentId;
+		const component = componentId ? findComponentByRef(space.schema, componentId) : void 0;
+		const target = component ? componentView(space, component) : space;
+		const el = findElementByRef(target.schema, elementRef);
 		if (!el) return null;
-		const view = elementView(space.schema, el, space.style);
+		const view = elementView(target.schema, el, target.style);
 		return {
 			stateVersion: view.version,
 			data: view.detail
 		};
 	}
 	if (uri === schemaVarsUri(env)) return envelope(schemaVariablesToAI(space.schema));
+	if (uri === flagsUri(env)) return envelope(space.schema.flags ?? {});
 	if (uri === settingsUri(env)) return envelope(settingsToAI(space.schema));
 	if (uri === interactionsUri(env)) return envelope(buildInteractionCatalog(space.schema));
 	if (uri === dataSourcesUri(env)) return envelope(buildDataSourceCatalog(space.schema));

package/dist/modules/mcp/server.js

@@ -69,7 +69,7 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 	const getSpace = () => spacePromise ??= loadSpace();
 	const server = new McpServer({
 		name: "plitzi-mcp",
-		version: "0.37.8"
+		version: "0.37.10"
 	}, { instructions: hasSpace ? serverInstructions : widgetsOnlyInstructions });
 	const { getChanges } = adapters;
 	registerResources(server, getSpace, MCP_ENV, log, hasSpace, getChanges ? (query) => getChanges(requireSpaceId(), MCP_ENV, query) : void 0);

package/dist/modules/mcp/tests/components.test.d.ts

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

package/dist/modules/mcp/tests/flags.test.d.ts

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

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

@@ -1,3 +1,5 @@
+import { componentView, findComponentByRef } from "../../helpers/components.js";
+import { pageUri } from "../../helpers/uris.js";
 import { fail } from "../../helpers/opResult.js";
 import { deleteAction } from "../operations/actions/deleteAction.js";
 import { patchAction } from "../operations/actions/patchAction.js";
@@ -9,10 +11,14 @@ import { deleteFunctionFile, upsertFunctionFile } from "../operations/functions/
 import { deleteBinding } from "../operations/schema/bindings/deleteBinding.js";
 import { patchBinding } from "../operations/schema/bindings/patchBinding.js";
 import { upsertBinding } from "../operations/schema/bindings/upsertBinding.js";
+import { deleteComponent } from "../operations/schema/components/deleteComponent.js";
+import { upsertComponent } from "../operations/schema/components/upsertComponent.js";
 import { deleteElement } from "../operations/schema/elements/deleteElement.js";
 import { moveElement } from "../operations/schema/elements/moveElement.js";
 import { patchElement } from "../operations/schema/elements/patchElement.js";
 import { upsertElement } from "../operations/schema/elements/upsertElement.js";
+import { deleteFlag } from "../operations/schema/flags/deleteFlag.js";
+import { upsertFlag } from "../operations/schema/flags/upsertFlag.js";
 import { deleteFolder } from "../operations/schema/folders/deleteFolder.js";
 import { upsertFolder } from "../operations/schema/folders/upsertFolder.js";
 import { deleteInteraction } from "../operations/schema/interactions/deleteInteraction.js";
@@ -41,6 +47,25 @@ import { deleteStyleVariable } from "../operations/style/variables/deleteStyleVa
 import { upsertStyleVariable } from "../operations/style/variables/upsertStyleVariable.js";
 import { isStyleOp } from "../operations/index.js";
 //#region src/modules/mcp/tools/apply/dispatch.ts
+var isRooted = (op) => "pageRef" in op;
+/**
+* An element op names its root with `pageRef`, and a component is one: the op runs on the component's tree as if it
+* were the space's only one — rooted at the component's root — so every element op works inside a component with no
+* code of its own. What it made stale is the component, read as `pages/<component>`.
+*/
+var executeRooted = (space, env, op) => {
+	const component = isRooted(op) ? findComponentByRef(space.schema, op.pageRef) : void 0;
+	if (!component || !isRooted(op)) return executeOp(space, env, op);
+	const retargeted = {
+		...op,
+		pageRef: component.rootId
+	};
+	const result = executeOp(componentView(space, component), env, retargeted);
+	return {
+		...result,
+		staleResources: result.staleResources.map((uri) => uri === pageUri(env, component.rootId) ? pageUri(env, component.id) : uri)
+	};
+};
 var executeOp = (space, env, op) => {
 	switch (op.type) {
 		case "upsertElement": return upsertElement(space, env, op);
@@ -55,6 +80,8 @@ var executeOp = (space, env, op) => {
 		case "deleteFolder": return deleteFolder(space, env, op);
 		case "upsertVariable": return upsertVariable(space, env, op);
 		case "deleteVariable": return deleteVariable(space, env, op);
+		case "upsertFlag": return upsertFlag(space, env, op);
+		case "deleteFlag": return deleteFlag(space, env, op);
 		case "upsertBinding": return upsertBinding(space, env, op);
 		case "patchBinding": return patchBinding(space, env, op);
 		case "deleteBinding": return deleteBinding(space, env, op);
@@ -62,6 +89,8 @@ var executeOp = (space, env, op) => {
 		case "patchInteractionNode": return patchInteractionNode(space, env, op);
 		case "deleteInteraction": return deleteInteraction(space, env, op);
 		case "patchSettings": return patchSettings(space, env, op);
+		case "upsertComponent": return upsertComponent(space, env, op);
+		case "deleteComponent": return deleteComponent(space, env, op);
 		case "upsertDefinition": return upsertDefinition(space, env, op);
 		case "upsertDefinitions": return upsertDefinitions(space, env, op);
 		case "patchDefinition": return patchDefinition(space, env, op);
@@ -113,7 +142,7 @@ var applyOperations = (space, env, ops) => {
 	const droppedActions = /* @__PURE__ */ new Set();
 	for (let i = 0; i < ops.length; i++) {
 		const op = ops[i];
-		const result = executeOp(space, env, op);
+		const result = executeRooted(space, env, op);
 		if (result.errors) {
 			outcome.errors.push(...result.errors.map((e) => ({
 				...e,

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

@@ -54,6 +54,8 @@ export declare const applyShape: {
             client: "client";
             shared: "shared";
         }>>;
+        flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -78,6 +80,7 @@ export declare const applyShape: {
         layout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
+        flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deletePage">;
         ref: z.ZodString;
@@ -122,6 +125,18 @@ export declare const applyShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteVariable">;
         name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertFlag">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        value: z.ZodBoolean;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            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<{
+        type: z.ZodLiteral<"deleteFlag">;
+        name: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"upsertBinding">;
         pageRef: z.ZodString;
@@ -225,6 +240,7 @@ export declare const applyShape: {
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"patchSettings">;
         customCss: z.ZodOptional<z.ZodString>;
+        notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
         keepState: z.ZodOptional<z.ZodBoolean>;
         stateStorage: z.ZodOptional<z.ZodEnum<{
             localStorage: "localStorage";
@@ -269,6 +285,17 @@ export declare const applyShape: {
             }>>;
             presence: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"upsertComponent">;
+        ref: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fromRef: z.ZodOptional<z.ZodString>;
+        instanceRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"deleteComponent">;
+        ref: z.ZodString;
     }, 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/apply/index.js

@@ -53,7 +53,7 @@ var apply = async (input, space, persisters) => {
 		errors: result.errors,
 		warnings: noWarnings(result.warnings)
 	};
-	const { draft, outcome, warnings } = result;
+	const { draft, outcome, warnings, suggestions } = result;
 	if (input.dryRun) return {
 		applied: false,
 		dryRun: true,
@@ -64,7 +64,8 @@ var apply = async (input, space, persisters) => {
 		},
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
-		warnings: noWarnings(warnings)
+		warnings: noWarnings(warnings),
+		suggestions: noWarnings(suggestions)
 	};
 	let persisted = true;
 	if (outcome.changedFunctions && draft.functions) {
@@ -118,7 +119,8 @@ var apply = async (input, space, persisters) => {
 		},
 		changed: changedResources(draft, env, outcome.staleResources),
 		elements: resolvedElements(draft, env, outcome.elementRefs),
-		warnings: noWarnings(warnings)
+		warnings: noWarnings(warnings),
+		suggestions: noWarnings(suggestions)
 	};
 };
 var applyTool = defineTool({

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

@@ -50,6 +50,8 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
         client: "client";
         shared: "shared";
     }>>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -74,6 +76,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
     layout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deletePage">;
     ref: z.ZodString;
@@ -118,6 +121,18 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteVariable">;
     name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertFlag">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    value: z.ZodBoolean;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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<{
+    type: z.ZodLiteral<"deleteFlag">;
+    name: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"upsertBinding">;
     pageRef: z.ZodString;
@@ -221,6 +236,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"patchSettings">;
     customCss: z.ZodOptional<z.ZodString>;
+    notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     keepState: z.ZodOptional<z.ZodBoolean>;
     stateStorage: z.ZodOptional<z.ZodEnum<{
         localStorage: "localStorage";
@@ -265,6 +281,17 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
         }>>;
         presence: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertComponent">;
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromRef: z.ZodOptional<z.ZodString>;
+    instanceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteComponent">;
+    ref: z.ZodString;
 }, 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]>>>;
@@ -807,6 +834,8 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
         client: "client";
         shared: "shared";
     }>>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -831,6 +860,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
     layout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deletePage">;
     ref: z.ZodString;
@@ -875,6 +905,18 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteVariable">;
     name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertFlag">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    value: z.ZodBoolean;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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<{
+    type: z.ZodLiteral<"deleteFlag">;
+    name: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"upsertBinding">;
     pageRef: z.ZodString;
@@ -978,6 +1020,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"patchSettings">;
     customCss: z.ZodOptional<z.ZodString>;
+    notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     keepState: z.ZodOptional<z.ZodBoolean>;
     stateStorage: z.ZodOptional<z.ZodEnum<{
         localStorage: "localStorage";
@@ -1022,6 +1065,17 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>>;
         presence: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertComponent">;
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromRef: z.ZodOptional<z.ZodString>;
+    instanceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteComponent">;
+    ref: z.ZodString;
 }, 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]>>>;
@@ -1836,6 +1890,8 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
         client: "client";
         shared: "shared";
     }>>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -1860,6 +1916,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
     layout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deletePage">;
     ref: z.ZodString;
@@ -1904,6 +1961,18 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteVariable">;
     name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertFlag">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    value: z.ZodBoolean;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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<{
+    type: z.ZodLiteral<"deleteFlag">;
+    name: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"upsertBinding">;
     pageRef: z.ZodString;
@@ -2007,6 +2076,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"patchSettings">;
     customCss: z.ZodOptional<z.ZodString>;
+    notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     keepState: z.ZodOptional<z.ZodBoolean>;
     stateStorage: z.ZodOptional<z.ZodEnum<{
         localStorage: "localStorage";
@@ -2051,6 +2121,17 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
         }>>;
         presence: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertComponent">;
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromRef: z.ZodOptional<z.ZodString>;
+    instanceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteComponent">;
+    ref: z.ZodString;
 }, 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]>>>;
@@ -2860,6 +2941,8 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
         client: "client";
         shared: "shared";
     }>>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -2884,6 +2967,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
     layout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutContainer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
+    flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deletePage">;
     ref: z.ZodString;
@@ -2928,6 +3012,18 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteVariable">;
     name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertFlag">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    value: z.ZodBoolean;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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<{
+    type: z.ZodLiteral<"deleteFlag">;
+    name: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"upsertBinding">;
     pageRef: z.ZodString;
@@ -3031,6 +3127,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"patchSettings">;
     customCss: z.ZodOptional<z.ZodString>;
+    notifications: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     keepState: z.ZodOptional<z.ZodBoolean>;
     stateStorage: z.ZodOptional<z.ZodEnum<{
         localStorage: "localStorage";
@@ -3075,6 +3172,17 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
         }>>;
         presence: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"upsertComponent">;
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromRef: z.ZodOptional<z.ZodString>;
+    instanceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"deleteComponent">;
+    ref: z.ZodString;
 }, 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/operations/index.js

@@ -21,6 +21,8 @@ var documentOps = [
 	elementOps.deleteFolder,
 	elementOps.upsertVariable,
 	elementOps.deleteVariable,
+	elementOps.upsertFlag,
+	elementOps.deleteFlag,
 	elementOps.upsertBinding,
 	elementOps.patchBinding,
 	elementOps.deleteBinding,
@@ -28,6 +30,8 @@ var documentOps = [
 	elementOps.patchInteractionNode,
 	elementOps.deleteInteraction,
 	elementOps.patchSettings,
+	elementOps.upsertComponent,
+	elementOps.deleteComponent,
 	styleOps.upsertDefinition,
 	styleOps.upsertDefinitions,
 	styleOps.patchDefinition,

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

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const deleteComponentOp: z.ZodObject<{
+    type: z.ZodLiteral<"deleteComponent">;
+    ref: z.ZodString;
+}, z.core.$strip>;
+export type DeleteComponent = z.infer<typeof deleteComponentOp>;
+export declare const deleteComponent: (space: Space, env: Env, op: DeleteComponent) => OpResult;

package/dist/modules/mcp/tools/operations/schema/components/deleteComponent.js

@@ -0,0 +1,21 @@
+import { componentsUri } from "../../../../helpers/uris.js";
+import { empty, fail } from "../../../../helpers/opResult.js";
+import { componentNamed, instancesOf, removeComponent } from "@plitzi/sdk-schema/helpers/components";
+import { z } from "zod";
+//#region src/modules/mcp/tools/operations/schema/components/deleteComponent.ts
+var deleteComponentOp = z.object({
+	type: z.literal("deleteComponent"),
+	ref: z.string()
+}).describe("Remove a component nothing places any more.");
+var deleteComponent = (space, env, op) => {
+	if (!componentNamed(space.schema, op.ref)) return fail("ref", `Component "${op.ref}" not found`, `Read plitzi://schema/${env}/components for valid refs`);
+	const placed = instancesOf(space.schema, op.ref);
+	if (placed.length > 0 || !removeComponent(space.schema, op.ref)) return fail("ref", `Component "${op.ref}" is still placed by ${placed.map((instance) => `"${instance.id}"`).join(", ")}`, "detachInstance or deleteElement each of them first");
+	return {
+		...empty(),
+		deleted: 1,
+		staleResources: [componentsUri(env)]
+	};
+};
+//#endregion
+export { deleteComponent, deleteComponentOp };

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

@@ -0,0 +1,2 @@
+export * from './deleteComponent';
+export * from './upsertComponent';

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

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../../helpers';
+import { Env } from '../../../../types';
+export declare const upsertComponentOp: z.ZodObject<{
+    type: z.ZodLiteral<"upsertComponent">;
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fromRef: z.ZodOptional<z.ZodString>;
+    instanceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpsertComponent = z.infer<typeof upsertComponentOp>;
+export declare const upsertComponent: (space: Space, env: Env, op: UpsertComponent) => OpResult;