@skillcap/gdh 3.1.0 → 3.2.0

package/node_modules/@gdh/docs/dist/templates/guidance/editor-bridge.md.tpl

@@ -0,0 +1,28 @@
+# {{projectName}}: Editor Bridge
+
+Use this unit when the task asks about the Godot editor, the currently open scene, scene tree inspection, node inspection, resource properties, or editor-backed scene/resource authoring.
+
+Start with context before guessing:
+
+- Use MCP `editor.state` to inspect the exact target/worktree editor session. In adopted-editor mode it reports current/open scene and selected nodes when the editor exposes them.
+- Use MCP `editor.scene.tree` for a saved scene tree. It requires an explicit `scenePath`; if you need the active editor scene first, call `editor.state`.
+- Use MCP `editor.node.inspect` for inspector-style node context from a saved scene: node summary plus requested property values or a bounded property list.
+- Use MCP `editor.resource.properties` before `editor.resource.read` when you do not already know the resource property names.
+- Use MCP `editor.resource.read` for targeted resource values. Nested arrays and dictionaries are bounded and resources are returned as handles when Godot exposes a resource path.
+- Use MCP `editor.class.search` and `editor.class.info` for class discovery instead of guessing Godot class names or property names.
+
+Use `editor.operation.run` only as the advanced escape hatch for operation kinds not covered by a focused MCP tool or for batched editor operations. Generic operation payloads dispatch on `operation.kind`, not `operation.type`.
+
+Recover from bad editor-operation payloads by reading the returned `summary`, `reasons`, and `help.examples`. CLI smoke-test help is available with:
+
+```sh
+gdh editor operation run --help
+```
+
+Do not read `.godot/` cache files to answer live editor-state questions while GDH editor tools are available. `.godot/` remains generated editor/import state; use it only when GDH explicitly reports that editor context is unavailable and you surface that limitation.
+
+Boundaries:
+
+- Current editor context and selection are available only from adopted editor sessions that expose editor APIs. Managed headless editor operations can load saved scenes/resources, but they do not have a human editor selection.
+- Scene/resource reads are bounded inspection and authoring support, not UI automation of the Godot editor.
+- Arbitrary editor script execution, broad editor UI automation, animation editor operations, TileMap/TileSet editing, and generic file maintenance remain outside this guidance.

package/node_modules/@gdh/docs/package.json

@@ -11,8 +11,8 @@
     }
   },
   "dependencies": {
-    "@gdh/core": "3.1.0",
+    "@gdh/core": "3.2.0",
     "yaml": "^2.8.3"
   },
-  "version": "3.1.0"
+  "version": "3.2.0"
 }

package/node_modules/@gdh/editor/dist/index.d.ts

@@ -105,6 +105,14 @@ export type GdhEditorOperation = {
     readonly scenePath: string;
     readonly nodePath: string;
     readonly propertyName: string;
+} | {
+    readonly kind: "node.inspect";
+    readonly scenePath: string;
+    readonly nodePath?: string;
+    readonly propertyNames?: readonly string[];
+    readonly includePropertyList?: boolean;
+    readonly propertyQuery?: string;
+    readonly propertyLimit?: number;
 } | {
     readonly kind: "resource.create";
     readonly resourcePath: string;
@@ -114,6 +122,11 @@ export type GdhEditorOperation = {
     readonly kind: "resource.read";
     readonly resourcePath: string;
     readonly propertyNames?: readonly string[];
+} | {
+    readonly kind: "resource.properties";
+    readonly resourcePath: string;
+    readonly propertyQuery?: string;
+    readonly propertyLimit?: number;
 } | {
     readonly kind: "resource.set_property";
     readonly resourcePath: string;
@@ -142,14 +155,21 @@ export type GdhEditorOperation = {
     readonly kind: "batch.apply";
     readonly operations: readonly GdhEditorOperation[];
 };
+export type GdhEditorOperationPayload = Readonly<Record<string, GdhJsonValue>>;
+export interface GdhEditorOperationHelp {
+    readonly usage: string;
+    readonly helpCommand: string;
+    readonly examples: readonly Readonly<Record<string, GdhJsonValue>>[];
+}
 export interface GdhEditorOperationResult {
     readonly targetPath: string;
     readonly state: GdhEditorOperationState;
     readonly summary: string;
     readonly reasons: readonly string[];
     readonly session: GdhEditorSessionSummary;
-    readonly operation: GdhEditorOperation;
+    readonly operation: GdhEditorOperationPayload;
     readonly output: GdhJsonValue;
+    readonly help?: GdhEditorOperationHelp | null;
     readonly artifacts: {
         readonly operationId: string;
         readonly directory: string;
@@ -161,7 +181,7 @@ export interface GdhEditorOperationResult {
     } | null;
 }
 export interface RunEditorOperationInput extends ResolveEditorBridgePathsInput {
-    readonly operation: GdhEditorOperation;
+    readonly operation: GdhEditorOperationPayload;
     readonly mode?: GdhEditorSessionMode;
     readonly timeoutMs?: number;
     readonly godotEditorBin?: string | null;
@@ -186,7 +206,7 @@ export type InvokeAdoptedEditor = (input: {
     readonly metadata: GdhEditorAdoptionMetadata;
     readonly token: string;
     readonly identity: GdhBridgeTargetIdentity;
-    readonly operation: GdhEditorOperation;
+    readonly operation: GdhEditorOperationPayload;
     readonly timeoutMs: number;
 }) => Promise<RunnerOutput>;
 export interface GdhEditorRunnerOutput {
@@ -194,6 +214,7 @@ export interface GdhEditorRunnerOutput {
     readonly summary?: string;
     readonly reasons?: readonly string[];
     readonly output?: GdhJsonValue;
+    readonly help?: GdhEditorOperationHelp | null;
 }
 type RunnerOutput = GdhEditorRunnerOutput;
 export declare function resolveEditorBridgePaths(input: ResolveEditorBridgePathsInput): GdhEditorBridgePaths;

package/node_modules/@gdh/editor/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/editor/dist/index.js

@@ -117,8 +117,187 @@ export async function inspectEditorBridgeSession(input) {
         adoptedEditor: null,
     };
 }
+function validateEditorOperation(operation) {
+    const kind = readPayloadString(operation["kind"]);
+    const help = createEditorOperationHelp(kind);
+    if (kind === "") {
+        const typeValue = readPayloadString(operation["type"]);
+        const operationHelp = typeValue === "" ? help : createEditorOperationHelp(typeValue);
+        return {
+            summary: typeValue === ""
+                ? `Editor operation payload is missing "kind". Use operation.kind, for example ${JSON.stringify(help.examples[0])}.`
+                : `Editor operation payload used "type": "${typeValue}", but GDH dispatches editor operations with "kind". Use ${JSON.stringify(operationHelp.examples[0])}.`,
+            reasons: typeValue === ""
+                ? ["operation_kind_missing"]
+                : ["operation_kind_missing", "operation_type_unsupported"],
+            help: operationHelp,
+        };
+    }
+    if (!KNOWN_EDITOR_OPERATION_KINDS.has(kind)) {
+        return {
+            summary: `Unsupported editor operation kind "${kind}". Use one of: ${[
+                ...KNOWN_EDITOR_OPERATION_KINDS,
+            ].join(", ")}.`,
+            reasons: ["operation_unsupported"],
+            help,
+        };
+    }
+    const missingField = requiredFieldForOperation(kind, operation);
+    if (missingField !== null) {
+        return {
+            summary: `Editor operation "${kind}" requires "${missingField}". Example: ${JSON.stringify(createEditorOperationHelp(kind).examples[0])}.`,
+            reasons: [`${toSnakeCase(missingField)}_missing`],
+            help: createEditorOperationHelp(kind),
+        };
+    }
+    if (kind === "batch.apply") {
+        const operations = operation["operations"];
+        if (!Array.isArray(operations)) {
+            return {
+                summary: 'Editor operation "batch.apply" requires "operations" as an array of operation payloads.',
+                reasons: ["batch_operations_invalid"],
+                help,
+            };
+        }
+        for (const child of operations) {
+            if (child === null || Array.isArray(child) || typeof child !== "object") {
+                return {
+                    summary: 'Editor operation "batch.apply" children must be operation objects.',
+                    reasons: ["batch_child_operation_invalid"],
+                    help,
+                };
+            }
+            const childValidation = validateEditorOperation(child);
+            if (childValidation !== null)
+                return childValidation;
+        }
+    }
+    return null;
+}
+const KNOWN_EDITOR_OPERATION_KINDS = new Set([
+    "scene.create",
+    "scene.tree",
+    "scene.save",
+    "node.add",
+    "node.remove",
+    "node.reparent",
+    "node.duplicate",
+    "node.set_property",
+    "node.get_property",
+    "node.inspect",
+    "resource.create",
+    "resource.read",
+    "resource.properties",
+    "resource.set_property",
+    "script.attach",
+    "class.search",
+    "class.info",
+    "editor.state",
+    "batch.apply",
+]);
+function requiredFieldForOperation(kind, operation) {
+    const require = (...fields) => fields.find((field) => readPayloadString(operation[field]) === "") ?? null;
+    switch (kind) {
+        case "scene.create":
+        case "scene.tree":
+        case "scene.save":
+            return require("scenePath");
+        case "node.add":
+            return require("scenePath", "nodeType", "nodeName");
+        case "node.remove":
+        case "node.reparent":
+        case "node.duplicate":
+            return require("scenePath", "nodePath");
+        case "node.set_property":
+        case "node.get_property":
+            return require("scenePath", "nodePath", "propertyName");
+        case "node.inspect":
+            return require("scenePath");
+        case "resource.create":
+            return require("resourcePath", "resourceType");
+        case "resource.read":
+        case "resource.properties":
+            return require("resourcePath");
+        case "resource.set_property":
+            return require("resourcePath", "propertyName");
+        case "script.attach":
+            return require("scenePath", "nodePath", "scriptPath");
+        case "class.info":
+            return require("className");
+        default:
+            return null;
+    }
+}
+function createEditorOperationHelp(kind) {
+    const example = editorOperationExample(kind);
+    return {
+        usage: "Use editor.operation.run with an operation object that contains a kind field, or prefer focused MCP tools such as editor.state, editor.scene.tree, editor.resource.read, editor.resource.properties, editor.node.inspect, editor.class.search, and editor.class.info.",
+        helpCommand: 'gdh editor operation run --help; example: gdh editor operation run --input-json \'{"kind":"class.search","query":"Label"}\'',
+        examples: [example],
+    };
+}
+function editorOperationExample(kind) {
+    switch (kind) {
+        case "scene.tree":
+            return { kind: "scene.tree", scenePath: "res://path/to/scene.tscn", maxDepth: 3 };
+        case "node.inspect":
+            return {
+                kind: "node.inspect",
+                scenePath: "res://path/to/scene.tscn",
+                nodePath: ".",
+                includePropertyList: true,
+                propertyLimit: 40,
+            };
+        case "resource.read":
+            return {
+                kind: "resource.read",
+                resourcePath: "res://path/to/resource.tres",
+                propertyNames: ["name"],
+            };
+        case "resource.properties":
+            return { kind: "resource.properties", resourcePath: "res://path/to/resource.tres" };
+        case "class.search":
+            return { kind: "class.search", query: "Label" };
+        case "class.info":
+            return { kind: "class.info", className: "Label", propertyQuery: "text" };
+        case "editor.state":
+            return { kind: "editor.state" };
+        default:
+            return { kind: "editor.state" };
+    }
+}
+function readPayloadString(value) {
+    return typeof value === "string" ? value : "";
+}
+function toSnakeCase(value) {
+    return value.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
 export async function runEditorOperation(input) {
     const paths = resolveEditorBridgePaths(input);
+    const operationValidation = validateEditorOperation(input.operation);
+    if (operationValidation !== null) {
+        return {
+            targetPath: paths.targetRootPath,
+            state: "failed",
+            summary: operationValidation.summary,
+            reasons: operationValidation.reasons,
+            session: {
+                targetPath: paths.targetRootPath,
+                godotProjectRootPath: paths.godotProjectRootPath,
+                mode: input.mode ?? "auto",
+                state: "blocked",
+                kind: null,
+                summary: "Editor operation was rejected before session startup.",
+                reasons: operationValidation.reasons,
+                identity: paths.identity,
+                adoptedEditor: null,
+            },
+            operation: input.operation,
+            output: null,
+            help: operationValidation.help,
+            artifacts: null,
+        };
+    }
     const session = await inspectEditorBridgeSession(input);
     if (session.state !== "ready" || session.kind === null) {
         return {
@@ -129,6 +308,7 @@ export async function runEditorOperation(input) {
             session,
             operation: input.operation,
             output: null,
+            help: null,
             artifacts: null,
         };
     }
@@ -145,6 +325,7 @@ export async function runEditorOperation(input) {
             session,
             operation: input.operation,
             output: null,
+            help: null,
             artifacts: null,
         };
     }
@@ -198,6 +379,7 @@ export async function runEditorOperation(input) {
             session,
             operation: input.operation,
             output: null,
+            help: null,
             artifacts,
         };
     }
@@ -210,6 +392,7 @@ export async function runEditorOperation(input) {
         session,
         operation: input.operation,
         output: runnerOutput.output ?? null,
+        help: runnerOutput.help ?? null,
         artifacts,
     };
 }
@@ -224,6 +407,7 @@ async function runAdoptedEditorOperation(input) {
             session: input.session,
             operation: input.input.operation,
             output: null,
+            help: null,
             artifacts: null,
         };
     }
@@ -259,6 +443,7 @@ async function runAdoptedEditorOperation(input) {
         session: input.session,
         operation: input.input.operation,
         output: runnerOutput.output ?? null,
+        help: runnerOutput.help ?? null,
         artifacts,
     };
 }
@@ -537,6 +722,11 @@ func run_editor_operation(operation: Dictionary) -> Dictionary:
 
 func _dispatch_operation(operation: Dictionary) -> Dictionary:
 	var kind := str(operation.get("kind", ""))
+	if kind == "":
+		var type_value := str(operation.get("type", ""))
+		if type_value != "":
+			return _failure("Editor operation payload used type='" + type_value + "', but GDH dispatches editor operations with kind. Use operation.kind instead.", ["operation_kind_missing", "operation_type_unsupported"], _operation_help(type_value))
+		return _failure("Editor operation payload is missing kind.", ["operation_kind_missing"], _operation_help("editor.state"))
 	match kind:
 		"scene.create":
 			return _scene_create(operation)
@@ -556,10 +746,14 @@ func _dispatch_operation(operation: Dictionary) -> Dictionary:
 			return _node_set_property(operation)
 		"node.get_property":
 			return _node_get_property(operation)
+		"node.inspect":
+			return _node_inspect(operation)
 		"resource.create":
 			return _resource_create(operation)
 		"resource.read":
 			return _resource_read(operation)
+		"resource.properties":
+			return _resource_properties(operation)
 		"resource.set_property":
 			return _resource_set_property(operation)
 		"script.attach":
@@ -573,7 +767,7 @@ func _dispatch_operation(operation: Dictionary) -> Dictionary:
 		"batch.apply":
 			return _batch_apply(operation)
 		_:
-			return _failure("Unsupported editor operation: " + kind, ["operation_unsupported"])
+			return _failure("Unsupported editor operation: " + kind, ["operation_unsupported"], _operation_help(kind))
 
 func _scene_create(operation: Dictionary) -> Dictionary:
 	var scene_path := _res_path(str(operation.get("scenePath", "")))
@@ -597,6 +791,8 @@ func _scene_create(operation: Dictionary) -> Dictionary:
 
 func _scene_tree(operation: Dictionary) -> Dictionary:
 	var scene_path := _res_path(str(operation.get("scenePath", "")))
+	if scene_path == "res://":
+		return _failure("scene.tree requires scenePath.", ["scene_path_missing"], _operation_help("scene.tree"))
 	var loaded = load(scene_path)
 	if loaded == null or not (loaded is PackedScene):
 		return _failure("Scene could not be loaded: " + scene_path, ["scene_load_failed"])
@@ -739,6 +935,31 @@ func _node_get_property(operation: Dictionary) -> Dictionary:
 	root.queue_free()
 	return _success("Node property read.", {"scenePath": scene_path, "nodePath": node_path, "propertyName": property_name, "value": value})
 
+func _node_inspect(operation: Dictionary) -> Dictionary:
+	var scene_path := _res_path(str(operation.get("scenePath", "")))
+	if scene_path == "res://":
+		return _failure("node.inspect requires scenePath.", ["scene_path_missing"], _operation_help("node.inspect"))
+	var root = _load_scene_root(scene_path)
+	if root == null:
+		return _failure("Scene could not be loaded: " + scene_path, ["scene_load_failed"])
+	var node_path := str(operation.get("nodePath", "."))
+	var node = _find_node(root, node_path)
+	if node == null:
+		root.queue_free()
+		return _failure("Node not found: " + node_path, ["node_not_found"])
+	var property_names = operation.get("propertyNames", [])
+	var properties := {}
+	if typeof(property_names) == TYPE_ARRAY:
+		for property_name in property_names:
+			var key := str(property_name)
+			properties[key] = _encode_value(node.get(key))
+	var property_list := []
+	if bool(operation.get("includePropertyList", false)):
+		property_list = _filter_property_list(node.get_property_list(), str(operation.get("propertyQuery", "")), int(operation.get("propertyLimit", 50)))
+	var summary := _node_summary(node, node_path, 0, 0)
+	root.queue_free()
+	return _success("Node inspected.", {"scenePath": scene_path, "nodePath": node_path, "node": summary, "properties": properties, "propertyList": property_list})
+
 func _resource_create(operation: Dictionary) -> Dictionary:
 	var resource_path := _res_path(str(operation.get("resourcePath", "")))
 	var resource_type := str(operation.get("resourceType", ""))
@@ -754,6 +975,8 @@ func _resource_create(operation: Dictionary) -> Dictionary:
 
 func _resource_read(operation: Dictionary) -> Dictionary:
 	var resource_path := _res_path(str(operation.get("resourcePath", "")))
+	if resource_path == "res://":
+		return _failure("resource.read requires resourcePath.", ["resource_path_missing"], _operation_help("resource.read"))
 	var resource = load(resource_path)
 	if resource == null or not (resource is Resource):
 		return _failure("Resource could not be loaded: " + resource_path, ["resource_load_failed"])
@@ -766,6 +989,17 @@ func _resource_read(operation: Dictionary) -> Dictionary:
 	var script = resource.get_script()
 	return _success("Resource read.", {"resourcePath": resource_path, "class": resource.get_class(), "scriptPath": script.resource_path if script else null, "properties": properties})
 
+func _resource_properties(operation: Dictionary) -> Dictionary:
+	var resource_path := _res_path(str(operation.get("resourcePath", "")))
+	if resource_path == "res://":
+		return _failure("resource.properties requires resourcePath.", ["resource_path_missing"], _operation_help("resource.properties"))
+	var resource = load(resource_path)
+	if resource == null or not (resource is Resource):
+		return _failure("Resource could not be loaded: " + resource_path, ["resource_load_failed"])
+	var script = resource.get_script()
+	var properties := _filter_property_list(resource.get_property_list(), str(operation.get("propertyQuery", "")), int(operation.get("propertyLimit", 80)))
+	return _success("Resource properties loaded.", {"resourcePath": resource_path, "class": resource.get_class(), "scriptPath": script.resource_path if script else null, "properties": properties, "propertiesTruncated": properties.size() >= int(operation.get("propertyLimit", 80))})
+
 func _resource_set_property(operation: Dictionary) -> Dictionary:
 	var resource_path := _res_path(str(operation.get("resourcePath", "")))
 	var resource = load(resource_path)
@@ -871,13 +1105,34 @@ func _class_info(operation: Dictionary) -> Dictionary:
 	return _failure("Class not found: " + class_id, ["class_not_found"])
 
 func _editor_state(_operation: Dictionary) -> Dictionary:
+	var editor_interface = _editor_interface()
+	var current_scene_path = null
+	var open_scenes := []
+	var selected_node_paths := []
+	if editor_interface != null:
+		if editor_interface.has_method("get_open_scenes"):
+			for scene_path in editor_interface.get_open_scenes():
+				open_scenes.append(str(scene_path))
+		var edited_root = editor_interface.get_edited_scene_root()
+		if edited_root != null:
+			current_scene_path = edited_root.scene_file_path
+		var selection = editor_interface.get_selection()
+		if selection != null:
+			for selected_node in selection.get_selected_nodes():
+				if edited_root != null and selected_node is Node:
+					selected_node_paths.append(str(edited_root.get_path_to(selected_node)))
+				else:
+					selected_node_paths.append(str(selected_node.get_path()))
 	return _success("Editor state loaded.", {
 		"projectName": ProjectSettings.get_setting("application/config/name", ""),
 		"engineVersion": Engine.get_version_info().get("string", ""),
 		"features": ProjectSettings.get_setting("application/config/features", []),
 		"godotProjectRootPath": ProjectSettings.globalize_path("res://"),
+		"editorContextAvailable": editor_interface != null,
+		"currentScenePath": current_scene_path,
+		"openScenes": open_scenes,
 		"dirtyScenes": [],
-		"selectedNodePaths": [],
+		"selectedNodePaths": selected_node_paths,
 	})
 
 func _batch_apply(operation: Dictionary) -> Dictionary:
@@ -940,23 +1195,67 @@ func _decode_value(value):
 			return Color(float(color.get("r", 0.0)), float(color.get("g", 0.0)), float(color.get("b", 0.0)), float(color.get("a", 1.0)))
 	return value
 
-func _encode_value(value):
+func _encode_value(value, depth := 0):
 	if value == null:
 		return null
+	if depth >= 4:
+		return {"$truncated": "max_depth", "text": str(value)}
 	if value is Vector2:
 		return {"$vector2": {"x": value.x, "y": value.y}}
 	if value is Color:
 		return {"$color": {"r": value.r, "g": value.g, "b": value.b, "a": value.a}}
 	if value is Resource:
-		return {"$resource": value.resource_path, "class": value.get_class()}
+		var resource_path: String = value.resource_path
+		return {"$resource": resource_path if resource_path != "" else null, "class": value.get_class(), "text": str(value)}
 	var value_type := typeof(value)
-	if value_type in [TYPE_BOOL, TYPE_INT, TYPE_FLOAT, TYPE_STRING, TYPE_ARRAY, TYPE_DICTIONARY]:
+	if value_type in [TYPE_BOOL, TYPE_INT, TYPE_FLOAT, TYPE_STRING]:
 		return value
+	if value_type == TYPE_ARRAY:
+		var encoded := []
+		var count := 0
+		for item in value:
+			if count >= 100:
+				encoded.append({"$truncated": "max_items"})
+				break
+			encoded.append(_encode_value(item, depth + 1))
+			count += 1
+		return encoded
+	if value_type == TYPE_DICTIONARY:
+		var encoded_dict := {}
+		var count := 0
+		for key in value.keys():
+			if count >= 100:
+				encoded_dict["$truncated"] = "max_items"
+				break
+			encoded_dict[str(key)] = _encode_value(value[key], depth + 1)
+			count += 1
+		return encoded_dict
 	return str(value)
 
 func _property_summary(property: Dictionary) -> Dictionary:
 	return {"name": str(property.get("name", "")), "type": int(property.get("type", TYPE_NIL)), "hint": int(property.get("hint", 0)), "usage": int(property.get("usage", 0))}
 
+func _filter_property_list(property_list: Array, query: String, limit: int) -> Array:
+	var lowered_query := query.to_lower()
+	var effective_limit := limit if limit > 0 else 50
+	var properties := []
+	for property in property_list:
+		var name := str(property.get("name", ""))
+		if lowered_query != "" and not name.to_lower().contains(lowered_query):
+			continue
+		properties.append(_property_summary(property))
+		if properties.size() >= effective_limit:
+			break
+	return properties
+
+func _editor_interface():
+	var plugin = get("_plugin")
+	if plugin == null:
+		return null
+	if plugin.has_method("get_editor_interface"):
+		return plugin.get_editor_interface()
+	return null
+
 func _find_script_class(class_id: String) -> Dictionary:
 	for entry in ProjectSettings.get_global_class_list():
 		if str(entry.get("class", "")) == class_id:
@@ -1048,8 +1347,25 @@ func _write_json(path: String, value: Dictionary) -> void:
 func _success(summary: String, output: Dictionary) -> Dictionary:
 	return {"ok": true, "summary": summary, "reasons": [], "output": output}
 
-func _failure(summary: String, reasons: Array) -> Dictionary:
-	return {"ok": false, "summary": summary, "reasons": reasons, "output": null}
+func _failure(summary: String, reasons: Array, help := {}) -> Dictionary:
+	return {"ok": false, "summary": summary, "reasons": reasons, "output": null, "help": help}
+
+func _operation_help(kind: String) -> Dictionary:
+	var examples := {
+		"scene.tree": {"kind": "scene.tree", "scenePath": "res://path/to/scene.tscn", "maxDepth": 3},
+		"node.inspect": {"kind": "node.inspect", "scenePath": "res://path/to/scene.tscn", "nodePath": ".", "includePropertyList": true, "propertyLimit": 40},
+		"resource.read": {"kind": "resource.read", "resourcePath": "res://path/to/resource.tres", "propertyNames": ["name"]},
+		"resource.properties": {"kind": "resource.properties", "resourcePath": "res://path/to/resource.tres"},
+		"class.search": {"kind": "class.search", "query": "Label"},
+		"class.info": {"kind": "class.info", "className": "Label", "propertyQuery": "text"},
+		"editor.state": {"kind": "editor.state"},
+	}
+	var example = examples.get(kind, {"kind": "editor.state"})
+	return {
+		"usage": "Use editor.operation.run with operation.kind, or prefer focused MCP tools: editor.state, editor.scene.tree, editor.node.inspect, editor.resource.read, editor.resource.properties, editor.class.search, editor.class.info.",
+		"helpCommand": "gdh editor operation run --help",
+		"examples": [example],
+	}
 `;
 }
 export function renderEditorOperationCatalogGdscript() {