Skip to content

v1.0.2

Latest

Choose a tag to compare

@loggzix loggzix released this 01 Nov 10:44

Changed

  • execute_code takes timeout_seconds (up to 1680) for work that legitimately outlasts the ~170 s call ceiling, a 4-minute scene finalize or a texture bake. It raises the call ceiling to that value plus 120 s, which covers the pre-compile refresh, on all three transports through ToolRegistry.TimeoutSecondsForRequest, and raises the budget for the snippet's own loops from 20 s to the same value. Without that second part a loop in the snippet would still be stopped at 20 s. A value never narrows either limit, 0 (the default) keeps both, and the total ceiling stays at a batch's 1800 s, under the broker's hold deadline. A runaway loop is stopped only after the raised budget, so pass it only for work that needs it.
  • The Tool call timed out error now says the call already running in the editor cannot be cancelled and may still finish, so check what it did before running it again; for execute_code it also names timeout_seconds and get_execute_code_history. A bare "timed out" read as "nothing happened", and agents ran the same work a second time behind the first (#68).
  • request_recompile takes wait and exit_play_mode, both off by default so a plain call behaves as before. wait=true holds the call until compilation finishes and answers with the compile result; in broker mode it survives the domain reload, because the redelivered call now waits (up to 30 s) for the recovery record the recompile writes once compiling ends, instead of answering the stub or an older recompile's record. exit_play_mode=true keeps the Play Mode console's latest errors and exceptions in the response, exits Play Mode, waits for Edit Mode and then recompiles, where it used to answer PLAY_MODE_ACTIVE and leave an agent to do those three steps in order. The errors are also kept across a domain reload and appended to the recovery record, so a reload that ends the call does not lose them.
  • execute_code answers SAFETY_CHECK_BLOCKED for a source pattern with an alternative naming what to use instead (while (true) -> a bounded loop, File.Delete -> delete_asset, GetMethod -> call the API directly and find it with reflect_api, a blocked file write -> write_file, ...). The reason and the generic hint said what was refused but not what was allowed, so agents guessed or retried with safety_checks=false. The compiled-assembly guard's block is unchanged.

Fixed

  • A JSON null argument is an argument left out, in a direct call and in batch_execute alike, so the parameter's default applies. It used to reach the tool as "" from a direct call and as the text "null" from a batch: create_script with save_path: null wrote to the project root (or into a folder named null), and find_assets with filter: null listed all 16,000 assets. A required parameter given null now answers MISSING_PARAM.
  • create_script refuses a name that is not a plain file name (../X, a/b) with INVALID_NAME, drops a trailing .cs instead of writing X.cs.cs, and refuses a save_path ending in .cs with INVALID_SAVE_PATH. create_prefab takes a save_path ending in .prefab as the file, where it made a folder of that name; it refuses to replace an existing prefab unless overwrite=true, and says when saving a prefab instance made a Variant. create_prefab_variant refuses a variant_path equal to its base, and an existing prefab unless overwrite=true. unpack_prefab reads mode without case and refuses an unknown one.
  • Script edits keep the file's BOM and line endings. patch_script, edit_script and edit_script_members rewrote a file without its BOM, patch_script could not match a multi-line old_text against a CRLF file, and edit_script left a CRLF file with mixed endings.
  • Arguments that were guessed at are refused: create_material, the UI create_image and set_camera_settings read a color they cannot parse as white (or threw a bare FormatException) and now answer INVALID_PARAM, and accept a color name such as red; log_message with an unknown log_type (warn is read as warning, log/debug/information as info, err/fatal/exception as error); set_time_scale with NaN; raycast_at_point with a non-finite point or an unknown origin. A float or double argument no longer reads "0,5" as 5 through the group separator.
  • simulate_key_press with action=press and a duration holds the key that long and releases it, where duration was ignored and the key stayed down. simulate_key_press, simulate_touch, simulate_gamepad, simulate_mouse_click and simulate_mouse_drag refuse an unknown action or button instead of falling back to tap or left, and simulate_key_combo refuses an empty list or an unknown key before pressing any. The virtual gamepad or touchscreen a simulation added is removed when Play Mode ends. A reply says so when the editor window is not focused, since Unity may not run Play Mode frames and the input then stays queued.
  • capture_game_view honours a width or height above the default size setting (up to 4096); only a call with neither is capped by it. capture_scene_view with only one of the two derives the other from the view's aspect ratio instead of ignoring it. The capture no longer logs "Releasing render texture that is set to be RenderTexture.active!". The tool descriptions state the 64-4096 range.
  • read_file answers PATH_IS_DIRECTORY for a folder and BINARY_FILE for a non-text file, and takes an offset to read a long file in parts (next_offset in the reply). find_assets says when a t: filter may be misspelled and when max was clamped.
  • reflect_api lists a type's constructors and operators, answers .ctor and op_* by name, leaves extension methods declared for every T out of a type's listing, and no longer suggests an accessor like get_mass back at a caller who asked for it.
  • get_scene_info, get_performance_snapshot and analyze_scene_complexity count the DontDestroyOnLoad scene in Play Mode.
  • Entering Play Mode no longer stores a "domain_reload / Interrupted ... re-run the tool" recovery record for a tool that had already returned.
  • request_recompile says "No external changes to import" when nothing changed, and timeout_seconds on it and on wait_for_compilation is documented as clamped to 5-120.
  • MCPClientConfigAutoRewrite replaces the stale URL in the config text instead of writing back the parsed tree, which dropped every key after a // comment.
  • execute_code blocks AssetDatabase.MoveAssetToTrash and MoveAssetsToTrash like DeleteAsset, also through a using alias. A timeout or a blocked-snippet message no longer names a tool the active profile hides without saying that set_tool_profile exposes it.
  • A path with a : inside a segment (Assets/a:/b.txt, file.txt::$DATA) no longer freezes the editor. PathSafety.RefuseLinkedSegment walks from the target up to the project root with Path.GetDirectoryName, and Mono answers its own argument for a segment like a:\, which it reads as a drive root, so the walk never ended — on the main thread, behind every file tool that resolves a path (25 call sites, read_file among them). The walk now stops when a step does not shorten the path.
  • request_recompile with exit_play_mode=true no longer answers "No compilation errors" without compiling. It waited for isPlayingOrWillChangePlaymode to clear, which reports only a pending switch into Play Mode and so was false the instant the exit was requested; the recompile then ran while isPlaying was still true, refused to refresh, and read an error list that predated the edits. It now waits for isPlaying itself, and marks the sync pending before the exit so a reload during it is recovered.
  • request_recompile and wait_for_compilation answer SCRIPT_CHANGES_NOT_COMPILED instead of success when script files are still newer than the last compilation — the staleness get_compilation_errors already warned about. Without it, wait_for_compilation(force_refresh=false) after an external edit, and force_refresh=true in Play Mode (where Unity does not compile), reported "No errors detected" for code that had never been compiled, and a script with a compile error looked clean.
  • raycast_at_point reads normalized and top_left against Screen.width/Screen.height, the space the pointer position is in, and reports that as screen_size. It used the Game View window's pixel size, which is smaller when a fixed resolution is scaled to fit (473x1024 for a 1080x2340 game), so a normalized centre point missed a centred image and top_left flipped to a negative y. It now agrees with simulate_mouse_click.
  • wait_for_compilation, get_compilation_errors, get_reload_recovery_status, get_editor_state and get_scene_info run again after a domain reload instead of answering the broker's "interrupted" stub. The new domain never re-ran a redelivered call and only an exact tool-name match against the recovery record produced a real answer, which a request_recompile record could never give these. The new [ReplaySafeTool] attribute opts a pure read into the replay; [ReadOnlyTool] does not imply it, because the input-simulation tools carry that one and would press the key twice.
  • get_console_logs with since_seconds and the default auto source answers "No ... entries found in cached logs from the last N second(s)" when the cache holds no match, instead of INVALID_SINCE_SECONDS. An empty cache is normal after a reload. An unknown parameter now also names the one it probably meant (limit -> count).
  • execute_code no longer fails with CS0104 on Object: a bare-body snippet, or a full class that imports both System and UnityEngine, resolves it to UnityEngine.Object. A class that implements IKitWrightCommand with the wrong signature gets a hint naming void Execute(ExecutionContext ctx).
  • A NaN or Infinity argument is refused as INVALID_PARAM for every float and double parameter, and x,y,z / x,y vectors no longer accept one either. Unity dropped such a value on a transform or camera and the tool still answered success. set_time_scale with NaN now answers INVALID_PARAM instead of INVALID_TIME_SCALE.
  • Text arguments that are JSON (batch_execute commands, properties, settings_json, edits) are read without date conversion, so an ISO-8601-looking string reaches the tool as written instead of being re-quoted or reformatted.
  • create_animation_clip and create_animator_controller refuse a name that is not a plain file name (../../x wrote outside Assets), accept a save_path without a trailing /, and refuse to replace an existing asset unless overwrite=true. copy_asset takes the same overwrite and create_folder refuses an illegal segment before it creates anything. delete_asset refuses .. segments, absolute paths and .meta files.
  • The Input Actions tools resolve every path through PathSafety (Assets only) and write through AtomicFile; they read and wrote any path on disk before.
  • set_component_properties keeps a value written through the reflection fallback when a later field of the same call applies; the stale serialized copy was written back over it. delete_game_object, rename_game_object and find_game_objects with by_path answer AMBIGUOUS_TARGET for two same-named siblings instead of acting on the first, an unknown find_method is INVALID_PARAM, and duplicate_game_object of a child stays under its parent.
  • set_rect_transform and the UI creators refuse an unparsable size, position or pivot and an unknown anchor preset instead of writing (0,0). add_component_to_many and paste_component_values report the tokens that matched nothing and fail when none succeeded.
  • Animator tools read enums by exact name only (99 and Float, Int no longer pass), refuse empty names, non-finite values and malformed conditions / keys; set_lighting_settings and set_active_tool do the same.
  • Configure never overwrites a client config it could not read (a locked ~/.claude.json was treated as missing and replaced), keeps the first .bak of what it replaces (never overwriting it, and writing nothing when the config is unchanged), keeps the user's own keys inside our entry in JSON and in the Codex TOML table, leaves dates alone, refuses a non-object mcpServers and a file that is not UTF-8, and checks that the merged text is still valid JSON before it writes. The Codex TOML table is found by line, so a # [mcp_servers.kitwright] comment no longer deletes the root keys. Rewrite finds the entry behind a comment and handles one old URL held under two keys.
  • create_prefab_variant with overwrite=true compares resolved paths, so Assets/X//Base.prefab can no longer overwrite the base prefab. execute_code blocks MoveAssetsToTrash as well. read_file does not split an emoji across parts, reports next_offset: null at the end and refuses an offset outside the file.
  • copy_asset and move_asset check the source and the destination before anything touches the disk. A source outside Assets / Packages (ProjectSettings/ProjectVersion.txt) used to open Unity's modal "Copying file failed" dialog, which freezes the editor until a human clicks it, and left the destination folders behind. delete_asset refuses the Assets and Packages roots and any .meta path however it ends, and trashes the normalised path.
  • create_animation_clip, create_animator_controller and create_material validate every folder of save_path (a .hid or x~ folder reported success for an asset Unity never imports) and answer the canonical path. add_animator_state refuses a . in the name, which Unity rewrites to _ and then could not find again. add_animator_transition refuses a negative duration. set_asset_import_settings refuses NaN and Infinity for every number.
  • by_path accepts the spellings Transform.Find did (Canvas/Panel/, A//B, A/../B) again. set_component_properties and the tools that share it refuse a non-finite number per field and still apply the other fields. create_button, create_text, create_image and create_ui_element refuse an unknown anchor before creating anything. set_volume_override_property reads a color through TryParseColor. The find_method parameter lists its seven values in the schema.
  • Results that carry text no longer have date-like strings reformatted on the way out: the nested results of batch_execute, the legacy tool payloads and structuredContent read the tool's JSON without date conversion (the last one also printed them in the editor's culture).
  • install_package and remove_package wait for the Package Manager request and report how it ended (PACKAGE_REQUEST_FAILED with its message) instead of always answering "initiated". remove_package refuses com.kitwright.unity.mcp, the package that runs the server.
  • [ReadOnlyTool] means the tool changes no project data; editor state such as the selection, the console or the plugin's own caches may change. wait_for_compilation (it refreshes the asset database) and memory_open_snapshot_in_profiler no longer carry it, so a client that skips the approval prompt for read-only tools asks for them. TOOL_NOT_EXPOSED names set_tool_profile when it is available, and the README and the tool description say that a profile shortens the tool list but is not an access control.
  • execute_code blocks FileUtil.ReplaceDirectory, ReplaceFile and MoveFileOrDirectory (and FileUtil.DeleteFileOrDirectory in the source scan as well as the compiled one). read_file refuses an offset inside a surrogate pair and names its unit.
  • profiler_start starts its recorders (they were created but never started, so the Render counters read 0 and profiler_status said not running; the "known limitation" in the description was a misdiagnosis). profiler_stop with no session says so and leaves Profiler.enabled alone, and get_counters without a session reads only the Memory counters (a one-shot read of the Render ones is always 0) and disposes the recorders it made. profiler_stop still turns the Profiler off after a domain reload, since the session flag is kept in SessionState, and a counter that does not exist in this Unity version is skipped instead of being listed as running.
  • add_sorting_layer writes a positive, unused id (a negative GetHashCode was written into an unsigned field as 0, which collides with Default and made about half of the names unusable); rename_sorting_layer looks up the old name first (a missing layer is SORTING_LAYER_NOT_FOUND), refuses a new name that already exists, and treats renaming to the same name as nothing to do. get_sorting_layers reports ids as signed integers like SortingLayer.id and warns about a layer other than Default that has id 0, which Unity reads as Default. set_selection answers NO_TARGETS_RESOLVED and leaves the selection alone when nothing resolved, instead of clearing it and reporting success, and counts a repeated token once.
  • get_execute_code_history reports a stable id per entry and replay_execute_code replays by that id (the parameter keeps the name index). The old index was a list position in a history capped at 50, so it moved whenever a new snippet ran and could re-run another client's mutating snippet; an id that is gone is HISTORY_ENTRY_NOT_FOUND, also one that predates clear_execute_code_history (it answered HISTORY_EMPTY) or an Editor restart (a new history numbers from the clock instead of 1).
  • execute_code can name the common Mono BCL assemblies (System.IO.Compression, System.Net.Http, System.Xml.Linq, System.Data, System.Numerics, ...); System.IO.Compression.ZipFile failed with CS1069 because the reference list was the assemblies the editor happened to have loaded, frozen at the first compile.
  • A tool whose optional package is not installed answers PACKAGE_NOT_INSTALLED with an install_package hint, also inside batch_execute, where it used to answer TOOL_NOT_EXPOSED under every profile. A refused or unknown call no longer waits behind a running mutating call just to be told no. batch_execute answers UNKNOWN_TOOL for an unknown name, as a direct call does (it was UNKNOWN_FUNCTION), and the install hint says install_package is not listed under the minimal and core profiles.
  • execute_code safety checks refuse HttpClientHandler and HttpMessageInvoker like HttpClient; they send requests too, and the BCL change above makes System.Net.Http always referenced.
  • execute_menu_item never runs a menu item that quits the editor, opens or switches the project, or clears PlayerPrefs, even with allow_modal=true (MENU_ITEM_REFUSED; execute_code already blocked closing the editor). Menu paths are compared with their empty segments dropped, because Unity runs //File/Exit, File//Exit and File/Exit/ as File/Exit, which slipped past the modal list and the new one. A path with a tab or newline is refused; what the tool learns as modal from a slow call expires after an hour instead of staying for good; the hint names a replacement tool only when the profile exposes it.
  • build_player refuses an output folder that is the project root, contains the project, or is Assets, ProjectSettings, Library, Packages, UserSettings, Temp or Logs (OUTPUT_PATH_REFUSED), also when it is spelled with trailing dots, a \\?\ prefix, an administrative share of this machine or an 8.3 short name.
  • mark_addressable answers ASSET_NOT_ADDRESSABLE when Addressables returns no entry, instead of a NullReferenceException, and removes a group it had just created for the call.
  • set_material_property refuses a built-in default, a material in an immutable package, and a read-only one such as a model's embedded material (MATERIAL_READ_ONLY); it used to edit it and report persistedToAsset:true for a change that could not be saved, or change Lit.mat in the package cache. A project material's reply names the asset and says every renderer using it changes. A forced type that disagrees with the shader property is INVALID_PARAM (the property did not change but the call succeeded), and 1e40 is refused instead of stored as Infinity.
  • set_parent answers PREFAB_INSTANCE_CHILD for a non-root child of a prefab instance and REPARENT_FAILED when Unity refuses the change, instead of "Parented"/"Unparented"; unparenting a root says it already is one. set_component_properties reports a refused Transform.parent the same way.
  • Writes go through AtomicFile in update_shader/create_shader, create_texture and the other texture writers, and memory_take_snapshot. AtomicFile writes through a symlink to its target instead of replacing the link, keeps a file's BOM and never writes two, writes in place when the sibling temp name would push a path just under the limit over it, and warns when it could not follow a link. The client-config auto-rewrite no longer overwrites a config that changed on disk since it was read.
  • A request_recompile cut short by a domain reload no longer reports "compilation finished successfully" while script files on disk are still newer than the last compilation: it answers SCRIPT_CHANGES_NOT_COMPILED and says to call it again (leaving Play Mode reloads before the compile starts). A read-only call running beside a mutating one no longer clears the mutating call's pending marker, so a reload still finds what it interrupted, and the recovery record the new domain wrote is not overwritten by the generic "interrupted" one. batch_execute inside batch_execute answers BATCH_NESTED (the budget, clock and undo group belong to the outer batch). replay_execute_code has the same timeout ceiling as execute_code, and tool names are matched case-insensitively against the ceilings. The editor-thread helper takes the main-thread context again on the editor thread when it was built before Unity installed it.
  • Play Mode and editor-state tools tell the truth about what they did. enter_play_mode is refused while the scripts have compile errors (COMPILATION_FAILED) and while an exit is still in flight, and exit_play_mode while an entry is (PLAY_MODE_TRANSITION_PENDING). set_time_scale outside Play Mode answers PLAY_MODE_REQUIRED instead of silently writing the project's TimeManager setting. set_lighting_settings says an ambient_light is stored but only shows with ambient_mode Flat, that fog_density is ignored by Linear fog, and that the change is discarded when Play Mode ends; bake_lightmaps answers BAKE_NOT_STARTED when Unity declines to start. play_animator_state in Edit Mode registers Undo and marks the scene modified. Scene View tools answer NO_SCENE_VIEW when there is no Scene View, and keep the selection. get_counters warns that Render counters read 0 until a frame has completed after profiler_start or a reload. The editor-context text refreshes when a compile starts or finishes and when an error is logged. get_test_job is replay-safe. get_console_logs refuses an unknown type with INVALID_PARAM.
  • build_player and modify_build_scenes refuse a scene that is not in the project (SCENE_NOT_FOUND), and switch_build_target reports a failed switch (SWITCH_FAILED) and that the switch was queued rather than done. The .asmdef tools refuse an existing file (ASMDEF_EXISTS) or assembly name (ASMDEF_NAME_EXISTS), refuse a call that changes nothing (NO_PARAMS) and validate their arguments (INVALID_PARAM). list_packages reads the whole manifest, reporting a missing one as MANIFEST_NOT_FOUND. set_project_settings saves only when it applied something.
  • Client configuration and skills: Configure refuses to overwrite a config that changed on disk since it was read, and the auto-rewrite changes only the KitWright entry, leaving the rest of the file as it was. Cursor .mdc rules keep their body and the skill frontmatter is validated. Settings are written atomically and keep a .bak. The Editor and Player prefs tools refuse a bad argument with INVALID_PARAM, read an integer the same way they write it, and accept true/false literals for a bool. Screenshots are written through AtomicFile.
  • execute_code: replay_execute_code takes skip_refresh and timeout_seconds, the CodeDom fallback references the same BCL assemblies as Roslyn, and execute_menu_item answers MENU_ITEM_DISABLED for a menu item that is not enabled right now and always refuses Window/Layouts/Revert Factory Settings (MENU_ITEM_REFUSED; it wipes the saved window layout), and mark_addressable refuses a path an Addressables group cannot serve (ASSET_NOT_ADDRESSABLE).
  • Terrain and NavMesh tools refuse what they cannot apply: non-finite or out-of-range sizes, scales, tile sizes, counts and heights (INVALID_SIZE, INVALID_SCALE, INVALID_TILE_SIZE, INVALID_COUNT, INVALID_TERRAIN_HEIGHT, INVALID_VECTOR), a bad name, a layer already added, a tree prototype already present (it is reported, not added twice), and Play Mode for a terrain whose data is a saved asset (EDIT_MODE_REQUIRED; a terrain created at runtime can be edited). The NavMesh bake says when it produced no NavMesh, and the agent path-finding tool answers AGENT_DISABLED and AGENT_NOT_ON_NAVMESH instead of success.
  • Audio, particle and Timeline tools: add_audio_listener only considers listeners in the target's own scene and answers LISTENER_EXISTS; add_audio_source on an object that has one and given no setting changes nothing and says so; director_evaluate answers NO_PLAYABLE_ASSET for a director without a timeline.
  • Texture and sprite tools: create_texture, apply_pattern, apply_gradient and apply_noise no longer replace an existing file (TEXTURE_EXISTS unless overwrite=true), write only .png, .jpg and .jpeg (INVALID_EXTENSION), refuse hidden or ~ folders, and refuse a color they cannot read (INVALID_PARAM; the comma form is 0-255 whole numbers, #hex and names also work) or an unknown pattern or gradient type instead of painting white. set_texture_as_sprite and slice_sprite_grid keep the current pixels-per-unit unless one is given (it was reset to 100), set_texture_as_sprite keeps a Multiple sheet Multiple, and slice_sprite_grid refuses a sheet that already has sprites (SPRITESHEET_EXISTS) unless overwrite=true, caps the grid at 10000 cells (TOO_MANY_CELLS; a huge padding or offset used to hang the editor), refuses a malformed offset (INVALID_OFFSET) and no longer loses the cut when nothing else on the importer changed. A refused slice leaves the importer untouched. Sprite Atlas tools refuse a non-packable asset (NOT_PACKABLE), report real counts, answer NOT_PACKED and NOTHING_TO_SET, and create_sprite_atlas refuses hidden folders. set_component_properties on a Sprite field that points at a sheet needs {"assetPath": "...", "subAsset": "<name>"} when the sheet has more than one sprite, and lists the names, instead of taking the first. set_asset_import_settings accepts a maxTextureSize only as a power of two from 32 to 16384.
  • uGUI tools: create_button, create_text, create_image and create_ui_element refuse a parent that is not under a Canvas (NOT_UNDER_CANVAS) or has no RectTransform (NO_RECT_TRANSFORM); create_button adds the EventSystem; the auto-created EventSystem uses InputSystemUIInputModule when Active Input Handling is not Old and the package is installed; created elements take the parent's layer and the Canvas the UI layer; create_canvas accepts world_space and Screen Space-Camera, refuses an unknown render_mode and reports the mode applied; size="" means the default size; font_size is limited to 1..1000, size, position and pivot to ±1e6, and a create_image color must be 0-1; a create_ui_element panel given a size and no anchor has that size; set_rect_transform with nothing to change is INVALID_PARAM. simulate_editor_window_key types digits correctly, refuses a numeric key and text together with key; simulate_editor_window_click limits click_count to 1..10, refuses an unknown button, answers NOTHING_AT_POINT outside the panel and AMBIGUOUS_TARGET when equally good windows match.
  • Camera, Volume and tag tools: the camera tools refuse what they cannot apply (an unknown or empty culling-mask layer name, an unknown mode, a bad clear_flags, a blank color, a non-positive size or clip plane, far not above near), read the stored value back, and answer NO_PARAMS for an empty call; the default camera is the Main Camera or the only camera, otherwise AMBIGUOUS_TARGET, and a target with no Camera answers NO_CAMERA_ON_TARGET. get_camera_properties reports the fields it says it does and says URP camera data is not included. create_volume validates the name before creating anything and registers the profile for Undo; add_volume_override and remove_volume_override go through Undo like the Inspector and add_volume_override takes override_all_parameters (default true, unchanged); set_volume_override_property accepts a declared enum name only (no number, no A,B), reports the stored value and saves, and says PARAM_TYPE_UNSUPPORTED for a Vector, Texture or LayerMask parameter. add_tag, remove_tag, add_layer and remove_layer trim names and save TagManager, and remove_tag of a built-in tag answers CANNOT_REMOVE_BUILTIN_TAG. set_tag_and_layer is an error when neither value could be applied. The physics queries refuse overflowing vectors, a direction that vanishes and max_hits <= 0.
  • The tool schema and the invoker agree. A parameter with a C# default is no longer listed as required in tools/list (set_component_properties keeps properties required), and a [Flags] enum parameter lists its names in the description rather than as a closed enum. The invoker reads decimal with the invariant culture (0,5 was 5), accepts True/TRUE for a bool, a plain enum only by a declared name (One,Two and 999 are refused; a [Flags] enum takes an exact comma list of names), arrays and List<T> as a JSON array, and Vector4/Quaternion as x,y,z,w without non-finite values; a Color parameter refuses NaN/Infinity and accepts a color name. A tool registered by hand with ToolRegistry.Register is exposed under every profile like a [ToolProvider] tool, answers UNKNOWN_PARAM for an argument it does not declare, and no longer fails on a null parameters or an empty name. An assembly that loads only in part keeps the tools it could load (with a warning naming it), property accessors and operators are no longer registered as tools, and the duplicate-tool warning names both assemblies.
  • NavMesh, Terrain, Timeline and particle follow-ups: bake_nav_mesh refuses an unsaved scene with SCENE_NOT_SAVED (Unity saved it as Assets/1.unity beside a NavMesh asset without saying so); clear_nav_mesh reports cleared only when nothing remains and says when runtime NavMesh data (NavMeshSurface, AddNavMeshData) is still loaded, with remainingVertexCount; create_terrain refuses Windows device names (CON, NUL, COM1...) with INVALID_NAME and a width, length or height above 100000 with INVALID_SIZE; director_evaluate takes a time between 0 and 1000000 only; particle_control on a container skips systems that are not active in the hierarchy and lists them as inactiveSkipped; add_tree_prototype warns when the prefab has no MeshRenderer. The Integrations panel's Timeline card names com.unity.modules.director, the module director_evaluate needs, not the Timeline package.
  • uGUI and editor-window follow-ups: when several windows match, simulate_editor_window_click and simulate_editor_window_key pick the one that is EditorWindow.focusedWindow (hasFocus is true for many windows at once, so the tie-break never worked); simulate_editor_window_key refuses key="None"; the create_image colour error no longer calls an out-of-range alpha a 0-255 mistake; the PARENT_NOT_FOUND hint offers create_canvas only when it is exposed; a Quaternion argument of 0,0,0,0 is refused; set_lighting_settings says that fog_color or fog_density show nothing while fog is off; a read-only tool cut short by a domain reload is told it can simply be called again instead of being sent to a recovery status that cannot hold anything for it.
  • Menu, skills, prefs and asmdef follow-ups: execute_menu_item answers MENU_ITEM_IS_SUBMENU for a submenu and MENU_ITEM_DISABLED only for an item proven to be a [MenuItem] leaf (a submenu used to be reported as disabled with advice to fix a precondition), and anything it cannot classify gets MENU_ITEM_NOT_FOUND with a hint that names missing, submenu and disabled; installed package skills and Cursor rules rendered by older code read as outdated and refresh on sync (the version marker now includes a renderer version); the prefs tools refuse NaN/Infinity floats, and set_player_pref takes type: "bool" (true/false/1/0/yes/no, stored as int 1/0); update_assembly_def_settings refuses a name another assembly definition uses (ASMDEF_NAME_EXISTS), set_assembly_platforms refuses include and exclude lists given together (INVALID_PARAM, it kept only the excludes), add_assembly_references with an empty list answers NO_PARAMS.
  • Texture, atlas, camera and tag follow-ups: create_texture, apply_pattern, apply_gradient and apply_noise with as_sprite=true import a new file as a Single sprite (an overwritten Multiple sheet stays Multiple), report the importer's real state in sprite and spriteMode, and refuse to overwrite a sliced sheet with an image of a different size (SPRITESHEET_EXISTS; the old slices would no longer fit) or keep the slices with a warning when the size is the same; add_to_sprite_atlas skips assets that are already packed or named twice (it listed them again and reported them as added); set_camera_projection refuses perspective while the near clip plane is 0 or below; set_tag_and_layer trims tag and layer like the tools that define them; set_asset_import_settings takes maxTextureSize only as a whole number (64.5 and "64" were truncated to 64); set_camera_settings says background_color is 0-1 floats.
  • Three tools answered FUNCTION_FAILED in Play Mode after they had already applied their change, because Unity refuses EditorSceneManager.MarkSceneDirty there: set_lighting_settings, set_material_property on a material that belongs to the scene, and director_evaluate (which failed before evaluating). They now apply and reply normally, and set_lighting_settings says the change is discarded when Play Mode ends.
  • request_recompile with exit_play_mode=true and edited scripts no longer leaves a final-looking SCRIPT_CHANGES_NOT_COMPILED error behind: leaving Play Mode reloads the domain before Unity's compile starts, so the recovery record now waits up to 25 seconds for that compile and records its real result, and only reports the error when no compile starts. Recovery timestamps are stored in UTC, so a recovery result cannot be overwritten by the generic "interrupted" record around a daylight-saving change; records written in the old local format still read.
  • Assembly definition and uGUI loose ends: list_assembly_defs marks each entry editable, false for an asmdef in a package that is not embedded in the project (a file: or registry package), and the other asmdef tools say so in the INVALID_PATH or ASMDEF_NOT_FOUND they answer for such a path instead of calling it an escape from the project; create_canvas, create_button and create_ui_element do not add a second EventSystem when the only one is inactive, they say to activate it; a refused simulate_editor_window_click (NOTHING_AT_POINT, IMGUI_CLICK_UNSUPPORTED) no longer focuses and repaints the window first; the get_editor_pref description says a stored 0 or 1 reads as bool under auto.
  • add_audio_source resolves a mixer group by its full path. Master/Music also matches the nested Master/Music/Music in FindMatchingGroups, and the old rule compared only the last name, so a full path could still answer MIXER_GROUP_AMBIGUOUS while the hint said to use one. The groups' own child lists give each group's path: an exact path wins, then a path that ends with the given one, and MIXER_GROUP_AMBIGUOUS is left for what really is ambiguous (Music). add_audio_listener still checks only the target's own scene for a second listener, and now says when another loaded scene has one (Unity warns about two listeners and only one is heard).
  • remove_assembly_references with an empty list answers NO_PARAMS instead of "Removed 0", like add_assembly_references. add_terrain_layer wrapping a texture on a terrain created at runtime (the only terrain Play Mode lets it edit) keeps the layer in memory instead of writing a .terrainlayer file to Assets.
  • Argument and file handling follow-ups: an integer array or List<int>-style parameter refuses an element that is not a JSON integer (1.5, "3", true, null) instead of rounding it (3.0 is still accepted); integer literals in tool arguments and ids keep their exact 64-bit value instead of going through a double (9007199254740993 used to arrive as ...992); a file that has other hard links (Windows) is written in place so every name sees the change, where the swap used to leave the other names on the old content; get_editor_pref with type omitted reports a stored integer as int and sets boolLike for 0 and 1 (it called them bool, so a written int did not read back as one), pass type: "bool" to read the bool.
  • request_recompile recovery no longer stores a transient SCRIPT_CHANGES_NOT_COMPILED record, warning or log entry while the compile is still being waited on, and the external-sync pending marker ages in UTC (an unreadable stamp counts as not pending).
  • Project Skills: the managed block in CLAUDE.md and AGENTS.md no longer embeds the absolute project path (it churned every checkout and leaked a local path); a marker counts only as a whole line, so a file that merely mentions it no longer breaks sync or disable; a file with broken markers or invalid UTF-8 is refused before the manifest or any file is written; BOM and line endings are kept when rewriting instruction and skill files; removal deletes only files the manifest lists, from a folder whose SKILL.md carries the managed header, and never a folder that holds other files; a GameWright block is replaced in place instead of getting a second KitWright block appended; files beside a package skill's SKILL.md (scripts/, references/...) are installed with it and tracked in managedFiles of the manifest.
  • Housekeeping: Library/KitWrightMcp/Screenshots keeps the newest 200 files and deletes older ones only when they are also more than 7 days old (the activity-log images keep 100); %TEMP%\KitWrightExecuteCode\<guid> folders left by a killed compile are removed after an hour; the per-session maps behind tool-list notifications and protocol negotiation are capped at 256 sessions.
  • In Play Mode a successful reply from a tool that edits scene objects (create_game_object, set_transform, add_component, the uGUI creators and similar) ends with the note that the change is discarded when Play Mode ends, as set_lighting_settings already said. modify_build_scenes says Build Settings has no Undo and returns undoable: false.
  • A file with other hard links is also written in place on macOS and Linux (the link count comes from the system stat tool; any failure falls back to the old swap, which breaks the link). batch_execute gives a scene-editing command run inside a batch in Play Mode the same "discarded when Play Mode ends" note as a direct call.
  • Project Skills follow-ups: CLAUDE.md, AGENTS.md and package SKILL.md files with classic-Mac (CR-only) line endings are recognised, so the managed block is replaced in place instead of a second one being appended on every sync, and the file is written back with CR; removing a package's skills also works for folders an older version wrote without a managedFiles record (the folder goes when the package is gone, its SKILL.md has the managed header and nothing else is in it; otherwise it is kept with a warning); after a GameWright to KitWright upgrade, gamewright-<id> skill folders and gamewright-<id>.mdc Cursor rules are removed when the same skill is installed in the same sync and they carry the old header and none of your files, and anything else is kept and listed in a warning.
  • Project Skills no longer repeats the same warning (a skill folder it keeps because it holds your files, a file it will not overwrite) on every sync; each message is logged once per editor session.