@openfairygui/mcp 0.5.0 → 0.6.1

package/README.md

@@ -23,9 +23,6 @@ It maps the backend P2 runtime surface into MCP tools:
 - `materializeSession`
 - `closeSession`
 - `getEvents`
-- `getJob`
-- `listJobs`
-- `cancelJob`
 - `getCacheSnapshot`
 - `refreshCache`
 
@@ -45,17 +42,18 @@ P1 also registers MCP-native ergonomics around the same backend surface:
   - `openfairygui://backend/session/{sessionId}`
   - `openfairygui://backend/session/{sessionId}/outline`
   - `openfairygui://backend/cache/{sessionId}`
-  - `openfairygui://backend/job/{sessionId}/{jobId}`
 - 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.
+Resources return `application/json` text containing the unchanged backend result envelope. Parameterized event polling uses `getEvents`, without a resource URI query grammar.
 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 does **not** redefine transaction selectors, transaction operations, path policy, session 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.
+It also does **not** activate artifact publish/restore execution, subscriptions, 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.
+
+`refreshCache` returns the refreshed cache snapshot in its response; clients do not poll a background task.
 
 ## Usage
 

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -175,36 +175,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
     readonly idempotentHint: true;
     readonly openWorldHint: false;
   };
-}, {
-  readonly name: "openfairygui_backend_get_job";
-  readonly backendMethod: "getJob";
-  readonly title: "Get Runtime Job";
-  readonly description: "Return a backend runtime job snapshot by session and backend-local job id.";
-  readonly annotations: {
-    readonly readOnlyHint: true;
-    readonly idempotentHint: true;
-    readonly openWorldHint: false;
-  };
-}, {
-  readonly name: "openfairygui_backend_list_jobs";
-  readonly backendMethod: "listJobs";
-  readonly title: "List Runtime Jobs";
-  readonly description: "List backend runtime jobs for a session with backend P2 status/kind filters.";
-  readonly annotations: {
-    readonly readOnlyHint: true;
-    readonly idempotentHint: true;
-    readonly openWorldHint: false;
-  };
-}, {
-  readonly name: "openfairygui_backend_cancel_job";
-  readonly backendMethod: "cancelJob";
-  readonly title: "Cancel Runtime Job";
-  readonly description: "Request cooperative cancellation for a backend runtime job.";
-  readonly annotations: {
-    readonly readOnlyHint: false;
-    readonly idempotentHint: false;
-    readonly openWorldHint: false;
-  };
 }, {
   readonly name: "openfairygui_backend_get_cache_snapshot";
   readonly backendMethod: "getCacheSnapshot";
@@ -219,7 +189,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
   readonly name: "openfairygui_backend_refresh_cache";
   readonly backendMethod: "refreshCache";
   readonly title: "Refresh Cache";
-  readonly description: "Create a backend P2 cache.refresh job for the session cache snapshot.";
+  readonly description: "Synchronously refresh the derived session cache and return its revision-bound snapshot.";
   readonly annotations: {
     readonly readOnlyHint: false;
     readonly idempotentHint: false;
@@ -230,7 +200,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
 //#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_read_session_state" | "openfairygui_backend_read_resource_bytes" | "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")[];
+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_read_session_state" | "openfairygui_backend_read_resource_bytes" | "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_cache_snapshot" | "openfairygui_backend_refresh_cache")[];
 interface OpenFairyGuiBackendToolDefinition extends BackendToolMetadata {
   name: OpenFairyGuiBackendToolName;
   inputSchema: z.ZodObject;
@@ -300,12 +270,12 @@ declare const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS: readonly [{
 }, {
   readonly name: "openfairygui_poll_runtime_state";
   readonly title: "Poll OpenFairyGUI Runtime State";
-  readonly description: "Guide a client through event, job, and cache polling tools.";
+  readonly description: "Guide a client through event polling and synchronous cache snapshots.";
   readonly text: string;
 }];
 //#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://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}"];
+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}"];
 //#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_PREFIX, OPENFAIRYGUI_OPERATION_CATALOG_URI, OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendRuntime, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, type OpenFairyGuiMcpToolPolicy, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer, getOpenFairyGuiOperationCatalog, getOpenFairyGuiOperationSchema };

package/dist/index.d.mts

@@ -175,36 +175,6 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
     readonly idempotentHint: true;
     readonly openWorldHint: false;
   };
-}, {
-  readonly name: "openfairygui_backend_get_job";
-  readonly backendMethod: "getJob";
-  readonly title: "Get Runtime Job";
-  readonly description: "Return a backend runtime job snapshot by session and backend-local job id.";
-  readonly annotations: {
-    readonly readOnlyHint: true;
-    readonly idempotentHint: true;
-    readonly openWorldHint: false;
-  };
-}, {
-  readonly name: "openfairygui_backend_list_jobs";
-  readonly backendMethod: "listJobs";
-  readonly title: "List Runtime Jobs";
-  readonly description: "List backend runtime jobs for a session with backend P2 status/kind filters.";
-  readonly annotations: {
-    readonly readOnlyHint: true;
-    readonly idempotentHint: true;
-    readonly openWorldHint: false;
-  };
-}, {
-  readonly name: "openfairygui_backend_cancel_job";
-  readonly backendMethod: "cancelJob";
-  readonly title: "Cancel Runtime Job";
-  readonly description: "Request cooperative cancellation for a backend runtime job.";
-  readonly annotations: {
-    readonly readOnlyHint: false;
-    readonly idempotentHint: false;
-    readonly openWorldHint: false;
-  };
 }, {
   readonly name: "openfairygui_backend_get_cache_snapshot";
   readonly backendMethod: "getCacheSnapshot";
@@ -219,7 +189,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
   readonly name: "openfairygui_backend_refresh_cache";
   readonly backendMethod: "refreshCache";
   readonly title: "Refresh Cache";
-  readonly description: "Create a backend P2 cache.refresh job for the session cache snapshot.";
+  readonly description: "Synchronously refresh the derived session cache and return its revision-bound snapshot.";
   readonly annotations: {
     readonly readOnlyHint: false;
     readonly idempotentHint: false;
@@ -230,7 +200,7 @@ declare const OPENFAIRYGUI_BACKEND_TOOL_METADATA: readonly [{
 //#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_read_session_state" | "openfairygui_backend_read_resource_bytes" | "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")[];
+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_read_session_state" | "openfairygui_backend_read_resource_bytes" | "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_cache_snapshot" | "openfairygui_backend_refresh_cache")[];
 interface OpenFairyGuiBackendToolDefinition extends BackendToolMetadata {
   name: OpenFairyGuiBackendToolName;
   inputSchema: z.ZodObject;
@@ -300,12 +270,12 @@ declare const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS: readonly [{
 }, {
   readonly name: "openfairygui_poll_runtime_state";
   readonly title: "Poll OpenFairyGUI Runtime State";
-  readonly description: "Guide a client through event, job, and cache polling tools.";
+  readonly description: "Guide a client through event polling and synchronous cache snapshots.";
   readonly text: string;
 }];
 //#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://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}"];
+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}"];
 //#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_PREFIX, OPENFAIRYGUI_OPERATION_CATALOG_URI, OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE, type OpenFairyGuiBackendPromptName, type OpenFairyGuiBackendRuntime, type OpenFairyGuiBackendToolDefinition, type OpenFairyGuiBackendToolName, type OpenFairyGuiMcpToolPolicy, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer, getOpenFairyGuiOperationCatalog, getOpenFairyGuiOperationSchema };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as OPENFAIRYGUI_BACKEND_TOOL_NAMES, c as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, d as getOpenFairyGuiOperationCatalog, f as getOpenFairyGuiOperationSchema, i as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, l as OPENFAIRYGUI_OPERATION_CATALOG_URI, m as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, p as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS, r as callOpenFairyGuiBackendTool, s as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE } from "./stdio-CnISo7SK.mjs";
+import { a as OPENFAIRYGUI_BACKEND_TOOL_NAMES, c as OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES, d as getOpenFairyGuiOperationCatalog, f as getOpenFairyGuiOperationSchema, i as OPENFAIRYGUI_BACKEND_TOOL_DEFINITIONS, l as OPENFAIRYGUI_OPERATION_CATALOG_URI, m as OPENFAIRYGUI_BACKEND_PROMPT_NAMES, n as createOpenFairyGuiMcpServer, o as OPENFAIRYGUI_BACKEND_TOOL_PREFIX, p as OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS, r as callOpenFairyGuiBackendTool, s as OPENFAIRYGUI_BACKEND_CAPABILITIES_RESOURCE_URI, t as connectOpenFairyGuiMcpStdio, u as OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE } from "./stdio-DyxngFMM.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_PREFIX, OPENFAIRYGUI_OPERATION_CATALOG_URI, OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE, callOpenFairyGuiBackendTool, connectOpenFairyGuiMcpStdio, createOpenFairyGuiMcpServer, getOpenFairyGuiOperationCatalog, getOpenFairyGuiOperationSchema };

package/dist/{stdio-CNx84KWi.cjs → stdio-B7MgcaE7.cjs}

@@ -47,7 +47,7 @@ const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 		text: [
 			"Use openfairygui_backend_get_capabilities first.",
 			"Read contractVersion, capabilitySchemaVersion, capability planes, methods, and runtime non-goals from the backend envelope.",
-			"Do not infer artifact publish/restore, subscriptions, persistent jobs, or cache source-of-truth support when the backend marks them unsupported."
+			"Do not infer artifact publish/restore, subscriptions, or cache source-of-truth support when the backend marks them unsupported."
 		].join("\n")
 	},
 	{
@@ -100,12 +100,11 @@ const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 	{
 		name: "openfairygui_poll_runtime_state",
 		title: "Poll OpenFairyGUI Runtime State",
-		description: "Guide a client through event, job, and cache polling tools.",
+		description: "Guide a client through event polling and synchronous cache snapshots.",
 		text: [
 			"Use openfairygui_backend_get_events for polling events with the backend cursor contract.",
-			"Use openfairygui_backend_list_jobs and openfairygui_backend_get_job for in-memory job snapshots.",
-			"Use openfairygui_backend_get_cache_snapshot and openfairygui_backend_refresh_cache for derived read-only cache state.",
-			"Subscriptions, persistent jobs, artifact jobs, and cache-as-source-of-truth behavior are not supported by backend P2."
+			"Use openfairygui_backend_get_cache_snapshot for derived read-only cache state; openfairygui_backend_refresh_cache returns the refreshed snapshot synchronously.",
+			"Subscriptions and cache-as-source-of-truth behavior are not supported by the backend."
 		].join("\n")
 	}
 ];
@@ -182,8 +181,7 @@ const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES = [
 	_openfairygui_backend_docs.OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE,
 	"openfairygui://backend/session/{sessionId}",
 	"openfairygui://backend/session/{sessionId}/outline",
-	"openfairygui://backend/cache/{sessionId}",
-	"openfairygui://backend/job/{sessionId}/{jobId}"
+	"openfairygui://backend/cache/{sessionId}"
 ];
 function registerOpenFairyGuiBackendResources(server, runtime) {
 	server.registerResource("openfairygui_docs_index", _openfairygui_backend_docs.OPENFAIRYGUI_DOCS_INDEX_URI, {
@@ -259,14 +257,6 @@ function registerOpenFairyGuiBackendResources(server, runtime) {
 		description: "Read a derived backend cache envelope by backend-local session id.",
 		mimeType: JSON_MIME_TYPE
 	}, (uri, variables) => jsonResource(uri, runtime.getCacheSnapshot({ sessionId: firstVariable(variables.sessionId) })));
-	server.registerResource("openfairygui_backend_job", new _modelcontextprotocol_sdk_server_mcp_js.ResourceTemplate("openfairygui://backend/job/{sessionId}/{jobId}", { list: void 0 }), {
-		title: "OpenFairyGUI Backend Job Snapshot",
-		description: "Read a backend runtime job envelope by session id and job id.",
-		mimeType: JSON_MIME_TYPE
-	}, (uri, variables) => jsonResource(uri, runtime.getJob({
-		sessionId: firstVariable(variables.sessionId),
-		jobId: firstVariable(variables.jobId)
-	})));
 }
 //#endregion
 //#region src/tool-metadata.ts
@@ -441,39 +431,6 @@ const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 			openWorldHint: false
 		}
 	},
-	{
-		name: "openfairygui_backend_get_job",
-		backendMethod: "getJob",
-		title: "Get Runtime Job",
-		description: "Return a backend runtime job snapshot by session and backend-local job id.",
-		annotations: {
-			readOnlyHint: true,
-			idempotentHint: true,
-			openWorldHint: false
-		}
-	},
-	{
-		name: "openfairygui_backend_list_jobs",
-		backendMethod: "listJobs",
-		title: "List Runtime Jobs",
-		description: "List backend runtime jobs for a session with backend P2 status/kind filters.",
-		annotations: {
-			readOnlyHint: true,
-			idempotentHint: true,
-			openWorldHint: false
-		}
-	},
-	{
-		name: "openfairygui_backend_cancel_job",
-		backendMethod: "cancelJob",
-		title: "Cancel Runtime Job",
-		description: "Request cooperative cancellation for a backend runtime job.",
-		annotations: {
-			readOnlyHint: false,
-			idempotentHint: false,
-			openWorldHint: false
-		}
-	},
 	{
 		name: "openfairygui_backend_get_cache_snapshot",
 		backendMethod: "getCacheSnapshot",
@@ -489,7 +446,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 		name: "openfairygui_backend_refresh_cache",
 		backendMethod: "refreshCache",
 		title: "Refresh Cache",
-		description: "Create a backend P2 cache.refresh job for the session cache snapshot.",
+		description: "Synchronously refresh the derived session cache and return its revision-bound snapshot.",
 		annotations: {
 			readOnlyHint: false,
 			idempotentHint: false,
@@ -629,7 +586,7 @@ async function callOpenFairyGuiBackendTool(runtime, name, input, policy) {
 //#region src/server.ts
 const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 function getInjectedPackageVersion() {
-	const version = "0.5.0";
+	const version = "0.6.1";
 	return typeof version === "string" && true ? version : null;
 }
 function readPackageVersion() {

package/dist/{stdio-CnISo7SK.mjs → stdio-DyxngFMM.mjs}

@@ -24,7 +24,7 @@ const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 		text: [
 			"Use openfairygui_backend_get_capabilities first.",
 			"Read contractVersion, capabilitySchemaVersion, capability planes, methods, and runtime non-goals from the backend envelope.",
-			"Do not infer artifact publish/restore, subscriptions, persistent jobs, or cache source-of-truth support when the backend marks them unsupported."
+			"Do not infer artifact publish/restore, subscriptions, or cache source-of-truth support when the backend marks them unsupported."
 		].join("\n")
 	},
 	{
@@ -77,12 +77,11 @@ const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 	{
 		name: "openfairygui_poll_runtime_state",
 		title: "Poll OpenFairyGUI Runtime State",
-		description: "Guide a client through event, job, and cache polling tools.",
+		description: "Guide a client through event polling and synchronous cache snapshots.",
 		text: [
 			"Use openfairygui_backend_get_events for polling events with the backend cursor contract.",
-			"Use openfairygui_backend_list_jobs and openfairygui_backend_get_job for in-memory job snapshots.",
-			"Use openfairygui_backend_get_cache_snapshot and openfairygui_backend_refresh_cache for derived read-only cache state.",
-			"Subscriptions, persistent jobs, artifact jobs, and cache-as-source-of-truth behavior are not supported by backend P2."
+			"Use openfairygui_backend_get_cache_snapshot for derived read-only cache state; openfairygui_backend_refresh_cache returns the refreshed snapshot synchronously.",
+			"Subscriptions and cache-as-source-of-truth behavior are not supported by the backend."
 		].join("\n")
 	}
 ];
@@ -159,8 +158,7 @@ const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES = [
 	OPENFAIRYGUI_OPERATION_SCHEMA_TEMPLATE,
 	"openfairygui://backend/session/{sessionId}",
 	"openfairygui://backend/session/{sessionId}/outline",
-	"openfairygui://backend/cache/{sessionId}",
-	"openfairygui://backend/job/{sessionId}/{jobId}"
+	"openfairygui://backend/cache/{sessionId}"
 ];
 function registerOpenFairyGuiBackendResources(server, runtime) {
 	server.registerResource("openfairygui_docs_index", OPENFAIRYGUI_DOCS_INDEX_URI, {
@@ -236,14 +234,6 @@ function registerOpenFairyGuiBackendResources(server, runtime) {
 		description: "Read a derived backend cache envelope by backend-local session id.",
 		mimeType: JSON_MIME_TYPE
 	}, (uri, variables) => jsonResource(uri, runtime.getCacheSnapshot({ sessionId: firstVariable(variables.sessionId) })));
-	server.registerResource("openfairygui_backend_job", new ResourceTemplate("openfairygui://backend/job/{sessionId}/{jobId}", { list: void 0 }), {
-		title: "OpenFairyGUI Backend Job Snapshot",
-		description: "Read a backend runtime job envelope by session id and job id.",
-		mimeType: JSON_MIME_TYPE
-	}, (uri, variables) => jsonResource(uri, runtime.getJob({
-		sessionId: firstVariable(variables.sessionId),
-		jobId: firstVariable(variables.jobId)
-	})));
 }
 //#endregion
 //#region src/tool-metadata.ts
@@ -418,39 +408,6 @@ const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 			openWorldHint: false
 		}
 	},
-	{
-		name: "openfairygui_backend_get_job",
-		backendMethod: "getJob",
-		title: "Get Runtime Job",
-		description: "Return a backend runtime job snapshot by session and backend-local job id.",
-		annotations: {
-			readOnlyHint: true,
-			idempotentHint: true,
-			openWorldHint: false
-		}
-	},
-	{
-		name: "openfairygui_backend_list_jobs",
-		backendMethod: "listJobs",
-		title: "List Runtime Jobs",
-		description: "List backend runtime jobs for a session with backend P2 status/kind filters.",
-		annotations: {
-			readOnlyHint: true,
-			idempotentHint: true,
-			openWorldHint: false
-		}
-	},
-	{
-		name: "openfairygui_backend_cancel_job",
-		backendMethod: "cancelJob",
-		title: "Cancel Runtime Job",
-		description: "Request cooperative cancellation for a backend runtime job.",
-		annotations: {
-			readOnlyHint: false,
-			idempotentHint: false,
-			openWorldHint: false
-		}
-	},
 	{
 		name: "openfairygui_backend_get_cache_snapshot",
 		backendMethod: "getCacheSnapshot",
@@ -466,7 +423,7 @@ const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 		name: "openfairygui_backend_refresh_cache",
 		backendMethod: "refreshCache",
 		title: "Refresh Cache",
-		description: "Create a backend P2 cache.refresh job for the session cache snapshot.",
+		description: "Synchronously refresh the derived session cache and return its revision-bound snapshot.",
 		annotations: {
 			readOnlyHint: false,
 			idempotentHint: false,
@@ -606,7 +563,7 @@ async function callOpenFairyGuiBackendTool(runtime, name, input, policy) {
 //#region src/server.ts
 const require = createRequire(import.meta.url);
 function getInjectedPackageVersion() {
-	const version = "0.5.0";
+	const version = "0.6.1";
 	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-CNx84KWi.cjs");
+const require_stdio = require("./stdio-B7MgcaE7.cjs");
 exports.connectOpenFairyGuiMcpStdio = require_stdio.connectOpenFairyGuiMcpStdio;

package/dist/stdio.mjs

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

package/package.json

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

package/src/prompt-definitions.ts

@@ -26,7 +26,7 @@ export const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 		text: [
 			'Use openfairygui_backend_get_capabilities first.',
 			'Read contractVersion, capabilitySchemaVersion, capability planes, methods, and runtime non-goals from the backend envelope.',
-			'Do not infer artifact publish/restore, subscriptions, persistent jobs, or cache source-of-truth support when the backend marks them unsupported.',
+			'Do not infer artifact publish/restore, subscriptions, or cache source-of-truth support when the backend marks them unsupported.',
 		].join('\n'),
 	},
 	{
@@ -79,12 +79,11 @@ export const OPENFAIRYGUI_BACKEND_PROMPT_DEFINITIONS = [
 	{
 		name: 'openfairygui_poll_runtime_state',
 		title: 'Poll OpenFairyGUI Runtime State',
-		description: 'Guide a client through event, job, and cache polling tools.',
+		description: 'Guide a client through event polling and synchronous cache snapshots.',
 		text: [
 			'Use openfairygui_backend_get_events for polling events with the backend cursor contract.',
-			'Use openfairygui_backend_list_jobs and openfairygui_backend_get_job for in-memory job snapshots.',
-			'Use openfairygui_backend_get_cache_snapshot and openfairygui_backend_refresh_cache for derived read-only cache state.',
-			'Subscriptions, persistent jobs, artifact jobs, and cache-as-source-of-truth behavior are not supported by backend P2.',
+			'Use openfairygui_backend_get_cache_snapshot for derived read-only cache state; openfairygui_backend_refresh_cache returns the refreshed snapshot synchronously.',
+			'Subscriptions and cache-as-source-of-truth behavior are not supported by the backend.',
 		].join('\n'),
 	},
 ] as const satisfies readonly OpenFairyGuiBackendPromptDefinition[];

package/src/resource-definitions.ts

@@ -38,7 +38,6 @@ export const OPENFAIRYGUI_BACKEND_RESOURCE_TEMPLATES = [
 	'openfairygui://backend/session/{sessionId}',
 	'openfairygui://backend/session/{sessionId}/outline',
 	'openfairygui://backend/cache/{sessionId}',
-	'openfairygui://backend/job/{sessionId}/{jobId}',
 ] as const;
 
 export function registerOpenFairyGuiBackendResources(server: McpServer, runtime: OpenFairyGuiBackendRuntime): void {
@@ -139,17 +138,4 @@ export function registerOpenFairyGuiBackendResources(server: McpServer, runtime:
 		})),
 	);
 
-	server.registerResource(
-		'openfairygui_backend_job',
-		new ResourceTemplate('openfairygui://backend/job/{sessionId}/{jobId}', { list: undefined }),
-		{
-			title: 'OpenFairyGUI Backend Job Snapshot',
-			description: 'Read a backend runtime job envelope by session id and job id.',
-			mimeType: JSON_MIME_TYPE,
-		},
-		(uri: URL, variables) => jsonResource(uri, runtime.getJob({
-			sessionId: firstVariable(variables.sessionId),
-			jobId: firstVariable(variables.jobId),
-		})),
-	);
 }

package/src/tool-metadata.ts

@@ -143,27 +143,6 @@ export const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 		description: 'Poll backend runtime events for a session using the backend P2 event cursor contract.',
 		annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
 	},
-	{
-		name: 'openfairygui_backend_get_job',
-		backendMethod: 'getJob',
-		title: 'Get Runtime Job',
-		description: 'Return a backend runtime job snapshot by session and backend-local job id.',
-		annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-	},
-	{
-		name: 'openfairygui_backend_list_jobs',
-		backendMethod: 'listJobs',
-		title: 'List Runtime Jobs',
-		description: 'List backend runtime jobs for a session with backend P2 status/kind filters.',
-		annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-	},
-	{
-		name: 'openfairygui_backend_cancel_job',
-		backendMethod: 'cancelJob',
-		title: 'Cancel Runtime Job',
-		description: 'Request cooperative cancellation for a backend runtime job.',
-		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
-	},
 	{
 		name: 'openfairygui_backend_get_cache_snapshot',
 		backendMethod: 'getCacheSnapshot',
@@ -175,7 +154,7 @@ export const OPENFAIRYGUI_BACKEND_TOOL_METADATA = [
 		name: 'openfairygui_backend_refresh_cache',
 		backendMethod: 'refreshCache',
 		title: 'Refresh Cache',
-		description: 'Create a backend P2 cache.refresh job for the session cache snapshot.',
+		description: 'Synchronously refresh the derived session cache and return its revision-bound snapshot.',
 		annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
 	},
 ] as const satisfies readonly BackendToolMetadata[];