@plitzi/sdk-mcp 0.38.4 → 0.38.5

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

@@ -1,4 +1,4 @@
-import { functionFileUri, functionsUri } from "../../helpers/uris.js";
+import { dataFileUri, dataUri, functionFileUri, functionsUri } from "../../helpers/uris.js";
 import { changedResources, conflictMessage, detectConflicts, resolvedElements } from "./writeResult.js";
 import { environment, operations } from "../operations/index.js";
 import { draftBatch } from "../shared/draftBatch.js";
@@ -23,6 +23,15 @@ var functionsErrors = (saved, env) => "problems" in saved ? saved.problems.map((
 	message: saved.refusal.error,
 	hint: `Read ${functionsUri(env)} again and redo the change on the current files`
 }];
+var dataErrors = (saved, env) => "problems" in saved ? saved.problems.map((problem) => ({
+	path: `data/${problem.file}`,
+	message: problem.message,
+	hint: `Fix it with upsertDataFile, or deleteDataFile; read ${dataFileUri(env, problem.file)} for the file`
+})) : [{
+	path: "data",
+	message: saved.refusal.error,
+	hint: `Read ${dataUri(env)} again and redo the change on the current files`
+}];
 var apply = async (input, space, persisters) => {
 	const env = input.environment ?? "main";
 	const conflicts = detectConflicts(space, env, input.expectedResourceVersions);
@@ -85,6 +94,23 @@ var apply = async (input, space, persisters) => {
 			};
 		} else persisted = false;
 	}
+	if (outcome.changedData && draft.data) {
+		if (persisters?.saveData) {
+			const saved = await persisters.saveData(draft.data.files, space.data?.version ?? "");
+			if (!saved.ok) return {
+				applied: false,
+				persisted: false,
+				summary: {
+					created: 0,
+					updated: 0,
+					deleted: 0
+				},
+				changed: [],
+				errors: dataErrors(saved, env),
+				warnings: noWarnings([...outcome.changedFunctions && persisters.saveFunctions ? ["The functions of this batch were saved; the data was not — apply the data again once fixed"] : [], ...warnings])
+			};
+		} else persisted = false;
+	}
 	if (outcome.changedSchema) {
 		if (persisters?.schema) await persisters.schema(draft.schema);
 		else persisted = false;

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

@@ -9,8 +9,8 @@ export { screenshotShape } from './screenshot';
 export { applyOperations } from './apply/dispatch';
 export { validateOperations } from './shared/validator';
 export { operation } from './operations';
-/** The MCP tool registry — the single source both hosts (the standalone server and the in-process AI bridge)
- *  register from. Adding a tool is: create its file with a ToolDef descriptor and append it here. */
+/** The MCP tool registry — the single source the server registers from. Adding a tool is: create its file with a
+ *  ToolDef descriptor and append it here. */
 export declare const tools: ToolDef[];
 export type { ToolContext, ToolDef } from './shared/tool';
 export type { OpResult } from '../helpers';

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

@@ -10,8 +10,8 @@ import { search, searchShape, searchTool } from "./search.js";
 import { tryFunctionTool } from "./tryFunction.js";
 import { validate, validateShape, validateTool } from "./validate.js";
 //#region src/modules/mcp/tools/index.ts
-/** The MCP tool registry — the single source both hosts (the standalone server and the in-process AI bridge)
-*  register from. Adding a tool is: create its file with a ToolDef descriptor and append it here. */
+/** The MCP tool registry — the single source the server registers from. Adding a tool is: create its file with a
+*  ToolDef descriptor and append it here. */
 var tools = [
 	applyTool,
 	validateTool,

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

@@ -31,11 +31,11 @@ export declare const connectorOps: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";
@@ -120,11 +120,11 @@ export declare const connectorOps: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";

package/dist/modules/mcp/tools/operations/connectors/manifest.d.ts

@@ -73,11 +73,11 @@ export declare const connectorConnection: 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";

package/dist/modules/mcp/tools/operations/connectors/patchConnector.d.ts

@@ -29,11 +29,11 @@ export declare const patchConnectorOp: 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";

package/dist/modules/mcp/tools/operations/connectors/upsertConnector.d.ts

@@ -30,11 +30,11 @@ export declare const upsertConnectorOp: 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";

package/dist/modules/mcp/tools/operations/data/data.test.d.ts

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

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

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { OpResult, Space } from '../../../helpers';
+import { Env } from '../../../types';
+export declare const upsertDataFileOp: z.ZodObject<{
+    type: z.ZodLiteral<"upsertDataFile">;
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export declare const deleteDataFileOp: z.ZodObject<{
+    type: z.ZodLiteral<"deleteDataFile">;
+    path: z.ZodString;
+}, z.core.$strip>;
+export type UpsertDataFile = z.infer<typeof upsertDataFileOp>;
+export type DeleteDataFile = z.infer<typeof deleteDataFileOp>;
+/**
+ * The data is one store of files, saved whole: an op edits the draft's copy, and the batch saves the files it leaves —
+ * checked by the platform then (each path, the weight), which answers by file. A file that is not JSON is refused here,
+ * where it is written: it is what makes it data.
+ */
+export declare const upsertDataFile: (space: Space, env: Env, op: UpsertDataFile) => OpResult;
+export declare const deleteDataFile: (space: Space, env: Env, op: DeleteDataFile) => OpResult;
+export declare const dataOps: {
+    upsertDataFile: z.ZodObject<{
+        type: z.ZodLiteral<"upsertDataFile">;
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+    deleteDataFile: z.ZodObject<{
+        type: z.ZodLiteral<"deleteDataFile">;
+        path: z.ZodString;
+    }, z.core.$strip>;
+};

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

@@ -0,0 +1,54 @@
+import { dataFileUri, dataUri } from "../../../helpers/uris.js";
+import { empty, fail } from "../../../helpers/opResult.js";
+import { z } from "zod";
+//#region src/modules/mcp/tools/operations/data/index.ts
+var upsertDataFileOp = z.object({
+	type: z.literal("upsertDataFile"),
+	path: z.string().describe("e.g. \"products.json\" — read as query \"/data/<path>\""),
+	content: z.string().describe("The whole file, as JSON text")
+}).describe("Write one file of the space’s data (JSON its server providers read), whole.");
+var deleteDataFileOp = z.object({
+	type: z.literal("deleteDataFile"),
+	path: z.string()
+}).describe("Remove one file of the space’s data.");
+var unavailable = () => fail("type", "This deployment keeps no space data", "Read the data through a connector or a server action instead");
+/**
+* The data is one store of files, saved whole: an op edits the draft's copy, and the batch saves the files it leaves —
+* checked by the platform then (each path, the weight), which answers by file. A file that is not JSON is refused here,
+* where it is written: it is what makes it data.
+*/
+var upsertDataFile = (space, env, op) => {
+	if (!space.data) return unavailable();
+	try {
+		JSON.parse(op.content);
+	} catch (error) {
+		return fail("content", `"${op.path}" is not JSON: ${error instanceof Error ? error.message : String(error)}`, "Write the whole file as JSON text — an object or a list");
+	}
+	const exists = Object.hasOwn(space.data.files, op.path);
+	space.data.files = {
+		...space.data.files,
+		[op.path]: op.content
+	};
+	return {
+		...empty(),
+		...exists ? { updated: 1 } : { created: 1 },
+		staleResources: [dataUri(env), dataFileUri(env, op.path)]
+	};
+};
+var deleteDataFile = (space, env, op) => {
+	if (!space.data) return unavailable();
+	if (!Object.hasOwn(space.data.files, op.path)) return fail("path", `The data has no file "${op.path}"`, `Read ${dataUri(env)} for the files it has`, Object.keys(space.data.files));
+	const { [op.path]: _removed, ...files } = space.data.files;
+	space.data.files = files;
+	return {
+		...empty(),
+		deleted: 1,
+		staleResources: [dataUri(env), dataFileUri(env, op.path)]
+	};
+};
+var dataOps = {
+	upsertDataFile: upsertDataFileOp,
+	deleteDataFile: deleteDataFileOp
+};
+//#endregion
+export { dataOps, deleteDataFile, deleteDataFileOp, upsertDataFile, upsertDataFileOp };

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

@@ -208,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>>;
@@ -226,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>>;
@@ -994,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>>;
@@ -1012,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>>;
@@ -1600,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";
@@ -1688,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";
@@ -1839,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'];
@@ -2052,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>>;
@@ -2070,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>>;
@@ -2658,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";
@@ -2746,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";
@@ -2897,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">;
@@ -3105,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>>;
@@ -3123,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/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

@@ -224,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>>;
@@ -243,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

@@ -128,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

@@ -3,6 +3,7 @@ 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([
@@ -156,11 +157,7 @@ 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()
 });

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";

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

@@ -19,8 +19,7 @@ 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"],

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

@@ -208,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>>;
@@ -226,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

@@ -210,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>>;
@@ -228,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

@@ -208,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>>;
@@ -226,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>>;
@@ -814,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";
@@ -902,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";
@@ -1053,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 {};