@atelierai/uco 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atelierai/uco",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "uco — Unity Copilot CLI. Drive Unity Editor (and runtime game builds) from any AI agent via plain HTTP. No MCP protocol on the wire.",
   "type": "module",
   "bin": {

package/skills/uco-setup/references/recovery.md

@@ -2,12 +2,36 @@
 
 Read this only after the bootstrap happy path fails.
 
+## Bridge not running (`uco ping` fails / connection refused)
+
+The bridge is a plain Node process (`bin/server.mjs` from the `@atelierai/uco`
+npm package) listening on a per-project deterministic port. Bring it up in any
+of these ways:
+
+- `uco open <project> --start-server true` — the CLI starts a uco-owned bridge
+  before Unity launches.
+- Open the Unity Editor: the plugin auto-starts the bridge in Custom mode when
+  `keepServerRunning` is true (the default) — discovery looks for the
+  `@atelierai/uco` package (project `node_modules` first, then the npm global).
+- Start it manually with the exact same arguments the plugin would use:
+
+  ```bash
+  node <npm-global>/node_modules/@atelierai/uco/bin/server.mjs \
+    --port <port> --authorization required --token <token from UserSettings/uco-config.json>
+  ```
+
+  The plugin detects an already-running server on its port and connects to it.
+
+If the plugin still refuses to start it: `nodeServerPath` in
+`UserSettings/uco-config.json` may point at a dead path (it must exist or be
+cleared), or the npm package is missing (`npm i -g @atelierai/uco`).
+
 ## Diagnose by layer
 
 1. Verify `Packages/manifest.json` contains `com.atelierai.unity.copilot` and inspect its source/version without rewriting unrelated dependencies.
 2. Check the OpenUPM scopes required by the package and preserve an active local package source.
-3. Check that `Assets/Plugins/NuGet` is present when using full `uco install`. (No server directory is staged — the Unity plugin launches its Node server itself.)
-4. Check `UserSettings/AI-Game-Developer-Config.json` exists, but never print its token.
+3. Check `Assets/Plugins/NuGet` is present when using full `uco install`. (No server directory is staged — the Unity plugin launches its Node server itself.)
+4. Check `UserSettings/uco-config.json` exists, but never print its token.
 5. Confirm the expected Unity Editor process owns this exact project before diagnosing REST readiness.
 6. Use `uco status`, then `open` plus `wait-for-ready`; only then run `ping` and `instance-get-current`.
 

package/vendor/plugin/com.atelierai.unity.copilot/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [1.0.3] - 2026-09-17 — Cloud mode removed; bridge finds the published npm package
+
+- **Cloud connection mode deleted.** The upstream remnant connected to a dead
+  third-party endpoint (ai-game.dev), silently prevented the local bridge from
+  auto-starting (its gate only allowed Custom), and confused every session that
+  hit a config without an explicit mode. ConnectionMode now has a single value
+  (Custom), the default is Custom, the device-code auth flow and its UI are
+  gone, and old configs carrying "Cloud" are mapped to Custom on load.
+- **Node bridge discovery follows the published package.** npm rejected the
+  bare name "uco" (typosquatting policy), so the package publishes as
+  @atelierai/uco — but discovery still looked for node_modules/uco, which
+  stopped existing the moment the pre-scope global install was removed.
+  Discovery now probes @atelierai/uco, then the legacy uco and cocli layouts,
+  project-local and npm-global.
+- Token env overrides route straight to the local token (no mode routing);
+  UNITY_MCP_CLOUD_URL is gone, --url/UNITY_MCP_HOST keep working.
+
 ## [1.0.2] - 2026-09-15 — one menu tree, one name: Unity Copilot
 
 - The product is named **Unity Copilot** (no hyphen). All menus, window

package/vendor/plugin/com.atelierai.unity.copilot/Editor/Scripts/CopilotServerManager.cs

@@ -85,12 +85,15 @@ namespace com.AtelierAI.Unity.Copilot.Editor
         #region Node Server Discovery
 
         /// <summary>
-        /// Name of the npm package that ships the Node.js server.
+        /// npm package directories that ship the Node.js server, newest first: the
+        /// published scoped package (@atelierai/uco — the registry rejected the bare
+        /// short name), the pre-scope local layout, and the deprecated cocli install
+        /// from the private era.
         /// </summary>
-        public const string NodeServerPackageName = "uco";
+        public static readonly string[] NodeServerPackageNames = { "@atelierai/uco", "uco", "cocli" };
 
         /// <summary>
-        /// Path of the server entry script inside the <see cref="NodeServerPackageName"/> package.
+        /// Path of the server entry script inside a <see cref="NodeServerPackageNames"/> package.
         /// </summary>
         public const string NodeServerEntryRelativePath = "bin/server.mjs";
 
@@ -124,28 +127,33 @@ namespace com.AtelierAI.Unity.Copilot.Editor
                 return null;
             }
 
-            // 2) Installed in the Unity project (uco first, legacy cocli as fallback)
-            // 2) uco installed in the Unity project
-            var projectLocal = Path.GetFullPath(Path.Combine(
-                UnityCopilotPluginEditor.ProjectRootPath,
-                "node_modules",
-                NodeServerPackageName,
-                NodeServerEntryRelativePath));
-            if (File.Exists(projectLocal))
-                return projectLocal;
-
-            // 3) uco installed globally via npm
+            // 2) Installed in the Unity project (@atelierai/uco first, legacy names after)
+            foreach (var packageName in NodeServerPackageNames)
+            {
+                var projectLocal = Path.GetFullPath(Path.Combine(
+                    UnityCopilotPluginEditor.ProjectRootPath,
+                    "node_modules",
+                    packageName,
+                    NodeServerEntryRelativePath));
+                if (File.Exists(projectLocal))
+                    return projectLocal;
+            }
+
+            // 3) Installed globally via npm (@atelierai/uco first, legacy names after)
             foreach (var globalRoot in GetNpmGlobalRoots())
             {
-                try
-                {
-                    var globalPath = Path.Combine(globalRoot, NodeServerPackageName, NodeServerEntryRelativePath);
-                    if (File.Exists(globalPath))
-                        return Path.GetFullPath(globalPath);
-                }
-                catch
+                foreach (var packageName in NodeServerPackageNames)
                 {
-                    // Inaccessible candidate — skip it.
+                    try
+                    {
+                        var globalPath = Path.Combine(globalRoot, packageName, NodeServerEntryRelativePath);
+                        if (File.Exists(globalPath))
+                            return Path.GetFullPath(globalPath);
+                    }
+                    catch
+                    {
+                        // Inaccessible candidate — skip it.
+                    }
                 }
             }
 
@@ -249,7 +257,7 @@ namespace com.AtelierAI.Unity.Copilot.Editor
             // documented project-local install location so the generated config is
             // still a valid, copy-pasteable starting point.
             var serverEntry = ResolveNodeServerEntry()
-                ?? Path.Combine("node_modules", NodeServerPackageName, NodeServerEntryRelativePath);
+                ?? Path.Combine("node_modules", NodeServerPackageNames[0], NodeServerEntryRelativePath);
 
             serverConfig["command"] = ResolveNodeExecutable().Replace('\\', '/');
 
@@ -951,17 +959,6 @@ namespace com.AtelierAI.Unity.Copilot.Editor
             }
         }
 
-        /// <summary>
-        /// Returns true when the local server may be auto-started for the given connection mode.
-        /// Only Custom mode targets the local server, so auto-start is allowed there (subject to
-        /// other gates such as <see cref="UnityCopilotPluginEditor.KeepServerRunning"/>). Every other
-        /// mode (Cloud today, plus any future addition) connects to a remote endpoint and must
-        /// never auto-start the local server on Editor launch or after a binary update.
-        /// Pure (no Unity API access) so it can be unit-tested in EditMode.
-        /// </summary>
-        public static bool IsAutoStartAllowedForMode(ConnectionMode mode)
-            => mode == ConnectionMode.Custom;
-
         /// <summary>
         /// Starts the server if KeepServerRunning is enabled and no external server is detected.
         /// This method is called during Unity Editor startup to auto-start the server based on user preference.
@@ -971,13 +968,6 @@ namespace com.AtelierAI.Unity.Copilot.Editor
         {
             EditorApplication.update -= StartServerIfNeeded;
 
-            // Skip local server auto-start in Cloud mode — Unity connects to the cloud server instead
-            if (!IsAutoStartAllowedForMode(UnityCopilotPluginEditor.ConnectionMode))
-            {
-                _logger.LogDebug("StartServerIfNeeded: Cloud mode active, skipping local server auto-start");
-                return;
-            }
-
             // Check if user wants the server to keep running
             if (!UnityCopilotPluginEditor.KeepServerRunning)
             {