unity-open-mcp 0.1.0

package/dist/tools/read-console.js

@@ -0,0 +1,57 @@
+export const readConsole = {
+    name: "unity_senses_read_console",
+    description: "Read the Unity Editor console log entries. Filter by type (error/warning/log/all), " +
+        "optionally clear the console, and get structured entries with stack traces. " +
+        "Unity-internal stack frames are stripped by default for readability. " +
+        "Useful after execute_csharp or mutations to check for compile errors, " +
+        "runtime exceptions, or debug logs. Requires a live Unity Editor connection. " +
+        "Token-bounded: `detail` controls stack verbosity, `truncated` always reports " +
+        "how many entries were dropped by `max_entries`.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            type: {
+                type: "string",
+                enum: ["error", "warning", "log", "all"],
+                default: "all",
+                description: "Filter entries by log type.",
+            },
+            clear: {
+                type: "boolean",
+                default: false,
+                description: "Clear the console after reading entries.",
+            },
+            max_entries: {
+                type: "integer",
+                default: 100,
+                minimum: 1,
+                maximum: 1000,
+                description: "Maximum number of entries to return (most recent). " +
+                    "Dropped entries are reported in `truncated`.",
+            },
+            max_stack_frames: {
+                type: "integer",
+                default: 20,
+                minimum: 0,
+                maximum: 100,
+                description: "Maximum stack-trace frames per entry (ignored when detail: verbose).",
+            },
+            include_unity_frames: {
+                type: "boolean",
+                default: false,
+                description: "Include Unity-internal stack frames (UnityEngine, UnityEditor, System). " +
+                    "Off by default for cleaner output. Forced on when detail: verbose.",
+            },
+            detail: {
+                type: "string",
+                enum: ["summary", "normal", "verbose"],
+                default: "normal",
+                description: "Token control. 'summary': message only, no stack traces. " +
+                    "'normal' (default): capped stack with Unity-internal frames stripped. " +
+                    "'verbose': full stack including Unity frames, ignoring max_stack_frames.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=read-console.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-console.js","sourceRoot":"","sources":["../../src/tools/read-console.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,qFAAqF;QACrF,8EAA8E;QAC9E,uEAAuE;QACvE,wEAAwE;QACxE,8EAA8E;QAC9E,+EAA+E;QAC/E,iDAAiD;IACnD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC;gBACxC,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,0CAA0C;aACxD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,qDAAqD;oBACrD,8CAA8C;aACjD;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,sEAAsE;aACpF;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,0EAA0E;oBAC1E,oEAAoE;aACvE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,2DAA2D;oBAC3D,wEAAwE;oBACxE,0EAA0E;aAC7E;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

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

package/dist/tools/regression-check.js

@@ -0,0 +1,36 @@
+export const regressionCheck = {
+    name: "unity_open_mcp_regression_check",
+    description: "Compare current full scan against a baseline file. Returns exitCode 1 when the error count increase exceeds " +
+        "regression_threshold (global) or any per-category threshold, or when the baseline is missing/invalid. " +
+        "per_category_thresholds maps a ruleId to its max tolerated error-count increase; rules absent from the map " +
+        "fall back to regression_threshold. Emits a compact regression summary (with optional per-rule breakdown) " +
+        "suitable for CI logs.",
+    inputSchema: {
+        type: "object",
+        required: ["baseline_path"],
+        properties: {
+            baseline_path: {
+                type: "string",
+                description: "Path to a baseline JSON file created by unity_open_mcp_baseline_create.",
+            },
+            regression_threshold: {
+                type: "integer",
+                default: 0,
+                minimum: 0,
+                description: "Max allowed increase in Error count before the check fails (applied globally).",
+            },
+            per_category_thresholds: {
+                type: "object",
+                additionalProperties: { type: "integer", minimum: 0 },
+                description: "Per-ruleId max tolerated error-count increase. Each key is a ruleId; the value overrides regression_threshold " +
+                    "for that rule. Example: {\"missing_references\": 2}. Rules not named here use regression_threshold.",
+            },
+            platform_profile: {
+                enum: ["mobile", "console", "desktop"],
+                default: "desktop",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=regression-check.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regression-check.js","sourceRoot":"","sources":["../../src/tools/regression-check.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,8GAA8G;QAC9G,wGAAwG;QACxG,6GAA6G;QAC7G,2GAA2G;QAC3G,uBAAuB;IACzB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,UAAU,EAAE;YACV,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;aACvF;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,gFAAgF;aAC9F;YACD,uBAAuB,EAAE;gBACvB,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACrD,WAAW,EACT,gHAAgH;oBAChH,qGAAqG;aACxG;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/reserialize.d.ts

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

package/dist/tools/reserialize.js

@@ -0,0 +1,31 @@
+export const reserialize = {
+    name: "unity_open_mcp_reserialize",
+    description: "Round-trip text-serialized assets through Unity's native serializer (AssetDatabase.ForceReserializeAssets). " +
+        "Use after directly editing a .prefab/.unity/.asset/.mat/.controller/.anim as YAML to normalize formatting and surface missing fields, wrong indents, or stale fileIDs. " +
+        "By default round-trips asset YAML only — the companion .meta is left untouched, so direct body edits produce no meta noise. " +
+        "Pass include_meta: true to also re-serialize importer metadata (use only for upgrade/importer-change workflows). " +
+        "Mutating: runs the full gate path (checkpoint -> reserialize -> validate -> delta). The `paths` array doubles as the gate's paths_hint scope.",
+    inputSchema: {
+        type: "object",
+        required: ["paths"],
+        properties: {
+            paths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Asset paths to reserialize (e.g. [\"Assets/Prefabs/Player.prefab\"]). Must be non-empty. Supported extensions: .prefab, .unity, .asset, .mat, .controller, .anim. Whole-project reserialize is not supported — enumerate explicitly.",
+            },
+            include_meta: {
+                type: "boolean",
+                default: false,
+                description: "When true, also round-trip each asset's companion .meta (ReserializeAssetsAndMetadata). Default false round-trips asset YAML only — this avoids spurious .meta churn (e.g. userData: vs userData: ) when only the asset body was edited. Set true only for upgrade or importer-change workflows that intentionally re-serialize importer metadata.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+                description: "Gate mode. Default 'enforce' — fails the call if the round-trip surfaces new errors.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=reserialize.js.map

package/dist/tools/reserialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserialize.js","sourceRoot":"","sources":["../../src/tools/reserialize.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,8GAA8G;QAC9G,yKAAyK;QACzK,8HAA8H;QAC9H,mHAAmH;QACnH,+IAA+I;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sOAAsO;aACzO;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,oVAAoV;aACvV;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,sFAAsF;aACpG;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/run-tests.d.ts

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

package/dist/tools/run-tests.js

@@ -0,0 +1,49 @@
+export const runTests = {
+    name: "unity_senses_run_tests",
+    description: "Run Unity EditMode or PlayMode tests and return structured results. " +
+        "EditMode runs in-process and results are available within seconds. " +
+        "PlayMode survives domain reload via file handoff. " +
+        "Filter by assembly, namespace, class, or method name.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            play_mode: {
+                type: "boolean",
+                default: false,
+                description: "Run PlayMode tests instead of EditMode. Requires domain reload.",
+            },
+            assembly_name: {
+                type: "string",
+                description: "Filter: run tests in this assembly only (e.g. 'MyAssembly').",
+            },
+            test_namespace: {
+                type: "string",
+                description: "Filter: run tests under this namespace.",
+            },
+            test_class: {
+                type: "string",
+                description: "Filter: run tests in this class (full or partial name).",
+            },
+            test_method: {
+                type: "string",
+                description: "Filter: run only this test method (fully qualified name).",
+            },
+            include_passes: {
+                type: "boolean",
+                default: true,
+                description: "Include passing tests in the results array. Set false to return " +
+                    "only failures/inconclusive — the summary still reports the full " +
+                    "counts. Recommended for large suites to avoid truncation.",
+            },
+            timeout_ms: {
+                type: "integer",
+                default: 60000,
+                minimum: 1000,
+                maximum: 600000,
+                description: "Maximum time to wait for results (PlayMode may take longer due to domain reload).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=run-tests.js.map

package/dist/tools/run-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../src/tools/run-tests.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,sEAAsE;QACtE,qEAAqE;QACrE,oDAAoD;QACpD,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;aACvE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,kEAAkE;oBAClE,kEAAkE;oBAClE,2DAA2D;aAC9D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,mFAAmF;aACtF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scan-all.d.ts

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

package/dist/tools/scan-all.js

@@ -0,0 +1,25 @@
+export const scanAll = {
+    name: "unity_open_mcp_scan_all",
+    description: "Full project scan using all ported verify rules. Runs in batch mode (headless Unity) — no open Editor required. Returns severity counts, per-rule summaries, timing, and issue details. exitCode 0 = pass, 1 = issues above fail_on_severity threshold.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            platform_profile: {
+                enum: ["mobile", "console", "desktop"],
+                default: "desktop",
+                description: "Stored in output metadata; does not filter rules in M5.",
+            },
+            fail_on_severity: {
+                enum: ["error", "warn", "info", "verbose", "never"],
+                default: "warn",
+                description: "Severity threshold for exit code. 'warn' = fail on any error or warning.",
+            },
+            output_path: {
+                type: "string",
+                description: "Optional JSON report path inside project (relative to project root or absolute).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scan-all.js.map

package/dist/tools/scan-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-all.js","sourceRoot":"","sources":["../../src/tools/scan-all.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,yPAAyP;IAC3P,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,yDAAyD;aACvE;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACnD,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,0EAA0E;aACxF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kFAAkF;aAChG;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scan-paths.d.ts

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

package/dist/tools/scan-paths.js

@@ -0,0 +1,40 @@
+export const scanPaths = {
+    name: "unity_open_mcp_scan_paths",
+    description: "Run one or more ported verify rules scoped to paths. For a single rule, pass categories: [\"missing_references\"]. " +
+        "Unknown rule IDs error with availableRules. Use include_rules / exclude_rules to filter the auto-selected set " +
+        "(exclude always wins; include narrows an explicit categories list, otherwise it is additive). " +
+        "fail_on_severity defaults to the project setting verify.severityThreshold in .unity-open-mcp/settings.json. " +
+        "Each issue carries ruleId + categoryId (alias), severity, code + issueCode (alias), assetPath, description, " +
+        "and fixId + fixSafe when a fix is available. rulesApplied lists the post-filter rule set.",
+    inputSchema: {
+        type: "object",
+        required: ["paths"],
+        properties: {
+            paths: { type: "array", items: { type: "string" }, description: "Asset paths to scan" },
+            categories: {
+                type: "array",
+                items: { type: "string" },
+                description: "Verify rule IDs; auto-selected from paths if omitted. Unknown IDs error with availableRules.",
+            },
+            include_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Allow-list applied to the resolved rule set. When `categories` is set, include_rules narrows to their intersection; " +
+                    "without `categories` it is additive on top of the auto-selected set.",
+            },
+            exclude_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Deny-list. Always wins over categories and include_rules.",
+            },
+            platform_profile: { enum: ["mobile", "console", "desktop"], default: "desktop" },
+            fail_on_severity: {
+                enum: ["error", "warn", "info", "verbose", "never"],
+                description: "Severity threshold for the `passed` flag. Omit to use the project default " +
+                    "(verify.severityThreshold in .unity-open-mcp/settings.json; falls back to `error`).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scan-paths.js.map

package/dist/tools/scan-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-paths.js","sourceRoot":"","sources":["../../src/tools/scan-paths.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,qHAAqH;QACrH,gHAAgH;QAChH,gGAAgG;QAChG,8GAA8G;QAC9G,8GAA8G;QAC9G,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE;YACvF,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,8FAA8F;aACjG;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sHAAsH;oBACtH,sEAAsE;aACzE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;YAChF,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACnD,WAAW,EACT,4EAA4E;oBAC5E,qFAAqF;aACxF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

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

package/dist/tools/scene-create.js

@@ -0,0 +1,47 @@
+// M16 Plan 3 — typed scene create. Mutating: writes a new .unity asset and
+// opens it. Runs the full gate path; `paths_hint` is the new .unity path.
+export const sceneCreate = {
+    name: "unity_open_mcp_scene_create",
+    description: "Create a new scene asset and save it at the given `.unity` path, opening it in the editor. " +
+        "Mutating: runs the full gate path; `paths_hint` should be the new `.unity` asset path. " +
+        "Returns the new scene's name, path, isDirty, isLoaded, rootCount, and buildIndex so the " +
+        "agent can chain scene_get_data / gameobject_create / scene_save without an extra lookup. " +
+        "Prefer this over raw execute_csharp EditorSceneManager.NewScene — schema-validated, " +
+        "undo-recorded, and the gate surfaces asset-reference fallout.",
+    inputSchema: {
+        type: "object",
+        required: ["path", "paths_hint"],
+        properties: {
+            path: {
+                type: "string",
+                description: "Destination asset path. Must start with 'Assets/' (or be relative to the project " +
+                    "root) and end with '.unity'. Intermediate folders must already exist.",
+            },
+            setup: {
+                type: "string",
+                enum: ["empty", "default"],
+                default: "empty",
+                description: "New-scene setup. 'empty' = NewSceneSetup.EmptyScene (no objects); 'default' = " +
+                    "NewSceneSetup.DefaultGameObjects (camera + directional light). Defaults to 'empty'.",
+            },
+            mode: {
+                type: "string",
+                enum: ["single", "additive"],
+                default: "single",
+                description: "New-scene mode. 'single' closes currently opened scenes and opens this one; " +
+                    "'additive' keeps currently opened scenes and opens this one alongside them.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the new `.unity` asset path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-create.js","sourceRoot":"","sources":["../../src/tools/scene-create.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,6FAA6F;QAC7F,yFAAyF;QACzF,0FAA0F;QAC1F,2FAA2F;QAC3F,sFAAsF;QACtF,+DAA+D;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,uEAAuE;aAC1E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC1B,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,gFAAgF;oBAChF,qFAAqF;aACxF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,8EAA8E;oBAC9E,6EAA6E;aAChF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;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/scene-focus.d.ts

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

package/dist/tools/scene-focus.js

@@ -0,0 +1,55 @@
+// M16 Plan 3 — typed scene focus. Mutating: moves the SceneView camera onto
+// a GameObject (folds UCP scene/focus). Runs the full gate path.
+export const sceneFocus = {
+    name: "unity_open_mcp_scene_focus",
+    description: "Frame a GameObject in the SceneView camera and optionally set a view axis. Mutating: runs " +
+        "the full gate path; `paths_hint` should be the scene path containing the target. Computes " +
+        "the target's combined renderer+collider bounds and calls SceneView.LookAtDirect, so the " +
+        "agent can point the editor at a specific object before screenshot or before a human takes " +
+        "over. Returns the resulting SceneView pivot / camera position / rotation / size and the " +
+        "resolved axis. Resolve the target by `instance_id` (canonical) or `path` / `name`, matching " +
+        "spatial_query and gameobject_find. Prefer this over raw execute_csharp SceneView.lastActiveSceneView.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Instance ID of the target GameObject (canonical address).",
+            },
+            path: {
+                type: "string",
+                description: "Hierarchy path of the target GameObject (fallback address).",
+            },
+            name: {
+                type: "string",
+                description: "Target GameObject name (lowest priority address).",
+            },
+            axis: {
+                type: "string",
+                enum: ["top", "bottom", "front", "back", "left", "right"],
+                description: "Optional view axis to orient the SceneView camera. Omit to keep the current rotation. " +
+                    "top = look straight down (–Y), bottom = +Y, front = look along –Z, back = +Z, " +
+                    "left = look along +X, right = –X.",
+            },
+            size: {
+                type: "number",
+                minimum: 0,
+                description: "Optional SceneView size (half-extent of the framing box). Omit to derive from the " +
+                    "target bounds.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path containing the target.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-focus.js.map

package/dist/tools/scene-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-focus.js","sourceRoot":"","sources":["../../src/tools/scene-focus.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,4FAA4F;QAC5F,4FAA4F;QAC5F,0FAA0F;QAC1F,4FAA4F;QAC5F,0FAA0F;QAC1F,8FAA8F;QAC9F,uGAAuG;IACzG,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,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;gBACzD,WAAW,EACT,wFAAwF;oBACxF,gFAAgF;oBAChF,mCAAmC;aACtC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,gBAAgB;aACnB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,wDAAwD;aACtE;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/scene-get-data.d.ts

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

package/dist/tools/scene-get-data.js

@@ -0,0 +1,52 @@
+// M16 Plan 3 — read-only scene get data. Gate-free. The structured scene
+// hierarchy read that supersedes the standalone M10 scene snapshot (T3.8)
+// and folds UUMCP summarize / hierarchy_describe into `detail`/`summary`
+// modes. Bounded output drives see-edit-verify loops.
+export const sceneGetData = {
+    name: "unity_open_mcp_scene_get_data",
+    description: "Read the hierarchy of an opened scene as compact, drill-down structured data. Read-only " +
+        "(gate-free). Supersedes the standalone M10 scene snapshot and folds UUMCP summarize / " +
+        "hierarchy_describe into the `detail` modes below. Default (`detail: 'summary'`) returns a " +
+        "cheap overview — scene name/path/isDirty/isLoaded/rootCount/buildIndex + a root-GameObject " +
+        "roster with name + childCount + components (no nested children). `detail: 'normal'` adds " +
+        "the first `depth` levels of nested children with per-node active/tag/layer/component set. " +
+        "`detail: 'verbose'` adds per-node transform (position/rotation/scale) and instance_id so the " +
+        "agent can chain gameobject_modify / component_modify without an extra lookup. " +
+        "Use scene_list_opened to enumerate scenes. Prefer this over read_asset on the .unity file " +
+        "(which is YAML-heavy and does not reflect unsaved editor state).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Opened scene name. Omit (or empty) to read the active scene. Use scene_list_opened " +
+                    "to enumerate opened scene names.",
+            },
+            detail: {
+                type: "string",
+                enum: ["summary", "normal", "verbose"],
+                default: "summary",
+                description: "Output detail. 'summary' (default): scene overview + root-GameObject roster " +
+                    "(name/childCount/components, no nested children). 'normal': + nested children to " +
+                    "`depth` with active/tag/layer/component set. 'verbose': + per-node instance_id and " +
+                    "transform (position/rotation/scale).",
+            },
+            depth: {
+                type: "integer",
+                default: 3,
+                minimum: 0,
+                description: "Max hierarchy depth to emit when detail is 'normal' or 'verbose'. 0 = roots only. " +
+                    "Nodes past the cap are counted in `moreHidden` per-root, not emitted.",
+            },
+            max_nodes: {
+                type: "integer",
+                default: 200,
+                minimum: 1,
+                description: "Hard cap on total nodes emitted across all roots (controls token budget). Remaining " +
+                    "nodes are counted in `truncated`. Defaults to 200.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-get-data.js.map

package/dist/tools/scene-get-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-get-data.js","sourceRoot":"","sources":["../../src/tools/scene-get-data.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,0EAA0E;AAC1E,yEAAyE;AACzE,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,0FAA0F;QAC1F,wFAAwF;QACxF,4FAA4F;QAC5F,6FAA6F;QAC7F,2FAA2F;QAC3F,4FAA4F;QAC5F,+FAA+F;QAC/F,gFAAgF;QAChF,4FAA4F;QAC5F,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qFAAqF;oBACrF,kCAAkC;aACrC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,8EAA8E;oBAC9E,mFAAmF;oBACnF,qFAAqF;oBACrF,sCAAsC;aACzC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,uEAAuE;aAC1E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,sFAAsF;oBACtF,oDAAoD;aACvD;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-get-dirty-summary.d.ts

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

package/dist/tools/scene-get-dirty-summary.js

@@ -0,0 +1,17 @@
+// M16 Plan 3 — read-only dirty summary. Gate-free. Per-scene summary of
+// unsaved changes (folds UCP scene/dirty-summary).
+export const sceneGetDirtySummary = {
+    name: "unity_open_mcp_scene_get_dirty_summary",
+    description: "Summarize unsaved changes per opened scene (which scenes are dirty, plus a per-scene change " +
+        "tally). Read-only (gate-free). Use before scene_save / scene_unload / scene_open to decide " +
+        "whether to save first. The response lists every opened scene with name/path/isDirty/" +
+        "rootCount, marking dirty ones, so the agent can prompt the user or auto-save before a " +
+        "destructive op. Prefer this over raw execute_csharp scene.isDirty — structured, all-scenes " +
+        "in one call.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-get-dirty-summary.js.map

package/dist/tools/scene-get-dirty-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-get-dirty-summary.js","sourceRoot":"","sources":["../../src/tools/scene-get-dirty-summary.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,8FAA8F;QAC9F,6FAA6F;QAC7F,sFAAsF;QACtF,wFAAwF;QACxF,6FAA6F;QAC7F,cAAc;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-list-opened.d.ts

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

package/dist/tools/scene-list-opened.js

@@ -0,0 +1,16 @@
+// M16 Plan 3 — read-only scene list opened. Gate-free. Enumerates every
+// opened scene as a shallow snapshot.
+export const sceneListOpened = {
+    name: "unity_open_mcp_scene_list_opened",
+    description: "List every scene currently opened in the Unity Editor as a shallow snapshot (name, path, " +
+        "isDirty, isLoaded, rootCount, buildIndex, isActive). Read-only (gate-free). Use scene_get_data " +
+        "for the deep hierarchy view of a specific scene. Prefer this over raw execute_csharp " +
+        "SceneManager.sceneCount — structured output + addressing parity with the rest of the typed " +
+        "scene surface.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-list-opened.js.map

package/dist/tools/scene-list-opened.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-list-opened.js","sourceRoot":"","sources":["../../src/tools/scene-list-opened.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,2FAA2F;QAC3F,iGAAiG;QACjG,uFAAuF;QACvF,6FAA6F;QAC7F,gBAAgB;IAClB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-open.d.ts

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

package/dist/tools/scene-open.js

@@ -0,0 +1,48 @@
+// M16 Plan 3 — typed scene open. Mutating: closes/keeps currently opened
+// scenes and loads the target scene asset. Runs the full gate path.
+export const sceneOpen = {
+    name: "unity_open_mcp_scene_open",
+    description: "Open a Unity scene asset from disk in Single or Additive mode. Mutating: runs the full gate " +
+        "path; `paths_hint` should be the target `.unity` asset path (and any currently-open scene " +
+        "paths when `mode: 'single'` closes them). Single mode closes currently opened scenes (Unity " +
+        "may prompt to save dirty scenes — see `ignore_scene_dirty`); Additive keeps them open. " +
+        "Returns the post-open list of all opened scenes (name/path/isDirty/isLoaded/rootCount/" +
+        "buildIndex/isActive) so the agent can confirm state and chain scene_set_active / scene_get_data. " +
+        "Prefer this over raw execute_csharp EditorSceneManager.OpenScene.",
+    inputSchema: {
+        type: "object",
+        required: ["path", "paths_hint"],
+        properties: {
+            path: {
+                type: "string",
+                description: "Asset path of the scene to open (must end with '.unity'). Must exist on disk.",
+            },
+            mode: {
+                type: "string",
+                enum: ["single", "additive"],
+                default: "single",
+                description: "'single' (default) closes currently opened scenes and opens this one; 'additive' " +
+                    "keeps currently opened scenes open and opens this one alongside them.",
+            },
+            ignore_scene_dirty: {
+                type: "boolean",
+                default: false,
+                description: "When true, proceed even if currently opened scenes are dirty (Unity may otherwise " +
+                    "prompt to save). Default false: the bridge refuses when opened scenes are dirty to " +
+                    "avoid losing unsaved changes.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the target `.unity` asset path. Include currently-open scene paths " +
+                    "too when `mode: 'single'` would close them.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=scene-open.js.map

package/dist/tools/scene-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-open.js","sourceRoot":"","sources":["../../src/tools/scene-open.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,oEAAoE;AACpE,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,8FAA8F;QAC9F,4FAA4F;QAC5F,8FAA8F;QAC9F,yFAAyF;QACzF,wFAAwF;QACxF,mGAAmG;QACnG,mEAAmE;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+EAA+E;aAClF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,mFAAmF;oBACnF,uEAAuE;aAC1E;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,oFAAoF;oBACpF,qFAAqF;oBACrF,+BAA+B;aAClC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sFAAsF;oBACtF,6CAA6C;aAChD;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/scene-save.d.ts

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