@plitzi/sdk-mcp 0.38.3 → 0.38.5

package/dist/modules/mcp/localScreenshotClient.d.ts

@@ -37,6 +37,9 @@ type Page = {
         value: string;
     }[]) => Promise<void>;
     evaluate: <T>(fn: () => T) => Promise<T>;
+    addStyleTag: (options: {
+        content: string;
+    }) => Promise<unknown>;
     screenshot: (options: Record<string, unknown>) => Promise<Buffer | Uint8Array>;
     /** Playwright's: the page's accessibility tree, already written as an outline. */
     locator?: (selector: string) => {

package/dist/modules/mcp/localScreenshotClient.js

@@ -1,5 +1,6 @@
 import { outlineOfSnapshot, outlineOfTree } from "./accessibilityOutline.js";
 import { PREVIEW_TOKEN_PARAM } from "@plitzi/sdk-server/kernel";
+import { MOTION_STILL_CSS } from "@plitzi/sdk-shared/schema/motion";
 //#region src/modules/mcp/localScreenshotClient.ts
 /**
 * Grow the window to whatever actually scrolls before shooting.
@@ -90,6 +91,7 @@ var createLocalScreenshotClient = async ({ renderBaseUrl, ignoreHttpsErrors = tr
 					message: `The page answered ${response.status()}.`
 				};
 				await page.evaluate(FONTS_READY);
+				await page.addStyleTag({ content: MOTION_STILL_CSS });
 				if (fullPage) {
 					const height = Math.min(await page.evaluate(CONTENT_HEIGHT), MAX_HEIGHT);
 					if (height > viewport.height) await setViewport(page, {

package/dist/modules/mcp/resources/connectors.d.ts

@@ -10,7 +10,7 @@ export declare const connectorSummaries: (space: Space) => {
         operators: string[];
         pagination: import('@plitzi/sdk-shared').ConnectorPagination | undefined;
         credential: string | undefined;
-        fields: Record<string, "number" | "file" | "text" | "color" | "switch" | "email" | "date" | "richText" | "image" | "multiImage" | "video" | "link" | "phone" | "option"> | undefined;
+        fields: Record<string, "number" | "file" | "text" | "color" | "image" | "switch" | "email" | "date" | "richText" | "multiImage" | "video" | "link" | "phone" | "option"> | undefined;
     }[];
 };
 /** Connector reads: the space's connector listing and one full manifest. Undefined when the URI belongs to

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

@@ -1,7 +1,7 @@
-import { buildTypeRegistry } from "../catalogs/registry.js";
-import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import "../helpers/uris.js";
 import { guideText } from "../helpers/guide.js";
+import { buildTypeRegistry } from "../catalogs/registry.js";
+import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import { envelope } from "./envelope.js";
 //#region src/modules/mcp/resources/core.ts
 /** Space-independent singletons: the usage guide, the observed type registry and the CSS property catalog.

package/dist/modules/mcp/resources/data.d.ts

@@ -0,0 +1,8 @@
+import { Space } from '../helpers';
+import { Env, ResourceEnvelope } from '../types';
+/**
+ * The space's own data: JSON its server providers read (`query: '/data/<file>'`, `runtime: 'server'`), never served.
+ * The listing says which files there are, so an agent reads the one it needs; a file reads whole — parsed, so its
+ * shape is what a binding onto it reads.
+ */
+export declare const readDataResource: (space: Space, env: Env, uri: string) => ResourceEnvelope<unknown> | null | undefined;

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

@@ -0,0 +1,46 @@
+import { afterPrefix, dataFileUri, dataUri } from "../helpers/uris.js";
+import { envelope } from "./envelope.js";
+//#region src/modules/mcp/resources/data.ts
+/**
+* The space's own data: JSON its server providers read (`query: '/data/<file>'`, `runtime: 'server'`), never served.
+* The listing says which files there are, so an agent reads the one it needs; a file reads whole — parsed, so its
+* shape is what a binding onto it reads.
+*/
+var readDataResource = (space, env, uri) => {
+	if (uri === dataUri(env)) {
+		if (!space.data) return envelope({
+			available: false,
+			reason: "This deployment keeps no space data"
+		});
+		const { files, version } = space.data;
+		return envelope({
+			available: true,
+			version,
+			files: Object.entries(files).map(([path, content]) => ({
+				path,
+				query: `/data/${path}`,
+				bytes: content.length
+			}))
+		});
+	}
+	const path = afterPrefix(uri, dataFileUri(env, ""));
+	if (path === void 0) return;
+	const content = space.data && Object.hasOwn(space.data.files, path) ? space.data.files[path] : void 0;
+	if (content === void 0) return null;
+	try {
+		return envelope({
+			path,
+			query: `/data/${path}`,
+			content: JSON.parse(content)
+		});
+	} catch {
+		return envelope({
+			path,
+			query: `/data/${path}`,
+			text: content,
+			problem: "It is not JSON"
+		});
+	}
+};
+//#endregion
+export { readDataResource };

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

@@ -11,7 +11,7 @@ var explainResource = (uri) => {
 		names: explainList(kind)
 	};
 	const explanations = explain(name);
-	if (explanations.length === 0) throw new Error(`"${name}" is no element, step, trigger, code or transformer. List what there is: ${Object.values(EXPLAIN_KINDS).map((plural) => `${PREFIX}${plural}`).join(", ")}.`);
+	if (explanations.length === 0) throw new Error(`"${name}" is no element, step, trigger, code, transformer or helper. List what there is: ${Object.values(EXPLAIN_KINDS).map((plural) => `${PREFIX}${plural}`).join(", ")}.`);
 	return {
 		name,
 		explanations,

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

@@ -1,9 +1,9 @@
-import { buildDataSourceCatalog, buildInteractionCatalog } from "../catalogs/observed.js";
-import { buildTypeRegistry } from "../catalogs/registry.js";
-import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import { componentSummariesToAI } from "../helpers/components.js";
 import { componentsUri, connectorsUri, dataSourcesUri, defsUri, flagsUri, foldersUri, fontsUri, interactionsUri, layoutsUri, pagesUri, primerUri, schemaVarsUri, settingsUri, styleVarsUri, typesUri } from "../helpers/uris.js";
 import { guideQuickstart } from "../helpers/guide.js";
+import { buildDataSourceCatalog, buildInteractionCatalog } from "../catalogs/observed.js";
+import { buildTypeRegistry } from "../catalogs/registry.js";
+import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import { envelope } from "./envelope.js";
 import { connectorSummaries } from "./connectors.js";
 import { definitionRefs, fontsToAI, styleVariablesToAI } from "../tools/operations/style/translator.js";

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

@@ -1,6 +1,6 @@
-import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import { changesUri } from "../helpers/uris.js";
 import { guideText } from "../helpers/guide.js";
+import { cssProperties, cssShorthands } from "../catalogs/index.js";
 import { envelope, jsonContents } from "./envelope.js";
 import { resourceErrorMessage } from "./canonical.js";
 import { registerRenderResources } from "./renderGuide.js";
@@ -36,7 +36,7 @@ var registerResources = (server, getSpace, env, log, hasSpace, readChanges) => {
 		return result;
 	};
 	server.registerResource("Guide", "plitzi://guide", {
-		description: "How to read and write this space with mcp-ai",
+		description: "How to read and write this space through this server",
 		mimeType: "text/markdown"
 	}, () => emitStatic("plitzi://guide", () => ({ contents: [{
 		uri: "plitzi://guide",
@@ -157,6 +157,11 @@ var registerResources = (server, getSpace, env, log, hasSpace, readChanges) => {
 			`plitzi://functions/${env}`,
 			"The space’s own server code: which files it is, and the tasks, routes and hosts it declares — its tasks are steps like any server task"
 		],
+		[
+			"Data",
+			`plitzi://data/${env}`,
+			"The space’s own data: JSON files its server providers read as `/data/<file>`, never served — which files there are"
+		],
 		[
 			"Style definitions (schema alias)",
 			`plitzi://schema/${env}/definitions`,
@@ -237,6 +242,11 @@ var registerResources = (server, getSpace, env, log, hasSpace, readChanges) => {
 			`plitzi://functions/${env}/{+path}`,
 			"One file of the space’s functions, whole"
 		],
+		[
+			"Data file",
+			`plitzi://data/${env}/{+path}`,
+			"One file of the space’s data, parsed"
+		],
 		[
 			"Style definition",
 			`plitzi://definitions/${env}/{ref}`,

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

@@ -197,9 +197,9 @@ and \`patchDefinition\` still changes only some CSS of one class.
 
 ## Fit the panel — go wide, stay short
 
-The widget renders in a **side panel** (Claude Desktop, ChatGPT, the Plitzi builder), so it gets a usable width but
-very little height: everything past the first screenful costs the user a scroll. Height is the scarce resource —
-spend width instead.
+The widget renders in a **side panel** (Claude Desktop, ChatGPT), so it gets a usable width but very little
+height: everything past the first screenful costs the user a scroll. Height is the scarce resource — spend width
+instead.
 
 Plain containers are blocks, so doing nothing stacks children **vertically** and produces exactly the tall,
 half-empty widget to avoid. Choose the axis every time:
@@ -228,9 +228,9 @@ it — and reach for \`max-width\` only to stop one lone card from stretching ac
 
 ## Match the host theme — never hardcode a light palette
 
-The widget is embedded in the host's own UI (Claude Desktop, ChatGPT, the builder), and that UI **may be in dark
-mode**. A widget painted with fixed light colours is the most common way to ship something unusable: a white card
-in a dark chat glares, and — worse — text left at a dark default disappears against the host's dark background.
+The widget is embedded in the host's own UI (Claude Desktop, ChatGPT), and that UI **may be in dark mode**. A
+widget painted with fixed light colours is the most common way to ship something unusable: a white card in a dark
+chat glares, and — worse — text left at a dark default disappears against the host's dark background.
 
 The host publishes its palette as CSS variables on the page, so use them for every colour, with a
 \`light-dark(<light>, <dark>)\` fallback for hosts that send none:

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

@@ -4,6 +4,7 @@ import { readActionResource } from "./actions.js";
 import { canonicalUri } from "./canonical.js";
 import { readConnectorResource } from "./connectors.js";
 import { readCoreResource } from "./core.js";
+import { readDataResource } from "./data.js";
 import { readFunctionsResource } from "./functions.js";
 import { readPrimerResource } from "./primer.js";
 import { readRenderResource } from "./renderGuide.js";
@@ -18,7 +19,8 @@ var resolvers = [
 	readStyleResource,
 	readConnectorResource,
 	readActionResource,
-	readFunctionsResource
+	readFunctionsResource,
+	readDataResource
 ];
 /** Resolve a resource URI to its versioned envelope, or null if unknown / not found. */
 var readResource = (space, env, rawUri) => {

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

@@ -1,7 +1,7 @@
-import { buildDataSourceCatalog, buildInteractionCatalog } from "../catalogs/observed.js";
 import { componentSummariesToAI, componentView, findComponentByRef } from "../helpers/components.js";
 import { findElementByRef, findRootByRef } from "../helpers/space.js";
 import { afterPrefix, componentsUri, dataSourcesUri, elementUri, flagsUri, folderUri, foldersUri, interactionsUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, settingsUri } from "../helpers/uris.js";
+import { buildDataSourceCatalog, buildInteractionCatalog } from "../catalogs/observed.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";

package/dist/modules/mcp/server.d.ts

@@ -20,10 +20,10 @@ export interface McpServerContext {
     /** Structured request-log sink. When set, every tool call and resource read emits an McpLogEvent to it (the
      *  consumer renders them); otherwise logging falls back to the console when MCP_DEBUG=1. */
     logger?: ServerLogger;
-    /** May the plitzi_render view paint from tool arguments the host is still streaming (see `mcpAi.renderStreaming`)?
-     *  Defaults to true. */
+    /** May the plitzi_render view paint from tool arguments the host is still streaming (see
+     *  `McpOptions.renderStreaming`)? Defaults to true. */
     renderStreaming?: boolean;
-    /** Where a rendered widget loads everything external from (see `mcpAi.proxy`). It reaches two places: the render
+    /** Where a rendered widget loads everything external from (see `McpOptions.proxy`). It reaches two places: the render
      *  tool, which rewrites the URLs the agent authored, and the App's CSP, which declares the origin those URLs
      *  point at. Absent → neither happens, and a widget's resources load only where the host allows their origin. */
     proxy?: ResourceProxy;

package/dist/modules/mcp/server.js

@@ -1,11 +1,11 @@
 import { registerApps } from "./apps/index.js";
+import { isCallToolResult } from "./helpers/callToolResult.js";
 import { NoSpaceError, ReadOnlyGrantError, emptySpace, emptySpaceMessage, noSpaceErrorCode, readOnlyGrantErrorCode } from "./helpers/space.js";
 import { serverInstructions, widgetsOnlyInstructions } from "./helpers/guide.js";
 import { createMcpLog } from "./helpers/log.js";
 import { proxyForTool } from "./proxy/config.js";
 import { registerResources } from "./resources/register.js";
 import { tools } from "./tools/index.js";
-import { isCallToolResult } from "../ai/toolkit.js";
 import { randomUUID } from "node:crypto";
 import { registerAppTool } from "@modelcontextprotocol/ext-apps/server";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -31,14 +31,15 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 	};
 	const loadSpace = async () => {
 		const id = requireSpaceId();
-		const [schema, style, catalog, connectors, actions, actionTasks, functions] = await Promise.all([
+		const [schema, style, catalog, connectors, actions, actionTasks, functions, data] = await Promise.all([
 			adapters.getSchema?.(id, MCP_ENV),
 			adapters.getStyle?.(id, MCP_ENV),
 			adapters.getComponentCatalog?.(id, MCP_ENV).catch(() => void 0),
 			adapters.getConnectors?.(id).catch(() => void 0),
 			adapters.getActions?.(id).catch(() => void 0),
 			adapters.getActionTasks?.(id).catch(() => void 0),
-			adapters.getFunctions?.(id).catch(() => void 0)
+			adapters.getFunctions?.(id).catch(() => void 0),
+			adapters.getData?.(id).catch(() => void 0)
 		]);
 		if (!schema || !style) throw new Error(emptySpaceMessage);
 		return {
@@ -48,10 +49,11 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 			connectors: connectors ?? [],
 			actions: actions ?? [],
 			actionTasks,
-			...functions ? { functions } : {}
+			...functions ? { functions } : {},
+			...data ? { data } : {}
 		};
 	};
-	const { saveSchema, saveStyle, saveConnector, deleteConnector, saveAction, deleteAction, saveFunctions, tryFunction } = adapters;
+	const { saveSchema, saveStyle, saveConnector, deleteConnector, saveAction, deleteAction, saveFunctions, tryFunction, saveData } = adapters;
 	const write = {
 		userId: grant?.userId,
 		batch: randomUUID()
@@ -63,13 +65,14 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 		deleteConnector: deleteConnector ? (id) => deleteConnector(requireWritableSpaceId(), id) : void 0,
 		saveAction: saveAction ? (entry) => saveAction(requireWritableSpaceId(), entry) : void 0,
 		deleteAction: deleteAction ? (id) => deleteAction(requireWritableSpaceId(), id) : void 0,
-		saveFunctions: saveFunctions ? (files, base) => saveFunctions(requireWritableSpaceId(), files, base, write) : void 0
+		saveFunctions: saveFunctions ? (files, base) => saveFunctions(requireWritableSpaceId(), files, base, write) : void 0,
+		saveData: saveData ? (files, base) => saveData(requireWritableSpaceId(), files, base, write) : void 0
 	};
 	let spacePromise;
 	const getSpace = () => spacePromise ??= loadSpace();
 	const server = new McpServer({
 		name: "plitzi-mcp",
-		version: "0.38.3"
+		version: "0.38.5"
 	}, { instructions: hasSpace ? serverInstructions : widgetsOnlyInstructions });
 	const { getChanges } = adapters;
 	registerResources(server, getSpace, MCP_ENV, log, hasSpace, getChanges ? (query) => getChanges(requireSpaceId(), MCP_ENV, query) : void 0);
@@ -126,7 +129,8 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 		const config = {
 			title: tool.title,
 			description: tool.description,
-			inputSchema: tool.inputShape
+			inputSchema: tool.inputShape,
+			annotations: { readOnlyHint: tool.access === "read" }
 		};
 		if (tool.ui) {
 			registerAppTool(server, tool.name, {

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

@@ -7,6 +7,7 @@ import { upsertAction } from "../operations/actions/upsertAction.js";
 import { deleteConnector } from "../operations/connectors/deleteConnector.js";
 import { patchConnector } from "../operations/connectors/patchConnector.js";
 import { upsertConnector } from "../operations/connectors/upsertConnector.js";
+import { deleteDataFile, upsertDataFile } from "../operations/data/index.js";
 import { deleteFunctionFile, upsertFunctionFile } from "../operations/functions/index.js";
 import { deleteBinding } from "../operations/schema/bindings/deleteBinding.js";
 import { patchBinding } from "../operations/schema/bindings/patchBinding.js";
@@ -113,6 +114,8 @@ var executeOp = (space, env, op) => {
 		case "deleteAction": return deleteAction(space, env, op);
 		case "upsertFunctionFile": return upsertFunctionFile(space, env, op);
 		case "deleteFunctionFile": return deleteFunctionFile(space, env, op);
+		case "upsertDataFile": return upsertDataFile(space, env, op);
+		case "deleteDataFile": return deleteDataFile(space, env, op);
 		default: return fail("type", `Unknown operation "${op.type}"`, "See the Operation union");
 	}
 };
@@ -132,7 +135,8 @@ var applyOperations = (space, env, ops) => {
 		deletedConnectors: [],
 		changedActions: [],
 		deletedActions: [],
-		changedFunctions: false
+		changedFunctions: false,
+		changedData: false
 	};
 	const stale = /* @__PURE__ */ new Set();
 	const elements = /* @__PURE__ */ new Set();
@@ -173,6 +177,10 @@ var applyOperations = (space, env, ops) => {
 			case "deleteFunctionFile":
 				outcome.changedFunctions = true;
 				break;
+			case "upsertDataFile":
+			case "deleteDataFile":
+				outcome.changedData = true;
+				break;
 			default: if (isStyleOp(op.type)) outcome.changedStyle = true;
 			else outcome.changedSchema = true;
 		}

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

@@ -57,6 +57,7 @@ export declare const applyShape: {
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        quiet: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;
@@ -211,6 +212,7 @@ export declare const applyShape: {
                 skip: "skip";
                 parallel: "parallel";
                 queue: "queue";
+                latest: "latest";
             }>>;
             elementId: z.ZodOptional<z.ZodString>;
             preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -229,6 +231,7 @@ export declare const applyShape: {
             skip: "skip";
             parallel: "parallel";
             queue: "queue";
+            latest: "latest";
         }>>;
         elementId: z.ZodOptional<z.ZodString>;
         preview: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -817,11 +820,11 @@ export declare const applyShape: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";
@@ -905,11 +908,11 @@ export declare const applyShape: {
                 file: "file";
                 text: "text";
                 color: "color";
+                image: "image";
                 switch: "switch";
                 email: "email";
                 date: "date";
                 richText: "richText";
-                image: "image";
                 multiImage: "multiImage";
                 video: "video";
                 link: "link";
@@ -1056,6 +1059,13 @@ export declare const applyShape: {
     }, 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 apply: (input: ApplyInput, space: Space, persisters?: Persisters) => Promise<WriteResponse>;

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