@plitzi/sdk-mcp 0.38.3 → 0.38.5

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

@@ -14,7 +14,7 @@ var tryFunctionShape = {
 var tryFunction = async (input, ctx) => {
 	if (input.dryRun) return {
 		ran: false,
-		reason: "Trying a function runs its code for real — its fetches and its writes — so not in plan mode"
+		reason: "Trying a function runs its code for real — its fetches and its writes — so a dry run does not run it"
 	};
 	if (!ctx.tryFunction) return {
 		ran: false,

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

@@ -54,6 +54,7 @@ export declare const validateShape: {
         flag: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         anchor: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         motion: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>>;
+        quiet: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodArray<import('zod').ZodString>>>;
     }, import('zod/v4/core').$strip>, import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteElement">;
         pageRef: import('zod').ZodString;
@@ -208,6 +209,7 @@ export declare const validateShape: {
                 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>>;
@@ -226,6 +228,7 @@ export declare const validateShape: {
             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>>;
@@ -814,11 +817,11 @@ export declare const validateShape: {
                 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 +905,11 @@ export declare const validateShape: {
                 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 +1056,13 @@ export declare const validateShape: {
     }, import('zod/v4/core').$strip>, import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteFunctionFile">;
         path: import('zod').ZodString;
+    }, import('zod/v4/core').$strip>, import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"upsertDataFile">;
+        path: import('zod').ZodString;
+        content: import('zod').ZodString;
+    }, import('zod/v4/core').$strip>, import('zod').ZodObject<{
+        type: import('zod').ZodLiteral<"deleteDataFile">;
+        path: import('zod').ZodString;
     }, import('zod/v4/core').$strip>], "type">>;
 };
 export declare const validate: (input: ValidateInput, space: Space) => ValidationResult;

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

@@ -16,9 +16,9 @@ export interface McpApp {
  *  that serves both settings still builds the (expensive) browser bundle once. The view reads them off
  *  `window.__PLITZI_VIEW__`, and must treat every one as optional: an older page carries none. */
 export interface McpViewSettings {
-    /** May the view paint from tool arguments the host is still streaming? See `mcpAi.renderStreaming`. */
+    /** May the view paint from tool arguments the host is still streaming? See `McpOptions.renderStreaming`. */
     streaming: boolean;
-    /** Absolute resource endpoint of the server that served the page, when it serves one (see `mcpAi.proxy`). It
+    /** Absolute resource endpoint of the server that served the page, when it serves one (see `McpOptions.proxy`). It
      *  shapes the PAGE rather than the view: its origin is what the resource CSP declares, so the URLs a render
      *  rewrote to it are allowed to load. The view needs nothing from it — every URL is rewritten server-side,
      *  where the signing secret is. */

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

@@ -1,6 +1,6 @@
 import { AIDefinition, AIElementDetail, ValidationError } from './aiSchema';
 import { Operation } from '../tools/operations';
-import { ActionEntry, ConnectorEntry, FunctionsSaveResult, Schema, Style } from '@plitzi/sdk-shared';
+import { ActionEntry, ConnectorEntry, DataSaveResult, FunctionsSaveResult, Schema, Style } from '@plitzi/sdk-shared';
 /** The element schema, the style schema and the connectors persist independently (Space model / Style model / one
  *  row per connector), so each has its own optional persister. When one is absent, that store is applied in memory
  *  but reported unsaved. Connectors save and delete a row at a time — a batch touching two of them saves those two
@@ -14,6 +14,8 @@ export interface Persisters {
     deleteAction?: (actionId: string) => Promise<void>;
     /** Saves the functions' files whole, against the version the batch read; answers what is wrong where it is. */
     saveFunctions?: (files: Record<string, string>, base: string) => Promise<FunctionsSaveResult>;
+    /** Saves the data's files whole, against the version the batch read; answers what is wrong by file. */
+    saveData?: (files: Record<string, string>, base: string) => Promise<DataSaveResult>;
 }
 export interface Conflict {
     resourceUri: string;
@@ -72,6 +74,8 @@ export interface MutationOutcome {
     deletedActions: string[];
     /** The functions' files changed: they are saved whole, as one store. */
     changedFunctions: boolean;
+    /** The data's files changed: saved whole too, as a store of their own. */
+    changedData: boolean;
 }
 export interface ApplyInput {
     environment?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-mcp",
-  "version": "0.38.3",
+  "version": "0.38.5",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -30,14 +30,12 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.7.5",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@plitzi/plitzi-sdk": "0.38.3",
-    "@plitzi/sdk-authoring": "0.38.3",
-    "@plitzi/sdk-elements": "0.38.3",
-    "@plitzi/sdk-interactions": "0.38.3",
-    "@plitzi/sdk-schema": "0.38.3",
-    "@plitzi/sdk-server": "0.38.3",
-    "@plitzi/sdk-shared": "0.38.3",
-    "@plitzi/sdk-style": "0.38.3",
+    "@plitzi/plitzi-sdk": "0.38.5",
+    "@plitzi/sdk-authoring": "0.38.5",
+    "@plitzi/sdk-schema": "0.38.5",
+    "@plitzi/sdk-server": "0.38.5",
+    "@plitzi/sdk-shared": "0.38.5",
+    "@plitzi/sdk-style": "0.38.5",
     "ejs": "^6.0.1",
     "esbuild": "^0.28.2",
     "zod": "^4.6.5"

package/dist/modules/ai/AIEngine.d.ts

@@ -1,20 +0,0 @@
-import { AiMode, AiContext, McpPromptHandler, McpToolHandler, McpToolLifecycleHooks, StreamCallbacks, McpTool, McpToolHandlerResult } from '@plitzi/sdk-shared';
-declare class AIEngine implements McpToolLifecycleHooks {
-    private readonly mode;
-    readonly callbacks: StreamCallbacks;
-    private toolsAvailables;
-    private toolsAvailablesMap;
-    ctx: AiContext;
-    constructor(mode: AiMode | undefined, callbacks: StreamCallbacks, ctx: Omit<AiContext, 'mode'>);
-    readonly readResource: (name: string, uri: string) => void;
-    readonly setToolsAvailables: (tools: McpTool[]) => void;
-    readonly can: (name: string) => boolean;
-    readonly before: (name: string, args: Record<string, unknown>) => Promise<boolean>;
-    readonly after: (name: string, args: Record<string, unknown>, result: McpToolHandlerResult) => Promise<void>;
-    private readonly validateToolInput;
-    private readonly validateToolOutput;
-    private readonly runPipeline;
-    readonly execute: (name: string, handlerFn?: McpToolHandler) => (args: Record<string, unknown>) => Promise<McpToolHandlerResult>;
-    readonly executePrompt: (_name: string, handlerFn: McpPromptHandler) => (args: Record<string, unknown>) => Promise<import('@plitzi/sdk-shared').McpPromptHandlerResult>;
-}
-export default AIEngine;

package/dist/modules/ai/AIEngine.js

@@ -1,120 +0,0 @@
-import { firstText, toolResponseErr } from "./toolkit.js";
-//#region src/modules/ai/AIEngine.ts
-var AIEngine = class {
-	mode;
-	callbacks;
-	toolsAvailables = /* @__PURE__ */ new Map();
-	toolsAvailablesMap = /* @__PURE__ */ new Map();
-	ctx;
-	constructor(mode, callbacks, ctx) {
-		this.mode = mode;
-		this.callbacks = callbacks;
-		this.ctx = {
-			...ctx,
-			mode: mode || "plan"
-		};
-	}
-	readResource = (name, uri) => {
-		this.callbacks.onResourceRead?.(name, uri);
-	};
-	setToolsAvailables = (tools) => {
-		this.toolsAvailables = new Map(tools.map((t) => [t.name, t]));
-		this.toolsAvailablesMap = new Map(tools.map((t) => [t.name, t.definition.allowedModes]));
-	};
-	can = (name) => {
-		if (!this.mode || !this.toolsAvailablesMap.has(name)) return false;
-		const allowedModes = this.toolsAvailablesMap.get(name);
-		return !allowedModes || allowedModes.includes(this.mode);
-	};
-	before = async (name, args) => {
-		this.callbacks.onBeforeTool?.(name, args);
-		if (!this.toolsAvailables.has(name)) {
-			this.callbacks.onLog?.("error", `tool rejected: '${name}' has no definition — possible security violation`);
-			await this.after(name, args, toolResponseErr(`Tool '${name}' is not defined and cannot be executed`));
-			return false;
-		}
-		if (!this.can(name)) {
-			this.callbacks.onLog?.("info", `tool blocked: '${name}' is not permitted in ${this.mode} mode`);
-			await this.after(name, args, toolResponseErr(`Tool '${name}' is not permitted in ${this.mode} mode`));
-			return false;
-		}
-		return true;
-	};
-	after = (name, args, result) => {
-		let resultParsed;
-		if (result.data !== void 0) resultParsed = result.data;
-		else try {
-			resultParsed = JSON.parse(firstText(result.content) ?? "");
-		} catch {}
-		if (result.isError) this.callbacks.onToolError?.({
-			name,
-			args,
-			result: resultParsed ?? { error: firstText(result.content) ?? "Tool failed" }
-		});
-		else this.callbacks.onToolSuccess?.({
-			name,
-			args,
-			result: resultParsed
-		});
-		return Promise.resolve();
-	};
-	validateToolInput = (name, args) => {
-		const tool = this.toolsAvailables.get(name);
-		if (!tool || !tool.mcpDefinition.inputSchema) return {
-			success: true,
-			data: args
-		};
-		const parsed = tool.mcpDefinition.inputSchema.safeParse(args);
-		if (!parsed.success) return {
-			success: false,
-			error: parsed.error.message
-		};
-		return {
-			success: true,
-			data: parsed.data
-		};
-	};
-	validateToolOutput = (name, result) => {
-		const tool = this.toolsAvailables.get(name);
-		if (!tool || !tool.mcpDefinition.outputSchema || result.isError) return;
-		if (result.data === void 0) return;
-		const parsed = tool.mcpDefinition.outputSchema.safeParse(result.data);
-		if (!parsed.success) return parsed.error.message;
-	};
-	runPipeline = async (name, args, handler) => {
-		const parsedArgs = this.validateToolInput(name, args);
-		if (!parsedArgs.success) {
-			this.callbacks.onLog?.("error", `tool validation error: ${name} error=${parsedArgs.error}`);
-			const err = toolResponseErr(parsedArgs.error);
-			await this.after(name, args, err);
-			return err;
-		}
-		const t0 = Date.now();
-		const result = await handler(parsedArgs.data, this.ctx);
-		this.callbacks.onLog?.("debug", `tool done: ${name} ms=${Date.now() - t0} result=${JSON.stringify(result).slice(0, 200)}`);
-		const outputError = this.validateToolOutput(name, result);
-		if (outputError) this.callbacks.onLog?.("info", `tool output schema drift: ${name} — ${outputError}`);
-		const tool = this.toolsAvailables.get(name);
-		if (!result.isError && tool?.mcpDefinition.outputSchema && result.data !== void 0 && result.data !== null) result.structuredContent = typeof result.data === "object" && !Array.isArray(result.data) ? result.data : { data: result.data };
-		if (result.isError) this.callbacks.onLog?.("error", `tool failed: ${name} error=${firstText(result.content) ?? "unknown"}`);
-		await this.after(name, args, result);
-		return result;
-	};
-	execute = (name, handlerFn) => async (args) => {
-		if (!await this.before(name, args)) return toolResponseErr(`Tool '${name}' execution was blocked`);
-		const handler = handlerFn ?? this.toolsAvailables.get(name)?.handler;
-		if (!handler) {
-			this.callbacks.onLog?.("error", `no handler registered for tool: ${name}`);
-			const err = toolResponseErr(`Tool '${name}' has no handler`);
-			await this.after(name, args, err);
-			return err;
-		}
-		this.callbacks.onLog?.("debug", `tool exec: ${name} args=${JSON.stringify(args).slice(0, 200)}`);
-		return this.runPipeline(name, args, handler);
-	};
-	executePrompt = (_name, handlerFn) => async (args) => {
-		return handlerFn(args, this.ctx);
-	};
-};
-//#endregion
-export { AIEngine as default };

package/dist/modules/ai/index.d.ts

@@ -1,4 +0,0 @@
-import { default as AIEngine } from './AIEngine';
-export * from './AIEngine';
-export { zodToJsonSchema, getAllowedModes, toolResponseOk, toolResponseErr, bindTools, isToolActive, resolveToolHandler, isCallToolResult, toolResponseFromResult } from './toolkit';
-export { AIEngine };

package/dist/modules/ai/toolkit.d.ts

@@ -1,17 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { AiMode, McpContent, McpTool, McpToolHandler, McpToolHandlerResult, ToolOperationType } from '@plitzi/sdk-shared';
-/** Convert a Zod schema to the JSON Schema an AI provider (Anthropic / OpenAI) expects in a tool definition.
- *  Delegates to Zod v4's built-in converter — one implementation, so descriptions, literal discriminators,
- *  enums, nested objects and recursive (z.lazy) shapes all survive and the provider sees the same contract an
- *  MCP client does. `io: 'input'` describes what the agent must SEND; `unrepresentable: 'any'` degrades an
- *  exotic type to an empty schema instead of throwing, so one unusual tool never breaks the whole tool list. */
-export declare const zodToJsonSchema: (schema: unknown) => Record<string, unknown>;
-export declare const firstText: (content: McpContent[]) => string | undefined;
-export declare const getAllowedModes: (operationType: ToolOperationType) => AiMode[];
-export declare const toolResponseOk: (data: unknown, agentMessage?: string) => McpToolHandlerResult;
-export declare const toolResponseErr: (error: Error | string) => McpToolHandlerResult;
-export declare const isCallToolResult: (result: unknown) => result is CallToolResult;
-export declare const toolResponseFromResult: (result: CallToolResult) => McpToolHandlerResult;
-export declare const isToolActive: (tool: McpTool) => boolean;
-export declare const resolveToolHandler: (tool: McpTool) => McpToolHandler | undefined;
-export declare const bindTools: (tools: McpTool[]) => McpTool[];

package/dist/modules/ai/toolkit.js

@@ -1,59 +0,0 @@
-import { z } from "zod";
-//#region src/modules/ai/toolkit.ts
-/** Convert a Zod schema to the JSON Schema an AI provider (Anthropic / OpenAI) expects in a tool definition.
-*  Delegates to Zod v4's built-in converter — one implementation, so descriptions, literal discriminators,
-*  enums, nested objects and recursive (z.lazy) shapes all survive and the provider sees the same contract an
-*  MCP client does. `io: 'input'` describes what the agent must SEND; `unrepresentable: 'any'` degrades an
-*  exotic type to an empty schema instead of throwing, so one unusual tool never breaks the whole tool list. */
-var zodToJsonSchema = (schema) => {
-	const json = z.toJSONSchema(schema, {
-		target: "draft-7",
-		io: "input",
-		unrepresentable: "any"
-	});
-	delete json.$schema;
-	return json;
-};
-var firstText = (content) => content.find((block) => block.type === "text")?.text;
-var getAllowedModes = (operationType) => {
-	return operationType === "write" ? ["build"] : ["plan", "build"];
-};
-var toolResponseOk = (data, agentMessage) => {
-	return {
-		content: [{
-			type: "text",
-			text: agentMessage ?? JSON.stringify(data ?? null, null, 2)
-		}],
-		data
-	};
-};
-var toolResponseErr = (error) => ({
-	content: [{
-		type: "text",
-		text: error instanceof Error ? error.message : error
-	}],
-	isError: true
-});
-var isCallToolResult = (result) => typeof result === "object" && result !== null && Array.isArray(result.content);
-var toolResponseFromResult = (result) => {
-	const content = [];
-	for (const block of result.content) if (block.type === "text") content.push({
-		type: "text",
-		text: block.text
-	});
-	else if (block.type === "image") content.push({
-		type: "image",
-		data: block.data,
-		mimeType: block.mimeType
-	});
-	return {
-		content,
-		data: result.structuredContent,
-		isError: result.isError ? true : void 0
-	};
-};
-var isToolActive = (tool) => Boolean(tool.handler);
-var resolveToolHandler = (tool) => tool.handler;
-var bindTools = (tools) => tools.filter(isToolActive);
-//#endregion
-export { bindTools, firstText, getAllowedModes, isCallToolResult, isToolActive, resolveToolHandler, toolResponseErr, toolResponseFromResult, toolResponseOk, zodToJsonSchema };

package/dist/modules/mcp/helpers/agentPrompt.d.ts

@@ -1,4 +0,0 @@
-/** The MCP-owned guidance block a consumer concatenates into its system prompt. Covers what the MCP is
- *  authoritative about: its editing model, tools, resources and interaction vocabulary. It intentionally does NOT
- *  cover a consumer’s own tools (previews, design helpers) or product framing (modes, identity, security). */
-export declare const buildAgentGuide: () => string;

package/dist/modules/mcp/helpers/agentPrompt.js

@@ -1,123 +0,0 @@
-import { BUILTIN_ELEMENT_CALLBACKS, BUILTIN_GLOBAL_CALLBACKS, BUILTIN_UTILITIES } from "../catalogs/index.js";
-//#region src/modules/mcp/helpers/agentPrompt.ts
-var EDITING_MODEL = [
-	"━━ PLITZI MCP — EDITING MODEL ━━",
-	"A Plitzi space is TWO schemas you edit together in one atomic plitzi_apply batch:",
-	"• Element schema — the tree of pages/elements (type, label, props, and which style classes each uses).",
-	"• Style schema — reusable definitions (CSS classes), design tokens (variables), theme.",
-	"To style an element: write a definition AND attach it via the element’s style.base in the same batch.",
-	"style.base is a LIST — an element can attach several classes (plus non-base slots); ALL of them apply together",
-	"(they cascade), so when a style looks wrong inspect EVERY attached class + its global/id styles, not just one.",
-	"Every element and page has ONE name, which IS its id: you choose it ([A-Za-z0-9_-] starting with a letter,",
-	"unique in the space), you address it by it, and the runtime wires by it (a provider source is",
-	"`<type>_<id>.<field>` — a dot is not allowed in a name, an underscore is). Nothing hands out opaque ids, so",
-	"never invent one: name the thing. CSS is kebab-case; style vars are var(--name), schema",
-	"vars are {{name}}. Use patchElement/patchDefinition to change SOME props/CSS; the upsert variants replace them all.",
-	"Reads are cheap by design — list to navigate, read one item for detail; never fetch a whole tree you do not need."
-].join("\n");
-var TOOLS = [
-	"━━ MCP TOOLS ━━",
-	"• plitzi_search — find elements by label/type/attribute; a hit carries the NAME every op takes (include:\"detail\"",
-	"  also returns its style + versions).",
-	"• plitzi_read — batch-read one or more resource URIs you already hold (from search or a write response).",
-	"• plitzi_validate — check a batch of operations without executing; returns teachable errors and warnings, and",
-	"  suggestions: a shorter way to the same page (a layout, a component, the content of a link) — never blocking.",
-	"• plitzi_apply — persist a batch of operations. Pass dryRun to preview the full diff without writing, and",
-	"  expectedResourceVersions to guard against concurrent edits (apply and search hand back the versions you need).",
-	"• plitzi_preview / plitzi_screenshot — render a page (HTML / PNG), with unsaved operations applied if you pass them.",
-	"  plitzi_screenshot view:\"accessibility\" reads it as a screen reader or a browser agent does, listing what has no name.",
-	"• plitzi_render — show the user an offline widget; it never touches the space (read plitzi://render/guide).",
-	"Discover → browse resources. Find a name → plitzi_search. Fetch known URIs → plitzi_read. Do not confuse them."
-].join("\n");
-var RESOURCES = [
-	"━━ MCP RESOURCES (read) ━━",
-	"Read plitzi://primer/{env} FIRST — a cold-start bundle: the guide’s quickstart + types + css-properties +",
-	"page/definition/variable summaries in one call. Then, on demand:",
-	"• plitzi://guide — full usage reference.",
-	"• plitzi://types — element types observed in this space (props, slots, subTypes, label/description/category).",
-	"• plitzi://css-properties — valid kebab-case CSS property keys.",
-	"• plitzi://schema/{env}/pages , /{ref} — page summaries, then one page as a skeleton tree.",
-	"• plitzi://schema/{env}/layouts — shared layout shells (header/sidebar/footer) and the pages inside each.",
-	"• plitzi://folders/{env} — page folders (the sidebar tree).",
-	"• plitzi://definitions/{env} , plitzi://style-variables/{env} , plitzi://fonts/{env} — style classes, design",
-	"  tokens and the font families the space loads.",
-	"• plitzi://interactions/{env} — interaction actions + built-in globalCallbacks with their source + param schema.",
-	"• plitzi://data-sources/{env} — data-source paths and binding targets (vocabulary for upsertBinding).",
-	"• plitzi://connectors/{env} , plitzi://connector-presets — CMS/API connectors (this space’s, and working ones).",
-	"• plitzi://actions/{env} , /tasks — server actions, and the tasks this deployment can build them from.",
-	"• plitzi://changes/{env} , /{id} — the change history (read-only): who changed what, before and after.",
-	"• plitzi://settings/{env} — space-level settings."
-].join("\n");
-var ACCESSIBILITY = [
-	"━━ ACCESSIBILITY ━━",
-	"Screen readers and browser agents (Claude in Chrome) work a page through its accessibility tree, so build every page",
-	"to be usable without sight: a button or link has words (an icon-only button a `title`; a link wrapping a card a",
-	"`label`), a field a `label` (`hideLabel: true` keeps it out of sight), an image an `alt` or `decorative: true`.",
-	"Clicks go on a button (it holds children) or a link — never on a container, text or image. Toggles bind",
-	"`ariaPressed`, openers `ariaExpanded`. Headings step down one level at a time. The linter warns on each of these."
-].join("\n");
-var NAVIGATION = [
-	"━━ NAVIGATION & DYNAMIC PAGES ━━",
-	"To move between pages, PREFER the Link element over an interaction — its words are its `content`, and it can wrap",
-	"any children too. The link to the page being shown is styled by its class's `current` state. mode \"page\" links",
-	"to another space page (href = the target page); mode \"internal\" takes a path inside the space and resolves",
-	"{{token}} templates in it (e.g. posts/{{postId}}); mode \"external\" is a full URL. Reach for the navigate",
-	"globalCallback only when navigation must be one step inside a larger flow.",
-	"A page slug is RELATIVE — never start it with \"/\" (the runtime prepends it). Folder slugs PREPEND to the page",
-	"slug, so a page at slug \"post\" inside folders \"blog\" > \"2024\" resolves to /blog/2024/post.",
-	"A slug segment \":name\" (e.g. \"posts/:postId\") declares a ROUTE PARAM, react-router style. It is readable on that",
-	"page as {{name}} in props AND as the binding source navigation.routeParams.name — so a dynamic detail page is a",
-	"\"posts/:postId\" page whose apiContainer query binds navigation.routeParams.postId."
-].join("\n");
-var paramList = (params) => {
-	const names = Object.keys(params);
-	return names.length > 0 ? names.join(", ") : "(no params)";
-};
-var globalCallbackLines = () => Object.entries(BUILTIN_GLOBAL_CALLBACKS).map(([action, { source, params }]) => `  • ${action} → source "${source}"; params: ${paramList(params)}`);
-var elementCallbackLines = () => Object.entries(BUILTIN_ELEMENT_CALLBACKS).map(([action, { params }]) => `  • ${action}; params: ${paramList(params)}`);
-var utilityLines = () => Object.entries(BUILTIN_UTILITIES).map(([action, { params }]) => `  • ${action}; params: ${paramList(params)}`);
-var INTERACTIONS = () => [
-	"━━ INTERACTIONS ━━",
-	"A flow is a trigger (onClick, onPageLoad…) followed by ordered callbacks/utilities; each step has an enabled",
-	"flag. Write one with upsertInteractionFlow (first node MUST be a trigger); change one step with",
-	"patchInteractionNode; remove a step (nodeId) or a whole flow (flowId) with deleteInteraction.",
-	"Disable ≠ delete: to turn a step off without removing it use patchInteractionNode { enabled: false }.",
-	"deleteInteraction is destructive — confirm with the user first.",
-	"Pick the RIGHT node type for an action: the wrong type resolves against nothing and the step silently no-ops.",
-	"Any param VALUE can be a data-binding token {{ source }} — e.g. addNotification content",
-	"\"{{ list_<name>.item.name }}\" shows the clicked row’s field; it resolves at runtime just like a prop binding.",
-	"",
-	"globalCallback (nodeType \"globalCallback\") — provided by a SOURCE MODULE, not the host element: OMIT elementId",
-	"and the MCP pins the right source and fills the builder’s param defaults. Use ONLY each callback’s declared",
-	"params (exact spelling) — for addNotification the text goes in `content` (NO title/message/type). Built-ins:",
-	...globalCallbackLines(),
-	"",
-	"callback (nodeType \"callback\") — a callback ON an element; elementId is that element (host by default). Every",
-	"element has a built-in `setState` that changes ITS OWN attribute/state (category/key/value/revertOnFinish). Set",
-	"revertOnFinish:true for a TEMPORARY change (e.g. a \"loading…\" label) so it auto-reverts at flow end — do NOT add",
-	"manual restore steps. This element setState has NO `type` param (that is the global state setState). Built-ins:",
-	...elementCallbackLines(),
-	"",
-	"utility (nodeType \"utility\") — no element/source. Use the EXACT param names (delayTime waits `time` ms, not",
-	"`delay`). Built-ins:",
-	...utilityLines(),
-	"The full param schema (types, options, defaults) for each is in plitzi://interactions/{env}."
-].join("\n");
-/** The MCP-owned guidance block a consumer concatenates into its system prompt. Covers what the MCP is
-*  authoritative about: its editing model, tools, resources and interaction vocabulary. It intentionally does NOT
-*  cover a consumer’s own tools (previews, design helpers) or product framing (modes, identity, security). */
-var buildAgentGuide = () => [
-	EDITING_MODEL,
-	"",
-	TOOLS,
-	"",
-	RESOURCES,
-	"",
-	ACCESSIBILITY,
-	"",
-	NAVIGATION,
-	"",
-	INTERACTIONS()
-].join("\n");
-//#endregion
-export { buildAgentGuide };