unity-open-mcp 0.1.0

package/dist/tools/build-set-target.js

@@ -0,0 +1,49 @@
+// M16 Plan 9 — typed build-target switch. Mutating: EditorUserBuildSettings
+// .SwitchActiveBuildTarget. May trigger a recompile + domain reload (the
+// lifecycle is restart_then_settle). Folds UCP build/set-target.
+//
+// paths_hint: ProjectSettings files are rewritten when the active target
+// changes (ProjectSettings/ProjectSettings.asset + the build-target-specific
+// override assets). Scope paths_hint to "ProjectSettings" so the gate covers
+// the rewritten settings.
+export const buildSetTarget = {
+    name: "unity_open_mcp_build_set_target",
+    description: "Mutating: switch the active build target via EditorUserBuildSettings.SwitchActiveBuildTarget. " +
+        "The target must be a valid BuildTarget name (use build_get_targets to enumerate). Switching " +
+        "can trigger a recompile / domain reload; the bridge blocks on the post-switch compile via " +
+        "its restart_then_settle lifecycle, and the active-scene dirty guard preflights the call " +
+        "(pass ignore_scene_dirty: true to opt out). Runs the full gate path; `paths_hint` should " +
+        "scope to \"ProjectSettings\" (target switches rewrite ProjectSettings/*.asset).",
+    inputSchema: {
+        type: "object",
+        required: ["target", "paths_hint"],
+        properties: {
+            target: {
+                type: "string",
+                description: "BuildTarget name, e.g. 'StandaloneWindows64', 'iOS', 'Android', 'WebGL'. Parsed " +
+                    "case-insensitively. Use build_get_targets to enumerate valid names.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — pass [\"ProjectSettings\"] so the gate covers the rewritten " +
+                    "settings assets. There is no whole-project fallback.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+                description: "Gate mode. Default 'enforce' — fails the call if the switch surfaces new errors.",
+            },
+            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.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=build-set-target.js.map

package/dist/tools/build-set-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-set-target.js","sourceRoot":"","sources":["../../src/tools/build-set-target.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,yEAAyE;AACzE,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,gGAAgG;QAChG,8FAA8F;QAC9F,4FAA4F;QAC5F,0FAA0F;QAC1F,2FAA2F;QAC3F,iFAAiF;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;QAClC,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kFAAkF;oBAClF,qEAAqE;aACxE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,+EAA+E;oBAC/E,sDAAsD;aACzD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,kFAAkF;aAChG;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,qFAAqF;oBACrF,oFAAoF;oBACpF,sFAAsF;oBACtF,mCAAmC;aACtC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/build-start.d.ts

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

package/dist/tools/build-start.js

@@ -0,0 +1,64 @@
+// M16 Plan 9 — typed player build trigger. Mutating + DESTRUCTIVE:
+// BuildPipeline.BuildPlayer. BuildPlayer is on the default deny list
+// (BridgeDenyList.DefaultCSharpPatterns), so this typed tool mirrors the
+// destructive-menu pattern: it refuses UNLESS the request passes
+// gate: "off" + confirm_bypass: true. When bypassed, the full gate path
+// still runs so the response carries any post-build asset-reference fallout.
+// Folds UCP build/start + UUMCP build_player.
+//
+// paths_hint: the build writes a binary player outside Assets/ and may touch
+// ProjectSettings assets. Agents typically scope paths_hint to the build
+// output folder (and/or "ProjectSettings").
+export const buildStart = {
+    name: "unity_open_mcp_build_start",
+    description: "Mutating + DESTRUCTIVE: trigger a player build via BuildPipeline.BuildPlayer. " +
+        "BuildPlayer is on the default deny list (it is multi-minute and writes a binary player " +
+        "outside Assets/), so this tool REFUSES unless the request passes BOTH gate: \"off\" AND " +
+        "confirm_bypass: true. When bypassed, the full gate path still runs and the response " +
+        "carries any post-build asset-reference fallout. Uses the scenes enabled in build settings " +
+        "(EditorBuildSettings.scenes) and the active build target; pass output_path to choose the " +
+        "destination (defaults to Builds/<target>/Build). development: true adds the Development " +
+        "build option; allow_debugging: true adds AllowDebugging. Returns the BuildReport summary " +
+        "(result, total time, size, errors/warnings, per-step durations). `paths_hint` should scope " +
+        "to the build output folder (and/or \"ProjectSettings\" since build settings can be touched).",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            output_path: {
+                type: "string",
+                description: "Destination for the player build. Defaults to 'Builds/<activeTarget>/Build' when " +
+                    "omitted. The folder is created if missing.",
+            },
+            development: {
+                type: "boolean",
+                default: false,
+                description: "Add the Development build option (BuildOptions.Development).",
+            },
+            allow_debugging: {
+                type: "boolean",
+                default: false,
+                description: "Add the AllowDebugging build option (BuildOptions.AllowDebugging).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — pass the build output folder (e.g. [\"Builds/StandaloneWindows64\"]) " +
+                    "and/or [\"ProjectSettings\"]. There is no whole-project fallback.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+                description: "Gate mode. Must be \"off\" for the build to proceed (BuildPlayer is on the deny list).",
+            },
+            confirm_bypass: {
+                type: "boolean",
+                default: false,
+                description: "Required to proceed. Bypass the deny heuristic for BuildPipeline.BuildPlayer. " +
+                    "Requires gate: \"off\" as well — BOTH flags must be set. The bypass is audited.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=build-start.js.map

package/dist/tools/build-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-start.js","sourceRoot":"","sources":["../../src/tools/build-start.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,qEAAqE;AACrE,yEAAyE;AACzE,iEAAiE;AACjE,wEAAwE;AACxE,6EAA6E;AAC7E,8CAA8C;AAC9C,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,gFAAgF;QAChF,yFAAyF;QACzF,0FAA0F;QAC1F,sFAAsF;QACtF,4FAA4F;QAC5F,2FAA2F;QAC3F,0FAA0F;QAC1F,2FAA2F;QAC3F,6FAA6F;QAC7F,8FAA8F;IAChG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,4CAA4C;aAC/C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,oEAAoE;aAClF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,wFAAwF;oBACxF,mEAAmE;aACtE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,wFAAwF;aAC3F;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,gFAAgF;oBAChF,iFAAiF;aACpF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/capture-inline.d.ts

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

package/dist/tools/capture-inline.js

@@ -0,0 +1,57 @@
+// M20 Plan 1 / T20.1.1 — inline-image capture. Same targets as
+// unity_senses_screenshot (scene / game / isolated) but returns the PNG as an
+// inline base64 image content block instead of writing a temp file. The bridge
+// includes an `inlineImage` field (base64 PNG); the MCP server unwraps it into
+// an MCP image content block so an agent that doesn't read the filesystem
+// still sees the image.
+export const captureInline = {
+    name: "unity_senses_capture_inline",
+    description: "Capture a screenshot and return it as an inline base64 PNG image " +
+        "(no temp file written), so an agent that doesn't read the filesystem can " +
+        "still view it. Supports three views: 'scene' (the Scene view), 'game' " +
+        "(the main camera / Game view), and 'isolated' (a clean 2x2 composite — " +
+        "Front/Right/Back/Top — of a single GameObject with layer culling and " +
+        "background choice). Returns an MCP image content block plus metadata. " +
+        "Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            view: {
+                type: "string",
+                enum: ["scene", "game", "isolated"],
+                default: "scene",
+                description: "Capture target. 'scene' = Scene view camera, 'game' = main game " +
+                    "camera, 'isolated' = clean 2x2 composite of one GameObject.",
+            },
+            width: {
+                type: "integer",
+                default: 1280,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture width in pixels. For 'isolated', this is per-quadrant " +
+                    "(full image is 2x).",
+            },
+            height: {
+                type: "integer",
+                default: 720,
+                minimum: 64,
+                maximum: 4096,
+                description: "Capture height in pixels. For 'isolated', this is per-quadrant " +
+                    "(full image is 2x).",
+            },
+            object_path: {
+                type: "string",
+                description: "Required for 'isolated' view. Hierarchy path of the target " +
+                    "GameObject (e.g. \"Player\" or \"Enemies/Goblin\").",
+            },
+            background: {
+                type: "string",
+                enum: ["transparent", "solid", "skybox"],
+                default: "skybox",
+                description: "Background for 'isolated' view. Ignored for scene/game.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=capture-inline.js.map

package/dist/tools/capture-inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-inline.js","sourceRoot":"","sources":["../../src/tools/capture-inline.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,wBAAwB;AACxB,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,mEAAmE;QACnE,2EAA2E;QAC3E,wEAAwE;QACxE,yEAAyE;QACzE,uEAAuE;QACvE,wEAAwE;QACxE,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;gBACnC,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,kEAAkE;oBAClE,6DAA6D;aAChE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,gEAAgE;oBAChE,qBAAqB;aACxB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,iEAAiE;oBACjE,qBAAqB;aACxB;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6DAA6D;oBAC7D,qDAAqD;aACxD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACxC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,yDAAyD;aACvE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/checkpoint-create.d.ts

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

package/dist/tools/checkpoint-create.js

@@ -0,0 +1,16 @@
+export const checkpointCreate = {
+    name: "unity_open_mcp_checkpoint_create",
+    description: "Create a manual checkpoint for later delta comparison.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            paths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Scope; empty = whole project summary (expensive)",
+            },
+            label: { type: "string" },
+        },
+    },
+};
+//# sourceMappingURL=checkpoint-create.js.map

package/dist/tools/checkpoint-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-create.js","sourceRoot":"","sources":["../../src/tools/checkpoint-create.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE,wDAAwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kDAAkD;aAChE;YACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACF;CACF,CAAC"}

package/dist/tools/compile-check.d.ts

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

package/dist/tools/compile-check.js

@@ -0,0 +1,26 @@
+export const compileCheck = {
+    name: "unity_open_mcp_compile_check",
+    description: "Headless compile check: spawn a batch Unity (no live bridge needed) and return " +
+        "structured C# compiler errors (CSxxxx code, file, line, message) collected across " +
+        "all assemblies. Use this when the live bridge is offline (a compile error put the " +
+        "Editor in a bad state) to self-diagnose whether a project compiles. " +
+        "Batch-only — uses the auto-discovered Unity (OS-default Hub install paths + " +
+        "UNITY_HUB env override), or UNITY_PATH when set. UNITY_PROJECT_PATH is used when " +
+        "set, else the instance lock's projectPath. Returns unity_not_discovered when no " +
+        "Unity install can be found.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            timeout_ms: {
+                type: "integer",
+                default: 300000,
+                minimum: 30000,
+                maximum: 600000,
+                description: "Maximum time to wait for compilation to settle (ms). " +
+                    "Clamped to [30000, 600000].",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=compile-check.js.map

package/dist/tools/compile-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-check.js","sourceRoot":"","sources":["../../src/tools/compile-check.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,iFAAiF;QACjF,oFAAoF;QACpF,oFAAoF;QACpF,sEAAsE;QACtE,8EAA8E;QAC9E,mFAAmF;QACnF,kFAAkF;QAClF,6BAA6B;IAC/B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,uDAAuD;oBACvD,6BAA6B;aAChC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/component-add.d.ts

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

package/dist/tools/component-add.js

@@ -0,0 +1,47 @@
+// M16 Plan 2 — typed component add. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the scene that contains the target.
+export const componentAdd = {
+    name: "unity_open_mcp_component_add",
+    description: "Add one or more Components to a GameObject in the active scene by type name. Undo-recorded. " +
+        "Mutating: runs the full gate path; `paths_hint` is the scene path that contains the host. " +
+        "Each type is resolved by full name (preferred) or class-name fallback; per-type errors " +
+        "(unknown type, not a Component, disallows multiples) are accumulated in the response so a " +
+        "single bad entry does not abort the batch. Use unity_open_mcp_component_list_all to discover " +
+        "attachable types first.",
+    inputSchema: {
+        type: "object",
+        required: ["component_types", "paths_hint"],
+        properties: {
+            component_types: {
+                type: "array",
+                items: { type: "string" },
+                description: "Component type names to add. Each entry may be a fully-qualified type name (preferred) " +
+                    "or a bare class name. Example: [\"UnityEngine.Rigidbody\", \"UnityEngine.BoxCollider\"].",
+            },
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Host GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Host hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Host GameObject name (first match). Lowest priority resolver.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the host.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=component-add.js.map

package/dist/tools/component-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-add.js","sourceRoot":"","sources":["../../src/tools/component-add.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,8FAA8F;QAC9F,4FAA4F;QAC5F,yFAAyF;QACzF,4FAA4F;QAC5F,+FAA+F;QAC/F,yBAAyB;IAC3B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC;QAC3C,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yFAAyF;oBACzF,0FAA0F;aAC7F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yDAAyD;aACvE;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/component-destroy.d.ts

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

package/dist/tools/component-destroy.js

@@ -0,0 +1,46 @@
+// M16 Plan 2 — typed component destroy. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the scene that contains the host.
+export const componentDestroy = {
+    name: "unity_open_mcp_component_destroy",
+    description: "Remove one or more Components from a GameObject in the active scene by type name. " +
+        "Undo-recorded. Mutating: runs the full gate path; `paths_hint` is the scene path that " +
+        "contains the host. Each type is resolved by full name or class-name fallback; per-type " +
+        "errors (unknown type, not present) are accumulated in the response. Use component_list_all " +
+        "to discover attachable types and component_get to inspect a component before removing it.",
+    inputSchema: {
+        type: "object",
+        required: ["component_types", "paths_hint"],
+        properties: {
+            component_types: {
+                type: "array",
+                items: { type: "string" },
+                description: "Component type names to remove (full name preferred, class-name fallback). When a type " +
+                    "allows multiples, only the first match is removed per call.",
+            },
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Host GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Host hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Host GameObject name (first match). Lowest priority resolver.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the host.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=component-destroy.js.map

package/dist/tools/component-destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-destroy.js","sourceRoot":"","sources":["../../src/tools/component-destroy.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,oFAAoF;QACpF,wFAAwF;QACxF,yFAAyF;QACzF,6FAA6F;QAC7F,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC;QAC3C,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yFAAyF;oBACzF,6DAA6D;aAChE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yDAAyD;aACvE;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/component-get.d.ts

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

package/dist/tools/component-get.js

@@ -0,0 +1,54 @@
+// M16 Plan 2 — read-only component get. Gate-free, token-bounded.
+// Returns the serialized field/property list of one component.
+export const componentGet = {
+    name: "unity_open_mcp_component_get",
+    description: "Read the serialized fields and (optionally) public properties of a single Component on a " +
+        "GameObject. Read-only (gate-free). Token-bounded by max_fields. Returns each field's path " +
+        "(SerializedProperty path), type, and current value — including nested arrays and child " +
+        "objects — so an agent can plan a component_modify without trial-and-error. Address the host " +
+        "by instance_id > path > name; identify the component by instance_id (specific instance) or " +
+        "type_name (full name preferred, class-name fallback).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Host GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Host hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Host GameObject name (first match). Lowest priority resolver.",
+            },
+            type_name: {
+                type: "string",
+                description: "Component type to read (full name preferred, class-name fallback). Use this OR " +
+                    "component_instance_id. Ignored when component_instance_id is set.",
+            },
+            component_instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Specific Component instance ID (for types that allow multiples). Takes precedence " +
+                    "over type_name when set.",
+            },
+            max_fields: {
+                type: "integer",
+                default: 100,
+                minimum: 1,
+                description: "Max fields+properties returned; remaining count is reported in 'truncated'.",
+            },
+            include_properties: {
+                type: "boolean",
+                default: true,
+                description: "Include non-serialized public properties (e.g. transform.position, Rigidbody.velocity). " +
+                    "Default true. Set false to read only SerializedObject fields.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=component-get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-get.js","sourceRoot":"","sources":["../../src/tools/component-get.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,2FAA2F;QAC3F,4FAA4F;QAC5F,yFAAyF;QACzF,8FAA8F;QAC9F,6FAA6F;QAC7F,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iFAAiF;oBACjF,mEAAmE;aACtE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,0BAA0B;aAC7B;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,6EAA6E;aAC3F;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,0FAA0F;oBAC1F,+DAA+D;aAClE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/component-list-all.d.ts

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

package/dist/tools/component-list-all.js

@@ -0,0 +1,38 @@
+// M16 Plan 2 — read-only component catalog. Gate-free, token-bounded.
+export const componentListAll = {
+    name: "unity_open_mcp_component_list_all",
+    description: "Enumerate component types that can be attached via AddComponent — built-in + project " +
+        "MonoBehaviours from every loaded assembly. Read-only (gate-free). Token-bounded by " +
+        "max_results. Use the optional `query` substring to narrow by namespace/type-name (case-" +
+        "insensitive, matched against both the full name and the bare class name). Each entry " +
+        "returns fullName (use this in component_add / type_name), name (short class name), " +
+        "namespace, assembly, and builtin flag. Use this before component_add to discover valid type names.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Optional case-insensitive substring filter on the type's full name OR class name. " +
+                    "Example: \"Rigidbody\" matches UnityEngine.Rigidbody and MyNamespace.RigidbodyController.",
+            },
+            max_results: {
+                type: "integer",
+                default: 200,
+                minimum: 1,
+                description: "Max types returned; remaining count is reported in 'truncated'.",
+            },
+            include_builtin: {
+                type: "boolean",
+                default: true,
+                description: "Include Unity built-in components (UnityEngine.* / UnityEditor.* assemblies). Default true.",
+            },
+            include_project: {
+                type: "boolean",
+                default: true,
+                description: "Include project + package MonoBehaviours from loaded assemblies. Default true.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=component-list-all.js.map

package/dist/tools/component-list-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-list-all.js","sourceRoot":"","sources":["../../src/tools/component-list-all.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,uFAAuF;QACvF,qFAAqF;QACrF,yFAAyF;QACzF,uFAAuF;QACvF,qFAAqF;QACrF,oGAAoG;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oFAAoF;oBACpF,2FAA2F;aAC9F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,iEAAiE;aAC/E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,6FAA6F;aAChG;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,gFAAgF;aACnF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/component-modify.d.ts

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

package/dist/tools/component-modify.js

@@ -0,0 +1,80 @@
+// M16 Plan 2 — typed component modify. Mutating: runs the full gate path.
+// Per-path serialized patches via SerializedObject.
+export const componentModify = {
+    name: "unity_open_mcp_component_modify",
+    description: "Modify serialized fields on a Component by path via SerializedObject. Undo-recorded. " +
+        "Mutating: runs the full gate path; `paths_hint` is the scene path that contains the host. " +
+        "`fields` is an array of {path, value, type?} patches where `path` is the SerializedProperty " +
+        "path (e.g. \"m_Color\", \"m_Mass\", \"m_Colors.Array.data[0]\"). Per-entry errors are " +
+        "accumulated, so a single bad patch does not abort the batch. Use component_get first to " +
+        "discover valid paths and value types. Address the host by instance_id > path > name; " +
+        "identify the component by component_instance_id or type_name.",
+    inputSchema: {
+        type: "object",
+        required: ["fields", "paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Host GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Host hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Host GameObject name (first match). Lowest priority resolver.",
+            },
+            type_name: {
+                type: "string",
+                description: "Component type to modify (full name preferred, class-name fallback). Use this OR " +
+                    "component_instance_id. Ignored when component_instance_id is set.",
+            },
+            component_instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Specific Component instance ID. Takes precedence over type_name when set.",
+            },
+            fields: {
+                type: "array",
+                description: "Serialized-property patches to apply in order. Each entry: { path: string, value: any, type?: \"name\" | \"int\" }. " +
+                    "value shape depends on the property's SerializedPropertyType — see component_get output. " +
+                    "For enum properties, set type=\"name\" to set by enum name (default is int index). " +
+                    "For object references, value is {\"path\": \"Assets/...\"} or {\"instance_id\": N} or null.",
+                items: {
+                    type: "object",
+                    required: ["path", "value"],
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "SerializedProperty.propertyPath (e.g. \"m_Color\", \"m_Mass\").",
+                        },
+                        value: {
+                            description: "New value. Scalars/strings/bools as JSON primitives; vectors/colors as [x,y,(z,(w))]; " +
+                                "object references as {\"path\": \"...\"} or null; enums as int (default) or name " +
+                                "(when type=\"name\").",
+                        },
+                        type: {
+                            type: "string",
+                            enum: ["name", "int"],
+                            description: "Optional hint. \"name\" = interpret value as an enum NAME (default is int index).",
+                        },
+                    },
+                    additionalProperties: false,
+                },
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the host.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=component-modify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-modify.js","sourceRoot":"","sources":["../../src/tools/component-modify.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,uFAAuF;QACvF,4FAA4F;QAC5F,8FAA8F;QAC9F,wFAAwF;QACxF,0FAA0F;QAC1F,uFAAuF;QACvF,+DAA+D;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;QAClC,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,mEAAmE;aACtE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,2EAA2E;aAC9E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,sHAAsH;oBACtH,2FAA2F;oBAC3F,qFAAqF;oBACrF,6FAA6F;gBAC/F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;oBAC3B,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iEAAiE;yBAC/E;wBACD,KAAK,EAAE;4BACL,WAAW,EACT,wFAAwF;gCACxF,mFAAmF;gCACnF,uBAAuB;yBAC1B;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;4BACrB,WAAW,EACT,mFAAmF;yBACtF;qBACF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;aACF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yDAAyD;aACvE;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/console-clear.d.ts

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

package/dist/tools/console-clear.js

@@ -0,0 +1,19 @@
+// M16 Plan 5 — typed console clear. Mutates editor console state but touches
+// no assets, so it routes as a gate-free direct-response tool (same footing as
+// unity_senses_read_console, which already clears via `clear: true`).
+// Complements the read side — do NOT duplicate it.
+export const consoleClear = {
+    name: "unity_open_mcp_console_clear",
+    description: "Clear the Unity Editor console. Mutates console state only (no asset " +
+        "writes), so it is gate-free and returns directly without the gate " +
+        "envelope — same footing as unity_senses_read_console with clear: true. " +
+        "Complements read_console (the read side). Prefer this over raw " +
+        "execute_csharp LogEntries.Clear() — schema-validated and surfaced as a " +
+        "first-class tool so a failed clear is visible as a structured error.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=console-clear.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console-clear.js","sourceRoot":"","sources":["../../src/tools/console-clear.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,+EAA+E;AAC/E,sEAAsE;AACtE,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uEAAuE;QACvE,oEAAoE;QACpE,yEAAyE;QACzE,iEAAiE;QACjE,yEAAyE;QACzE,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/console-log.d.ts

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