unity-mcp-cli 0.88.0 → 0.90.0

package/README.md

@@ -93,6 +93,7 @@ npx unity-mcp-cli install-plugin /path/to/unity/project
 - [Commands](#commands)
   - [`configure`](#configure)
   - [`create-project`](#create-project)
+  - [`install-extension`](#install-extension)
   - [`install-plugin`](#install-plugin)
   - [`install-unity`](#install-unity)
   - [`login`](#login)
@@ -181,6 +182,55 @@ unity-mcp-cli create-project ./MyGame --unity 2022.3.62f1
 
 ![AI Game Developer — Unity SKILLS and MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
 
+## `install-extension`
+
+Install one of the Unity-MCP extensions — the optional tool packs that add MCP tools for Animation, Cinemachine, Input System, Navigation, Particle System, ProBuilder, Splines, Terrain, Tilemap, and Timeline — into a Unity project's `Packages/manifest.json`. This is the command-line equivalent of the **Extensions** section in the *AI Game Developer* editor window, and it installs from the same shared catalogue.
+
+```bash
+# See what is installable (no project and no network required)
+unity-mcp-cli install-extension --list
+
+# Run from inside the Unity project folder — the path is optional
+cd ./MyGame && unity-mcp-cli install-extension Tilemap
+```
+
+| Argument / Option | Required | Description |
+|---|---|---|
+| `[id]` | Yes (unless `--list`) | Extension to install — the OpenUPM package id (`com.ivanmurzak.unity.mcp.tilemap`) or the catalogue name (`Tilemap`). Matched case-insensitively. An unknown id lists every installable extension so you can self-correct. |
+| `[path]` | No | Path to the Unity project (positional or `--path`). Defaults to the current directory, verified the same way as `install-plugin`. |
+| `--extension-version <version>` | No | Extension version to install (defaults to latest from OpenUPM). **Not `--version`** — that is the CLI's own global version flag. |
+| `--list` | No | List the installable extensions and exit. |
+
+This command:
+1. Adds the **OpenUPM scoped registry** with all required scopes (the `com.ivanmurzak` scope is what makes the extension resolvable at all)
+2. Adds the extension's package id to `dependencies`, resolving OpenUPM's `latest` at install time
+3. **Never downgrades** on an auto-resolved version — if a higher version is already installed, it is preserved and a warning is printed. Pass `--extension-version` to force a specific value, including a downgrade.
+4. Is **idempotent** — a re-run that finds the extension already up to date reports so and writes nothing
+
+**Example — install a specific extension version:**
+
+```bash
+unity-mcp-cli install-extension Cinemachine ./MyGame --extension-version 1.0.17
+```
+
+**Example — in-process, from the library:**
+
+```ts
+import { installExtension, EXTENSIONS_CATALOG } from 'unity-mcp-cli';
+
+const result = await installExtension({
+  unityProjectPath: './MyGame',
+  extensionId: 'Tilemap',
+});
+if (result.kind === 'success') {
+  console.log(result.outcome, result.fromVersion, '->', result.toVersion);
+}
+```
+
+> After running this command, open (or focus) the Unity Editor so the Package Manager resolves the new dependency.
+
+![AI Game Developer — Unity SKILLS and MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
+
 ## `install-plugin`
 
 Install the Unity-MCP plugin into a Unity project's `Packages/manifest.json`. Optionally download the RID-matched MCP server binary and redeem a team enrollment code in the same run.

package/dist/commands/install-extension.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installExtensionCommand: Command;

package/dist/commands/install-extension.js

@@ -0,0 +1,99 @@
+import { Command } from 'commander';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { installExtension } from '../lib/install-extension.js';
+import { EXTENSIONS_CATALOG } from '../utils/extensions-catalog.js';
+import { resolveInstallTarget, unityAdapter } from '@baizor/gamedev-cli-core';
+export const installExtensionCommand = new Command('install-extension')
+    .description('Install a Unity-MCP extension into a Unity project: resolve the extension <id> from the shared catalogue, add (or update) its dependency plus the OpenUPM scoped registry in Packages/manifest.json, then let Unity resolve it. Idempotent. The project path defaults to the current directory (like install-plugin).')
+    .argument('[id]', 'Extension to install (the OpenUPM package id, or the catalogue name e.g. "Tilemap")')
+    .argument('[path]', 'Path to the Unity project (defaults to the current directory)')
+    .option('--path <path>', 'Path to the Unity project')
+    // NOT `--version`: the root program registers `-V, --version` via `.version()`, which
+    // intercepts it before this subcommand sees it — `install-extension X --version 1.2.3`
+    // would print the CLI's own version and exit 0 without installing anything. This is the
+    // same reason `install-plugin` spells its flag `--plugin-version`.
+    .option('--extension-version <version>', 'Extension version to install (default: latest from OpenUPM)')
+    .option('--list', 'List the installable extensions and exit')
+    .action(async (id, positionalPath, options) => {
+    // `--list` is a pure read: no project needed, no network, exit 0.
+    if (options.list) {
+        ui.heading('Installable Unity-MCP extensions');
+        for (const ext of EXTENSIONS_CATALOG) {
+            ui.label(ext.name, ext.packageId);
+        }
+        ui.info(`${EXTENSIONS_CATALOG.length} extensions. Install one with: unity-mcp-cli install-extension <id> [path]`);
+        return;
+    }
+    if (!id || id.trim() === '') {
+        ui.error('Missing extension id. Pass one (e.g. `unity-mcp-cli install-extension Tilemap`), or run with --list to see what is installable.');
+        process.exit(1);
+    }
+    // Same path resolution as install-plugin: `path? → --path? → cwd`, then verify the
+    // directory really is a Unity project so the error names what was checked.
+    const target = resolveInstallTarget({
+        adapter: unityAdapter,
+        positional: positionalPath,
+        path: options.path,
+    });
+    if (target.kind === 'failure') {
+        ui.error(target.error.message);
+        process.exit(1);
+    }
+    const projectPath = target.projectRoot;
+    ui.heading('Installing Unity-MCP extension');
+    verbose(`Extension id: ${id}`);
+    verbose(`Project path: ${projectPath}`);
+    if (options.extensionVersion)
+        verbose(`--extension-version: ${options.extensionVersion}`);
+    let spinner;
+    if (!options.extensionVersion) {
+        spinner = ui.startSpinner('Resolving latest extension version...');
+    }
+    const result = await installExtension({
+        unityProjectPath: projectPath,
+        extensionId: id,
+        version: options.extensionVersion,
+        onProgress: (event) => {
+            if (event.phase === 'dependencies-resolved' && spinner) {
+                spinner.success(`Resolved extension version: ${event.version}`);
+                spinner = undefined;
+                return;
+            }
+            if (event.phase === 'manifest-patched') {
+                verbose(event.message);
+            }
+        },
+    });
+    if (result.kind === 'failure') {
+        if (spinner) {
+            spinner.error('Failed to resolve extension version');
+            spinner = undefined;
+        }
+        ui.error(result.error.message);
+        for (const warning of result.warnings) {
+            ui.warn(warning);
+        }
+        process.exit(1);
+    }
+    switch (result.outcome) {
+        case 'added':
+            ui.success(`Installed ${result.packageId} ${result.toVersion}`);
+            break;
+        case 'updated':
+            ui.success(`Updated ${result.packageId} ${result.fromVersion} → ${result.toVersion}`);
+            break;
+        case 'already-up-to-date':
+            ui.info(`${result.packageId} is already up to date (${result.toVersion})`);
+            break;
+    }
+    ui.label('Status', result.message);
+    ui.label('Manifest', result.manifestPath);
+    for (const warning of result.warnings) {
+        ui.warn(warning);
+    }
+    for (const step of result.nextSteps) {
+        ui.label('Next step', step);
+    }
+});
+//# sourceMappingURL=install-extension.js.map

package/dist/commands/install-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-extension.js","sourceRoot":"","sources":["../../src/commands/install-extension.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,6 +5,7 @@ import { closeCommand } from './commands/close.js';
 import { createProjectCommand } from './commands/create-project.js';
 import { installUnityCommand } from './commands/install-unity.js';
 import { openCommand } from './commands/open.js';
+import { installExtensionCommand } from './commands/install-extension.js';
 import { installPluginCommand } from './commands/install-plugin.js';
 import { loginCommand } from './commands/login.js';
 import { configureCommand } from './commands/configure.js';
@@ -32,6 +33,7 @@ const subcommands = [
     closeCommand,
     configureCommand,
     createProjectCommand,
+    installExtensionCommand,
     installPluginCommand,
     installUnityCommand,
     loginCommand,

package/dist/index.js.map

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

package/dist/lib/install-extension.d.ts

@@ -0,0 +1,25 @@
+import type { InstallExtensionOptions, InstallExtensionResult } from './types.js';
+/**
+ * Install (or update) a Unity-MCP extension into a consumer Unity project, as a
+ * REAL installer that is behaviourally identical to the in-editor window's
+ * `ExtensionPanel`:
+ *
+ *  1. Resolve `extensionId` to a descriptor in the SHARED catalogue
+ *     (`Unity-MCP-Plugin/Packages/com.ivanmurzak.unity.mcp/extensions.catalog.json`,
+ *     mirrored here by `EXTENSIONS_CATALOG`).
+ *  2. Validate that the target path hosts a Unity project (`Packages/manifest.json`).
+ *  3. Resolve the version to install: the explicit `version` override, else the
+ *     catalogue pin, else OpenUPM's `dist-tags.latest` fetched live. Every shipped
+ *     catalogue entry is unpinned, so the live fetch is the normal path.
+ *  4. Read-modify-write `Packages/manifest.json`: ensure the OpenUPM scoped registry
+ *     and its required scopes, then add or version-bump the package dependency.
+ *  5. Tell the caller Unity must resolve packages (the CLI cannot call
+ *     `UnityEditor.PackageManager.Client.Resolve()` — only the editor can).
+ *
+ * Library-safe: no stdout noise, no `process.exit`, no throws past the public
+ * boundary; returns a `{ kind: 'success' | 'failure' }` union. Idempotent: a re-run
+ * that finds the dependency at an equal-or-newer version reports
+ * `already-up-to-date` and makes no write. Mirrors `installPlugin`'s shape exactly
+ * so the app can adopt it the same way.
+ */
+export declare function installExtension(opts: InstallExtensionOptions): Promise<InstallExtensionResult>;

package/dist/lib/install-extension.js

@@ -0,0 +1,182 @@
+import * as fs from 'fs';
+import { EXTENSIONS_CATALOG, findExtension, hasVersion, } from '../utils/extensions-catalog.js';
+import { addPackageToManifest, resolveLatestPackageVersion } from '../utils/manifest.js';
+import { silentLogger } from './logger.js';
+import { emitProgress } from './progress.js';
+import { requireUnityProject } from './validation.js';
+/**
+ * Install (or update) a Unity-MCP extension into a consumer Unity project, as a
+ * REAL installer that is behaviourally identical to the in-editor window's
+ * `ExtensionPanel`:
+ *
+ *  1. Resolve `extensionId` to a descriptor in the SHARED catalogue
+ *     (`Unity-MCP-Plugin/Packages/com.ivanmurzak.unity.mcp/extensions.catalog.json`,
+ *     mirrored here by `EXTENSIONS_CATALOG`).
+ *  2. Validate that the target path hosts a Unity project (`Packages/manifest.json`).
+ *  3. Resolve the version to install: the explicit `version` override, else the
+ *     catalogue pin, else OpenUPM's `dist-tags.latest` fetched live. Every shipped
+ *     catalogue entry is unpinned, so the live fetch is the normal path.
+ *  4. Read-modify-write `Packages/manifest.json`: ensure the OpenUPM scoped registry
+ *     and its required scopes, then add or version-bump the package dependency.
+ *  5. Tell the caller Unity must resolve packages (the CLI cannot call
+ *     `UnityEditor.PackageManager.Client.Resolve()` — only the editor can).
+ *
+ * Library-safe: no stdout noise, no `process.exit`, no throws past the public
+ * boundary; returns a `{ kind: 'success' | 'failure' }` union. Idempotent: a re-run
+ * that finds the dependency at an equal-or-newer version reports
+ * `already-up-to-date` and makes no write. Mirrors `installPlugin`'s shape exactly
+ * so the app can adopt it the same way.
+ */
+export async function installExtension(opts) {
+    const warnings = [];
+    const nextSteps = [];
+    const extensionId = opts?.extensionId ?? '';
+    try {
+        const catalog = opts.catalog ?? EXTENSIONS_CATALOG;
+        const resolved = findExtension(extensionId, catalog);
+        if (resolved === null) {
+            return {
+                kind: 'failure',
+                success: false,
+                extensionId,
+                warnings,
+                nextSteps,
+                error: new Error(unknownExtensionMessage(extensionId, catalog)),
+            };
+        }
+        const validated = requireUnityProject(opts?.unityProjectPath);
+        if (!validated.ok) {
+            return {
+                kind: 'failure',
+                success: false,
+                extensionId,
+                packageId: resolved.packageId,
+                manifestPath: validated.manifestPath,
+                warnings,
+                nextSteps,
+                error: validated.error,
+            };
+        }
+        const { projectPath } = validated;
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Installing extension ${resolved.packageId} into ${projectPath}`,
+        });
+        // Apply the optional `version` override (drives both the pin written and, via
+        // `force`, whether a downgrade is permitted).
+        const descriptor = applyVersionOverride(resolved, opts.version, warnings);
+        const isExplicitVersion = (opts.version ?? '').trim() !== '';
+        let version;
+        if (hasVersion(descriptor)) {
+            // Non-null only for an explicit override or a (currently unused) catalogue pin.
+            version = descriptor.version;
+        }
+        else {
+            version = await resolveLatestPackageVersion(descriptor.packageId, silentLogger, '--extension-version');
+            emitProgress(opts.onProgress, {
+                phase: 'dependencies-resolved',
+                message: `Resolved latest ${descriptor.packageId} version: ${version}`,
+                version,
+            });
+        }
+        const before = readInstalledVersion(validated.manifestPath, descriptor.packageId);
+        const result = addPackageToManifest(projectPath, descriptor.packageId, version, isExplicitVersion, silentLogger);
+        // `addPackageToManifest` refuses to downgrade unless `force`; surface that as a
+        // warning rather than silently reporting the requested version.
+        if (result.resolvedVersion !== version && !isExplicitVersion) {
+            warnings.push(`${descriptor.packageId} is already at version ${result.resolvedVersion} (>= ${version}). ` +
+                'Skipping version update. Pass an explicit `version` to force a specific value.');
+        }
+        emitProgress(opts.onProgress, {
+            phase: 'manifest-patched',
+            message: result.modified
+                ? `Updated ${result.manifestPath}`
+                : 'manifest.json is already up to date.',
+            manifestPath: result.manifestPath,
+        });
+        // Derive the outcome from what was actually on disk before the write, NOT from
+        // `modified` alone: `modified` is also true when only the scoped registry had to
+        // be added, which is not an "added extension".
+        const outcome = before === null
+            ? 'added'
+            : result.resolvedVersion === before
+                ? 'already-up-to-date'
+                : 'updated';
+        const message = outcome === 'added'
+            ? `Added ${descriptor.packageId} ${result.resolvedVersion}. Unity will resolve the package on next focus.`
+            : outcome === 'updated'
+                ? `Updated ${descriptor.packageId} from ${before} to ${result.resolvedVersion}.`
+                : `${descriptor.name} is already installed and up to date (${result.resolvedVersion}).`;
+        if (outcome !== 'already-up-to-date') {
+            nextSteps.push('Open (or focus) the Unity Editor so the Package Manager resolves the new dependency.');
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: 'Extension install complete.' });
+        return {
+            kind: 'success',
+            success: true,
+            outcome,
+            changed: outcome !== 'already-up-to-date',
+            extensionId,
+            packageId: descriptor.packageId,
+            fromVersion: before,
+            toVersion: result.resolvedVersion,
+            manifestPath: result.manifestPath,
+            message,
+            warnings,
+            nextSteps,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            extensionId,
+            warnings,
+            nextSteps,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/**
+ * Read the version currently pinned for `packageId` in the project manifest, or
+ * `null` when the dependency is absent. Used to classify the outcome as
+ * added / updated / already-up-to-date, which `addPackageToManifest`'s
+ * `{ modified }` flag cannot express on its own.
+ *
+ * Deliberately forgiving: any read/parse problem yields `null` (treated as
+ * "not installed"). The subsequent `addPackageToManifest` call performs the
+ * authoritative read and throws a precise error if the manifest is unusable, so
+ * swallowing here cannot mask a real failure — it only avoids duplicating the
+ * error path.
+ */
+function readInstalledVersion(manifestPath, packageId) {
+    try {
+        const raw = fs.readFileSync(manifestPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const current = parsed?.dependencies?.[packageId];
+        return typeof current === 'string' && current.trim() !== '' ? current : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Return a descriptor with the `version` override applied (empty/whitespace override is ignored). */
+function applyVersionOverride(descriptor, version, warnings) {
+    const v = (version ?? '').trim();
+    if (v === '')
+        return descriptor;
+    if (descriptor.version !== null && descriptor.version !== v) {
+        warnings.push(`version ${v} overrides the catalogue pin ${descriptor.packageId}@${descriptor.version} for this install.`);
+    }
+    return { ...descriptor, version: v };
+}
+/** A clear "unknown extension" error that lists what IS installable (or says the catalogue is empty). */
+function unknownExtensionMessage(id, catalog) {
+    if (catalog.length === 0) {
+        return (`Unknown extension "${id}". The Unity-MCP extension catalogue is currently empty, ` +
+            'so there is nothing to install.');
+    }
+    const available = catalog.map((d) => d.packageId).join(', ');
+    return `Unknown extension "${id}". Available extensions: ${available}.`;
+}
+//# sourceMappingURL=install-extension.js.map

package/dist/lib/install-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-extension.js","sourceRoot":"","sources":["../../src/lib/install-extension.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -1,3 +1,4 @@
+import type { ExtensionDescriptor } from '../utils/extensions-catalog.js';
 /**
  * Discriminated union describing every progress event the library can
  * emit to the optional `onProgress` callback.
@@ -120,6 +121,84 @@ export interface InstallFailure {
     error: Error;
 }
 export type InstallResult = InstallSuccess | InstallFailure;
+/**
+ * What `installExtension` actually did. Distinguished from `changed` because a
+ * caller usually wants to say "installed" vs "updated" vs "nothing to do" in its
+ * UI, and `changed` alone cannot tell the first two apart.
+ */
+export type InstallExtensionOutcome = 'added' | 'updated' | 'already-up-to-date';
+export interface InstallExtensionOptions {
+    /** Absolute or relative path to the Unity project's root. */
+    unityProjectPath: string;
+    /**
+     * Extension to install — either the OpenUPM package id
+     * (`com.ivanmurzak.unity.mcp.tilemap`) or the catalogue display name
+     * (`Tilemap`). Matched case-insensitively, package id first.
+     */
+    extensionId: string;
+    /**
+     * Version to install. When omitted, OpenUPM's `dist-tags.latest` is resolved
+     * live at install time — which is the normal path, because every catalogue
+     * entry is unpinned (`version: null`). Supplying a value also permits a
+     * downgrade, mirroring `installPlugin`'s explicit-version semantics.
+     */
+    version?: string;
+    /**
+     * Catalogue override, for tests and for callers that carry their own list.
+     * Defaults to the built-in `EXTENSIONS_CATALOG`.
+     */
+    catalog?: readonly ExtensionDescriptor[];
+    /**
+     * Optional progress callback — fires for `start`, `dependencies-resolved`
+     * (when the version was auto-resolved), `manifest-patched`, and `done`.
+     */
+    onProgress?: ProgressCallback;
+}
+/** Successful `installExtension` outcome. Narrow with `kind === 'success'`. */
+export interface InstallExtensionSuccess {
+    kind: 'success';
+    /** Always `true` for the success variant. */
+    success: true;
+    /** What happened — see {@link InstallExtensionOutcome}. */
+    outcome: InstallExtensionOutcome;
+    /** `true` when `manifest.json` was written. `false` for `already-up-to-date`. */
+    changed: boolean;
+    /** The `extensionId` as supplied by the caller. */
+    extensionId: string;
+    /** The resolved OpenUPM package id that was written to the manifest. */
+    packageId: string;
+    /** Version present before the call, or `null` when the extension was absent. */
+    fromVersion: string | null;
+    /** Version present after the call. */
+    toVersion: string;
+    /** Absolute path to the `Packages/manifest.json` that was inspected / written. */
+    manifestPath: string;
+    /** Human-readable summary the caller may surface directly. */
+    message: string;
+    /** Non-fatal warnings collected during the run. */
+    warnings: string[];
+    /** Suggested next steps for the caller to surface to a human user. */
+    nextSteps: string[];
+}
+/** Failed `installExtension` outcome. Narrow with `kind === 'failure'`. */
+export interface InstallExtensionFailure {
+    kind: 'failure';
+    /** Always `false` for the failure variant. */
+    success: false;
+    /** The `extensionId` as supplied by the caller. */
+    extensionId: string;
+    /** Resolved package id, when catalogue lookup succeeded before the failure. */
+    packageId?: string;
+    /** Manifest path may be known even on failure (e.g. a validation failure that reached it). */
+    manifestPath?: string;
+    /** Non-fatal warnings collected before the failure. */
+    warnings: string[];
+    /** Suggested next steps the caller may surface to a human user. */
+    nextSteps: string[];
+    /** The captured error. Never thrown past this boundary. */
+    error: Error;
+}
+export type InstallExtensionResult = InstallExtensionSuccess | InstallExtensionFailure;
 export interface RemovePluginOptions {
     unityProjectPath: string;
     onProgress?: ProgressCallback;

package/dist/lib.d.ts

@@ -1,8 +1,11 @@
 export { installPlugin } from './lib/install-plugin.js';
+export { installExtension } from './lib/install-extension.js';
 export { removePlugin } from './lib/remove-plugin.js';
 export { configure } from './lib/configure.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { openProject } from './lib/open.js';
 export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';
-export type { ProgressEvent, ProgressCallback, ResultKind, InstallPluginOptions, InstallResult, InstallSuccess, InstallFailure, RemovePluginOptions, RemoveResult, RemoveSuccess, RemoveFailure, ConfigureOptions, ConfigureResult, ConfigureSuccess, ConfigureFailure, ConfigureSnapshot, FeatureAction, McpFeatureSnapshot, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, McpTransport, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectTransport, CreateProjectOptions, CreateProjectResult, CreateProjectSuccess, CreateProjectFailure, CreateProjectEditorInfo, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, } from './lib/types.js';
+export { EXTENSIONS_CATALOG, findExtension, hasVersion, } from './utils/extensions-catalog.js';
+export type { ExtensionDescriptor, ExtensionTool, } from './utils/extensions-catalog.js';
+export type { ProgressEvent, ProgressCallback, ResultKind, InstallPluginOptions, InstallResult, InstallSuccess, InstallFailure, InstallExtensionOptions, InstallExtensionResult, InstallExtensionSuccess, InstallExtensionFailure, InstallExtensionOutcome, RemovePluginOptions, RemoveResult, RemoveSuccess, RemoveFailure, ConfigureOptions, ConfigureResult, ConfigureSuccess, ConfigureFailure, ConfigureSnapshot, FeatureAction, McpFeatureSnapshot, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, McpTransport, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectTransport, CreateProjectOptions, CreateProjectResult, CreateProjectSuccess, CreateProjectFailure, CreateProjectEditorInfo, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, } from './lib/types.js';

package/dist/lib.js

@@ -16,10 +16,15 @@
 // Consumers: `import { installPlugin } from 'unity-mcp-cli'` (maps to
 // this file via the `exports` field in package.json).
 export { installPlugin } from './lib/install-plugin.js';
+export { installExtension } from './lib/install-extension.js';
 export { removePlugin } from './lib/remove-plugin.js';
 export { configure } from './lib/configure.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { openProject } from './lib/open.js';
 export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';
+// The extension catalogue is part of the public library surface: a consumer that
+// renders an "install an extension" list (the desktop app) needs the same ten
+// entries the CLI installs from, and must not re-declare them.
+export { EXTENSIONS_CATALOG, findExtension, hasVersion, } from './utils/extensions-catalog.js';
 //# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,qDAAqD;AACrD,iEAAiE;AACjE,sEAAsE;AACtE,oDAAoD;AACpD,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,uEAAuE;AACvE,iEAAiE;AACjE,oEAAoE;AACpE,2BAA2B;AAC3B,EAAE;AACF,sEAAsE;AACtE,sDAAsD;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,qDAAqD;AACrD,iEAAiE;AACjE,sEAAsE;AACtE,oDAAoD;AACpD,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,uEAAuE;AACvE,iEAAiE;AACjE,oEAAoE;AACpE,2BAA2B;AAC3B,EAAE;AACF,sEAAsE;AACtE,sDAAsD;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3D,iFAAiF;AACjF,8EAA8E;AAC9E,+DAA+D;AAC/D,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,MAAM,+BAA+B,CAAC"}

package/dist/utils/extensions-catalog.d.ts

@@ -0,0 +1,40 @@
+/** One tool a catalogue extension contributes — mirrors the JSON `tools[]` entry. */
+export interface ExtensionTool {
+    readonly name: string;
+    readonly description: string;
+}
+/**
+ * One installable extension — the CLI analog of the C# `ExtensionPanel.ExtensionData`.
+ * `packageId` is the INSTALL IDENTITY (the `Packages/manifest.json` dependency key,
+ * resolved from the OpenUPM scoped registry).
+ * `version` is `null` for a floating (unpinned) reference — every catalogue entry is
+ * unpinned, so OpenUPM's `dist-tags.latest` is resolved live at install time.
+ *
+ * `tools` is the same CURATED highlight list the editor renders in an extension's
+ * tooltip (`ExtensionPanel.BuildTooltip`) — it is deliberately NOT an exhaustive
+ * inventory of the extension's MCP tools, and must not be consumed as one.
+ */
+export interface ExtensionDescriptor {
+    readonly name: string;
+    readonly description: string;
+    readonly packageId: string;
+    readonly version: string | null;
+    readonly gitUrl: string | null;
+    readonly tools: readonly ExtensionTool[];
+}
+/**
+ * The extension catalogue, single-sourced from
+ * `Unity-MCP-Plugin/Packages/com.ivanmurzak.unity.mcp/extensions.catalog.json`.
+ * Ten shipped extensions; `Unity-AI-Tools-Template` is a template and is excluded.
+ */
+export declare const EXTENSIONS_CATALOG: readonly ExtensionDescriptor[];
+/** True when a descriptor carries a concrete version pin (drives the up-to-date / update decision). */
+export declare function hasVersion(descriptor: ExtensionDescriptor): boolean;
+/**
+ * Resolve a user-supplied `<id>` to a catalogue descriptor. Matches by `packageId`
+ * first (case-insensitively — UPM package names are lowercase by convention, and
+ * this is the install identity), then falls back to an exact case-insensitive `name`
+ * match for convenience (`unity-mcp-cli install-extension Tilemap`). Returns `null`
+ * when absent or `id` is empty.
+ */
+export declare function findExtension(id: string | undefined | null, catalog?: readonly ExtensionDescriptor[]): ExtensionDescriptor | null;

package/dist/utils/extensions-catalog.js

@@ -0,0 +1,197 @@
+// The CLI's typed mirror of the SHARED extension catalogue — the single source of
+// truth `Unity-MCP-Plugin/Packages/com.ivanmurzak.unity.mcp/extensions.catalog.json`
+// (see that file's sibling `extensions.catalog.md`).
+//
+// There are THREE artifacts holding this same list, and all three are kept in
+// lockstep by build-failing parity tests:
+//
+//   1. `extensions.catalog.json`        — the JSON source of truth, shipped in the UPM package.
+//   2. `MainWindowEditor._extensions`   — the C# array that drives the editor's Extensions
+//                                         section and `ExtensionPanel.AddToManifest`.
+//   3. `EXTENSIONS_CATALOG` (this file) — drives `installExtension` in this CLI.
+//
+// SINGLE SOURCE OF TRUTH: this constant MUST stay equivalent to the JSON. The parity
+// test `cli/tests/extensions-catalog-parity.test.ts` reads the JSON and FAILS the build
+// if this mirror drifts; `cli/tests/extensions-catalog-csharp-parity.test.ts` does the
+// same for the C# array. Adding an extension = appending an entry to the JSON, the C#
+// array, AND this array (both tests enforce it). This mirror exists so the published npm
+// package stays self-contained — no runtime `../Unity-MCP-Plugin` dependency.
+//
+// No top-level side effects; pure data + pure lookups only.
+/**
+ * The extension catalogue, single-sourced from
+ * `Unity-MCP-Plugin/Packages/com.ivanmurzak.unity.mcp/extensions.catalog.json`.
+ * Ten shipped extensions; `Unity-AI-Tools-Template` is a template and is excluded.
+ */
+export const EXTENSIONS_CATALOG = [
+    {
+        name: 'Animation',
+        description: 'AI-driven animation control and playback tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.animation',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Animation.git',
+        tools: [
+            { name: 'animation-create', description: 'Create AnimationClip assets with keyframes' },
+            { name: 'animation-get-data', description: 'Inspect clip curves, events, and properties' },
+            { name: 'animation-modify', description: 'Edit curves, events, and settings on a clip' },
+            { name: 'animator-create', description: 'Create AnimatorController assets' },
+            { name: 'animator-get-data', description: 'Inspect controller layers, states, and parameters' },
+            { name: 'animator-modify', description: 'Edit parameters, states, and transitions' },
+        ],
+    },
+    {
+        name: 'Cinemachine',
+        description: 'AI-assisted Cinemachine camera setup and configuration tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.cinemachine',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Cinemachine.git',
+        tools: [
+            { name: 'cinemachine-camera-create', description: 'Create a CinemachineCamera in the scene' },
+            { name: 'cinemachine-set-targets', description: 'Set the Follow and LookAt targets' },
+            { name: 'cinemachine-set-lens', description: 'Configure FOV, clip planes, and dutch' },
+            { name: 'cinemachine-set-body', description: 'Set the position-control component (Follow/Orbital/...)' },
+            { name: 'cinemachine-set-noise', description: 'Add camera shake via Perlin noise' },
+        ],
+    },
+    {
+        name: 'InputSystem',
+        description: 'AI-assisted Unity Input System authoring: InputActionAssets, maps, actions, bindings, and control schemes.',
+        packageId: 'com.ivanmurzak.unity.mcp.inputsystem',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-InputSystem.git',
+        tools: [
+            { name: 'inputsystem-asset-create', description: 'Create a new .inputactions InputActionAsset' },
+            { name: 'inputsystem-actionmap-add', description: 'Add an ActionMap to the asset' },
+            { name: 'inputsystem-action-add', description: 'Add an Action (type + expectedControlType)' },
+            { name: 'inputsystem-binding-add', description: 'Add a binding path to an Action' },
+            { name: 'inputsystem-binding-composite-add', description: 'Add a composite binding (2DVector/1DAxis)' },
+            { name: 'inputsystem-controlscheme-add', description: 'Add a control scheme with device requirements' },
+            { name: 'inputsystem-get', description: "Read the asset's maps, actions, and bindings" },
+        ],
+    },
+    {
+        name: 'Navigation',
+        description: 'AI-driven NavMesh navigation: surfaces, baking, agents, and links.',
+        packageId: 'com.ivanmurzak.unity.mcp.navigation',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Navigation.git',
+        tools: [
+            { name: 'navigation-surface-add', description: 'Add and configure a NavMeshSurface' },
+            { name: 'navigation-set-bake-settings', description: 'Set agent radius/height/slope/step and voxel size' },
+            { name: 'navigation-surface-bake', description: 'Bake or clear a NavMeshSurface' },
+            { name: 'navigation-modifier-add', description: 'Add a NavMeshModifier (override area / ignore)' },
+            { name: 'navigation-modifier-volume-add', description: 'Add a NavMeshModifierVolume' },
+            { name: 'navigation-link-add', description: 'Add a NavMeshLink between two points' },
+            { name: 'navigation-agent-add', description: 'Add and configure a NavMeshAgent' },
+            { name: 'navigation-agent-set-destination', description: "Set a NavMeshAgent's destination" },
+            { name: 'navigation-list', description: 'List NavMeshSurfaces and NavMeshAgents' },
+            { name: 'navigation-get', description: 'Serialize any NavMesh component' },
+            { name: 'navigation-modify', description: 'Modify any NavMesh component via ReflectorNet' },
+        ],
+    },
+    {
+        name: 'ParticleSystem',
+        description: 'AI-powered particle system creation and control tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.particlesystem',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-ParticleSystem.git',
+        tools: [
+            { name: 'particle-system-get', description: 'Inspect ParticleSystem modules and settings' },
+            { name: 'particle-system-modify', description: 'Modify emission, shape, color, noise, and more' },
+        ],
+    },
+    {
+        name: 'ProBuilder',
+        description: 'AI-assisted ProBuilder geometry modeling tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.probuilder',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-ProBuilder.git',
+        tools: [
+            { name: 'probuilder-create-shape', description: 'Create editable 3D primitives in the scene' },
+            { name: 'probuilder-get-mesh-info', description: 'Retrieve faces, vertices, and edges data' },
+            { name: 'probuilder-extrude', description: 'Extrude faces along their normals' },
+            { name: 'probuilder-delete-faces', description: 'Remove faces to create holes or trim geometry' },
+            { name: 'probuilder-set-face-material', description: 'Assign materials to individual faces' },
+        ],
+    },
+    {
+        name: 'Splines',
+        description: 'AI-assisted Spline authoring: containers, knots, tangents, and evaluation.',
+        packageId: 'com.ivanmurzak.unity.mcp.splines',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Splines.git',
+        tools: [
+            { name: 'splines-container-create', description: 'Create a SplineContainer in the scene' },
+            { name: 'splines-add-knot', description: 'Append a knot to a spline' },
+            { name: 'splines-set-knot', description: "Set a knot's position, tangents, and rotation" },
+            { name: 'splines-set-tangent-mode', description: "Set a knot's tangent mode" },
+            { name: 'splines-evaluate', description: 'Evaluate position/tangent/up along a spline' },
+            { name: 'splines-modify', description: 'Modify any Splines component via ReflectorNet' },
+        ],
+    },
+    {
+        name: 'Terrain',
+        description: 'AI-powered Unity Terrain authoring tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.terrain',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Terrain.git',
+        tools: [
+            { name: 'terrain-create', description: 'Create a Terrain GameObject backed by new TerrainData' },
+            { name: 'terrain-set-heights', description: 'Sculpt heightmap values over a region or the whole terrain' },
+            { name: 'terrain-paint-layer', description: 'Paint a TerrainLayer onto the alphamap (splatmap)' },
+            { name: 'terrain-place-trees', description: 'Scatter or place trees from a tree prototype' },
+            { name: 'terrain-set-neighbors', description: 'Stitch neighbor Terrains so Unity blends seams' },
+        ],
+    },
+    {
+        name: 'Tilemap',
+        description: 'AI-assisted 2D Tilemap creation, painting, and tile/RuleTile asset tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.tilemap',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Tilemap.git',
+        tools: [
+            { name: 'tilemap-create', description: 'Create a Grid + Tilemap + TilemapRenderer' },
+            { name: 'tilemap-set-tile', description: 'Paint a tile into a cell' },
+            { name: 'tilemap-box-fill', description: 'Fill a rectangular region with a tile' },
+            { name: 'tilemap-create-tile-asset', description: 'Create a Tile asset from a Sprite' },
+            { name: 'tilemap-create-rule-tile', description: 'Create a RuleTile asset (2D Tilemap Extras)' },
+        ],
+    },
+    {
+        name: 'Timeline',
+        description: 'AI-assisted Timeline cutscene and sequence authoring tools.',
+        packageId: 'com.ivanmurzak.unity.mcp.timeline',
+        version: null,
+        gitUrl: 'https://github.com/IvanMurzak/Unity-AI-Timeline.git',
+        tools: [
+            { name: 'timeline-create', description: 'Create a TimelineAsset (.playable)' },
+            { name: 'timeline-track-add', description: 'Add Animation/Activation/Audio/Signal/Control tracks' },
+            { name: 'timeline-clip-add', description: 'Add clips to a track with start and duration' },
+            { name: 'timeline-director-bind', description: 'Bind a TimelineAsset to a scene PlayableDirector' },
+            { name: 'timeline-modify', description: 'Modify any Timeline object via ReflectorNet' },
+        ],
+    },
+];
+/** True when a descriptor carries a concrete version pin (drives the up-to-date / update decision). */
+export function hasVersion(descriptor) {
+    return descriptor.version !== null && descriptor.version.trim() !== '';
+}
+/**
+ * Resolve a user-supplied `<id>` to a catalogue descriptor. Matches by `packageId`
+ * first (case-insensitively — UPM package names are lowercase by convention, and
+ * this is the install identity), then falls back to an exact case-insensitive `name`
+ * match for convenience (`unity-mcp-cli install-extension Tilemap`). Returns `null`
+ * when absent or `id` is empty.
+ */
+export function findExtension(id, catalog = EXTENSIONS_CATALOG) {
+    if (id === undefined || id === null)
+        return null;
+    const needle = id.trim();
+    if (needle === '')
+        return null;
+    const byPackageId = catalog.find((d) => d.packageId.toLowerCase() === needle.toLowerCase());
+    if (byPackageId)
+        return byPackageId;
+    return catalog.find((d) => d.name.toLowerCase() === needle.toLowerCase()) ?? null;
+}
+//# sourceMappingURL=extensions-catalog.js.map

package/dist/utils/extensions-catalog.js.map

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

package/dist/utils/manifest.d.ts

@@ -8,6 +8,23 @@ import { type LibLogger } from '../lib/logger.js';
  *   styled logger adapter explicitly to preserve the historical output.
  */
 export declare function resolveLatestVersion(logger?: LibLogger): Promise<string>;
+/**
+ * Resolve the latest version of ANY OpenUPM-hosted package (the plugin itself, or
+ * one of the catalogue extensions) from the OpenUPM registry. Throws an error with
+ * actionable suggestions if the network request fails.
+ *
+ * This is the generalisation of {@link resolveLatestVersion}: same 5000 ms
+ * `AbortController` abort, same "no cached fallback" behaviour, same actionable
+ * error — the only difference is that the package id is a parameter and the
+ * suggested escape-hatch flag is caller-supplied, because `install-plugin` offers
+ * `--plugin-version` where `install-extension` offers `--version`.
+ *
+ * @param packageId OpenUPM package id to resolve (e.g. `com.ivanmurzak.unity.mcp.tilemap`).
+ * @param logger Optional logger. Defaults to `silentLogger` so library callers stay
+ *   side-effect-free.
+ * @param versionFlag Name of the CLI flag suggested in the failure message.
+ */
+export declare function resolveLatestPackageVersion(packageId: string, logger?: LibLogger, versionFlag?: string): Promise<string>;
 /**
  * Determines if the version should be updated.
  * Only update if the new version is higher than the current version.
@@ -36,6 +53,27 @@ export interface AddPluginResult {
  *   styled logger adapter explicitly to preserve the historical output.
  */
 export declare function addPluginToManifest(projectPath: string, version: string, force?: boolean, logger?: LibLogger): AddPluginResult;
+/**
+ * Add ANY OpenUPM-hosted package to a Unity project's `Packages/manifest.json` —
+ * the plugin itself, or one of the catalogue extensions.
+ *
+ * This is the generalisation of {@link addPluginToManifest}, which now delegates
+ * here with `PACKAGE_ID`. Keeping ONE implementation matters because the
+ * scoped-registry rules (registry name, URL, and the `REQUIRED_SCOPES` pair
+ * `com.ivanmurzak` / `extensions.unity`) must be identical for the plugin and for
+ * every extension — the extensions live under the `com.ivanmurzak` scope, so an
+ * extension installed without that scope resolves against Unity's default registry
+ * and fails. It also mirrors the C# editor installer
+ * (`ExtensionPanel.AddToManifest` / `EnsureScopedRegistry`), which single-sources
+ * the same three constants on the Unity side.
+ *
+ * Behaviour (unchanged from the plugin-only version):
+ * - Adds the OpenUPM scoped registry with the required scopes when missing.
+ * - Adds/updates the package dependency.
+ * - When `force` is false (auto-resolved version): never downgrades.
+ * - When `force` is true (user-specified version): allows downgrade.
+ */
+export declare function addPackageToManifest(projectPath: string, packageId: string, version: string, force?: boolean, logger?: LibLogger): AddPluginResult;
 export interface RemovePluginResult {
     /** Whether the plugin was present and has been removed. */
     removed: boolean;

package/dist/utils/manifest.js

@@ -18,10 +18,29 @@ const REQUIRED_SCOPES = [
  *   styled logger adapter explicitly to preserve the historical output.
  */
 export async function resolveLatestVersion(logger = silentLogger) {
+    return resolveLatestPackageVersion(PACKAGE_ID, logger);
+}
+/**
+ * Resolve the latest version of ANY OpenUPM-hosted package (the plugin itself, or
+ * one of the catalogue extensions) from the OpenUPM registry. Throws an error with
+ * actionable suggestions if the network request fails.
+ *
+ * This is the generalisation of {@link resolveLatestVersion}: same 5000 ms
+ * `AbortController` abort, same "no cached fallback" behaviour, same actionable
+ * error — the only difference is that the package id is a parameter and the
+ * suggested escape-hatch flag is caller-supplied, because `install-plugin` offers
+ * `--plugin-version` where `install-extension` offers `--version`.
+ *
+ * @param packageId OpenUPM package id to resolve (e.g. `com.ivanmurzak.unity.mcp.tilemap`).
+ * @param logger Optional logger. Defaults to `silentLogger` so library callers stay
+ *   side-effect-free.
+ * @param versionFlag Name of the CLI flag suggested in the failure message.
+ */
+export async function resolveLatestPackageVersion(packageId, logger = silentLogger, versionFlag = '--plugin-version') {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 5000);
     try {
-        const res = await fetch(`https://package.openupm.com/${PACKAGE_ID}`, {
+        const res = await fetch(`https://package.openupm.com/${packageId}`, {
             signal: controller.signal,
             headers: { Accept: 'application/json' },
         });
@@ -34,14 +53,14 @@ export async function resolveLatestVersion(logger = silentLogger) {
             }
         }
         throw new Error(`OpenUPM returned status ${res.status}. ` +
-            'Check your network connection and retry, or specify a version manually with --plugin-version <version>');
+            `Check your network connection and retry, or specify a version manually with ${versionFlag} <version>`);
     }
     catch (err) {
-        if (err instanceof Error && err.message.includes('--plugin-version')) {
+        if (err instanceof Error && err.message.includes(versionFlag)) {
             throw err;
         }
-        throw new Error('Failed to resolve latest plugin version from OpenUPM. ' +
-            'Check your network connection and retry, or specify a version manually with --plugin-version <version>');
+        throw new Error(`Failed to resolve the latest version of ${packageId} from OpenUPM. ` +
+            `Check your network connection and retry, or specify a version manually with ${versionFlag} <version>`);
     }
     finally {
         clearTimeout(timeout);
@@ -80,6 +99,29 @@ export function shouldUpdateVersion(currentVersion, newVersion) {
  *   styled logger adapter explicitly to preserve the historical output.
  */
 export function addPluginToManifest(projectPath, version, force = false, logger = silentLogger) {
+    return addPackageToManifest(projectPath, PACKAGE_ID, version, force, logger);
+}
+/**
+ * Add ANY OpenUPM-hosted package to a Unity project's `Packages/manifest.json` —
+ * the plugin itself, or one of the catalogue extensions.
+ *
+ * This is the generalisation of {@link addPluginToManifest}, which now delegates
+ * here with `PACKAGE_ID`. Keeping ONE implementation matters because the
+ * scoped-registry rules (registry name, URL, and the `REQUIRED_SCOPES` pair
+ * `com.ivanmurzak` / `extensions.unity`) must be identical for the plugin and for
+ * every extension — the extensions live under the `com.ivanmurzak` scope, so an
+ * extension installed without that scope resolves against Unity's default registry
+ * and fails. It also mirrors the C# editor installer
+ * (`ExtensionPanel.AddToManifest` / `EnsureScopedRegistry`), which single-sources
+ * the same three constants on the Unity side.
+ *
+ * Behaviour (unchanged from the plugin-only version):
+ * - Adds the OpenUPM scoped registry with the required scopes when missing.
+ * - Adds/updates the package dependency.
+ * - When `force` is false (auto-resolved version): never downgrades.
+ * - When `force` is true (user-specified version): allows downgrade.
+ */
+export function addPackageToManifest(projectPath, packageId, version, force = false, logger = silentLogger) {
     const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
     if (!fs.existsSync(manifestPath)) {
         throw new Error(`manifest.json not found at: ${manifestPath}`);
@@ -119,15 +161,15 @@ export function addPluginToManifest(projectPath, version, force = false, logger
         manifest.dependencies = {};
         modified = true;
     }
-    const currentVersion = manifest.dependencies[PACKAGE_ID];
+    const currentVersion = manifest.dependencies[packageId];
     let resolvedVersion = version;
     if (!currentVersion || force || shouldUpdateVersion(currentVersion, version)) {
-        manifest.dependencies[PACKAGE_ID] = version;
+        manifest.dependencies[packageId] = version;
         modified = true;
     }
     else {
         resolvedVersion = currentVersion;
-        logger.info(`Plugin already at version ${currentVersion} (>= ${version}). Skipping version update. Use --plugin-version to force a specific version.`);
+        logger.info(`${packageId} already at version ${currentVersion} (>= ${version}). Skipping version update. Pass an explicit version to force a specific version.`);
     }
     // --- Write back
     if (modified) {

package/dist/utils/manifest.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-mcp-cli",
-  "version": "0.88.0",
+  "version": "0.90.0",
   "description": "Cross-platform CLI tool for AI Game Developer (Skills & MCP). Full AI develop and test loop. Efficient token usage, advanced tools. Creates Unity project, installs plugins, configures tools, and manages HTTP connection with Unity Editor and a game made with Unity. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.",
   "type": "module",
   "main": "dist/lib.js",