@atelierai/uco 1.0.0

package/dist/devops/utils/launch-error-dismiss.js

@@ -0,0 +1,440 @@
+import { execFile, execFileSync } from 'child_process';
+import { platform as nodePlatform } from 'os';
+import { verbose } from './ui.js';
+/**
+ * Window-title fragments matched against the Unity launch-errors
+ * dialog. Both legacy and current strings are listed so the matcher
+ * stays resilient across Unity versions. The match is case-insensitive
+ * and substring-based — Unity's actual title varies by version but
+ * always contains one of these.
+ *
+ * Exposed so tests can assert the matcher knows about both spellings
+ * without grepping the implementation.
+ */
+export const LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS = [
+    'Safe Mode', // Unity 2020.2+ ("Enter Safe Mode?") — the launch-errors dialog on every modern Unity (2022 LTS, 6000.x)
+    'Compiler Errors', // Unity 2020+ ("Hold On" + "Compiler Errors on Launch")
+    'Hold On', // Generic Unity progress dialog wrapping the launch-errors variant
+    'Compile Errors', // Older Unity dialog spelling
+    'Scripts have compiler errors', // Unity 2022+ on Linux (window manager surfacing)
+];
+/** The button label this helper presses to dismiss the dialog. */
+export const DISMISS_BUTTON_LABEL = 'Ignore';
+/**
+ * Producer-side prefixes for error messages that callers treat as
+ * permanent (the polling loop bails out instead of ticking again).
+ *
+ * Exported so the bailout matcher in `lib/open.ts` and the
+ * error-construction sites below reference the SAME literal — a
+ * future re-word lands in both places at once.
+ *
+ * The matcher in `lib/open.ts` uses `String.includes`, so each
+ * constant just needs to be a stable substring of the full message.
+ */
+export const LINUX_XDOTOOL_MISSING_PREFIX = 'xdotool not found on PATH';
+export const UNSUPPORTED_PLATFORM_PREFIX = 'Unsupported platform for launch-errors auto-dismiss';
+/**
+ * Try once to find and dismiss the Unity launch-errors dialog on the
+ * current OS desktop. Pure-ish — performs a single OS call and
+ * returns; never blocks past the underlying syscall's own timeout.
+ *
+ * Library-safe: never throws (errors are returned in the
+ * `DismissOutcome` union), never writes to stdout/stderr, never
+ * mutates global state.
+ *
+ * The helper is platform-dispatched:
+ * - **Windows**: Win32 (`FindWindowW` / `EnumWindows` /
+ *   `EnumChildWindows` / `GetWindowTextW` / `SendMessageW(BM_CLICK)`)
+ *   driven from PowerShell so we do not pull in a native node-gyp
+ *   dependency. UI Automation is the documented fallback if title
+ *   matching breaks on a future Unity release.
+ * - **macOS**: AppleScript via `osascript` (the leaner
+ *   AX-C-API-direct path is a documented follow-up). Requires the
+ *   user to have granted Accessibility permission to the terminal /
+ *   `unity-mcp-cli` binary once.
+ * - **Linux/X11**: `xdotool` (documented as a Linux platform
+ *   dependency; `wmctrl` is acceptable as an alternative window
+ *   enumerator). Wayland is deferred — call out explicitly in the
+ *   error message so the user does not waste time debugging.
+ */
+export async function tryDismissLaunchErrorsDialog(platform = nodePlatform()) {
+    switch (platform) {
+        case 'win32':
+            return tryDismissWindows();
+        case 'darwin':
+            return tryDismissMacOS();
+        case 'linux':
+            return tryDismissLinuxX11();
+        default:
+            return {
+                kind: 'error',
+                message: `${UNSUPPORTED_PLATFORM_PREFIX}: ${platform}`,
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Windows — Win32 via PowerShell
+// ---------------------------------------------------------------------------
+/**
+ * The PowerShell payload that probes for the Unity launch-errors
+ * dialog and clicks `Ignore` if found. Exported as a string (not a
+ * function) so tests can assert the script shape without launching
+ * PowerShell.
+ *
+ * Strategy:
+ *   1. P/Invoke `EnumWindows` via Add-Type to enumerate every visible
+ *      top-level window owned by `Unity.exe`.
+ *   2. Filter by title fragment (case-insensitive substring).
+ *   3. Walk child windows with `EnumChildWindows`, looking for a
+ *      Button whose text equals `Ignore`.
+ *   4. Send `BM_CLICK` (0x00F5) to the matched button. `BM_CLICK` is
+ *      preferred over a synthesised mouse event — it works even if
+ *      the user is mid-click in another app, and it does not steal
+ *      focus.
+ *
+ * The script writes a single-token result to stdout:
+ *   - `dismissed:<button>` on success
+ *   - `not-found` when no dialog was matched
+ *   - `error:<message>` on an unexpected exception
+ */
+export const WINDOWS_DISMISS_PS_SCRIPT = `
+$ErrorActionPreference = 'Stop'
+try {
+  if (-not ([System.Management.Automation.PSTypeName]'UnityMcp.LaunchErrors.Dismisser').Type) {
+    Add-Type -TypeDefinition @"
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Text;
+namespace UnityMcp.LaunchErrors {
+  public static class Dismisser {
+    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
+    [DllImport("user32.dll")] static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetWindowTextW(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetClassNameW(IntPtr hWnd, StringBuilder lpClassName, int nMaxCount);
+    [DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr hWnd);
+    [DllImport("user32.dll")] static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);
+    [DllImport("user32.dll")] static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern IntPtr SendMessageW(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
+    const uint BM_CLICK = 0x00F5;
+    static readonly string[] TitleFragments = new[] { ${LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS.map((f) => JSON.stringify(f)).join(', ')} };
+    static readonly string[] ButtonLabels = new[] { "${DISMISS_BUTTON_LABEL}", "&${DISMISS_BUTTON_LABEL}" };
+    public static string TryDismiss(int[] unityPids) {
+      var unityPidSet = new HashSet<uint>();
+      for (int i = 0; i < unityPids.Length; i++) unityPidSet.Add((uint)unityPids[i]);
+      IntPtr matchedDialog = IntPtr.Zero;
+      var sb = new StringBuilder(512);
+      EnumWindows((hWnd, lParam) => {
+        if (!IsWindowVisible(hWnd)) return true;
+        uint procId; GetWindowThreadProcessId(hWnd, out procId);
+        if (!unityPidSet.Contains(procId)) return true;
+        sb.Length = 0;
+        GetWindowTextW(hWnd, sb, sb.Capacity);
+        var text = sb.ToString();
+        foreach (var frag in TitleFragments) {
+          if (text.IndexOf(frag, StringComparison.OrdinalIgnoreCase) >= 0) {
+            matchedDialog = hWnd;
+            return false;
+          }
+        }
+        return true;
+      }, IntPtr.Zero);
+      if (matchedDialog == IntPtr.Zero) return "not-found";
+      IntPtr matchedButton = IntPtr.Zero;
+      EnumChildWindows(matchedDialog, (hWnd, lParam) => {
+        sb.Length = 0;
+        GetClassNameW(hWnd, sb, sb.Capacity);
+        if (sb.ToString() != "Button") return true;
+        sb.Length = 0;
+        GetWindowTextW(hWnd, sb, sb.Capacity);
+        var text = sb.ToString();
+        foreach (var label in ButtonLabels) {
+          if (string.Equals(text, label, StringComparison.OrdinalIgnoreCase)) {
+            matchedButton = hWnd;
+            return false;
+          }
+        }
+        return true;
+      }, IntPtr.Zero);
+      if (matchedButton == IntPtr.Zero) return "not-found";
+      SendMessageW(matchedButton, BM_CLICK, IntPtr.Zero, IntPtr.Zero);
+      return "dismissed:${DISMISS_BUTTON_LABEL}";
+    }
+  }
+}
+"@
+  }
+  $unityPids = @(Get-Process -Name 'Unity' -ErrorAction SilentlyContinue | ForEach-Object { [int]$_.Id })
+  if ($unityPids.Count -eq 0) { Write-Output 'not-found'; return }
+  Write-Output ([UnityMcp.LaunchErrors.Dismisser]::TryDismiss([int[]]$unityPids))
+} catch {
+  Write-Output ('error:' + $_.Exception.Message)
+}
+`;
+async function tryDismissWindows() {
+    return new Promise((resolve) => {
+        execFile('powershell', ['-NoProfile', '-NonInteractive', '-Command', WINDOWS_DISMISS_PS_SCRIPT], { timeout: 5000, windowsHide: true }, (err, stdout) => {
+            if (err) {
+                // ETIMEDOUT, ENOENT (powershell missing), etc. Treat as transient.
+                verbose(`tryDismissWindows: powershell invocation failed (${err.message}) — treating as not-found`);
+                resolve({ kind: 'error', message: err.message });
+                return;
+            }
+            resolve(parseDismissOutput(stdout));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// macOS — AppleScript via osascript
+// ---------------------------------------------------------------------------
+/**
+ * The AppleScript snippet used for the macOS dismiss path. Exposed as
+ * a string for testability.
+ *
+ * Strategy: iterate every window of the Unity application process and
+ * click the first button titled `Ignore`. If the Unity process is not
+ * running OR no matching button exists, the script reports
+ * `not-found`. Any AppleScript exception (e.g. Accessibility
+ * permission not granted) is reported as `error:<message>` so the
+ * caller can surface it once and continue polling.
+ *
+ * Requires the Terminal / `unity-mcp-cli` binary to have been granted
+ * Accessibility permission in System Settings → Privacy & Security →
+ * Accessibility. Documented in the README.
+ */
+export const MACOS_DISMISS_APPLESCRIPT = `
+on run
+  try
+    tell application "System Events"
+      if not (exists process "Unity") then
+        return "not-found"
+      end if
+      tell process "Unity"
+        repeat with w in windows
+          try
+            if exists (button "${DISMISS_BUTTON_LABEL}" of w) then
+              click button "${DISMISS_BUTTON_LABEL}" of w
+              return "dismissed:${DISMISS_BUTTON_LABEL}"
+            end if
+          end try
+        end repeat
+      end tell
+    end tell
+    return "not-found"
+  on error errMsg
+    return "error:" & errMsg
+  end try
+end run
+`;
+async function tryDismissMacOS() {
+    return new Promise((resolve) => {
+        execFile('osascript', ['-e', MACOS_DISMISS_APPLESCRIPT], { timeout: 5000 }, (err, stdout) => {
+            if (err) {
+                verbose(`tryDismissMacOS: osascript invocation failed (${err.message}) — treating as transient error`);
+                resolve({ kind: 'error', message: err.message });
+                return;
+            }
+            resolve(parseDismissOutput(stdout));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Linux/X11 — xdotool
+// ---------------------------------------------------------------------------
+/**
+ * Whether `xdotool` is on PATH. Cached per process so the polling
+ * loop pays the lookup cost at most once. `which xdotool` /
+ * `command -v xdotool` is too coarse here — we directly try
+ * `xdotool --version` and observe the exit code.
+ */
+let xdotoolPresence;
+function isXdotoolAvailable() {
+    if (xdotoolPresence !== undefined)
+        return xdotoolPresence;
+    try {
+        execFileSync('xdotool', ['--version'], {
+            stdio: 'ignore',
+            timeout: 2000,
+        });
+        xdotoolPresence = true;
+    }
+    catch {
+        xdotoolPresence = false;
+    }
+    return xdotoolPresence;
+}
+/**
+ * Reset the cached `xdotool` presence flag. Test-only — production
+ * code never needs to call this. Exposed so tests can simulate "the
+ * tool was installed mid-process" without affecting other tests.
+ */
+export function _resetXdotoolPresenceForTests() {
+    xdotoolPresence = undefined;
+}
+/**
+ * Escape a literal string for safe use in `xdotool search --name`.
+ * `xdotool search --name` interprets its argument as a regex; without
+ * escaping, a future fragment containing metacharacters (e.g.
+ * `(Hold On)` or `Compiler Errors v2.0+`) would silently change the
+ * match semantics. The current fragments are regex-safe but this
+ * helper is defensive and zero-runtime-cost.
+ *
+ * Exposed for tests so the regex-safety contract is locked down.
+ */
+export function regexEscapeForXdotool(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Look up currently-running Unity Editor PIDs on the local box.
+ * Used by the Linux/X11 dismiss path to scope the title-fragment
+ * window match to Unity processes only — without this, `xdotool
+ * search --name 'Hold On'` would match any top-level window whose
+ * title contains "Hold On" (browser tab, chat client, etc.).
+ *
+ * Returns an empty array on any failure (missing `pgrep`, no Unity
+ * running, syscall error). Pure / idempotent / never throws.
+ */
+function getUnityPidsLinux() {
+    try {
+        const stdout = execFileSync('pgrep', ['-x', 'Unity'], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 1000,
+            encoding: 'utf8',
+        });
+        return stdout
+            .split(/\r?\n/)
+            .map((s) => parseInt(s.trim(), 10))
+            .filter((n) => Number.isFinite(n) && n > 0);
+    }
+    catch {
+        return [];
+    }
+}
+async function tryDismissLinuxX11() {
+    if (!isXdotoolAvailable()) {
+        return {
+            kind: 'error',
+            message: `${LINUX_XDOTOOL_MISSING_PREFIX}. Install it (e.g. \`sudo apt-get install xdotool\`) to enable Unity launch-errors auto-dismiss on Linux/X11. Wayland is not yet supported.`,
+        };
+    }
+    const unityPids = new Set(getUnityPidsLinux());
+    if (unityPids.size === 0) {
+        return { kind: 'not-found' };
+    }
+    // Strategy:
+    //   1. `xdotool search --name '<regex-escaped fragment>'` once per
+    //      fragment, collect candidate window IDs. Empty stdout from
+    //      `xdotool search` is reported via a non-zero exit; treat that
+    //      as "no match".
+    //   2. Filter candidate windows to those owned by a Unity PID via
+    //      `xdotool getwindowpid <winId>` so we never act on an
+    //      unrelated top-level window with a colliding title.
+    //   3. Activate the window (`windowactivate --sync`) and send Return
+    //      to click the focused button. The Unity launch-errors dialog
+    //      defaults focus to the leftmost button, which IS `Ignore`.
+    return new Promise((resolve) => {
+        const fragments = LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS;
+        let idx = 0;
+        const tryNext = () => {
+            if (idx >= fragments.length) {
+                resolve({ kind: 'not-found' });
+                return;
+            }
+            const fragment = fragments[idx++];
+            execFile('xdotool', ['search', '--name', regexEscapeForXdotool(fragment)], { timeout: 2000 }, (err, stdout) => {
+                if (err || !stdout.trim()) {
+                    tryNext();
+                    return;
+                }
+                const candidateIds = stdout.trim().split(/\s+/).filter(Boolean);
+                findUnityOwnedWindow(candidateIds, unityPids, (winId) => {
+                    if (!winId) {
+                        tryNext();
+                        return;
+                    }
+                    // Activate then send Return to click the focused (Ignore) button.
+                    execFile('xdotool', ['windowactivate', '--sync', winId, 'key', '--clearmodifiers', 'Return'], { timeout: 2000 }, (activateErr) => {
+                        if (activateErr) {
+                            resolve({
+                                kind: 'error',
+                                message: `xdotool failed to dismiss window ${winId}: ${activateErr.message}`,
+                            });
+                            return;
+                        }
+                        resolve({ kind: 'dismissed', button: DISMISS_BUTTON_LABEL });
+                    });
+                });
+            });
+        };
+        tryNext();
+    });
+}
+/**
+ * Walk `candidateIds` and call `done(winId)` with the first window
+ * owned by a Unity PID, or `done(undefined)` if none match. Each
+ * `xdotool getwindowpid <id>` call has a short timeout so a stalled
+ * lookup cannot stall the polling loop. Sequential, not parallel —
+ * the candidate list is small and parallelism would buy us nothing
+ * meaningful here.
+ */
+function findUnityOwnedWindow(candidateIds, unityPids, done) {
+    let idx = 0;
+    const next = () => {
+        if (idx >= candidateIds.length) {
+            done(undefined);
+            return;
+        }
+        const winId = candidateIds[idx++];
+        execFile('xdotool', ['getwindowpid', winId], { timeout: 1000 }, (err, stdout) => {
+            if (err) {
+                next();
+                return;
+            }
+            const pid = parseInt(stdout.trim(), 10);
+            if (Number.isFinite(pid) && unityPids.has(pid)) {
+                done(winId);
+                return;
+            }
+            next();
+        });
+    };
+    next();
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse the single-token contract every platform-specific dispatcher
+ * writes to stdout. Exposed for tests so we can exhaustively cover
+ * the parser without invoking PowerShell / osascript / xdotool.
+ *
+ * Inspects the LAST non-empty line of stdout, not the whole buffer:
+ * a stray PowerShell warning, `osascript` deprecation notice, or
+ * `xdotool` chatter printed before the contract token must not
+ * misclassify the result as `not-found`.
+ *
+ * Contract:
+ *   - `dismissed:<button>` → `{ kind: 'dismissed', button }`
+ *   - `not-found`          → `{ kind: 'not-found' }`
+ *   - `error:<message>`    → `{ kind: 'error', message }`
+ *   - any other / empty    → `{ kind: 'not-found' }` (defensive — a
+ *     transient parse miss is treated as "not yet visible" rather
+ *     than aborting the polling loop)
+ */
+export function parseDismissOutput(stdout) {
+    const lines = stdout.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0);
+    if (lines.length === 0)
+        return { kind: 'not-found' };
+    const last = lines[lines.length - 1];
+    if (last === 'not-found')
+        return { kind: 'not-found' };
+    if (last.startsWith('dismissed:')) {
+        const button = last.substring('dismissed:'.length);
+        return { kind: 'dismissed', button: button || DISMISS_BUTTON_LABEL };
+    }
+    if (last.startsWith('error:')) {
+        return { kind: 'error', message: last.substring('error:'.length) };
+    }
+    return { kind: 'not-found' };
+}
+//# sourceMappingURL=launch-error-dismiss.js.map

package/dist/devops/utils/launch-error-dismiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-error-dismiss.js","sourceRoot":"","sources":["../../../src/devops/utils/launch-error-dismiss.ts"],"names":[],"mappings":"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"}

package/dist/devops/utils/manifest.d.ts

@@ -0,0 +1,124 @@
+import { type LibLogger } from '../lib/logger.js';
+export declare const UCO_UNITY_PACKAGE_ID = "com.atelierai.unity.copilot";
+export declare const COCLI_LEGACY_UNITY_PACKAGE_IDS: readonly ["com.ivanmurzak.unity.mcp"];
+export declare const COCLI_OPENUPM_REQUIRED_SCOPES: string[];
+export interface ManifestFileSystem {
+    statSync(filePath: string): {
+        mode: number;
+    };
+    writeFileSync(filePath: string, content: string, options: {
+        encoding: 'utf8';
+        mode: number;
+        flag: 'wx';
+    }): void;
+    renameSync(oldPath: string, newPath: string): void;
+    unlinkSync(filePath: string): void;
+}
+export declare class AtomicManifestReplaceError extends Error {
+    readonly temporaryPath: string;
+    readonly replacementError: unknown;
+    readonly cleanupError: unknown;
+    constructor(temporaryPath: string, replacementError: unknown, cleanupError: unknown);
+}
+/** Same-directory unique write followed by atomic replacement. */
+export declare function atomicReplaceManifest(manifestPath: string, content: string, fileSystem?: ManifestFileSystem): void;
+export interface PluginManifestInspection {
+    manifestPath: string;
+    activeSource: string | undefined;
+    activeSourceIsNonSemver: boolean;
+}
+export declare function inspectPluginManifest(projectPath: string): PluginManifestInspection;
+/**
+ * Resolve the latest plugin version from the OpenUPM registry.
+ * Throws an error with actionable suggestions if the network request fails.
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export declare function resolveLatestVersion(logger?: LibLogger): Promise<string>;
+/**
+ * Determines if the version should be updated.
+ * Only update if the new version is higher than the current version.
+ * Ports the C# Installer.ShouldUpdateVersion() logic.
+ */
+export declare function shouldUpdateVersion(currentVersion: string, newVersion: string): boolean;
+export interface AddPluginResult {
+    /** Whether the file was modified on disk (false = already up to date). */
+    modified: boolean;
+    /** Final plugin version in the manifest (may differ from the requested
+     *  version if the existing version was higher and force was false). */
+    resolvedVersion: string;
+    /** Absolute path to the manifest.json that was inspected / written. */
+    manifestPath: string;
+}
+/**
+ * Add Unity-MCP plugin to a Unity project's Packages/manifest.json.
+ * Ports the C# Installer.Manifest.cs logic:
+ * - Adds OpenUPM scoped registry with required scopes
+ * - Adds/updates the plugin dependency
+ * - When force is false (auto-resolved version): never downgrades
+ * - When force is true (user-specified --plugin-version): allows downgrade
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export declare function addPluginToManifest(projectPath: string, version: string, force?: boolean, logger?: LibLogger, fileSystem?: ManifestFileSystem): AddPluginResult;
+/** Plugin sourcing mode for `setPluginInManifest`. */
+export type ManifestPluginSpec = {
+    kind: 'file';
+    path: string;
+} | {
+    kind: 'git';
+    url: string;
+} | {
+    kind: 'embed';
+};
+export interface PatchManifestResult {
+    /** Whether the file was modified on disk. */
+    modified: boolean;
+    /** Absolute path to the manifest.json. */
+    manifestPath: string;
+    /** Final dependency value written under `com.atelierai.unity.copilot`. */
+    dependencyValue: string;
+    /** Scoped registry scopes that were removed (so caller can warn). */
+    removedScopes: string[];
+}
+/**
+ * Patch `Packages/manifest.json` for the uco `install` flow.
+ *
+ *   - Set `dependencies["com.atelierai.unity.copilot"]` to the chosen sourcing
+ *     spec (file:, git, or embed).
+ *   - Strip the OpenUPM `org.nuget.com.ivanmurzak.*` scopes from any
+ *     existing `scopedRegistries[].scopes` array (we ship DLLs directly,
+ *     so OpenUPM must not race the install and re-introduce upstream
+ *     binaries).
+ *   - Keep the OpenUPM `extensions.unity` scope needed by the embedded
+ *     plugin's Unity package dependencies.
+ *   - If another scopedRegistry ends up with zero scopes after stripping,
+ *     remove that registry entry.
+ *
+ * Idempotent: re-running with the same spec is a no-op.
+ *
+ * NB: this is intentionally separate from `addPluginToManifest`, which
+ *     installs the plugin itself from OpenUPM. uco's install path only
+ *     keeps scopes needed by transitive Unity packages.
+ */
+export declare function setPluginInManifest(projectPath: string, spec: ManifestPluginSpec, logger?: LibLogger, fileSystem?: ManifestFileSystem): PatchManifestResult;
+export interface RemovePluginResult {
+    /** Whether the plugin was present and has been removed. */
+    removed: boolean;
+    /** Absolute path to the manifest.json that was inspected. */
+    manifestPath: string;
+}
+/**
+ * Remove Unity-MCP plugin from a Unity project's Packages/manifest.json.
+ * Only removes the plugin dependency — scoped registries and scopes are
+ * left untouched because other packages may depend on them.
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export declare function removePluginFromManifest(projectPath: string, logger?: LibLogger, fileSystem?: ManifestFileSystem): RemovePluginResult;