@atelierai/uco 1.0.0

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.Get.pre-Unity.6.5.cs

@@ -0,0 +1,168 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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
+#if !UNITY_6000_5_OR_NEWER
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet;
+using com.IvanMurzak.ReflectorNet.Model;
+using com.IvanMurzak.ReflectorNet.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_GameObject
+    {
+        public const string GameObjectComponentGetToolId = "gameobject-component-get";
+        [UcoTool
+        (
+            GameObjectComponentGetToolId,
+            Title = "GameObject / Component / Get",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription(ComponentGetSkill.Description)]
+        [UcoSkillBody(ComponentGetSkill.Body)]
+        [Description("Get detailed information about a specific Component on a GameObject. " +
+            "Returns component type, enabled state, and optionally serialized fields and properties. " +
+            "Use this to inspect component data before modifying it. " +
+            "Use '" + GameObjectFindToolId + "' tool to get the list of all components on the GameObject.\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. The result is returned in the " +
+            "'View' field of the response. These two parameters are mutually exclusive — supply at most one.\n" +
+            "Path syntax: 'fieldName', 'nested/field', 'arrayField/[i]', 'dictField/[key]'. Leading '#/' is stripped.")]
+        public GetComponentResponse GetComponent
+        (
+            GameObjectRef gameObjectRef,
+            ComponentRef componentRef,
+            [Description("Include serialized fields of the component.")]
+            bool includeFields = true,
+            [Description("Include serialized properties of the component.")]
+            bool includeProperties = true,
+            [Description("Performs deep serialization including all nested objects. Otherwise, only serializes top-level members.")]
+            bool deepSerialization = false,
+            [Description("Optional. List of paths to read individually via Reflector.TryReadAt. " +
+                "When supplied, the legacy 'Fields'/'Properties' lists are skipped and the result is returned in 'View'. " +
+                "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. " +
+                "When supplied, the legacy 'Fields'/'Properties' lists are skipped and the filtered subtree is " +
+                "returned in 'View'. Mutually exclusive with 'paths'.")]
+            ViewQuery? viewQuery = null
+        )
+        {
+            if (gameObjectRef == null)
+                throw new ArgumentNullException(nameof(gameObjectRef));
+
+            if (componentRef == null)
+                throw new ArgumentNullException(nameof(componentRef));
+
+            if (!gameObjectRef.IsValid(out var gameObjectValidationError))
+                throw new ArgumentException(gameObjectValidationError, nameof(gameObjectRef));
+
+            if (!componentRef.IsValid(out var componentValidationError))
+                throw new ArgumentException(componentValidationError, nameof(componentRef));
+
+            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 go = gameObjectRef.FindGameObject(out var error);
+                if (error != null)
+                    throw new Exception(error);
+
+                if (go == null)
+                    throw new Exception("GameObject not found.");
+
+                var allComponents = go.GetComponents<UnityEngine.Component>();
+                UnityEngine.Component? targetComponent = null;
+                int targetIndex = -1;
+
+                for (int i = 0; i < allComponents.Length; i++)
+                {
+                    if (componentRef.Matches(allComponents[i], i))
+                    {
+                        targetComponent = allComponents[i];
+                        targetIndex = i;
+                        break;
+                    }
+                }
+
+                if (targetComponent == null)
+                    throw new Exception(Error.NotFoundComponent(componentRef.InstanceID, allComponents));
+
+                var response = new GetComponentResponse
+                {
+                    Reference = new ComponentRef(targetComponent),
+                    Index = targetIndex,
+                    Component = new ComponentDataShallow(targetComponent)
+                };
+
+                var reflector = UnityCopilotPluginEditor.Instance.Reflector ?? throw new Exception("Reflector is not available.");
+                var logger = UnityLoggerFactory.LoggerFactory.CreateLogger<Tool_GameObject>();
+
+                if (hasPaths)
+                {
+                    response.View = PathReadHelper.BuildPathReadAggregate(
+                        reflector, targetComponent, targetComponent.GetType().GetTypeId(), paths!, logger);
+                }
+                else if (hasViewQuery)
+                {
+                    response.View = reflector.View(targetComponent, viewQuery, logs: null, logger: logger)
+                        ?? new SerializedMember
+                        {
+                            name = targetComponent.GetType().GetTypeId(),
+                            typeName = targetComponent.GetType().FullName ?? string.Empty
+                        };
+                }
+                else if (includeFields || includeProperties)
+                {
+                    var serialized = reflector.Serialize(
+                        obj: targetComponent,
+                        name: targetComponent.GetType().GetTypeId(),
+                        recursive: deepSerialization,
+                        logger: logger
+                    );
+
+                    if (includeFields && serialized?.fields != null)
+                    {
+                        response.Fields = serialized.fields
+                            .Where(f => f != null)
+                            .ToList();
+                    }
+
+                    if (includeProperties && serialized?.props != null)
+                    {
+                        response.Properties = serialized.props
+                            .Where(p => p != null)
+                            .ToList();
+                    }
+                }
+
+                return response;
+            });
+        }
+
+    }
+}
+#endif

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.Get.pre-Unity.6.5.cs.meta

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

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.ListAll.cs

@@ -0,0 +1,98 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet;
+using com.IvanMurzak.ReflectorNet.Utils;
+using UnityEditor;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_GameObject
+    {
+        public static IEnumerable<Type> AllComponentTypes => TypeUtils.AllTypes
+            .Where(type => typeof(UnityEngine.Component).IsAssignableFrom(type) && !type.IsAbstract);
+
+        public const string ComponentListToolId = "gameobject-component-list-all";
+        [UcoTool
+        (
+            ComponentListToolId,
+            Title = "GameObject / Component / List All",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription("List the fully-qualified C# type names of every concrete `UnityEngine.Component` " +
+            "subclass available in the project. Paginated (default 5/page, max 500). " +
+            "Use this to find a valid `componentName` for '" + GameObjectComponentAddToolId + "'.")]
+        [UcoSkillBody("List C# class names extended from UnityEngine.Component. " +
+            "Use this to find component type names for '" + GameObjectComponentAddToolId + "' tool. " +
+            "Results are paginated to avoid overwhelming responses.\n\n" +
+            "## Inputs\n\n" +
+            "- `search` (optional) — case-insensitive substring filter on type names.\n" +
+            "- `page` (default 0, 0-based) — page index.\n" +
+            "- `pageSize` (default 5, range 1..500) — items per page.\n\n" +
+            "## Behavior\n\n" +
+            "Enumerates `AllComponentTypes` (every non-abstract subclass of `UnityEngine.Component`), filters by " +
+            "`search` if supplied, then returns a `ComponentListResult` containing the requested page plus " +
+            "`TotalCount` / `TotalPages` so the caller can iterate.")]
+        [Description("List C# class names extended from UnityEngine.Component. " +
+            "Use this to find component type names for '" + GameObjectComponentAddToolId + "' tool. " +
+            "Results are paginated to avoid overwhelming responses.")]
+        public ComponentListResult ListAll
+        (
+            [Description("Substring for searching components. Could be empty.")]
+            string? search = null,
+            [Description("Page number (0-based). Default is 0.")]
+            int page = 0,
+            [Description("Number of items per page. Default is 5. Max is 500.")]
+            int pageSize = 5
+        )
+        {
+            // Clamp pageSize to valid range
+            pageSize = Math.Clamp(pageSize, 1, 500);
+            page = Math.Max(0, page);
+
+            var componentTypes = AllComponentTypes
+                .Select(type => type.GetTypeId())
+                .Where(typeName => typeName != null);
+
+            if (!string.IsNullOrEmpty(search))
+            {
+                componentTypes = componentTypes
+                    .Where(typeName => typeName.Contains(search, StringComparison.OrdinalIgnoreCase));
+            }
+
+            var allItems = componentTypes.Cast<string>().ToList();
+            var totalCount = allItems.Count;
+            var totalPages = (int)Math.Ceiling((double)totalCount / pageSize);
+
+            var pagedItems = allItems
+                .Skip(page * pageSize)
+                .Take(pageSize)
+                .ToArray();
+
+            return new ComponentListResult
+            {
+                Items = pagedItems,
+                Page = page,
+                PageSize = pageSize,
+                TotalCount = totalCount,
+                TotalPages = totalPages
+            };
+        }
+
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.ListAll.cs.meta

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

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.Modify.cs

@@ -0,0 +1,200 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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.AtelierAI.Unity.Copilot.Editor.Utils;
+using com.IvanMurzak.ReflectorNet.Model;
+using com.IvanMurzak.ReflectorNet.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_GameObject
+    {
+        public const string GameObjectComponentModifyToolId = "gameobject-component-modify";
+        [UcoTool
+        (
+            GameObjectComponentModifyToolId,
+            Title = "GameObject / Component / Modify",
+            IdempotentHint = true
+        )]
+        [AuthoringCapability(
+            MutationKind = AuthoringMutationKind.Modify,
+            UndoLevel = AuthoringUndoLevel.Partial,
+            SupportsValidation = true,
+            SupportsPlanning = true,
+            ValidatorType = typeof(UnityPilotAuthoringValidator),
+            PlannerType = typeof(UnityPilotAuthoringPlanner),
+            TransactionFactoryType = typeof(UnityAuthoringTransactionFactory))]
+        [UcoSkillDescription("Modify a specific Component on a GameObject in opened Prefab or in a Scene. " +
+            "Allows direct modification of component fields and properties without wrapping in GameObject structure. " +
+            "Use '" + GameObjectComponentGetToolId + "' first to inspect the component structure before modifying. " +
+            "Three modification surfaces are available (componentDiff, pathPatches, jsonPatch) — see the skill body for details.")]
+        [UcoSkillBody(
+            "## Three modification surfaces\n\n" +
+            "Use whichever fits the task:\n\n" +
+            "1. `componentDiff` — full `SerializedMember` diff (legacy, backwards compatible).\n" +
+            "2. `pathPatches` — list of `{path, value}` pairs routed through `Reflector.TryModifyAt`; atomic per-path modification, multiple entries can target different depths.\n" +
+            "3. `jsonPatch` — a JSON Merge Patch (RFC 7396, extended with `[i]`/`[key]` notation) routed through `Reflector.TryPatch`; multiple fields at any depth in a single call.\n\n" +
+            "When more than one is supplied they run in this order: `jsonPatch` → `pathPatches` → `componentDiff`. At least one is required.\n\n" +
+            "## Path syntax\n\n" +
+            "`fieldName`, `nested/field`, `arrayField/[i]`, `dictField/[key]`. Leading `#/` is stripped.")]
+        [Description("Modify a specific Component on a GameObject in opened Prefab or in a Scene. " +
+            "Allows direct modification of component fields and properties without wrapping in GameObject structure. " +
+            "Use '" + GameObjectComponentGetToolId + "' first to inspect the component structure before modifying.\n\n" +
+            "Three modification surfaces (use whichever fits the task):\n" +
+            "  1. '" + "componentDiff" + "' — full SerializedMember diff (legacy, backwards compatible).\n" +
+            "  2. '" + "pathPatches" + "' — list of {path, value} pairs routed through Reflector.TryModifyAt; " +
+            "atomic per-path modification, multiple entries can target different depths.\n" +
+            "  3. '" + "jsonPatch" + "' — a JSON Merge Patch (RFC 7396, extended with [i]/[key] notation) " +
+            "routed through Reflector.TryPatch; multiple fields at any depth in a single call.\n" +
+            "When more than one is supplied they run in this order: jsonPatch → pathPatches → componentDiff. " +
+            "At least one is required.\n" +
+            "Path syntax: 'fieldName', 'nested/field', 'arrayField/[i]', 'dictField/[key]'. Leading '#/' is stripped.")]
+        public ModifyComponentResponse ModifyComponent
+        (
+            GameObjectRef gameObjectRef,
+            ComponentRef componentRef,
+            [Description("Optional. The full component data to apply (legacy path). Should contain '" + nameof(SerializedMember.fields) + "' and/or '" + nameof(SerializedMember.props) + "' with the values to modify.\n" +
+                "Only include the fields/properties you want to change.\n" +
+                "Any unknown or invalid fields and properties will be reported in the response.")]
+            SerializedMember? componentDiff = null,
+            [Description("Optional. List of path-scoped patches routed through Reflector.TryModifyAt. " +
+                "Each entry targets one field/element/entry by path. " +
+                "Path syntax: 'fieldName', 'nested/field', 'arrayField/[i]', 'dictField/[key]'.")]
+            List<PathPatch>? pathPatches = null,
+            [Description("Optional. JSON Merge Patch (RFC 7396, extended with [i]/[key] keys) routed through " +
+                "Reflector.TryPatch. Allows multiple fields at any depth to be updated in a single call. " +
+                "Use '$type' for compatible-subtype replacement.")]
+            string? jsonPatch = null
+        )
+        {
+            if (!gameObjectRef.IsValid(out var gameObjectValidationError))
+                throw new ArgumentException(gameObjectValidationError, nameof(gameObjectRef));
+
+            if (!componentRef.IsValid(out var componentValidationError))
+                throw new ArgumentException(componentValidationError, nameof(componentRef));
+
+            var hasDiff = componentDiff != null;
+            var hasPathPatches = pathPatches != null && pathPatches.Count > 0;
+            var hasJsonPatch = !string.IsNullOrWhiteSpace(jsonPatch);
+            if (!hasDiff && !hasPathPatches && !hasJsonPatch)
+                throw new ArgumentNullException(paramName: null,
+                    $"At least one of '{nameof(componentDiff)}', '{nameof(pathPatches)}', or '{nameof(jsonPatch)}' is required. " +
+                    $"Make sure the JSON input uses '{nameof(componentDiff)}' as the key (not 'fields' or 'props' directly), " +
+                    $"or supply '{nameof(pathPatches)}' / '{nameof(jsonPatch)}' for path-scoped modifications.");
+
+            return MainThread.Instance.Run(() =>
+            {
+                // g-005: fail closed before the first mutation unless the policy pipeline approved this call.
+                UnityAuthoringUndo.RequireAuthoringScope();
+                var go = gameObjectRef.FindGameObject(out var error);
+                if (error != null)
+                    throw new Exception(error);
+
+                if (go == null)
+                    throw new Exception("GameObject not found.");
+
+                var allComponents = go.GetComponents<UnityEngine.Component>();
+                UnityEngine.Component? targetComponent = null;
+                int targetIndex = -1;
+
+                for (int i = 0; i < allComponents.Length; i++)
+                {
+                    if (componentRef.Matches(allComponents[i], i))
+                    {
+                        targetComponent = allComponents[i];
+                        targetIndex = i;
+                        break;
+                    }
+                }
+
+                if (targetComponent == null)
+                    throw new Exception(Error.NotFoundComponent(componentRef.InstanceID, allComponents));
+
+                var response = new ModifyComponentResponse
+                {
+                    Reference = new ComponentRef(targetComponent),
+                    Index = targetIndex
+                };
+
+                var logs = new Logs();
+                // Reflected/nested members require a complete snapshot before
+                // any patch is attempted. The capability is advertised as
+                // partial because third-party nested references may still be
+                // outside Unity's serialized Undo graph.
+                UnityAuthoringUndo.RecordModified(targetComponent, completeSnapshot: true);
+                var objToModify = (object?)targetComponent;
+                var reflector = UnityCopilotPluginEditor.Instance.Reflector ?? throw new Exception("Reflector is not available.");
+                var logger = UnityLoggerFactory.LoggerFactory.CreateLogger<Tool_GameObject>();
+
+                var anySuccess = false;
+
+                // 1) JSON Patch first — applied as a single Reflector.TryPatch
+                if (hasJsonPatch)
+                {
+                    if (reflector.TryPatch(ref objToModify, jsonPatch!, logs: logs, logger: logger))
+                        anySuccess = true;
+                }
+
+                // 2) Path-scoped patches — one Reflector.TryModifyAt per entry
+                if (hasPathPatches)
+                {
+                    for (int i = 0; i < pathPatches!.Count; i++)
+                    {
+                        var patch = pathPatches[i];
+                        if (patch == null || string.IsNullOrEmpty(patch.Path))
+                        {
+                            logs.Error($"PathPatch[{i}] with empty path skipped.");
+                            continue;
+                        }
+                        if (reflector.TryModifyAt(ref objToModify, patch.Path, patch.Value, logs: logs, logger: logger))
+                            anySuccess = true;
+                    }
+                }
+
+                // 3) Legacy full SerializedMember diff
+                if (hasDiff)
+                {
+                    if (reflector.TryModify(ref objToModify, data: componentDiff!, logs: logs, logger: logger))
+                        anySuccess = true;
+                }
+
+                if (anySuccess)
+                {
+                    UnityAuthoringUndo.MarkMutated();
+                    UnityEditor.EditorUtility.SetDirty(go);
+                    UnityEditor.EditorUtility.SetDirty(targetComponent);
+                    response.Success = true;
+                }
+
+                UnityEditorInternal.InternalEditorUtility.RepaintAllViews();
+
+                response.Logs = logs
+                    .Select(log => log.ToString())
+                    .ToArray();
+
+                // Return updated component data
+                response.Component = new ComponentDataShallow(targetComponent);
+
+                return response;
+            });
+        }
+
+    }
+}

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/GameObject.Component.Modify.cs.meta

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

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

@@ -0,0 +1,123 @@
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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 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 com.AtelierAI.Unity.Copilot.Runtime.Utils;
+using UnityEditor;
+using UnityEngine;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_GameObject
+    {
+        public const string GameObjectCreateToolId = "gameobject-create";
+        [UcoTool
+        (
+            GameObjectCreateToolId,
+            Title = "GameObject / Create"
+        )]
+        [AuthoringCapability(
+            MutationKind = AuthoringMutationKind.Create,
+            UndoLevel = AuthoringUndoLevel.Full,
+            SupportsValidation = true,
+            SupportsPlanning = true,
+            ValidatorType = typeof(UnityPilotAuthoringValidator),
+            PlannerType = typeof(UnityPilotAuthoringPlanner),
+            TransactionFactoryType = typeof(UnityAuthoringTransactionFactory))]
+        [UcoSkillDescription("Create a new GameObject in the currently opened Prefab or active Scene, optionally " +
+            "parented under another GameObject and pre-positioned. Pass `primitiveType` to spawn a Unity primitive " +
+            "(Cube, Sphere, etc.) instead of an empty GameObject.")]
+        [UcoSkillBody("Create a new GameObject in opened Prefab or in a Scene. " +
+            "If needed - provide proper 'position', 'rotation' and 'scale' to reduce amount of operations.\n\n" +
+            "## Inputs\n\n" +
+            "- `name` — required non-empty name.\n" +
+            "- `parentGameObjectRef` (optional) — when provided, the new GameObject is parented under this one " +
+            "(`SetParent(parent, worldPositionStays: false)`); otherwise it's created at scene/prefab root.\n" +
+            "- `position` / `rotation` / `scale` — optional transform; default to zero / zero / one.\n" +
+            "- `isLocalSpace` — when `true`, applies the transform in local space relative to the parent.\n" +
+            "- `primitiveType` (optional) — when set, the GameObject is created via `GameObject.CreatePrimitive` " +
+            "(adds the appropriate renderer/collider for the primitive shape).")]
+        [Description("Create a new GameObject in opened Prefab or in a Scene. " +
+            "If needed - provide proper 'position', 'rotation' and 'scale' to reduce amount of operations.")]
+        public GameObjectRef Create
+        (
+            [Description("Name of the new GameObject.")]
+            string name,
+            [Description("Parent GameObject reference. If not provided, the GameObject will be created at the root of the scene or prefab.")]
+            GameObjectRef? parentGameObjectRef = null,
+            [Description("Transform position of the GameObject.")]
+            Vector3? position = null,
+            [Description("Transform rotation of the GameObject. Euler angles in degrees.")]
+            Vector3? rotation = null,
+            [Description("Transform scale of the GameObject.")]
+            Vector3? scale = null,
+            [Description("World or Local space of transform.")]
+            bool isLocalSpace = false,
+            PrimitiveType? primitiveType = null
+        )
+        {
+            if (string.IsNullOrEmpty(name))
+                throw new ArgumentException("Name cannot be null or empty.", nameof(name));
+
+            return MainThread.Instance.Run(() =>
+            {
+                // g-005: fail closed before the first mutation unless the policy pipeline approved this call.
+                UnityAuthoringUndo.RequireAuthoringScope();
+                var parentGo = default(GameObject);
+                if (parentGameObjectRef?.IsValid(out _) == true)
+                {
+                    parentGo = parentGameObjectRef.FindGameObject(out var error);
+                    if (error != null)
+                        throw new ArgumentException(error, nameof(parentGameObjectRef));
+                }
+
+                position ??= Vector3.zero;
+                rotation ??= Vector3.zero;
+                scale ??= Vector3.one;
+
+                var go = primitiveType != null
+                    ? GameObject.CreatePrimitive(primitiveType.Value)
+                    : new GameObject(name);
+
+                UnityAuthoringUndo.RecordCreated(go);
+                // Register the initial object snapshot before applying the
+                // caller's name/parent/transform mutations.  Both records
+                // belong to the one transaction group.
+                UnityAuthoringUndo.RecordModified(go, completeSnapshot: true);
+                go.name = name;
+
+                // Set parent if provided
+                if (parentGo != null)
+                    go.transform.SetParent(parentGo.transform, false);
+
+                // Set the transform properties
+                go.SetTransform(
+                    position: position,
+                    rotation: rotation,
+                    scale: scale,
+                    isLocalSpace: isLocalSpace);
+
+                UnityAuthoringUndo.MarkMutated();
+
+                EditorUtility.SetDirty(go);
+                EditorUtils.RepaintAllEditorWindows();
+
+                return new GameObjectRef(go);
+            });
+        }
+    }
+}

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

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