@plitzi/sdk-mcp 0.38.12 → 0.38.14

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

@@ -0,0 +1,67 @@
+import { emptySpace } from "../helpers/space.js";
+import { proxifyResources } from "../proxy/rewrite.js";
+import { documentOperations } from "./operations/index.js";
+import { draftBatch } from "./shared/draftBatch.js";
+import { interactionReport } from "./shared/interactionReport.js";
+import { generateCache } from "@plitzi/sdk-style/StyleHelper";
+//#region src/modules/mcp/tools/renderWidget.ts
+/**
+* A widget built from an agent's operations, with no space and no backend: the engine behind `plitzi_render`, apart
+* from the MCP tool — so a project's own agent can draw the same widgets in its own pages (`@plitzi/sdk-mcp/render`).
+*/
+var HOST_PAGE_REF = "render";
+var seedSpace = (base) => {
+	const space = emptySpace();
+	if (base) space.style = {
+		...structuredClone(base),
+		cache: ""
+	};
+	space.schema.definition.name = "Widget";
+	space.schema.flat[HOST_PAGE_REF] = {
+		id: HOST_PAGE_REF,
+		attributes: {
+			slug: "",
+			name: "Render",
+			default: true
+		},
+		definition: {
+			rootId: HOST_PAGE_REF,
+			label: "Page",
+			type: "page",
+			items: [],
+			styleSelectors: { base: "" }
+		}
+	};
+	space.schema.pages = [HOST_PAGE_REF];
+	return space;
+};
+var noWarnings = (warnings) => warnings.length > 0 ? warnings : void 0;
+/** The input as a tool declares it, for a project registering the render as a tool of its own MCP server. */
+var renderWidgetShape = { operations: documentOperations };
+var render = (input, options = {}) => {
+	const result = draftBatch(seedSpace(options.base), "main", input.operations, "widget");
+	if (!result.ok) return {
+		rendered: false,
+		errors: result.errors,
+		warnings: noWarnings(result.warnings)
+	};
+	const { ops, draft: space } = result;
+	const behaviour = interactionReport(space);
+	const warnings = [...result.warnings, ...behaviour.warnings];
+	if (options.proxy) warnings.push(...proxifyResources(space, options.proxy));
+	space.style.cache = generateCache(space.style);
+	return {
+		rendered: true,
+		operations: ops,
+		...behaviour.flows ? { interactions: behaviour.flows } : {},
+		rootRef: HOST_PAGE_REF,
+		elementCount: Object.keys(space.schema.flat).length - 1,
+		offlineData: {
+			schema: space.schema,
+			style: space.style
+		},
+		warnings: noWarnings(warnings)
+	};
+};
+//#endregion
+export { HOST_PAGE_REF, render, renderWidgetShape };

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

@@ -10,6 +10,7 @@ var touchedRefs = (ops) => {
 		case "upsertElement":
 			refs.add(op.element.ref);
 			break;
+		case "upsertPage":
 		case "patchElement":
 		case "moveElement":
 		case "upsertBinding":

package/dist/modules/mcp/types/aiSchema.d.ts

@@ -1,4 +1,4 @@
-import { NotificationsSpec, CssProps } from '@plitzi/sdk-authoring';
+import { DocumentScroll, NotificationsSpec, CssProps } from '@plitzi/sdk-authoring';
 import { ElementRuntime, Environment, WhileRunning } from '@plitzi/sdk-shared';
 export type Env = Environment;
 /** CSS declarations for one selector state. Keys are kebab-case CSS properties (see plitzi://css-properties).
@@ -101,6 +101,8 @@ export interface AIPageSkeleton {
     /** Whether the page is served by the published SDK runtime. A disabled page (`false`) is not routable/accessible
      *  to end users, but stays fully editable here. Defaults to true. */
     enabled: boolean;
+    /** How the document moves while the page is on it (`upsertPage`'s `documentScroll`). Absent, it scrolls as any page. */
+    documentScroll?: DocumentScroll;
     /** Route params bound by the slug (e.g. ":spaceId" → ["spaceId"]). Valid as {{name}} references on this page,
      *  alongside the space-level plitzi://schema-variables. */
     routeParams: string[];

package/dist/render.d.ts

@@ -0,0 +1,10 @@
+/** The widget render of `plitzi_render`, on its own: operations in, a self-contained `offlineData` out — no server, no
+ *  space, no OAuth.
+ *
+ *  Import it as `@plitzi/sdk-mcp/render` in a project whose own agent draws UI in its own pages: register `render` as
+ *  a tool of the project's MCP server with `renderWidgetShape` as its input and `renderGuideText` for the agent to read,
+ *  hand it `base` — the style of the project's space — so the widget looks like the page around it, and draw the
+ *  answer with the `plitziSdk` element (its `offlineData`). */
+export { HOST_PAGE_REF as RENDER_ROOT_REF, render, renderWidgetShape } from './modules/mcp/tools/renderWidget';
+export { renderGuideText } from './modules/mcp/resources/renderGuide';
+export type { RenderOptions, RenderResponse, RenderWidgetInput } from './modules/mcp/tools/renderWidget';

package/dist/render.js

@@ -0,0 +1,3 @@
+import { renderGuideText } from "./modules/mcp/resources/renderGuide.js";
+import { HOST_PAGE_REF, render, renderWidgetShape } from "./modules/mcp/tools/renderWidget.js";
+export { HOST_PAGE_REF as RENDER_ROOT_REF, render, renderGuideText, renderWidgetShape };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-mcp",
-  "version": "0.38.12",
+  "version": "0.38.14",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -19,6 +19,11 @@
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js",
       "default": "./dist/server.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "import": "./dist/render.js",
+      "default": "./dist/render.js"
     }
   },
   "repository": {
@@ -30,12 +35,12 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.7.5",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@plitzi/plitzi-sdk": "0.38.12",
-    "@plitzi/sdk-authoring": "0.38.12",
-    "@plitzi/sdk-schema": "0.38.12",
-    "@plitzi/sdk-server": "0.38.12",
-    "@plitzi/sdk-shared": "0.38.12",
-    "@plitzi/sdk-style": "0.38.12",
+    "@plitzi/plitzi-sdk": "0.38.14",
+    "@plitzi/sdk-authoring": "0.38.14",
+    "@plitzi/sdk-schema": "0.38.14",
+    "@plitzi/sdk-server": "0.38.14",
+    "@plitzi/sdk-shared": "0.38.14",
+    "@plitzi/sdk-style": "0.38.14",
     "ejs": "^6.0.1",
     "esbuild": "^0.28.2",
     "zod": "^4.6.5"