@openfairygui/mcp 0.3.0 → 0.4.0

package/README.md

@@ -13,7 +13,9 @@ It maps the backend P2 runtime surface into MCP tools:
 - `openProjectSession`
 - `getSession`
 - `getProjectOutline`
+- `queryEntity`
 - `validateSession`
+- `preflightTransaction`
 - `applyTransaction`
 - `saveSession`
 - `materializeSession`
@@ -25,13 +27,15 @@ It maps the backend P2 runtime surface into MCP tools:
 - `getCacheSnapshot`
 - `refreshCache`
 
-Each tool exposes a shared output schema for `structuredContent.backendResult`, preserving the backend envelope shape:
+Each tool exposes a method-specific output schema for `structuredContent.backendResult`, preserving the backend envelope shape:
 
 - `ok`
 - `data?`
 - `error?`
 - `meta?`
 
+The factory advertises the fixed 18-method Backend catalog. Input/output schemas come from the canonical installed contract; discovery uses self-contained draft-07 `definitions`/`$ref` to reuse repeated structures without loosening the 41-operation union, call validators or input budgets. Installed operation documentation remains available through `openfairygui://contracts/operations` and `openfairygui://docs/index`.
+
 P1 also registers MCP-native ergonomics around the same backend surface:
 
 - read-only resources for identity snapshots:

package/dist/index.cjs

@@ -1,13 +1,37 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-9ewjcCag.cjs");
+const require_stdio = require("./stdio-B0OU-oZC.cjs");
+let _openfairygui_backend_docs = require("@openfairygui/backend/docs");
 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;
 exports.OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES = require_stdio.OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES;
 exports.OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS = require_stdio.OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS;
 exports.OPENFAIRYGUI_BACKEND_TOOL_NAMES = require_stdio.OPENFAIRYGUI_BACKEND_TOOL_NAMES;
-exports.OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA = require_stdio.OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA;
 exports.OPENFAIRYGUI_BACKEND_TOOL_PREFIX = require_stdio.OPENFAIRYGUI_BACKEND_TOOL_PREFIX;
+Object.defineProperty(exports, "OPENFAIRYGUI_OPERATION_CATALOG_URI", {
+	enumerable: true,
+	get: function() {
+		return _openfairygui_backend_docs.OPENFAIRYGUI_OPERATION_CATALOG_URI;
+	}
+});
+Object.defineProperty(exports, "OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE", {
+	enumerable: true,
+	get: function() {
+		return _openfairygui_backend_docs.OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE;
+	}
+});
 exports.callOpenFairyGuiBackendTool = require_stdio.callOpenFairyGuiBackendTool;
 exports.connectOpenFairyGuiMcpStdio = require_stdio.connectOpenFairyGuiMcpStdio;
 exports.createOpenFairyGuiMcpServer = require_stdio.createOpenFairyGuiMcpServer;
+Object.defineProperty(exports, "getOpenFairyGuiOperationCatalog", {
+	enumerable: true,
+	get: function() {
+		return _openfairygui_backend_docs.getOpenFairyGuiOperationCatalog;
+	}
+});
+Object.defineProperty(exports, "getOpenFairyGuiOperationSchema", {
+	enumerable: true,
+	get: function() {
+		return _openfairygui_backend_docs.getOpenFairyGuiOperationSchema;
+	}
+});

package/dist/index.d.cts

@@ -1,21 +1,16 @@
 import { connectOpenFairyGuiMcpStdio } from "./stdio.cjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import { BackendRuntime } from "@openfairygui/backend";
+import { BackendMethodName, BackendMethodName as BackendMethodName$1, BackendRuntime } from "@openfairygui/backend";
 import { z } from "zod";
+import { OPENFAIRYGUI_OPERATION_CATALOG_URI, OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE, getOpenFairyGuiOperationCatalog, getOpenFairyGuiOperationSchema } from "@openfairygui/backend/docs";
 
-//#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_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' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache';
-interface OpenFairyGuiBackendToolDefinition {
-  name: OpenFairyGuiBackendToolName;
-  backendMethod: BackendMethodName;
+//#region src/tool-metadata.d.ts
+interface BackendToolMetadata {
+  name: `openfairygui_backend_${string}`;
+  backendMethod: BackendMethodName$1;
   title: string;
   description: string;
-  inputSchema: z.ZodObject;
-  outputSchema: z.ZodObject;
   annotations: {
     readOnlyHint?: boolean;
     destructiveHint?: boolean;
@@ -23,28 +18,11 @@ interface OpenFairyGuiBackendToolDefinition {
     openWorldHint?: boolean;
   };
 }
-declare const OPENFAIRYGUI_BACKEND_TOOL_OUTPUT_SCHEMA: 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>;
-declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
+declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
   readonly name: "openfairygui_backend_get_capabilities";
   readonly backendMethod: "getCapabilities";
   readonly title: "Get Backend Capabilities";
   readonly description: "Return the OpenFairyGUI backend capability, version, and service-plane snapshot.";
-  readonly inputSchema: z.ZodObject<{}, 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;
@@ -55,17 +33,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "openSession";
   readonly title: "Open Backend Session";
   readonly description: "Open a FairyGUI project through BackendRuntime and acquire its backend-local session lock.";
-  readonly inputSchema: z.ZodObject<{
-    projectPath: 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;
@@ -76,20 +43,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   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;
@@ -100,17 +53,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "getSession";
   readonly title: "Get Backend Session";
   readonly description: "Return a backend session snapshot by session id.";
-  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;
@@ -121,17 +63,16 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "getProjectOutline";
   readonly title: "Get Project Outline";
   readonly description: "Return a revision-bound project/package/resource/component identity outline without source bytes or full property payloads.";
-  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_query_entity";
+  readonly backendMethod: "queryEntity";
+  readonly title: "Query Entity Properties";
+  readonly description: "Read revision-bound project/package settings, resource, component-property, display-node, controller (including pages/actions), or transition (including items) snapshots. Project queries use only kind; other queries use formal selectors. Settings snapshots include the complete settings payload for updateProjectSettings/updatePackageSettings. No source bytes; fixed projection with explicit response limits.";
   readonly annotations: {
     readonly readOnlyHint: true;
     readonly idempotentHint: true;
@@ -142,17 +83,16 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   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_preflight_transaction";
+  readonly backendMethod: "preflightTransaction";
+  readonly title: "Preview UAM Transaction";
+  readonly description: "Execute a revision-checked operation batch on an isolated project snapshot and discard the result. Returns the base revision and Core diagnostics; does not write, reserve a revision, or guarantee a later apply/save.";
   readonly annotations: {
     readonly readOnlyHint: true;
     readonly idempotentHint: true;
@@ -162,20 +102,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly name: "openfairygui_backend_apply_transaction";
   readonly backendMethod: "applyTransaction";
   readonly title: "Apply UAM Transaction";
-  readonly description: "Apply a backend revision-checked UAM operation batch without redefining selector or operation grammar.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    expectedRevision: z.ZodNumber;
-    operations: z.ZodArray<z.ZodUnknown>;
-  }, 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 description: "Apply a bounded, revision-checked UAM operation batch using the Core transaction discriminants.";
   readonly annotations: {
     readonly readOnlyHint: false;
     readonly destructiveHint: true;
@@ -186,22 +113,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly name: "openfairygui_backend_save_session";
   readonly backendMethod: "saveSession";
   readonly title: "Save Backend Session";
-  readonly description: "Write the current backend session back through the backend coordinated non-atomic save path.";
-  readonly inputSchema: z.ZodObject<{
-    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 description: "Write the current backend session through its coordinated save path; Node uses an atomic staged directory swap.";
   readonly annotations: {
     readonly readOnlyHint: false;
     readonly destructiveHint: true;
@@ -213,20 +125,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   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<{
-      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;
@@ -238,17 +136,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "closeSession";
   readonly title: "Close Backend Session";
   readonly description: "Close a backend session and release its backend-local session lock.";
-  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: false;
     readonly idempotentHint: false;
@@ -259,19 +146,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "getEvents";
   readonly title: "Get Runtime Events";
   readonly description: "Poll backend runtime events for a session using the backend P2 event cursor contract.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    after: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-  }, 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;
@@ -282,18 +156,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "getJob";
   readonly title: "Get Runtime Job";
   readonly description: "Return a backend runtime job snapshot by session and backend-local job id.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    jobId: 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;
@@ -304,28 +166,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "listJobs";
   readonly title: "List Runtime Jobs";
   readonly description: "List backend runtime jobs for a session with backend P2 status/kind filters.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    status: z.ZodOptional<z.ZodEnum<{
-      queued: "queued";
-      running: "running";
-      completed: "completed";
-      failed: "failed";
-      cancelled: "cancelled";
-      active: "active";
-      terminal: "terminal";
-    }>>;
-    kind: z.ZodOptional<z.ZodLiteral<"cache.refresh">>;
-    limit: z.ZodOptional<z.ZodNumber>;
-  }, 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;
@@ -336,18 +176,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "cancelJob";
   readonly title: "Cancel Runtime Job";
   readonly description: "Request cooperative cancellation for a backend runtime job.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    jobId: 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;
@@ -358,17 +186,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "getCacheSnapshot";
   readonly title: "Get Cache Snapshot";
   readonly description: "Return the backend P2 derived read-only cache snapshot for a session.";
-  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;
@@ -379,22 +196,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   readonly backendMethod: "refreshCache";
   readonly title: "Refresh Cache";
   readonly description: "Create a backend P2 cache.refresh job for the session cache snapshot.";
-  readonly inputSchema: z.ZodObject<{
-    sessionId: z.ZodString;
-    reason: z.ZodOptional<z.ZodEnum<{
-      manual: "manual";
-      session_open: "session_open";
-      after_save: "after_save";
-    }>>;
-  }, 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;
@@ -402,13 +203,26 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly [{
   };
 }];
 //#endregion
+//#region src/tool-definitions.d.ts
+declare const OPENFAIRYGUI_BACKEND_TOOL_PREFIX = "openfairygui_backend_";
+type OpenFairyGuiBackendToolName = typeof OPENFAIRYGUI_BACKEND_TOOL_METADATA[number]['name'];
+declare const OPENFAIRYGUI_BACKEND_TOOL_NAMES: ("openfairygui_backend_get_capabilities" | "openfairygui_backend_open_session" | "openfairygui_backend_open_project_session" | "openfairygui_backend_get_session" | "openfairygui_backend_get_project_outline" | "openfairygui_backend_query_entity" | "openfairygui_backend_validate_session" | "openfairygui_backend_preflight_transaction" | "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")[];
+interface OpenFairyGuiBackendToolDefinition extends BackendToolMetadata {
+  name: OpenFairyGuiBackendToolName;
+  inputSchema: z.ZodObject;
+  outputSchema: z.ZodObject;
+}
+declare const OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS: readonly OpenFairyGuiBackendToolDefinition[];
+//#endregion
 //#region src/tool-handler.d.ts
-type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, 'getCapabilities' | 'openSession' | 'openProjectSession' | 'getSession' | 'getProjectOutline' | 'validateSession' | 'applyTransaction' | 'saveSession' | 'materializeSession' | 'closeSession' | 'getEvents' | 'getJob' | 'listJobs' | 'cancelJob' | 'getCacheSnapshot' | 'refreshCache'>;
+type OpenFairyGuiBackendRuntime = Pick<BackendRuntime, BackendMethodName$1>;
 declare function callOpenFairyGuiBackendTool(runtime: OpenFairyGuiBackendRuntime, name: OpenFairyGuiBackendToolName, input: Record<string, unknown>): Promise<CallToolResult>;
 //#endregion
 //#region src/server.d.ts
 interface CreateOpenFairyGuiMcpServerOptions {
   runtime?: OpenFairyGuiBackendRuntime;
+  /** Filesystem roots exposed by the default Node backend runtime. Defaults to process.cwd(). */
+  allowedProjectRoots?: readonly string[];
   name?: string;
   version?: string;
 }
@@ -451,6 +265,6 @@ declare const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS: readonly [{
 //#endregion
 //#region src/resource-definitions.d.ts
 declare const OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI = "openfairygui://backend/capabilities";
-declare const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES: readonly ["openfairygui://backend/session/{sessionId}", "openfairygui://backend/session/{sessionId}/outline", "openfairygui://backend/cache/{sessionId}", "openfairygui://backend/job/{sessionId}/{jobId}"];
+declare const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES: readonly ["openfairygui://docs/methods/{method}", "openfairygui://docs/cli/{command}", "openfairygui://docs/diagnostics/{code}", "openfairygui://contracts/operations/{kind}", "openfairygui://backend/session/{sessionId}", "openfairygui://backend/session/{sessionId}/outline", "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 OpenFairyGuiBackendRuntime, 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_PREFIX, OPENFAIRYGUI_OPERATION_CATALOG_URI, OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendRuntime, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer, getOpenFairyGuiOperationCatalog, getOpenFairyGuiOperationSchema };