@openfairygui/mcp 0.3.0-alpha.1 → 0.3.0-alpha.3

package/README.md

@@ -13,6 +13,7 @@ It maps the backend P2 runtime surface into MCP tools:
 - `openProjectSession`
 - `getSession`
 - `getProjectOutline`
+- `validateSession`
 - `applyTransaction`
 - `saveSession`
 - `materializeSession`
@@ -42,7 +43,7 @@ P1 also registers MCP-native ergonomics around the same backend surface:
 - prompts for capability inspection, session open/inspect, project-outline inspection, revision-checked transactions, save, and runtime polling
 
 Resources return `application/json` text containing the unchanged backend result envelope. Parameterized polling remains tool-based: `getEvents` and `listJobs` are not exposed as resource URI query grammars.
-The project outline is revision-bound and exposes package, resource, folder, display-node, controller-page, and transition identities for transaction planning. It intentionally omits source bytes and full property payloads.
+The project outline is revision-bound and exposes package, resource, folder, display-node, controller-page, and transition identities for transaction planning. It intentionally omits source bytes and full property payloads. `validateSession` returns the backend-owned read-only project validation report; the MCP adapter does not reinterpret its diagnostics.
 
 It does **not** redefine transaction selectors, transaction operations, path policy, session semantics, job semantics, cache semantics, or backend error envelopes. Those remain owned by `@openfairygui/backend`, `@openfairygui/functions`, and `@openfairygui/core`.
 

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-BqoMZ4QC.cjs");
+const require_stdio = require("./stdio-BXisOzWj.cjs");
 exports.OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI = require_stdio.OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI;
 exports.OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = require_stdio.OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS;
 exports.OPENFAIRYGUI_BACKEND_PROMPT_NAMES = require_stdio.OPENFAIRYGUI_BACKEND_PROMPT_NAMES;

package/dist/index.d.cts

@@ -6,9 +6,9 @@ import { z } from "zod";
 
 //#region src/tool-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
-declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_get_project_outline", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_materialize_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
+declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_get_project_outline", "openfairygui_backend_validate_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_materialize_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
 type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES[number];
-type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -137,6 +137,27 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: true;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_validate_session";
+  readonly backendMethod: "validateSession";
+  readonly title: "Validate Project Session";
+  readonly description: "Validate the current session project structure, references, paths, and available source bytes without writing files.";
+  readonly inputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+  }, z.core.$strip>;
+  readonly outputSchema: z.ZodObject<{
+    backendResult: z.ZodObject<{
+      ok: z.ZodBoolean;
+      data: z.ZodOptional<z.ZodUnknown>;
+      error: z.ZodOptional<z.ZodUnknown>;
+      meta: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+  }, z.core.$strip>;
+  readonly annotations: {
+    readonly readOnlyHint: true;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_apply_transaction";
   readonly backendMethod: "applyTransaction";
@@ -382,7 +403,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
 }];
 //#endregion
 //#region src/tool-handler.d.ts
-type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache'>;
+type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache'>;
 declare function callOpenFairyGuiBackendTool(runtime: OpenFairyGuiBackendRuntime, name: OpenFairyGuiBackendToolName, input: Record<string, unknown>): Promise<CallToolResult>;
 //#endregion
 //#region src/server.d.ts

package/dist/index.d.mts

@@ -6,9 +6,9 @@ import { BackendRuntime } from "@openfairygui/backend";
 
 //#region src/tool-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
-declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_get_project_outline", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_materialize_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
+declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: readonly ["openfairygui_backend_get_capabilities", "openfairygui_backend_open_session", "openfairygui_backend_open_project_session", "openfairygui_backend_get_session", "openfairygui_backend_get_project_outline", "openfairygui_backend_validate_session", "openfairygui_backend_apply_transaction", "openfairygui_backend_save_session", "openfairygui_backend_materialize_session", "openfairygui_backend_close_session", "openfairygui_backend_get_events", "openfairygui_backend_get_job", "openfairygui_backend_list_jobs", "openfairygui_backend_cancel_job", "openfairygui_backend_get_cache_snapshot", "openfairygui_backend_refresh_cache"];
 type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES[number];
-type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -137,6 +137,27 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: true;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_validate_session";
+  readonly backendMethod: "validateSession";
+  readonly title: "Validate Project Session";
+  readonly description: "Validate the current session project structure, references, paths, and available source bytes without writing files.";
+  readonly inputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+  }, z.core.$strip>;
+  readonly outputSchema: z.ZodObject<{
+    backendResult: z.ZodObject<{
+      ok: z.ZodBoolean;
+      data: z.ZodOptional<z.ZodUnknown>;
+      error: z.ZodOptional<z.ZodUnknown>;
+      meta: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+  }, z.core.$strip>;
+  readonly annotations: {
+    readonly readOnlyHint: true;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_apply_transaction";
   readonly backendMethod: "applyTransaction";
@@ -382,7 +403,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
 }];
 //#endregion
 //#region src/tool-handler.d.ts
-type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache'>;
+type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache'>;
 declare function callOpenFairyGuiBackendTool(runtime: OpenFairyGuiBackendRuntime, name: OpenFairyGuiBackendToolName, input: Record<string, unknown>): Promise<CallToolResult>;
 //#endregion
 //#region src/server.d.ts

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, c as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, d as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, i as OPENFAIRYGUI_BACKEND_TOOL_NAMES, l as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, r as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, s as callOpenFairyGuiBackendTool, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS } from "./stdio-C69hamhI.mjs";
+import { a as OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, c as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, d as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, i as OPENFAIRYGUI_BACKEND_TOOL_NAMES, l as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, r as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, s as callOpenFairyGuiBackendTool, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS } from "./stdio-CSoMRo55.mjs";
 export { OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS, OPENFAIRYGUI_BACKEND_PROMPT_NAMES, OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, OPENFAIRYGUI_BACKEND_TOOL_NAMES, OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA, OPENFAIRYGUI_BACKEND_TOOL_PREFIX, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };

package/dist/{stdio-BqoMZ4QC.cjs → stdio-BXisOzWj.cjs}

@@ -181,6 +181,9 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_get_project_outline":
 			result = runtime.getProjectOutline({ sessionId: String(input.sessionId) });
 			break;
+		case "openfairygui_backend_validate_session":
+			result = runtime.validateSession({ sessionId: String(input.sessionId) });
+			break;
 		case "openfairygui_backend_apply_transaction":
 			result = await runtime.applyTransaction({
 				sessionId: String(input.sessionId),
@@ -257,6 +260,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_open_project_session",
 	"openfairygui_backend_get_session",
 	"openfairygui_backend_get_project_outline",
+	"openfairygui_backend_validate_session",
 	"openfairygui_backend_apply_transaction",
 	"openfairygui_backend_save_session",
 	"openfairygui_backend_materialize_session",
@@ -349,6 +353,19 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_validate_session",
+		backendMethod: "validateSession",
+		title: "Validate Project Session",
+		description: "Validate the current session project structure, references, paths, and available source bytes without writing files.",
+		inputSchema: zod.z.object({ sessionId }),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_apply_transaction",
 		backendMethod: "applyTransaction",
@@ -532,7 +549,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 function getInjectedPackageVersion() {
-	const version = "0.3.0-alpha.1";
+	const version = "0.3.0-alpha.3";
 	return typeof version === "string" && true ? version : null;
 }
 function readPackageVersion() {

package/dist/{stdio-C69hamhI.mjs → stdio-CSoMRo55.mjs}

@@ -181,6 +181,9 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_get_project_outline":
 			result = runtime.getProjectOutline({ sessionId: String(input.sessionId) });
 			break;
+		case "openfairygui_backend_validate_session":
+			result = runtime.validateSession({ sessionId: String(input.sessionId) });
+			break;
 		case "openfairygui_backend_apply_transaction":
 			result = await runtime.applyTransaction({
 				sessionId: String(input.sessionId),
@@ -257,6 +260,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_open_project_session",
 	"openfairygui_backend_get_session",
 	"openfairygui_backend_get_project_outline",
+	"openfairygui_backend_validate_session",
 	"openfairygui_backend_apply_transaction",
 	"openfairygui_backend_save_session",
 	"openfairygui_backend_materialize_session",
@@ -349,6 +353,19 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_validate_session",
+		backendMethod: "validateSession",
+		title: "Validate Project Session",
+		description: "Validate the current session project structure, references, paths, and available source bytes without writing files.",
+		inputSchema: z.object({ sessionId }),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_apply_transaction",
 		backendMethod: "applyTransaction",
@@ -532,7 +549,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const require = createRequire(import.meta.url);
 function getInjectedPackageVersion() {
-	const version = "0.3.0-alpha.1";
+	const version = "0.3.0-alpha.3";
 	return typeof version === "string" && true ? version : null;
 }
 function readPackageVersion() {

package/dist/stdio.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-BqoMZ4QC.cjs");
+const require_stdio = require("./stdio-BXisOzWj.cjs");
 exports.connectOpenFairyGuiMcpStdio = require_stdio.connectOpenFairyGuiMcpStdio;

package/dist/stdio.mjs

@@ -1,2 +1,2 @@
-import { t as connectOpenFairyGuiMcpStdio } from "./stdio-C69hamhI.mjs";
+import { t as connectOpenFairyGuiMcpStdio } from "./stdio-CSoMRo55.mjs";
 export { connectOpenFairyGuiMcpStdio };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/mcp",
-  "version": "0.3.0-alpha.1",
+  "version": "0.3.0-alpha.3",
   "description": "FairyGUI Headless Authoring SDK - MCP server adapter for the backend runtime.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -58,13 +58,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6",
-    "@openfairygui/backend": "0.3.0-alpha.1"
+    "@openfairygui/backend": "0.3.0-alpha.3"
   },
   "devDependencies": {
     "ava": "^7.0.0",
     "tsx": "^4.0.0",
     "@openfairygui/test-utils": "0.2.0-alpha.10",
-    "@openfairygui/core": "0.3.0-alpha.1"
+    "@openfairygui/core": "0.3.0-alpha.3"
   },
   "ava": {
     "extensions": {

package/src/tool-definitions.ts

@@ -8,6 +8,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	'openfairygui_backend_open_project_session',
 	'openfairygui_backend_get_session',
 	'openfairygui_backend_get_project_outline',
+	'openfairygui_backend_validate_session',
 	'openfairygui_backend_apply_transaction',
 	'openfairygui_backend_save_session',
 	'openfairygui_backend_materialize_session',
@@ -28,6 +29,7 @@ export type BackendMethodName =
 	| 'openProjectSession'
 	| 'getSession'
 	| 'getProjectOutline'
+	| 'validateSession'
 	| 'applyTransaction'
 	| 'saveSession'
 	| 'materializeSession'
@@ -121,6 +123,15 @@ export const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
 	},
+	{
+		name: 'openfairygui_backend_validate_session',
+		backendMethod: 'validateSession',
+		title: 'Validate Project Session',
+		description: 'Validate the current session project structure, references, paths, and available source bytes without writing files.',
+		inputSchema: z.object({ sessionId }),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+	},
 	{
 		name: 'openfairygui_backend_apply_transaction',
 		backendMethod: 'applyTransaction',

package/src/tool-handler.ts

@@ -9,6 +9,7 @@ export type OpenFairyGuiBackendRuntime = Pick<
 	| 'openProjectSession'
 	| 'getSession'
 	| 'getProjectOutline'
+	| 'validateSession'
 	| 'applyTransaction'
 	| 'saveSession'
 	| 'materializeSession'
@@ -76,6 +77,11 @@ export async function callOpenFairyGuiBackendTool(
 				sessionId: String(input.sessionId),
 			});
 			break;
+		case 'openfairygui_backend_validate_session':
+			result = runtime.validateSession({
+				sessionId: String(input.sessionId),
+			});
+			break;
 		case 'openfairygui_backend_apply_transaction':
 			result = await runtime.applyTransaction({
 				sessionId: String(input.sessionId),