unity-open-mcp 0.1.0 → 0.3.0

package/dist/tools/index.js

@@ -9,6 +9,7 @@ import { validateEdit } from "./validate-edit.js";
 import { checkpointCreate } from "./checkpoint-create.js";
 import { delta } from "./delta.js";
 import { findReferences } from "./find-references.js";
+import { dependencies } from "./dependencies.js";
 import { scanPaths } from "./scan-paths.js";
 import { applyFix } from "./apply-fix.js";
 import { scanAll } from "./scan-all.js";
@@ -28,6 +29,16 @@ import { captureInline } from "./capture-inline.js";
 // M20 Plan 1 / T20.1.2 — Editor window screenshot. Win-only full-fidelity via
 // PrintWindow; cross-platform best-effort readback with platformLimited flag.
 import { screenshotWindow } from "./screenshot-window.js";
+// M20 Plan 1 / T20.1.3 — Frame Debugger control + draw-call list. Wraps the
+// internal Frame Debugger API via reflection; enable/disable is a non-mutating
+// Editor state change (gate-free, read-only), list returns the draw calls of
+// the currently-debugged frame.
+import { frameDebugger } from "./frame-debugger.js";
+// M20 Plan 1 / T20.1.4 — single-frame deep profiler capture. Returns one
+// frame's full sample tree for the requested modules; deeper than the existing
+// per-module profiler_get_* stats. Read-only; pairs with the existing profiler
+// session family.
+import { profilerCaptureFrame } from "./profiler-capture-frame.js";
 import { readConsole } from "./read-console.js";
 import { profilerCapture } from "./profiler-capture.js";
 import { profilerMemory } from "./profiler-memory.js";
@@ -39,9 +50,9 @@ import { listRules } from "./list-rules.js";
 import { pullEvents } from "./pull-events.js";
 import { readCompileErrors } from "./read-compile-errors.js";
 import { bridgeStatus } from "./bridge-status.js";
-// M18 Plan 2 / T18.2.2 — Coplay-style manage_tools meta-tool (session
-// tool-group visibility). Server-only meta-tool; routes local, always
-// visible regardless of which groups the current session has activated.
+// M18 Plan 2 / T18.2.2 — manage_tools meta-tool (per-session tool-group
+// visibility). Server-only meta-tool; routes local, always visible regardless
+// of which groups the current session has activated.
 import { manageTools } from "./manage-tools.js";
 // M16 Plan 1 — typed project & asset management tools.
 import { assetsCreateFolder } from "./assets-create-folder.js";
@@ -89,11 +100,14 @@ import { sceneListOpened } from "./scene-list-opened.js";
 import { sceneGetData } from "./scene-get-data.js";
 import { sceneGetDirtySummary } from "./scene-get-dirty-summary.js";
 import { sceneFocus } from "./scene-focus.js";
+import { sceneviewGetCamera } from "./sceneview-get-camera.js";
+import { sceneviewSetCamera } from "./sceneview-set-camera.js";
 // M16 Plan 4 — typed Package Manager tools.
 import { packageList } from "./package-list.js";
 import { packageSearch } from "./package-search.js";
 import { packageAdd } from "./package-add.js";
 import { packageRemove } from "./package-remove.js";
+import { reimportPackage } from "./reimport-package.js";
 import { packageGetInfo } from "./package-get-info.js";
 import { packageGetDependencies } from "./package-get-dependencies.js";
 import { packageCheck } from "./package-check.js";
@@ -105,6 +119,8 @@ import { selectionGet } from "./selection-get.js";
 import { selectionSet } from "./selection-set.js";
 import { editorUndo } from "./editor-undo.js";
 import { editorRedo } from "./editor-redo.js";
+import { editorUndoHistory } from "./editor-undo-history.js";
+import { editorClearHistory } from "./editor-clear-history.js";
 import { editorGetTags } from "./editor-get-tags.js";
 import { editorGetLayers } from "./editor-get-layers.js";
 import { editorAddTag } from "./editor-add-tag.js";
@@ -116,6 +132,18 @@ import { scriptWrite } from "./script-write.js";
 import { scriptDelete } from "./script-delete.js";
 import { objectGetData } from "./object-get-data.js";
 import { objectModify } from "./object-modify.js";
+// M20 Plan 5 / T20.5 — typed ScriptableObject + Assembly Definition tools.
+// scriptableobject_create is a mutating create path (EditorSettle); the read/
+// info surface stays on object_get_data / object_modify. list_assets_of_type is
+// a read-only typed list-by-type. The asmdef family (list/get/create/modify)
+// closes the asmdef parity gap: list/get are read-only; create/modify use the
+// RestartThenSettle lifecycle (a recompile + domain reload follows).
+import { scriptableObjectCreate } from "./scriptableobject-create.js";
+import { listAssetsOfType } from "./list-assets-of-type.js";
+import { asmdefList } from "./asmdef-list.js";
+import { asmdefGet } from "./asmdef-get.js";
+import { asmdefCreate } from "./asmdef-create.js";
+import { asmdefModify } from "./asmdef-modify.js";
 // M16 Plan 7 — typed profiler session / diagnostics tools.
 import { profilerStart } from "./profiler-start.js";
 import { profilerStop } from "./profiler-stop.js";
@@ -149,6 +177,27 @@ import { settingsGetPhysics } from "./settings-get-physics.js";
 import { settingsSetPhysics } from "./settings-set-physics.js";
 import { settingsGetLighting } from "./settings-get-lighting.js";
 import { settingsSetLighting } from "./settings-set-lighting.js";
+// M20 Plan 9 / T20.9.2 — KV preferences (PlayerPrefs + EditorPrefs). Mutating
+// members (set / delete) write to the registry / Library/PlayerPreferences, NOT
+// to project assets — they route as gate-free direct-response tools like
+// editor_undo (the catalog/toggle still marks them mutating). playerprefs_set
+// calls PlayerPrefs.Save(); EditorPrefs writes through immediately.
+// playerprefs_delete_all is deliberately omitted (irreversible wipe — route
+// through execute_csharp with an explicit confirm).
+import { playerprefsGet } from "./playerprefs-get.js";
+import { playerprefsSet } from "./playerprefs-set.js";
+import { playerprefsDelete } from "./playerprefs-delete.js";
+import { editorprefsGet } from "./editorprefs-get.js";
+import { editorprefsSet } from "./editorprefs-set.js";
+import { editorprefsDelete } from "./editorprefs-delete.js";
+// M20 Plan 9 / T20.9.3 — Project Settings remainder. set_time +
+// set_quality_level write ProjectSettings/*.asset (full gate path); get_time +
+// get_render_pipeline are read-only. get_render_pipeline has no setter —
+// switching SRP is a package-level operation.
+import { settingsGetTime } from "./settings-get-time.js";
+import { settingsSetTime } from "./settings-set-time.js";
+import { settingsGetRenderPipeline } from "./settings-get-render-pipeline.js";
+import { settingsSetQualityLevel } from "./settings-set-quality-level.js";
 // M16 Plan 10 / T6.6.2 — Navigation (NavMesh) extension tools. Each tool is
 // gated on the `com.alexeyperov.unity-open-mcp-ext-navigation` extension pack
 // being installed in the target project; the tool definitions live in core so
@@ -210,6 +259,203 @@ import { splinesSetTangentMode } from "./splines-set-tangent-mode.js";
 import { splinesEvaluate } from "./splines-evaluate.js";
 import { splinesGetKnots } from "./splines-get-knots.js";
 import { splinesModify } from "./splines-modify.js";
+// M20 Plan 2 / T20.2 — Lighting domain tools. Built-in lighting module (Light /
+// ReflectionProbe / RenderSettings / Lightmapping) — ungated in the bridge (no
+// UNITY_OPEN_MCP_EXT_LIGHTING define), always compiled. The `lighting` group is
+// hidden from ListTools until the session activates it via manage_tools.
+// Mutating members (light_add / light_set / light_modify /
+// reflection_probe_bake / skybox_set) run the full gate path with paths_hint
+// scoped to the host scene path (skybox_set dirties the active scene).
+// reflection_probe_bake is the long mutation — EditorSettle so the dispatcher
+// waits for the bake + asset refresh before returning. Read-only members
+// (reflection_probe_get / skybox_get) are gate-free.
+import { lightAdd } from "./light-add.js";
+import { lightSet } from "./light-set.js";
+import { lightModify } from "./light-modify.js";
+import { reflectionProbeBake } from "./reflection-probe-bake.js";
+import { reflectionProbeGet } from "./reflection-probe-get.js";
+import { skyboxSet } from "./skybox-set.js";
+import { skyboxGet } from "./skybox-get.js";
+// M20 Plan 3 / T20.3.1 — Audio domain tools. Built-in audio module (AudioSource /
+// AudioListener / AudioMixer / AudioMixerGroup from UnityEngine.AudioModule) —
+// ungated in the bridge (no UNITY_OPEN_MCP_EXT_AUDIO define), always compiled.
+// The `audio` group is hidden from ListTools until the session activates it via
+// manage_tools. Mutating members (audio_source_add / audio_source_modify /
+// audio_mixer_set_parameter) run the full gate path with paths_hint scoped to
+// the host scene path (or the mixer asset path for audio_mixer_set_parameter).
+// Read-only members (audio_listener_get / audio_mixer_get_parameter) are
+// gate-free. The mixer-parameter round-trip (set then read-back) is the
+// documented advantage — a source-only audio tool touches per-source settings
+// only, while this set also reads/writes exposed AudioMixer float parameters.
+import { audioSourceAdd } from "./audio-source-add.js";
+import { audioSourceModify } from "./audio-source-modify.js";
+import { audioMixerSetParameter } from "./audio-mixer-set-parameter.js";
+import { audioListenerGet } from "./audio-listener-get.js";
+import { audioMixerGetParameter } from "./audio-mixer-get-parameter.js";
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tools. Built-in UI module (Canvas /
+// CanvasScaler / GraphicRaycaster / Image / Text / Button / Slider / Toggle /
+// InputField / layout groups / EventSystem from UnityEngine.UI +
+// UnityEngine.EventSystems) — ungated in the bridge (no UNITY_OPEN_MCP_EXT_UI
+// define), always compiled. TextMesh Pro (TMP_Text) is OPTIONAL and detected
+// at call time via reflection — when an agent requests element_type=TMP_Text
+// and TMP is absent, the tool returns `tmp_package_required` (no silent
+// legacy-Text fallback). The `ui` group is hidden from ListTools until the
+// session activates it via manage_tools. All four members (ui_canvas_add /
+// ui_element_add / ui_layout_group_add / ui_element_modify) run the full gate
+// path with paths_hint scoped to the host / new-root / parent scene path. The
+// Canvas-companion ensure (CanvasScaler + GraphicRaycaster + EventSystem) is
+// the documented advantage — a canvas-only tool creates the Canvas alone.
+import { uiCanvasAdd } from "./ui-canvas-add.js";
+import { uiElementAdd } from "./ui-element-add.js";
+import { uiLayoutGroupAdd } from "./ui-layout-group-add.js";
+import { uiElementModify } from "./ui-element-modify.js";
+// M20 Plan 3 / T20.3.3 — Constraints & LOD domain tools. Built-in engine
+// modules (UnityEngine.AnimationModule for the constraint components,
+// UnityEngine.CoreModule for LODGroup) — ungated in the bridge (no
+// UNITY_OPEN_MCP_EXT_CONSTRAINTS define), always compiled. The `constraints`
+// group is hidden from ListTools until the session activates it via
+// manage_tools. All three members (constraint_add / lod_group_configure /
+// lod_add_level) are mutating and run the full gate path with paths_hint
+// scoped to the host scene path. The gate + paths_hint contract on every
+// mutating member is the documented advantage.
+import { constraintAdd } from "./constraint-add.js";
+import { lodGroupConfigure } from "./lod-group-configure.js";
+import { lodAddLevel } from "./lod-add-level.js";
+// M20 Plan 4 / T20.4 — Terrain domain tools. Built-in Terrain module (Terrain
+// / TerrainData / TreePrototype / TerrainLayer) — ungated in the bridge (no
+// UNITY_OPEN_MCP_EXT_TERRAIN define), always compiled. The `terrain` group is
+// hidden from ListTools until the session activates it via manage_tools. All
+// five members (terrain_create / terrain_set_heights / terrain_paint_layer /
+// terrain_place_trees / terrain_set_neighbors) are mutating and run the full
+// gate path with paths_hint scoped to the host scene path (+ the asset path
+// for terrain_create's TerrainData .asset and terrain_paint_layer's new
+// TerrainLayer .terrainlayer). Closes the Terrain parity gap; the
+// large-array cap + tiling hint and the gate + paths_hint contract on every
+// mutating member are the documented advantages.
+import { terrainCreate } from "./terrain-create.js";
+import { terrainSetHeights } from "./terrain-set-heights.js";
+import { terrainPaintLayer } from "./terrain-paint-layer.js";
+import { terrainPlaceTrees } from "./terrain-place-trees.js";
+import { terrainSetNeighbors } from "./terrain-set-neighbors.js";
+// M20 Plan 6 / T20.6.1 — Cinemachine extension tools. The only
+// reflection-gated domain pack in the bridge: the assembly always compiles
+// (no UNITY_OPEN_MCP_EXT_CINEMACHINE compile gate), and Cinemachine 3.x
+// presence is detected at call time via the CinemachineVersion reflection
+// layer. When 3.x is absent (package missing OR Cinemachine 2.x installed),
+// the tools return a clear install/upgrade error envelope. Six mutating
+// members (create_camera / set_targets / set_lens / set_body / set_noise /
+// brain_ensure) run the full gate path with paths_hint scoped to the host
+// scene path (create_camera adds a new GameObject to the active scene). One
+// read-only member (camera_list) is gate-free.
+import { cinemachineCreateCamera } from "./cinemachine-create-camera.js";
+import { cinemachineSetTargets } from "./cinemachine-set-targets.js";
+import { cinemachineSetLens } from "./cinemachine-set-lens.js";
+import { cinemachineSetBody } from "./cinemachine-set-body.js";
+import { cinemachineSetNoise } from "./cinemachine-set-noise.js";
+import { cinemachineBrainEnsure } from "./cinemachine-brain-ensure.js";
+import { cinemachineCameraList } from "./cinemachine-camera-list.js";
+// M20 Plan 6 / T20.6.2 — Timeline extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_TIMELINE on com.unity.timeline). All five
+// members (create / track_add / clip_add / director_bind / modify) are
+// mutating and run the full gate path. create produces a .playable asset;
+// director_bind mutates a scene PlayableDirector; modify is a reflective
+// field-patch escape hatch. The gate + paths_hint contract on every mutating
+// member is the documented advantage.
+import { timelineCreate } from "./timeline-create.js";
+import { timelineTrackAdd } from "./timeline-track-add.js";
+import { timelineClipAdd } from "./timeline-clip-add.js";
+import { timelineDirectorBind } from "./timeline-director-bind.js";
+import { timelineModify } from "./timeline-modify.js";
+// M20 Plan 6 / T20.6.3 — Tilemap extension tools. Compile-gated in the
+// bridge by UNITY_OPEN_MCP_EXT_TILEMAP (com.unity.2d.tilemap), with an inner
+// UNITY_OPEN_MCP_EXT_TILEMAP_EXTRAS guard around create_rule_tile's body —
+// when tilemap.extras is absent, the tool compiles in but returns a clear
+// tilemap_extras_required install error (two defines, two guards). All five
+// members (create / set_tile / box_fill / create_tile_asset /
+// create_rule_tile) are mutating and run the full gate path.
+import { tilemapCreate } from "./tilemap-create.js";
+import { tilemapSetTile } from "./tilemap-set-tile.js";
+import { tilemapBoxFill } from "./tilemap-box-fill.js";
+import { tilemapCreateTileAsset } from "./tilemap-create-tile-asset.js";
+import { tilemapCreateRuleTile } from "./tilemap-create-rule-tile.js";
+// M20 Plan 7 / T20.7.1 — Shader Graph extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_SHADERGRAPH on com.unity.shadergraph) AND
+// auto-activating — the first domain to ship with package-detection auto-
+// activation (M20 Plan 7 / T20.7.0): the `shadergraph` group activates for
+// the session automatically when com.unity.shadergraph is installed, no
+// manual manage_tools call. Three mutating members (create / node_add /
+// node_connect) run the full gate path with paths_hint scoped to the
+// .shadergraph asset path; open is a read-only window bring-up (Gate = Off)
+// that returns a structured node/edge summary. The editing API is wrapped
+// behind a reflection helper (ShaderGraphApi) — when the installed package
+// version exposes a different surface, mutating tools return a structured
+// shadergraph_api_unavailable error instead of throwing. Complementary to
+// the inspect surface (shader_get_data / shader_list_all).
+import { shaderGraphCreate } from "./shader-graph-create.js";
+import { shaderGraphOpen } from "./shader-graph-open.js";
+import { shaderGraphNodeAdd } from "./shader-graph-node-add.js";
+import { shaderGraphNodeConnect } from "./shader-graph-node-connect.js";
+// M20 Plan 7 / T20.7.2 — VFX Graph extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_VFX on com.unity.visualeffectgraph) AND auto-
+// activating — the second domain under the package-detection auto-activation
+// model (M20 Plan 7 / T20.7.0): the `vfx` group activates for the session
+// automatically when com.unity.visualeffectgraph is installed, no manual
+// manage_tools call. list / open are read-only (Gate = Off) returning a
+// structured context/block/property summary; block_edit is the lone mutating
+// member (Gate = Enforce, paths_hint = .vfx asset path). VFX Graph's editor
+// graph model is internal/unstable — the read paths work over the public
+// runtime VisualEffectAsset type and the serialized file format (version-
+// stable); block_edit reflects over the editor graph and requires the VFX
+// Graph window to be open, degrading to a structured
+// vfx_block_edit_requires_editor_window error otherwise.
+import { vfxList } from "./vfx-list.js";
+import { vfxOpen } from "./vfx-open.js";
+import { vfxBlockEdit } from "./vfx-block-edit.js";
+// M20 Plan 7 / T20.7.3 — Memory Profiler snapshot capture. Compile-gated in
+// the bridge (UNITY_OPEN_MCP_EXT_MEMORYPROFILER on com.unity.memoryprofiler) +
+// auto-activating — the third domain under the package-detection auto-activation
+// model (M20 Plan 7 / T20.7.0): the `memoryprofiler` group activates for the
+// session automatically when com.unity.memoryprofiler is installed. Sense-
+// prefixed (unity_senses_*) because it pairs with the existing senses profiler
+// family rather than the typed-editor surface. Read-only re: game/project state
+// but produces a .snap file — Gate = Off, ReadOnlyHint = true, Lifecycle =
+// EditorSettle. The capture is callback-based; the bridge blocks until the
+// callback fires. Pairs with profiler_get_script_stats / profiler_capture_frame
+// for a fuller performance picture than a standalone memory tool.
+import { memorySnapshotCapture } from "./memory-snapshot-capture.js";
+// M20 Plan 9 / T20.9.1 — 2D art pipeline: SpriteAtlas + Texture import domain
+// tools. Built-in 2D module (SpriteAtlas / SpriteAtlasAsset /
+// SpriteAtlasPackingSettings / SpriteAtlasTextureSettings in UnityEngine.U2D /
+// UnityEditor.U2D + TextureImporter in UnityEditor) — ungated in the bridge
+// (no UNITY_OPEN_MCP_EXT_2D define), always compiled. The `2d` group is hidden
+// from ListTools until the session activates it via manage_tools. Two prefixes
+// share one group: spriteatlas_* (create/get/add_packable/remove_packable/
+// modify/delete/list) and texture_* (get_importer/set_import/reimport/get).
+// Mutating members (spriteatlas_create/add_packable/remove_packable/modify/
+// delete + texture_set_import/reimport) run the full gate path with
+// EditorSettle (the .spriteatlas asset is written/reimported; texture
+// reimports can take seconds and may trigger a platform-switch domain reload)
+// and paths_hint scoped to the asset path. Read-only members (spriteatlas_get/
+// list + texture_get_importer/get) are gate-free. spriteatlas_set_import folds
+// sprite + normal-map presets into one structured settings_json patch instead
+// of separate set_sprite / set_normalmap tools (cleaner, fewer IDs).
+import { spriteatlasCreate } from "./spriteatlas-create.js";
+import { spriteatlasGet } from "./spriteatlas-get.js";
+import { spriteatlasAddPackable } from "./spriteatlas-add-packable.js";
+import { spriteatlasRemovePackable } from "./spriteatlas-remove-packable.js";
+import { spriteatlasModify } from "./spriteatlas-modify.js";
+import { spriteatlasDelete } from "./spriteatlas-delete.js";
+import { spriteatlasList } from "./spriteatlas-list.js";
+import { textureGetImporter } from "./texture-get-importer.js";
+import { textureSetImport } from "./texture-set-import.js";
+import { textureReimport } from "./texture-reimport.js";
+import { textureGet } from "./texture-get.js";
+import { hubListEditors } from "./hub-list-editors.js";
+import { hubAvailableReleases } from "./hub-available-releases.js";
+import { hubInstallEditor } from "./hub-install-editor.js";
+import { hubInstallModules } from "./hub-install-modules.js";
+import { hubGetInstallPath } from "./hub-get-install-path.js";
+import { hubSetInstallPath } from "./hub-set-install-path.js";
 export const M2_TOOLS = [
     ping,
     executeCsharp,
@@ -219,7 +465,7 @@ export const M2_TOOLS = [
     compileCheck,
 ];
 export const M2_5_TOOLS = [editorStatus];
-export const M3_TOOLS = [validateEdit, checkpointCreate, delta, findReferences, scanPaths, applyFix];
+export const M3_TOOLS = [validateEdit, checkpointCreate, delta, findReferences, dependencies, scanPaths, applyFix];
 export const M5_TOOLS = [scanAll, baselineCreate, regressionCheck];
 export const M9_TOOLS = [reserialize, readAsset, searchAssets, listAssets];
 export const M10_TOOLS = [
@@ -242,10 +488,19 @@ export const M10_TOOLS = [
 //
 // M20 Plan 1 / T20.1.2 adds screenshot_window (EditorWindow capture; Win-only
 // full-fidelity, cross-platform best-effort readback with platformLimited).
+//
+// M20 Plan 1 / T20.1.3 adds frame_debugger (reflection over Unity's internal
+// Frame Debugger — enable/disable/list draw calls; non-mutating Editor state,
+// gate-free).
+//
+// M20 Plan 1 / T20.1.4 adds profiler_capture_frame (single-frame deep profiler
+// capture; returns the sample tree for the requested modules).
 export const M20_PLAN1_TOOLS = [
     screenshotCamera,
     captureInline,
     screenshotWindow,
+    frameDebugger,
+    profilerCaptureFrame,
 ];
 export const M11_TOOLS = [agentCapabilities, generateSkill];
 export const M12_TOOLS = [listRules];
@@ -262,9 +517,9 @@ export const M14_TOOLS = [readCompileErrors];
 // (operators / the Validation Suite reach them; the agent skill does NOT
 // document them in mutate/gate sections). See docs/api/mcp-tools.md.
 export const BRIDGE_ADMIN_TOOLS = [bridgeStatus];
-// M18 Plan 2 / T18.2.2 — Coplay-style manage_tools meta-tool. Server-only,
-// local-routed, and always visible regardless of which groups the current
-// session has activated (see ALWAYS_VISIBLE_TOOLS in tool-session-state.ts).
+// M18 Plan 2 / T18.2.2 — manage_tools meta-tool. Server-only, local-routed,
+// and always visible regardless of which groups the current session has
+// activated (see ALWAYS_VISIBLE_TOOLS in tool-session-state.ts).
 export const M18_PLAN2_TOOLS = [manageTools];
 // M16 Plan 1 — Project & Asset Management typed tools. Mutating members run
 // the full gate path with `paths_hint`; read-only members (shader reads,
@@ -325,6 +580,9 @@ export const M16_PLAN3_TOOLS = [
     sceneGetData,
     sceneGetDirtySummary,
     sceneFocus,
+    // M20 Plan 9 / T20.9.4 — SceneView camera pose-level tools.
+    sceneviewGetCamera,
+    sceneviewSetCamera,
 ];
 // M16 Plan 4 — Package Manager typed tools. Mutating members (add / remove)
 // run the full gate path with `paths_hint` = ["Packages/manifest.json"] and
@@ -337,6 +595,7 @@ export const M16_PLAN4_TOOLS = [
     packageSearch,
     packageAdd,
     packageRemove,
+    reimportPackage,
     packageGetInfo,
     packageGetDependencies,
     packageCheck,
@@ -357,6 +616,9 @@ export const M16_PLAN5_TOOLS = [
     selectionSet,
     editorUndo,
     editorRedo,
+    // M20 Plan 9 / T20.9.4 — undo stack read/reset tools.
+    editorUndoHistory,
+    editorClearHistory,
     editorGetTags,
     editorGetLayers,
     editorAddTag,
@@ -439,6 +701,22 @@ export const M16_PLAN9_TOOLS = [
     settingsSetPhysics,
     settingsGetLighting,
     settingsSetLighting,
+    // M20 Plan 9 / T20.9.2 — KV preferences. PlayerPrefs + EditorPrefs share the
+    // build-settings group (project configuration surface). set / delete are
+    // mutating but gate-free (registry writes — no asset scope).
+    playerprefsGet,
+    playerprefsSet,
+    playerprefsDelete,
+    editorprefsGet,
+    editorprefsSet,
+    editorprefsDelete,
+    // M20 Plan 9 / T20.9.3 — Project Settings remainder. set_time /
+    // set_quality_level run the gate (ProjectSettings asset writes);
+    // get_time / get_render_pipeline are gate-free.
+    settingsGetTime,
+    settingsSetTime,
+    settingsGetRenderPipeline,
+    settingsSetQualityLevel,
 ];
 // M16 Plan 10 / T6.6.2 — Navigation (NavMesh) extension tools. Extension pack
 // tools ship their tool definitions in the core MCP server (so capabilities
@@ -448,8 +726,7 @@ export const M16_PLAN9_TOOLS = [
 // modifier_add / modifier_volume_add / link_add / agent_add /
 // agent_set_destination / modify) run the full gate path with paths_hint
 // scoped to the host scene path; surface_bake is the heavy op (EditorSettle).
-// Read-only members (list / get) are gate-free. The eleven tools mirror the
-// kebab `navigation-*` ids in the upstream Unity-MCP reference pack.
+// Read-only members (list / get) are gate-free.
 export const M16_PLAN10_TOOLS = [
     navigationSurfaceAdd,
     navigationSetBakeSettings,
@@ -470,8 +747,7 @@ export const M16_PLAN10_TOOLS = [
 // mutating members (asset_create / actionmap_add / action_add / binding_add /
 // binding_composite_add / controlscheme_add) run the full gate path with
 // paths_hint scoped to the .inputactions asset; the read-only member (get) is
-// gate-free. The seven tools mirror the kebab `inputsystem-*` ids in the
-// upstream Unity-MCP reference pack.
+// gate-free.
 export const M16_PLAN10_INPUTSYSTEM_TOOLS = [
     inputsystemAssetCreate,
     inputsystemActionmapAdd,
@@ -487,8 +763,7 @@ export const M16_PLAN10_INPUTSYSTEM_TOOLS = [
 // new GameObject to the active scene); delete_faces is the lone DESTRUCTIVE
 // tool. The read-only member (get_mesh_info) is gate-free. Face selection is
 // index-based or semantic (Up / Down / Left / Right / Forward / Back) — never
-// SceneView mouse picking. The five tools mirror the kebab `probuilder-*` ids
-// in the upstream Unity-MCP reference pack.
+// SceneView mouse picking.
 export const M16_PLAN10_PROBUILDER_TOOLS = [
     probuilderCreateShape,
     probuilderGetMeshInfo,
@@ -499,11 +774,10 @@ export const M16_PLAN10_PROBUILDER_TOOLS = [
 // M16 Plan 10 / T6.6.9 — Particle System extension tools. The lone mutator
 // (particle_system_modify) runs the full gate path with paths_hint scoped to
 // the host scene path; the read-only member (particle_system_get) is gate-free.
-// The two tools mirror the kebab `particle-system-*` ids in the upstream
-// Unity-MCP reference pack. modify uses a per-module field-patch surface
-// (module discriminator + fields_json) instead of the opaque ReflectorNet
-// SerializedMember payload — agents get up-front field-name validation and a
-// structured unknownFields report instead of guessing.
+// modify uses a per-module field-patch surface (module discriminator +
+// fields_json) instead of an opaque reflective SerializedMember payload —
+// agents get up-front field-name validation and a structured unknownFields
+// report instead of guessing.
 export const M16_PLAN10_PARTICLESYSTEM_TOOLS = [
     particleSystemGet,
     particleSystemModify,
@@ -513,10 +787,9 @@ export const M16_PLAN10_PARTICLESYSTEM_TOOLS = [
 // animator_create / animator_modify) run the full gate path with paths_hint
 // scoped to the asset path (.anim or .controller); the two modify tools are
 // DESTRUCTIVE — some modification types are irreversible without undo. Read-
-// only members (animation_get_data / animator_get_data) are gate-free. The six
-// tools mirror the kebab `animation-*` / `animator-*` ids in the upstream
-// Unity-MCP reference pack. modify accepts a JSON array of modification
-// entries dispatched by `type`; per-entry errors are accumulated, not thrown.
+// only members (animation_get_data / animator_get_data) are gate-free. modify
+// accepts a JSON array of modification entries dispatched by `type`; per-entry
+// errors are accumulated, not thrown.
 export const M16_PLAN10_ANIMATION_TOOLS = [
     animationCreate,
     animationGetData,
@@ -532,8 +805,6 @@ export const M16_PLAN10_ANIMATION_TOOLS = [
 // set_knot / set_tangent_mode / modify) run the full gate path with paths_hint
 // scoped to the host scene path (container_create adds a new GameObject to the
 // active scene). Two read-only members (evaluate / get_knots) are gate-free.
-// The seven tools mirror the kebab `splines-*` ids in the upstream
-// Unity-AI-Splines reference pack.
 export const M18_PLAN7_SPLINES_TOOLS = [
     splinesContainerCreate,
     splinesAddKnot,
@@ -543,6 +814,231 @@ export const M18_PLAN7_SPLINES_TOOLS = [
     splinesGetKnots,
     splinesModify,
 ];
+// M20 Plan 2 / T20.2 — Lighting domain tools. Built-in lighting module —
+// ungated in the bridge (always compiled). Five mutating members (light_add /
+// light_set / light_modify / reflection_probe_bake / skybox_set) run the full
+// gate path with paths_hint scoped to the host scene path. The bake is the
+// long mutation (EditorSettle). Two read-only members (reflection_probe_get /
+// skybox_get) are gate-free.
+export const M20_PLAN2_LIGHTING_TOOLS = [
+    lightAdd,
+    lightSet,
+    lightModify,
+    reflectionProbeBake,
+    reflectionProbeGet,
+    skyboxSet,
+    skyboxGet,
+];
+// M20 Plan 3 / T20.3.1 — Audio domain tools. Built-in audio module — ungated
+// in the bridge (always compiled). Three mutating members (audio_source_add /
+// audio_source_modify / audio_mixer_set_parameter) run the full gate path with
+// paths_hint scoped to the host scene path (audio_source_*) or the mixer asset
+// path (audio_mixer_set_parameter). Two read-only members (audio_listener_get /
+// audio_mixer_get_parameter) are gate-free.
+export const M20_PLAN3_AUDIO_TOOLS = [
+    audioSourceAdd,
+    audioSourceModify,
+    audioMixerSetParameter,
+    audioListenerGet,
+    audioMixerGetParameter,
+];
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tools. Built-in UI module — ungated
+// in the bridge (always compiled). Four mutating members (ui_canvas_add /
+// ui_element_add / ui_layout_group_add / ui_element_modify) run the full gate
+// path with paths_hint scoped to the host / new-root / parent scene path.
+// TextMesh Pro (TMP_Text) is optional — when absent, ui_element_add returns
+// `tmp_package_required` (no silent legacy-Text fallback). The Canvas-companion
+// ensure (CanvasScaler + GraphicRaycaster + EventSystem) is the documented
+// advantage — a canvas-only tool creates the Canvas alone.
+export const M20_PLAN3_UI_TOOLS = [
+    uiCanvasAdd,
+    uiElementAdd,
+    uiLayoutGroupAdd,
+    uiElementModify,
+];
+// M20 Plan 3 / T20.3.3 — Constraints & LOD domain tools. Built-in engine
+// modules — ungated in the bridge (always compiled). Three mutating members
+// (constraint_add / lod_group_configure / lod_add_level) run the full gate
+// path with paths_hint scoped to the host scene path. constraint_add seeds an
+// optional source Transform + weight + activation; lod_group_configure
+// allocates the LOD array; lod_add_level wires renderers per level. One
+// `constraints` group covers both concerns because they are small and closely
+// related.
+export const M20_PLAN3_CONSTRAINTS_TOOLS = [
+    constraintAdd,
+    lodGroupConfigure,
+    lodAddLevel,
+];
+// M20 Plan 4 / T20.4 — Terrain domain tools. Built-in Terrain module —
+// ungated in the bridge (always compiled). Five mutating members
+// (terrain_create / terrain_set_heights / terrain_paint_layer /
+// terrain_place_trees / terrain_set_neighbors) run the full gate path with
+// paths_hint scoped to the host scene path (+ asset paths when
+// terrain_create / terrain_paint_layer write assets). terrain_create allocates
+// TerrainData + a Terrain GameObject; terrain_set_heights writes a heightmap
+// region (cap 513x513 per call); terrain_paint_layer paints a splat layer
+// (seeding a new TerrainLayer when the index is new); terrain_place_trees
+// places tree instances (seeding a prototype from a prefab when the index is
+// new); terrain_set_neighbors stitches neighbor terrains for LOD. Absorbs
+// backlog T6.6.7.
+export const M20_PLAN4_TERRAIN_TOOLS = [
+    terrainCreate,
+    terrainSetHeights,
+    terrainPaintLayer,
+    terrainPlaceTrees,
+    terrainSetNeighbors,
+];
+// M20 Plan 5 / T20.5 — typed ScriptableObject + Assembly Definition tools. Two
+// core (always-on, no Unity package dependency) tool sets for ScriptableObject
+// CRUD (§B7) and Assembly Definitions (§B8). scriptableobject_create is the
+// gate-integrated create path (the read/info surface stays on object_get_data /
+// object_modify); it applies optional initial field patches reusing
+// object_modify's value vocabulary. list_assets_of_type is a read-only typed
+// list-by-type (offline-routeable in principle). The asmdef family parses
+// .asmdef as JSON (hand-rolled reader/writer — no Newtonsoft, per the bridge
+// AGENTS.md): list/get are read-only (offline-routeable); create/modify use
+// the RestartThenSettle lifecycle so the gate waits for the recompile to
+// settle (the advantage over an ungated asmdef mutator).
+export const M20_PLAN5_TOOLS = [
+    scriptableObjectCreate,
+    listAssetsOfType,
+    asmdefList,
+    asmdefGet,
+    asmdefCreate,
+    asmdefModify,
+];
+// M20 Plan 6 / T20.6.1 — Cinemachine extension tools. The only reflection-
+// gated domain pack in the bridge (the assembly always compiles; Cinemachine
+// 3.x presence is detected at call time). Six mutating members
+// (create_camera / set_targets / set_lens / set_body / set_noise /
+// brain_ensure) run the full gate path with paths_hint scoped to the host
+// scene path (create_camera adds a new GameObject to the active scene). One
+// read-only member (camera_list) is gate-free. The canonical reflection case
+// named in M18 Plan 1 T18.1.1 task 5 (version-split API trigger).
+export const M20_PLAN6_CINEMACHINE_TOOLS = [
+    cinemachineCreateCamera,
+    cinemachineSetTargets,
+    cinemachineSetLens,
+    cinemachineSetBody,
+    cinemachineSetNoise,
+    cinemachineBrainEnsure,
+    cinemachineCameraList,
+];
+// M20 Plan 6 / T20.6.2 — Timeline extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_TIMELINE on com.unity.timeline). All five
+// members (create / track_add / clip_add / director_bind / modify) are
+// mutating and run the full gate path. create produces a .playable asset;
+// director_bind mutates a scene PlayableDirector; modify is a reflective
+// field-patch escape hatch.
+export const M20_PLAN6_TIMELINE_TOOLS = [
+    timelineCreate,
+    timelineTrackAdd,
+    timelineClipAdd,
+    timelineDirectorBind,
+    timelineModify,
+];
+// M20 Plan 6 / T20.6.3 — Tilemap extension tools. Compile-gated in the
+// bridge by UNITY_OPEN_MCP_EXT_TILEMAP (com.unity.2d.tilemap), with an inner
+// UNITY_OPEN_MCP_EXT_TILEMAP_EXTRAS guard around create_rule_tile's body
+// (when tilemap.extras is absent, the tool compiles in but returns a clear
+// tilemap_extras_required install error — two defines, two guards). All five
+// members (create / set_tile / box_fill / create_tile_asset /
+// create_rule_tile) are mutating and run the full gate path.
+export const M20_PLAN6_TILEMAP_TOOLS = [
+    tilemapCreate,
+    tilemapSetTile,
+    tilemapBoxFill,
+    tilemapCreateTileAsset,
+    tilemapCreateRuleTile,
+];
+// M20 Plan 7 / T20.7.1 — Shader Graph extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_SHADERGRAPH on com.unity.shadergraph) AND auto-
+// activating — the first domain under the package-detection auto-activation
+// model (M20 Plan 7 / T20.7.0). Three mutating members (create / node_add /
+// node_connect) run the full gate path with paths_hint scoped to the
+// .shadergraph asset path; open is a read-only window bring-up (Gate = Off)
+// returning a structured node/edge summary. The editing API is wrapped behind
+// a reflection helper; when the installed package version exposes a different
+// surface, mutating tools return a structured shadergraph_api_unavailable
+// error instead of throwing. Complementary to shader_get_data / shader_list_all
+// (which read compiled shader properties, not the graph).
+export const M20_PLAN7_SHADERGRAPH_TOOLS = [
+    shaderGraphCreate,
+    shaderGraphOpen,
+    shaderGraphNodeAdd,
+    shaderGraphNodeConnect,
+];
+// M20 Plan 7 / T20.7.2 — VFX Graph extension tools. Compile-gated in the
+// bridge (UNITY_OPEN_MCP_EXT_VFX on com.unity.visualeffectgraph) AND auto-
+// activating — the second domain under the package-detection auto-activation
+// model (M20 Plan 7 / T20.7.0). list / open are read-only (Gate = Off) returning
+// a structured context/block/property summary; block_edit is the lone mutating
+// member (Gate = Enforce, paths_hint = .vfx asset path). VFX Graph's editor
+// graph model is internal/unstable — list/open work over the public runtime
+// VisualEffectAsset type (version-stable); block_edit reflects over the editor
+// graph and requires the VFX Graph window to be open, degrading to a structured
+// vfx_block_edit_requires_editor_window error otherwise.
+export const M20_PLAN7_VFX_TOOLS = [
+    vfxList,
+    vfxOpen,
+    vfxBlockEdit,
+];
+// M20 Plan 7 / T20.7.3 — Memory Profiler snapshot capture. Compile-gated in
+// the bridge (UNITY_OPEN_MCP_EXT_MEMORYPROFILER on com.unity.memoryprofiler) +
+// auto-activating — the third domain under the package-detection auto-activation
+// model (M20 Plan 7 / T20.7.0). Sense-prefixed (unity_senses_*) because it
+// pairs with the existing senses profiler family rather than the typed-editor
+// surface. Read-only re: game/project state but produces a .snap file —
+// Gate = Off, ReadOnlyHint = true, Lifecycle = EditorSettle. The capture is
+// callback-based (async); the bridge reflects over whichever capture surface
+// the installed version exposes (Unity.Profiling.Memory.MemoryProfiler or
+// UnityEditor.MemoryProfiler) and blocks until the callback fires, so the tool
+// returns a definitive path/result. Pairs with profiler_get_script_stats /
+// profiler_capture_frame for a fuller performance picture than a standalone
+// memory tool.
+export const M20_PLAN7_MEMORYPROFILER_TOOLS = [
+    memorySnapshotCapture,
+];
+// M20 Plan 9 / T20.9.1 — 2D art pipeline (SpriteAtlas + Texture import) domain
+// tools. Built-in 2D module — ungated in the bridge (always compiled). Seven
+// spriteatlas_* members + four texture_* members share one `2d` group. Five
+// mutating spriteatlas members (create / add_packable / remove_packable /
+// modify / delete) run the full gate path with EditorSettle and paths_hint
+// scoped to the .spriteatlas asset path; spriteatlas_delete is destructive.
+// Two mutating texture members (set_import / reimport) run the full gate path
+// with EditorSettle (reimport can take seconds / trigger a platform-switch
+// domain reload); set_import folds sprite + normal-map presets into one
+// structured settings_json patch. Two read-only spriteatlas members (get /
+// list) and two read-only texture members (get_importer / get) are gate-free.
+export const M20_PLAN9_2D_TOOLS = [
+    spriteatlasCreate,
+    spriteatlasGet,
+    spriteatlasAddPackable,
+    spriteatlasRemovePackable,
+    spriteatlasModify,
+    spriteatlasDelete,
+    spriteatlasList,
+    textureGetImporter,
+    textureSetImport,
+    textureReimport,
+    textureGet,
+];
+// M26 Plan 2 — Unity Hub control tools. Local-routed (resolved inside the MCP
+// server: filesystem discovery + Unity archive feed + unityhub:// deep link +
+// Hub CLI). Never hit the Unity bridge or spawn Unity. Read-only members
+// (list_editors, available_releases, get_install_path) are gate-free; mutating
+// members (install_editor, install_modules, set_install_path) are system-level
+// ops where paths_hint is N/A, so they are gate-free too (the gate validates
+// project-asset fallout, which does not apply). Live in the `unity-hub-control`
+// group (activate via manage_tools); not always-visible meta-tools.
+export const M26_PLAN2_HUB_TOOLS = [
+    hubListEditors,
+    hubAvailableReleases,
+    hubInstallEditor,
+    hubInstallModules,
+    hubGetInstallPath,
+    hubSetInstallPath,
+];
 export const ALL_TOOLS = [
     ...M2_TOOLS,
     ...M2_5_TOOLS,
@@ -572,5 +1068,19 @@ export const ALL_TOOLS = [
     ...M16_PLAN10_ANIMATION_TOOLS,
     ...M18_PLAN2_TOOLS,
     ...M18_PLAN7_SPLINES_TOOLS,
+    ...M20_PLAN2_LIGHTING_TOOLS,
+    ...M20_PLAN3_AUDIO_TOOLS,
+    ...M20_PLAN3_UI_TOOLS,
+    ...M20_PLAN3_CONSTRAINTS_TOOLS,
+    ...M20_PLAN4_TERRAIN_TOOLS,
+    ...M20_PLAN5_TOOLS,
+    ...M20_PLAN6_CINEMACHINE_TOOLS,
+    ...M20_PLAN6_TIMELINE_TOOLS,
+    ...M20_PLAN6_TILEMAP_TOOLS,
+    ...M20_PLAN7_SHADERGRAPH_TOOLS,
+    ...M20_PLAN7_VFX_TOOLS,
+    ...M20_PLAN7_MEMORYPROFILER_TOOLS,
+    ...M20_PLAN9_2D_TOOLS,
+    ...M26_PLAN2_HUB_TOOLS,
 ];
 //# sourceMappingURL=index.js.map