@openfairygui/mcp 0.2.0-alpha.0 → 0.2.0-alpha.1

package/dist/index.cjs

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

@@ -14,9 +14,9 @@ declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServ
 //#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_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_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' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -79,6 +79,30 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: false;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_open_project_session";
+  readonly backendMethod: "openProjectSession";
+  readonly title: "Open Project Session";
+  readonly description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.";
+  readonly inputSchema: z.ZodObject<{
+    project: z.ZodUnknown;
+    sessionId: z.ZodOptional<z.ZodString>;
+    canonicalProjectPath: z.ZodOptional<z.ZodString>;
+    canonicalPathKey: z.ZodOptional<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: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_get_session";
   readonly backendMethod: "getSession";

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { connectOpenFairyGuiMcpStdio } from "./stdio.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BackendRuntime } from "@openfairygui/backend";
 import { z } from "zod";
+import { BackendRuntime } from "@openfairygui/backend";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/server.d.ts
@@ -14,9 +14,9 @@ declare function createOpenFairyGuiMcpServer(options?: CreateOpenFairyGuiMcpServ
 //#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_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_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' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
+type BackendMethodName = 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'applyTransaction' | 'saveSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
 interface OpenFairyGuiBackendToolDefinition {
   name: OpenFairyGuiBackendToolName;
   backendMethod: BackendMethodName;
@@ -79,6 +79,30 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
     readonly idempotentHint: false;
     readonly openWorldHint: false;
   };
+}, {
+  readonly name: "openfairygui_backend_open_project_session";
+  readonly backendMethod: "openProjectSession";
+  readonly title: "Open Project Session";
+  readonly description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.";
+  readonly inputSchema: z.ZodObject<{
+    project: z.ZodUnknown;
+    sessionId: z.ZodOptional<z.ZodString>;
+    canonicalProjectPath: z.ZodOptional<z.ZodString>;
+    canonicalPathKey: z.ZodOptional<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: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+  };
 }, {
   readonly name: "openfairygui_backend_get_session";
   readonly backendMethod: "getSession";

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-ByGWerIG.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-DT1cUPJ3.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-BDHxauin.cjs → stdio-Ckmxm29z.cjs}

@@ -1,5 +1,5 @@
 let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
-let _openfairygui_backend = require("@openfairygui/backend");
+let _openfairygui_backend_node = require("@openfairygui/backend/node");
 let zod = require("zod");
 let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
 let node_url = require("node:url");
@@ -148,6 +148,14 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_open_session":
 			result = await runtime.openSession({ projectPath: String(input.projectPath) });
 			break;
+		case "openfairygui_backend_open_project_session":
+			result = runtime.openProjectSession({
+				project: input.project,
+				sessionId: input.sessionId === void 0 ? void 0 : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === void 0 ? void 0 : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === void 0 ? void 0 : String(input.canonicalPathKey)
+			});
+			break;
 		case "openfairygui_backend_get_session":
 			result = runtime.getSession({ sessionId: String(input.sessionId) });
 			break;
@@ -214,6 +222,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
 const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"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",
@@ -262,6 +271,24 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_open_project_session",
+		backendMethod: "openProjectSession",
+		title: "Open Project Session",
+		description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.",
+		inputSchema: zod.z.object({
+			project: zod.z.unknown(),
+			sessionId: zod.z.string().min(1).optional(),
+			canonicalProjectPath: zod.z.string().min(1).optional(),
+			canonicalPathKey: zod.z.string().min(1).optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_get_session",
 		backendMethod: "getSession",
@@ -437,7 +464,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
 function createOpenFairyGuiMcpServer(options = {}) {
-	const runtime = options.runtime ?? new _openfairygui_backend.BackendRuntime();
+	const runtime = options.runtime ?? (0, _openfairygui_backend_node.createNodeBackendRuntime)();
 	const server = new _modelcontextprotocol_sdk_server_mcp_js.McpServer({
 		name: options.name ?? "openfairygui-mcp",
 		version: options.version ?? PACKAGE_VERSION

package/dist/{stdio-ByGWerIG.mjs → stdio-DT1cUPJ3.mjs}

@@ -1,5 +1,5 @@
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BackendRuntime } from "@openfairygui/backend";
+import { createNodeBackendRuntime } from "@openfairygui/backend/node";
 import { z } from "zod";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { pathToFileURL } from "node:url";
@@ -148,6 +148,14 @@ async function callOpenFairyGuiBackendTool(runtime, name, input) {
 		case "openfairygui_backend_open_session":
 			result = await runtime.openSession({ projectPath: String(input.projectPath) });
 			break;
+		case "openfairygui_backend_open_project_session":
+			result = runtime.openProjectSession({
+				project: input.project,
+				sessionId: input.sessionId === void 0 ? void 0 : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === void 0 ? void 0 : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === void 0 ? void 0 : String(input.canonicalPathKey)
+			});
+			break;
 		case "openfairygui_backend_get_session":
 			result = runtime.getSession({ sessionId: String(input.sessionId) });
 			break;
@@ -214,6 +222,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
 const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	"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",
@@ -262,6 +271,24 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 			openWorldHint: false
 		}
 	},
+	{
+		name: "openfairygui_backend_open_project_session",
+		backendMethod: "openProjectSession",
+		title: "Open Project Session",
+		description: "Open a browser-safe backend session from an already loaded UAM project without filesystem access.",
+		inputSchema: z.object({
+			project: z.unknown(),
+			sessionId: z.string().min(1).optional(),
+			canonicalProjectPath: z.string().min(1).optional(),
+			canonicalPathKey: z.string().min(1).optional()
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: {
+			readOnlyHint: false,
+			idempotentHint: false,
+			openWorldHint: false
+		}
+	},
 	{
 		name: "openfairygui_backend_get_session",
 		backendMethod: "getSession",
@@ -437,7 +464,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 //#region src/server.ts
 const PACKAGE_VERSION = process.env.npm_package_version ?? "0.2.0-alpha.0";
 function createOpenFairyGuiMcpServer(options = {}) {
-	const runtime = options.runtime ?? new BackendRuntime();
+	const runtime = options.runtime ?? createNodeBackendRuntime();
 	const server = new McpServer({
 		name: options.name ?? "openfairygui-mcp",
 		version: options.version ?? PACKAGE_VERSION

package/dist/stdio.cjs

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

package/dist/stdio.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@openfairygui/mcp",
-	"version": "0.2.0-alpha.0",
+	"version": "0.2.0-alpha.1",
 	"description": "FairyGUI Headless Authoring SDK - MCP server adapter for the backend runtime.",
 	"author": "OpenFairyGUI Contributors",
 	"license": "MIT",

package/src/server.ts

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { BackendRuntime } from '@openfairygui/backend';
+import type { BackendRuntime } from '@openfairygui/backend';
+import { createNodeBackendRuntime } from '@openfairygui/backend/node';
 import { registerOpenFairyGuiBackendPrompts } from './prompt-definitions.js';
 import { registerOpenFairyGuiBackendResources } from './resource-definitions.js';
 import { callOpenFairyGuiBackendTool } from './tool-handler.js';
@@ -17,7 +18,7 @@ export interface CreateOpenFairyGuiMcpServerOptions {
 }
 
 export function createOpenFairyGuiMcpServer(options: CreateOpenFairyGuiMcpServerOptions = {}): McpServer {
-	const runtime = options.runtime ?? new BackendRuntime();
+	const runtime = options.runtime ?? createNodeBackendRuntime();
 	const server = new McpServer({
 		name: options.name ?? 'openfairygui-mcp',
 		version: options.version ?? PACKAGE_VERSION,

package/src/tool-definitions.ts

@@ -5,6 +5,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = 'openfairygui_backend_';
 export const OPENFAIRYGUI_BACKEND_TOOL_NAMES = [
 	'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',
@@ -22,6 +23,7 @@ export type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_NAMES
 export type BackendMethodName =
 	| 'getCapabilities'
 	| 'openSession'
+	| 'openProjectSession'
 	| 'getSession'
 	| 'applyTransaction'
 	| 'saveSession'
@@ -83,6 +85,20 @@ export const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = [
 		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
 		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
 	},
+	{
+		name: 'openfairygui_backend_open_project_session',
+		backendMethod: 'openProjectSession',
+		title: 'Open Project Session',
+		description: 'Open a browser-safe backend session from an already loaded UAM project without filesystem access.',
+		inputSchema: z.object({
+			project: z.unknown(),
+			sessionId: z.string().min(1).optional(),
+			canonicalProjectPath: z.string().min(1).optional(),
+			canonicalPathKey: z.string().min(1).optional(),
+		}),
+		outputSchema: OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA,
+		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
+	},
 	{
 		name: 'openfairygui_backend_get_session',
 		backendMethod: 'getSession',

package/src/tool-handler.ts

@@ -39,6 +39,14 @@ export async function callOpenFairyGuiBackendTool(
 				projectPath: String(input.projectPath),
 			});
 			break;
+		case 'openfairygui_backend_open_project_session':
+			result = runtime.openProjectSession({
+				project: input.project as Parameters<BackendRuntime['openProjectSession']>[0]['project'],
+				sessionId: input.sessionId === undefined ? undefined : String(input.sessionId),
+				canonicalProjectPath: input.canonicalProjectPath === undefined ? undefined : String(input.canonicalProjectPath),
+				canonicalPathKey: input.canonicalPathKey === undefined ? undefined : String(input.canonicalPathKey),
+			});
+			break;
 		case 'openfairygui_backend_get_session':
 			result = runtime.getSession({
 				sessionId: String(input.sessionId),