@atelierai/uco 1.0.0

package/dist/commands/install.js

@@ -0,0 +1,161 @@
+// uco install — end-user-facing single-shot install into a Unity project.
+//
+// Stages the artifacts needed for the forked (Phase B) toolchain:
+//   - Plugin (UPM package) — via file:, git, or embedded source
+//   - NuGet DLLs   — copied to <target>/Assets/Plugins/NuGet/ (.meta-preserving)
+//   - Initial config — UserSettings/uco-config.json (if missing)
+//
+// The tool server itself is not staged: the Unity plugin auto-starts the
+// Node.js MCP server (uco) on launch, so no server binaries live in the
+// project.
+//
+// Wraps `devops/lib/install.installAll`.
+import path from 'node:path';
+import kleur from 'kleur';
+import { runCommand } from '../util/cli-context.js';
+import { CliError } from '../util/errors.js';
+import { installAll } from '../devops/lib/install.js';
+import { resolveProjectArg, progressLogger, unwrapResult } from './devops/_helpers.js';
+import { UCO_UNITY_PACKAGE_ID } from '../devops/utils/manifest.js';
+import { hasVendorPlugin, resolveDefaultNugetSource, resolveDefaultPluginSource, vendorPath, } from '../devops/utils/vendor.js';
+import { UNITY_SOURCE_BUNDLE, recordUnityInInstallManifest, } from '../skills/install-manifest.js';
+export function registerInstall(program) {
+    program
+        .command('install [project]')
+        .description('Install the Unity-MCP toolchain into a Unity project (Plugin UPM + NuGet DLLs + initial config). One-shot, idempotent.')
+        .option('--from-file <path>', 'Plugin source: local file: path (default: workspace-relative fork)')
+        .option('--from-git <url>', 'Plugin source: git URL (alternative to --from-file)')
+        .option('--embed', 'Plugin source: copy package source into <target>/Packages/ (offline)')
+        .option('--dry-run', 'Print planned actions without writing anything')
+        .option('--skip-nuget', 'Do not stage the NuGet DLLs')
+        .option('--skip-plugin', 'Do not patch Packages/manifest.json')
+        .option('--skip-config', 'Do not initialise UserSettings config')
+        .option('--overwrite-config', 'Re-create UserSettings config even if it exists')
+        .option('--nuget-dir <path>', 'Override staged NuGet folder (default: <workspace>/dist/nuget/)')
+        .action(function (projectArg, opts) {
+        return runCommand(this, async (ctx) => {
+            const projectPath = resolveProjectArg(ctx, projectArg);
+            const pluginSource = resolvePluginSource(opts);
+            // Default artifact sources, in priority order:
+            //   1. explicit --nuget-dir override
+            //   2. bundled vendor/ (self-contained tgz install — `npm i -g uco.tgz`)
+            //   3. dev workspace dist/ (local checkout fallback)
+            // vendor/ lets a globally-installed uco stage artifacts with no workspace present.
+            const stagedNugetPath = path.resolve(opts.nugetDir ?? resolveDefaultNugetSource());
+            const callOpts = {
+                unityProjectPath: projectPath,
+                pluginSource,
+                stagedNugetPath,
+                dryRun: Boolean(opts.dryRun),
+                skipNuget: Boolean(opts.skipNuget),
+                skipPlugin: Boolean(opts.skipPlugin),
+                skipConfig: Boolean(opts.skipConfig),
+                overwriteConfig: Boolean(opts.overwriteConfig),
+                onProgress: progressLogger(ctx),
+            };
+            const result = await installAll(callOpts);
+            const unwrapped = unwrapResult(result);
+            // Record the Unity toolchain surface in the install manifest so
+            // `uco update` knows this project is uco-installed (and how the
+            // plugin is sourced). Fails open: a manifest problem never fails an
+            // otherwise-successful install.
+            if (result.kind === 'success' && !result.dryRun) {
+                const record = recordUnityInInstallManifest(projectPath, {
+                    installed: opts.skipPlugin !== true,
+                    source: describePluginSourceKind(pluginSource),
+                    projectPath,
+                });
+                if ('warning' in record && result.kind === 'success') {
+                    result.warnings.push(record.warning);
+                }
+            }
+            // Human pretty-print (suppressed under --json by printResult).
+            if (!ctx.output.json) {
+                printHumanSummary(result);
+                return undefined; // already printed
+            }
+            return unwrapped;
+        })();
+    });
+}
+/** Map the plugin source actually used onto the manifest's `unity.source` value. */
+function describePluginSourceKind(source) {
+    switch (source.kind) {
+        case 'embed':
+            return UNITY_SOURCE_BUNDLE;
+        case 'file':
+            return `file:${source.path}`;
+        case 'git':
+            return `git:${source.url}`;
+    }
+}
+function resolvePluginSource(opts) {
+    const explicitSources = [opts.fromFile, opts.fromGit, opts.embed].filter(Boolean).length;
+    if (explicitSources > 1) {
+        throw new CliError('Choose at most one of --from-file, --from-git, --embed.', 'invalid-flags');
+    }
+    if (opts.fromGit) {
+        return { kind: 'git', url: opts.fromGit };
+    }
+    if (opts.fromFile) {
+        return { kind: 'file', path: path.resolve(opts.fromFile) };
+    }
+    // Plugin source candidates, in priority order:
+    //   1. bundled vendor/plugin/<id>  (self-contained tgz install) — preferred
+    //   2. workspace fork              (dev checkout)
+    const hasVendor = hasVendorPlugin();
+    const defaultPluginPath = resolveDefaultPluginSource();
+    if (opts.embed) {
+        return { kind: 'embed', sourcePath: defaultPluginPath };
+    }
+    // No explicit flag: a vendor install defaults to embed (the Unity project then
+    // owns its own plugin copy under Packages/ and survives uco uninstall/upgrade);
+    // a dev-workspace install keeps the historical file: default.
+    if (hasVendor) {
+        return { kind: 'embed', sourcePath: vendorPath('plugin', UCO_UNITY_PACKAGE_ID) };
+    }
+    return { kind: 'file', path: path.resolve(defaultPluginPath) };
+}
+function printHumanSummary(result) {
+    if (result.kind === 'failure') {
+        // The CliError thrown by unwrapResult already aborts; this branch
+        // is only reachable in --json mode (which short-circuits above).
+        return;
+    }
+    const out = process.stderr;
+    const w = (s) => { out.write(s + '\n'); };
+    if (result.dryRun) {
+        w(kleur.bold().yellow('uco install — DRY RUN (no files written)'));
+    }
+    else {
+        w(kleur.bold().green('uco install — done'));
+    }
+    w(kleur.gray(`  project : ${result.unityProjectPath}`));
+    if (result.actions.length > 0) {
+        w('');
+        w(kleur.bold('Actions:'));
+        for (const a of result.actions) {
+            const target = a.target ? kleur.gray(` -> ${a.target}`) : '';
+            w(`  ${kleur.cyan(a.kind.padEnd(18))} ${a.detail}${target}`);
+        }
+    }
+    if (!result.dryRun && result.summary.length > 0) {
+        w('');
+        w(kleur.bold('Summary:'));
+        for (const s of result.summary)
+            w(`  ${s}`);
+    }
+    if (result.warnings.length > 0) {
+        w('');
+        w(kleur.bold().yellow('Warnings:'));
+        for (const s of result.warnings)
+            w(`  ${s}`);
+    }
+    if (result.nextSteps.length > 0) {
+        w('');
+        w(kleur.bold('Next steps:'));
+        for (const s of result.nextSteps)
+            w(`  - ${s}`);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerList(program: Command): void;

package/dist/commands/list.js

@@ -0,0 +1,40 @@
+// uco list — enumerate the tool catalog the server exposes.
+//
+// Use cases:
+//   - Agent self-discovery: "what's available?" before composing a workflow
+//   - Codegen input (Phase 2 wires this into build-time command generation)
+import { runCommand } from '../util/cli-context.js';
+const SAFETY_HINTS = [
+    'readOnlyHint',
+    'destructiveHint',
+    'idempotentHint',
+    'openWorldHint',
+];
+export function registerList(program) {
+    program
+        .command('list')
+        .description('List tools the server exposes (GET /api/tools).')
+        .option('-f, --filter <substring>', 'Filter tool names by substring (case-insensitive)')
+        .action(function (opts) {
+        return runCommand(this, async (ctx) => {
+            const tools = await ctx.transport.listTools();
+            const filtered = opts.filter
+                ? tools.filter((t) => t.name.toLowerCase().includes(opts.filter.toLowerCase()))
+                : tools;
+            // Keep the JSON shape stable: an array of {name, title?, description?}.
+            return filtered.map((tool) => {
+                const entry = {
+                    name: tool.name,
+                    ...(tool.title ? { title: tool.title } : {}),
+                    ...(tool.description ? { description: tool.description } : {}),
+                };
+                for (const hint of SAFETY_HINTS) {
+                    if (Object.hasOwn(tool, hint))
+                        entry[hint] = tool[hint];
+                }
+                return entry;
+            });
+        })();
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,aAAa;AACb,4EAA4E;AAC5E,4EAA4E;AAG5E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,MAAM,YAAY,GAAG;IACnB,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;CACP,CAAC;AAEX,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,0BAA0B,EAAE,mDAAmD,CAAC;SACvF,MAAM,CAAC,UAAyB,IAAiB;QAChD,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM;gBAC1B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAO,CAAC,WAAW,EAAE,CAAC,CAAC;gBAChF,CAAC,CAAC,KAAK,CAAC;YACV,wEAAwE;YACxE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC3B,MAAM,KAAK,GAA4B;oBACrC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;oBAChC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1D,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/ping.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPing(program: Command): void;

package/dist/commands/ping.js

@@ -0,0 +1,25 @@
+// uco ping — liveness probe against the Unity-MCP server.
+//
+// First step the Skill tells the agent to run before any other command:
+// confirms the URL resolves, the server is up, and the Unity Editor /
+// runtime build has the plugin connected.
+import { runCommand } from '../util/cli-context.js';
+import { printInfo } from '../util/output.js';
+export function registerPing(program) {
+    program
+        .command('ping')
+        .description('Health check the Unity-MCP server (POST /api/system-tools/ping).')
+        .action(function () {
+        return runCommand(this, async (ctx) => {
+            printInfo(ctx.output, `→ ${ctx.resolved.baseUrl} (${ctx.resolved.source})`);
+            const data = await ctx.transport.ping();
+            return {
+                ok: true,
+                url: ctx.resolved.baseUrl,
+                source: ctx.resolved.source,
+                data,
+            };
+        })();
+    });
+}
+//# sourceMappingURL=ping.js.map

package/dist/commands/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/commands/ping.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,0CAA0C;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC;QACN,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO;gBACzB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;gBAC3B,IAAI;aACL,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/prompt.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPrompt(program: Command): void;

package/dist/commands/prompt.js

@@ -0,0 +1,45 @@
+// uco prompt [name] [--args '<json>'] — list or resolve Unity-MCP prompts.
+//
+// Prompts are preset instruction templates (slash-commands) the Unity plugin exposes.
+//   uco prompt                 → list available prompts (GET /api/prompts)
+//   uco prompt <name>          → resolve a prompt by name (POST /api/prompts/{name})
+import { runCommand, CliError } from '../util/cli-context.js';
+export function registerPrompt(program) {
+    program
+        .command('prompt [name]')
+        .description('List Unity-MCP prompts, or resolve one by name (POST /api/prompts/{name}).')
+        .option('-a, --args <json>', 'JSON arguments for the prompt (resolve mode)', '{}')
+        .option('-f, --filter <substring>', 'Filter prompt names by substring (list mode, case-insensitive)')
+        .action(function (name, opts) {
+        return runCommand(this, async (ctx) => {
+            if (!name) {
+                const prompts = await ctx.transport.listPrompts();
+                const filtered = opts.filter
+                    ? prompts.filter((p) => p.name.toLowerCase().includes(opts.filter.toLowerCase()))
+                    : prompts;
+                return filtered.map((p) => ({
+                    name: p.name,
+                    ...(p.title ? { title: p.title } : {}),
+                    ...(p.description ? { description: p.description } : {}),
+                }));
+            }
+            const args = parsePromptArgs(opts);
+            return ctx.transport.callPrompt(name, args);
+        })();
+    });
+}
+function parsePromptArgs(opts) {
+    try {
+        const parsed = JSON.parse(opts.args ?? '{}');
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new CliError('--args must be a JSON object', 'args-not-object');
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(`Invalid JSON in --args: ${err.message}`, 'args-invalid-json');
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,sFAAsF;AACtF,2EAA2E;AAC3E,qFAAqF;AAGrF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAO9D,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,4EAA4E,CAAC;SACzF,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,EAAE,IAAI,CAAC;SACjF,MAAM,CAAC,0BAA0B,EAAE,gEAAgE,CAAC;SACpG,MAAM,CAAC,UAAyB,IAAwB,EAAE,IAAgB;QACzE,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM;oBAC1B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAO,CAAC,WAAW,EAAE,CAAC,CAAC;oBAClF,CAAC,CAAC,OAAO,CAAC;gBACZ,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzD,CAAC,CAAC,CAAC;YACN,CAAC;YACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,eAAe,CAAC,IAAgB;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,QAAQ,CAAC,8BAA8B,EAAE,iBAAiB,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAC;QACvC,MAAM,IAAI,QAAQ,CAAC,2BAA4B,GAAa,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/commands/resource.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerResource(program: Command): void;

package/dist/commands/resource.js

@@ -0,0 +1,30 @@
+// uco resource [uri] — list Unity-MCP resources, or read one by URI.
+//
+// Resources are read-only state providers (editor state, project info, hierarchy, ...).
+//   uco resource                → list available resources (GET /api/resources)
+//   uco resource <uri>          → read a resource by URI (GET /api/resources/content?uri=)
+import { runCommand } from '../util/cli-context.js';
+export function registerResource(program) {
+    program
+        .command('resource [uri]')
+        .description('List Unity-MCP resources, or read one by URI (GET /api/resources/content?uri=).')
+        .option('-f, --filter <substring>', 'Filter by URI/name substring (list mode, case-insensitive)')
+        .action(function (uri, opts) {
+        return runCommand(this, async (ctx) => {
+            if (!uri) {
+                const resources = await ctx.transport.listResources();
+                const filtered = opts.filter
+                    ? resources.filter((r) => `${r.uri} ${r.name ?? ''}`.toLowerCase().includes(opts.filter.toLowerCase()))
+                    : resources;
+                return filtered.map((r) => ({
+                    uri: r.uri,
+                    ...(r.name ? { name: r.name } : {}),
+                    ...(r.description ? { description: r.description } : {}),
+                    ...(r.mimeType ? { mimeType: r.mimeType } : {}),
+                }));
+            }
+            return ctx.transport.readResource(uri);
+        })();
+    });
+}
+//# sourceMappingURL=resource.js.map

package/dist/commands/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/commands/resource.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,wFAAwF;AACxF,gFAAgF;AAChF,2FAA2F;AAG3F,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,iFAAiF,CAAC;SAC9F,MAAM,CAAC,0BAA0B,EAAE,4DAA4D,CAAC;SAChG,MAAM,CAAC,UAAyB,GAAuB,EAAE,IAAkB;QAC1E,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;gBACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM;oBAC1B,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACrB,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAO,CAAC,WAAW,EAAE,CAAC,CAAC;oBAClF,CAAC,CAAC,SAAS,CAAC;gBACd,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1B,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChD,CAAC,CAAC,CAAC;YACN,CAAC;YACD,OAAO,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/update.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerUpdate(program: Command): void;

package/dist/commands/update.js

@@ -0,0 +1,132 @@
+// uco update — refresh everything uco installed into a target, per the
+// install manifest: every agent's entry Skills + the shared agent-runtime
+// (content-diff driven, no running Unity Editor required), the Unity plugin
+// package + NuGet DLL set as one matched set for bundle-sourced installs,
+// and per-agent MCP client configs from the project's live server settings.
+//
+// Upgrading the uco npm package itself stays `npm i -g uco@latest` —
+// update refreshes only what uco installed. Wraps `devops/lib/update.runUpdate`.
+import process from 'node:process';
+import path from 'node:path';
+import kleur from 'kleur';
+import { runCommand } from '../util/cli-context.js';
+import { runUpdate } from '../devops/lib/update.js';
+import { unwrapResult } from './devops/_helpers.js';
+export function registerUpdate(program) {
+    program
+        .command('update [target]')
+        .description('Refresh the uco-installed Skills, shared runtime, Unity toolchain (matched set), and agent MCP configs recorded in .uco/install-manifest.json. Default target: current directory. Idempotent — run it after every uco upgrade.')
+        .option('--dry-run', 'Print the planned changes without writing anything')
+        .option('--force', 'Refresh every recorded agent even when content-identical')
+        .option('--skip-unity', 'Leave the Unity plugin package and NuGet DLL set untouched')
+        .option('--skip-mcp-config', 'Do not read or write any agent MCP config file')
+        .action(function (targetArg, opts) {
+        return runCommand(this, async (ctx) => {
+            const target = path.resolve(targetArg ?? process.cwd());
+            const result = await runUpdate({
+                targetPath: target,
+                dryRun: opts.dryRun === true,
+                force: opts.force === true,
+                skipUnity: opts.skipUnity === true,
+                skipMcpConfig: opts.skipMcpConfig === true,
+            });
+            const unwrapped = unwrapResult(result);
+            // Human pretty-print (suppressed under --json by printResult).
+            if (result.kind === 'success' && !ctx.output.json) {
+                printUpdateSummary(result);
+                return undefined;
+            }
+            return unwrapped;
+        })();
+    });
+}
+function printUpdateSummary(result) {
+    const out = process.stderr;
+    const w = (s) => { out.write(s + '\n'); };
+    if (result.upToDate) {
+        w(kleur.bold().gray('uco update — Already up to date.'));
+    }
+    else if (result.dryRun) {
+        w(kleur.bold().yellow('uco update — DRY RUN (no files written)'));
+    }
+    else {
+        w(kleur.bold().green('uco update — done'));
+    }
+    w(kleur.gray(`  target     : ${result.targetPath}`));
+    if (result.versionBefore !== result.versionAfter) {
+        w(kleur.gray(result.upToDate
+            ? `  uco      : installed by v${result.versionBefore || 'unknown'} — every managed file already matches v${result.versionAfter}, nothing to restamp`
+            : `  uco      : installed by v${result.versionBefore || 'unknown'} → refreshed with v${result.versionAfter}`));
+    }
+    else {
+        w(kleur.gray(`  uco      : v${result.versionAfter}`));
+    }
+    if (result.seeded && result.seedAgentIds.length > 0) {
+        w(kleur.gray(`  migrated   : seeded the install manifest from ${result.seedAgentIds.join(', ')}`));
+    }
+    if (result.agents.length > 0) {
+        w('');
+        w(kleur.bold('Agent Skills:'));
+        for (const agent of result.agents) {
+            const mark = agent.status === 'updated'
+                ? kleur.green(`✓ ${agent.changedFileCount} file${agent.changedFileCount === 1 ? '' : 's'} ${result.dryRun ? 'would change' : 'refreshed'}`)
+                : agent.status === 'failed'
+                    ? kleur.red(`✗ ${agent.error ?? 'failed'}`)
+                    : kleur.gray('  unchanged');
+            w(`  ${kleur.cyan(agent.id.padEnd(16))} ${kleur.gray(agent.skillsPath)}  ${mark}`);
+        }
+        const runtimeLabel = result.runtime.liveCatalogPreserved ? 'agent-runtime (live catalog preserved)' : 'agent-runtime';
+        const runtimeMark = result.runtime.status === 'updated'
+            ? kleur.green(`✓ ${result.runtime.changedFileCount} file${result.runtime.changedFileCount === 1 ? '' : 's'} refreshed`)
+            : result.runtime.status === 'failed'
+                ? kleur.red(`✗ ${result.runtime.error ?? 'failed'}`)
+                : kleur.gray('  unchanged');
+        w(`  ${kleur.cyan(runtimeLabel.padEnd(16))} ${runtimeMark}`);
+    }
+    w('');
+    w(kleur.bold('Unity toolchain:'));
+    {
+        const mark = result.unity.status === 'refreshed'
+            ? kleur.green(`✓ ${result.dryRun ? 'would refresh' : 'refreshed'} (matched set)`)
+            : result.unity.status === 'failed'
+                ? kleur.red(`✗ ${result.unity.detail}`)
+                : kleur.gray(`  ${result.unity.status}`);
+        w(`  ${mark}${kleur.gray(result.unity.status !== 'failed' ? ` — ${result.unity.detail}` : '')}`);
+    }
+    if (result.configSync.status !== 'disabled') {
+        w('');
+        w(kleur.bold('MCP configs:'));
+        if (result.configSync.status === 'skipped') {
+            w(kleur.gray(`  skipped — ${result.configSync.detail}`));
+        }
+        else {
+            for (const agent of result.configSync.agents) {
+                const mark = agent.status === 'created'
+                    ? kleur.green('✓ created')
+                    : agent.status === 'updated'
+                        ? kleur.green('✓ updated')
+                        : agent.status === 'failed'
+                            ? kleur.red(`✗ ${agent.error ?? 'failed'}`)
+                            : kleur.gray('  unchanged');
+                w(`  ${kleur.cyan(agent.id.padEnd(16))} ${mark}  ${kleur.gray(agent.configPath)}`);
+            }
+            if (result.configSync.restartReminder) {
+                w(kleur.yellow('  Restart the affected agent(s) for the config change to take effect.'));
+            }
+        }
+    }
+    if (result.newAgentAdvisories.length > 0) {
+        w('');
+        w(kleur.bold('New agents detected (not auto-added):'));
+        for (const advisory of result.newAgentAdvisories) {
+            w(`  ${kleur.cyan(advisory.id)} — present at ${advisory.detectionPaths.join(', ')}; run ${kleur.gray(`uco init --agent ${advisory.id}`)} to install.`);
+        }
+    }
+    if (result.warnings.length > 0) {
+        w('');
+        w(kleur.bold().yellow('Warnings:'));
+        for (const warning of result.warnings)
+            w(`  ${warning}`);
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/config/port.d.ts

@@ -0,0 +1 @@
+export declare function generatePortFromDirectory(dir: string): number;

package/dist/config/port.js

@@ -0,0 +1,19 @@
+// Deterministic port derivation — matches Unity-MCP plugin's algorithm.
+//
+// Source: Unity-MCP/cli/src/utils/port.ts (mirrors C# UnityMcpPlugin.GeneratePortFromDirectory).
+// SHA256 of lowercased directory path → first 4 bytes LE as uint32 → mod 10000 + 20000.
+//
+// If the user changes the algorithm upstream (rare), the port the plugin
+// listens on and the port we connect to will diverge. Treat upstream's
+// implementation as the source of truth and sync this file when it changes.
+import { createHash } from 'node:crypto';
+const MIN_PORT = 20_000;
+const MAX_PORT = 29_999;
+const PORT_RANGE = MAX_PORT - MIN_PORT + 1;
+export function generatePortFromDirectory(dir) {
+    const hash = createHash('sha256').update(dir.toLowerCase()).digest();
+    const int32 = hash.readInt32LE(0);
+    const uint32 = int32 >>> 0;
+    return MIN_PORT + (uint32 % PORT_RANGE);
+}
+//# sourceMappingURL=port.js.map

package/dist/config/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/config/port.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,iGAAiG;AACjG,wFAAwF;AACxF,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;AAE3C,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC;IAC3B,OAAO,QAAQ,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,24 @@
+export interface ProjectConfig {
+    host?: string;
+    token?: string;
+    cloudToken?: string;
+    connectionMode?: string | number;
+    [key: string]: unknown;
+}
+export interface ResolveOptions {
+    /** Path to the Unity project root (the folder that contains Assets/, ProjectSettings/, UserSettings/). */
+    projectPath?: string;
+    /** Direct server URL override. Wins over everything else. */
+    url?: string;
+    /** Direct bearer token override. */
+    token?: string;
+}
+export interface Resolved {
+    baseUrl: string;
+    token: string | undefined;
+    /** Where the URL came from — useful for diagnostics. */
+    source: 'override' | 'config-custom' | 'config-cloud' | 'deterministic';
+    /** Resolved project path (absolute), if any. */
+    projectPath: string | undefined;
+}
+export declare function resolveConnection(opts: ResolveOptions): Resolved;

package/dist/config/resolve.js

@@ -0,0 +1,78 @@
+// Resolve the (url, token) pair to talk to a Unity-MCP server, given:
+//   1. Explicit CLI overrides (--url, --token)
+//   2. The Unity project's UserSettings/AI-Game-Developer-Config.json
+//   3. Deterministic-port localhost fallback
+//
+// Priority: explicit override > project config > deterministic port.
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { generatePortFromDirectory } from './port.js';
+const CONFIG_RELATIVE_PATH = 'UserSettings/uco-config.json';
+// Pre-rename filename (uco 0.3.0): read as a fallback until every project
+// has been migrated (the plugin migrates it on first Editor start).
+const LEGACY_CONFIG_RELATIVE_PATH = 'UserSettings/AI-Game-Developer-Config.json';
+const CLOUD_SERVER_URL = 'https://ai-game.dev/mcp';
+export function resolveConnection(opts) {
+    // 1. Explicit override wins outright.
+    if (opts.url) {
+        return {
+            baseUrl: stripTrailingSlash(opts.url),
+            token: opts.token,
+            source: 'override',
+            projectPath: opts.projectPath ? resolve(opts.projectPath) : undefined,
+        };
+    }
+    // 2. Try to load project config.
+    if (opts.projectPath) {
+        const absProjectPath = resolve(opts.projectPath);
+        const cfg = tryReadConfig(absProjectPath);
+        if (cfg) {
+            if (isCloudMode(cfg)) {
+                return {
+                    baseUrl: CLOUD_SERVER_URL,
+                    token: opts.token ?? cfg.cloudToken,
+                    source: 'config-cloud',
+                    projectPath: absProjectPath,
+                };
+            }
+            if (cfg.host) {
+                return {
+                    baseUrl: stripTrailingSlash(cfg.host),
+                    token: opts.token ?? cfg.token,
+                    source: 'config-custom',
+                    projectPath: absProjectPath,
+                };
+            }
+        }
+        // 3. Deterministic port fallback for the given project path.
+        return {
+            baseUrl: `http://localhost:${generatePortFromDirectory(absProjectPath)}`,
+            token: opts.token,
+            source: 'deterministic',
+            projectPath: absProjectPath,
+        };
+    }
+    throw new Error('uco: cannot resolve server URL — supply --url, or --project <path>, ' +
+        'or cd into a Unity project directory.');
+}
+function tryReadConfig(projectPath) {
+    const configPath = join(projectPath, CONFIG_RELATIVE_PATH);
+    const legacyConfigPath = join(projectPath, LEGACY_CONFIG_RELATIVE_PATH);
+    const effectivePath = existsSync(configPath) ? configPath : legacyConfigPath;
+    if (!existsSync(effectivePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(effectivePath, 'utf8'));
+    }
+    catch {
+        // Malformed config — treat as missing.
+        return null;
+    }
+}
+function isCloudMode(cfg) {
+    return cfg.connectionMode === 'Cloud' || cfg.connectionMode === 1;
+}
+function stripTrailingSlash(s) {
+    return s.replace(/\/+$/, '');
+}
+//# sourceMappingURL=resolve.js.map