@atelierai/uco 1.0.0

package/dist/devops/lib/update.js

@@ -0,0 +1,405 @@
+// uco `update` library — the single idempotent refresh path for everything
+// uco installed into a target, resolved from `.uco/install-manifest.json`:
+//
+//   1. Every manifest agent's entry Skills, refreshed from the current static
+//      templates (content-diff driven — no running Unity Editor required).
+//   2. The shared `.uco/agent-runtime` support tree, exactly once per run,
+//      without regressing a live catalog installed by `uco setup-skills`.
+//   3. The Unity plugin package + NuGet DLL set as ONE matched set for
+//      bundle-sourced installs (the stale-DLL CS0246 class of breakage is not
+//      reachable through this path).
+//   4. Per-agent MCP client configs, reconciled from the project's live
+//      server settings through the same writers `setup-mcp` uses.
+//
+// Never onboards an agent that is not in the manifest (new agents surface only
+// through the advisory). Upgrading the uco npm package itself stays
+// `npm i -g uco@latest`. Library-safe: no process.exit, no printing,
+// discriminated-union result.
+import fs from 'node:fs';
+import path from 'node:path';
+import { installStaticSkillBundle, loadToolsFromManifest, refreshLiveAgentRuntimeScripts, resolvePluginManifestPath, } from '../../skills/bundle.js';
+import { UNITY_SOURCE_BUNDLE, getUcoVersion, inferUnitySource, installManifestPath, readOrSeedInstallManifest, writeInstallManifest, } from '../../skills/install-manifest.js';
+import { getAgentById, detectAgentsAt, mergeJsonAgentConfigRoot, mergeTomlAgentConfigLines, MCP_SERVER_NAME, } from '../utils/agents.js';
+import { UCO_UNITY_PACKAGE_ID } from '../utils/manifest.js';
+import { resolveDefaultNugetSource, resolveDefaultPluginSource } from '../utils/vendor.js';
+import { installAll, nugetSurfaceDiffers, pluginSurfaceDiffers } from './install.js';
+import { computeAgentMcpProps } from './setup-mcp.js';
+import { emitProgress } from './progress.js';
+const LIVE_CATALOG_MARKER = path.join('.uco', 'agent-runtime', 'catalog', 'project.json');
+export async function runUpdate(opts) {
+    const warnings = [];
+    const dryRun = opts.dryRun === true;
+    try {
+        emitProgress(opts.onProgress, { phase: 'validating', message: `Resolving install state at ${opts.targetPath}` });
+        const target = path.resolve(opts.targetPath);
+        if (!fs.existsSync(target) || !fs.statSync(target).isDirectory()) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                error: new Error(`Target directory does not exist or is not a directory: ${target}`),
+            };
+        }
+        // A dry run computes the seed in memory (so the plan can report the
+        // would-be migration) but must not persist anything — including the seed.
+        const state = readOrSeedInstallManifest(target, { persist: !dryRun });
+        warnings.push(...state.warnings);
+        if (state.manifest === undefined) {
+            return {
+                kind: 'failure',
+                success: false,
+                targetPath: target,
+                warnings,
+                error: new Error(`No uco install found at ${target} (no install manifest and no uco-owned artifacts on disk). Run \`uco init\` there first, then re-run \`uco update\`.`),
+            };
+        }
+        const manifest = state.manifest;
+        const manifestRecordPath = installManifestPath(target);
+        const versionBefore = manifest.ucoVersion;
+        const versionAfter = getUcoVersion();
+        if (state.seeded && state.seedAgentIds.length > 0) {
+            warnings.push(`Seeded install manifest from on-disk artifacts: ${state.seedAgentIds.join(', ')}.`);
+        }
+        if (manifest.agents.length === 0 && !manifest.unity.installed) {
+            return {
+                kind: 'success',
+                success: true,
+                targetPath: target,
+                manifestPath: manifestRecordPath,
+                seeded: state.seeded,
+                seedAgentIds: state.seedAgentIds,
+                agents: [],
+                runtime: { status: 'unchanged', changedFileCount: 0, liveCatalogPreserved: false },
+                unity: { status: 'skipped', detail: 'no Unity toolchain recorded', warnings: [] },
+                configSync: { status: 'skipped', detail: 'no installed agents', agents: [], restartReminder: false },
+                newAgentAdvisories: [],
+                upToDate: true,
+                versionBefore,
+                versionAfter,
+                warnings: [
+                    ...warnings,
+                    'Install manifest records no agents and no Unity toolchain — nothing to update. Run `uco init` to install agent Skills.',
+                ],
+                dryRun,
+            };
+        }
+        // --- 1 + 2: per-agent Skills refresh and the (single) runtime refresh ---
+        const liveCatalogInstalled = fs.existsSync(path.join(target, LIVE_CATALOG_MARKER));
+        const tools = loadToolsFromManifest(resolvePluginManifestPath());
+        const primary = manifest.agents[0];
+        const runtimeSkillsPath = primary?.skillsPath;
+        const agentReports = [];
+        let runtimeWrittenFiles = 0;
+        for (const entry of manifest.agents) {
+            const agent = getAgentById(entry.id);
+            if (!agent)
+                continue; // the tolerant reader already dropped unknown ids
+            try {
+                const result = installStaticSkillBundle({
+                    projectPath: target,
+                    skillsRoot: path.resolve(target, entry.skillsPath),
+                    dryRun,
+                    force: opts.force,
+                    tools,
+                    // The shared runtime records the primary agent's path; skip it per
+                    // agent when a live catalog owns the runtime (refreshed separately).
+                    ...(runtimeSkillsPath !== undefined ? { runtimeSkillsPath } : {}),
+                    ...(liveCatalogInstalled ? { skipRuntime: true } : {}),
+                });
+                const runtimeFiles = result.written.filter((file) => file.startsWith('agent-runtime/')).length;
+                runtimeWrittenFiles = Math.max(runtimeWrittenFiles, runtimeFiles);
+                agentReports.push({
+                    id: entry.id,
+                    skillsPath: entry.skillsPath,
+                    // --force regenerates every manifest agent even when content-identical.
+                    status: result.written.length > 0 || opts.force === true ? 'updated' : 'unchanged',
+                    changedFileCount: result.written.length,
+                });
+            }
+            catch (error) {
+                agentReports.push({
+                    id: entry.id,
+                    skillsPath: entry.skillsPath,
+                    status: 'failed',
+                    changedFileCount: 0,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        let runtime;
+        if (liveCatalogInstalled) {
+            try {
+                const live = refreshLiveAgentRuntimeScripts({ projectPath: target, dryRun, force: opts.force });
+                runtime = {
+                    status: live.status === 'would-change' ? 'updated' : live.status,
+                    changedFileCount: live.written.length,
+                    liveCatalogPreserved: true,
+                };
+                warnings.push(...live.warnings);
+            }
+            catch (error) {
+                runtime = {
+                    status: 'failed',
+                    changedFileCount: 0,
+                    liveCatalogPreserved: true,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        }
+        else {
+            const changed = runtimeWrittenFiles > 0 || opts.force === true;
+            runtime = {
+                status: changed ? 'updated' : 'unchanged',
+                changedFileCount: runtimeWrittenFiles,
+                liveCatalogPreserved: false,
+            };
+        }
+        // --- 3: Unity toolchain refresh (matched set) ---
+        const unity = await refreshUnitySurface(target, manifest, opts, warnings);
+        // --- 4: MCP config reconciliation ---
+        const configSync = reconcileMcpConfigs(target, manifest, opts);
+        // --- New-agent advisory (never auto-adds) ---
+        const installedIds = new Set(manifest.agents.map((entry) => entry.id));
+        const newAgentAdvisories = [];
+        for (const id of detectAgentsAt(target)) {
+            if (installedIds.has(id))
+                continue;
+            const agent = getAgentById(id);
+            if (agent) {
+                newAgentAdvisories.push({ id, detectionPaths: agent.detectionPaths });
+            }
+        }
+        const allAgentsQuiet = agentReports.every((report) => report.status === 'unchanged');
+        const unityQuiet = unity.status === 'unchanged' || unity.status === 'skipped';
+        const configsQuiet = configSync.agents.every((report) => report.status === 'unchanged');
+        // The no-op decision is content-only: after a uco upgrade whose
+        // templates are content-identical, every managed file already matches the
+        // current output, so the run reports "Already up to date." and the version
+        // restamp is included in the no-op (nothing was refreshed to restamp).
+        const upToDate = allAgentsQuiet
+            && runtime.status === 'unchanged'
+            && unityQuiet
+            && configsQuiet;
+        // One-shot source inference (design D4 "runs at most once per project"):
+        // a sourceless legacy `unity` record gets its inferred source persisted
+        // even on an otherwise-quiet run. This is a manifest-only field heal, not
+        // a content write — it does not affect the no-op decision above, and like
+        // every write it is gated on `!dryRun`. When inference cannot resolve a
+        // source (no plugin dependency on disk), nothing is persisted and the
+        // inference simply re-runs next time.
+        const inferredUnitySource = manifest.unity.installed && manifest.unity.source === undefined
+            ? inferUnitySourceFromProject(manifest.unity.projectPath ?? target)
+            : undefined;
+        // --- Restamp the manifest after a run that wrote something ---
+        let restamped = manifest;
+        if (!dryRun && (!upToDate || inferredUnitySource !== undefined)) {
+            restamped = {
+                ...manifest,
+                ucoVersion: versionAfter,
+                updatedAt: new Date().toISOString(),
+                ...(inferredUnitySource !== undefined
+                    ? { unity: { ...manifest.unity, source: inferredUnitySource } }
+                    : {}),
+            };
+            try {
+                writeInstallManifest(target, restamped);
+            }
+            catch (error) {
+                warnings.push(`Could not restamp the install manifest at ${manifestRecordPath} (${error instanceof Error ? error.message : String(error)}).`);
+            }
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: upToDate ? 'Already up to date.' : 'Update complete.' });
+        return {
+            kind: 'success',
+            success: true,
+            targetPath: target,
+            manifestPath: manifestRecordPath,
+            seeded: state.seeded,
+            seedAgentIds: state.seedAgentIds,
+            agents: agentReports,
+            runtime,
+            unity,
+            configSync,
+            newAgentAdvisories,
+            upToDate,
+            versionBefore,
+            versionAfter,
+            warnings,
+            dryRun,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/** Read the plugin dependency value from a project's Packages/manifest.json. */
+function readPluginDependency(projectPath) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath))
+        return undefined;
+    try {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+        const dependency = manifest.dependencies?.[UCO_UNITY_PACKAGE_ID];
+        return typeof dependency === 'string' ? dependency : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function inferUnitySourceFromProject(projectPath) {
+    const dependency = readPluginDependency(projectPath);
+    return dependency !== undefined ? inferUnitySource(dependency) : undefined;
+}
+async function refreshUnitySurface(target, manifest, opts, warnings) {
+    if (!manifest.unity.installed) {
+        return { status: 'skipped', detail: 'no Unity toolchain recorded in the install manifest', warnings: [] };
+    }
+    if (opts.skipUnity === true) {
+        return { status: 'skipped', detail: '--skip-unity', warnings: [] };
+    }
+    const unityProjectPath = path.resolve(manifest.unity.projectPath ?? target);
+    // Resolve the source deterministically: the recorded value, or a one-shot
+    // inference from the package manifest when the field is absent.
+    const source = manifest.unity.source ?? inferUnitySourceFromProject(unityProjectPath);
+    if (source === undefined) {
+        return {
+            status: 'skipped',
+            detail: `no plugin source recorded and no ${UCO_UNITY_PACKAGE_ID} dependency found under ${unityProjectPath}`,
+            warnings: [],
+        };
+    }
+    if (source !== UNITY_SOURCE_BUNDLE) {
+        return {
+            status: 'skipped',
+            detail: `user-managed plugin source (${source}) — re-run \`uco install ${unityProjectPath}\` deliberately to restage`,
+            warnings: [],
+        };
+    }
+    const pluginSourcePath = opts.pluginSourcePath ?? resolveDefaultPluginSource();
+    const stagedNugetPath = opts.nugetSourcePath ?? resolveDefaultNugetSource();
+    const embedSource = { kind: 'embed', sourcePath: pluginSourcePath };
+    // Matched-set heal: refresh when EITHER surface drifted from the bundle.
+    const pluginChanged = pluginSurfaceDiffers(unityProjectPath, embedSource);
+    const nugetChanged = nugetSurfaceDiffers(stagedNugetPath, unityProjectPath);
+    if (!pluginChanged && !nugetChanged && opts.force !== true) {
+        return { status: 'unchanged', detail: 'plugin and NuGet set already match the current uco bundle', warnings: [] };
+    }
+    // The Unity refresh never stages a tool server, so `skipServer: true` is
+    // the semantically correct ask on every shape of `installAll`. The field
+    // exists only in the pre-Node-migration `InstallAllOptions` (where omitting
+    // it makes installAll demand a `stagedServerPath`); the intersection keeps
+    // this call type-valid before and after the migration deletes the field,
+    // and the extra property is a harmless no-op on the post-migration shape.
+    const refreshCall = {
+        unityProjectPath,
+        pluginSource: embedSource,
+        stagedNugetPath,
+        dryRun: opts.dryRun === true,
+        refresh: true,
+        skipConfig: true, // UserSettings config is preserved byte-for-byte.
+        skipServer: true,
+        ...(opts.onProgress ? { onProgress: opts.onProgress } : {}),
+    };
+    const result = await installAll(refreshCall);
+    warnings.push(...result.warnings);
+    if (result.kind === 'failure') {
+        return {
+            status: 'failed',
+            detail: result.error.message,
+            warnings: result.warnings,
+        };
+    }
+    return {
+        status: 'refreshed',
+        detail: opts.dryRun === true
+            ? 'plugin package and NuGet DLL set would be re-staged from the uco bundle as one matched set'
+            : 'plugin package and NuGet DLL set re-staged from the uco bundle as one matched set',
+        warnings: result.warnings,
+    };
+}
+function reconcileMcpConfigs(target, manifest, opts) {
+    if (opts.skipMcpConfig === true) {
+        return { status: 'disabled', detail: '--skip-mcp-config', agents: [], restartReminder: false };
+    }
+    if (manifest.agents.length === 0) {
+        return { status: 'skipped', detail: 'no installed agents', agents: [], restartReminder: false };
+    }
+    // Resolve the project whose live server settings drive the entry. Never
+    // fabricate a host, port, or token: no config file means no write.
+    const candidates = [...new Set([manifest.unity.projectPath, target])]
+        .filter((candidate) => candidate !== undefined)
+        .map((candidate) => path.resolve(candidate));
+    const projectWithConfig = candidates.find((candidate) => fs.existsSync(path.join(candidate, 'UserSettings', 'AI-Game-Developer-Config.json')));
+    if (projectWithConfig === undefined) {
+        return {
+            status: 'skipped',
+            detail: `no UserSettings/AI-Game-Developer-Config.json found under ${target} — run \`uco install <project>\` first; MCP configs left untouched`,
+            agents: [],
+            restartReminder: false,
+        };
+    }
+    const reports = [];
+    for (const entry of manifest.agents) {
+        const agent = getAgentById(entry.id);
+        if (!agent)
+            continue;
+        try {
+            const computed = computeAgentMcpProps(agent, projectWithConfig);
+            const current = fs.existsSync(computed.configPath)
+                ? fs.readFileSync(computed.configPath, 'utf8')
+                : undefined;
+            const existed = current !== undefined;
+            let nextContent;
+            if (agent.configFormat === 'toml') {
+                const lines = current !== undefined ? current.split('\n') : [];
+                const merged = mergeTomlAgentConfigLines(lines, agent.bodyPath, MCP_SERVER_NAME, computed.props, computed.removeKeys);
+                nextContent = merged.join('\n') + '\n';
+            }
+            else {
+                let root = {};
+                if (current !== undefined) {
+                    try {
+                        const parsed = JSON.parse(current);
+                        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                            root = parsed;
+                        }
+                    }
+                    catch {
+                        // Malformed file: the writer starts fresh; mirror that here.
+                    }
+                }
+                const merged = mergeJsonAgentConfigRoot(root, agent.bodyPath, MCP_SERVER_NAME, computed.props, computed.removeKeys);
+                nextContent = JSON.stringify(merged, null, 2) + '\n';
+            }
+            if (current === nextContent) {
+                reports.push({ id: entry.id, status: 'unchanged', configPath: computed.configPath });
+                continue;
+            }
+            if (opts.dryRun !== true) {
+                fs.mkdirSync(path.dirname(computed.configPath), { recursive: true });
+                fs.writeFileSync(computed.configPath, nextContent, 'utf8');
+            }
+            reports.push({ id: entry.id, status: existed ? 'updated' : 'created', configPath: computed.configPath });
+        }
+        catch (error) {
+            reports.push({
+                id: entry.id,
+                status: 'failed',
+                configPath: '',
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return {
+        status: 'synced',
+        detail: `reconciled from ${path.join(projectWithConfig, 'UserSettings', 'AI-Game-Developer-Config.json')}`,
+        agents: reports,
+        restartReminder: reports.some((report) => report.status === 'created' || report.status === 'updated'),
+    };
+}
+//# sourceMappingURL=update.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Small, side-effect-free input-validation helpers shared by the
+ * library-facing API functions. Each helper returns a discriminated
+ * union so call sites can pattern-match without throwing across the
+ * public boundary.
+ */
+export type ValidatedPath = {
+    ok: true;
+    projectPath: string;
+} | {
+    ok: false;
+    error: Error;
+};
+export type ValidatedUnityProject = {
+    ok: true;
+    projectPath: string;
+    manifestPath: string;
+} | {
+    ok: false;
+    manifestPath?: string;
+    error: Error;
+};
+/**
+ * Require a non-empty string and resolve it to an absolute path.
+ */
+export declare function requireProjectPath(raw: unknown): ValidatedPath;
+/**
+ * Require a non-empty path AND that the path hosts a Unity project
+ * (identified by the presence of `Packages/manifest.json`).
+ */
+export declare function requireUnityProject(raw: unknown): ValidatedUnityProject;
+/**
+ * Require that the given path exists on disk (does not need to host a
+ * Unity manifest). Used by `configure()` which only needs a directory
+ * to drop a config file into.
+ */
+export declare function requireExistingPath(raw: unknown): ValidatedPath;

package/dist/devops/lib/validation.js

@@ -0,0 +1,50 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Require a non-empty string and resolve it to an absolute path.
+ */
+export function requireProjectPath(raw) {
+    if (typeof raw !== 'string' || raw.length === 0) {
+        return {
+            ok: false,
+            error: new Error('unityProjectPath is required and must be a non-empty string.'),
+        };
+    }
+    return { ok: true, projectPath: path.resolve(raw) };
+}
+/**
+ * Require a non-empty path AND that the path hosts a Unity project
+ * (identified by the presence of `Packages/manifest.json`).
+ */
+export function requireUnityProject(raw) {
+    const outer = requireProjectPath(raw);
+    if (!outer.ok)
+        return outer;
+    const manifestPath = path.join(outer.projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        return {
+            ok: false,
+            manifestPath,
+            error: new Error(`Not a valid Unity project (missing Packages/manifest.json): ${outer.projectPath}`),
+        };
+    }
+    return { ok: true, projectPath: outer.projectPath, manifestPath };
+}
+/**
+ * Require that the given path exists on disk (does not need to host a
+ * Unity manifest). Used by `configure()` which only needs a directory
+ * to drop a config file into.
+ */
+export function requireExistingPath(raw) {
+    const outer = requireProjectPath(raw);
+    if (!outer.ok)
+        return outer;
+    if (!fs.existsSync(outer.projectPath)) {
+        return {
+            ok: false,
+            error: new Error(`Project path does not exist: ${outer.projectPath}`),
+        };
+    }
+    return outer;
+}
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/devops/lib/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAiB7B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,IAAI,KAAK,CAAC,8DAA8D,CAAC;SACjF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAC/E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,YAAY;YACZ,KAAK,EAAE,IAAI,KAAK,CACd,+DAA+D,KAAK,CAAC,WAAW,EAAE,CACnF;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,61 @@
+export interface AgentDefinition {
+    id: string;
+    name: string;
+    skillsPath: string | null;
+    /**
+     * Project-relative paths whose presence marks the agent as active at a
+     * target (its config directory, e.g. `.claude`, `.cursor`). Purely advisory
+     * input to install selection — detection never installs or removes anything.
+     * Empty for agents with no reliable project-local marker (global-only config).
+     */
+    detectionPaths: readonly string[];
+    configPathDisplay: string;
+    configFormat: 'json' | 'toml';
+    bodyPath: string;
+    getConfigPath(projectPath: string): string;
+    getStdioProps(serverPath: string, port: number, timeout: number, auth: string, token: string): Record<string, unknown>;
+    getHttpProps(url: string, token: string, authRequired: boolean): Record<string, unknown>;
+    stdioRemoveKeys: string[];
+    httpRemoveKeys: string[];
+}
+declare const MCP_SERVER_NAME = "ai-game-developer";
+export declare const agentRegistry: readonly AgentDefinition[];
+export declare function getAgentById(id: string): AgentDefinition | undefined;
+export declare function getAgentIds(): string[];
+/** Registry entries that accept Skills installs — the install-selection surface. */
+export declare function getSkillsCapableAgents(): AgentDefinition[];
+export declare function getSkillsCapableAgentIds(): string[];
+/**
+ * Detect which skills-capable agents already have a presence at a target by
+ * probing each entry's detection paths (file or directory) under it. Advisory
+ * only — detection never installs, refreshes, or removes anything.
+ */
+export declare function detectAgentsAt(target: string): string[];
+export interface AgentListEntry {
+    id: string;
+    name: string;
+    skillsPath: string;
+    detectionPaths: readonly string[];
+}
+/** Shared `--list` payload for commands that target skills-capable agents. */
+export declare function listSkillsCapableAgents(): AgentListEntry[];
+export declare function listAgentTable(heading: string, locationLabel: string, locationFn: (agent: AgentDefinition) => string): void;
+export declare function resolveServerBinaryPath(projectPath: string): string;
+/**
+ * Pure merge core of {@link writeJsonAgentConfig}: reconciles the managed
+ * server entry inside a parsed config root (surgical — unrelated keys are
+ * preserved) and returns the root that would be serialized. Callers that need
+ * byte-identical skip semantics (notably `uco update`) can run this over the
+ * parsed current file and compare the serialization before writing.
+ */
+export declare function mergeJsonAgentConfigRoot(root: Record<string, unknown>, bodyPath: string, serverName: string, props: Record<string, unknown>, removeKeys: string[]): Record<string, unknown>;
+export declare function writeJsonAgentConfig(configPath: string, bodyPath: string, serverName: string, props: Record<string, unknown>, removeKeys: string[]): void;
+/**
+ * Pure merge core of {@link writeTomlAgentConfig}: reconciles the managed
+ * section inside the config's line array and returns the lines that would be
+ * written. Byte-identical skip semantics mirror
+ * {@link mergeJsonAgentConfigRoot}.
+ */
+export declare function mergeTomlAgentConfigLines(lines: string[], bodyPath: string, serverName: string, props: Record<string, unknown>, removeKeys: string[]): string[];
+export declare function writeTomlAgentConfig(configPath: string, bodyPath: string, serverName: string, props: Record<string, unknown>, removeKeys: string[]): void;
+export { MCP_SERVER_NAME };