@openfairygui/mcp 0.2.0-alpha.2 → 0.2.0

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-Ckmxm29z.cjs");
+const require_stdio = require("./stdio-eqd_tVeJ.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

@@ -1,22 +1,14 @@
 import { connectOpenFairyGuiMcpStdio } from "./stdio.cjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BackendRuntime } from "@openfairygui/backend";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { BackendRuntime } from "@openfairygui/backend";
 import { z } from "zod";
 
-//#region src/server.d.ts
-interface CreateOpenFairyGuiMcpServerOptions {
-  runtime?: BackendRuntime;
-  name?: string;
-  version?: string;
-}
-declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServerOptions): McpServer;
-//#endregion
 //#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_apply_transaction", "openfairygui_backend_save_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_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' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -157,6 +149,33 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     sessionId: z.ZodString;
     expectedRevision: z.ZodOptional<z.ZodNumber>;
     targetPath: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodLiteral<"materializeCleanSession">>;
+  }, 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: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
+}, {
+  readonly name: "openfairygui_backend_materialize_session";
+  readonly backendMethod: "materializeSession";
+  readonly title: "Materialize Backend Session";
+  readonly description: "Force materialize the current backend session project through the configured project storage without requiring a dirty edit revision.";
+  readonly inputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodLiteral<"fullProject">>;
+    reason: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly outputSchema: z.ZodObject<{
     backendResult: z.ZodObject<{
@@ -176,7 +195,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly name: "openfairygui_backend_close_session";
   readonly backendMethod: "closeSession";
   readonly title: "Close Backend Session";
-  readonly description: "Close a backend session and release its backend-local advisory lock.";
+  readonly description: "Close a backend session and release its backend-local session lock.";
   readonly inputSchema: z.ZodObject<{
     sessionId: z.ZodString;
   }, z.core.$strip>;
@@ -342,7 +361,16 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
 }];
 //#endregion
 //#region src/tool-handler.d.ts
-declare function callOpenFairyGuiBackendTool(runtime: BackendRuntime, name: OpenFairyGuiBackendToolName, input: Record<string, unknown>): Promise<CallToolResult>;
+type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | '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
+interface CreateOpenFairyGuiMcpServerOptions {
+  runtime?: OpenFairyGuiBackendRuntime;
+  name?: string;
+  version?: string;
+}
+declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServerOptions): McpServer;
 //#endregion
 //#region src/prompt-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_PROMPT_NAMES: readonly ["openfairygui_inspect_capabilities", "openfairygui_open_and_inspect_session", "openfairygui_plan_revision_checked_transaction", "openfairygui_save_session", "openfairygui_poll_runtime_state"];
@@ -378,4 +406,4 @@ declare const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS: readonly [{
 declare const OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI = "openfairygui://backend/capabilities";
 declare const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES: readonly ["openfairygui://backend/session/{sessionId}", "openfairygui://backend/cache/{sessionId}", "openfairygui://backend/job/{sessionId}/{jobId}"];
 //#endregion
-export { type BackendMethodName, type CreateOpenFairyGuiMcpServerOptions, 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, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };
+export { type BackendMethodName, type CreateOpenFairyGuiMcpServerOptions, 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, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendRuntime, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };

package/dist/index.d.mts

@@ -1,22 +1,14 @@
 import { connectOpenFairyGuiMcpStdio } from "./stdio.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { BackendRuntime } from "@openfairygui/backend";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { BackendRuntime } from "@openfairygui/backend";
 
-//#region src/server.d.ts
-interface CreateOpenFairyGuiMcpServerOptions {
-  runtime?: BackendRuntime;
-  name?: string;
-  version?: string;
-}
-declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServerOptions): McpServer;
-//#endregion
 //#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_apply_transaction", "openfairygui_backend_save_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_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' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -157,6 +149,33 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     sessionId: z.ZodString;
     expectedRevision: z.ZodOptional<z.ZodNumber>;
     targetPath: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodLiteral<"materializeCleanSession">>;
+  }, 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: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
+}, {
+  readonly name: "openfairygui_backend_materialize_session";
+  readonly backendMethod: "materializeSession";
+  readonly title: "Materialize Backend Session";
+  readonly description: "Force materialize the current backend session project through the configured project storage without requiring a dirty edit revision.";
+  readonly inputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodLiteral<"fullProject">>;
+    reason: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly outputSchema: z.ZodObject<{
     backendResult: z.ZodObject<{
@@ -176,7 +195,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly name: "openfairygui_backend_close_session";
   readonly backendMethod: "closeSession";
   readonly title: "Close Backend Session";
-  readonly description: "Close a backend session and release its backend-local advisory lock.";
+  readonly description: "Close a backend session and release its backend-local session lock.";
   readonly inputSchema: z.ZodObject<{
     sessionId: z.ZodString;
   }, z.core.$strip>;
@@ -342,7 +361,16 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
 }];
 //#endregion
 //#region src/tool-handler.d.ts
-declare function callOpenFairyGuiBackendTool(runtime: BackendRuntime, name: OpenFairyGuiBackendToolName, input: Record<string, unknown>): Promise<CallToolResult>;
+type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | '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
+interface CreateOpenFairyGuiMcpServerOptions {
+  runtime?: OpenFairyGuiBackendRuntime;
+  name?: string;
+  version?: string;
+}
+declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServerOptions): McpServer;
 //#endregion
 //#region src/prompt-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_PROMPT_NAMES: readonly ["openfairygui_inspect_capabilities", "openfairygui_open_and_inspect_session", "openfairygui_plan_revision_checked_transaction", "openfairygui_save_session", "openfairygui_poll_runtime_state"];
@@ -378,4 +406,4 @@ declare const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS: readonly [{
 declare const OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI = "openfairygui://backend/capabilities";
 declare const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES: readonly ["openfairygui://backend/session/{sessionId}", "openfairygui://backend/cache/{sessionId}", "openfairygui://backend/job/{sessionId}/{jobId}"];
 //#endregion
-export { type BackendMethodName, type CreateOpenFairyGuiMcpServerOptions, 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, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };
+export { type BackendMethodName, type CreateOpenFairyGuiMcpServerOptions, 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, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendRuntime, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer };

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-DT1cUPJ3.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-AonL7fG4.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-DT1cUPJ3.mjs → stdio-AonL7fG4.mjs}

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { createNodeBackendRuntime } from "@openfairygui/backend/node";
 import { z } from "zod";
@@ -170,7 +171,17 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 			result = await runtime.saveSession({
 				sessionId: String(input.sessionId),
 				expectedRevision: input.expectedRevision === void 0 ? void 0 : Number(input.expectedRevision),
-				targetPath: input.targetPath === void 0 ? void 0 : String(input.targetPath)
+				targetPath: input.targetPath === void 0 ? void 0 : String(input.targetPath),
+				force: input.force === void 0 ? void 0 : Boolean(input.force),
+				mode: input.mode
+			});
+			break;
+		case "openfairygui_backend_materialize_session":
+			result = await runtime.materializeSession({
+				sessionId: String(input.sessionId),
+				expectedRevision: input.expectedRevision === void 0 ? void 0 : Number(input.expectedRevision),
+				mode: input.mode,
+				reason: input.reason === void 0 ? void 0 : String(input.reason)
 			});
 			break;
 		case "openfairygui_backend_close_session":
@@ -226,6 +237,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_get_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",
@@ -328,7 +340,28 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		inputSchema: z.object({
 			sessionId,
 			expectedRevision: expectedRevision.optional(),
-			targetPath: z.string().min(1).optional()
+			targetPath: z.string().min(1).optional(),
+			force: z.boolean().optional(),
+			mode: z.literal("materializeCleanSession").optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: true,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
+	{
+		name: "openfairygui_backend_materialize_session",
+		backendMethod: "materializeSession",
+		title: "Materialize Backend Session",
+		description: "Force materialize the current backend session project through the configured project storage without requiring a dirty edit revision.",
+		inputSchema: z.object({
+			sessionId,
+			expectedRevision: expectedRevision.optional(),
+			mode: z.literal("fullProject").optional(),
+			reason: z.string().min(1).optional()
 		}),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: {
@@ -342,7 +375,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		name: "openfairygui_backend_close_session",
 		backendMethod: "closeSession",
 		title: "Close Backend Session",
-		description: "Close a backend session and release its backend-local advisory lock.",
+		description: "Close a backend session and release its backend-local session lock.",
 		inputSchema: z.object({ sessionId }),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: {
@@ -462,7 +495,21 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 ];
 //#endregion
 //#region src/server.ts
-const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
+const require = createRequire(import.meta.url);
+function getInjectedPackageVersion() {
+	const version = "0.2.0";
+	return typeof version === "string" && true ? version : null;
+}
+function readPackageVersion() {
+	const injectedVersion = getInjectedPackageVersion();
+	if (injectedVersion) return injectedVersion;
+	try {
+		const pkg = require("../package.json");
+		if (typeof pkg.version === "string" && pkg.version.length > 0) return pkg.version;
+	} catch {}
+	return "0.0.0-dev";
+}
+const PACKAGE_VERSION = readPackageVersion();
 function createOpenFairyGuiMcpServer(options = {}) {
 	const runtime = options.runtime ?? createNodeBackendRuntime();
 	const server = new McpServer({

package/dist/{stdio-Ckmxm29z.cjs → stdio-eqd_tVeJ.cjs}

@@ -1,5 +1,6 @@
 let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
 let _openfairygui_backend_node = require("@openfairygui/backend/node");
+let node_module = require("node:module");
 let zod = require("zod");
 let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
 let node_url = require("node:url");
@@ -170,7 +171,17 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 			result = await runtime.saveSession({
 				sessionId: String(input.sessionId),
 				expectedRevision: input.expectedRevision === void 0 ? void 0 : Number(input.expectedRevision),
-				targetPath: input.targetPath === void 0 ? void 0 : String(input.targetPath)
+				targetPath: input.targetPath === void 0 ? void 0 : String(input.targetPath),
+				force: input.force === void 0 ? void 0 : Boolean(input.force),
+				mode: input.mode
+			});
+			break;
+		case "openfairygui_backend_materialize_session":
+			result = await runtime.materializeSession({
+				sessionId: String(input.sessionId),
+				expectedRevision: input.expectedRevision === void 0 ? void 0 : Number(input.expectedRevision),
+				mode: input.mode,
+				reason: input.reason === void 0 ? void 0 : String(input.reason)
 			});
 			break;
 		case "openfairygui_backend_close_session":
@@ -226,6 +237,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"openfairygui_backend_get_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",
@@ -328,7 +340,28 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		inputSchema: zod.z.object({
 			sessionId,
 			expectedRevision: expectedRevision.optional(),
-			targetPath: zod.z.string().min(1).optional()
+			targetPath: zod.z.string().min(1).optional(),
+			force: zod.z.boolean().optional(),
+			mode: zod.z.literal("materializeCleanSession").optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: true,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
+	{
+		name: "openfairygui_backend_materialize_session",
+		backendMethod: "materializeSession",
+		title: "Materialize Backend Session",
+		description: "Force materialize the current backend session project through the configured project storage without requiring a dirty edit revision.",
+		inputSchema: zod.z.object({
+			sessionId,
+			expectedRevision: expectedRevision.optional(),
+			mode: zod.z.literal("fullProject").optional(),
+			reason: zod.z.string().min(1).optional()
 		}),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: {
@@ -342,7 +375,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		name: "openfairygui_backend_close_session",
 		backendMethod: "closeSession",
 		title: "Close Backend Session",
-		description: "Close a backend session and release its backend-local advisory lock.",
+		description: "Close a backend session and release its backend-local session lock.",
 		inputSchema: zod.z.object({ sessionId }),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: {
@@ -462,7 +495,21 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 ];
 //#endregion
 //#region src/server.ts
-const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+function getInjectedPackageVersion() {
+	const version = "0.2.0";
+	return typeof version === "string" && true ? version : null;
+}
+function readPackageVersion() {
+	const injectedVersion = getInjectedPackageVersion();
+	if (injectedVersion) return injectedVersion;
+	try {
+		const pkg = require$1("../package.json");
+		if (typeof pkg.version === "string" && pkg.version.length > 0) return pkg.version;
+	} catch {}
+	return "0.0.0-dev";
+}
+const PACKAGE_VERSION = readPackageVersion();
 function createOpenFairyGuiMcpServer(options = {}) {
 	const runtime = options.runtime ?? (0, _openfairygui_backend_node.createNodeBackendRuntime)();
 	const server = new _modelcontextprotocol_sdk_server_mcp_js.McpServer({

package/dist/stdio.cjs

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

package/dist/stdio.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/mcp",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0",
   "description": "FairyGUI Headless Authoring SDK - MCP server adapter for the backend runtime.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -58,12 +58,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6",
-    "@openfairygui/backend": "0.2.0-alpha.2"
+    "@openfairygui/backend": "0.2.0"
   },
   "devDependencies": {
     "ava": "^7.0.0",
     "tsx": "^4.0.0",
-    "@openfairygui/core": "0.2.0-alpha.2"
+    "@openfairygui/test-utils": "0.2.0-alpha.10",
+    "@openfairygui/core": "0.2.0"
   },
   "ava": {
     "extensions": {
@@ -78,8 +79,8 @@
     ]
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/stdio.ts --format esm,cjs --platform node --external node:fs --external node:path --external node:fs/promises --env.PACKAGE_VERSION=$npm_package_version",
-    "build:watch": "tsdown src/index.ts src/stdio.ts --watch --format esm,cjs --platform node --env.PACKAGE_VERSION=$npm_package_version",
+    "build": "tsdown src/index.ts src/stdio.ts --format esm,cjs --platform node --external node:fs --external node:path --external node:fs/promises",
+    "build:watch": "tsdown src/index.ts src/stdio.ts --watch --format esm,cjs --platform node",
     "test": "ava test/**/*.test.ts --no-worker-threads"
   }
 }

package/src/index.ts

@@ -7,6 +7,7 @@ export {
 } from './stdio.js';
 export {
 	callOpenFairyGuiBackendTool,
+	type OpenFairyGuiBackendRuntime,
 } from './tool-handler.js';
 export {
 	OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS,

package/src/resource-definitions.ts

@@ -1,6 +1,6 @@
 import { ResourceTemplate, type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
-import type { BackendRuntime } from '@openfairygui/backend';
+import type { OpenFairyGuiBackendRuntime } from './tool-handler.js';
 
 const JSON_MIME_TYPE = 'application/json';
 
@@ -28,7 +28,7 @@ export const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES = [
 	'openfairygui://backend/job/{sessionId}/{jobId}',
 ] as const;
 
-export function registerOpenFairyGuiBackendResources(server: McpServer, runtime: BackendRuntime): void {
+export function registerOpenFairyGuiBackendResources(server: McpServer, runtime: OpenFairyGuiBackendRuntime): void {
 	server.registerResource(
 		'openfairygui_backend_capabilities',
 		OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI,

package/src/server.ts

@@ -1,18 +1,40 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { BackendRuntime } from '@openfairygui/backend';
 import { createNodeBackendRuntime } from '@openfairygui/backend/node';
+import { createRequire } from 'node:module';
 import { registerOpenFairyGuiBackendPrompts } from './prompt-definitions.js';
 import { registerOpenFairyGuiBackendResources } from './resource-definitions.js';
-import { callOpenFairyGuiBackendTool } from './tool-handler.js';
+import { callOpenFairyGuiBackendTool, type OpenFairyGuiBackendRuntime } from './tool-handler.js';
 import {
 	OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS,
 	type OpenFairyGuiBackendToolName,
 } from './tool-definitions.js';
 
-const PACKAGE_VERSION = process.env.npm_package_version ?? '0.2.0-alpha.0';
+const require = createRequire(import.meta.url);
+declare const __OPENFAIRYGUI_PACKAGE_VERSION__: string | undefined;
+
+function getInjectedPackageVersion(): string | null {
+	const version = typeof __OPENFAIRYGUI_PACKAGE_VERSION__ === 'string' ? __OPENFAIRYGUI_PACKAGE_VERSION__ : null;
+	return typeof version === 'string' && version.length > 0 ? version : null;
+}
+
+function readPackageVersion(): string {
+	const injectedVersion = getInjectedPackageVersion();
+	if (injectedVersion) return injectedVersion;
+	try {
+		const pkg = require('../package.json') as { version?: unknown };
+		if (typeof pkg.version === 'string' && pkg.version.length > 0) {
+			return pkg.version;
+		}
+	} catch {
+		// Keep the MCP server usable when executed from a bundled artifact missing package.json.
+	}
+	return '0.0.0-dev';
+}
+
+const PACKAGE_VERSION = readPackageVersion();
 
 export interface CreateOpenFairyGuiMcpServerOptions {
-	runtime?: BackendRuntime;
+	runtime?: OpenFairyGuiBackendRuntime;
 	name?: string;
 	version?: string;
 }

package/src/tool-definitions.ts

@@ -9,6 +9,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	'openfairygui_backend_get_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',
@@ -27,6 +28,7 @@ export type BackendMethodName =
 	| 'getSession'
 	| 'applyTransaction'
 	| 'saveSession'
+	| 'materializeSession'
 	| 'closeSession'
 	| 'getEvents'
 	| 'getJob'
@@ -130,6 +132,22 @@ export const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			sessionId,
 			expectedRevision: expectedRevision.optional(),
 			targetPath: z.string().min(1).optional(),
+			force: z.boolean().optional(),
+			mode: z.literal('materializeCleanSession').optional(),
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+	},
+	{
+		name: 'openfairygui_backend_materialize_session',
+		backendMethod: 'materializeSession',
+		title: 'Materialize Backend Session',
+		description: 'Force materialize the current backend session project through the configured project storage without requiring a dirty edit revision.',
+		inputSchema: z.object({
+			sessionId,
+			expectedRevision: expectedRevision.optional(),
+			mode: z.literal('fullProject').optional(),
+			reason: z.string().min(1).optional(),
 		}),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
@@ -138,7 +156,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		name: 'openfairygui_backend_close_session',
 		backendMethod: 'closeSession',
 		title: 'Close Backend Session',
-		description: 'Close a backend session and release its backend-local advisory lock.',
+		description: 'Close a backend session and release its backend-local session lock.',
 		inputSchema: z.object({ sessionId }),
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },

package/src/tool-handler.ts

@@ -2,6 +2,24 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import type { BackendRuntime } from '@openfairygui/backend';
 import type { OpenFairyGuiBackendToolName } from './tool-definitions.js';
 
+export type OpenFairyGuiBackendRuntime = Pick<
+	BackendRuntime,
+	| 'getCapabilities'
+	| 'openSession'
+	| 'openProjectSession'
+	| 'getSession'
+	| 'applyTransaction'
+	| 'saveSession'
+	| 'materializeSession'
+	| 'closeSession'
+	| 'getEvents'
+	| 'getJob'
+	| 'listJobs'
+	| 'cancelJob'
+	| 'getCacheSnapshot'
+	| 'refreshCache'
+>;
+
 function jsonResult(payload: unknown, isError = false): CallToolResult {
 	return {
 		content: [
@@ -25,7 +43,7 @@ function isBackendFailure(value: unknown): boolean {
 }
 
 export async function callOpenFairyGuiBackendTool(
-	runtime: BackendRuntime,
+	runtime: OpenFairyGuiBackendRuntime,
 	name: OpenFairyGuiBackendToolName,
 	input: Record<string, unknown>,
 ): Promise<CallToolResult> {
@@ -64,6 +82,16 @@ export async function callOpenFairyGuiBackendTool(
 				sessionId: String(input.sessionId),
 				expectedRevision: input.expectedRevision === undefined ? undefined : Number(input.expectedRevision),
 				targetPath: input.targetPath === undefined ? undefined : String(input.targetPath),
+				force: input.force === undefined ? undefined : Boolean(input.force),
+				mode: input.mode as Parameters<BackendRuntime['saveSession']>[0]['mode'],
+			});
+			break;
+		case 'openfairygui_backend_materialize_session':
+			result = await runtime.materializeSession({
+				sessionId: String(input.sessionId),
+				expectedRevision: input.expectedRevision === undefined ? undefined : Number(input.expectedRevision),
+				mode: input.mode as Parameters<BackendRuntime['materializeSession']>[0]['mode'],
+				reason: input.reason === undefined ? undefined : String(input.reason),
 			});
 			break;
 		case 'openfairygui_backend_close_session':