unity-open-mcp 0.1.0

package/dist/tools/package-list.js

@@ -0,0 +1,57 @@
+// M16 Plan 4 — typed UPM package list. Read-only (gate-free). Token-bounded
+// by max_results. Wraps UnityEditor.PackageManager.Client.List and supports
+// offline mode (cached resolution only), source filtering, name-substring
+// filtering, and a direct-dependencies-only toggle (manifest.json entries).
+export const packageList = {
+    name: "unity_open_mcp_package_list",
+    description: "List Unity Package Manager (UPM) packages installed in the project — name, displayName, " +
+        "version, packageId, source, resolvedPath, description, category, versions (recommended + " +
+        "latestCompatible), registry, and per-package dependencies. Optionally filter by `source` " +
+        "(registry / embedded / local / git / builtin / localtarball), by `name_filter` substring " +
+        "(name/displayName/description with exact-match priority), and direct-dependencies-only " +
+        "(entries in Packages/manifest.json). Read-only (gate-free). Token-bounded by `max_results` " +
+        "(remaining count is reported in `truncated`). Defaults to `offline: true` (cached resolution); " +
+        "pass `offline: false` to refresh from the registry first.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            offline: {
+                type: "boolean",
+                default: true,
+                description: "When true (default), use the cached resolution (no registry round-trip). Set false to " +
+                    "force a fresh resolution. Offline mode is faster and works without network.",
+            },
+            include_indirect: {
+                type: "boolean",
+                default: false,
+                description: "When true, include transitive (indirect) dependencies. Default false returns only the " +
+                    "packages listed in Packages/manifest.json.",
+            },
+            source: {
+                type: "string",
+                enum: ["registry", "embedded", "local", "git", "builtin", "localtarball"],
+                description: "Restrict the result to packages from a single PackageSource.",
+            },
+            name_filter: {
+                type: "string",
+                description: "Case-insensitive substring filter over name/displayName/description. Results are " +
+                    "prioritized: exact name → exact displayName → name substring → displayName substring " +
+                    "→ description substring.",
+            },
+            direct_dependencies_only: {
+                type: "boolean",
+                default: false,
+                description: "When true, only return packages whose name appears in Packages/manifest.json (direct " +
+                    "dependencies). Implies a manifest read to compute the directDependency flag.",
+            },
+            max_results: {
+                type: "integer",
+                minimum: 1,
+                default: 200,
+                description: "Max packages returned; remaining count is reported in 'truncated'.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=package-list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-list.js","sourceRoot":"","sources":["../../src/tools/package-list.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,2FAA2F;QAC3F,2FAA2F;QAC3F,2FAA2F;QAC3F,yFAAyF;QACzF,6FAA6F;QAC7F,iGAAiG;QACjG,2DAA2D;IAC7D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,wFAAwF;oBACxF,6EAA6E;aAChF;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,wFAAwF;oBACxF,4CAA4C;aAC/C;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,CAAC;gBACzE,WAAW,EAAE,8DAA8D;aAC5E;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,uFAAuF;oBACvF,0BAA0B;aAC7B;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,uFAAuF;oBACvF,8EAA8E;aACjF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,oEAAoE;aAClF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/package-remove.d.ts

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

package/dist/tools/package-remove.js

@@ -0,0 +1,40 @@
+// M16 Plan 4 — typed UPM package remove. Mutating: writes Packages/manifest.json
+// and triggers resolution (may domain-reload). Runs the full gate path;
+// paths_hint must be scoped to "Packages/manifest.json" (packages-lock.json
+// is touched implicitly). Refuses packages that are not installed.
+export const packageRemove = {
+    name: "unity_open_mcp_package_remove",
+    description: "Remove (uninstall) a UPM package from the project. Mutating: rewrites Packages/manifest.json " +
+        "and triggers package resolution (may remove assemblies and force a domain reload; the bridge " +
+        "blocks on the post-remove compile via its restart_then_settle lifecycle). Runs the full gate " +
+        "path; `paths_hint` must be `[\"Packages/manifest.json\"]` (packages-lock.json is touched " +
+        "implicitly). Refuses packages that are not installed (use unity_open_mcp_package_list to " +
+        "enumerate first). Built-in packages and packages depended on by others cannot be removed. " +
+        "A trailing '@<version>' on the input is stripped automatically.",
+    inputSchema: {
+        type: "object",
+        required: ["package_id", "paths_hint"],
+        properties: {
+            package_id: {
+                type: "string",
+                description: "Package name to remove, e.g. 'com.unity.textmeshpro'. A trailing '@<version>' is " +
+                    "stripped before being passed to Client.Remove. Use the bare package name (not the " +
+                    "versioned form).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — pass [\"Packages/manifest.json\"]. The gate validates against this " +
+                    "scope; packages-lock.json is touched implicitly by UPM resolution and does not need " +
+                    "to be listed. There is no whole-project fallback.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+                description: "Gate mode. Default 'enforce' — fails the call if the remove surfaces new errors.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=package-remove.js.map

package/dist/tools/package-remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-remove.js","sourceRoot":"","sources":["../../src/tools/package-remove.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,wEAAwE;AACxE,4EAA4E;AAC5E,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,+FAA+F;QAC/F,+FAA+F;QAC/F,+FAA+F;QAC/F,2FAA2F;QAC3F,2FAA2F;QAC3F,4FAA4F;QAC5F,iEAAiE;IACnE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;QACtC,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,oFAAoF;oBACpF,kBAAkB;aACrB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sFAAsF;oBACtF,sFAAsF;oBACtF,mDAAmD;aACtD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,kFAAkF;aAChG;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/package-search.d.ts

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

package/dist/tools/package-search.js

@@ -0,0 +1,42 @@
+// M16 Plan 4 — typed UPM package search. Read-only (gate-free). Token-bounded
+// by max_results. Wraps UnityEditor.PackageManager.Client.Search /
+// Client.SearchAll. Online mode fetches exact matches from the live registry
+// first; cached registry data backs the substring matches in both modes.
+// Each result reports install status + installed version.
+export const packageSearch = {
+    name: "unity_open_mcp_package_search",
+    description: "Search the Unity Package Manager registry plus installed local packages (Git, local, " +
+        "embedded sources) by query string. Returns name, displayName, latest version, truncated " +
+        "description, source, install status, installed version (if any), and top-5 compatible " +
+        "versions per result. Read-only (gate-free). Token-bounded by `max_results` (remaining count " +
+        "reported in `truncated`). Results are prioritized: exact name → exact displayName → name " +
+        "substring → displayName substring → description substring. Defaults to `offline: true` " +
+        "(cached registry only); pass `offline: false` to hit the live registry for exact matches " +
+        "before supplementing with cached substring matches.",
+    inputSchema: {
+        type: "object",
+        required: ["query"],
+        properties: {
+            query: {
+                type: "string",
+                description: "Package id, name, displayName, or description keyword (case-insensitive). Examples: " +
+                    "'com.unity.textmeshpro', 'TextMesh Pro', 'TextMesh', 'rendering'.",
+            },
+            offline: {
+                type: "boolean",
+                default: true,
+                description: "When true (default), search cached registry data only (substring match). Set false to " +
+                    "first fetch exact matches from the live registry, then supplement with cached " +
+                    "substring matches.",
+            },
+            max_results: {
+                type: "integer",
+                minimum: 1,
+                default: 20,
+                description: "Max results returned; remaining count is reported in 'truncated'.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=package-search.js.map

package/dist/tools/package-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-search.js","sourceRoot":"","sources":["../../src/tools/package-search.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,mEAAmE;AACnE,6EAA6E;AAC7E,yEAAyE;AACzE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,uFAAuF;QACvF,0FAA0F;QAC1F,wFAAwF;QACxF,8FAA8F;QAC9F,2FAA2F;QAC3F,yFAAyF;QACzF,2FAA2F;QAC3F,qDAAqD;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sFAAsF;oBACtF,mEAAmE;aACtE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,wFAAwF;oBACxF,gFAAgF;oBAChF,oBAAoB;aACvB;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,mEAAmE;aACjF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/particle-system-get.d.ts

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

package/dist/tools/particle-system-get.js

@@ -0,0 +1,42 @@
+// M16 Plan 10 / T6.6.9 — Particle System extension tool. Requires the
+// particle system extension pack. Read-only, gate-free.
+const targetSchema = {
+    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." },
+};
+export const particleSystemGet = {
+    name: "unity_open_mcp_particle_system_get",
+    description: "Inspect a ParticleSystem component on a scene GameObject — runtime state " +
+        "(isPlaying / isPaused / isEmitting / isStopped / particleCount / time) plus " +
+        "opt-in data for the well-known modules (main / emission / shape / " +
+        "color_over_lifetime / size_over_lifetime / rotation_over_lifetime / noise / " +
+        "collision / trails / renderer). include_main defaults to true; everything " +
+        "else defaults to false. Set include_all to emit every module. Read-only, " +
+        "gate-free. Use this to discover valid module + field names for " +
+        "particle_system_modify. Requires the particle system extension pack installed " +
+        "in the project.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            ...targetSchema,
+            include_main: { type: "boolean", default: true, description: "Include the Main module." },
+            include_emission: { type: "boolean", default: false, description: "Include the Emission module." },
+            include_shape: { type: "boolean", default: false, description: "Include the Shape module." },
+            include_color_over_lifetime: { type: "boolean", default: false, description: "Include the Color over Lifetime module." },
+            include_size_over_lifetime: { type: "boolean", default: false, description: "Include the Size over Lifetime module." },
+            include_rotation_over_lifetime: { type: "boolean", default: false, description: "Include the Rotation over Lifetime module." },
+            include_noise: { type: "boolean", default: false, description: "Include the Noise module." },
+            include_collision: { type: "boolean", default: false, description: "Include the Collision module." },
+            include_trails: { type: "boolean", default: false, description: "Include the Trails module." },
+            include_renderer: { type: "boolean", default: false, description: "Include the sibling ParticleSystemRenderer component." },
+            include_all: { type: "boolean", default: false, description: "Override every per-module flag and emit all modules." },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=particle-system-get.js.map

package/dist/tools/particle-system-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-system-get.js","sourceRoot":"","sources":["../../src/tools/particle-system-get.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,wDAAwD;AACxD,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;IAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;CACvG,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,2EAA2E;QAC3E,8EAA8E;QAC9E,oEAAoE;QACpE,8EAA8E;QAC9E,4EAA4E;QAC5E,2EAA2E;QAC3E,iEAAiE;QACjE,gFAAgF;QAChF,iBAAiB;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,YAAY;YACf,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACzF,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,8BAA8B,EAAE;YAClG,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAC5F,2BAA2B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,yCAAyC,EAAE;YACxH,0BAA0B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,wCAAwC,EAAE;YACtH,8BAA8B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC9H,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAC5F,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACpG,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,4BAA4B,EAAE;YAC9F,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,uDAAuD,EAAE;YAC3H,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,sDAAsD,EAAE;SACtH;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/particle-system-modify.d.ts

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

package/dist/tools/particle-system-modify.js

@@ -0,0 +1,73 @@
+// M16 Plan 10 / T6.6.9 — Particle System extension tool. Requires the
+// particle system extension pack. Mutating: runs the full gate path.
+const targetSchema = {
+    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 host scene path.",
+    },
+    gate: { enum: ["enforce", "warn", "off"], default: "enforce" },
+};
+export const particleSystemModify = {
+    name: "unity_open_mcp_particle_system_modify",
+    description: "Apply a per-module field patch to a ParticleSystem component. module is one " +
+        "of 'main' / 'emission' / 'shape' / 'color_over_lifetime' / 'size_over_lifetime' / " +
+        "'rotation_over_lifetime' / 'noise' / 'collision' / 'trails' / 'renderer'. " +
+        "fields_json is a JSON object of {field: value} entries to set on that module " +
+        "(only the documented fields per module are accepted; unknown fields are " +
+        "skipped and reported). Use particle_system_get first to discover valid " +
+        "module + field names. Mutating: runs the full gate path; paths_hint is the " +
+        "host scene path. Requires the particle system extension pack installed in " +
+        "the project.",
+    inputSchema: {
+        type: "object",
+        required: ["module", "fields_json", "paths_hint"],
+        properties: {
+            ...targetSchema,
+            module: {
+                type: "string",
+                enum: [
+                    "main",
+                    "emission",
+                    "shape",
+                    "color_over_lifetime",
+                    "size_over_lifetime",
+                    "rotation_over_lifetime",
+                    "noise",
+                    "collision",
+                    "trails",
+                    "renderer",
+                ],
+                description: "Which particle module to patch.",
+            },
+            fields_json: {
+                type: "string",
+                description: "JSON object of {field: value} entries to apply to the chosen module. " +
+                    "Per-module field surface (use particle_system_get to see current values): " +
+                    "main: duration(read-only) / loop / prewarm / startDelay / startLifetime / " +
+                    "startSpeed / startSize / startSize3D / startRotation3D / startRotation / " +
+                    "gravityModifier / playOnAwake / maxParticles / simulationSpace(Local/World/Custom) / " +
+                    "scalingMode(Hierarchy/Local/Shape). " +
+                    "emission: enabled / rateOverTime / rateOverDistance. " +
+                    "shape: enabled / shapeType / radius / radiusThickness / angle / arc / position('x,y,z') / " +
+                    "rotation('x,y,z') / scale('x,y,z'). " +
+                    "color_over_lifetime: enabled. " +
+                    "size_over_lifetime: enabled / separateAxes. " +
+                    "rotation_over_lifetime: enabled / separateAxes / x / y / z (radians/sec). " +
+                    "noise: enabled / strength / frequency / scrollSpeed / damping / octaveCount / quality(Low/Medium/High). " +
+                    "collision: enabled / type(Planes/World) / dampen / bounce / lifetimeLoss. " +
+                    "trails: enabled / ratio / lifetime. " +
+                    "renderer: renderMode / alignment / sortMode / maskInteraction.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=particle-system-modify.js.map

package/dist/tools/particle-system-modify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-system-modify.js","sourceRoot":"","sources":["../../src/tools/particle-system-modify.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,qEAAqE;AACrE,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;IAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;IACtG,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;CAC/D,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,8EAA8E;QAC9E,oFAAoF;QACpF,4EAA4E;QAC5E,+EAA+E;QAC/E,0EAA0E;QAC1E,yEAAyE;QACzE,6EAA6E;QAC7E,4EAA4E;QAC5E,cAAc;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,CAAC;QACjD,UAAU,EAAE;YACV,GAAG,YAAY;YACf,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,MAAM;oBACN,UAAU;oBACV,OAAO;oBACP,qBAAqB;oBACrB,oBAAoB;oBACpB,wBAAwB;oBACxB,OAAO;oBACP,WAAW;oBACX,QAAQ;oBACR,UAAU;iBACX;gBACD,WAAW,EAAE,iCAAiC;aAC/C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uEAAuE;oBACvE,4EAA4E;oBAC5E,4EAA4E;oBAC5E,2EAA2E;oBAC3E,uFAAuF;oBACvF,sCAAsC;oBACtC,uDAAuD;oBACvD,4FAA4F;oBAC5F,sCAAsC;oBACtC,gCAAgC;oBAChC,8CAA8C;oBAC9C,4EAA4E;oBAC5E,0GAA0G;oBAC1G,4EAA4E;oBAC5E,sCAAsC;oBACtC,gEAAgE;aACnE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/ping.d.ts

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

package/dist/tools/ping.js

@@ -0,0 +1,10 @@
+export const ping = {
+    name: "unity_open_mcp_ping",
+    description: "Bridge health check.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/prefab-apply.d.ts

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

package/dist/tools/prefab-apply.js

@@ -0,0 +1,39 @@
+// M16 Plan 1 — typed prefab instance apply. Mutating: runs the full gate path.
+// Applies a prefab instance's overrides back to the prefab asset.
+export const prefabApply = {
+    name: "unity_open_mcp_prefab_apply",
+    description: "Apply a prefab instance's overrides back to its source prefab asset (so all instances inherit " +
+        "the change). Mutating: runs the full gate path; `paths_hint` should include the prefab asset " +
+        "path (so the gate validates the asset) and the scene path (so the gate validates the instance). " +
+        "Resolve the instance by `instance_id` (canonical) or `path` / `name` (fallback).",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Instance ID of the prefab instance to apply (canonical address).",
+            },
+            path: {
+                type: "string",
+                description: "Hierarchy path of the prefab instance (fallback address).",
+            },
+            name: {
+                type: "string",
+                description: "Prefab instance GameObject name (lowest priority address).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Prefab asset path + scene path (the gate's validation scope).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-apply.js.map

package/dist/tools/prefab-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-apply.js","sourceRoot":"","sources":["../../src/tools/prefab-apply.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,kEAAkE;AAClE,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,gGAAgG;QAChG,+FAA+F;QAC/F,kGAAkG;QAClG,kFAAkF;IACpF,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,kEAAkE;aAChF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+DAA+D;aAC7E;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/prefab-close.d.ts

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

package/dist/tools/prefab-close.js

@@ -0,0 +1,29 @@
+// M16 Plan 1 — typed prefab stage close. Mutating: runs the full gate path.
+export const prefabClose = {
+    name: "unity_open_mcp_prefab_close",
+    description: "Close the currently open prefab edit stage, optionally saving changes. No-op (with a note) " +
+        "when no prefab stage is open. Mutating: runs the full gate path; `paths_hint` is the prefab " +
+        "asset path being edited (best-effort — when omitted, the gate runs without a scope).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            save: {
+                type: "boolean",
+                default: true,
+                description: "When true (default), save changes to the prefab asset before closing. When false, " +
+                    "discard the in-stage changes.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Prefab asset path being edited (the gate's validation scope). Best-effort when omitted.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-close.js.map

package/dist/tools/prefab-close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-close.js","sourceRoot":"","sources":["../../src/tools/prefab-close.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,6FAA6F;QAC7F,8FAA8F;QAC9F,sFAAsF;IACxF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,oFAAoF;oBACpF,+BAA+B;aAClC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yFAAyF;aACvG;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/prefab-create.d.ts

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

package/dist/tools/prefab-create.js

@@ -0,0 +1,52 @@
+// M16 Plan 1 — typed prefab create / variant. Mutating: runs the full gate
+// path. `paths_hint` is the new prefab asset path.
+export const prefabCreate = {
+    name: "unity_open_mcp_prefab_create",
+    description: "Create a prefab (or prefab variant) asset at a given Assets/-rooted path ending in .prefab, " +
+        "from a scene GameObject. Creates intermediate folders if missing. When the source GameObject " +
+        "is already a prefab instance and `connect` is true, a prefab variant is created. Mutating: " +
+        "runs the full gate path; `paths_hint` is the new .prefab path (and the scene path if the " +
+        "source is connected in-scene). Resolve the source GameObject by `instance_id` (canonical) or " +
+        "by `path` / `name` (fallback).",
+    inputSchema: {
+        type: "object",
+        required: ["prefab_asset_path", "paths_hint"],
+        properties: {
+            prefab_asset_path: {
+                type: "string",
+                description: "Destination prefab asset path. Must start with 'Assets/' and end with '.prefab'.",
+            },
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Instance ID of the scene GameObject to convert (canonical address).",
+            },
+            path: {
+                type: "string",
+                description: "Hierarchy path of the scene GameObject (fallback address).",
+            },
+            name: {
+                type: "string",
+                description: "Scene GameObject name (lowest priority address).",
+            },
+            connect: {
+                type: "boolean",
+                default: true,
+                description: "When true, the scene GameObject is connected to the new prefab (becoming a prefab instance); " +
+                    "if the source is already a prefab instance, a variant is created. When false, the asset is " +
+                    "saved but the scene GameObject is left unchanged.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "New .prefab path (+ scene path when connect is true). The gate's validation scope.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-create.js","sourceRoot":"","sources":["../../src/tools/prefab-create.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,8FAA8F;QAC9F,+FAA+F;QAC/F,6FAA6F;QAC7F,2FAA2F;QAC3F,+FAA+F;QAC/F,gCAAgC;IAClC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;QAC7C,UAAU,EAAE;YACV,iBAAiB,EAAE;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kFAAkF;aAChG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,qEAAqE;aACnF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,+FAA+F;oBAC/F,6FAA6F;oBAC7F,mDAAmD;aACtD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oFAAoF;aAClG;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/prefab-get-overrides.d.ts

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

package/dist/tools/prefab-get-overrides.js

@@ -0,0 +1,27 @@
+// M16 Plan 1 — read-only prefab overrides listing. Gate-free.
+export const prefabGetOverrides = {
+    name: "unity_open_mcp_prefab_get_overrides",
+    description: "List property/component overrides on a prefab instance: propertyModifications (target type + " +
+        "propertyPath + value), addedComponents (type + instanceId), and removedComponents (type). " +
+        "Read-only (gate-free). Resolve the instance by `instance_id` (canonical) or `path` / `name`.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Instance ID of the prefab instance (canonical address).",
+            },
+            path: {
+                type: "string",
+                description: "Hierarchy path of the prefab instance (fallback address).",
+            },
+            name: {
+                type: "string",
+                description: "Prefab instance GameObject name (lowest priority address).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-get-overrides.js.map

package/dist/tools/prefab-get-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-get-overrides.js","sourceRoot":"","sources":["../../src/tools/prefab-get-overrides.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,+FAA+F;QAC/F,4FAA4F;QAC5F,8FAA8F;IAChG,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,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/prefab-instantiate.d.ts

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

package/dist/tools/prefab-instantiate.js

@@ -0,0 +1,52 @@
+// M16 Plan 1 — typed prefab instantiate. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the destination scene path.
+export const prefabInstantiate = {
+    name: "unity_open_mcp_prefab_instantiate",
+    description: "Instantiate a prefab into the currently active scene at an optional position/rotation/scale, " +
+        "optionally parented under an existing scene GameObject path. Mutating: runs the full gate path. " +
+        "`paths_hint` should be the destination scene path (the instance is a scene side-effect) plus the " +
+        "prefab asset path. Returns the new instance's instanceId, name, and path so the agent can " +
+        "re-acquire it. Use unity_open_mcp_search_assets with t:Prefab to locate the prefab asset first.",
+    inputSchema: {
+        type: "object",
+        required: ["prefab_asset_path", "paths_hint"],
+        properties: {
+            prefab_asset_path: {
+                type: "string",
+                description: "Prefab asset path to instantiate.",
+            },
+            name: {
+                type: "string",
+                description: "Optional name for the new GameObject (defaults to the prefab's name).",
+            },
+            parent_path: {
+                type: "string",
+                description: "Optional destination scene path \"Root/Parent\" — the parent must already exist. " +
+                    "Omit to instantiate at scene root.",
+            },
+            position: {
+                type: "string",
+                description: "Optional world-space position as \"x,y,z\". Defaults to 0,0,0.",
+            },
+            rotation: {
+                type: "string",
+                description: "Optional world-space Euler rotation in degrees as \"x,y,z\". Defaults to 0,0,0.",
+            },
+            scale: {
+                type: "string",
+                description: "Optional world-space scale as \"x,y,z\". Defaults to 1,1,1.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — include the active scene path (the instance is a scene side-effect) and the prefab asset path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-instantiate.js.map

package/dist/tools/prefab-instantiate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-instantiate.js","sourceRoot":"","sources":["../../src/tools/prefab-instantiate.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,+FAA+F;QAC/F,kGAAkG;QAClG,mGAAmG;QACnG,4FAA4F;QAC5F,iGAAiG;IACnG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;QAC7C,UAAU,EAAE;YACV,iBAAiB,EAAE;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,oCAAoC;aACvC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gEAAgE;aAC9E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iFAAiF;aAC/F;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,iHAAiH;aACpH;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/prefab-open.d.ts

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

package/dist/tools/prefab-open.js

@@ -0,0 +1,30 @@
+// M16 Plan 1 — typed prefab stage open. Mutating: runs the full gate path
+// (the stage lifecycle touches editor state). Scope paths_hint to the prefab
+// asset path.
+export const prefabOpen = {
+    name: "unity_open_mcp_prefab_open",
+    description: "Open the prefab edit stage for a prefab asset path. Modifications inside the stage propagate " +
+        "to all instances. Pair with unity_open_mcp_prefab_close to exit the stage when done. Mutating: " +
+        "runs the full gate path; `paths_hint` is the prefab asset path.",
+    inputSchema: {
+        type: "object",
+        required: ["prefab_asset_path", "paths_hint"],
+        properties: {
+            prefab_asset_path: {
+                type: "string",
+                description: "Prefab asset path to open in the edit stage.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Prefab asset path (the gate's validation scope).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=prefab-open.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefab-open.js","sourceRoot":"","sources":["../../src/tools/prefab-open.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6EAA6E;AAC7E,cAAc;AACd,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,+FAA+F;QAC/F,iGAAiG;QACjG,iEAAiE;IACnE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;QAC7C,UAAU,EAAE;YACV,iBAAiB,EAAE;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kDAAkD;aAChE;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/prefab-revert.d.ts

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