@atelierai/uco 1.0.0

package/dist/devops/lib/setup-mcp.js

@@ -0,0 +1,172 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { generatePortFromDirectory } from '../utils/port.js';
+import { readConfig, resolveConnectionFromConfig } from '../utils/config.js';
+import { getAgentById, getAgentIds, resolveServerBinaryPath, writeJsonAgentConfig, writeTomlAgentConfig, MCP_SERVER_NAME, } from '../utils/agents.js';
+import { emitProgress } from './progress.js';
+import { requireExistingPath } from './validation.js';
+function isValidTransport(t) {
+    return t === 'stdio' || t === 'http';
+}
+/**
+ * Extract a port from a `host` URL string, falling back to the
+ * project-directory-derived deterministic port on any parse failure.
+ */
+function portFromHost(host, projectPath) {
+    if (!host)
+        return generatePortFromDirectory(projectPath);
+    try {
+        return parseInt(new URL(host).port, 10) || generatePortFromDirectory(projectPath);
+    }
+    catch {
+        return generatePortFromDirectory(projectPath);
+    }
+}
+/**
+ * Compute the managed MCP server entry an agent's config should carry for a
+ * project, from the project's live `UserSettings/uco-config.json`
+ * (the same resolution `setupMcp` performs). Shared by `setupMcp` and
+ * `uco update`'s reconciliation so both always write the same entry.
+ */
+export function computeAgentMcpProps(agent, projectPath, overrides = {}) {
+    const config = readConfig(projectPath);
+    const fromConfig = config
+        ? resolveConnectionFromConfig(config)
+        : { url: undefined, token: undefined };
+    const port = portFromHost(config?.host, projectPath);
+    const auth = config?.authOption ?? 'none';
+    const token = overrides.token ?? fromConfig.token ?? '';
+    const authRequired = auth === 'required';
+    // Resolve URL — explicit override, then config, then deterministic
+    // localhost fallback. Trailing slash stripped.
+    const serverUrl = (overrides.url ?? fromConfig.url ?? `http://localhost:${port}`).replace(/\/$/, '');
+    const configPath = agent.getConfigPath(projectPath);
+    const props = agent.getHttpProps(serverUrl, token, authRequired);
+    return { configPath, props, removeKeys: agent.httpRemoveKeys };
+}
+/**
+ * Write MCP configuration for the given AI agent, so it can talk to
+ * Unity-MCP. Library-safe: no stdout noise, no process.exit, no throws
+ * past the public boundary.
+ *
+ * The returned `SetupMcpResult` is a discriminated union — narrow with
+ * `result.kind === 'success'` to access `agentId` / `configPath` /
+ * `transport`, or `result.kind === 'failure'` to access `error`.
+ */
+export async function setupMcp(opts) {
+    const warnings = [];
+    const nextSteps = [];
+    try {
+        if (!opts || typeof opts.agentId !== 'string' || opts.agentId.length === 0) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                nextSteps,
+                error: new Error(`agentId is required. Available agent IDs: ${getAgentIds().join(', ')}`),
+            };
+        }
+        const agent = getAgentById(opts.agentId);
+        if (!agent) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                nextSteps,
+                error: new Error(`Unknown agent: "${opts.agentId}". Available agent IDs: ${getAgentIds().join(', ')}`),
+            };
+        }
+        const transport = opts.transport ?? 'http';
+        if (!isValidTransport(transport)) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                nextSteps,
+                error: new Error(`Invalid transport: "${transport}". Must be "stdio" or "http".`),
+            };
+        }
+        // Resolve project path. If the caller supplied one explicitly it
+        // must exist; otherwise fall back to cwd (matches CLI behaviour).
+        let projectPath;
+        if (opts.unityProjectPath) {
+            const validated = requireExistingPath(opts.unityProjectPath);
+            if (!validated.ok) {
+                return { kind: 'failure', success: false, warnings, nextSteps, error: validated.error };
+            }
+            projectPath = validated.projectPath;
+        }
+        else {
+            projectPath = path.resolve(process.cwd());
+        }
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Configuring ${agent.name} (${transport}) for ${projectPath}`,
+        });
+        const config = readConfig(projectPath);
+        const configPath = agent.getConfigPath(projectPath);
+        const serverPath = resolveServerBinaryPath(projectPath).replace(/\\/g, '/');
+        let props;
+        let removeKeys;
+        if (transport === 'stdio') {
+            const port = portFromHost(config?.host, projectPath);
+            const timeout = config?.timeoutMs ?? 10000;
+            const auth = config?.authOption ?? 'none';
+            const fromConfig = config
+                ? resolveConnectionFromConfig(config)
+                : { url: undefined, token: undefined };
+            const token = opts.token ?? fromConfig.token ?? '';
+            props = agent.getStdioProps(serverPath, port, timeout, auth, token);
+            removeKeys = agent.stdioRemoveKeys;
+        }
+        else {
+            const computed = computeAgentMcpProps(agent, projectPath, {
+                ...(opts.url ? { url: opts.url } : {}),
+                ...(opts.token ? { token: opts.token } : {}),
+            });
+            props = computed.props;
+            removeKeys = computed.removeKeys;
+        }
+        if (agent.configFormat === 'toml') {
+            writeTomlAgentConfig(configPath, agent.bodyPath, MCP_SERVER_NAME, props, removeKeys);
+        }
+        else {
+            writeJsonAgentConfig(configPath, agent.bodyPath, MCP_SERVER_NAME, props, removeKeys);
+        }
+        emitProgress(opts.onProgress, {
+            phase: 'manifest-patched',
+            message: `Wrote ${configPath}`,
+            manifestPath: configPath,
+        });
+        if (transport === 'stdio' && !fs.existsSync(serverPath.replace(/\//g, path.sep))) {
+            warnings.push('Server binary not found. Open Unity with the MCP plugin to download it automatically.');
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: `${agent.name} configured successfully.` });
+        return {
+            kind: 'success',
+            success: true,
+            agentId: agent.id,
+            configPath,
+            transport,
+            warnings,
+            nextSteps,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            nextSteps,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/**
+ * List every agent id known to the `setupMcp` function. Useful for
+ * consumer UIs that want to render a picker.
+ */
+export function listAgentIds() {
+    return getAgentIds();
+}
+//# sourceMappingURL=setup-mcp.js.map

package/dist/devops/lib/setup-mcp.js.map

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

package/dist/devops/lib/setup-unity-cli.d.ts

@@ -0,0 +1,129 @@
+import { CliError } from '../../util/errors.js';
+import { type UnityCliProcessAdapter } from '../utils/unity-cli.js';
+export declare const UNITY_CLI_INSTALLER_HOST = "public-cdn.cloud.unity3d.com";
+export declare const UNITY_CLI_SETUP_MAX_DOWNLOAD_BYTES: number;
+export declare const UNITY_CLI_SETUP_MAX_OUTPUT_BYTES: number;
+export declare const UNITY_CLI_SETUP_DOWNLOAD_TIMEOUT_MS = 30000;
+export declare const UNITY_CLI_SETUP_PROCESS_TIMEOUT_MS: number;
+export declare const UNITY_CLI_SETUP_MAX_REDIRECTS = 5;
+export interface UnityCliInstallerMetadata {
+    url: string;
+    scriptName: 'install.ps1' | 'install.sh';
+    executor: 'powershell' | 'bash';
+    args: readonly string[];
+}
+export declare const UNITY_CLI_SETUP_INSTALLERS: Readonly<Partial<Record<NodeJS.Platform, UnityCliInstallerMetadata>>>;
+export type SetupUnityCliErrorKind = 'invalid-unity-cli-path' | 'unsupported-platform' | 'executor-not-found' | 'approval-required' | 'download-failed' | 'unsafe-response' | 'temporary-file-failed' | 'spawn-failed' | 'process-failed' | 'output-too-large' | 'timeout' | 'aborted';
+export interface SetupUnityCliErrorFields {
+    kind: SetupUnityCliErrorKind;
+    message: string;
+    cause?: unknown;
+    status?: number;
+    stdout?: string;
+    stderr?: string;
+    installerMayHaveChangedMachine?: boolean;
+}
+export declare class SetupUnityCliError extends CliError {
+    readonly kind: SetupUnityCliErrorKind;
+    readonly status: number | undefined;
+    readonly stdout: string | undefined;
+    readonly stderr: string | undefined;
+    readonly installerMayHaveChangedMachine: boolean;
+    constructor(fields: SetupUnityCliErrorFields);
+    toJSON(): Record<string, unknown>;
+}
+export interface SetupUnityCliPlan {
+    platform: NodeJS.Platform;
+    installerUrl: string;
+    executor: string;
+    executorArgs: readonly string[];
+    environment: {
+        UNITY_CLI_CHANNEL: 'beta';
+    };
+    discovery: {
+        status: 'candidate-discovered';
+        executable: string;
+        verified: false;
+        verification: 'planned: bounded unity --version outside dry-run';
+    } | {
+        status: 'not-found';
+        executable: null;
+        verified: false;
+        verification: 'not-applicable';
+    };
+    verification: 'rediscover executable and run unity --version';
+}
+export type SetupUnityCliResult = {
+    success: true;
+    status: 'already-installed';
+    verified: true;
+    executable: string;
+    version: string;
+} | {
+    success: true;
+    status: 'planned';
+    dryRun: true;
+    plan: SetupUnityCliPlan;
+} | {
+    success: true;
+    status: 'cancelled';
+    installed: false;
+} | {
+    success: true;
+    status: 'installed';
+    verified: true;
+    executable: string;
+    version: string;
+} | {
+    success: true;
+    status: 'installed-restart-required';
+    verified: false;
+    nextSteps: readonly string[];
+};
+export interface SetupUnityCliOptions {
+    yes?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    interactive?: boolean;
+    signal?: AbortSignal;
+    onProgress?: (message: string) => void;
+}
+export interface SetupFetchResponse {
+    ok: boolean;
+    status: number;
+    url: string;
+    location?: string;
+    contentLength?: number;
+    body: AsyncIterable<Uint8Array> | null;
+}
+export type SetupFetchAdapter = (url: string, options: {
+    signal: AbortSignal;
+}) => Promise<SetupFetchResponse>;
+export interface SetupUnityCliDependencies {
+    platform: NodeJS.Platform;
+    environment: NodeJS.ProcessEnv;
+    findUnityCli(): string | null;
+    getUnityCliVersion(): string | null;
+    resolveExecutor(platform: NodeJS.Platform, environment: NodeJS.ProcessEnv): string | null;
+    prompt(message: string, signal?: AbortSignal): Promise<boolean>;
+    fetchInstaller: SetupFetchAdapter;
+    processAdapter: UnityCliProcessAdapter;
+    createTempDirectory(): Promise<string>;
+    writeInstaller(filePath: string, content: Uint8Array): Promise<void>;
+    removeTempDirectory(directory: string): Promise<void>;
+    limits: {
+        downloadBytes: number;
+        downloadTimeoutMs: number;
+        processOutputBytes: number;
+        processTimeoutMs: number;
+    };
+}
+/** Build the minimal documented environment inherited by Unity's installer. */
+export declare function createInstallerEnvironment(environment: NodeJS.ProcessEnv, platform: NodeJS.Platform): NodeJS.ProcessEnv;
+/** The currently documented beta CLI emits a bare SemVer `x.y.z-beta.n`. */
+export declare function isOfficialUnityCliVersion(value: string): boolean;
+/**
+ * Discover, explicitly approve, acquire, run, and verify Unity's official CLI
+ * installer. All external behavior has a production/test shared adapter seam.
+ */
+export declare function setupUnityCli(options?: SetupUnityCliOptions, dependencies?: SetupUnityCliDependencies): Promise<SetupUnityCliResult>;