@atelierai/uco 1.0.0

package/dist/devops/commands-upstream/wait-for-ready.js

@@ -0,0 +1,93 @@
+import { Command } from 'commander';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { resolveAndValidateProjectPath, resolveConnection } from '../utils/connection.js';
+import { generatePortFromDirectory } from '../utils/port.js';
+import { probe } from '../utils/probe.js';
+const MAX_PROBE_TIMEOUT_MS = 10_000;
+/**
+ * Build the list of base URLs to probe.
+ * When --url is explicit, only that URL is probed.
+ * Otherwise, probe both the config-resolved URL and the deterministic local port
+ * (if they differ), succeeding on whichever responds first.
+ */
+function resolveProbeUrls(projectPath, options) {
+    const { url: configUrl } = resolveConnection(projectPath, options);
+    const urls = [configUrl];
+    if (!options.url) {
+        const localPort = generatePortFromDirectory(projectPath);
+        const localUrl = `http://localhost:${localPort}`;
+        if (localUrl !== configUrl) {
+            urls.push(localUrl);
+            verbose(`Will probe both config URL (${configUrl}) and local URL (${localUrl})`);
+        }
+    }
+    return urls;
+}
+export const waitForReadyCommand = new Command('wait-for-ready')
+    .description('Wait until Unity Editor and MCP server are ready to accept tool calls')
+    .argument('[path]', 'Unity project path (used for config and auto port detection)')
+    .option('--path <path>', 'Unity project path (config and auto port detection)')
+    .option('--url <url>', 'Direct server URL override (bypasses config)')
+    .option('--token <token>', 'Bearer token override (bypasses config)')
+    .option('--timeout <ms>', 'Maximum time to wait in milliseconds (default: 120000)', '120000')
+    .option('--interval <ms>', 'Polling interval in milliseconds (default: 3000)', '3000')
+    .action(async (positionalPath, options) => {
+    const projectPath = resolveAndValidateProjectPath(positionalPath, options);
+    const { token } = resolveConnection(projectPath, options);
+    const probeUrls = resolveProbeUrls(projectPath, options);
+    const timeoutMs = parseInt(options.timeout ?? '120000', 10);
+    const intervalMs = parseInt(options.interval ?? '3000', 10);
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        ui.error(`Invalid --timeout value: "${options.timeout}". Must be a positive integer (milliseconds).`);
+        process.exit(1);
+    }
+    if (!Number.isFinite(intervalMs) || intervalMs <= 0) {
+        ui.error(`Invalid --interval value: "${options.interval}". Must be a positive integer (milliseconds).`);
+        process.exit(1);
+    }
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    for (const url of probeUrls) {
+        verbose(`Probe target: ${url}`);
+    }
+    verbose(`Timeout: ${timeoutMs}ms, Interval: ${intervalMs}ms`);
+    const spinner = ui.startSpinner('Waiting for Unity Editor and MCP server...');
+    const startTime = Date.now();
+    while (true) {
+        const elapsed = Date.now() - startTime;
+        if (elapsed >= timeoutMs) {
+            spinner.error(`Timed out after ${(timeoutMs / 1000).toFixed(1)}s waiting for MCP server`);
+            process.exit(1);
+        }
+        const remaining = Math.ceil((timeoutMs - elapsed) / 1000);
+        spinner.text = `Waiting for Unity Editor and MCP server... (${remaining}s remaining)`;
+        const probeTimeout = Math.min(intervalMs, MAX_PROBE_TIMEOUT_MS);
+        // Race probes: resolve as soon as any succeeds, don't wait for slow ones
+        const ready = await new Promise(resolve => {
+            let pending = probeUrls.length;
+            for (const url of probeUrls) {
+                probe(url, headers, probeTimeout).then(result => {
+                    if (result.ok)
+                        resolve(result);
+                    else if (--pending === 0)
+                        resolve(null);
+                });
+            }
+        });
+        if (ready?.ok) {
+            const totalSeconds = ((Date.now() - startTime) / 1000).toFixed(1);
+            spinner.success(`MCP server is ready at ${ready.baseUrl} (connected in ${totalSeconds}s)`);
+            process.exit(0);
+        }
+        const remainingMs = timeoutMs - (Date.now() - startTime);
+        if (remainingMs <= 0)
+            continue;
+        await new Promise(resolve => setTimeout(resolve, Math.min(intervalMs, remainingMs)));
+    }
+});
+//# sourceMappingURL=wait-for-ready.js.map

package/dist/devops/commands-upstream/wait-for-ready.js.map

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

package/dist/devops/lib/configure.d.ts

@@ -0,0 +1,14 @@
+import type { ConfigureOptions, ConfigureResult } from './types.js';
+/**
+ * Configure Unity-MCP features (tools / prompts / resources) for a
+ * Unity project. Library-safe: no stdout noise, no process.exit.
+ *
+ * If none of `tools`/`prompts`/`resources` are supplied, the call is a
+ * read-only "create-if-missing and return snapshot" — mirrors the CLI's
+ * `--list` behaviour minus the rendering.
+ *
+ * The returned `ConfigureResult` is a discriminated union — narrow with
+ * `result.kind === 'success'` to access `configPath` / `snapshot`, or
+ * `result.kind === 'failure'` to access `error`.
+ */
+export declare function configure(opts: ConfigureOptions): Promise<ConfigureResult>;

package/dist/devops/lib/configure.js

@@ -0,0 +1,91 @@
+import * as path from 'path';
+import { getOrCreateConfig, writeConfig, updateFeatures, } from '../utils/config.js';
+import { emitProgress } from './progress.js';
+import { requireExistingPath } from './validation.js';
+const CONFIG_RELATIVE_PATH = 'UserSettings/uco-config.json';
+function hasAnyAction(action) {
+    if (!action)
+        return false;
+    return ((Array.isArray(action.enableNames) && action.enableNames.length > 0) ||
+        (Array.isArray(action.disableNames) && action.disableNames.length > 0) ||
+        action.enableAll === true ||
+        action.disableAll === true);
+}
+function snapshotFeatures(config, key) {
+    const raw = config[key];
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((f) => typeof f === 'object' && f !== null && typeof f.name === 'string' && typeof f.enabled === 'boolean')
+        .map((f) => ({ name: f.name, enabled: f.enabled }));
+}
+/**
+ * Configure Unity-MCP features (tools / prompts / resources) for a
+ * Unity project. Library-safe: no stdout noise, no process.exit.
+ *
+ * If none of `tools`/`prompts`/`resources` are supplied, the call is a
+ * read-only "create-if-missing and return snapshot" — mirrors the CLI's
+ * `--list` behaviour minus the rendering.
+ *
+ * The returned `ConfigureResult` is a discriminated union — narrow with
+ * `result.kind === 'success'` to access `configPath` / `snapshot`, or
+ * `result.kind === 'failure'` to access `error`.
+ */
+export async function configure(opts) {
+    const warnings = [];
+    try {
+        const validated = requireExistingPath(opts?.unityProjectPath);
+        if (!validated.ok) {
+            return { kind: 'failure', success: false, warnings, error: validated.error };
+        }
+        const { projectPath } = validated;
+        const configPath = path.join(projectPath, CONFIG_RELATIVE_PATH);
+        emitProgress(opts.onProgress, { phase: 'start', message: `Configuring Unity-MCP features for ${projectPath}` });
+        const config = getOrCreateConfig(projectPath);
+        const hasToolsAction = hasAnyAction(opts.tools);
+        const hasPromptsAction = hasAnyAction(opts.prompts);
+        const hasResourcesAction = hasAnyAction(opts.resources);
+        if (hasToolsAction) {
+            updateFeatures(config, 'tools', opts.tools);
+        }
+        if (hasPromptsAction) {
+            updateFeatures(config, 'prompts', opts.prompts);
+        }
+        if (hasResourcesAction) {
+            updateFeatures(config, 'resources', opts.resources);
+        }
+        if (hasToolsAction || hasPromptsAction || hasResourcesAction) {
+            writeConfig(projectPath, config);
+            emitProgress(opts.onProgress, {
+                phase: 'manifest-patched',
+                message: `Wrote ${configPath}`,
+                manifestPath: configPath,
+            });
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: 'Configure complete.' });
+        return {
+            kind: 'success',
+            success: true,
+            configPath,
+            snapshot: {
+                host: typeof config.host === 'string' ? config.host : undefined,
+                keepConnected: typeof config.keepConnected === 'boolean' ? config.keepConnected : undefined,
+                transportMethod: typeof config.transportMethod === 'string' ? config.transportMethod : undefined,
+                authOption: typeof config.authOption === 'string' ? config.authOption : undefined,
+                tools: snapshotFeatures(config, 'tools'),
+                prompts: snapshotFeatures(config, 'prompts'),
+                resources: snapshotFeatures(config, 'resources'),
+            },
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+//# sourceMappingURL=configure.js.map

package/dist/devops/lib/configure.js.map

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

package/dist/devops/lib/install-plugin.d.ts

@@ -0,0 +1,18 @@
+import { inspectPluginManifest, type AddPluginResult } from '../utils/manifest.js';
+import type { InstallPluginOptions, InstallResult } from './types.js';
+/**
+ * Install the Unity-MCP plugin into a Unity project. Library-safe:
+ * never calls `process.exit`, never prints to stdout / stderr, never
+ * throws past the public boundary — errors are returned in
+ * `{ kind: 'failure', success: false, error }`.
+ *
+ * The returned `InstallResult` is a discriminated union — narrow with
+ * `result.kind === 'success'` to access `installedVersion` /
+ * `manifestPath`, or `result.kind === 'failure'` to access `error`.
+ */
+export interface InstallPluginDependencies {
+    resolveLatestVersion(): Promise<string>;
+    inspectManifest(projectPath: string): ReturnType<typeof inspectPluginManifest>;
+    addToManifest(projectPath: string, version: string, force: boolean): AddPluginResult;
+}
+export declare function installPlugin(opts: InstallPluginOptions, dependencies?: InstallPluginDependencies): Promise<InstallResult>;

package/dist/devops/lib/install-plugin.js

@@ -0,0 +1,115 @@
+import { addPluginToManifest, inspectPluginManifest, resolveLatestVersion, } from '../utils/manifest.js';
+import { silentLogger } from './logger.js';
+import { emitProgress } from './progress.js';
+import { requireUnityProject } from './validation.js';
+import { isValidVersion, isNewerVersion } from '../utils/semver.js';
+const productionDependencies = {
+    resolveLatestVersion: () => resolveLatestVersion(silentLogger),
+    inspectManifest: inspectPluginManifest,
+    addToManifest: (projectPath, version, force) => (addPluginToManifest(projectPath, version, force, silentLogger)),
+};
+export async function installPlugin(opts, dependencies = productionDependencies) {
+    const warnings = [];
+    const nextSteps = [];
+    try {
+        const validated = requireUnityProject(opts?.unityProjectPath);
+        if (!validated.ok) {
+            return {
+                kind: 'failure',
+                success: false,
+                manifestPath: validated.manifestPath,
+                warnings,
+                nextSteps,
+                error: validated.error,
+            };
+        }
+        const { projectPath } = validated;
+        emitProgress(opts.onProgress, { phase: 'start', message: `Installing Unity-MCP plugin into ${projectPath}` });
+        let version = opts.version?.trim();
+        const isExplicitVersion = !!version;
+        if (!version) {
+            const inspection = dependencies.inspectManifest(projectPath);
+            if (inspection.activeSourceIsNonSemver && inspection.activeSource !== undefined) {
+                version = inspection.activeSource;
+            }
+            else {
+                version = await dependencies.resolveLatestVersion();
+                if (typeof version !== 'string'
+                    || version !== version.trim()
+                    || /[\u0000-\u001f\u007f]/.test(version)
+                    || !isValidVersion(version)) {
+                    throw new Error('OpenUPM returned an invalid latest plugin version. '
+                        + 'Retry, or run `uco install-plugin <project> --version <version>`.');
+                }
+                emitProgress(opts.onProgress, {
+                    phase: 'dependencies-resolved',
+                    message: `Resolved latest plugin version: ${version}`,
+                    version,
+                });
+            }
+        }
+        if (opts.dryRun === true) {
+            // Plan-only mode: report exactly what a real run would write — the
+            // resolved target version and the manifest patch — without touching
+            // the manifest. The no-downgrade comparison is reported from the
+            // inspection snapshot instead of the write path.
+            const inspection = dependencies.inspectManifest(projectPath);
+            if (inspection.activeSource !== undefined
+                && inspection.activeSource !== version
+                && !isExplicitVersion
+                && !inspection.activeSourceIsNonSemver
+                && isNewerVersion(inspection.activeSource, version)) {
+                warnings.push(`Plugin already at version ${inspection.activeSource} (>= ${version}); a real run would keep it. ` +
+                    'Run `uco install-plugin <project> --version <version>` to force a specific value.');
+            }
+            nextSteps.push('Re-run without --dry-run to apply the planned manifest patch.');
+            emitProgress(opts.onProgress, { phase: 'done', message: 'Dry run complete — nothing written.' });
+            return {
+                kind: 'success',
+                success: true,
+                installedVersion: version,
+                manifestPath: inspection.manifestPath,
+                modified: false,
+                warnings,
+                nextSteps,
+                dryRun: true,
+                plannedActions: [
+                    { action: 'manifest-patch', path: inspection.manifestPath, version },
+                ],
+            };
+        }
+        const result = dependencies.addToManifest(projectPath, version, isExplicitVersion);
+        if (result.resolvedVersion !== version && !isExplicitVersion) {
+            warnings.push(`Plugin already at version ${result.resolvedVersion} (>= ${version}). ` +
+                'Skipping version update. Run `uco install-plugin <project> --version <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,
+        });
+        nextSteps.push('Open the Unity project in the Editor to complete installation.');
+        emitProgress(opts.onProgress, { phase: 'done', message: 'Install complete.' });
+        return {
+            kind: 'success',
+            success: true,
+            installedVersion: result.resolvedVersion,
+            manifestPath: result.manifestPath,
+            modified: result.modified,
+            warnings,
+            nextSteps,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            nextSteps,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+//# sourceMappingURL=install-plugin.js.map

package/dist/devops/lib/install-plugin.js.map

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

package/dist/devops/lib/install.d.ts

@@ -0,0 +1,35 @@
+import type { InstallAllOptions, InstallAllResult, PluginSource } from './types.js';
+/**
+ * Install the Unity-MCP toolchain into a target Unity project.
+ *
+ * This is the single end-user entry point. After it completes, the user
+ * opens Unity once and the Plugin auto-starts the Node.js MCP server with
+ * the correct token + port.
+ */
+export declare function installAll(opts: InstallAllOptions): Promise<InstallAllResult>;
+/**
+ * Whether the plugin surface at the target differs from what the given source
+ * would produce: the `Packages/manifest.json` dependency value (including
+ * legacy package ids) or — for embed staging — any file of the mirrored
+ * package source that is missing or byte-different at the target. Used by
+ * refresh mode to gate the lockfile reset and to detect hand-edited drift.
+ * Exported for `uco update`'s needs-refresh pre-check (matched-set heal).
+ */
+export declare function pluginSurfaceDiffers(projectPath: string, source: PluginSource): boolean;
+/**
+ * Directories under `Packages/` that look like copies or backups of the uco
+ * package directory (the package id prefix) other than the live embedded copy.
+ * Reported as warnings only — uco never deletes them. On Windows the
+ * comparison is case-insensitive to match the filesystem (a
+ * `Com.Atelierai.unity.copilot.bak` sibling would otherwise escape the
+ * advisory).
+ */
+export declare function detectPackageSiblings(projectPath: string): string[];
+/**
+ * Whether the staged NuGet set differs from what is installed under
+ * `Assets/Plugins/NuGet/`: any non-`.meta` file missing or byte-different.
+ * Existing `.meta` files count as in sync regardless of content — staging
+ * preserves target GUIDs, so a differing `.meta` is expected, not drift.
+ * Exported for `uco update`'s needs-refresh pre-check.
+ */
+export declare function nugetSurfaceDiffers(stagedNugetPath: string, projectPath: string): boolean;