@atelierai/uco 1.0.0

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Delete.cs

@@ -0,0 +1,97 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using AIGD;
+using System.Collections.Generic;
+using System.ComponentModel;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Utils;
+using com.AtelierAI.Unity.Copilot.Editor.Utils;
+using com.AtelierAI.Unity.Copilot.Utils;
+using Microsoft.Extensions.Logging;
+using UnityEditor;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Assets
+    {
+        public const string AssetsDeleteToolId = "assets-delete";
+        [UcoTool
+        (
+            AssetsDeleteToolId,
+            Title = "Assets / Delete",
+            DestructiveHint = true,
+            Enabled = false
+        )]
+        [UcoSkillDescription("Delete the assets at the given project paths. " +
+            "Refreshes the AssetDatabase at the end. " +
+            "Use '" + AssetsFindToolId + "' to locate the assets first.")]
+        [UcoSkillBody("Delete the assets at paths from the project. " +
+            "Does AssetDatabase.Refresh() at the end. " +
+            "Use '" + AssetsFindToolId + "' tool to find assets before deleting.\n\n" +
+            "## Inputs\n\n" +
+            "- `paths` — project-relative asset paths to delete. Must be non-empty.\n\n" +
+            "## Behavior\n\n" +
+            "Routes through `AssetDatabase.DeleteAssets`, which deletes the batch atomically. " +
+            "Paths Unity reports as failed are surfaced in `response.Errors`; successfully deleted paths " +
+            "are surfaced in `response.DeletedPaths`. The tool is destructive (removes files from disk).")]
+        [Description("Delete the assets at paths from the project. " +
+            "Does AssetDatabase.Refresh() at the end. " +
+            "Use '" + AssetsFindToolId + "' tool to find assets before deleting.")]
+        public DeleteAssetsResponse Delete
+        (
+            [Description("The paths of the assets")]
+            string[] paths
+        )
+        {
+            return MainThread.Instance.Run(() =>
+            {
+                var logger = UnityLoggerFactory.LoggerFactory.CreateLogger<Tool_Assets>();
+
+                if (paths.Length == 0)
+                    throw new System.Exception(Error.SourcePathsArrayIsEmpty());
+
+                logger.LogInformation("Deleting {Count} asset(s): {Paths}", paths.Length, string.Join(", ", paths));
+
+                var response = new DeleteAssetsResponse();
+                var outFailedPaths = new List<string>();
+                var success = AssetDatabase.DeleteAssets(paths, outFailedPaths);
+
+                if (!success)
+                {
+                    response.Errors ??= new();
+                    foreach (var failedPath in outFailedPaths)
+                    {
+                        logger.LogWarning("Failed to delete asset at '{Path}'", failedPath);
+                        response.Errors.Add($"Failed to delete asset at {failedPath}.");
+                    }
+                }
+
+                // Add successfully deleted paths
+                foreach (var path in paths)
+                {
+                    if (!outFailedPaths.Contains(path))
+                    {
+                        logger.LogInformation("Successfully deleted asset at '{Path}'", path);
+                        response.DeletedPaths ??= new();
+                        response.DeletedPaths.Add(path);
+                    }
+                }
+
+                AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport);
+                EditorUtils.RepaintAllEditorWindows();
+
+                return response;
+            });
+        }
+
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Delete.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b96e6ba7cd7d96344a8efcd5128a9dc5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Find.cs

@@ -0,0 +1,95 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using System.Collections.Generic;
+using System.ComponentModel;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Utils;
+using AIGD;
+using UnityEditor;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Assets
+    {
+        public const string AssetsFindToolId = "assets-find";
+        [UcoTool
+        (
+            AssetsFindToolId,
+            Title = "Assets / Find",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription("Search the Unity asset database using a search filter string. " +
+            "The filter accepts names, labels (`l:`), types (`t:`), AssetBundles (`b:`), areas (`a:`), and globs (`glob:`). " +
+            "See the body for the full filter syntax.")]
+        [UcoSkillBody("Search the asset database using the search filter string. " +
+            "Allows you to search for Assets. The string argument can provide names, labels or types (classnames).\n\n" +
+            "## Filter syntax\n\n" +
+            "- **Name** — filter assets by their filename (without extension). Words separated by whitespace are " +
+            "treated as separate name searches.\n" +
+            "- **Labels (`l:`)** — assets can have labels attached. Use `l:` before each label.\n" +
+            "- **Types (`t:`)** — find assets based on explicitly identified types. Available types include " +
+            "AnimationClip, AudioClip, AudioMixer, ComputeShader, Font, GUISkin, Material, Mesh, Model, " +
+            "PhysicMaterial, Prefab, Scene, Script, Shader, Sprite, Texture, VideoClip, VisualEffectAsset, " +
+            "VisualEffectSubgraph.\n" +
+            "- **AssetBundles (`b:`)** — find assets which are part of an Asset bundle.\n" +
+            "- **Area (`a:`)** — find assets in a specific area. Valid values: `all`, `assets`, `packages`.\n" +
+            "- **Globbing (`glob:`)** — use globbing to match specific rules.\n\n" +
+            "Searching is case-insensitive. Use `searchInFolders` to restrict the search scope. " +
+            "`maxResults` caps the returned list (default 10) — results beyond it are truncated.")]
+        [Description("Search the asset database using the search filter string. " +
+            "Allows you to search for Assets. The string argument can provide names, labels or types (classnames).")]
+        public List<AssetObjectRef> Find
+        (
+            // <ref>https://docs.unity3d.com/ScriptReference/AssetDatabase.FindAssets.html</ref>
+            [Description("The filter string can contain search data. Could be empty. " +
+                "Name: Filter assets by their filename (without extension). Words separated by whitespace are treated as separate name searches. " +
+                "Labels (l:): Assets can have labels attached to them. Use 'l:' before each label. " +
+                "Types (t:): Find assets based on explicitly identified types. Use 't:' keyword. Available types: AnimationClip, AudioClip, AudioMixer, ComputeShader, Font, GUISkin, Material, Mesh, Model, PhysicMaterial, Prefab, Scene, Script, Shader, Sprite, Texture, VideoClip, VisualEffectAsset, VisualEffectSubgraph. " +
+                "AssetBundles (b:): Find assets which are part of an Asset bundle. " +
+                "Area (a:): Find assets in a specific area. Valid values are 'all', 'assets', and 'packages'. " +
+                "Globbing (glob:): Use globbing to match specific rules. " +
+                "Note: Searching is case insensitive.")]
+            string? filter = null,
+            [Description("The folders where the search will start. If null, the search will be performed in all folders.")]
+            string[]? searchInFolders = null,
+            [Description("Maximum number of assets to return. If the number of found assets exceeds this limit, the result will be truncated.")]
+            int maxResults = 10
+        )
+        {
+            if (maxResults <= 0)
+                throw new System.ArgumentException($"{nameof(maxResults)} must be greater than zero.");
+
+            return MainThread.Instance.Run(() =>
+            {
+                var assetGuids = (searchInFolders?.Length ?? 0) == 0
+                    ? AssetDatabase.FindAssets(filter ?? string.Empty)
+                    : AssetDatabase.FindAssets(filter ?? string.Empty, searchInFolders);
+
+                var response = new List<AssetObjectRef>();
+
+                for (var i = 0; i < assetGuids.Length && i < maxResults; i++)
+                {
+                    var assetPath = AssetDatabase.GUIDToAssetPath(assetGuids[i]);
+                    var assetType = AssetDatabase.GetMainAssetTypeAtPath(assetPath);
+                    var assetObject = AssetDatabase.LoadAssetAtPath(assetPath, assetType);
+                    if (assetObject == null)
+                        continue;
+
+                    response.Add(new AssetObjectRef(assetObject));
+                }
+
+                return response;
+            });
+        }
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Find.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 29edf70368523fc4c98f917595522d2c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.FindBuiltIn.cs

@@ -0,0 +1,140 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Utils;
+using com.AtelierAI.Unity.Copilot.Editor.Utils;
+using AIGD;
+using com.AtelierAI.Unity.Copilot.Runtime.Extensions;
+using UnityObject = UnityEngine.Object;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Assets
+    {
+        public const string AssetsFindBuiltInToolId = "assets-find-built-in";
+        [UcoTool
+        (
+            AssetsFindBuiltInToolId,
+            Title = "Assets / Find (Built-in)",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription("Search the built-in assets of the Unity Editor (located at " +
+            ExtensionsRuntimeObject.UnityEditorBuiltInResourcesPath + "). " +
+            "Filters by name and/or type; built-in assets have no GUID so GUID-based lookups are not supported.")]
+        [UcoSkillBody("Search the built-in assets of the Unity Editor located in the built-in resources: " +
+            ExtensionsRuntimeObject.UnityEditorBuiltInResourcesPath + ". " +
+            "Doesn't support GUIDs since built-in assets do not have them.\n\n" +
+            "## Inputs\n\n" +
+            "- `name` (optional) — case-insensitive name fragment. Underscores, hyphens, spaces, and periods " +
+            "delimit search words so partial-word matching works.\n" +
+            "- `type` (optional) — restrict results to assets assignable to this type (e.g. `UnityEngine.Texture2D`).\n" +
+            "- `maxResults` — cap on returned list size (default 10).\n\n" +
+            "## Ranking\n\n" +
+            "Results are sorted by descending match quality: exact match → substring match → all-words match → " +
+            "partial-words match. Within a rank, results are sorted alphabetically by filename for stable ordering.")]
+        [Description("Search the built-in assets of the Unity Editor located in the built-in resources: " +
+            ExtensionsRuntimeObject.UnityEditorBuiltInResourcesPath + ". " +
+            "Doesn't support GUIDs since built-in assets do not have them.")]
+        public List<AssetObjectRef> FindBuiltIn
+        (
+            [Description("The name of the asset to filter by.")]
+            string? name = null,
+            [Description("The type of the asset to filter by.")]
+            Type? type = null,
+            [Description("Maximum number of assets to return. If the number of found assets exceeds this limit, the result will be truncated.")]
+            int maxResults = 10
+        )
+        {
+            if (maxResults <= 0)
+                throw new ArgumentException($"{nameof(maxResults)} must be greater than zero.");
+
+            var nameWords = string.IsNullOrEmpty(name)
+                ? Array.Empty<string>()
+                : name!.Split(new[] { ' ', '_', '-', '.' }, StringSplitOptions.RemoveEmptyEntries);
+
+            return MainThread.Instance.Run(() =>
+            {
+                return BuiltInAssetCache.GetAllAssets()
+                    .Where(obj => obj != null && !string.IsNullOrEmpty(obj.name))
+                    .Where(obj => type == null || type.IsAssignableFrom(obj.GetType()))
+                    .Select(obj => ToAssetObjectRef(obj))
+                    .Select(assetRef => (assetRef, priority: GetMatchPriority(assetRef, name, nameWords)))
+                    .Where(x => x.priority >= 0)
+                    .OrderBy(x => x.priority)
+                    .ThenBy(x => GetAssetFileName(x.assetRef)) // Secondary sort for consistent ordering
+                    .Take(maxResults)
+                    .Select(x => x.assetRef)
+                    .ToList();
+            });
+        }
+
+        private static string? GetAssetFileName(AssetObjectRef assetRef)
+        {
+            if (string.IsNullOrEmpty(assetRef.AssetPath))
+                return null;
+            return System.IO.Path.GetFileNameWithoutExtension(assetRef.AssetPath);
+        }
+
+        private static int GetMatchPriority(AssetObjectRef assetRef, string? name, string[] nameWords)
+        {
+            if (string.IsNullOrEmpty(name))
+                return 0; // No name filter, all items have same priority
+
+            var assetName = GetAssetFileName(assetRef);
+            if (string.IsNullOrEmpty(assetName))
+                return -1; // No valid asset name
+
+            if (assetName!.Equals(name, StringComparison.OrdinalIgnoreCase))
+                return 0; // Exact match - top priority
+
+            if (assetName.Contains(name!, StringComparison.OrdinalIgnoreCase))
+                return 1; // Partial match - medium priority
+
+            if (nameWords.Length > 0)
+            {
+                var matchedWords = nameWords.Count(word =>
+                    assetName.Contains(word, StringComparison.OrdinalIgnoreCase));
+
+                if (matchedWords == nameWords.Length)
+                    return 2; // All words match - higher word match priority
+
+                if (matchedWords > 0)
+                    return 3; // Some words match - lower word match priority
+            }
+
+            return -1; // No match
+        }
+
+        private static AssetObjectRef ToAssetObjectRef(UnityObject obj)
+        {
+            var assetObjRef = new AssetObjectRef(obj)
+            {
+                AssetGuid = null // Unity built-in assets do not have GUIDs
+            };
+
+            // Distinguish built-in assets: if the path doesn't end with the asset name, append it.
+            // This handles cases where multiple built-in assets map to "Resources/unity_builtin_extra".
+            if (!string.IsNullOrEmpty(assetObjRef.AssetPath) && !assetObjRef.AssetPath!.EndsWith("/" + obj.name))
+            {
+                var extension = BuiltInAssetCache.GetExtensionForAsset(obj);
+                assetObjRef.AssetPath = $"{assetObjRef.AssetPath}/{obj.name}{extension}";
+            }
+
+            return assetObjRef;
+        }
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.FindBuiltIn.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ba51c2deb10d4444180f962f14da4c1e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.GetData.cs

@@ -0,0 +1,119 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Model;
+using com.IvanMurzak.ReflectorNet.Utils;
+using com.AtelierAI.Unity.Copilot.Editor.Utils;
+using AIGD;
+using com.AtelierAI.Unity.Copilot.Runtime.Extensions;
+using com.AtelierAI.Unity.Copilot.Utils;
+using Microsoft.Extensions.Logging;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Assets
+    {
+        public const string AssetsGetDataToolId = "assets-get-data";
+        [UcoTool
+        (
+            AssetsGetDataToolId,
+            Title = "Assets / Get Data",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription("Get asset data from the asset file in the Unity project — every serializable " +
+            "field and property. Supports token-saving path-scoped reads via `paths` or `viewQuery`. " +
+            "Use '" + AssetsFindToolId + "' to find the asset first.")]
+        [UcoSkillBody("Get asset data from the asset file in the Unity project. " +
+            "It includes all serializable fields and properties of the asset. " +
+            "Use '" + AssetsFindToolId + "' tool to find asset before using this tool.\n\n" +
+            "## Path-scoped reads (token-saving)\n\n" +
+            "Supply `paths` (a list of paths) to read only the listed fields/elements via " +
+            "`Reflector.TryReadAt`, or `viewQuery` (a `ViewQuery`) to navigate to a subtree and/or filter by " +
+            "name regex / max depth / type via `Reflector.View`. These two parameters are mutually exclusive — " +
+            "supply at most one. When neither is supplied the full asset is serialized (backwards compatible).\n\n" +
+            "## Path syntax\n\n" +
+            "`fieldName`, `nested/field`, `arrayField/[i]`, `dictField/[key]`. Leading `#/` is stripped.")]
+        [Description("Get asset data from the asset file in the Unity project. " +
+            "It includes all serializable fields and properties of the asset. " +
+            "Use '" + AssetsFindToolId + "' tool to find asset before using this tool.\n\n" +
+            "Path-scoped reads (token-saving): supply '" + "paths" + "' (a list of paths) to read only the listed " +
+            "fields/elements via Reflector.TryReadAt, or '" + "viewQuery" + "' (a ViewQuery) to navigate to a " +
+            "subtree and/or filter by name regex / max depth / type via Reflector.View. " +
+            "These two parameters are mutually exclusive — supply at most one. " +
+            "When neither is supplied the full asset is serialized as before (backwards compatible).\n" +
+            "Path syntax: 'fieldName', 'nested/field', 'arrayField/[i]', 'dictField/[key]'. Leading '#/' is stripped.")]
+        public SerializedMember GetData
+        (
+            AssetObjectRef assetRef,
+            [Description("Optional. List of paths to read individually via Reflector.TryReadAt. " +
+                "Path syntax: 'fieldName', 'nested/field', 'arrayField/[i]', 'dictField/[key]'. " +
+                "Mutually exclusive with '" + "viewQuery" + "'.")]
+            List<string>? paths = null,
+            [Description("Optional. View-query filter routed through Reflector.View — combines a starting Path, " +
+                "a case-insensitive NamePattern regex, MaxDepth, and an optional TypeFilter. " +
+                "Mutually exclusive with '" + "paths" + "'.")]
+            ViewQuery? viewQuery = null
+        )
+        {
+            if (assetRef == null)
+                throw new ArgumentNullException(nameof(assetRef));
+
+            if (!assetRef.IsValid(out var error))
+                throw new ArgumentException(error, nameof(assetRef));
+
+            var hasPaths = paths != null && paths.Count > 0;
+            var hasViewQuery = viewQuery != null;
+            if (hasPaths && hasViewQuery)
+                throw new ArgumentException(
+                    $"'{nameof(paths)}' and '{nameof(viewQuery)}' are mutually exclusive — supply at most one.");
+
+            return MainThread.Instance.Run(() =>
+            {
+                var asset = assetRef.FindAssetObject();
+                if (asset == null)
+                {
+                    // Built-in assets fallback (uses cached assets to avoid repeated expensive LoadAllAssetsAtPath calls)
+                    if (!string.IsNullOrEmpty(assetRef.AssetPath) && assetRef.AssetPath!.StartsWith(ExtensionsRuntimeObject.UnityEditorBuiltInResourcesPath))
+                    {
+                        var targetName = System.IO.Path.GetFileNameWithoutExtension(assetRef.AssetPath);
+                        var ext = System.IO.Path.GetExtension(assetRef.AssetPath);
+                        asset = BuiltInAssetCache.FindAssetByExtension(targetName, ext);
+                    }
+                }
+
+                if (asset == null)
+                    throw new Exception(Error.NotFoundAsset(assetRef.AssetPath!, assetRef.AssetGuid ?? "N/A"));
+
+                var reflector = UnityCopilotPluginEditor.Instance.Reflector ?? throw new Exception("Reflector is not available.");
+                var logger = UnityLoggerFactory.LoggerFactory.CreateLogger<Tool_Assets>();
+
+                if (hasPaths)
+                    return PathReadHelper.BuildPathReadAggregate(reflector, asset, asset.name, paths!, logger);
+
+                if (hasViewQuery)
+                    return reflector.View(asset, viewQuery, logs: null, logger: logger)
+                        ?? new SerializedMember { name = asset.name, typeName = asset.GetType().FullName ?? string.Empty };
+
+                return reflector.Serialize(
+                    obj: asset,
+                    name: asset.name,
+                    recursive: true,
+                    logger: logger
+                );
+            });
+        }
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.GetData.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 06637f7f24ac6e842b3e28d125650f57
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Material.Create.cs

@@ -0,0 +1,90 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using System;
+using System.ComponentModel;
+using System.IO;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Utils;
+using com.AtelierAI.Unity.Copilot.Editor.Utils;
+using AIGD;
+using UnityEditor;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Assets
+    {
+        public const string AssetsMaterialCreateToolId = "assets-material-create";
+        [UcoTool
+        (
+            AssetsMaterialCreateToolId,
+            Title = "Assets / Create Material"
+        )]
+        [UcoSkillDescription("Create a new Material asset with default parameters at a given 'Assets/'-rooted " +
+            "path ending in '.mat'. Creates intermediate folders if missing. Use '" +
+            Tool_Assets_Shader.AssetsShaderListAllToolId + "' to find a valid `shaderName`.")]
+        [UcoSkillBody("Create new material asset with default parameters. " +
+            "Creates folders recursively if they do not exist. " +
+            "Provide proper 'shaderName' - use '" + Tool_Assets_Shader.AssetsShaderListAllToolId + "' tool to find available shaders.\n\n" +
+            "## Inputs\n\n" +
+            "- `assetPath` — must start with `Assets/` and end with `.mat`.\n" +
+            "- `shaderName` — name resolvable via `UnityEngine.Shader.Find`.\n\n" +
+            "## Behavior\n\n" +
+            "Throws if the path is empty, malformed, or the shader cannot be resolved. " +
+            "Creates a default Material from the resolved shader, saves it, refreshes the AssetDatabase, " +
+            "and returns an `AssetObjectRef` pointing at the new asset.")]
+        [Description("Create new material asset with default parameters. " +
+            "Creates folders recursively if they do not exist. " +
+            "Provide proper 'shaderName' - use '" + Tool_Assets_Shader.AssetsShaderListAllToolId + "' tool to find available shaders.")]
+        public AssetObjectRef CreateMaterial
+        (
+            [Description("Asset path. Starts with 'Assets/'. Ends with '.mat'.")]
+            string assetPath,
+            [Description("Name of the shader that need to be used to create the material.")]
+            string shaderName
+        )
+        {
+            return MainThread.Instance.Run(() =>
+            {
+                if (string.IsNullOrEmpty(assetPath))
+                    throw new ArgumentException(Error.EmptyAssetPath(), nameof(assetPath));
+
+                if (!assetPath.StartsWith("Assets/"))
+                    throw new ArgumentException(Error.AssetPathMustStartWithAssets(assetPath), nameof(assetPath));
+
+                if (!assetPath.EndsWith(".mat"))
+                    throw new ArgumentException(Error.AssetPathMustEndWithMat(assetPath), nameof(assetPath));
+
+                var shader = UnityEngine.Shader.Find(shaderName);
+                if (shader == null)
+                    throw new ArgumentException(Error.ShaderNotFound(shaderName), nameof(shaderName));
+
+                var material = new UnityEngine.Material(shader);
+
+                // Create all folders in the path if they do not exist
+                var directory = Path.GetDirectoryName(assetPath);
+                if (!string.IsNullOrEmpty(directory) && !Directory.Exists(directory))
+                {
+                    Directory.CreateDirectory(directory);
+                    AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport);
+                }
+
+                AssetDatabase.CreateAsset(material, assetPath);
+                AssetDatabase.SaveAssets();
+                AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport);
+
+                EditorUtils.RepaintAllEditorWindows();
+
+                return new AssetObjectRef(material);
+            });
+        }
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Material.Create.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 326e37ac4dcd290449d11717e4bba24b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Material.cs

@@ -0,0 +1,23 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak)             │
+│  Repository: GitHub (https://github.com/IvanMurzak/Unity-MCP)    │
+│  Copyright (c) 2025 Ivan Murzak                                  │
+│  Licensed under the Apache License, Version 2.0.                 │
+│  See the LICENSE file in the project root for more information.  │
+└──────────────────────────────────────────────────────────────────┘
+*/
+
+#nullable enable
+using com.AtelierAI.Uco.Framework;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    [UcoToolType]
+    public partial class Tool_Assets_Material
+    {
+        public static class Error
+        {
+        }
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Assets.Material.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 598b37cb5cbd51f43a96e19db16ddac4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: