unity-open-mcp 0.5.0 → 0.7.0

package/dist/tools/scene-unload.js

@@ -1,20 +1,34 @@
 // M16 Plan 3 — typed scene unload. Mutating: removes an opened scene from
 // the editor (without saving). Runs the full gate path.
+//
+// Scene identity (path-first): `path` resolves an opened scene by its asset
+// path; `name` resolves by display name. Precedence: when both are supplied,
+// `path` wins; `name` is the fallback when only it is supplied.
 export const sceneUnload = {
     name: "unity_open_mcp_scene_unload",
     description: "Unload an opened scene from the Unity Editor (without saving — call scene_save first if " +
         "the scene has unsaved changes you want to keep). Mutating: runs the full gate path; " +
-        "`paths_hint` should be the scene's asset path. Returns the post-unload list of opened " +
-        "scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/isActive). Prefer this over raw " +
-        "execute_csharp SceneManager.UnloadSceneAsync.",
+        "`paths_hint` should be the scene's asset path. Scene identity is path-first: provide `path` " +
+        "(the scene's `Assets/.../*.unity` asset path) to resolve unambiguously, or `name` to resolve " +
+        "by display name. When both are supplied, `path` wins and `name` is ignored. The response " +
+        "carries `resolvedBy` (\"path\" or \"name\") so the agent can tell which identity key resolved " +
+        "the target. Returns the " +
+        "post-unload list of opened scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/isActive). " +
+        "Prefer this over raw execute_csharp SceneManager.UnloadSceneAsync.",
     inputSchema: {
         type: "object",
-        required: ["name", "paths_hint"],
+        required: ["paths_hint"],
         properties: {
+            path: {
+                type: "string",
+                description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to unload. Resolves the scene " +
+                    "by its asset path — the authoritative identity. When supplied, takes precedence over " +
+                    "`name`. Use scene_list_opened to enumerate opened scene paths.",
+            },
             name: {
                 type: "string",
-                description: "Name of the opened scene to unload. Must match an opened scene. Use " +
-                    "scene_list_opened to enumerate opened scene names.",
+                description: "Name of the opened scene to unload (fallback when `path` is not supplied). Must match " +
+                    "an opened scene's display name. Use scene_list_opened to enumerate opened scene names.",
             },
             paths_hint: {
                 type: "array",

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

@@ -1 +1 @@
-{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,wFAAwF;QACxF,0FAA0F;QAC1F,+CAA+C;IACjD,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,sEAAsE;oBACtE,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;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"}
+{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,8FAA8F;QAC9F,+FAA+F;QAC/F,2FAA2F;QAC3F,gGAAgG;QAChG,0BAA0B;QAC1B,gGAAgG;QAChG,oEAAoE;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yFAAyF;oBACzF,uFAAuF;oBACvF,gEAAgE;aACnE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;oBACxF,wFAAwF;aAC3F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;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/search-assets.js

@@ -57,7 +57,9 @@ export const searchAssets = {
             max_results: {
                 type: "integer",
                 default: 50,
-                description: "Max result files returned when page_size is omitted; extras counted in 'truncated'. Legacy alias of the single-page cap.",
+                description: "Max result files returned when page_size is omitted; extras counted in 'truncated'. Legacy alias of the single-page cap. " +
+                    "Callers should pass >= 1; the value 0 is a server-internal sentinel meaning 'unlimited (for paging)' " +
+                    "and is emitted by the server itself when page_size is set — it is never a value a caller needs to pass.",
             },
         },
         additionalProperties: false,

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

@@ -1 +1 @@
-{"version":3,"file":"search-assets.js","sourceRoot":"","sources":["../../src/tools/search-assets.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,kBAAkB;AAClB,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uIAAuI;QACvI,+HAA+H;QAC/H,8EAA8E;QAC9E,0DAA0D;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,2CAA2C;aACzD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,2IAA2I;oBAC3I,6FAA6F;aAChG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,8HAA8H;oBAC9H,yEAAyE;aAC5E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8GAA8G;aACjH;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,8IAA8I;aACjJ;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,0HAA0H;aAC7H;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"search-assets.js","sourceRoot":"","sources":["../../src/tools/search-assets.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,kBAAkB;AAClB,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uIAAuI;QACvI,+HAA+H;QAC/H,8EAA8E;QAC9E,0DAA0D;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,2CAA2C;aACzD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,2IAA2I;oBAC3I,6FAA6F;aAChG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,8HAA8H;oBAC9H,yEAAyE;aAC5E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8GAA8G;aACjH;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,8IAA8I;aACjJ;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,2HAA2H;oBAC3H,uGAAuG;oBACvG,yGAAyG;aAC5G;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-open-mcp",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "MCP server (stdio) routing tool calls to the live Unity Open MCP Bridge or batch Unity processes.",
   "type": "module",
   "main": "dist/index.js",