@atelierai/uco 1.0.7 → 1.0.9

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Console.GetLogs.cs

@@ -1,96 +1,96 @@
-/*
-┌──────────────────────────────────────────────────────────────────┐
-│  Author: Ivan Murzak (https://github.com/IvanMurzak/Unity-MCP)    │
-│  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 UnityEngine;
-
-namespace com.AtelierAI.Unity.Copilot.Editor.API
-{
-    public partial class Tool_Console
-    {
-        public const string ConsoleGetLogsToolId = "console-get-logs";
-        [UcoTool
-        (
-            ConsoleGetLogsToolId,
-            Title = "Console / Get Logs",
-            ReadOnlyHint = true,
-            IdempotentHint = true
-        )]
-        [UcoSkillDescription("Retrieve Unity Editor logs from the MCP plugin's `LogCollector`, " +
-            "optionally filtered by log type, time window, operation/correlation identity, or source " +
-            "(product / bridge / tool / unity). Useful for debugging and monitoring Editor activity.")]
-        [UcoSkillBody("Retrieves Unity Editor logs with attribution and loss accounting.\n\n" +
-            "## Inputs\n\n" +
-            "- `maxEntries` (default 100, minimum 1) — caps the size of the returned array.\n" +
-            "- `logTypeFilter` — Unity `LogType` filter; `null` returns all severities.\n" +
-            "- `includeStackTrace` (default `false`) — include stack-trace strings in each entry.\n" +
-            "- `lastMinutes` (default 0) — when non-zero, only logs from the last N minutes are returned.\n" +
-            "- `correlationId` — only entries emitted inside that tool call's execution window.\n" +
-            "- `operationId` — only entries attributed to that durable operation.\n" +
-            "- `source` — one of `product`, `bridge`, `tool`, `unity`.\n" +
-            "- `sinceUnixMs` — only entries at or after this Unix millisecond boundary.\n\n" +
-            "## Attribution and loss accounting\n\n" +
-            "Each entry carries `Source` and, when produced on the main thread inside an owned execution " +
-            "window, `CorrelationId`/`OperationId`. The response reports `DroppedEntries` (lost to " +
-            "capacity or storage failures) and `TruncatedEntries` (messages cut at the size limit) so an " +
-            "empty result is distinguishable from a clean run.\n\n" +
-            "## Example: new errors for one operation\n\n" +
-            "`{ \"operationId\": \"<from tests-run>\", \"logTypeFilter\": \"Error\", \"sinceUnixMs\": 1760000000000, \"maxEntries\": 50 }`")]
-        [Description("Retrieves Unity Editor logs with correlation/source attribution and loss accounting. " +
-            "Useful for debugging and monitoring Unity Editor activity.")]
-        public ConsoleLogsQueryResult GetLogs
-        (
-            [Description("Maximum number of log entries to return. Minimum: 1. Default: 100")]
-            int maxEntries = 100,
-            [Description("Filter by log type. 'null' means All.")]
-            LogType? logTypeFilter = null,
-            [Description("Include stack traces in the output. Default: false")]
-            bool includeStackTrace = false,
-            [Description("Return logs from the last N minutes. If 0, returns all available logs. Default: 0")]
-            int lastMinutes = 0,
-            [Description("Only entries emitted inside this tool call's execution window (correlation identity). Example: 'call-...'.")]
-            string? correlationId = null,
-            [Description("Only entries attributed to this durable operation id. Example: the operationId returned by tests-run.")]
-            string? operationId = null,
-            [Description("Source classification filter: 'product', 'bridge', 'tool', or 'unity'. 'null' returns all sources.")]
-            string? source = null,
-            [Description("Only entries at or after this Unix-epoch millisecond boundary. Record the boundary before an operation, then filter new entries here. Example: 1760000000000.")]
-            long? sinceUnixMs = null
-        )
-        {
-            // Validate parameters
-            if (maxEntries < 1)
-                throw new ArgumentException(Error.InvalidMaxEntries(maxEntries));
-
-            if (!UnityCopilotPluginEditor.HasInstance)
-                throw new InvalidOperationException("UnityCopilotPluginEditor is not initialized.");
-
-            var logCollector = UnityCopilotPluginEditor.Instance.LogCollector;
-            if (logCollector == null)
-                throw new InvalidOperationException("LogCollector is not initialized.");
-
-            var logs = logCollector.QueryDetailed(
-                maxEntries: maxEntries,
-                logTypeFilter: logTypeFilter,
-                includeStackTrace: includeStackTrace,
-                lastMinutes: lastMinutes,
-                correlationId: correlationId,
-                operationId: operationId,
-                source: source,
-                sinceUnixMs: sinceUnixMs
-            );
-
-            return logs;
-        }
-    }
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  Author: Ivan Murzak (https://github.com/IvanMurzak/Unity-MCP)    │
+│  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 UnityEngine;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Console
+    {
+        public const string ConsoleGetLogsToolId = "console-get-logs";
+        [UcoTool
+        (
+            ConsoleGetLogsToolId,
+            Title = "Console / Get Logs",
+            ReadOnlyHint = true,
+            IdempotentHint = true
+        )]
+        [UcoSkillDescription("Retrieve Unity Editor logs from the Uco plugin's `LogCollector`, " +
+            "optionally filtered by log type, time window, operation/correlation identity, or source " +
+            "(product / bridge / tool / unity). Useful for debugging and monitoring Editor activity.")]
+        [UcoSkillBody("Retrieves Unity Editor logs with attribution and loss accounting.\n\n" +
+            "## Inputs\n\n" +
+            "- `maxEntries` (default 100, minimum 1) — caps the size of the returned array.\n" +
+            "- `logTypeFilter` — Unity `LogType` filter; `null` returns all severities.\n" +
+            "- `includeStackTrace` (default `false`) — include stack-trace strings in each entry.\n" +
+            "- `lastMinutes` (default 0) — when non-zero, only logs from the last N minutes are returned.\n" +
+            "- `correlationId` — only entries emitted inside that tool call's execution window.\n" +
+            "- `operationId` — only entries attributed to that durable operation.\n" +
+            "- `source` — one of `product`, `bridge`, `tool`, `unity`.\n" +
+            "- `sinceUnixMs` — only entries at or after this Unix millisecond boundary.\n\n" +
+            "## Attribution and loss accounting\n\n" +
+            "Each entry carries `Source` and, when produced on the main thread inside an owned execution " +
+            "window, `CorrelationId`/`OperationId`. The response reports `DroppedEntries` (lost to " +
+            "capacity or storage failures) and `TruncatedEntries` (messages cut at the size limit) so an " +
+            "empty result is distinguishable from a clean run.\n\n" +
+            "## Example: new errors for one operation\n\n" +
+            "`{ \"operationId\": \"<from tests-run>\", \"logTypeFilter\": \"Error\", \"sinceUnixMs\": 1760000000000, \"maxEntries\": 50 }`")]
+        [Description("Retrieves Unity Editor logs with correlation/source attribution and loss accounting. " +
+            "Useful for debugging and monitoring Unity Editor activity.")]
+        public ConsoleLogsQueryResult GetLogs
+        (
+            [Description("Maximum number of log entries to return. Minimum: 1. Default: 100")]
+            int maxEntries = 100,
+            [Description("Filter by log type. 'null' means All.")]
+            LogType? logTypeFilter = null,
+            [Description("Include stack traces in the output. Default: false")]
+            bool includeStackTrace = false,
+            [Description("Return logs from the last N minutes. If 0, returns all available logs. Default: 0")]
+            int lastMinutes = 0,
+            [Description("Only entries emitted inside this tool call's execution window (correlation identity). Example: 'call-...'.")]
+            string? correlationId = null,
+            [Description("Only entries attributed to this durable operation id. Example: the operationId returned by tests-run.")]
+            string? operationId = null,
+            [Description("Source classification filter: 'product', 'bridge', 'tool', or 'unity'. 'null' returns all sources.")]
+            string? source = null,
+            [Description("Only entries at or after this Unix-epoch millisecond boundary. Record the boundary before an operation, then filter new entries here. Example: 1760000000000.")]
+            long? sinceUnixMs = null
+        )
+        {
+            // Validate parameters
+            if (maxEntries < 1)
+                throw new ArgumentException(Error.InvalidMaxEntries(maxEntries));
+
+            if (!UnityCopilotPluginEditor.HasInstance)
+                throw new InvalidOperationException("UnityCopilotPluginEditor is not initialized.");
+
+            var logCollector = UnityCopilotPluginEditor.Instance.LogCollector;
+            if (logCollector == null)
+                throw new InvalidOperationException("LogCollector is not initialized.");
+
+            var logs = logCollector.QueryDetailed(
+                maxEntries: maxEntries,
+                logTypeFilter: logTypeFilter,
+                includeStackTrace: includeStackTrace,
+                lastMinutes: lastMinutes,
+                correlationId: correlationId,
+                operationId: operationId,
+                source: source,
+                sinceUnixMs: sinceUnixMs
+            );
+
+            return logs;
+        }
+    }
 }

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/API/Tool/Docs.HttpFetcher.cs

@@ -1,139 +1,139 @@
-/*
- * Portions of this file are derived from MCP for Unity (CoplayDev/unity-mcp),
- * Copyright (c) Coplay Inc., licensed under the MIT License.
- * Original: https://github.com/CoplayDev/unity-mcp/blob/main/Server/src/services/tools/unity_docs.py
- */
-
-/*
-┌──────────────────────────────────────────────────────────────────┐
-│  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.Concurrent;
-using System.Net;
-using System.Net.Http;
-using System.Threading;
-using System.Threading.Tasks;
-
-namespace com.AtelierAI.Unity.Copilot.Editor.API
-{
-    public partial class Tool_Docs
-    {
-        /// <summary>
-        /// Small async HTTP wrapper used by the docs-* tools. Holds a single shared
-        /// <see cref="HttpClient"/>, applies a fixed timeout, follows redirects and
-        /// caches successful responses in-memory for a short TTL so parallel lookups
-        /// of the same URL only hit the network once.
-        /// </summary>
-        internal static class HttpFetcher
-        {
-            // Single shared HttpClient — recommended pattern. .NET pools sockets internally.
-            private static readonly HttpClient s_client = CreateClient();
-            private const string UserAgent = "Unity-MCP-Docs/1.0";
-            private static readonly TimeSpan s_timeout = TimeSpan.FromSeconds(10);
-            private static readonly TimeSpan s_cacheTtl = TimeSpan.FromSeconds(30);
-
-            private static readonly ConcurrentDictionary<string, CacheEntry> s_cache = new();
-
-            private static HttpClient CreateClient()
-            {
-                var handler = new HttpClientHandler
-                {
-                    AllowAutoRedirect = true,
-                    AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate,
-                };
-                var client = new HttpClient(handler)
-                {
-                    Timeout = TimeSpan.FromSeconds(15) // hard cap; per-call CTS enforces s_timeout earlier.
-                };
-                client.DefaultRequestHeaders.UserAgent.ParseAdd(UserAgent);
-                client.DefaultRequestHeaders.Accept.ParseAdd("text/html,application/xhtml+xml");
-                return client;
-            }
-
-            /// <summary>
-            /// Fetch a URL and return (statusCode, body, finalUrl). On network failure
-            /// returns (-1, "", url) and sets <paramref name="errorMessage"/>.
-            /// </summary>
-            public static async Task<FetchResult> FetchAsync(string url)
-            {
-                if (s_cache.TryGetValue(url, out var cached) && cached.ExpiresAt > DateTime.UtcNow)
-                    return new FetchResult(cached.Status, cached.Body, cached.FinalUrl, null);
-
-                using var cts = new CancellationTokenSource(s_timeout);
-                try
-                {
-                    using var resp = await s_client.GetAsync(url, HttpCompletionOption.ResponseContentRead, cts.Token).ConfigureAwait(false);
-                    var status = (int)resp.StatusCode;
-                    var body = status == 404
-                        ? string.Empty
-                        : await resp.Content.ReadAsStringAsync().ConfigureAwait(false);
-                    var final = resp.RequestMessage?.RequestUri?.ToString() ?? url;
-
-                    // Cache successful + 404 responses (not 5xx — those can be transient)
-                    if (status == 200 || status == 404)
-                    {
-                        s_cache[url] = new CacheEntry(status, body, final, DateTime.UtcNow + s_cacheTtl);
-                    }
-
-                    return new FetchResult(status, body, final, null);
-                }
-                catch (TaskCanceledException)
-                {
-                    return new FetchResult(-1, string.Empty, url, $"Timed out after {s_timeout.TotalSeconds:F0}s fetching {url}.");
-                }
-                catch (HttpRequestException ex)
-                {
-                    return new FetchResult(-1, string.Empty, url, $"HTTP error fetching {url}: {ex.Message}");
-                }
-                catch (Exception ex)
-                {
-                    return new FetchResult(-1, string.Empty, url, $"Unexpected error fetching {url}: {ex.Message}");
-                }
-            }
-
-            internal readonly struct FetchResult
-            {
-                public readonly int Status;
-                public readonly string Body;
-                public readonly string FinalUrl;
-                public readonly string? ErrorMessage;
-
-                public FetchResult(int status, string body, string finalUrl, string? errorMessage)
-                {
-                    Status = status;
-                    Body = body;
-                    FinalUrl = finalUrl;
-                    ErrorMessage = errorMessage;
-                }
-
-                public bool IsOk => Status == 200;
-                public bool IsNotFound => Status == 404;
-                public bool IsNetworkError => Status == -1;
-            }
-
-            private readonly struct CacheEntry
-            {
-                public readonly int Status;
-                public readonly string Body;
-                public readonly string FinalUrl;
-                public readonly DateTime ExpiresAt;
-
-                public CacheEntry(int status, string body, string finalUrl, DateTime expiresAt)
-                {
-                    Status = status;
-                    Body = body;
-                    FinalUrl = finalUrl;
-                    ExpiresAt = expiresAt;
-                }
-            }
-        }
-    }
-}
+/*
+ * Portions of this file are derived from MCP for Unity (CoplayDev/unity-mcp),
+ * Copyright (c) Coplay Inc., licensed under the MIT License.
+ * Original: https://github.com/CoplayDev/unity-mcp/blob/main/Server/src/services/tools/unity_docs.py
+ */
+
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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.Concurrent;
+using System.Net;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Docs
+    {
+        /// <summary>
+        /// Small async HTTP wrapper used by the docs-* tools. Holds a single shared
+        /// <see cref="HttpClient"/>, applies a fixed timeout, follows redirects and
+        /// caches successful responses in-memory for a short TTL so parallel lookups
+        /// of the same URL only hit the network once.
+        /// </summary>
+        internal static class HttpFetcher
+        {
+            // Single shared HttpClient — recommended pattern. .NET pools sockets internally.
+            private static readonly HttpClient s_client = CreateClient();
+            private const string UserAgent = "Unity-Uco-Docs/1.0";
+            private static readonly TimeSpan s_timeout = TimeSpan.FromSeconds(10);
+            private static readonly TimeSpan s_cacheTtl = TimeSpan.FromSeconds(30);
+
+            private static readonly ConcurrentDictionary<string, CacheEntry> s_cache = new();
+
+            private static HttpClient CreateClient()
+            {
+                var handler = new HttpClientHandler
+                {
+                    AllowAutoRedirect = true,
+                    AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate,
+                };
+                var client = new HttpClient(handler)
+                {
+                    Timeout = TimeSpan.FromSeconds(15) // hard cap; per-call CTS enforces s_timeout earlier.
+                };
+                client.DefaultRequestHeaders.UserAgent.ParseAdd(UserAgent);
+                client.DefaultRequestHeaders.Accept.ParseAdd("text/html,application/xhtml+xml");
+                return client;
+            }
+
+            /// <summary>
+            /// Fetch a URL and return (statusCode, body, finalUrl). On network failure
+            /// returns (-1, "", url) and sets <paramref name="errorMessage"/>.
+            /// </summary>
+            public static async Task<FetchResult> FetchAsync(string url)
+            {
+                if (s_cache.TryGetValue(url, out var cached) && cached.ExpiresAt > DateTime.UtcNow)
+                    return new FetchResult(cached.Status, cached.Body, cached.FinalUrl, null);
+
+                using var cts = new CancellationTokenSource(s_timeout);
+                try
+                {
+                    using var resp = await s_client.GetAsync(url, HttpCompletionOption.ResponseContentRead, cts.Token).ConfigureAwait(false);
+                    var status = (int)resp.StatusCode;
+                    var body = status == 404
+                        ? string.Empty
+                        : await resp.Content.ReadAsStringAsync().ConfigureAwait(false);
+                    var final = resp.RequestMessage?.RequestUri?.ToString() ?? url;
+
+                    // Cache successful + 404 responses (not 5xx — those can be transient)
+                    if (status == 200 || status == 404)
+                    {
+                        s_cache[url] = new CacheEntry(status, body, final, DateTime.UtcNow + s_cacheTtl);
+                    }
+
+                    return new FetchResult(status, body, final, null);
+                }
+                catch (TaskCanceledException)
+                {
+                    return new FetchResult(-1, string.Empty, url, $"Timed out after {s_timeout.TotalSeconds:F0}s fetching {url}.");
+                }
+                catch (HttpRequestException ex)
+                {
+                    return new FetchResult(-1, string.Empty, url, $"HTTP error fetching {url}: {ex.Message}");
+                }
+                catch (Exception ex)
+                {
+                    return new FetchResult(-1, string.Empty, url, $"Unexpected error fetching {url}: {ex.Message}");
+                }
+            }
+
+            internal readonly struct FetchResult
+            {
+                public readonly int Status;
+                public readonly string Body;
+                public readonly string FinalUrl;
+                public readonly string? ErrorMessage;
+
+                public FetchResult(int status, string body, string finalUrl, string? errorMessage)
+                {
+                    Status = status;
+                    Body = body;
+                    FinalUrl = finalUrl;
+                    ErrorMessage = errorMessage;
+                }
+
+                public bool IsOk => Status == 200;
+                public bool IsNotFound => Status == 404;
+                public bool IsNetworkError => Status == -1;
+            }
+
+            private readonly struct CacheEntry
+            {
+                public readonly int Status;
+                public readonly string Body;
+                public readonly string FinalUrl;
+                public readonly DateTime ExpiresAt;
+
+                public CacheEntry(int status, string body, string finalUrl, DateTime expiresAt)
+                {
+                    Status = status;
+                    Body = body;
+                    FinalUrl = finalUrl;
+                    ExpiresAt = expiresAt;
+                }
+            }
+        }
+    }
+}

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

@@ -1,72 +1,72 @@
-/*
- * Design inspired by MCP for Unity (CoplayDev/unity-mcp), Copyright (c) Coplay Inc., MIT License.
- */
-
-/*
-┌──────────────────────────────────────────────────────────────────┐
-│  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.ComponentModel;
-using System.Linq;
-using com.AtelierAI.Uco.Framework;
-using com.IvanMurzak.ReflectorNet.Utils;
-using com.AtelierAI.Unity.Copilot.Editor.Utils;
-
-namespace com.AtelierAI.Unity.Copilot.Editor.API
-{
-    public partial class Tool_Instance
-    {
-        public const string InstanceListAllToolId = "instance-list-all";
-
-        [UcoTool
-        (
-            InstanceListAllToolId,
-            Title = "Instance / List All",
-            ReadOnlyHint = true,
-            Enabled = false
-        )]
-        [UcoSkillDescription("List all Unity Editor instances registered on this machine plus identify the " +
-            "calling Editor. Each entry carries port, project path, Unity version, PID, instance id and a liveness " +
-            "flag (verified by checking that the PID is still running).")]
-        [UcoSkillBody("Soft discovery of every Unity Editor that has registered itself with this machine's " +
-            "MCP plugin. Each entry includes port, project path, Unity version, PID, stable instance id and an " +
-            "`IsAlive` flag.\n\n" +
-            "## Inputs\n\n" +
-            "- `includeStale` (default `false`) — include rows whose registry file has not been refreshed in over " +
-            "5 minutes. Useful for diagnosing crashed Editors that did not get a chance to clean up their entry.\n\n" +
-            "## Behavior\n\n" +
-            "Reads every `*.json` file under `%TEMP%/unity-mcp-instances/`. The calling Editor's row is marked " +
-            "with `IsSelf=true`. `IsAlive` is determined by `Process.GetProcessById(pid)`.\n\n" +
-            "## Limitation\n\n" +
-            "This is discovery only — you can see which sibling Editors exist, but you cannot route tool calls to " +
-            "them. Cross-instance routing requires server-side changes in the external NuGet " +
-            "`com.AtelierAI.Uco.Framework` package and is not yet implemented.")]
-        [Description("List all Unity Editor instances registered on this machine plus identify the calling Editor.")]
-        public UnityInstanceListResult ListAll
-        (
-            [Description("Include stale entries (Editor exited without cleanup). Default false.")]
-            bool includeStale = false
-        )
-        {
-            return MainThread.Instance.Run(() =>
-            {
-                var entries = UnityInstanceRegistry.List(includeStale: includeStale).ToArray();
-                var self = entries.FirstOrDefault(e => e.IsSelf);
-                var currentId = self?.InstanceId
-                                ?? UnityInstanceRegistry.BuildSelfEntry().InstanceId;
-                return new UnityInstanceListResult
-                {
-                    Instances = entries,
-                    CurrentInstanceId = currentId,
-                };
-            });
-        }
-    }
-}
+/*
+ * Design inspired by MCP for Unity (CoplayDev/unity-mcp), Copyright (c) Coplay Inc., MIT License.
+ */
+
+/*
+┌──────────────────────────────────────────────────────────────────┐
+│  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.ComponentModel;
+using System.Linq;
+using com.AtelierAI.Uco.Framework;
+using com.IvanMurzak.ReflectorNet.Utils;
+using com.AtelierAI.Unity.Copilot.Editor.Utils;
+
+namespace com.AtelierAI.Unity.Copilot.Editor.API
+{
+    public partial class Tool_Instance
+    {
+        public const string InstanceListAllToolId = "instance-list-all";
+
+        [UcoTool
+        (
+            InstanceListAllToolId,
+            Title = "Instance / List All",
+            ReadOnlyHint = true,
+            Enabled = false
+        )]
+        [UcoSkillDescription("List all Unity Editor instances registered on this machine plus identify the " +
+            "calling Editor. Each entry carries port, project path, Unity version, PID, instance id and a liveness " +
+            "flag (verified by checking that the PID is still running).")]
+        [UcoSkillBody("Soft discovery of every Unity Editor that has registered itself with this machine's " +
+            "Uco plugin. Each entry includes port, project path, Unity version, PID, stable instance id and an " +
+            "`IsAlive` flag.\n\n" +
+            "## Inputs\n\n" +
+            "- `includeStale` (default `false`) — include rows whose registry file has not been refreshed in over " +
+            "5 minutes. Useful for diagnosing crashed Editors that did not get a chance to clean up their entry.\n\n" +
+            "## Behavior\n\n" +
+            "Reads every `*.json` file under `%TEMP%/unity-mcp-instances/`. The calling Editor's row is marked " +
+            "with `IsSelf=true`. `IsAlive` is determined by `Process.GetProcessById(pid)`.\n\n" +
+            "## Limitation\n\n" +
+            "This is discovery only — you can see which sibling Editors exist, but you cannot route tool calls to " +
+            "them. Cross-instance routing requires server-side changes in the external NuGet " +
+            "`com.AtelierAI.Uco.Framework` package and is not yet implemented.")]
+        [Description("List all Unity Editor instances registered on this machine plus identify the calling Editor.")]
+        public UnityInstanceListResult ListAll
+        (
+            [Description("Include stale entries (Editor exited without cleanup). Default false.")]
+            bool includeStale = false
+        )
+        {
+            return MainThread.Instance.Run(() =>
+            {
+                var entries = UnityInstanceRegistry.List(includeStale: includeStale).ToArray();
+                var self = entries.FirstOrDefault(e => e.IsSelf);
+                var currentId = self?.InstanceId
+                                ?? UnityInstanceRegistry.BuildSelfEntry().InstanceId;
+                return new UnityInstanceListResult
+                {
+                    Instances = entries,
+                    CurrentInstanceId = currentId,
+                };
+            });
+        }
+    }
+}