unity-open-mcp 0.1.0

package/dist/tools/profiler-get-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-get-config.js","sourceRoot":"","sources":["../../src/tools/profiler-get-config.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,2EAA2E;AAC3E,qEAAqE;AACrE,uEAAuE;AACvE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,2EAA2E;QAC3E,sEAAsE;QACtE,gFAAgF;QAChF,gFAAgF;QAChF,oFAAoF;QACpF,sFAAsF;QACtF,qEAAqE;IACvE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-get-script-stats.d.ts

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

package/dist/tools/profiler-get-script-stats.js

@@ -0,0 +1,20 @@
+// M16 Plan 7 — typed script-stats read. Read-only, gate-free. Folds UMCP
+// `profiler-get-script-stats`. Surfaces script execution timing from Time
+// (deltaTime / fixedDeltaTime / timeScale / frameCount / realtimeSinceStartup)
+// plus Mono + GC managed-heap usage — complementary to the per-frame
+// profiler_capture hierarchy and the live allocator profiler_memory snapshot.
+export const profilerGetScriptStats = {
+    name: "unity_open_mcp_profiler_get_script_stats",
+    description: "Snapshot script execution timing and managed-memory usage from a single call: frame time " +
+        "(Time.deltaTime*1000 in ms), fixed delta time (Time.fixedDeltaTime*1000 in ms), time scale, " +
+        "total frame count, realtime since startup, Mono used memory (Profiler.GetMonoUsedSizeLong " +
+        "in MB), and GC total memory (GC.GetTotalMemory in MB). Read-only and gate-free. Single- " +
+        "frame snapshot — for historical frame data use the Profiler window or " +
+        "unity_senses_profiler_capture; for live allocator bytes use unity_senses_profiler_memory.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-get-script-stats.js.map

package/dist/tools/profiler-get-script-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-get-script-stats.js","sourceRoot":"","sources":["../../src/tools/profiler-get-script-stats.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,0EAA0E;AAC1E,+EAA+E;AAC/E,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,IAAI,EAAE,0CAA0C;IAChD,WAAW,EACT,2FAA2F;QAC3F,8FAA8F;QAC9F,4FAA4F;QAC5F,0FAA0F;QAC1F,wEAAwE;QACxE,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-get-status.d.ts

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

package/dist/tools/profiler-get-status.js

@@ -0,0 +1,22 @@
+// M16 Plan 7 — typed profiler status read. Read-only, gate-free. Folds UMCP
+// `profiler-get-status` and UCP `profiler/status`. Does NOT duplicate M10 —
+// unity_senses_profiler_memory / profiler_rendering / profiler_capture are the
+// per-frame / allocator / GPU reads; this tool returns the runtime flag, max
+// used memory high-water mark, platform support, and the local module
+// bookkeeping set.
+export const profilerGetStatus = {
+    name: "unity_open_mcp_profiler_get_status",
+    description: "Snapshot the runtime profiler's current state: enabled flag, platform support " +
+        "(Profiler.supported), max-used-memory high-water mark (Profiler.maxUsedMemory), and " +
+        "the local module bookkeeping set (see profiler_list_modules / profiler_enable_module). " +
+        "Read-only and gate-free. Pair with profiler_start / profiler_stop to drive the enabled " +
+        "flag. For per-frame hierarchy / live allocator bytes / GPU + QualitySettings batch use " +
+        "unity_senses_profiler_capture / profiler_memory / profiler_rendering instead — this tool " +
+        "is only the runtime-status surface.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-get-status.js.map

package/dist/tools/profiler-get-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-get-status.js","sourceRoot":"","sources":["../../src/tools/profiler-get-status.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,mBAAmB;AACnB,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,gFAAgF;QAChF,sFAAsF;QACtF,yFAAyF;QACzF,yFAAyF;QACzF,yFAAyF;QACzF,2FAA2F;QAC3F,qCAAqC;IACvC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-list-modules.d.ts

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

package/dist/tools/profiler-list-modules.js

@@ -0,0 +1,20 @@
+// M16 Plan 7 — typed profiler module list. Read-only, gate-free. Folds UMCP
+// `profiler-list-modules`. Returns the canonical Profiler window module names
+// (CPU / GPU / Rendering / Memory / Audio / Video / Physics / Physics2D /
+// NetworkMessages / NetworkOperations / UI / UIDetails / GlobalIllumination /
+// VirtualTexturing) with the local enabled bookkeeping flag each.
+export const profilerListModules = {
+    name: "unity_open_mcp_profiler_list_modules",
+    description: "List every known Profiler window module name (CPU, GPU, Rendering, Memory, Audio, Video, " +
+        "Physics, Physics2D, NetworkMessages, NetworkOperations, UI, UIDetails, " +
+        "GlobalIllumination, VirtualTexturing) with the local enabled bookkeeping flag for each. " +
+        "Read-only and gate-free. The enabled flag is local bookkeeping only — Unity's runtime API " +
+        "does not expose programmatic per-module toggling; actual module visibility is controlled " +
+        "from the Profiler window. Pair with profiler_enable_module to flip the flag.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-list-modules.js.map

package/dist/tools/profiler-list-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-list-modules.js","sourceRoot":"","sources":["../../src/tools/profiler-list-modules.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,kEAAkE;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EACT,2FAA2F;QAC3F,yEAAyE;QACzE,0FAA0F;QAC1F,4FAA4F;QAC5F,2FAA2F;QAC3F,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-load-data.d.ts

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

package/dist/tools/profiler-load-data.js

@@ -0,0 +1,38 @@
+// M16 Plan 7 — typed profiler snapshot read-back. Read-only (reads a file
+// previously written by profiler_save_data); gate-free direct-response tool.
+// Folds UMCP `profiler-load-data` and UCP `profiler/capture/load`. UCP also
+// calls Profiler.AddFramesFromFile to load the capture back into the Editor
+// Profiler; this tool surfaces BOTH the raw JSON text (caller parses) and an
+// `addedToProfiler` boolean so the agent knows whether the frames are now
+// browsable in the Profiler window.
+export const profilerLoadData = {
+    name: "unity_open_mcp_profiler_load_data",
+    description: "Read back a previously-saved profiler JSON snapshot and optionally push its frames back " +
+        "into the Editor Profiler window. Read-only file access; gate-free. The source path must " +
+        "live inside the project root, end in `.json`, and be under a 10 MB cap (rejects oversized " +
+        "files up-front to avoid OOM). Returns the raw JSON text plus an `addedToProfiler` flag — " +
+        "when `add_to_profiler: true` (default false), Profiler.AddFramesFromFile is invoked so the " +
+        "frames are browsable in the Profiler window (no-op for non-binary snapshots; surfaces a " +
+        "warning). Use profiler_save_data to write a snapshot first.",
+    inputSchema: {
+        type: "object",
+        required: ["file_path"],
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Path to a snapshot previously written by profiler_save_data. Must be project-relative, " +
+                    "end in `.json`, and live under the project root. Must be under 10 MB.",
+            },
+            add_to_profiler: {
+                type: "boolean",
+                default: false,
+                description: "When true, also call Profiler.AddFramesFromFile so the frames are browsable in the " +
+                    "Profiler window. JSON snapshots saved by profiler_save_data are NOT raw binary " +
+                    "captures, so AddFramesFromFile will refuse them — the request surfaces as a warning " +
+                    "and the raw JSON is still returned. Set true only if you have a real .raw capture.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-load-data.js.map

package/dist/tools/profiler-load-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-load-data.js","sourceRoot":"","sources":["../../src/tools/profiler-load-data.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,0EAA0E;AAC1E,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,0FAA0F;QAC1F,0FAA0F;QAC1F,4FAA4F;QAC5F,2FAA2F;QAC3F,6FAA6F;QAC7F,0FAA0F;QAC1F,6DAA6D;IAC/D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yFAAyF;oBACzF,uEAAuE;aAC1E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,qFAAqF;oBACrF,iFAAiF;oBACjF,sFAAsF;oBACtF,oFAAoF;aACvF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-memory.d.ts

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

package/dist/tools/profiler-memory.js

@@ -0,0 +1,21 @@
+export const profilerMemory = {
+    name: "unity_senses_profiler_memory",
+    description: "Snapshot live Unity memory allocator stats: total allocated, reserved, " +
+        "unused reserved, temp allocator size, and the managed (GC) heap. Both " +
+        "raw byte counts and human-readable strings are returned. Set " +
+        "gc_collect=true to run a full GC first for a stable baseline. Requires " +
+        "a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            gc_collect: {
+                type: "boolean",
+                default: false,
+                description: "Run a full GC.Collect (with finalizers) before sampling for a " +
+                    "stable baseline.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-memory.js.map

package/dist/tools/profiler-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-memory.js","sourceRoot":"","sources":["../../src/tools/profiler-memory.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,yEAAyE;QACzE,wEAAwE;QACxE,+DAA+D;QAC/D,yEAAyE;QACzE,iCAAiC;IACnC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,gEAAgE;oBAChE,kBAAkB;aACrB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-rendering.d.ts

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

package/dist/tools/profiler-rendering.js

@@ -0,0 +1,14 @@
+export const profilerRendering = {
+    name: "unity_senses_profiler_rendering",
+    description: "Snapshot the rendering environment: GPU / SystemInfo, active render " +
+        "pipeline (URP/HDRP/Built-in), QualitySettings, screen resolution and " +
+        "refresh rate, target frame rate, and Time stats. For per-frame batch / " +
+        "draw-call counts use unity_senses_profiler_capture. Requires a live " +
+        "Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-rendering.js.map

package/dist/tools/profiler-rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-rendering.js","sourceRoot":"","sources":["../../src/tools/profiler-rendering.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,sEAAsE;QACtE,uEAAuE;QACvE,yEAAyE;QACzE,sEAAsE;QACtE,0BAA0B;IAC5B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-save-data.d.ts

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

package/dist/tools/profiler-save-data.js

@@ -0,0 +1,38 @@
+// M16 Plan 7 — typed profiler snapshot save. Mutating: writes a JSON snapshot
+// to disk (composed from the read surfaces already in this tool family —
+// status / memory / rendering / script / frame — so the shape stays in sync).
+// Runs the full gate path with paths_hint scoped to the destination path.
+// Folds UMCP `profiler-save-data` and UCP `profiler/capture/save` (the .json
+// structured-snapshot path; UCP's binary-log path is editor-runtime-gated and
+// folds into profiler_set_config's binary_log warning surface instead).
+export const profilerSaveData = {
+    name: "unity_open_mcp_profiler_save_data",
+    description: "Save a structured JSON profiler snapshot to a path. Composes the runtime status, memory " +
+        "allocator stats, rendering environment, script timing, and a single-frame capture into one " +
+        "document and writes it (parent directories are created). Mutating: runs the full gate path; " +
+        "`paths_hint` must be scoped to the destination file path. The destination must live inside " +
+        "the project root and end in `.json`. Read back via profiler_load_data.",
+    inputSchema: {
+        type: "object",
+        required: ["file_path", "paths_hint"],
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Destination path for the snapshot. Must be project-relative, end in `.json`, and live " +
+                    "under the project root (`..` and absolute-outside paths are refused). Parent " +
+                    "directories are created.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the destination `.json` path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-save-data.js.map

package/dist/tools/profiler-save-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-save-data.js","sourceRoot":"","sources":["../../src/tools/profiler-save-data.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,0FAA0F;QAC1F,6FAA6F;QAC7F,8FAA8F;QAC9F,6FAA6F;QAC7F,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QACrC,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;oBACxF,+EAA+E;oBAC/E,0BAA0B;aAC7B;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,gDAAgD;aAC9D;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/profiler-set-config.d.ts

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

package/dist/tools/profiler-set-config.js

@@ -0,0 +1,72 @@
+// M16 Plan 7 — typed profiler config mutator. Mutates editor state but writes
+// NO assets; gate-free direct-response tool. Folds UCP `profiler/config/set`.
+// Only the knobs Unity's runtime API exposes for in-place writes are honored;
+// the rest are reported as warnings (the request is recorded, the value is
+// not applied). Returns the post-write config (same shape as
+// profiler_get_config) plus a warnings[] list of any non-applicable knobs.
+export const profilerSetConfig = {
+    name: "unity_open_mcp_profiler_set_config",
+    description: "Update one or more profiler runtime knobs in a single call: mode (\"play\" or \"edit\" — " +
+        "edit-mode targeting requires a supported Unity version), deepProfile (deep profiling — high " +
+        "overhead), allocationCallstacks (capture GC.Alloc callstacks — high overhead), binaryLog " +
+        "(Editor runtime usually ignores this; reported as a warning when not applied), output (the " +
+        "Profiler.logFile path; parent dirs are created), maxUsedMemory (bytes; clamped to a safe " +
+        "editor budget), enableCategories[] / disableCategories[] (ProfilerCategory name toggles). " +
+        "Mutates editor state only (no asset writes); gate-free. Returns the post-write config plus " +
+        "a warnings[] list of any knobs that were recorded but not applied on this Unity version. " +
+        "Use profiler_start / profiler_stop to flip the enabled flag itself.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            mode: {
+                type: "string",
+                enum: ["play", "edit"],
+                description: "Edit-vs-play targeting. \"play\" enters play mode if not already there; \"edit\" " +
+                    "exits play mode. The matching Editor ProfilerDriver.profileEditor knob is also flipped " +
+                    "on supported Unity versions. Reported as a warning when profileEditor automation is " +
+                    "unavailable.",
+            },
+            deep_profile: {
+                type: "boolean",
+                description: "Toggle deep profiling (every method call instrumented). High runtime overhead; " +
+                    "toggling at runtime only takes effect on supported Unity versions.",
+            },
+            allocation_callstacks: {
+                type: "boolean",
+                description: "Toggle GC.Alloc callstack capture. Adds noticeable profiler overhead and can trigger " +
+                    "frame drops / heavy editor memory pressure during longer captures.",
+            },
+            binary_log: {
+                type: "boolean",
+                description: "Toggle Profiler.enableBinaryLog. The Unity Editor keeps this disabled at runtime — a " +
+                    "true request is recorded but reported as a warning (raw binary capture requires a " +
+                    "player build or manual Profiler window export).",
+            },
+            output: {
+                type: "string",
+                description: "Profiler.logFile path. Parent directories are created. Used together with binary_log " +
+                    "(when the Editor honors it).",
+            },
+            max_used_memory: {
+                type: "integer",
+                minimum: 0,
+                description: "Profiler.maxUsedMemory in bytes. Clamped to a safe editor budget (minimum 16 MiB, " +
+                    "absolute cap depends on whether deep_profile / allocation_callstacks are on).",
+            },
+            enable_categories: {
+                type: "array",
+                items: { type: "string" },
+                description: "ProfilerCategory names to enable (e.g. \"Render\", \"Memory\", \"Physics\"). Unknown " +
+                    "names are reported as warnings; the open Profiler window can override category " +
+                    "settings to match active charts.",
+            },
+            disable_categories: {
+                type: "array",
+                items: { type: "string" },
+                description: "ProfilerCategory names to disable. Same behavior as enable_categories for unknown names.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-set-config.js.map

package/dist/tools/profiler-set-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-set-config.js","sourceRoot":"","sources":["../../src/tools/profiler-set-config.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,6DAA6D;AAC7D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,2FAA2F;QAC3F,8FAA8F;QAC9F,2FAA2F;QAC3F,6FAA6F;QAC7F,2FAA2F;QAC3F,4FAA4F;QAC5F,6FAA6F;QAC7F,2FAA2F;QAC3F,qEAAqE;IACvE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;gBACtB,WAAW,EACT,mFAAmF;oBACnF,yFAAyF;oBACzF,sFAAsF;oBACtF,cAAc;aACjB;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,iFAAiF;oBACjF,oEAAoE;aACvE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,uFAAuF;oBACvF,oEAAoE;aACvE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,uFAAuF;oBACvF,oFAAoF;oBACpF,iDAAiD;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,8BAA8B;aACjC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,+EAA+E;aAClF;YACD,iBAAiB,EAAE;gBACjB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,uFAAuF;oBACvF,iFAAiF;oBACjF,kCAAkC;aACrC;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,0FAA0F;aAC7F;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

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

package/dist/tools/profiler-start.js

@@ -0,0 +1,31 @@
+// M16 Plan 7 — typed profiler session start. Mutating editor state but writes
+// NO assets, so the gate (which validates asset-reference fallout) has nothing
+// to validate — gate-free direct-response tool. Idempotent: calling when
+// already enabled returns the current enabled state. Folds UMCP `profiler-start`
+// and UCP `profiler/session/start` (UCP's deep-profile / allocation-callstacks /
+// binary-log options are intentionally NOT folded in — they require a richer
+// session state than this surface exposes; use profiler_set_config for those).
+export const profilerStart = {
+    name: "unity_open_mcp_profiler_start",
+    description: "Enable the Unity runtime profiler (UnityEngine.Profiling.Profiler.enabled = true) " +
+        "and open the Profiler window (Window > Analysis > Profiler). Idempotent — calling " +
+        "when already enabled is a no-op that returns the current state. Mutates editor state " +
+        "only (no asset writes); gate-free. Recording starts at the next frame; poll " +
+        "profiler_get_status or unity_senses_profiler_capture to confirm data is flowing. " +
+        "Enabling the profiler adds runtime overhead — disable it via profiler_stop when " +
+        "finished to restore full editor throughput.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            open_window: {
+                type: "boolean",
+                default: true,
+                description: "Also open the Profiler window via Window > Analysis > Profiler. Default true. " +
+                    "When false, only the runtime Profiler.enabled flag flips (the window stays " +
+                    "in whatever state it was).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-start.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-start.js","sourceRoot":"","sources":["../../src/tools/profiler-start.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,+EAA+E;AAC/E,yEAAyE;AACzE,iFAAiF;AACjF,iFAAiF;AACjF,6EAA6E;AAC7E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oFAAoF;QACpF,oFAAoF;QACpF,uFAAuF;QACvF,8EAA8E;QAC9E,mFAAmF;QACnF,kFAAkF;QAClF,6CAA6C;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,gFAAgF;oBAChF,6EAA6E;oBAC7E,4BAA4B;aAC/B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/profiler-stop.d.ts

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

package/dist/tools/profiler-stop.js

@@ -0,0 +1,20 @@
+// M16 Plan 7 — typed profiler session stop. Mutating editor state but writes
+// NO assets; gate-free direct-response tool. Idempotent. Folds UMCP
+// `profiler-stop` and UCP `profiler/session/stop` (UCP's session-state restore
+// is intentionally NOT folded — Unity's profiler keeps buffered frames across a
+// stop, so call profiler_clear_data to discard them).
+export const profilerStop = {
+    name: "unity_open_mcp_profiler_stop",
+    description: "Disable the Unity runtime profiler (UnityEngine.Profiling.Profiler.enabled = false). " +
+        "Idempotent — calling when already disabled returns the current state. Mutates editor " +
+        "state only (no asset writes); gate-free. Buffered frames stay in the Profiler's memory " +
+        "after stop — call profiler_clear_data to discard them, or profiler_save_data to persist " +
+        "a snapshot first. Closing the Profiler window is NOT done by this tool — Unity keeps " +
+        "the runtime flag separate from the window.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=profiler-stop.js.map

package/dist/tools/profiler-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-stop.js","sourceRoot":"","sources":["../../src/tools/profiler-stop.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,oEAAoE;AACpE,+EAA+E;AAC/E,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uFAAuF;QACvF,uFAAuF;QACvF,yFAAyF;QACzF,0FAA0F;QAC1F,uFAAuF;QACvF,4CAA4C;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/pull-events.d.ts

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

package/dist/tools/pull-events.js

@@ -0,0 +1,43 @@
+// M13 T4.4 — bridge event pull tool.
+//
+// The bridge emits console-log and editor-state (compile / play-mode)
+// notifications over an SSE stream at GET /events. This tool drains the
+// per-process subscription queue and returns incremental events since the
+// previous call. The first call opens the subscription; subsequent calls
+// return only new events.
+//
+// Why poll instead of push? The MCP server runs over a stdio transport; it has
+// no native way to forward bridge SSE → MCP notifications. Polling per call
+// keeps the model in the loop and lets an agent decide when to drain (e.g.
+// right after a mutation that may produce logs).
+export const pullEvents = {
+    name: "unity_senses_pull_events",
+    description: "Drain incremental bridge events (console logs + editor-state transitions) since the previous call. " +
+        "The first call opens a server-side SSE subscription; later calls return only new events. " +
+        "Use this after execute_csharp / mutations to stream console output without polling /ping or " +
+        "re-reading the full console. Each event carries `seq`, `ts`, `type` ('log' | 'editor_state'), " +
+        "and type-specific fields (logType/message/stack for logs, state/isCompiling/isPlaying for state). " +
+        "`dropped` reports events evicted from the queue before this pull; `connected` reports the SSE reader " +
+        "state. Requires a live Unity Editor connection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            max_events: {
+                type: "integer",
+                default: 50,
+                minimum: 1,
+                maximum: 1000,
+                description: "Maximum events to return per call. Additional buffered events are counted in `dropped`.",
+            },
+            // Hidden-but-documented: an explicit subscriber id lets a long-lived
+            // agent session resume across MCP server restarts. Defaults to a
+            // server-scoped id; callers normally omit it.
+            subscriber: {
+                type: "string",
+                description: "Optional subscriber id to resume a prior subscription (defaults to a server-scoped id).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=pull-events.js.map

package/dist/tools/pull-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-events.js","sourceRoot":"","sources":["../../src/tools/pull-events.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,0BAA0B;AAC1B,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,qGAAqG;QACrG,2FAA2F;QAC3F,8FAA8F;QAC9F,gGAAgG;QAChG,oGAAoG;QACpG,uGAAuG;QACvG,iDAAiD;IACnD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,yFAAyF;aAC5F;YACD,qEAAqE;YACrE,iEAAiE;YACjE,8CAA8C;YAC9C,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yFAAyF;aAC5F;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/read-asset.d.ts

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

package/dist/tools/read-asset.js

@@ -0,0 +1,62 @@
+// M9 Plan 2 — compact drill-down asset read. Returns a MAP by default (counts +
+// CMP component-set declarations + folded hierarchy tree + omission counts);
+// drill-down flags expand detail progressively without the caller re-specifying
+// the whole asset. Offline-first (Plan 3): text-serialized assets are parsed
+// directly from disk without a running Editor; binary formats fall back to the
+// live bridge.
+export const readAsset = {
+    name: "unity_open_mcp_read_asset",
+    description: "Read a Unity asset as a compact, token-budgeted summary (hierarchy + components + counts). " +
+        "Default returns a map: ASSET/PATH/GUID/OBJECTS/COMPONENTS counts, CMP component-set declarations, and a folded TREE with 'more: N hidden' omission counts. " +
+        "Drill down with component/path/id/detail instead of re-reading raw YAML. " +
+        "Achieves >=70% size reduction vs raw YAML on typical prefabs. Offline-first: text-serialized assets parse from disk (no Editor needed); binary formats fall back to the live bridge.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "Asset path to read (e.g. \"Assets/Prefabs/Player.prefab\"). Text-serialized YAML assets only (.prefab/.unity/.asset/.mat/.controller/.anim).",
+            },
+            detail: {
+                enum: ["summary", "normal", "verbose"],
+                default: "summary",
+                description: "Compression level. 'summary' (default): folded tree, component-set codes, omission counts. 'normal': inline component names per node. 'verbose': full tree without render-only folding.",
+            },
+            component: {
+                type: "string",
+                description: "Drill-down: dump fields for components whose name/scriptPath matches (case-insensitive substring). Returns a componentMatches list instead of the TREE.",
+            },
+            path: {
+                type: "string",
+                description: "Drill-down: scope the TREE to the subtree whose hierarchy path matches (case-insensitive substring).",
+            },
+            id: {
+                type: "string",
+                description: "Drill-down: return one object by local YAML fileID. Offline-only (live bridge does not expose fileIDs); use component/path drill-down when reading live.",
+            },
+            override: {
+                type: "boolean",
+                default: false,
+                description: "Drill-down: show prefab variant overrides (property modifications, added/removed components and GameObjects). Returns an overrides list instead of the TREE. Offline-only (requires the offline YAML parser).",
+            },
+            depth: {
+                type: "integer",
+                default: -1,
+                description: "Hierarchy depth cap. -1 = unlimited. Nodes past the cap are counted in 'moreHidden'.",
+            },
+            limit: {
+                type: "integer",
+                default: 0,
+                description: "Max TREE rows after folding. 0 = unlimited. Dropped rows counted in 'moreHidden'.",
+            },
+            field_limit: {
+                type: "integer",
+                default: 0,
+                description: "Max serialized fields per component when the bridge fetches them. 0 = names only (suitable for summary). Bump to 20-50 before using component drill-down so fields are available.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=read-asset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-asset.js","sourceRoot":"","sources":["../../src/tools/read-asset.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,eAAe;AACf,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,6FAA6F;QAC7F,6JAA6J;QAC7J,2EAA2E;QAC3E,sLAAsL;IACxL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8IAA8I;aACjJ;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,yLAAyL;aAC5L;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yJAAyJ;aAC5J;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sGAAsG;aACzG;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0JAA0J;aAC7J;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,+MAA+M;aAClN;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC,CAAC;gBACX,WAAW,EAAE,sFAAsF;aACpG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,mFAAmF;aACjG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,mLAAmL;aACtL;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/read-compile-errors.d.ts

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

package/dist/tools/read-compile-errors.js

@@ -0,0 +1,59 @@
+// Offline, filesystem-only tool: reads the tail of Unity's platform Editor.log
+// and extracts BOTH C# compiler errors AND package / assembly-level red flags.
+// The one recovery channel that works when the bridge assembly itself has
+// failed to compile — in that state every in-bridge channel (read_console,
+// editor_status) is dead with it, and compile_check can't run either (the
+// batch entry point shares the broken assembly, and Unity's per-project lock
+// blocks a second instance). The live Editor still writes CSxxxx diagnostics
+// AND assembly-resolution failures AND Package Manager notices to Editor.log
+// regardless of bridge health, so this tool retrieves them without touching
+// Unity or the bridge.
+//
+// Response fields:
+//   - status: "compile_failed" | "project_unhealthy" | "no_errors_found"
+//   - unhealthy: true when compiler errors OR issues are present
+//   - headline: one-line triage summary (empty when healthy)
+//   - errors[]: structured CSxxxx diagnostics (file/line/code/message)
+//   - issues[]: package / assembly red flags with kind + hint:
+//       * assembly_resolution — Mono.Cecil unresolved-assembly failures
+//         (classic package-version / Unity-version mismatch, e.g. ProBuilder
+//         5.x compiled against an assembly ProBuilder 6 removed)
+//       * package_deprecated   — [Package Manager] <id> is deprecated
+//       * package_manager_error — other Package Manager conflict / resolution
+//         errors
+export const readCompileErrors = {
+    name: "unity_open_mcp_read_compile_errors",
+    description: "Read C# compiler errors AND package/assembly red flags directly from " +
+        "Unity's Editor.log (offline, no bridge, no Unity spawn). Returns " +
+        "structured CSxxxx compiler errors (file/line/code/message) PLUS a " +
+        "`issues` list of package-level red flags with per-issue `kind` + " +
+        "`hint`: assembly_resolution (Mono.Cecil unresolved-assembly failures — " +
+        "the classic package-version / Unity-version mismatch, e.g. ProBuilder " +
+        "5.x on Unity 6), package_deprecated ([Package Manager] <id> is " +
+        "deprecated), and package_manager_error (conflict / resolution errors). " +
+        "Use this when: (a) the bridge is unreachable after a recompile — a " +
+        "'bridge_compile_failed' response points here, or ping returns " +
+        "connected:false unexpectedly; (b) Unity showed a 'package update' / " +
+        "incompatibility popup; (c) you suspect a package is too old for the " +
+        "current Editor. Works even when the bridge assembly itself is broken, " +
+        "because it reads the log file the Editor writes independently of the " +
+        "bridge. Check `unhealthy` first; when true, scan `headline` for a " +
+        "one-line triage then drill into `errors` and `issues`.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            tail_bytes: {
+                type: "integer",
+                default: 262144,
+                minimum: 4096,
+                maximum: 1048576,
+                description: "Maximum number of bytes to read from the END of Editor.log " +
+                    "(default 256KB). Compiler errors AND assembly-resolution failures " +
+                    "are written in contiguous blocks near the end, so a modest tail " +
+                    "is ample. Increase only if errors or issues are reported missing.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=read-compile-errors.js.map

package/dist/tools/read-compile-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,uBAAuB;AACvB,EAAE;AACF,mBAAmB;AACnB,yEAAyE;AACzE,iEAAiE;AACjE,6DAA6D;AAC7D,uEAAuE;AACvE,+DAA+D;AAC/D,wEAAwE;AACxE,6EAA6E;AAC7E,iEAAiE;AACjE,sEAAsE;AACtE,8EAA8E;AAC9E,iBAAiB;AACjB,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,uEAAuE;QACvE,mEAAmE;QACnE,oEAAoE;QACpE,mEAAmE;QACnE,yEAAyE;QACzE,wEAAwE;QACxE,iEAAiE;QACjE,yEAAyE;QACzE,qEAAqE;QACrE,gEAAgE;QAChE,sEAAsE;QACtE,sEAAsE;QACtE,wEAAwE;QACxE,uEAAuE;QACvE,oEAAoE;QACpE,wDAAwD;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,6DAA6D;oBAC7D,oEAAoE;oBACpE,kEAAkE;oBAClE,mEAAmE;aACtE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

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