unity-open-mcp 0.1.0 → 0.3.0

package/dist/tools/editor-undo.js

@@ -1,7 +1,7 @@
 // M16 Plan 5 — typed editor undo. Mutates editor undo state but writes no
-// assets — routes as a gate-free direct-response tool. Folds UUMCP editor_undo
-// (Undo.PerformUndo). Pair with editor_redo and the undo-recorded typed
-// mutators (gameobject_*, component_*, selection_set, ...).
+// assets — routes as a gate-free direct-response tool (Undo.PerformUndo).
+// Pair with editor_redo and the undo-recorded typed mutators (gameobject_*,
+// component_*, selection_set, ...).
 export const editorUndo = {
     name: "unity_open_mcp_editor_undo",
     description: "Perform an editor Undo — reverts the most recent recorded action (one " +

package/dist/tools/editor-undo.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-undo.js","sourceRoot":"","sources":["../../src/tools/editor-undo.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,+EAA+E;AAC/E,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,wEAAwE;QACxE,qEAAqE;QACrE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,kEAAkE;oBAClE,wBAAwB;aAC3B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"editor-undo.js","sourceRoot":"","sources":["../../src/tools/editor-undo.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,0EAA0E;AAC1E,4EAA4E;AAC5E,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,wEAAwE;QACxE,qEAAqE;QACrE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,kEAAkE;oBAClE,wBAAwB;aAC3B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editorprefs-delete.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const editorprefsDelete: Tool;

package/dist/tools/editorprefs-delete.js

@@ -0,0 +1,23 @@
+// M20 Plan 9 / T20.9.2 — KV preferences. Mutating: delete a single EditorPrefs
+// key. Direct-response (no project-asset write — gate-free). EditorPrefs writes
+// through immediately.
+export const editorprefsDelete = {
+    name: "unity_open_mcp_editorprefs_delete",
+    description: "Mutating: delete a single EditorPrefs key. Returns { existed, deleted } so " +
+        "the caller knows whether the key was present. Writes to the editor registry " +
+        "(NOT a project asset) — a mutating editor-state write that has nothing for " +
+        "the asset gate to validate, so no paths_hint is required. EditorPrefs are " +
+        "editor-scoped — use playerprefs_delete for project-scoped preferences.",
+    inputSchema: {
+        type: "object",
+        required: ["key"],
+        properties: {
+            key: {
+                type: "string",
+                description: "The preference key to delete.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editorprefs-delete.js.map

package/dist/tools/editorprefs-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorprefs-delete.js","sourceRoot":"","sources":["../../src/tools/editorprefs-delete.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,gFAAgF;AAChF,uBAAuB;AACvB,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,6EAA6E;QAC7E,8EAA8E;QAC9E,6EAA6E;QAC7E,4EAA4E;QAC5E,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editorprefs-get.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const editorprefsGet: Tool;

package/dist/tools/editorprefs-get.js

@@ -0,0 +1,28 @@
+// M20 Plan 9 / T20.9.2 — KV preferences. Read-only: get an EditorPrefs value by
+// key. Type (int/float/string) is inferred from the stored value when omitted.
+// Gate-free direct-response read.
+export const editorprefsGet = {
+    name: "unity_open_mcp_editorprefs_get",
+    description: "Read-only: get an EditorPrefs value by key. Returns { store, key, type, " +
+        "value }. When `type` is omitted, the type is inferred from the stored value " +
+        "(probes int → float → string). Gate-free. EditorPrefs are editor-scoped " +
+        "(shared across projects on the machine) — use playerprefs_get for " +
+        "project-scoped player preferences. Mutating counterpart: editorprefs_set.",
+    inputSchema: {
+        type: "object",
+        required: ["key"],
+        properties: {
+            key: {
+                type: "string",
+                description: "The preference key to read.",
+            },
+            type: {
+                enum: ["int", "float", "string"],
+                description: "Optional type hint. When omitted, the type is inferred (int → float " +
+                    "→ string). When present, the value is read as that type.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editorprefs-get.js.map

package/dist/tools/editorprefs-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorprefs-get.js","sourceRoot":"","sources":["../../src/tools/editorprefs-get.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,+EAA+E;AAC/E,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,0EAA0E;QAC1E,8EAA8E;QAC9E,0EAA0E;QAC1E,oEAAoE;QACpE,2EAA2E;IAC7E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;gBAChC,WAAW,EACT,sEAAsE;oBACtE,0DAA0D;aAC7D;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editorprefs-set.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const editorprefsSet: Tool;

package/dist/tools/editorprefs-set.js

@@ -0,0 +1,33 @@
+// M20 Plan 9 / T20.9.2 — KV preferences. Mutating: set an EditorPrefs key.
+// Direct-response (writes to the editor registry, not a project asset —
+// gate-free). EditorPrefs writes through immediately (no Save call needed).
+export const editorprefsSet = {
+    name: "unity_open_mcp_editorprefs_set",
+    description: "Mutating: set an EditorPrefs key to a typed value. EditorPrefs writes " +
+        "through immediately (no Save call). Writes to the editor registry (NOT a " +
+        "project asset) — like editor_undo it is a mutating editor-state write that " +
+        "has nothing for the asset gate to validate, so no paths_hint is required. " +
+        "EditorPrefs are editor-scoped (shared across projects on the machine) — " +
+        "use playerprefs_set for project-scoped player preferences.",
+    inputSchema: {
+        type: "object",
+        required: ["key", "value", "type"],
+        properties: {
+            key: {
+                type: "string",
+                description: "The preference key to write.",
+            },
+            value: {
+                description: "The value. Pass an int for type:int, a float for type:float, or a " +
+                    "string for type:string.",
+            },
+            type: {
+                enum: ["int", "float", "string"],
+                description: "Value type. Determines which EditorPrefs setter (SetInt / SetFloat / " +
+                    "SetString) is called.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editorprefs-set.js.map

package/dist/tools/editorprefs-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorprefs-set.js","sourceRoot":"","sources":["../../src/tools/editorprefs-set.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,wEAAwE;QACxE,2EAA2E;QAC3E,6EAA6E;QAC7E,4EAA4E;QAC5E,0EAA0E;QAC1E,4DAA4D;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;QAClC,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,KAAK,EAAE;gBACL,WAAW,EACT,oEAAoE;oBACpE,yBAAyB;aAC5B;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;gBAChC,WAAW,EACT,uEAAuE;oBACvE,uBAAuB;aAC1B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/find-references.js

@@ -1,23 +1,43 @@
 export const findReferences = {
     name: "unity_open_mcp_find_references",
     description: "Reverse dependency lookup for assets. Returns all assets that reference the given asset path or GUID. " +
+        "Default (`profile: 'compact'`) returns counts grouped by kind/folder; raise to balanced/full for the per-asset path list " +
+        "(and verbose field locations, offline). Page large result sets with page_size/cursor. " +
         "Works offline (scanning YAML on disk) when no Editor is running, or via the live bridge when connected.",
     inputSchema: {
         type: "object",
         properties: {
             asset_path: { type: "string", description: "Asset path (e.g. Assets/Prefabs/Player.prefab)" },
             guid: { type: "string", pattern: "^[0-9a-fA-F]{32}$", description: "Asset GUID (32 hex chars)" },
+            profile: {
+                enum: ["compact", "balanced", "full"],
+                default: "compact",
+                description: "Token-budget output profile (M22). 'compact' (default) = counts + byKind/byFolder groupings only (no per-asset list). " +
+                    "'balanced' = referencing asset paths grouped by kind/folder. 'full' = also includes which fields reference the target (offline). " +
+                    "An explicit profile wins over the legacy `detail` param.",
+            },
+            page_size: {
+                type: "integer",
+                minimum: 1,
+                description: "Page the referencing-assets list (M22 uniform paging; balanced/full). When set, the response carries a `pagination` " +
+                    "block with a `next_cursor` to resume. Omit to receive up to `max_results` entries in one response.",
+            },
+            cursor: {
+                type: "string",
+                description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the referencing-assets list.",
+            },
             detail: {
                 enum: ["summary", "normal", "verbose"],
                 default: "normal",
-                description: "summary: counts only. normal: referencing asset paths grouped by kind/folder. verbose: also includes which fields reference the target.",
+                description: "Legacy compression level (alias for `profile`: summary=compact, normal=balanced, verbose=full). " +
+                    "Prefer `profile`; ignored when `profile` is set.",
             },
-            max_results: { type: "integer", default: 100, description: "Maximum number of referencing assets to return" },
-            max_per_file: { type: "integer", default: 5, description: "Verbose mode: max field locations per file" },
+            max_results: { type: "integer", default: 100, description: "Max referencing assets returned when page_size is omitted. Legacy alias of the single-page cap." },
+            max_per_file: { type: "integer", default: 5, description: "Verbose/full mode (offline): max field locations per file" },
             pattern_threshold: {
                 type: "integer",
                 default: 0,
-                description: "Collapse folders with >= this many referencing files into a single summary entry (0 = disabled)",
+                description: "Collapse folders with >= this many referencing files into a single summary entry (0 = disabled). Offline only.",
             },
         },
         oneOf: [

package/dist/tools/find-references.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-references.js","sourceRoot":"","sources":["../../src/tools/find-references.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,wGAAwG;QACxG,yGAAyG;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC7F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAChG,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,yIAAyI;aACvJ;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC7G,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACxG,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,iGAAiG;aAC/G;SACF;QACD,KAAK,EAAE;YACL,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;YAC5B,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;SACvB;KACF;CACF,CAAC"}
+{"version":3,"file":"find-references.js","sourceRoot":"","sources":["../../src/tools/find-references.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,wGAAwG;QACxG,2HAA2H;QAC3H,wFAAwF;QACxF,yGAAyG;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC7F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAChG,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,wHAAwH;oBACxH,mIAAmI;oBACnI,0DAA0D;aAC7D;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,sHAAsH;oBACtH,oGAAoG;aACvG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kHAAkH;aACrH;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,kGAAkG;oBAClG,kDAAkD;aACrD;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,iGAAiG,EAAE;YAC9J,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE;YACvH,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,gHAAgH;aAC9H;SACF;QACD,KAAK,EAAE;YACL,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;YAC5B,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;SACvB;KACF;CACF,CAAC"}

package/dist/tools/frame-debugger.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const frameDebugger: Tool;

package/dist/tools/frame-debugger.js

@@ -0,0 +1,48 @@
+// M20 Plan 1 / T20.1.3 — Frame Debugger control + draw-call list.
+//
+// Routes through Unity's internal Frame Debugger API (reflection-wrapped in
+// the bridge) to enable/disable capture and enumerate the draw calls of the
+// currently-debugged frame. Enable/disable is a non-mutating Editor state
+// change, so the tool is gate-free; the response carries `windowOpened` so the
+// agent knows Editor UI may have changed (the Frame Debugger window may have
+// been opened during capture).
+//
+// The draw-call list is capped at max_draw_calls (default 256) with a
+// `truncated` count; per-call entries surface shader / pass / material /
+// render target / vertex/index/instance counts where the Unity build exposes
+// them (some fields are version-specific and simply omitted when absent).
+export const frameDebugger = {
+    name: "unity_senses_frame_debugger",
+    description: "Control Unity's Frame Debugger and list the draw calls of the " +
+        "currently-debugged frame. Use action 'enable' to open the Frame Debugger " +
+        "window and start capturing a frame, 'disable' to stop capturing, or 'list' " +
+        "to enumerate the draw calls (shader, pass, material, render target, " +
+        "vertex/index/instance counts per call). Enable/disable is a non-mutating " +
+        "Editor state change — no assets or scenes are touched and the gate is " +
+        "always off, but the response reports windowOpened so the agent knows " +
+        "Editor UI state may have changed. Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["enable", "disable", "list"],
+                default: "list",
+                description: "'enable' opens the Frame Debugger window and starts capturing; " +
+                    "'disable' stops capturing; 'list' returns the draw-call list for " +
+                    "the currently-debugged frame (enable must have been called first).",
+            },
+            max_draw_calls: {
+                type: "integer",
+                default: 256,
+                minimum: 1,
+                maximum: 2000,
+                description: "Maximum number of draw calls to return for action 'list'. The " +
+                    "response reports the full totalDrawCalls count plus a truncated " +
+                    "flag when the list was capped.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=frame-debugger.js.map

package/dist/tools/frame-debugger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-debugger.js","sourceRoot":"","sources":["../../src/tools/frame-debugger.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAC/E,6EAA6E;AAC7E,+BAA+B;AAC/B,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,gEAAgE;QAChE,2EAA2E;QAC3E,6EAA6E;QAC7E,sEAAsE;QACtE,2EAA2E;QAC3E,wEAAwE;QACxE,uEAAuE;QACvE,4EAA4E;IAC9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;gBACnC,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,iEAAiE;oBACjE,mEAAmE;oBACnE,oEAAoE;aACvE;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,gEAAgE;oBAChE,kEAAkE;oBAClE,gCAAgC;aACnC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-modify.js

@@ -1,12 +1,28 @@
 // M16 Plan 2 — typed GameObject modify. Mutating: runs the full gate path.
 // Covers name / tag / layer / active AND transform (pos/rot/scale).
+//
+// M22 T22.1.4 — three-surface RFC 7396 form (additive, backwards-compatible).
+// In addition to the legacy flat fields, the caller may provide:
+//   - gameObjectDiffs          : grouped root-target patches (same fields as flat).
+//   - pathPatchesPerGameObject : {childPath: diffs} applied to descendants.
+//   - jsonPatchesPerGameObject : {componentTypeName: mergePatch} applied to the
+//                                root target's components via reflection.
+// Apply order: jsonPatches → pathPatches → gameObjectDiffs/flat. When any path
+// or json surface is present, the response carries a `surfaces` breakdown; a
+// legacy (root-only) call keeps the original compact result shape.
 export const gameobjectModify = {
     name: "unity_open_mcp_gameobject_modify",
     description: "Modify one or more GameObject fields in a single call: name, tag, layer, active, and " +
         "transform (position, rotation, scale). Only provided fields are touched; omitted fields are " +
         "preserved. Undo-recorded. Mutating: runs the full gate path; `paths_hint` is the scene path " +
         "that contains the target. Use local_space=true to interpret transform values in the parent's " +
-        "local space (matches Inspector). Address the target by instance_id > path > name.",
+        "local space (matches Inspector). Address the target by instance_id > path > name.\n\n" +
+        "Three-surface form (RFC 7396 JSON Merge Patch, additive): beyond the legacy flat fields you " +
+        "may pass gameObjectDiffs (root-target patches grouped in one object), " +
+        "pathPatchesPerGameObject ({childPath: diffs} applied to descendants of the target), and " +
+        "jsonPatchesPerGameObject ({componentTypeName: {field: value}} applied to the target's " +
+        "components via reflection, reusing object_modify's value shape). Apply order is " +
+        "jsonPatches → pathPatches → gameObjectDiffs/flat.",
     inputSchema: {
         type: "object",
         required: ["paths_hint"],
@@ -26,7 +42,7 @@ export const gameobjectModify = {
             },
             name: {
                 type: "string",
-                description: "New name. Omit to leave unchanged.",
+                description: "New name (legacy flat field). Omit to leave unchanged. Prefer gameObjectDiffs for new code.",
             },
             tag: {
                 type: "string",
@@ -60,6 +76,57 @@ export const gameobjectModify = {
                 description: "When true, position/rotation are local-space (parent-relative). Default false = world " +
                     "space. Unset fields inherit the same space as the previously-set value so they round-trip cleanly.",
             },
+            gameObjectDiffs: {
+                type: "object",
+                description: "M22 T22.1.4 surface 1 — root-target patches grouped in one object: " +
+                    "{name, tag, layer, active, position, rotation, scale, local_space}. Same field shape as " +
+                    "the legacy flat fields; when present, takes precedence over them. Omit any field to leave it unchanged.",
+                properties: {
+                    name: { type: "string" },
+                    tag: { type: "string" },
+                    layer: { type: "integer", minimum: 0, maximum: 31 },
+                    active: { type: "boolean" },
+                    position: { type: "string" },
+                    rotation: { type: "string" },
+                    scale: { type: "string" },
+                    local_space: { type: "boolean", default: false },
+                },
+                additionalProperties: false,
+            },
+            pathPatchesPerGameObject: {
+                type: "object",
+                description: "M22 T22.1.4 surface 2 — {childPath: diffs} applied to descendants of the target. Each " +
+                    "key is a slash-delimited path relative to the target (e.g. \"Body/Arm\"); the value is " +
+                    "the same diffs shape as gameObjectDiffs. Per-child errors accumulate and do not abort the batch.",
+                additionalProperties: {
+                    type: "object",
+                    description: "Diffs for the descendant GameObject at this path.",
+                    properties: {
+                        name: { type: "string" },
+                        tag: { type: "string" },
+                        layer: { type: "integer", minimum: 0, maximum: 31 },
+                        active: { type: "boolean" },
+                        position: { type: "string" },
+                        rotation: { type: "string" },
+                        scale: { type: "string" },
+                        local_space: { type: "boolean", default: false },
+                    },
+                    additionalProperties: false,
+                },
+            },
+            jsonPatchesPerGameObject: {
+                type: "object",
+                description: "M22 T22.1.4 surface 3 — {componentTypeName: mergePatch} applied to the root target's " +
+                    "components via reflection. The key names a component type on the target (class name " +
+                    "first, e.g. \"Rigidbody\", then full name); the value is a RFC 7396 merge patch " +
+                    "{field: value} reusing object_modify's value shape (scalars, [x,y,z] vectors, " +
+                    "{\"path\":...} refs). Per-component/per-field errors accumulate. Apply order: this " +
+                    "surface runs before pathPatches and the root diff.",
+                additionalProperties: {
+                    type: "object",
+                    description: "RFC 7396 merge patch of {fieldName: value} for this component.",
+                },
+            },
             paths_hint: {
                 type: "array",
                 items: { type: "string" },

package/dist/tools/gameobject-modify.js.map

@@ -1 +1 @@
-{"version":3,"file":"gameobject-modify.js","sourceRoot":"","sources":["../../src/tools/gameobject-modify.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,uFAAuF;QACvF,8FAA8F;QAC9F,8FAA8F;QAC9F,+FAA+F;QAC/F,mFAAmF;IACrF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yGAAyG;aAC5G;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,kDAAkD;aAChE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+CAA+C;aAC7D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,wFAAwF;oBACxF,oGAAoG;aACvG;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"gameobject-modify.js","sourceRoot":"","sources":["../../src/tools/gameobject-modify.ts"],"names":[],"mappings":"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"}

package/dist/tools/gate-budget-estimate.js

@@ -13,7 +13,8 @@
 //
 // Heuristic only — checkpoint-mode is lighter than full validation, so the
 // duration estimate is a lower bound. Run validate_edit to measure actuals.
-// No Unity-MCP / UCP / UUMCP equivalent; composed from existing foundations.
+// Composed from existing foundations; no equivalent in the broader tool
+// landscape.
 export const gateBudgetEstimate = {
     name: "unity_open_mcp_gate_budget_estimate",
     description: "Forecast validation duration + issue budget for a planned mutation scope before mutating. Returns " +

package/dist/tools/gate-budget-estimate.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate-budget-estimate.js","sourceRoot":"","sources":["../../src/tools/gate-budget-estimate.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,aAAa;AACb,+EAA+E;AAC/E,4EAA4E;AAC5E,uDAAuD;AACvD,6EAA6E;AAC7E,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,oGAAoG;QACpG,qGAAqG;QACrG,qGAAqG;QACrG,mGAAmG;QACnG,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,wDAAwD;aACtE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2EAA2E;aACzF;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,8CAA8C;aAC5D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACzB,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,8FAA8F;oBAC9F,iFAAiF;aACpF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"gate-budget-estimate.js","sourceRoot":"","sources":["../../src/tools/gate-budget-estimate.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,aAAa;AACb,+EAA+E;AAC/E,4EAA4E;AAC5E,uDAAuD;AACvD,6EAA6E;AAC7E,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,oGAAoG;QACpG,qGAAqG;QACrG,qGAAqG;QACrG,mGAAmG;QACnG,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,wDAAwD;aACtE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2EAA2E;aACzF;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,8CAA8C;aAC5D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACzB,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,8FAA8F;oBAC9F,iFAAiF;aACpF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-available-releases.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubAvailableReleases: Tool;

package/dist/tools/hub-available-releases.js

@@ -0,0 +1,23 @@
+// M26 Plan 2 — Unity Hub control: available releases. Local-routed (fetches
+// Unity's public download-archive page and parses its Next.js RSC payload;
+// never hits the Unity bridge or spawns Unity). Falls back to a bundled
+// snapshot (stale=true) on network failure, so the call never hard-errors.
+// Read-only, gate-free.
+export const hubAvailableReleases = {
+    name: "unity_open_mcp_hub_available_releases",
+    description: "List Unity Editor versions available for download, with their release " +
+        "stream (LTS / Supported / TECH / Beta / Alpha), release date, release-" +
+        "notes URL, and install changeset (when exposed). Sourced from Unity's " +
+        "public download-archive page (unity.com/releases/editor/archive). The " +
+        "result carries a `stale` flag — true when the live fetch failed and the " +
+        "data is a bundled offline fallback (re-call to retry), false when it is " +
+        "fresh. The changeset is required to install some archived versions via " +
+        "the unityhub:// deep link; pass it to hub_install_editor when present. " +
+        "Read-only, gate-free, no Unity Editor or bridge connection required.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=hub-available-releases.js.map

package/dist/tools/hub-available-releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-available-releases.js","sourceRoot":"","sources":["../../src/tools/hub-available-releases.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,2EAA2E;AAC3E,wBAAwB;AACxB,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,yEAAyE;QACzE,yEAAyE;QACzE,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-get-install-path.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubGetInstallPath: Tool;

package/dist/tools/hub-get-install-path.js

@@ -0,0 +1,20 @@
+// M26 Plan 2 — Unity Hub control: get install path. Local-routed. Tries the
+// Hub CLI (install-path) first, falling back to filesystem inference from the
+// Hub install roots when the CLI is unavailable. Read-only, gate-free.
+export const hubGetInstallPath = {
+    name: "unity_open_mcp_hub_get_install_path",
+    description: "Get the default installation directory for Unity Editors managed by " +
+        "Unity Hub. Tries the Hub headless CLI (`Unity Hub --headless " +
+        "install-path`) first; when the Hub CLI is not found, falls back to " +
+        "inferring the path from the OS-default Hub install roots. The response " +
+        "carries a `source` field (hub-cli | filesystem | none) so the caller can " +
+        "tell how the value was resolved, and a structured `hub_cli_not_found` " +
+        "error when neither path is available. Read-only, gate-free, no Unity " +
+        "Editor or bridge connection required.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=hub-get-install-path.js.map

package/dist/tools/hub-get-install-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-get-install-path.js","sourceRoot":"","sources":["../../src/tools/hub-get-install-path.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,8EAA8E;AAC9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,sEAAsE;QACtE,+DAA+D;QAC/D,qEAAqE;QACrE,yEAAyE;QACzE,2EAA2E;QAC3E,wEAAwE;QACxE,uEAAuE;QACvE,uCAAuC;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-install-editor.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubInstallEditor: Tool;

package/dist/tools/hub-install-editor.js

@@ -0,0 +1,47 @@
+// M26 Plan 2 — Unity Hub control: install editor. Local-routed (fires the
+// unityhub:// deep link via the OS handler; never hits the Unity bridge).
+//
+// MUTATING — installs software at the system level. This is NOT a project-
+// asset mutation, so paths_hint is N/A and the call is gate-free (the gate
+// validates project-asset-reference fallout, which does not apply). The
+// response still carries the gate-consistent mutation/agentNextSteps envelope
+// shape so agents parse it uniformly. The install itself happens inside Unity
+// Hub (single instance, native progress UI); there is no in-call completion
+// detection — poll hub_list_editors afterwards to confirm.
+export const hubInstallEditor = {
+    name: "unity_open_mcp_hub_install_editor",
+    description: "Install a specific Unity Editor version by opening Unity Hub at its " +
+        "native install dialog via the unityhub:// deep link. The Hub must be " +
+        "installed and registered as the system handler for the unityhub:// " +
+        "scheme. Optionally pass the build changeset (available from " +
+        "hub_available_releases) to pin the exact build for archived versions. " +
+        "Mutating: this installs software (a multi-GB editor download) — it is a " +
+        "system-level operation, not a project-asset mutation, so paths_hint is " +
+        "N/A and the call is gate-free. The install runs inside the Hub with its " +
+        "own progress UI; this call returns once the deep link is accepted, NOT " +
+        "when the download completes. There is no in-call completion detection " +
+        "(the Hub owns the process) — poll hub_list_editors after the Hub " +
+        "finishes to confirm the new editor. Cross-platform: uses the OS URL " +
+        "handler (open on macOS, xdg-open on Linux, start on Windows).",
+    inputSchema: {
+        type: "object",
+        required: ["version"],
+        properties: {
+            version: {
+                type: "string",
+                description: "Unity version to install (e.g. '2022.3.20f1', '6000.3.18f1'). " +
+                    "Discover available versions + their changesets via " +
+                    "hub_available_releases.",
+            },
+            changeset: {
+                type: "string",
+                description: "Optional build changeset hash (e.g. '88b47c5e7076'). When present, " +
+                    "the deep link is unityhub://<version>/<changeset>, which pins the " +
+                    "exact build (required for some archived versions). Omit for a " +
+                    "changeset-less install (older Hub versions may ignore these).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=hub-install-editor.js.map

package/dist/tools/hub-install-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-install-editor.js","sourceRoot":"","sources":["../../src/tools/hub-install-editor.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,wEAAwE;AACxE,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,sEAAsE;QACtE,uEAAuE;QACvE,qEAAqE;QACrE,8DAA8D;QAC9D,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,mEAAmE;QACnE,sEAAsE;QACtE,+DAA+D;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gEAAgE;oBAChE,qDAAqD;oBACrD,yBAAyB;aAC5B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qEAAqE;oBACrE,oEAAoE;oBACpE,gEAAgE;oBAChE,+DAA+D;aAClE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-install-modules.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubInstallModules: Tool;

package/dist/tools/hub-install-modules.js

@@ -0,0 +1,44 @@
+// M26 Plan 2 — Unity Hub control: install modules. Local-routed (fires the
+// unityhub:// deep link; never hits the Unity bridge). Like hub_install_editor
+// this opens the Hub's native install dialog — the Hub does not expose a
+// module-only deep link, so the same version deep link is used and the module
+// selection happens in the Hub UI. MUTATING system-level op, gate-free.
+export const hubInstallModules = {
+    name: "unity_open_mcp_hub_install_modules",
+    description: "Add platform build modules to an already-installed Unity Editor " +
+        "version by opening Unity Hub at its install/module dialog via the " +
+        "unityhub:// deep link. The Hub must be installed and registered as the " +
+        "unityhub:// handler. Mutating: this installs software (platform module " +
+        "downloads) at the system level — paths_hint is N/A and the call is " +
+        "gate-free. The module install runs inside the Hub; this call returns " +
+        "once the deep link is accepted, not when the download completes. Poll " +
+        "hub_list_editors (which scans Data/PlaybackEngines) afterwards to " +
+        "confirm the new modules. Note: the unityhub:// scheme does not expose a " +
+        "module-specific deep link, so the Hub opens at the version's install " +
+        "dialog where the operator selects the modules — the modules argument is " +
+        "informational and surfaced in the response for the operator to act on.",
+    inputSchema: {
+        type: "object",
+        required: ["version"],
+        properties: {
+            version: {
+                type: "string",
+                description: "Target already-installed Unity version (e.g. '6000.3.18f1').",
+            },
+            modules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Modules to add (informational — surfaced in the response for the " +
+                    "operator to select in the Hub dialog): android, ios, webgl, " +
+                    "linux-il2cpp, mac-il2cpp, windows-il2cpp, etc.",
+            },
+            changeset: {
+                type: "string",
+                description: "Optional build changeset (from hub_available_releases) to pin the " +
+                    "exact build. Forwarded as the deep-link changeset segment.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=hub-install-modules.js.map

package/dist/tools/hub-install-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-install-modules.js","sourceRoot":"","sources":["../../src/tools/hub-install-modules.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,+EAA+E;AAC/E,yEAAyE;AACzE,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,kEAAkE;QAClE,oEAAoE;QACpE,yEAAyE;QACzE,yEAAyE;QACzE,qEAAqE;QACrE,uEAAuE;QACvE,wEAAwE;QACxE,oEAAoE;QACpE,0EAA0E;QAC1E,uEAAuE;QACvE,0EAA0E;QAC1E,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mEAAmE;oBACnE,8DAA8D;oBAC9D,gDAAgD;aACnD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;oBACpE,4DAA4D;aAC/D;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-list-editors.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubListEditors: Tool;

package/dist/tools/hub-list-editors.js

@@ -0,0 +1,25 @@
+// M26 Plan 2 — Unity Hub control: list installed editors. Local-routed (the
+// MCP server scans the Hub install roots itself; never hits the Unity bridge
+// or spawns Unity). Reuses the same discovery approach as the Hub launcher
+// (scannedHubRoots + Data/PlaybackEngines scan) implemented standalone in TS.
+// Read-only, gate-free, no project-asset mutation (paths_hint is N/A).
+export const hubListEditors = {
+    name: "unity_open_mcp_hub_list_editors",
+    description: "List all Unity Editor versions installed via Unity Hub on this machine, " +
+        "including each install's executable path, the build-target platforms it " +
+        "has modules for (scanned from Data/PlaybackEngines), and the release " +
+        "stream inferred from the version suffix (LTS / TECH / Beta / Alpha). " +
+        "Resolved by scanning the OS-default Unity Hub install roots " +
+        "(+ UNITY_HUB env override) — no running Unity Editor or bridge " +
+        "connection required. Read-only, gate-free. Cross-platform: the scan " +
+        "roots are /Applications/Unity/Hub/Editor (macOS), " +
+        "C:\\Program Files\\Unity\\Hub\\Editor (Windows), ~/Unity/Hub/Editor " +
+        "(Linux). Use this before hub_install_editor to check what is already " +
+        "available, and after an install (refresh) to confirm the new editor.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=hub-list-editors.js.map

package/dist/tools/hub-list-editors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-list-editors.js","sourceRoot":"","sources":["../../src/tools/hub-list-editors.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,0EAA0E;QAC1E,0EAA0E;QAC1E,uEAAuE;QACvE,uEAAuE;QACvE,8DAA8D;QAC9D,iEAAiE;QACjE,sEAAsE;QACtE,oDAAoD;QACpD,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/hub-set-install-path.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const hubSetInstallPath: Tool;