unity-open-mcp 0.1.0

package/dist/tools/console-log.js

@@ -0,0 +1,47 @@
+// M16 Plan 5 — typed console log. Writes a log/warning/error to the Editor
+// console from the agent. Gate-free direct-response tool: it emits a message
+// to the console but writes no assets, so no gate validation is meaningful.
+// Folds UUMCP console_log. The emitted entry surfaces in the next
+// unity_senses_read_console / unity_senses_pull_events call.
+export const consoleLog = {
+    name: "unity_open_mcp_console_log",
+    description: "Write a log / warning / error message to the Unity Editor console from " +
+        "the agent. Useful for leaving breadcrumbs a human watching the Console " +
+        "window can follow, or for asserting a checkpoint in a mutate→gate→fix " +
+        "loop. Mutates console state only (no asset writes), so it is gate-free " +
+        "and returns directly without the gate envelope. The entry appears in the " +
+        "next unity_senses_read_console or unity_senses_pull_events call. Prefer " +
+        "this over raw execute_csharp Debug.Log — schema-validated and typed.",
+    inputSchema: {
+        type: "object",
+        required: ["message"],
+        properties: {
+            message: {
+                type: "string",
+                description: "The message text to write to the console.",
+            },
+            level: {
+                type: "string",
+                enum: ["log", "warning", "error"],
+                default: "log",
+                description: "Severity. 'log' → Debug.Log; 'warning' → Debug.LogWarning; " +
+                    "'error' → Debug.LogError (shows a red entry + stack). Defaults to 'log'.",
+            },
+            context_instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Optional GameObject/Component instance id to attach as the log " +
+                    "context. When set, the Console window pings the object when the " +
+                    "entry is clicked. Omit (or 0) for a context-less log.",
+            },
+            context_asset_path: {
+                type: "string",
+                description: "Optional asset path (e.g. 'Assets/Prefabs/Player.prefab') to attach " +
+                    "as the log context. Takes precedence over context_instance_id when " +
+                    "both are set. Omit for a context-less log.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=console-log.js.map

package/dist/tools/console-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-log.js","sourceRoot":"","sources":["../../src/tools/console-log.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,kEAAkE;AAClE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,yEAAyE;QACzE,yEAAyE;QACzE,wEAAwE;QACxE,yEAAyE;QACzE,2EAA2E;QAC3E,0EAA0E;QAC1E,sEAAsE;IACxE,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,2CAA2C;aACzD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC;gBACjC,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,6DAA6D;oBAC7D,0EAA0E;aAC7E;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,iEAAiE;oBACjE,kEAAkE;oBAClE,uDAAuD;aAC1D;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;oBACtE,qEAAqE;oBACrE,4CAA4C;aAC/C;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/delta.d.ts

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

package/dist/tools/delta.js

@@ -0,0 +1,17 @@
+export const delta = {
+    name: "unity_open_mcp_delta",
+    description: "Compare current project health vs a checkpoint.",
+    inputSchema: {
+        type: "object",
+        required: ["checkpoint_id"],
+        properties: {
+            checkpoint_id: { type: "string" },
+            paths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Re-validate scope; defaults to checkpoint paths",
+            },
+        },
+    },
+};
+//# sourceMappingURL=delta.js.map

package/dist/tools/delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../src/tools/delta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAS;IACzB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,iDAAiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,UAAU,EAAE;YACV,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjC,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,iDAAiD;aAC/D;SACF;KACF;CACF,CAAC"}

package/dist/tools/editor-add-layer.d.ts

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

package/dist/tools/editor-add-layer.js

@@ -0,0 +1,51 @@
+// M16 Plan 5 — typed editor add layer. Mutating: assigns a layer name to a
+// slot in the TagManager (ProjectSettings/TagManager.asset) and saves it. Runs
+// the full gate path with paths_hint scoped to that asset. Folds UCP
+// settings/add-layer. Layers are index-keyed (0–31); this tool finds the first
+// empty slot (or uses an explicit slot), assigns the name, and saves.
+export const editorAddLayer = {
+    name: "unity_open_mcp_editor_add_layer",
+    description: "Add a user-defined layer to the project's TagManager. Mutating: assigns " +
+        "the layer name to a slot, writes ProjectSettings/TagManager.asset, and " +
+        "refreshes the asset database. Runs the full gate path; paths_hint should " +
+        "be [\"ProjectSettings/TagManager.asset\"]. By default picks the first " +
+        "empty slot (slots 0–7 are reserved for built-ins, so user layers land in " +
+        "8–31); pass slot to assign a specific index. Refuses reserved built-in " +
+        "layer names and slots, refuses when no free slot remains, and is " +
+        "idempotent (re-assigning the same name to the same slot is a no-op). " +
+        "Prefer this over raw execute_csharp TagManager manipulation — schema-" +
+        "validated, undo-recorded, and the gate surfaces any fallout from the " +
+        "TagManager rewrite. Pair with editor_get_layers to confirm the addition.",
+    inputSchema: {
+        type: "object",
+        required: ["layer", "paths_hint"],
+        properties: {
+            layer: {
+                type: "string",
+                description: "The layer name to add. Must be non-empty and not a reserved " +
+                    "built-in layer name (Default, TransparentFX, IgnoreRaycast, Water, " +
+                    "UI). Leading/trailing whitespace is trimmed.",
+            },
+            slot: {
+                type: "integer",
+                minimum: 8,
+                maximum: 31,
+                description: "Explicit slot index (8–31) to assign. Slots 0–7 are reserved for " +
+                    "Unity built-ins. When omitted, the first empty slot in 8–31 is " +
+                    "used. Refuses when the chosen slot is occupied by a different name.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — [\"ProjectSettings/TagManager.asset\"] (the asset " +
+                    "this tool rewrites).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-add-layer.js.map

package/dist/tools/editor-add-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-add-layer.js","sourceRoot":"","sources":["../../src/tools/editor-add-layer.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,+EAA+E;AAC/E,qEAAqE;AACrE,+EAA+E;AAC/E,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,0EAA0E;QAC1E,yEAAyE;QACzE,2EAA2E;QAC3E,wEAAwE;QACxE,2EAA2E;QAC3E,yEAAyE;QACzE,mEAAmE;QACnE,uEAAuE;QACvE,uEAAuE;QACvE,uEAAuE;QACvE,0EAA0E;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;QACjC,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8DAA8D;oBAC9D,qEAAqE;oBACrE,8CAA8C;aACjD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,mEAAmE;oBACnE,iEAAiE;oBACjE,qEAAqE;aACxE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,qEAAqE;oBACrE,sBAAsB;aACzB;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"}

package/dist/tools/editor-add-tag.d.ts

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

package/dist/tools/editor-add-tag.js

@@ -0,0 +1,41 @@
+// M16 Plan 5 — typed editor add tag. Mutating: appends a user tag to the
+// TagManager (ProjectSettings/TagManager.asset) and saves it. Runs the full
+// gate path with paths_hint scoped to that asset. Folds UCP settings/add-tag.
+// Idempotent: a tag that already exists is a no-op (saved:false). Built-in tag
+// names are reserved.
+export const editorAddTag = {
+    name: "unity_open_mcp_editor_add_tag",
+    description: "Add a user-defined tag to the project's TagManager. Mutating: appends the " +
+        "tag, writes ProjectSettings/TagManager.asset, and refreshes the asset " +
+        "database. Runs the full gate path; paths_hint should be " +
+        "[\"ProjectSettings/TagManager.asset\"]. Idempotent — adding a tag that " +
+        "already exists returns saved:false (no write). Refuses reserved built-in " +
+        "tag names (Untagged, Respawn, Finish, EditorOnly, MainCamera, Player, " +
+        "GameController) and invalid names. Prefer this over raw execute_csharp " +
+        "TagManager manipulation — schema-validated, undo-recorded, and the gate " +
+        "surfaces any fallout from the TagManager rewrite. Pair with " +
+        "editor_get_tags to confirm the addition.",
+    inputSchema: {
+        type: "object",
+        required: ["tag", "paths_hint"],
+        properties: {
+            tag: {
+                type: "string",
+                description: "The tag name to add. Must be non-empty and not a reserved built-in " +
+                    "tag. Leading/trailing whitespace is trimmed.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — [\"ProjectSettings/TagManager.asset\"] (the asset " +
+                    "this tool rewrites).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-add-tag.js.map

package/dist/tools/editor-add-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-add-tag.js","sourceRoot":"","sources":["../../src/tools/editor-add-tag.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,sBAAsB;AACtB,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,4EAA4E;QAC5E,wEAAwE;QACxE,0DAA0D;QAC1D,yEAAyE;QACzE,2EAA2E;QAC3E,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,8DAA8D;QAC9D,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;QAC/B,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qEAAqE;oBACrE,8CAA8C;aACjD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,qEAAqE;oBACrE,sBAAsB;aACzB;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"}

package/dist/tools/editor-get-layers.d.ts

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

package/dist/tools/editor-get-layers.js

@@ -0,0 +1,22 @@
+// M16 Plan 5 — typed editor layers read. Read-only: lists every non-empty
+// layer slot (index 0–31) from the TagManager. Gate-free. Folds UUMCP
+// editor_get_layers + UCP settings/tags-layers. Pair with editor_add_layer
+// for the mutating side, and gameobject_modify (layer) for consumers.
+export const editorGetLayers = {
+    name: "unity_open_mcp_editor_get_layers",
+    description: "List every non-empty layer slot configured in the project's TagManager " +
+        "(the Layers list under Edit → Project Settings → Tags and Layers). " +
+        "Returns each populated slot's index (0–31) and name. Built-in layers " +
+        "(0 Default, 1 TransparentFX, 2 IgnoreRaycast, 4 Water, 5 UI) are " +
+        "included; empty slots are omitted. Read-only and gate-free. Use this " +
+        "before gameobject_modify (layer) to discover valid layer indices, and " +
+        "before editor_add_layer to find the first free slot. Prefer this over " +
+        "raw execute_csharp InternalEditorUtility.layers — schema-validated and " +
+        "includes the slot indices the modify tool expects.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-get-layers.js.map

package/dist/tools/editor-get-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-get-layers.js","sourceRoot":"","sources":["../../src/tools/editor-get-layers.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,yEAAyE;QACzE,qEAAqE;QACrE,uEAAuE;QACvE,mEAAmE;QACnE,uEAAuE;QACvE,wEAAwE;QACxE,wEAAwE;QACxE,yEAAyE;QACzE,oDAAoD;IACtD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editor-get-tags.d.ts

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

package/dist/tools/editor-get-tags.js

@@ -0,0 +1,19 @@
+// M16 Plan 5 — typed editor tags read. Read-only: lists every configured tag
+// from the TagManager. Gate-free. Folds UUMCP editor_get_tags + UCP
+// settings/tags-layers. Pair with editor_add_tag for the mutating side.
+export const editorGetTags = {
+    name: "unity_open_mcp_editor_get_tags",
+    description: "List every tag configured in the project's TagManager (the Tags list " +
+        "under Edit → Project Settings → Tags and Layers). Includes Unity's " +
+        "built-in tags (Untagged, Respawn, Finish, EditorOnly, MainCamera, " +
+        "Player, GameController) plus user-defined tags. Read-only and gate-free. " +
+        "Use this before gameobject_modify (tag) to discover valid tag names, and " +
+        "before editor_add_tag to check whether a tag already exists. Prefer this " +
+        "over raw execute_csharp InternalEditorUtility.tags — schema-validated.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-get-tags.js.map

package/dist/tools/editor-get-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-get-tags.js","sourceRoot":"","sources":["../../src/tools/editor-get-tags.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,oEAAoE;AACpE,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,uEAAuE;QACvE,qEAAqE;QACrE,oEAAoE;QACpE,2EAA2E;QAC3E,2EAA2E;QAC3E,2EAA2E;QAC3E,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editor-redo.d.ts

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

package/dist/tools/editor-redo.js

@@ -0,0 +1,27 @@
+// M16 Plan 5 — typed editor redo. Mutates editor undo state but writes no
+// assets — routes as a gate-free direct-response tool. Folds UUMCP editor_redo
+// (Undo.PerformRedo). Pair with editor_undo and the undo-recorded typed
+// mutators.
+export const editorRedo = {
+    name: "unity_open_mcp_editor_redo",
+    description: "Perform an editor Redo — re-applies the most recent undone action (one " +
+        "step). Mutates editor undo state only (writes no assets), so it is " +
+        "gate-free and returns directly without the gate envelope. Use steps > 1 " +
+        "to redo multiple actions in one call. Prefer this over raw execute_csharp " +
+        "Undo.PerformRedo() — schema-validated and surfaces the post-redo " +
+        "selection so the agent knows what re-applied.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            steps: {
+                type: "integer",
+                default: 1,
+                minimum: 1,
+                description: "Number of redo steps to perform. Each step re-applies one undone " +
+                    "action. Defaults to 1.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-redo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor-redo.js","sourceRoot":"","sources":["../../src/tools/editor-redo.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,+EAA+E;AAC/E,wEAAwE;AACxE,YAAY;AACZ,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,yEAAyE;QACzE,qEAAqE;QACrE,0EAA0E;QAC1E,4EAA4E;QAC5E,mEAAmE;QACnE,+CAA+C;IACjD,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,mEAAmE;oBACnE,wBAAwB;aAC3B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editor-set-state.d.ts

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

package/dist/tools/editor-set-state.js

@@ -0,0 +1,57 @@
+// M16 Plan 5 — typed editor state set (play / pause / stop). Complements
+// unity_open_mcp_editor_status (the read side). Entering play mode is a
+// disruptive editor transition: if any loaded scene is dirty, Unity's native
+// save modal can interrupt the flow. The bridge preflights the scene setup and
+// refuses with code `scene_dirty` when that would happen — pass
+// `ignore_scene_dirty: true` to accept the risk.
+//
+// The call does NOT go through the gate envelope: editor state transitions
+// write no assets (the gate validates asset-reference fallout, which does not
+// apply). It is a gate-free direct-response tool that still runs on the main
+// thread. Document settle/poll expectations: entering play mode is
+// near-instant in the editor; the response reflects the post-transition state.
+export const editorSetState = {
+    name: "unity_open_mcp_editor_set_state",
+    description: "Set the Unity Editor play / pause / stop state. Complements " +
+        "unity_open_mcp_editor_status (the read side). play = enter play mode " +
+        "(EditorApplication.EnterPlaymode); pause = toggle pause while playing; " +
+        "stop = exit play mode. Entering play mode is disruptive — when a loaded " +
+        "scene has unsaved changes, Unity's native save modal can interrupt the " +
+        "flow, so the bridge preflights and refuses with code `scene_dirty`; pass " +
+        "ignore_scene_dirty: true to accept the risk. Writes no assets, so the call " +
+        "is gate-free and returns the post-transition state directly. Prefer this " +
+        "over raw execute_csharp EditorApplication.isPlaying = true — schema-" +
+        "validated, undo-safe, and the dirty-scene refusal is surfaced as a " +
+        "structured error instead of a hanging save dialog.",
+    inputSchema: {
+        type: "object",
+        required: ["state"],
+        properties: {
+            state: {
+                type: "string",
+                enum: ["play", "pause", "stop"],
+                description: "Target state. 'play' → enter play mode (refuses if already playing " +
+                    "unless force: true); 'pause' → toggle pause on the current play " +
+                    "session (no-op when not playing); 'stop' → exit play mode (refuses " +
+                    "when not playing).",
+            },
+            force: {
+                type: "boolean",
+                default: false,
+                description: "When true, skip the idempotent 'already in target state' check. " +
+                    "Useful for re-entering play mode after a code change without first " +
+                    "stopping. Default false.",
+            },
+            ignore_scene_dirty: {
+                type: "boolean",
+                default: false,
+                description: "Opt out of the active-scene dirty guard. When false (default), the " +
+                    "call is refused with code `scene_dirty` if any loaded scene has " +
+                    "unsaved changes — entering play mode would otherwise trigger " +
+                    "Unity's native save modal. Set true to proceed and accept the risk.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-set-state.js.map

package/dist/tools/editor-set-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-set-state.js","sourceRoot":"","sources":["../../src/tools/editor-set-state.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wEAAwE;AACxE,6EAA6E;AAC7E,+EAA+E;AAC/E,gEAAgE;AAChE,iDAAiD;AACjD,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,mEAAmE;AACnE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,8DAA8D;QAC9D,uEAAuE;QACvE,yEAAyE;QACzE,0EAA0E;QAC1E,yEAAyE;QACzE,2EAA2E;QAC3E,6EAA6E;QAC7E,2EAA2E;QAC3E,sEAAsE;QACtE,qEAAqE;QACrE,oDAAoD;IACtD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;gBAC/B,WAAW,EACT,qEAAqE;oBACrE,kEAAkE;oBAClE,qEAAqE;oBACrE,oBAAoB;aACvB;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,kEAAkE;oBAClE,qEAAqE;oBACrE,0BAA0B;aAC7B;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,qEAAqE;oBACrE,kEAAkE;oBAClE,+DAA+D;oBAC/D,qEAAqE;aACxE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editor-status.d.ts

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

package/dist/tools/editor-status.js

@@ -0,0 +1,17 @@
+export const editorStatus = {
+    name: "unity_open_mcp_editor_status",
+    description: "Returns the current Unity Editor state: play mode, compile state, current scene path, Unity version, and editor type.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            timeout_ms: {
+                type: "integer",
+                default: 30000,
+                minimum: 1000,
+                maximum: 300000,
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor-status.js","sourceRoot":"","sources":["../../src/tools/editor-status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uHAAuH;IACzH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;aAChB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/editor-undo.d.ts

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

package/dist/tools/editor-undo.js

@@ -0,0 +1,29 @@
+// 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, ...).
+export const editorUndo = {
+    name: "unity_open_mcp_editor_undo",
+    description: "Perform an editor Undo — reverts the most recent recorded action (one " +
+        "step). Mutates editor undo state only (writes no assets), so it is " +
+        "gate-free and returns directly without the gate envelope. Works against " +
+        "every undo-recorded action the bridge takes (gameobject_*, component_*, " +
+        "selection_set, material_set_*, prefab_*, scene_*) plus human actions. " +
+        "Use steps > 1 to undo multiple actions in one call. Prefer this over raw " +
+        "execute_csharp Undo.PerformUndo() — schema-validated and surfaces the " +
+        "post-undo selection so the agent knows what reverted.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            steps: {
+                type: "integer",
+                default: 1,
+                minimum: 1,
+                description: "Number of undo steps to perform. Each step reverts one recorded " +
+                    "action. Defaults to 1.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=editor-undo.js.map

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

@@ -0,0 +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"}

package/dist/tools/execute-csharp.d.ts

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

package/dist/tools/execute-csharp.js

@@ -0,0 +1,74 @@
+export const executeCsharp = {
+    name: "unity_open_mcp_execute_csharp",
+    description: "Compile and run a C# snippet in the Editor (Roslyn). Primary escape hatch — covers most Editor APIs without typed tools.",
+    inputSchema: {
+        type: "object",
+        required: ["code"],
+        properties: {
+            code: {
+                type: "string",
+                description: "C# source. Use return x; to produce output.",
+            },
+            usings: {
+                type: "array",
+                items: { type: "string" },
+                description: "Extra using directives beyond defaults (UnityEngine, UnityEditor, etc.)",
+            },
+            object_ids: {
+                type: "array",
+                items: { type: "string" },
+                description: "Instance IDs (or full handle JSON) of live UnityEngine.Objects " +
+                    "to inject into the snippet. Access them via Refs[index] or " +
+                    "Ref<T>(index) in the code body. Instance IDs come from the " +
+                    "'objectId' field of object handles returned by other tools. " +
+                    "Instance IDs change on domain reload.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Asset paths likely touched; drives scoped gate validation",
+            },
+            ignore_scene_dirty: {
+                type: "boolean",
+                default: false,
+                description: "Bypass the active-scene dirty guard. By default a disruptive op " +
+                    "(recompile / scene switch) is refused with scene_dirty when any " +
+                    "loaded scene has unsaved changes, so Unity's native save modal " +
+                    "never interrupts the flow. Set true to proceed and accept the risk " +
+                    "of a native save prompt.",
+            },
+            confirm_bypass: {
+                type: "boolean",
+                default: false,
+                description: "Bypass the deny heuristic for destructive patterns " +
+                    "(EditorApplication.Exit, AssetDatabase.DeleteAsset, " +
+                    "BuildPipeline.BuildPlayer, etc.). Requires gate: \"off\" as well — " +
+                    "both flags must be set. The bypass is audited.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+            timeout_ms: {
+                type: "integer",
+                default: 30000,
+                minimum: 1000,
+                maximum: 300000,
+            },
+            max_depth: {
+                type: "integer",
+                default: 4,
+                minimum: 0,
+                description: "Max recursion depth when serializing the returned object graph (default 4). Composite nodes deeper than this are stringified to bound payload size.",
+            },
+            max_items: {
+                type: "integer",
+                default: 100,
+                minimum: 0,
+                description: "Max items emitted per list/enumerable in the returned object graph (default 100). Truncated lists report a `truncated` count of the elided items.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=execute-csharp.js.map

package/dist/tools/execute-csharp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-csharp.js","sourceRoot":"","sources":["../../src/tools/execute-csharp.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,0HAA0H;IAC5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yEAAyE;aAC5E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,iEAAiE;oBACjE,6DAA6D;oBAC7D,6DAA6D;oBAC7D,8DAA8D;oBAC9D,uCAAuC;aAC1C;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,2DAA2D;aAC9D;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,kEAAkE;oBAClE,kEAAkE;oBAClE,iEAAiE;oBACjE,qEAAqE;oBACrE,0BAA0B;aAC7B;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,qDAAqD;oBACrD,sDAAsD;oBACtD,qEAAqE;oBACrE,gDAAgD;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;aAChB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,qJAAqJ;aACxJ;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,mJAAmJ;aACtJ;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/execute-menu.d.ts

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

package/dist/tools/execute-menu.js

@@ -0,0 +1,40 @@
+export const executeMenu = {
+    name: "unity_open_mcp_execute_menu",
+    description: "Execute a Unity Editor menu item.",
+    inputSchema: {
+        type: "object",
+        required: ["menu_path"],
+        properties: {
+            menu_path: {
+                type: "string",
+                description: "e.g. Assets/Refresh, File/Save Project",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+            },
+            ignore_scene_dirty: {
+                type: "boolean",
+                default: false,
+                description: "Bypass the active-scene dirty guard. By default a disruptive op " +
+                    "(recompile / scene switch / menu that can disrupt the editor) is " +
+                    "refused with scene_dirty when any loaded scene has unsaved changes, " +
+                    "so Unity's native save modal never interrupts the flow. Set true to " +
+                    "proceed and accept the risk of a native save prompt.",
+            },
+            confirm_bypass: {
+                type: "boolean",
+                default: false,
+                description: "Bypass the deny heuristic for destructive menu paths " +
+                    "(File/Quit, File/Exit, Assets/Reimport All). Requires gate: \"off\" " +
+                    "as well — both flags must be set. The bypass is audited.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=execute-menu.js.map

package/dist/tools/execute-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-menu.js","sourceRoot":"","sources":["../../src/tools/execute-menu.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,mCAAmC;IAChD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,kEAAkE;oBAClE,mEAAmE;oBACnE,sEAAsE;oBACtE,sEAAsE;oBACtE,sDAAsD;aACzD;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,uDAAuD;oBACvD,sEAAsE;oBACtE,0DAA0D;aAC7D;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"}

package/dist/tools/find-members.d.ts

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

package/dist/tools/find-members.js

@@ -0,0 +1,56 @@
+// M16 Plan 6 — find_members enhanced in place with richer overload/signature
+// metadata. The previous flat signature string now carries structured fields
+// (returnType, parameters[], isStatic, isGeneric, genericParameters[] for
+// methods; propertyType, canRead, canWrite, isStatic for properties; the
+// member kind, declaring type, and assembly) so an agent can pick a specific
+// overload and call it via invoke_method without trial-and-error. The legacy
+// flat `signature` field stays for compatibility.
+export const findMembers = {
+    name: "unity_open_mcp_find_members",
+    description: "Discover types, methods, and properties for agent planning (reduces blind execute calls). " +
+        "Token-bounded: `max_results` caps the returned list, `truncated` always reports how many " +
+        "additional matches were dropped. Each member carries a flat `signature` string AND " +
+        "structured fields (returnType, parameters[], isStatic, isGeneric, genericParameters[] for " +
+        "methods; propertyType, canRead, canWrite for properties) so you can pick a specific " +
+        "overload and plan an invoke_method call. Pass `include_signatures: false` to get back " +
+        "just names (lighter payload). When `query` matches a method with overloads, every " +
+        "overload is listed separately.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Substring filter on type or member name",
+            },
+            kind: {
+                enum: ["type", "method", "property", "all"],
+                default: "all",
+            },
+            assembly_filter: {
+                type: "string",
+            },
+            include_unity_editor: {
+                type: "boolean",
+                default: true,
+            },
+            include_project: {
+                type: "boolean",
+                default: true,
+            },
+            include_signatures: {
+                type: "boolean",
+                default: true,
+                description: "Include the flat `signature` string and structured parameter/generic metadata on " +
+                    "each member (default). Set false to get back just names for a lighter payload.",
+            },
+            max_results: {
+                type: "integer",
+                default: 50,
+                maximum: 200,
+                description: "Maximum number of members to return. Additional matches are counted in `truncated`.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=find-members.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-members.js","sourceRoot":"","sources":["../../src/tools/find-members.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,4FAA4F;QAC5F,2FAA2F;QAC3F,qFAAqF;QACrF,4FAA4F;QAC5F,sFAAsF;QACtF,wFAAwF;QACxF,oFAAoF;QACpF,gCAAgC;IAClC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;gBAC3C,OAAO,EAAE,KAAK;aACf;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;aACf;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;aACd;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;aACd;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,mFAAmF;oBACnF,gFAAgF;aACnF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,GAAG;gBACZ,WAAW,EACT,qFAAqF;aACxF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/find-references.d.ts

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