ue-mcp 1.3.7 → 1.3.8-beta

package/dist/tools/project.js

@@ -24,6 +24,7 @@ import { readLogState, readEngineSnapshot } from "../engine-observer.js";
 import { switchProject, isTargetDiverged } from "../project-switch.js";
 import { ueMcpConfigRejections, describeConfigRejections } from "../project.js";
 import { CURSOR_PARAM, paged } from "../pagination.js";
+import { actions as epicActions, schema as epicSchema } from "./epic/project.generated.js";
 /**
  * The environment variables flattening every registered editor into one, right
  * now.
@@ -142,6 +143,8 @@ function resolveSourceModuleDir(projectDir, projectName, moduleName) {
 }
 export const projectTool = categoryTool("project", "Project status and editor connection: get_status (is the editor connected?), set_project (switch/redirect the bridge to another .uproject), get_info. Also config INI files, module load state, and C++ source inspection. Call project(get_status) first in any session.", {
     get_status: {
+        kind: "handler",
+        effect: "read",
         description: "Check server mode and editor connection. Also reports pluginBuildStale when the compiled bridge is older than its source, which is the real cause of 'Unknown method' on handlers that do exist. Params: none (#785)",
         handler: async (ctx) => {
             const flows = ctx.getFlows?.() ?? [];
@@ -243,6 +246,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     set_project: {
+        kind: "handler",
+        effect: "mutate",
         description: "Switch project: moves both path resolution and the editor connection to the new .uproject. Params: projectPath",
         handler: async (ctx, p) => {
             const projectPath = p.projectPath;
@@ -287,6 +292,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_editors: {
+        kind: "handler",
+        effect: "read",
         description: "List every editor session this server drives: name, project, bridge port, whether the socket is connected, whether anything is answering on that port, and which session untargeted calls fall through to. Params: none (#817)",
         handler: async (ctx) => {
             if (!ctx.sessions) {
@@ -334,6 +341,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     use_editor: {
+        kind: "handler",
+        effect: "mutate",
         description: "Make one editor session the default target for untargeted calls. Does not change the session set and never touches any editor process. Params: editorTarget (session name, project name, or .uproject path) (#817)",
         handler: async (ctx, p) => {
             if (!ctx.sessions)
@@ -352,6 +361,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     add_editor: {
+        kind: "handler",
+        effect: "mutate",
         description: "Register another project as an addressable editor session, with its own bridge connection and port. Optionally launch its editor. Every category then accepts editor=\"<name>\" to run a call there. Params: projectPath, editorName? (defaults to the project name), start? (launch the editor and wait for it to be ready), timeout? (seconds, default 300) (#817)",
         handler: async (ctx, p) => {
             if (!ctx.sessions)
@@ -423,6 +434,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     drop_editor: {
+        kind: "handler",
+        effect: "mutate",
         description: "Forget an editor session and close its bridge socket. The editor process is LEFT RUNNING and untouched - this detaches, it does not stop anything (use editor(stop_editor) for that). Params: editorTarget (#817)",
         handler: async (ctx, p) => {
             if (!ctx.sessions)
@@ -442,6 +455,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     get_info: {
+        kind: "handler",
+        effect: "read",
         description: "Read .uproject file details. Params: none",
         handler: async (ctx) => {
             ctx.project.ensureLoaded();
@@ -449,6 +464,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_config: {
+        kind: "handler",
+        effect: "read",
         description: "Read INI config. Params: configName (e.g. 'Engine', 'Game')",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -460,6 +477,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     search_config: {
+        kind: "handler",
+        effect: "read",
         description: "Search INI files. Params: query",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -485,6 +504,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_config_tags: {
+        kind: "handler",
+        effect: "read",
         description: "Extract gameplay tags from config. Params: none",
         handler: async (ctx) => {
             ctx.project.ensureLoaded();
@@ -516,6 +537,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_cpp_header: {
+        kind: "handler",
+        effect: "read",
         description: "Parse a .h file. Params: headerPath",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -532,6 +555,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_module: {
+        kind: "handler",
+        effect: "read",
         description: "Read module source. Params: moduleName",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -548,6 +573,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_modules: {
+        kind: "handler",
+        effect: "read",
         description: "List C++ modules. Params: none",
         handler: async (ctx) => {
             ctx.project.ensureLoaded();
@@ -567,6 +594,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     search_cpp: {
+        kind: "handler",
+        effect: "read",
         description: "Search .h/.cpp files. Params: query, directory?",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -624,6 +653,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_engine_header: {
+        kind: "handler",
+        effect: "read",
         description: "Parse a .h file from the engine source tree. Params: headerPath (relative to Engine/Source, or absolute)",
         handler: async (ctx, p) => {
             const engineRoot = requireEngineRoot(ctx);
@@ -638,6 +669,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     find_engine_symbol: {
+        kind: "handler",
+        effect: "read",
         description: "Grep engine headers for a symbol. Params: symbol, maxResults?",
         handler: async (ctx, p) => {
             const engineRoot = requireEngineRoot(ctx);
@@ -676,6 +709,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_engine_modules: {
+        kind: "handler",
+        effect: "read",
         description: "List modules in Engine/Source/Runtime. Params: none",
         handler: async (ctx) => {
             const engineRoot = requireEngineRoot(ctx);
@@ -689,6 +724,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     search_engine_cpp: {
+        kind: "handler",
+        effect: "read",
         description: "Search engine .h/.cpp/.inl files across Runtime/Editor/Developer/Plugins. Params: query, tree? (Runtime|Editor|Developer|Plugins|all - default Runtime), subdirectory?, maxResults? (default 500)",
         handler: async (ctx, p) => {
             const engineRoot = requireEngineRoot(ctx);
@@ -762,6 +799,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     search_tools: {
+        kind: "handler",
+        effect: "read",
         description: "Search every ue-mcp tool + action by keyword or task INTENT (a synonym layer maps 'screenshot'->capture_scene_png, 'tile a texture'->the texture-bomb flow, etc.) and return ranked matches (tool, action, description, score). The first step before editor(execute_python); most tasks already have a dedicated action. Params: query (space-separated keywords/intent), limit? (default 20) (#704)",
         handler: async (_ctx, p) => {
             const query = p.query ?? "";
@@ -779,6 +818,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     describe_action: {
+        kind: "handler",
+        effect: "read",
         description: "Return the live parameter schema for one action: every parameter it accepts, "
             + "with type, required/optional, description, allowed values and default, plus the "
             + "bridge method it dispatches to. search_tools finds an action by keyword and hands "
@@ -831,6 +872,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_available_actions: {
+        kind: "handler",
+        effect: "read",
         description: "Report which actions this server can serve RIGHT NOW and why the rest cannot. With no editor "
             + "attached the surface is advertised in full but most of it cannot run, and this is the line "
             + "between the two halves: an action either runs in this Node process (availability 'always') or "
@@ -872,6 +915,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_content_assets: {
+        kind: "handler",
+        effect: "read",
         description: "List the project's assets from the package files on DISK, which is the one asset query that "
             + "works with no editor running. Takes a mount path (/Game, /Game/Characters, or a plugin's "
             + "/MyPlugin) and resolves it through the same mount table the live path uses, so an offline "
@@ -890,6 +935,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         }),
     },
     check_install: {
+        kind: "handler",
+        effect: "read",
         description: "Answer whether this project can run the bridge at all, from disk, with no editor running and "
             + "nothing compiled. Reports the project kind (a project declaring no native modules of its own "
             + "is Blueprint-only, which is NOT a blocker: UnrealBuildTool writes temporary target and module "
@@ -909,6 +956,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     execute_python_report: {
+        kind: "handler",
+        effect: "read",
         description: "Measurement for #704: reads this session's execute_python calls and, for each, runs its taskSummary back through search_tools to flag calls that OVERLAPPED an existing dedicated action ('you used Python for X, but tool Y does X'). Returns totalCalls, overlapping[] and an overlapRate. Params: none (#704)",
         handler: async (ctx) => {
             const entries = getWorkarounds(ctx);
@@ -932,6 +981,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     list_files: {
+        kind: "handler",
+        effect: "read",
         description: "List files on disk under a directory, optionally filtered by extension(s). Runs in the MCP server process (no editor round-trip). Params: directory (absolute, or relative to the project dir), extensions? (e.g. ['png','exr'] or 'png'), recursive? (default false), maxResults? (default 1000) (#608)",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -974,8 +1025,10 @@ export const projectTool = categoryTool("project", "Project status and editor co
             return { directory: base, extensions: exts, recursive, count: results.length, files: results };
         },
     },
-    set_config: bp("Write to INI. Params: configName, section, key, value", "set_config"),
+    set_config: bp("mutate", "Write to INI. Params: configName, section, key, value", "set_config"),
     build: {
+        kind: "handler",
+        effect: "mutate",
         // #958: this used to be dispatched over the editor bridge, so it failed
         // with ECONNREFUSED whenever the editor was down. That made it unusable
         // for its only real job: UnrealBuildTool refuses to link while an editor
@@ -995,11 +1048,13 @@ export const projectTool = categoryTool("project", "Project status and editor co
             return { ...result, output: lines.join("") };
         },
     },
-    generate_project_files: bp("Generate IDE project files (Visual Studio, Xcode, etc.). Params: none", "generate_project_files"),
+    generate_project_files: bp("mutate", "Generate IDE project files (Visual Studio, Xcode, etc.). Params: none", "generate_project_files"),
     // v0.7.13 - native C++ authoring. Bridge handlers wrap
     // GameProjectUtils / ILiveCodingModule (same APIs used by the editor's
     // File → New C++ Class and Live Coding menus).
     create_cpp_class: {
+        kind: "bridge",
+        effect: "mutate",
         description: "Create a new native UCLASS in a project module. Uses the same engine template path as File → New C++ Class. Writes .h + .cpp; returns both paths plus needsEditorRestart (true unless Live Coding successfully hot-reloaded). Params: className (no prefix), parentClass? (default UObject; accepts short names like 'Actor' or /Script/<Module>.<Class> paths), moduleName? (default: first project module, use list_project_modules to pick), classDomain? ('public'|'private'|'classes', default public), subPath?",
         bridge: "create_cpp_class",
         // AddCodeToProject regenerates IDE project files synchronously - can
@@ -1013,21 +1068,25 @@ export const projectTool = categoryTool("project", "Project status and editor co
             subPath: p.subPath,
         }),
     },
-    list_project_modules: bp(paged("List native modules in the current project (name, host type, source path), in the .uproject's own declaration order. Feed moduleName from here into create_cpp_class."), "list_project_modules", (p) => ({ cursor: p.cursor, limit: p.limit })),
-    list_loaded_modules: bp(paged("Enumerate ALL engine+project modules with runtime load state (loaded/gameModule), not just uproject-declared ones. Params: filter? (case-insensitive substring), loadedOnly? (default false) (#689)"), "list_loaded_modules", (p) => ({ filter: p.filter, loadedOnly: p.loadedOnly, cursor: p.cursor, limit: p.limit })),
-    is_module_loaded: bp("Report whether a named module is currently loaded in the editor. Params: moduleName (#689)", "is_module_loaded", (p) => ({ moduleName: p.moduleName })),
-    list_available_plugins: bp(paged("List every plugin installed in this engine or project, sorted by name, with its category, version, type, whether it is enabled in THIS editor session, whether it is enabled by default, and the .uproject's current reference to it under projectReference {present, enabled}. Those two disagree after enable_plugin until the editor restarts, which is the point of reporting both. Params: filter?, pluginCategory?, enabledOnly?, limit? (default 200, max 2000)"), "list_available_plugins", (p) => ({ filter: p.filter, pluginCategory: p.pluginCategory, enabledOnly: p.enabledOnly, cursor: p.cursor, limit: p.limit })),
-    enable_plugin: bp("Enable a plugin in the .uproject. Plugin enablement is neither a UPROPERTY nor an INI key, it is a JSON array in the .uproject read once at startup, so set_config cannot reach it and without this a plugin-gated capability stays permanently unreachable through the bridge. Idempotent: a plugin already enabled, or enabled by default with no entry, reports existed and writes nothing. The change is a file change, so modules, classes, content and settings appear only after editor(restart_editor), which the result says. Params: pluginName", "enable_plugin", (p) => ({ pluginName: p.pluginName })),
-    disable_plugin: bp("Disable a plugin in the .uproject. removeReference deletes the entry outright instead of writing an explicit disable, which is the difference between handing a default-on plugin back to its default and overriding it, and the two are not the same file. Idempotent against whichever of the two was asked for. Refuses to disable the bridge itself, since that would leave no way to undo it. Takes effect on the next editor start. Params: pluginName, removeReference?", "disable_plugin", (p) => ({ pluginName: p.pluginName, removeReference: p.removeReference })),
+    list_project_modules: bp("read", paged("List native modules in the current project (name, host type, source path), in the .uproject's own declaration order. Feed moduleName from here into create_cpp_class."), "list_project_modules", (p) => ({ cursor: p.cursor, limit: p.limit })),
+    list_loaded_modules: bp("read", paged("Enumerate ALL engine+project modules with runtime load state (loaded/gameModule), not just uproject-declared ones. Params: filter? (case-insensitive substring), loadedOnly? (default false) (#689)"), "list_loaded_modules", (p) => ({ filter: p.filter, loadedOnly: p.loadedOnly, cursor: p.cursor, limit: p.limit })),
+    is_module_loaded: bp("read", "Report whether a named module is currently loaded in the editor. Params: moduleName (#689)", "is_module_loaded", (p) => ({ moduleName: p.moduleName })),
+    list_available_plugins: bp("read", paged("List every plugin installed in this engine or project, sorted by name, with its category, version, type, whether it is enabled in THIS editor session, whether it is enabled by default, and the .uproject's current reference to it under projectReference {present, enabled}. Those two disagree after enable_plugin until the editor restarts, which is the point of reporting both. Params: filter?, pluginCategory?, enabledOnly?, limit? (default 200, max 2000)"), "list_available_plugins", (p) => ({ filter: p.filter, pluginCategory: p.pluginCategory, enabledOnly: p.enabledOnly, cursor: p.cursor, limit: p.limit })),
+    enable_plugin: bp("mutate", "Enable a plugin in the .uproject. Plugin enablement is neither a UPROPERTY nor an INI key, it is a JSON array in the .uproject read once at startup, so set_config cannot reach it and without this a plugin-gated capability stays permanently unreachable through the bridge. Idempotent: a plugin already enabled, or enabled by default with no entry, reports existed and writes nothing. The change is a file change, so modules, classes, content and settings appear only after editor(restart_editor), which the result says. Params: pluginName", "enable_plugin", (p) => ({ pluginName: p.pluginName })),
+    disable_plugin: bp("mutate", "Disable a plugin in the .uproject. removeReference deletes the entry outright instead of writing an explicit disable, which is the difference between handing a default-on plugin back to its default and overriding it, and the two are not the same file. Idempotent against whichever of the two was asked for. Refuses to disable the bridge itself, since that would leave no way to undo it. Takes effect on the next editor start. Params: pluginName, removeReference?", "disable_plugin", (p) => ({ pluginName: p.pluginName, removeReference: p.removeReference })),
     live_coding_compile: {
+        kind: "bridge",
+        effect: "mutate",
         description: "Trigger a Live Coding compile (Windows only). Hot-patches method bodies of existing UCLASSes without editor restart - the fast inner loop for UFUNCTION implementations. Does NOT reliably register brand-new UCLASSes; use build_project + editor restart for those. Params: wait? (default false - fire and return 'in_progress').",
         bridge: "live_coding_compile",
         timeoutMs: 300_000,
         mapParams: (p) => ({ wait: p.wait }),
     },
-    live_coding_status: bp("Report Live Coding availability/state (available, started, enabledForSession, compiling). Helps choose between live_coding_compile and build_project. Params: none", "live_coding_status", () => ({})),
-    resolve_collision_profile: bp("Read one collision profile's resolved per-channel responses: collisionEnabled, objectType, and every channel with Block/Overlap/Ignore. This is the project-side half of blueprint(get_component_collision) (#925): a component's ResponseArray only lists the channels it OVERRIDES, so the profile is where an inherited response actually comes from. Project trace and object channels appear under their configured names, with enumName (ECC_GameTraceChannel1) alongside so a caller can key on something stable. By default the eight engine channels plus every channel the project configured are returned; includeAllChannels=true adds the unused slots. channel narrows it to one. A profile that does not exist lists the ones that do. Params: profileName, channel?, includeAllChannels?", "resolve_collision_profile", (p) => ({ profileName: p.profileName, channel: p.channel, includeAllChannels: p.includeAllChannels })),
+    live_coding_status: bp("read", "Report Live Coding availability/state (available, started, enabledForSession, compiling). Helps choose between live_coding_compile and build_project. Params: none", "live_coding_status", () => ({})),
+    resolve_collision_profile: bp("read", "Read one collision profile's resolved per-channel responses: collisionEnabled, objectType, and every channel with Block/Overlap/Ignore. This is the project-side half of blueprint(get_component_collision) (#925): a component's ResponseArray only lists the channels it OVERRIDES, so the profile is where an inherited response actually comes from. Project trace and object channels appear under their configured names, with enumName (ECC_GameTraceChannel1) alongside so a caller can key on something stable. By default the eight engine channels plus every channel the project configured are returned; includeAllChannels=true adds the unused slots. channel narrows it to one. A profile that does not exist lists the ones that do. Params: profileName, channel?, includeAllChannels?", "resolve_collision_profile", (p) => ({ profileName: p.profileName, channel: p.channel, includeAllChannels: p.includeAllChannels })),
     write_cpp_file: {
+        kind: "handler",
+        effect: "mutate",
         description: "Write a .h / .cpp / .inl file under the project's Source/ tree. Used to append UPROPERTYs/UFUNCTIONs or method bodies after create_cpp_class. Writes are scoped to Source/ for safety. Params: path (relative to Source/ or absolute within Source/), content (full file contents). After editing, call live_coding_compile (for existing classes) or build_project (for new classes).",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -1060,6 +1119,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_cpp_source: {
+        kind: "handler",
+        effect: "read",
         description: "Read a .cpp file from the project Source/ tree. Companion to read_cpp_header for round-trip edits. Params: sourcePath (relative to Source/ or absolute).",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -1079,6 +1140,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     write_source_file: {
+        kind: "handler",
+        effect: "mutate",
         description: "Write a .h/.cpp/.inl into a named module's Public/Private folder (resolves the module dir for you, including plugin modules under Plugins/*/Source/ that write_cpp_file refuses). After a new file, build_project + restart; after a body edit, live_coding_compile. Params: module (module name, default the project's primary module), visibility (Public|Private, default Private), fileName, content.",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -1112,6 +1175,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     read_source_file: {
+        kind: "handler",
+        effect: "read",
         description: "Read a .h/.cpp/.inl from a named module's folder (companion to write_source_file; resolves plugin modules too). With no visibility it tries Public then Private then the module root. Params: module, visibility?, fileName.",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -1134,6 +1199,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     build_engine_index: {
+        kind: "handler",
+        effect: "mutate",
         description: "Build or refresh the engine symbol index that verify_symbols, lint_cpp_header and "
             + "suggest_build_deps read. Scans roughly 31,000 headers across Runtime, Editor, Developer "
             + "and the includable half of Engine/Plugins, and records for each symbol the header that "
@@ -1161,6 +1228,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     verify_symbols: {
+        kind: "handler",
+        effect: "read",
         description: "Check that engine symbols exist BEFORE writing C++ that uses them, and get back what you "
             + "need to write it: the header to #include, the owning module for Build.cs, the exact "
             + "declaration, the base class, and any UE_DEPRECATED with its version and message. Accepts "
@@ -1179,6 +1248,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     suggest_build_deps: {
+        kind: "handler",
+        effect: "mutate",
         description: "Given the engine symbols a module uses, report which modules its Build.cs has to depend on "
             + "and which of those it does not list yet, plus the AddRange line to paste. Core and "
             + "CoreUObject are omitted because every module already has them. buildCsPath defaults to "
@@ -1201,6 +1272,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     find_example_usage: {
+        kind: "handler",
+        effect: "read",
         description: "Find real call sites for an engine symbol in the engine's own .cpp files, which answers "
             + "'how is this actually used' with code that compiles. Better than a signature for anything "
             + "with a non-obvious calling convention. Searches sources rather than headers on purpose: a "
@@ -1225,6 +1298,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     class_hierarchy: {
+        kind: "handler",
+        effect: "read",
         description: "Report what a class derives from and what derives from it, which is the question behind "
             + "'what should I subclass' and 'what already does this'. Ancestors are the full chain up "
             + "to the root, nearest parent first; descendants default to the direct subclasses only, "
@@ -1258,6 +1333,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     find_references: {
+        kind: "handler",
+        effect: "read",
         description: "Find every line in the engine tree that names a symbol, which answers 'how is this woven "
             + "into the engine' and 'what would break if this changed'. Broader than find_callers on "
             + "purpose: a reference is a member declaration, a UPROPERTY type, a cast, a template "
@@ -1285,6 +1362,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     find_callers: {
+        kind: "handler",
+        effect: "read",
         description: "Find who calls a function, and from which enclosing function, which is how to see the "
             + "conventions around a call before writing one: what is checked first, what is passed, "
             + "what is done with the result. Searches .cpp bodies first, since a mention in a header is "
@@ -1312,6 +1391,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     find_callees: {
+        kind: "handler",
+        effect: "read",
         description: "Report what a function calls, by reading its body and looking every called name back up "
             + "in the engine index. Answers 'what does doing this properly actually involve': the "
             + "result carries each callee's module and include, and modules[] is the Build.cs cost of "
@@ -1340,6 +1421,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     symbol_context: {
+        kind: "handler",
+        effect: "read",
         description: "Return the lines of engine source around a declaration, so the API surrounding a symbol "
             + "can be read without opening the file: the sibling overloads, the UPROPERTY above it, the "
             + "comment saying which of three similar methods to call. verify_symbols returns the "
@@ -1368,6 +1451,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     lint_cpp_header: {
+        kind: "handler",
+        effect: "read",
         description: "Check a header you just wrote against the engine it has to build against, and report what "
             + "the compiler would before the compiler runs. Covers the structural mistakes that produce "
             + "baffling Unreal build errors (a reflected type with no .generated.h include, a .generated.h "
@@ -1400,6 +1485,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     add_module_dependency: {
+        kind: "handler",
+        effect: "mutate",
         description: "Add a module to a target module's Build.cs dependency array. Params: moduleName (the Build.cs to edit - must exist in the project), dependency (module name to add, e.g. 'UMG'), access? ('public'|'private', default 'private'). Creates the corresponding AddRange block if missing. Rebuild required afterward.",
         handler: async (ctx, p) => {
             ctx.project.ensureLoaded();
@@ -1453,6 +1540,8 @@ export const projectTool = categoryTool("project", "Project status and editor co
         },
     },
     add_cpp_member: {
+        kind: "handler",
+        effect: "mutate",
         // #423: append a UPROPERTY / UFUNCTION declaration to an existing UCLASS
         // header in the right access-specifier block. The recurring trap is that
         // raw appending lands the declaration in whatever access section the
@@ -1536,7 +1625,9 @@ export const projectTool = categoryTool("project", "Project status and editor co
             };
         },
     },
+    ...epicActions,
 }, undefined, {
+    ...epicSchema,
     projectPath: z.string().optional().describe("For set_project / add_editor / check_install: path to .uproject"),
     editorName: z.string().optional().describe("For add_editor: name to address the new session by (default the project name) (#817)"),
     editorTarget: z.string().optional().describe("For use_editor / drop_editor: session name, project name, or .uproject path (#817)"),