ue-mcp 1.4.11-beta.2 → 1.4.11-beta.4

package/README.md

@@ -8,9 +8,9 @@
 <img width="1354" height="586" alt="{6F52BA62-D736-454E-AD30-A1C98F9EEBAA}" src="https://github.com/user-attachments/assets/9380e080-c608-4609-ba21-90e6b0a3ba7f" />
 
 
-**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->30<!-- /count --> category tools covering <!-- count:actions -->2100+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows and an npm plugin system for extending the surface.
+**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->30<!-- /count --> category tools covering <!-- count:actions -->2108+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows and an npm plugin system for extending the surface.
 
-That total is <!-- count:ownActions -->1270+<!-- /count --> actions of ue-mcp's own plus Epic's entire native AI Toolset Registry: on UE 5.8+ its <!-- count:nativeToolActions -->830<!-- /count --> official Unreal tools are called in-process and surfaced as `epic_*` actions in the matching category, Sequencer in `animation`, PCG in `pcg`, static meshes in `asset`.
+That total is <!-- count:ownActions -->1278+<!-- /count --> actions of ue-mcp's own plus Epic's entire native AI Toolset Registry: on UE 5.8+ its <!-- count:nativeToolActions -->830<!-- /count --> official Unreal tools are called in-process and surfaced as `epic_*` actions in the matching category, Sequencer in `animation`, PCG in `pcg`, static meshes in `asset`.
 
 ```mermaid
 flowchart LR
@@ -68,7 +68,7 @@ If you prefer to configure manually, add to your MCP client config:
   "mcpServers": {
     "ue-mcp": {
       "command": "npx",
-      "args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]
+      "args": ["-y", "--min-release-age=0", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]
     }
   }
 }
@@ -142,7 +142,7 @@ flows:
 flow(action="run", flowName="build_and_check")
 ```
 
-Every one of the <!-- count:actions -->2100+<!-- /count --> actions is also a flow task. Flows support step references, retries, rollback, custom tasks in your own `.js`/`.ts`, and shell steps. See [Flows](https://ue-mcp.com/docs/flows/).
+Every one of the <!-- count:actions -->2108+<!-- /count --> actions is also a flow task. Flows support step references, retries, rollback, custom tasks in your own `.js`/`.ts`, and shell steps. See [Flows](https://ue-mcp.com/docs/flows/).
 
 ## Plugins
 

package/dist/bridge/bridge-timeouts.js

@@ -65,6 +65,7 @@ export const REGISTERED_HANDLER_TIMEOUT_SECONDS = {
     bulk_restore_data_assets: 120,
     bulk_set_component_property: 300,
     bulk_upsert_data_assets: 120,
+    checkpoint_finish_restore: 300,
     compile_customizable_object: 600,
     convert_brushes_to_static_mesh: 600,
     create_cpp_class: 300,

package/dist/bridge/bridge-timeouts.js.map

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

package/dist/checkpoints/service.d.ts

@@ -0,0 +1,127 @@
+import type { EditorSession } from "../sessions/session.js";
+import { type ChangeEntry, type CheckpointInfo, type CheckpointTrigger, type RestoreRefusal } from "./shadow-repo.js";
+export { CheckpointError } from "./shadow-repo.js";
+export type { ChangeEntry, CheckpointInfo, RestoreRefusal } from "./shadow-repo.js";
+export interface CheckpointState {
+    editor: string;
+    enabled: boolean;
+    source: "config" | "session";
+    configured: boolean;
+    repository: string | null;
+    checkpoints: CheckpointInfo[];
+}
+export interface CheckpointResult extends CheckpointInfo {
+    editor: string;
+    changes: ChangeEntry[];
+    dirtyPackages: string[];
+    editorConnected: boolean;
+}
+export interface ChangesResult {
+    editor: string;
+    from: string;
+    to: string | null;
+    changes: ChangeEntry[];
+}
+export interface RestoreResult {
+    editor: string;
+    checkpoint: string;
+    before: string;
+    after: string;
+    restored: Array<{
+        path: string;
+        action: "written" | "deleted";
+    }>;
+    refused: RestoreRefusal[];
+    reloaded: string[];
+    unloaded: string[];
+    configsReloaded: string[];
+    reopened: string[];
+}
+export type CheckpointEvent = {
+    type: "toggled";
+    data: {
+        editor: string;
+        enabled: boolean;
+        source: "config" | "session";
+    };
+} | {
+    type: "created";
+    data: {
+        editor: string;
+        id: string;
+        label: string;
+        trigger: CheckpointTrigger;
+        files: number;
+    };
+} | {
+    type: "restored";
+    data: {
+        editor: string;
+        checkpoint: string;
+        before: string;
+        after: string;
+        restored: string[];
+        refused: Array<{
+            path: string;
+            reason: string;
+        }>;
+    };
+} | {
+    type: "cleared";
+    data: {
+        editor: string;
+    };
+};
+/** Every session's checkpoint events. The daemon republishes them as checkpoint.* and checkpoints.*. */
+export declare function subscribeCheckpointEvents(listener: (e: CheckpointEvent) => void): () => void;
+/** `on`, `true` and the object form's `enabled` read as on; anything else as off. */
+export declare function configuredCheckpoints(value: unknown): {
+    enabled: boolean;
+    largeFileBytes: number;
+};
+export declare class SessionCheckpoints {
+    private readonly session;
+    private override;
+    private repoCache;
+    /** The generation the connected bridge records into, which a checkpoint must not fold in. */
+    private activeGeneration;
+    private warnedNoRecorder;
+    constructor(session: EditorSession);
+    private get projectDir();
+    private configured;
+    enabled(): boolean;
+    private repo;
+    private requireEnabled;
+    state(limit?: number): Promise<CheckpointState>;
+    /** The daemon's per-session override; null goes back to ue-mcp.yml. */
+    setEnabled(enabled: boolean | null): Promise<CheckpointState>;
+    /**
+     * Tell the connected bridge whether to record saves, and where. On means a
+     * fresh generation; the previous one is left for the next checkpoint.
+     */
+    private arm;
+    /** A bridge call that reports failure as null, warning once when the plugin predates the recorder. */
+    private callBridge;
+    /** Copy a file's bytes into the history before the server writes it. A no-op while off. */
+    recordBeforeWrite(file: string): void;
+    create(label?: string): Promise<CheckpointResult>;
+    private createUnlocked;
+    changes(from: string, to?: string | null, opts?: {
+        blueprintDiffs?: boolean;
+    }): Promise<ChangesResult>;
+    /** blueprint(diff) against the checkpoint, for modified Blueprint packages, run in the editor. */
+    private addBlueprintDiffs;
+    restore(checkpoint: string, opts?: {
+        paths?: string[];
+        force?: boolean;
+    }): Promise<RestoreResult>;
+    /** Delete the history. Allowed while off, which is how history kept from before is removed. */
+    clear(): Promise<{
+        editor: string;
+        cleared: true;
+    }>;
+}
+/** The session's checkpoints, created on first use; creating them creates nothing on disk. */
+export declare function checkpointsFor(session: EditorSession): SessionCheckpoints;
+/** Record a file the server is about to write, for the session a tool call runs in. */
+export declare function recordBeforeWrite(session: EditorSession | undefined, file: string): void;

package/dist/checkpoints/service.js

@@ -0,0 +1,345 @@
+/**
+ * Checkpoints per editor session (#1482): whether they are on, the bridge's
+ * save recording, and the checkpoint, changes, restore and clear operations
+ * the editor(...) actions and the daemon routes share.
+ *
+ * Off unless `checkpoints: on` is in ue-mcp.yml or the daemon turned them on
+ * for the session. While off, no shadow repository is created and the bridge
+ * is told not to intercept saves.
+ *
+ * The bridge records from UPackage::PreSavePackageWithContextEvent into the
+ * pending generation it was armed with. Arming happens on every connect, and
+ * each checkpoint re-arms it with a fresh generation, so a checkpoint folds in
+ * exactly the copies made before it.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { warn, info } from "../core/log.js";
+import { CheckpointError, DEFAULT_LARGE_FILE_BYTES, ShadowRepo, changeKind, } from "./shadow-repo.js";
+export { CheckpointError } from "./shadow-repo.js";
+/** How many Blueprint packages one list_changes diffs in the editor. */
+const MAX_BLUEPRINT_DIFFS = 25;
+const listeners = new Set();
+/** Every session's checkpoint events. The daemon republishes them as checkpoint.* and checkpoints.*. */
+export function subscribeCheckpointEvents(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+function emit(e) {
+    for (const l of listeners) {
+        try {
+            l(e);
+        }
+        catch (err) {
+            warn("checkpoints", "event listener failed", err);
+        }
+    }
+}
+/** `on`, `true` and the object form's `enabled` read as on; anything else as off. */
+export function configuredCheckpoints(value) {
+    const on = (v) => v === true || v === "on";
+    if (value && typeof value === "object") {
+        const o = value;
+        return {
+            enabled: on(o.enabled),
+            largeFileBytes: typeof o.largeFileBytes === "number" && o.largeFileBytes > 0 ? o.largeFileBytes : DEFAULT_LARGE_FILE_BYTES,
+        };
+    }
+    return { enabled: on(value), largeFileBytes: DEFAULT_LARGE_FILE_BYTES };
+}
+export class SessionCheckpoints {
+    session;
+    override = null;
+    repoCache = null;
+    /** The generation the connected bridge records into, which a checkpoint must not fold in. */
+    activeGeneration = null;
+    warnedNoRecorder = false;
+    constructor(session) {
+        this.session = session;
+        session.bridge.onConnectionChanged((change) => {
+            if (change.connected)
+                void this.arm().catch((e) => warn("checkpoints", `arming ${session.name} failed`, e));
+        });
+    }
+    get projectDir() {
+        const dir = this.session.project.projectDir;
+        if (!dir)
+            throw new CheckpointError(400, "Checkpoints need a project; this session has none");
+        return dir;
+    }
+    configured() {
+        return configuredCheckpoints(this.session.project.config.checkpoints);
+    }
+    enabled() {
+        return this.override ?? this.configured().enabled;
+    }
+    repo() {
+        const dir = this.projectDir;
+        if (!this.repoCache || this.repoCache.projectDir !== dir) {
+            this.repoCache = new ShadowRepo(dir, { largeFileBytes: this.configured().largeFileBytes });
+        }
+        return this.repoCache;
+    }
+    requireEnabled() {
+        if (!this.enabled()) {
+            throw new CheckpointError(409, "Checkpoints are off for this session. Set `checkpoints: on` in ue-mcp.yml, or turn them on through the daemon (PUT /v1/checkpoints/enabled).");
+        }
+    }
+    async state(limit = 50) {
+        const configured = this.configured().enabled;
+        const hasProject = !!this.session.project.projectDir;
+        const repo = hasProject ? this.repo() : null;
+        return {
+            editor: this.session.name,
+            enabled: this.enabled(),
+            source: this.override === null ? "config" : "session",
+            configured,
+            repository: repo?.exists() ? repo.gitdir : null,
+            checkpoints: repo ? await repo.list(limit) : [],
+        };
+    }
+    /** The daemon's per-session override; null goes back to ue-mcp.yml. */
+    async setEnabled(enabled) {
+        const was = this.enabled();
+        this.override = enabled;
+        const now = this.enabled();
+        if (now !== was || enabled === null) {
+            await this.arm().catch((e) => warn("checkpoints", `arming ${this.session.name} failed`, e));
+            emit({ type: "toggled", data: { editor: this.session.name, enabled: now, source: this.override === null ? "config" : "session" } });
+        }
+        return this.state();
+    }
+    /**
+     * Tell the connected bridge whether to record saves, and where. On means a
+     * fresh generation; the previous one is left for the next checkpoint.
+     */
+    async arm() {
+        if (!this.session.bridge.isConnected || !this.session.project.projectDir)
+            return null;
+        if (!this.enabled()) {
+            if (this.activeGeneration === null)
+                return null;
+            this.activeGeneration = null;
+            await this.callBridge("checkpoint_arm", { enabled: false });
+            return null;
+        }
+        const repo = this.repo();
+        await repo.ensure();
+        const generation = repo.newGeneration("bridge");
+        const answer = await this.callBridge("checkpoint_arm", { enabled: true, pendingDir: generation, projectDir: repo.projectDir });
+        if (!answer) {
+            fs.rmSync(generation, { recursive: true, force: true });
+            this.activeGeneration = null;
+            return null;
+        }
+        this.activeGeneration = generation;
+        const dirty = Array.isArray(answer.dirtyPackages) ? answer.dirtyPackages.map(String) : [];
+        return { dirtyPackages: dirty };
+    }
+    /** A bridge call that reports failure as null, warning once when the plugin predates the recorder. */
+    async callBridge(method, params) {
+        try {
+            const r = (await this.session.bridge.call(method, params));
+            if (r && r.success === false) {
+                if (method !== "checkpoint_arm")
+                    throw new CheckpointError(409, String(r.error ?? `${method} failed`));
+                warn("checkpoints", `${method}: ${String(r.error ?? "failed")}`);
+                return null;
+            }
+            return r ?? {};
+        }
+        catch (e) {
+            if (e instanceof CheckpointError)
+                throw e;
+            const message = e instanceof Error ? e.message : String(e);
+            if (/unknown method/i.test(message)) {
+                if (!this.warnedNoRecorder) {
+                    this.warnedNoRecorder = true;
+                    warn("checkpoints", `The editor's bridge plugin predates checkpoints (${method}); package saves are not recorded until it is updated.`);
+                }
+                return null;
+            }
+            if (method === "checkpoint_arm") {
+                warn("checkpoints", `${method} failed`, e);
+                return null;
+            }
+            throw e;
+        }
+    }
+    /** Copy a file's bytes into the history before the server writes it. A no-op while off. */
+    recordBeforeWrite(file) {
+        if (!this.enabled() || !this.session.project.projectDir)
+            return;
+        try {
+            this.repo().recordBeforeWrite(file);
+        }
+        catch (e) {
+            warn("checkpoints", `could not record ${file} before writing it`, e);
+        }
+    }
+    create(label) {
+        this.requireEnabled();
+        return this.repo().serialize(() => this.createUnlocked(label ?? "", "client"));
+    }
+    async createUnlocked(label, trigger, expected) {
+        const repo = this.repo();
+        // Re-arm first, so every save before this point is in a generation this checkpoint folds in.
+        const armed = await this.arm();
+        const connected = armed !== null;
+        const out = await repo.checkpoint({
+            label,
+            trigger,
+            activeGeneration: connected ? this.activeGeneration : null,
+            expected,
+        });
+        emit({ type: "created", data: { editor: this.session.name, id: out.info.id, label: out.info.label, trigger, files: out.info.files } });
+        return {
+            ...out.info,
+            editor: this.session.name,
+            changes: out.changes,
+            dirtyPackages: armed?.dirtyPackages ?? [],
+            editorConnected: connected,
+        };
+    }
+    async changes(from, to, opts = {}) {
+        if (!from)
+            throw new CheckpointError(400, "from is required: the checkpoint id to compare against");
+        const repo = this.repo();
+        return repo.serialize(async () => {
+            const result = await repo.changes(from, to ?? null);
+            if (opts.blueprintDiffs !== false && this.session.bridge.isConnected)
+                await this.addBlueprintDiffs(result);
+            return { editor: this.session.name, ...result };
+        });
+    }
+    /** blueprint(diff) against the checkpoint, for modified Blueprint packages, run in the editor. */
+    async addBlueprintDiffs(result) {
+        const repo = this.repo();
+        const candidates = result.changes
+            .filter((c) => c.status === "modified" && !c.large && c.path.toLowerCase().endsWith(".uasset"))
+            .slice(0, MAX_BLUEPRINT_DIFFS);
+        // Saved/Diff maps to /Temp, which is where the editor loads a package for diffing.
+        const tempDir = path.join(this.projectDir, "Saved", "Diff", "UE_MCP_Checkpoints");
+        for (const c of candidates) {
+            const base = path.basename(c.path, path.extname(c.path));
+            const fromFile = path.join(tempDir, `${base}-${result.from.slice(0, 10)}.uasset`);
+            const toFile = result.to ? path.join(tempDir, `${base}-${result.to.slice(0, 10)}.uasset`) : null;
+            try {
+                if (!(await repo.exportAt(result.from, c.path, fromFile)))
+                    continue;
+                if (toFile && !(await repo.exportAt(result.to, c.path, toFile)))
+                    continue;
+                const answer = await this.callBridge("checkpoint_diff_blueprint", {
+                    originalFile: path.join(this.projectDir, c.path),
+                    fromFile,
+                    ...(toFile ? { toFile } : {}),
+                });
+                if (answer && answer.isBlueprint === true) {
+                    const { success: _s, isBlueprint: _b, ...diff } = answer;
+                    c.blueprintDiff = diff;
+                }
+            }
+            catch (e) {
+                warn("checkpoints", `blueprint diff of ${c.path} failed`, e);
+            }
+            finally {
+                fs.rmSync(fromFile, { force: true });
+                if (toFile)
+                    fs.rmSync(toFile, { force: true });
+            }
+        }
+    }
+    restore(checkpoint, opts = {}) {
+        this.requireEnabled();
+        if (!checkpoint)
+            throw new CheckpointError(400, "checkpoint is required: the id to restore to");
+        const repo = this.repo();
+        return repo.serialize(async () => {
+            const connected = this.session.bridge.isConnected;
+            // Refuse during PIE before anything is recorded or written.
+            if (connected)
+                await this.callBridge("checkpoint_prepare_restore", { files: [], checkOnly: true });
+            const needle = checkpoint.trim().toLowerCase();
+            const matches = (await repo.list(Number.MAX_SAFE_INTEGER)).filter((c) => c.id.startsWith(needle));
+            if (matches.length !== 1) {
+                throw new CheckpointError(400, matches.length === 0 ? `No checkpoint '${checkpoint}' in this project's history` : `'${checkpoint}' matches ${matches.length} checkpoints; give more of the id`);
+            }
+            const target = matches[0];
+            const before = await this.createUnlocked(`before restore to ${target.label}`, "restore-before");
+            const { plan, refused } = await repo.planRestore(target.id, before.id, opts.paths, opts.force === true);
+            const prepared = connected && plan.length > 0
+                ? await this.callBridge("checkpoint_prepare_restore", { files: plan.map((p) => p.file) })
+                : null;
+            const restored = [];
+            for (const entry of plan) {
+                try {
+                    restored.push({ path: entry.path, action: await repo.apply(entry) });
+                }
+                catch (e) {
+                    refused.push({ path: entry.path, reason: "write-failed", detail: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            const finished = connected && plan.length > 0
+                ? await this.callBridge("checkpoint_finish_restore", {
+                    files: restored.map((r) => ({ file: path.join(repo.projectDir, r.path), exists: r.action === "written", kind: changeKind(r.path) })),
+                    reopen: Array.isArray(prepared?.closedEditors) ? prepared.closedEditors : [],
+                })
+                : null;
+            const after = await this.createUnlocked(`restored to ${target.label}`, "restore-after", restored.map((r) => r.path));
+            const strings = (v) => (Array.isArray(v) ? v.map(String) : []);
+            const result = {
+                editor: this.session.name,
+                checkpoint: target.id,
+                before: before.id,
+                after: after.id,
+                restored,
+                refused,
+                reloaded: strings(finished?.reloaded),
+                unloaded: strings(finished?.unloaded),
+                configsReloaded: strings(finished?.configsReloaded),
+                reopened: strings(finished?.reopened),
+            };
+            emit({
+                type: "restored",
+                data: {
+                    editor: this.session.name,
+                    checkpoint: result.checkpoint,
+                    before: result.before,
+                    after: result.after,
+                    restored: restored.map((r) => r.path),
+                    refused: refused.map((r) => ({ path: r.path, reason: r.reason })),
+                },
+            });
+            info("checkpoints", `${this.session.name}: restored ${restored.length} path(s) to ${result.checkpoint.slice(0, 10)}, refused ${refused.length}`);
+            return result;
+        });
+    }
+    /** Delete the history. Allowed while off, which is how history kept from before is removed. */
+    async clear() {
+        const repo = this.repo();
+        await repo.serialize(async () => {
+            repo.clear();
+            this.activeGeneration = null;
+            if (this.enabled())
+                await this.arm().catch((e) => warn("checkpoints", "re-arming after clear failed", e));
+        });
+        emit({ type: "cleared", data: { editor: this.session.name } });
+        return { editor: this.session.name, cleared: true };
+    }
+}
+const bySession = new WeakMap();
+/** The session's checkpoints, created on first use; creating them creates nothing on disk. */
+export function checkpointsFor(session) {
+    let c = bySession.get(session);
+    if (!c) {
+        c = new SessionCheckpoints(session);
+        bySession.set(session, c);
+    }
+    return c;
+}
+/** Record a file the server is about to write, for the session a tool call runs in. */
+export function recordBeforeWrite(session, file) {
+    if (session)
+        checkpointsFor(session).recordBeforeWrite(file);
+}
+//# sourceMappingURL=service.js.map

package/dist/checkpoints/service.js.map

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