@openfairygui/mcp 0.3.1 → 0.5.0-alpha.1

package/README.md

@@ -13,7 +13,11 @@ It maps the backend P2 runtime surface into MCP tools:
 - `openProjectSession`
 - `getSession`
 - `getProjectOutline`
+- `queryEntity`
+- `readSessionState`
+- `readResourceBytes`
 - `validateSession`
+- `preflightTransaction`
 - `applyTransaction`
 - `saveSession`
 - `materializeSession`
@@ -25,13 +29,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 20-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:
@@ -45,6 +51,8 @@ P1 also registers MCP-native ergonomics around the same backend surface:
 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. `validateSession` returns the backend-owned read-only project validation report; the MCP adapter does not reinterpret its diagnostics.
 
+`readSessionState` returns a detached public UAM model without primary asset bytes, plus the current edit revision and source-read diagnostics. `readResourceBytes` reads one already-loaded primary asset with a required matching revision. Neither reads storage or changes the session. Both tools enforce their native response limits and a separate 16 MiB complete MCP response limit; see the installed method schemas and [workflow](../backend/docs/workflow.md).
+
 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`.
 
 It also does **not** activate artifact publish/restore jobs, subscriptions, persistent jobs, or cache-as-source-of-truth behavior. MCP roots may be useful client context, but this package does not enforce roots or duplicate backend path canonicalization; backend path policy remains authoritative.

package/dist/index.cjs

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