flockbay 0.10.43 → 0.10.44

package/bin/flockbay-mcp.mjs

@@ -3,7 +3,7 @@
 import { execFileSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 // Ensure Node flags to reduce noisy warnings on stdout (which could interfere with MCP).
 const hasNoWarnings = process.execArgv.includes('--no-warnings');
@@ -25,7 +25,13 @@ function resolveTsxImportArgs() {
     join(projectRoot, 'node_modules', 'tsx', 'dist', 'index.js'),
   ];
   const resolved = candidates.find(existsSync);
-  return resolved ? ['--import', resolved] : ['--import', 'tsx'];
+  return resolved ? ['--import', toNodeSpecifier(resolved)] : ['--import', 'tsx'];
+}
+
+function toNodeSpecifier(p) {
+  if (process.platform !== 'win32') return p;
+  if (!/^[a-zA-Z]:[\\/]/.test(p)) return p;
+  return pathToFileURL(p).href;
 }
 
 if (!hasNoWarnings || !hasNoDeprecation || useTsx) {

package/bin/flockbay.mjs

@@ -3,7 +3,7 @@
 import { execFileSync } from 'node:child_process';
 import { existsSync, statSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 // Ensure Node flags to reduce noisy warnings on stdout.
 const hasNoWarnings = process.execArgv.includes('--no-warnings');
@@ -54,7 +54,13 @@ function resolveTsxImportArgs() {
     join(projectRoot, 'node_modules', 'tsx', 'dist', 'index.js'),
   ];
   const resolved = candidates.find(existsSync);
-  return resolved ? ['--import', resolved] : ['--import', 'tsx'];
+  return resolved ? ['--import', toNodeSpecifier(resolved)] : ['--import', 'tsx'];
+}
+
+function toNodeSpecifier(p) {
+  if (process.platform !== 'win32') return p;
+  if (!/^[a-zA-Z]:[\\/]/.test(p)) return p;
+  return pathToFileURL(p).href;
 }
 
 const rewrittenArgs = rewriteTopLevelAliases(process.argv.slice(2));

package/dist/{index-ZFx58JSw.mjs → index-BfBX93aY.mjs}

@@ -2,7 +2,7 @@ import{createRequire as _pkgrollCR}from"node:module";const require=_pkgrollCR(im
 import * as os from 'node:os';
 import os__default, { homedir } from 'node:os';
 import { randomUUID, createCipheriv, randomBytes, createHash as createHash$1 } from 'node:crypto';
-import { l as logger, b as projectPath, d as backoff, e as delay, R as RawJSONLinesSchema, c as configuration, f as readDaemonState, g as clearDaemonState, p as packageJson, r as readSettings, h as readCredentials, u as updateSettings, o as openBrowser, w as writeCredentials, j as unrealMcpPythonDir, k as acquireDaemonLock, m as writeDaemonState, n as ApiMachineClient, q as releaseDaemonLock, s as sendUnrealMcpTcpCommand, A as ApiClient, v as validatePath, t as run, x as run$1, y as buildShellInvocation, z as clearCredentials, B as clearMachineId, C as authenticateCodex, D as syncCodexCliAuth, E as authenticateClaude, F as authenticateGemini, i as installUnrealMcpPluginToEngine, G as buildAndInstallUnrealMcpPlugin, H as installUnrealMcpPluginToProject, I as getLatestDaemonLog, J as normalizeServerUrlForNode } from './types-1s9-Oj5w.mjs';
+import { l as logger, b as projectPath, d as backoff, e as delay, R as RawJSONLinesSchema, c as configuration, f as readDaemonState, g as clearDaemonState, p as packageJson, r as readSettings, h as readCredentials, u as updateSettings, o as openBrowser, w as writeCredentials, j as unrealMcpPythonDir, k as acquireDaemonLock, m as writeDaemonState, n as ApiMachineClient, q as releaseDaemonLock, s as sendUnrealMcpTcpCommand, A as ApiClient, v as validatePath, t as run, x as run$1, y as buildShellInvocation, z as clearCredentials, B as clearMachineId, C as authenticateCodex, D as syncCodexCliAuth, E as authenticateClaude, F as authenticateGemini, i as installUnrealMcpPluginToEngine, G as buildAndInstallUnrealMcpPlugin, H as installUnrealMcpPluginToProject, I as getLatestDaemonLog, J as normalizeServerUrlForNode } from './types-D8EqTVgB.mjs';
 import { spawn, execFileSync, execSync } from 'node:child_process';
 import * as path from 'node:path';
 import path__default, { resolve, join, dirname } from 'node:path';
@@ -14,7 +14,7 @@ import fs$1, { readFile, access as access$1, mkdir, readdir, stat, writeFile, co
 import fs$2, { watch, access, mkdir as mkdir$1, writeFile as writeFile$1, rm } from 'fs/promises';
 import { useStdout, useInput, Box, Text, render } from 'ink';
 import React, { useState, useRef, useEffect, useCallback } from 'react';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import axios from 'axios';
 import 'socket.io-client';
 import { spawn as spawn$1, execFileSync as execFileSync$1 } from 'child_process';
@@ -5261,13 +5261,35 @@ function resolveTsxImportArgs(projectRoot) {
     join(projectRoot, "node_modules", "tsx", "dist", "index.js")
   ];
   const resolved = candidates.find(existsSync);
-  return resolved ? ["--import", resolved] : ["--import", "tsx"];
+  return resolved ? ["--import", toNodeSpecifier(resolved)] : ["--import", "tsx"];
+}
+function toNodeSpecifier(p) {
+  if (process$1.platform !== "win32") return p;
+  if (!/^[a-zA-Z]:[\\/]/.test(p)) return p;
+  return pathToFileURL(p).href;
 }
 function spawnFlockbayCLI(args, options = {}) {
   const projectRoot = projectPath();
   const distEntrypoint = join(projectRoot, "dist", "index.mjs");
   const devEntrypoint = join(projectRoot, "src", "index.ts");
-  const entrypoint = existsSync(distEntrypoint) ? distEntrypoint : devEntrypoint;
+  const entrypoint = (() => {
+    const forceSrc = process$1.env.FLOCKBAY_USE_SRC === "1";
+    const forceDist = process$1.env.FLOCKBAY_USE_DIST === "1";
+    const hasDist = existsSync(distEntrypoint);
+    const hasDev = existsSync(devEntrypoint);
+    if (forceSrc && hasDev) return devEntrypoint;
+    if (forceDist && hasDist) return distEntrypoint;
+    if (hasDist && hasDev) {
+      try {
+        const devTime = statSync(devEntrypoint).mtimeMs;
+        const distTime = statSync(distEntrypoint).mtimeMs;
+        if (devTime > distTime) return devEntrypoint;
+      } catch {
+      }
+      return distEntrypoint;
+    }
+    return hasDist ? distEntrypoint : devEntrypoint;
+  })();
   const useTsx = entrypoint.endsWith(".ts");
   const desiredCwd = "cwd" in options && typeof options.cwd === "string" ? options.cwd : process$1.cwd();
   const windowsHide = typeof options?.windowsHide === "boolean" ? Boolean(options.windowsHide) : process$1.platform === "win32";
@@ -5683,12 +5705,14 @@ async function enforceCliVersionPolicy(opts) {
   const policy = await fetchCliVersionPolicy({ serverUrl: opts.serverUrl, timeoutMs: opts.timeoutMs });
   const evaluation = evaluateCliVersion({ currentVersion, policy });
   if (evaluation.status === "update_required") {
-    const header = `CLI update required (installed: ${currentVersion}, required: ${evaluation.minimumSupported})`;
-    const msg = evaluation.message ? `
-${evaluation.message}` : "";
-    const help = `
-Update: ${evaluation.updateCommand}`;
-    throw new Error(`${header}${msg}${help}`);
+    try {
+      opts.onUpdateRequired?.({
+        minimumSupported: evaluation.minimumSupported,
+        updateCommand: evaluation.updateCommand,
+        message: evaluation.message
+      });
+    } catch {
+    }
   }
   if (evaluation.status === "update_available") {
     try {
@@ -5789,6 +5813,14 @@ async function startDaemon() {
         serverUrl: configuration.serverUrl,
         currentVersion: packageJson.version,
         timeoutMs: Number.parseInt(process.env.FLOCKBAY_CLI_VERSION_CHECK_TIMEOUT_MS || "3000", 10) || 3e3,
+        onUpdateRequired: ({ minimumSupported, updateCommand, message }) => {
+          const note = message ? `
+${message}` : "";
+          console.error(
+            `CLI update required (installed: ${packageJson.version}, required: ${minimumSupported})${note}
+Update: ${updateCommand}`
+          );
+        },
         onUpdateAvailable: ({ latest, updateCommand, message }) => {
           const note = message ? `
 ${message}` : "";
@@ -5798,12 +5830,7 @@ Update: ${updateCommand}`);
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      if (/^CLI update required\b/i.test(msg)) {
-        console.error(msg);
-        process.exit(1);
-      } else {
-        logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
-      }
+      logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
     }
     logger.debug("[DAEMON RUN] Auth and machine setup complete");
     const shouldStartUnrealMcp = String(process.env.FLOCKBAY_UNREAL_MCP_ENABLED || "").trim() === "1";
@@ -6579,10 +6606,18 @@ Log: ${logPath || `not found (check ${configuration.logsDir})`}` + formatLogExce
           cliPolicyCheckInFlight = true;
           lastCliPolicyCheckAtMs = Date.now();
           try {
-            await enforceCliVersionPolicy({
+            const { evaluation } = await enforceCliVersionPolicy({
               serverUrl: configuration.serverUrl,
               currentVersion: packageJson.version,
               timeoutMs: Number.parseInt(process.env.FLOCKBAY_CLI_VERSION_CHECK_TIMEOUT_MS || "3000", 10) || 3e3,
+              onUpdateRequired: ({ minimumSupported, updateCommand, message }) => {
+                const note = message ? `
+${message}` : "";
+                logger.debug(
+                  `[DAEMON RUN] CLI update required (installed: ${packageJson.version}, required: ${minimumSupported}).${note}
+Update: ${updateCommand}`
+                );
+              },
               onUpdateAvailable: ({ latest, updateCommand, message }) => {
                 const note = message ? `
 ${message}` : "";
@@ -6592,13 +6627,10 @@ Update: ${updateCommand}`
                 );
               }
             });
+            if (evaluation.status === "update_required") {
+            }
           } catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            if (/^CLI update required\b/i.test(msg)) {
-              logger.debug("[DAEMON RUN] CLI update required; shutting down daemon:", msg);
-              requestShutdown("exception", msg);
-              return;
-            }
             logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
           } finally {
             cliPolicyCheckInFlight = false;
@@ -14882,7 +14914,8 @@ async function startDaemonDetachedOrExit(opts) {
         console.log(chalk.gray(`Daemon:   ${daemon?.pid ? `pid=${daemon.pid} port=${daemon.httpPort}` : "not running"}`));
         console.log("");
         if (opts?.openWebapp) openUrlBestEffort(configuration.webappUrl);
-        process.exit(0);
+        process.exitCode = 0;
+        return;
       }
       const authMismatch = lastUpsertStatus === 401 || /unauthorized/i.test(lastConnectError);
       if (authMismatch && !opts?.reauthAttempted) {
@@ -14953,7 +14986,8 @@ async function startDaemonDetachedOrExit(opts) {
     console.log(chalk.gray(`Daemon:   ${daemon?.pid ? `pid=${daemon.pid} port=${daemon.httpPort}` : "not running"}`));
     console.log("");
     if (opts?.openWebapp) openUrlBestEffort(configuration.webappUrl);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   } else {
     const latest = await getLatestDaemonLog();
     if (latest?.path) console.error(`Latest daemon log: ${latest.path}`);
@@ -15083,7 +15117,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-BenVKITz.mjs');
+        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-DAAX2TDX.mjs');
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15222,7 +15256,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await import('./runCodex-aBjsormW.mjs');
+      const { runCodex } = await import('./runCodex-C_dwGw9p.mjs');
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {
@@ -15324,7 +15358,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await import('./runGemini-D9bi1Ih3.mjs');
+      const { runGemini } = await import('./runGemini-CWiIoJag.mjs');
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {

package/dist/{index-Bih-iANW.cjs → index-CVBvClyV.cjs}

@@ -3,7 +3,7 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var types = require('./types-DTy-RPNv.cjs');
+var types = require('./types-tRJ8NBIX.cjs');
 var node_child_process = require('node:child_process');
 var path = require('node:path');
 var node_readline = require('node:readline');
@@ -1316,7 +1316,7 @@ function buildDaemonSafeEnv(baseEnv, binPath) {
   env[pathKey] = [...prepend, ...existingParts].join(pathSep);
   return env;
 }
-const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-Bih-iANW.cjs', document.baseURI).href)));
+const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-CVBvClyV.cjs', document.baseURI).href)));
 const __dirname$1 = path.join(__filename$1, "..");
 function getGlobalClaudeVersion(claudeExecutable) {
   try {
@@ -5283,13 +5283,35 @@ function resolveTsxImportArgs(projectRoot) {
     path.join(projectRoot, "node_modules", "tsx", "dist", "index.js")
   ];
   const resolved = candidates.find(fs.existsSync);
-  return resolved ? ["--import", resolved] : ["--import", "tsx"];
+  return resolved ? ["--import", toNodeSpecifier(resolved)] : ["--import", "tsx"];
+}
+function toNodeSpecifier(p) {
+  if (process$1.platform !== "win32") return p;
+  if (!/^[a-zA-Z]:[\\/]/.test(p)) return p;
+  return node_url.pathToFileURL(p).href;
 }
 function spawnFlockbayCLI(args, options = {}) {
   const projectRoot = types.projectPath();
   const distEntrypoint = path.join(projectRoot, "dist", "index.mjs");
   const devEntrypoint = path.join(projectRoot, "src", "index.ts");
-  const entrypoint = fs.existsSync(distEntrypoint) ? distEntrypoint : devEntrypoint;
+  const entrypoint = (() => {
+    const forceSrc = process$1.env.FLOCKBAY_USE_SRC === "1";
+    const forceDist = process$1.env.FLOCKBAY_USE_DIST === "1";
+    const hasDist = fs.existsSync(distEntrypoint);
+    const hasDev = fs.existsSync(devEntrypoint);
+    if (forceSrc && hasDev) return devEntrypoint;
+    if (forceDist && hasDist) return distEntrypoint;
+    if (hasDist && hasDev) {
+      try {
+        const devTime = fs.statSync(devEntrypoint).mtimeMs;
+        const distTime = fs.statSync(distEntrypoint).mtimeMs;
+        if (devTime > distTime) return devEntrypoint;
+      } catch {
+      }
+      return distEntrypoint;
+    }
+    return hasDist ? distEntrypoint : devEntrypoint;
+  })();
   const useTsx = entrypoint.endsWith(".ts");
   const desiredCwd = "cwd" in options && typeof options.cwd === "string" ? options.cwd : process$1.cwd();
   const windowsHide = typeof options?.windowsHide === "boolean" ? Boolean(options.windowsHide) : process$1.platform === "win32";
@@ -5705,12 +5727,14 @@ async function enforceCliVersionPolicy(opts) {
   const policy = await fetchCliVersionPolicy({ serverUrl: opts.serverUrl, timeoutMs: opts.timeoutMs });
   const evaluation = evaluateCliVersion({ currentVersion, policy });
   if (evaluation.status === "update_required") {
-    const header = `CLI update required (installed: ${currentVersion}, required: ${evaluation.minimumSupported})`;
-    const msg = evaluation.message ? `
-${evaluation.message}` : "";
-    const help = `
-Update: ${evaluation.updateCommand}`;
-    throw new Error(`${header}${msg}${help}`);
+    try {
+      opts.onUpdateRequired?.({
+        minimumSupported: evaluation.minimumSupported,
+        updateCommand: evaluation.updateCommand,
+        message: evaluation.message
+      });
+    } catch {
+    }
   }
   if (evaluation.status === "update_available") {
     try {
@@ -5811,6 +5835,14 @@ async function startDaemon() {
         serverUrl: types.configuration.serverUrl,
         currentVersion: types.packageJson.version,
         timeoutMs: Number.parseInt(process.env.FLOCKBAY_CLI_VERSION_CHECK_TIMEOUT_MS || "3000", 10) || 3e3,
+        onUpdateRequired: ({ minimumSupported, updateCommand, message }) => {
+          const note = message ? `
+${message}` : "";
+          console.error(
+            `CLI update required (installed: ${types.packageJson.version}, required: ${minimumSupported})${note}
+Update: ${updateCommand}`
+          );
+        },
         onUpdateAvailable: ({ latest, updateCommand, message }) => {
           const note = message ? `
 ${message}` : "";
@@ -5820,12 +5852,7 @@ Update: ${updateCommand}`);
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      if (/^CLI update required\b/i.test(msg)) {
-        console.error(msg);
-        process.exit(1);
-      } else {
-        types.logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
-      }
+      types.logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
     }
     types.logger.debug("[DAEMON RUN] Auth and machine setup complete");
     const shouldStartUnrealMcp = String(process.env.FLOCKBAY_UNREAL_MCP_ENABLED || "").trim() === "1";
@@ -6601,10 +6628,18 @@ Log: ${logPath || `not found (check ${types.configuration.logsDir})`}` + formatL
           cliPolicyCheckInFlight = true;
           lastCliPolicyCheckAtMs = Date.now();
           try {
-            await enforceCliVersionPolicy({
+            const { evaluation } = await enforceCliVersionPolicy({
               serverUrl: types.configuration.serverUrl,
               currentVersion: types.packageJson.version,
               timeoutMs: Number.parseInt(process.env.FLOCKBAY_CLI_VERSION_CHECK_TIMEOUT_MS || "3000", 10) || 3e3,
+              onUpdateRequired: ({ minimumSupported, updateCommand, message }) => {
+                const note = message ? `
+${message}` : "";
+                types.logger.debug(
+                  `[DAEMON RUN] CLI update required (installed: ${types.packageJson.version}, required: ${minimumSupported}).${note}
+Update: ${updateCommand}`
+                );
+              },
               onUpdateAvailable: ({ latest, updateCommand, message }) => {
                 const note = message ? `
 ${message}` : "";
@@ -6614,13 +6649,10 @@ Update: ${updateCommand}`
                 );
               }
             });
+            if (evaluation.status === "update_required") {
+            }
           } catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            if (/^CLI update required\b/i.test(msg)) {
-              types.logger.debug("[DAEMON RUN] CLI update required; shutting down daemon:", msg);
-              requestShutdown("exception", msg);
-              return;
-            }
             types.logger.debug("[DAEMON RUN] CLI version policy check failed (non-fatal):", msg);
           } finally {
             cliPolicyCheckInFlight = false;
@@ -14904,7 +14936,8 @@ async function startDaemonDetachedOrExit(opts) {
         console.log(chalk.gray(`Daemon:   ${daemon?.pid ? `pid=${daemon.pid} port=${daemon.httpPort}` : "not running"}`));
         console.log("");
         if (opts?.openWebapp) openUrlBestEffort(types.configuration.webappUrl);
-        process.exit(0);
+        process.exitCode = 0;
+        return;
       }
       const authMismatch = lastUpsertStatus === 401 || /unauthorized/i.test(lastConnectError);
       if (authMismatch && !opts?.reauthAttempted) {
@@ -14975,7 +15008,8 @@ async function startDaemonDetachedOrExit(opts) {
     console.log(chalk.gray(`Daemon:   ${daemon?.pid ? `pid=${daemon.pid} port=${daemon.httpPort}` : "not running"}`));
     console.log("");
     if (opts?.openWebapp) openUrlBestEffort(types.configuration.webappUrl);
-    process.exit(0);
+    process.exitCode = 0;
+    return;
   } else {
     const latest = await types.getLatestDaemonLog();
     if (latest?.path) console.error(`Latest daemon log: ${latest.path}`);
@@ -15105,7 +15139,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-CrSh19dY.cjs'); });
+        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-BL02mitg.cjs'); });
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15244,7 +15278,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-CJa61r9H.cjs'); });
+      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-DcQmhprg.cjs'); });
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {
@@ -15346,7 +15380,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-gcPF3ASy.cjs'); });
+      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-CJF0id5I.cjs'); });
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 require('chalk');
-require('./index-Bih-iANW.cjs');
-require('./types-DTy-RPNv.cjs');
+require('./index-CVBvClyV.cjs');
+require('./types-tRJ8NBIX.cjs');
 require('zod');
 require('node:child_process');
 require('node:fs');

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import 'chalk';
-import './index-ZFx58JSw.mjs';
-import './types-1s9-Oj5w.mjs';
+import './index-BfBX93aY.mjs';
+import './types-D8EqTVgB.mjs';
 import 'zod';
 import 'node:child_process';
 import 'node:fs';

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-DTy-RPNv.cjs');
+var types = require('./types-tRJ8NBIX.cjs');
 require('axios');
 require('node:fs');
 require('node:os');

package/dist/lib.mjs

@@ -1,4 +1,4 @@
-export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-1s9-Oj5w.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-D8EqTVgB.mjs';
 import 'axios';
 import 'node:fs';
 import 'node:os';

package/dist/{migratePlugin-CrSh19dY.cjs → migratePlugin-BL02mitg.cjs}

@@ -2,7 +2,7 @@
 
 var fs = require('node:fs');
 var path = require('node:path');
-var types = require('./types-DTy-RPNv.cjs');
+var types = require('./types-tRJ8NBIX.cjs');
 require('axios');
 require('node:os');
 require('node:events');

package/dist/{migratePlugin-BenVKITz.mjs → migratePlugin-DAAX2TDX.mjs}

@@ -1,6 +1,6 @@
 import fs__default from 'node:fs';
 import path__default from 'node:path';
-import { i as installUnrealMcpPluginToEngine } from './types-1s9-Oj5w.mjs';
+import { i as installUnrealMcpPluginToEngine } from './types-D8EqTVgB.mjs';
 import 'axios';
 import 'node:os';
 import 'node:events';

package/dist/{runCodex-aBjsormW.mjs → runCodex-C_dwGw9p.mjs}

@@ -1,6 +1,6 @@
 import { useStdout, useInput, Box, Text, render } from 'ink';
 import React, { useState, useRef, useEffect, useCallback } from 'react';
-import { l as logger, A as ApiClient, p as packageJson, c as configuration, r as readSettings, b as projectPath } from './types-1s9-Oj5w.mjs';
+import { l as logger, A as ApiClient, p as packageJson, c as configuration, r as readSettings, b as projectPath } from './types-D8EqTVgB.mjs';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { z } from 'zod';
@@ -10,7 +10,7 @@ import fs__default from 'node:fs';
 import os__default from 'node:os';
 import path__default, { resolve, join } from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { s as shouldCountToolCall, c as consumeToolQuota, f as formatQuotaDeniedReason, h as hashObject, e as enforceCliVersionPolicy, i as initialMachineMetadata, E as ElicitationHub, n as notifyDaemonSessionStarted, M as MessageQueue2, P as PLATFORM_SYSTEM_PROMPT, a as setLatestUserImages, w as withUserImagesMarker, r as registerKillSessionHandler, b as MessageBuffer, d as startFlockbayServer, g as buildProjectCapsule, t as trimIdent, j as autoFinalizeCoordinationWorkItem, k as detectScreenshotsForGate, l as applyCoordinationSideEffectsFromMcpToolResult, m as stopCaffeinate } from './index-ZFx58JSw.mjs';
+import { s as shouldCountToolCall, c as consumeToolQuota, f as formatQuotaDeniedReason, h as hashObject, e as enforceCliVersionPolicy, i as initialMachineMetadata, E as ElicitationHub, n as notifyDaemonSessionStarted, M as MessageQueue2, P as PLATFORM_SYSTEM_PROMPT, a as setLatestUserImages, w as withUserImagesMarker, r as registerKillSessionHandler, b as MessageBuffer, d as startFlockbayServer, g as buildProjectCapsule, t as trimIdent, j as autoFinalizeCoordinationWorkItem, k as detectScreenshotsForGate, l as applyCoordinationSideEffectsFromMcpToolResult, m as stopCaffeinate } from './index-BfBX93aY.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';

package/dist/{runCodex-CJa61r9H.cjs → runCodex-DcQmhprg.cjs}

@@ -2,7 +2,7 @@
 
 var ink = require('ink');
 var React = require('react');
-var types = require('./types-DTy-RPNv.cjs');
+var types = require('./types-tRJ8NBIX.cjs');
 var index_js = require('@modelcontextprotocol/sdk/client/index.js');
 var stdio_js = require('@modelcontextprotocol/sdk/client/stdio.js');
 var z = require('zod');
@@ -12,7 +12,7 @@ var fs = require('node:fs');
 var os = require('node:os');
 var path = require('node:path');
 var node_child_process = require('node:child_process');
-var index = require('./index-Bih-iANW.cjs');
+var index = require('./index-CVBvClyV.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');

package/dist/{runGemini-gcPF3ASy.cjs → runGemini-CJF0id5I.cjs}

@@ -6,8 +6,8 @@ var node_crypto = require('node:crypto');
 var os = require('node:os');
 var path = require('node:path');
 var fs$2 = require('node:fs/promises');
-var types = require('./types-DTy-RPNv.cjs');
-var index = require('./index-Bih-iANW.cjs');
+var types = require('./types-tRJ8NBIX.cjs');
+var index = require('./index-CVBvClyV.cjs');
 var node_child_process = require('node:child_process');
 var sdk = require('@agentclientprotocol/sdk');
 var fs = require('fs');

package/dist/{runGemini-D9bi1Ih3.mjs → runGemini-CWiIoJag.mjs}

@@ -4,8 +4,8 @@ import { randomUUID, createHash } from 'node:crypto';
 import os__default from 'node:os';
 import path__default, { resolve, join as join$1, basename } from 'node:path';
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
-import { l as logger, p as packageJson, A as ApiClient, c as configuration, r as readSettings, b as projectPath } from './types-1s9-Oj5w.mjs';
-import { s as shouldCountToolCall, c as consumeToolQuota, f as formatQuotaDeniedReason, h as hashObject, e as enforceCliVersionPolicy, i as initialMachineMetadata, n as notifyDaemonSessionStarted, M as MessageQueue2, g as buildProjectCapsule, a as setLatestUserImages, b as MessageBuffer, w as withUserImagesMarker, r as registerKillSessionHandler, d as startFlockbayServer, o as extractUserImagesMarker, p as getLatestUserImages, P as PLATFORM_SYSTEM_PROMPT, j as autoFinalizeCoordinationWorkItem, E as ElicitationHub, k as detectScreenshotsForGate, m as stopCaffeinate } from './index-ZFx58JSw.mjs';
+import { l as logger, p as packageJson, A as ApiClient, c as configuration, r as readSettings, b as projectPath } from './types-D8EqTVgB.mjs';
+import { s as shouldCountToolCall, c as consumeToolQuota, f as formatQuotaDeniedReason, h as hashObject, e as enforceCliVersionPolicy, i as initialMachineMetadata, n as notifyDaemonSessionStarted, M as MessageQueue2, g as buildProjectCapsule, a as setLatestUserImages, b as MessageBuffer, w as withUserImagesMarker, r as registerKillSessionHandler, d as startFlockbayServer, o as extractUserImagesMarker, p as getLatestUserImages, P as PLATFORM_SYSTEM_PROMPT, j as autoFinalizeCoordinationWorkItem, E as ElicitationHub, k as detectScreenshotsForGate, m as stopCaffeinate } from './index-BfBX93aY.mjs';
 import { spawn, spawnSync } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';

package/dist/{types-1s9-Oj5w.mjs → types-D8EqTVgB.mjs}

@@ -23,7 +23,7 @@ import { createServer } from 'http';
 import open$2 from 'open';
 
 var name = "flockbay";
-var version = "0.10.43";
+var version = "0.10.44";
 var description = "Flockbay CLI (local agent + daemon)";
 var author = "Eduardo Orellana";
 var license = "UNLICENSED";
@@ -3397,11 +3397,11 @@ function createBackoff(opts) {
 }
 let backoff = createBackoff();
 
-function looksLikeEngineRoot(engineRoot) {
+function looksLikeEngineRoot$1(engineRoot) {
   if (!engineRoot) return false;
   return fs__default.existsSync(path__default.join(engineRoot, "Engine")) && fs__default.existsSync(path__default.join(engineRoot, "Engine", "Plugins"));
 }
-function findFilesNamedUnderDir(options) {
+function findFilesNamedUnderDir$1(options) {
   const rootDir = options.rootDir;
   const filename = options.filename;
   const maxDepth = Math.max(0, Math.floor(options.maxDepth));
@@ -3429,7 +3429,7 @@ function findFilesNamedUnderDir(options) {
 }
 function installUnrealMcpPluginToEngine(engineRootRaw) {
   const engineRoot = (engineRootRaw || "").trim();
-  if (!looksLikeEngineRoot(engineRoot)) {
+  if (!looksLikeEngineRoot$1(engineRoot)) {
     return {
       ok: false,
       errorMessage: `Invalid engine root (expected an Unreal Engine install folder containing Engine/\u2026): ${engineRoot || "(empty)"}`
@@ -3443,7 +3443,7 @@ function installUnrealMcpPluginToEngine(engineRootRaw) {
   const destUpluginPath = path__default.join(destDir, "FlockbayMCP.uplugin");
   try {
     const enginePluginsDir = path__default.join(engineRoot, "Engine", "Plugins");
-    const candidates = findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 });
+    const candidates = findFilesNamedUnderDir$1({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 });
     const otherCopies = candidates.map((p) => path__default.resolve(p)).filter((p) => !p.startsWith(path__default.resolve(destDir) + path__default.sep));
     if (otherCopies.length > 0) {
       return {
@@ -3463,7 +3463,7 @@ Fix:
 - Re-run the Flockbay MCP plugin install, then restart Unreal Editor so it rebuilds the plugin`
       };
     }
-    const legacyCandidates = findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 });
+    const legacyCandidates = findFilesNamedUnderDir$1({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 });
     if (legacyCandidates.length > 0) {
       return {
         ok: false,
@@ -3542,7 +3542,7 @@ Error: ${message}`
   }
 }
 
-function readJsonIfPossible(filePath) {
+function readJsonIfPossible$1(filePath) {
   try {
     return JSON.parse(fs__default.readFileSync(filePath, "utf8"));
   } catch {
@@ -3553,7 +3553,7 @@ function writeJsonPretty(filePath, value) {
   fs__default.writeFileSync(filePath, JSON.stringify(value, null, 2) + "\n", "utf8");
 }
 function ensureProjectPluginEnabled(uprojectPath, pluginName) {
-  const parsed = readJsonIfPossible(uprojectPath);
+  const parsed = readJsonIfPossible$1(uprojectPath);
   if (!parsed || typeof parsed !== "object") {
     return { ok: false, error: `Invalid .uproject (expected JSON): ${uprojectPath}` };
   }
@@ -3638,7 +3638,7 @@ Fix:
 Expected: ${destUpluginPath}`
     };
   }
-  const uplugin = readJsonIfPossible(destUpluginPath);
+  const uplugin = readJsonIfPossible$1(destUpluginPath);
   const friendlyName = typeof uplugin?.FriendlyName === "string" ? uplugin.FriendlyName : null;
   const createdBy = typeof uplugin?.CreatedBy === "string" ? uplugin.CreatedBy : null;
   if (friendlyName !== "Flockbay MCP" || createdBy !== "Respaced Inc.") {
@@ -3800,6 +3800,182 @@ Log: ${buildLogPath}`
   return { ok: true, buildLogPath };
 }
 
+function canWriteDir$1(dir) {
+  const root = String(dir || "").trim();
+  if (!root) return false;
+  try {
+    const tmp = path__default.join(root, `.__flockbay_write_test_${Date.now()}_${Math.random().toString(16).slice(2)}.tmp`);
+    fs__default.writeFileSync(tmp, "ok", "utf8");
+    fs__default.unlinkSync(tmp);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function looksLikeEngineRoot(engineRoot) {
+  if (!engineRoot) return false;
+  return fs__default.existsSync(path__default.join(engineRoot, "Engine", "Plugins"));
+}
+function readJsonIfPossible(filePath) {
+  try {
+    return JSON.parse(fs__default.readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function isPluginDescriptorOk(parsed) {
+  const friendlyName = typeof parsed?.FriendlyName === "string" ? parsed.FriendlyName : null;
+  const createdBy = typeof parsed?.CreatedBy === "string" ? parsed.CreatedBy : null;
+  return friendlyName === "Flockbay MCP" && createdBy === "Respaced Inc.";
+}
+function isPathUnderDir(childPath, parentDir) {
+  const child = path__default.resolve(childPath);
+  const parent = path__default.resolve(parentDir);
+  return child === parent || child.startsWith(parent + path__default.sep);
+}
+function findFilesNamedUnderDir(options) {
+  const rootDir = options.rootDir;
+  const filename = options.filename;
+  const maxDepth = Math.max(0, Math.floor(options.maxDepth));
+  const results = [];
+  const visit = (dir, depth) => {
+    if (depth > maxDepth) return;
+    let entries = [];
+    try {
+      entries = fs__default.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name === ".DS_Store") continue;
+      const full = path__default.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        visit(full, depth + 1);
+        continue;
+      }
+      if (entry.isFile() && entry.name === filename) results.push(full);
+    }
+  };
+  visit(rootDir, 0);
+  return results;
+}
+function readUprojectPluginEnabled(uprojectPath, pluginName) {
+  const parsed = readJsonIfPossible(uprojectPath);
+  if (!parsed || typeof parsed !== "object") {
+    return { ok: false, error: `Invalid .uproject (expected JSON): ${uprojectPath}` };
+  }
+  const plugins = Array.isArray(parsed.Plugins) ? parsed.Plugins : [];
+  for (const p of plugins) {
+    if (!p || typeof p !== "object") continue;
+    if (p.Name === pluginName) return { ok: true, enabled: p.Enabled === true };
+  }
+  return { ok: true, enabled: false };
+}
+function getUnrealMcpPluginDiskStatus(params) {
+  const checkedAtMs = Date.now();
+  const engineRoot = String(params?.engineRoot || "").trim();
+  const installScope = String(params?.installScope || "auto");
+  const projectUprojectPathRaw = typeof params?.projectUprojectPath === "string" ? params.projectUprojectPath.trim() : "";
+  if (!engineRoot) return { success: false, error: "Missing engineRoot." };
+  if (!looksLikeEngineRoot(engineRoot)) {
+    return { success: false, error: `Invalid engine root (expected an Unreal Engine install folder containing Engine/Plugins): ${engineRoot}` };
+  }
+  const enginePluginsDir = path__default.join(engineRoot, "Engine", "Plugins");
+  const enginePluginDir = path__default.join(enginePluginsDir, "FlockbayMCP");
+  const engineUpluginPath = path__default.join(enginePluginDir, "FlockbayMCP.uplugin");
+  const engineDescriptor = fs__default.existsSync(engineUpluginPath) ? readJsonIfPossible(engineUpluginPath) : null;
+  const engineInfo = {
+    pluginDir: enginePluginDir,
+    upluginPath: engineUpluginPath,
+    exists: fs__default.existsSync(engineUpluginPath),
+    descriptorOk: engineDescriptor ? isPluginDescriptorOk(engineDescriptor) : false,
+    hasBinaries: fs__default.existsSync(path__default.join(enginePluginDir, "Binaries")),
+    enginePluginsWritable: canWriteDir$1(enginePluginsDir),
+    conflicts: [],
+    legacy: []
+  };
+  const conflictSet = /* @__PURE__ */ new Set();
+  const legacySet = /* @__PURE__ */ new Set();
+  const fastCandidates = [
+    path__default.join(enginePluginsDir, "Marketplace", "FlockbayMCP", "FlockbayMCP.uplugin"),
+    path__default.join(enginePluginsDir, "Marketplace", "UnrealMCP", "UnrealMCP.uplugin"),
+    path__default.join(enginePluginsDir, "UnrealMCP", "UnrealMCP.uplugin")
+  ];
+  for (const p of fastCandidates) {
+    if (fs__default.existsSync(p)) {
+      if (p.toLowerCase().endsWith("unrealmcp.uplugin")) legacySet.add(path__default.resolve(p));
+      if (p.toLowerCase().endsWith("flockbaymcp.uplugin")) conflictSet.add(path__default.resolve(p));
+    }
+  }
+  for (const p of findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 })) {
+    const resolved = path__default.resolve(p);
+    if (isPathUnderDir(resolved, enginePluginDir)) continue;
+    conflictSet.add(resolved);
+  }
+  for (const p of findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 })) {
+    legacySet.add(path__default.resolve(p));
+  }
+  engineInfo.conflicts = Array.from(conflictSet).sort();
+  engineInfo.legacy = Array.from(legacySet).sort();
+  const project = (() => {
+    if (!projectUprojectPathRaw) return null;
+    const uprojectPath = path__default.resolve(projectUprojectPathRaw);
+    if (!uprojectPath.toLowerCase().endsWith(".uproject")) {
+      return { error: `Invalid .uproject path (expected *.uproject): ${uprojectPath}` };
+    }
+    if (!fs__default.existsSync(uprojectPath)) {
+      return { error: `Missing .uproject: ${uprojectPath}` };
+    }
+    const projectRoot = path__default.dirname(uprojectPath);
+    const pluginDir = path__default.join(projectRoot, "Plugins", "FlockbayMCP");
+    const upluginPath = path__default.join(pluginDir, "FlockbayMCP.uplugin");
+    const descriptor = fs__default.existsSync(upluginPath) ? readJsonIfPossible(upluginPath) : null;
+    const enabled = readUprojectPluginEnabled(uprojectPath, "FlockbayMCP");
+    if (!enabled.ok) return { error: enabled.error };
+    return {
+      uprojectPath,
+      pluginDir,
+      upluginPath,
+      exists: fs__default.existsSync(upluginPath),
+      descriptorOk: descriptor ? isPluginDescriptorOk(descriptor) : false,
+      enabledInUproject: enabled.enabled
+    };
+  })();
+  if (project && "error" in project) return { success: false, error: project.error };
+  if (installScope === "project" && !project) {
+    return { success: false, error: "Missing projectUprojectPath (required for installScope=project)." };
+  }
+  const engineInstalled = engineInfo.exists && engineInfo.descriptorOk && engineInfo.hasBinaries;
+  const projectInstalled = Boolean(project && project.exists && project.descriptorOk && project.enabledInUproject);
+  const effectiveScope = installScope === "engine" ? "engine" : installScope === "project" ? "project" : engineInstalled ? "engine" : project && !engineInfo.enginePluginsWritable ? "project" : "engine";
+  const conflict = engineInfo.conflicts.length > 0;
+  const legacyConflict = engineInfo.legacy.length > 0;
+  const baseInstalled = effectiveScope === "engine" ? engineInstalled : projectInstalled;
+  const installed = baseInstalled && !conflict && !legacyConflict;
+  const status = conflict ? "conflict" : legacyConflict ? "legacy_conflict" : installed ? "ok" : "not_installed";
+  const fix = status === "conflict" ? [
+    "Close Unreal Editor.",
+    "Delete/rename the conflicting FlockbayMCP plugin folder(s) listed under engine.conflicts.",
+    "Ensure there is only ONE FlockbayMCP.uplugin under Engine/Plugins (common conflict: Engine/Plugins/Marketplace/FlockbayMCP).",
+    "Reinstall the plugin and restart Unreal Editor so it rebuilds the plugin binaries."
+  ] : status === "legacy_conflict" ? [
+    "Close Unreal Editor.",
+    "Delete/rename the legacy UnrealMCP plugin folder(s) listed under engine.legacy.",
+    "Reinstall the Flockbay MCP plugin and restart Unreal Editor."
+  ] : void 0;
+  return {
+    success: true,
+    checkedAtMs,
+    engineRoot,
+    effectiveScope,
+    installed,
+    status,
+    engine: engineInfo,
+    project: project || void 0,
+    fix
+  };
+}
+
 async function openBrowser(url) {
   try {
     const forceOpen = process.env.FLOCKBAY_FORCE_BROWSER === "1" || process.env.FLOCKBAY_FORCE_BROWSER === "true";
@@ -4525,6 +4701,10 @@ class ApiMachineClient {
         return { success: true, engineRoot: result.engineRoot, destDir: result.destDir };
       }
     );
+    this.rpcHandlerManager.registerHandler(
+      "unreal-mcp-plugin-disk-status",
+      async (params) => getUnrealMcpPluginDiskStatus(params)
+    );
   }
   socket;
   keepAliveInterval = null;

package/dist/{types-DTy-RPNv.cjs → types-tRJ8NBIX.cjs}

@@ -44,7 +44,7 @@ function _interopNamespaceDefault(e) {
 var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 
 var name = "flockbay";
-var version = "0.10.43";
+var version = "0.10.44";
 var description = "Flockbay CLI (local agent + daemon)";
 var author = "Eduardo Orellana";
 var license = "UNLICENSED";
@@ -774,7 +774,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-DTy-RPNv.cjs', document.baseURI).href))));
+const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-tRJ8NBIX.cjs', document.baseURI).href))));
 function projectPath() {
   const path = path$1.resolve(__dirname$1, "..");
   return path;
@@ -3418,11 +3418,11 @@ function createBackoff(opts) {
 }
 let backoff = createBackoff();
 
-function looksLikeEngineRoot(engineRoot) {
+function looksLikeEngineRoot$1(engineRoot) {
   if (!engineRoot) return false;
   return fs.existsSync(path.join(engineRoot, "Engine")) && fs.existsSync(path.join(engineRoot, "Engine", "Plugins"));
 }
-function findFilesNamedUnderDir(options) {
+function findFilesNamedUnderDir$1(options) {
   const rootDir = options.rootDir;
   const filename = options.filename;
   const maxDepth = Math.max(0, Math.floor(options.maxDepth));
@@ -3450,7 +3450,7 @@ function findFilesNamedUnderDir(options) {
 }
 function installUnrealMcpPluginToEngine(engineRootRaw) {
   const engineRoot = (engineRootRaw || "").trim();
-  if (!looksLikeEngineRoot(engineRoot)) {
+  if (!looksLikeEngineRoot$1(engineRoot)) {
     return {
       ok: false,
       errorMessage: `Invalid engine root (expected an Unreal Engine install folder containing Engine/\u2026): ${engineRoot || "(empty)"}`
@@ -3464,7 +3464,7 @@ function installUnrealMcpPluginToEngine(engineRootRaw) {
   const destUpluginPath = path.join(destDir, "FlockbayMCP.uplugin");
   try {
     const enginePluginsDir = path.join(engineRoot, "Engine", "Plugins");
-    const candidates = findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 });
+    const candidates = findFilesNamedUnderDir$1({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 });
     const otherCopies = candidates.map((p) => path.resolve(p)).filter((p) => !p.startsWith(path.resolve(destDir) + path.sep));
     if (otherCopies.length > 0) {
       return {
@@ -3484,7 +3484,7 @@ Fix:
 - Re-run the Flockbay MCP plugin install, then restart Unreal Editor so it rebuilds the plugin`
       };
     }
-    const legacyCandidates = findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 });
+    const legacyCandidates = findFilesNamedUnderDir$1({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 });
     if (legacyCandidates.length > 0) {
       return {
         ok: false,
@@ -3563,7 +3563,7 @@ Error: ${message}`
   }
 }
 
-function readJsonIfPossible(filePath) {
+function readJsonIfPossible$1(filePath) {
   try {
     return JSON.parse(fs.readFileSync(filePath, "utf8"));
   } catch {
@@ -3574,7 +3574,7 @@ function writeJsonPretty(filePath, value) {
   fs.writeFileSync(filePath, JSON.stringify(value, null, 2) + "\n", "utf8");
 }
 function ensureProjectPluginEnabled(uprojectPath, pluginName) {
-  const parsed = readJsonIfPossible(uprojectPath);
+  const parsed = readJsonIfPossible$1(uprojectPath);
   if (!parsed || typeof parsed !== "object") {
     return { ok: false, error: `Invalid .uproject (expected JSON): ${uprojectPath}` };
   }
@@ -3659,7 +3659,7 @@ Fix:
 Expected: ${destUpluginPath}`
     };
   }
-  const uplugin = readJsonIfPossible(destUpluginPath);
+  const uplugin = readJsonIfPossible$1(destUpluginPath);
   const friendlyName = typeof uplugin?.FriendlyName === "string" ? uplugin.FriendlyName : null;
   const createdBy = typeof uplugin?.CreatedBy === "string" ? uplugin.CreatedBy : null;
   if (friendlyName !== "Flockbay MCP" || createdBy !== "Respaced Inc.") {
@@ -3821,6 +3821,182 @@ Log: ${buildLogPath}`
   return { ok: true, buildLogPath };
 }
 
+function canWriteDir$1(dir) {
+  const root = String(dir || "").trim();
+  if (!root) return false;
+  try {
+    const tmp = path.join(root, `.__flockbay_write_test_${Date.now()}_${Math.random().toString(16).slice(2)}.tmp`);
+    fs.writeFileSync(tmp, "ok", "utf8");
+    fs.unlinkSync(tmp);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function looksLikeEngineRoot(engineRoot) {
+  if (!engineRoot) return false;
+  return fs.existsSync(path.join(engineRoot, "Engine", "Plugins"));
+}
+function readJsonIfPossible(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function isPluginDescriptorOk(parsed) {
+  const friendlyName = typeof parsed?.FriendlyName === "string" ? parsed.FriendlyName : null;
+  const createdBy = typeof parsed?.CreatedBy === "string" ? parsed.CreatedBy : null;
+  return friendlyName === "Flockbay MCP" && createdBy === "Respaced Inc.";
+}
+function isPathUnderDir(childPath, parentDir) {
+  const child = path.resolve(childPath);
+  const parent = path.resolve(parentDir);
+  return child === parent || child.startsWith(parent + path.sep);
+}
+function findFilesNamedUnderDir(options) {
+  const rootDir = options.rootDir;
+  const filename = options.filename;
+  const maxDepth = Math.max(0, Math.floor(options.maxDepth));
+  const results = [];
+  const visit = (dir, depth) => {
+    if (depth > maxDepth) return;
+    let entries = [];
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name === ".DS_Store") continue;
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        visit(full, depth + 1);
+        continue;
+      }
+      if (entry.isFile() && entry.name === filename) results.push(full);
+    }
+  };
+  visit(rootDir, 0);
+  return results;
+}
+function readUprojectPluginEnabled(uprojectPath, pluginName) {
+  const parsed = readJsonIfPossible(uprojectPath);
+  if (!parsed || typeof parsed !== "object") {
+    return { ok: false, error: `Invalid .uproject (expected JSON): ${uprojectPath}` };
+  }
+  const plugins = Array.isArray(parsed.Plugins) ? parsed.Plugins : [];
+  for (const p of plugins) {
+    if (!p || typeof p !== "object") continue;
+    if (p.Name === pluginName) return { ok: true, enabled: p.Enabled === true };
+  }
+  return { ok: true, enabled: false };
+}
+function getUnrealMcpPluginDiskStatus(params) {
+  const checkedAtMs = Date.now();
+  const engineRoot = String(params?.engineRoot || "").trim();
+  const installScope = String(params?.installScope || "auto");
+  const projectUprojectPathRaw = typeof params?.projectUprojectPath === "string" ? params.projectUprojectPath.trim() : "";
+  if (!engineRoot) return { success: false, error: "Missing engineRoot." };
+  if (!looksLikeEngineRoot(engineRoot)) {
+    return { success: false, error: `Invalid engine root (expected an Unreal Engine install folder containing Engine/Plugins): ${engineRoot}` };
+  }
+  const enginePluginsDir = path.join(engineRoot, "Engine", "Plugins");
+  const enginePluginDir = path.join(enginePluginsDir, "FlockbayMCP");
+  const engineUpluginPath = path.join(enginePluginDir, "FlockbayMCP.uplugin");
+  const engineDescriptor = fs.existsSync(engineUpluginPath) ? readJsonIfPossible(engineUpluginPath) : null;
+  const engineInfo = {
+    pluginDir: enginePluginDir,
+    upluginPath: engineUpluginPath,
+    exists: fs.existsSync(engineUpluginPath),
+    descriptorOk: engineDescriptor ? isPluginDescriptorOk(engineDescriptor) : false,
+    hasBinaries: fs.existsSync(path.join(enginePluginDir, "Binaries")),
+    enginePluginsWritable: canWriteDir$1(enginePluginsDir),
+    conflicts: [],
+    legacy: []
+  };
+  const conflictSet = /* @__PURE__ */ new Set();
+  const legacySet = /* @__PURE__ */ new Set();
+  const fastCandidates = [
+    path.join(enginePluginsDir, "Marketplace", "FlockbayMCP", "FlockbayMCP.uplugin"),
+    path.join(enginePluginsDir, "Marketplace", "UnrealMCP", "UnrealMCP.uplugin"),
+    path.join(enginePluginsDir, "UnrealMCP", "UnrealMCP.uplugin")
+  ];
+  for (const p of fastCandidates) {
+    if (fs.existsSync(p)) {
+      if (p.toLowerCase().endsWith("unrealmcp.uplugin")) legacySet.add(path.resolve(p));
+      if (p.toLowerCase().endsWith("flockbaymcp.uplugin")) conflictSet.add(path.resolve(p));
+    }
+  }
+  for (const p of findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "FlockbayMCP.uplugin", maxDepth: 6 })) {
+    const resolved = path.resolve(p);
+    if (isPathUnderDir(resolved, enginePluginDir)) continue;
+    conflictSet.add(resolved);
+  }
+  for (const p of findFilesNamedUnderDir({ rootDir: enginePluginsDir, filename: "UnrealMCP.uplugin", maxDepth: 6 })) {
+    legacySet.add(path.resolve(p));
+  }
+  engineInfo.conflicts = Array.from(conflictSet).sort();
+  engineInfo.legacy = Array.from(legacySet).sort();
+  const project = (() => {
+    if (!projectUprojectPathRaw) return null;
+    const uprojectPath = path.resolve(projectUprojectPathRaw);
+    if (!uprojectPath.toLowerCase().endsWith(".uproject")) {
+      return { error: `Invalid .uproject path (expected *.uproject): ${uprojectPath}` };
+    }
+    if (!fs.existsSync(uprojectPath)) {
+      return { error: `Missing .uproject: ${uprojectPath}` };
+    }
+    const projectRoot = path.dirname(uprojectPath);
+    const pluginDir = path.join(projectRoot, "Plugins", "FlockbayMCP");
+    const upluginPath = path.join(pluginDir, "FlockbayMCP.uplugin");
+    const descriptor = fs.existsSync(upluginPath) ? readJsonIfPossible(upluginPath) : null;
+    const enabled = readUprojectPluginEnabled(uprojectPath, "FlockbayMCP");
+    if (!enabled.ok) return { error: enabled.error };
+    return {
+      uprojectPath,
+      pluginDir,
+      upluginPath,
+      exists: fs.existsSync(upluginPath),
+      descriptorOk: descriptor ? isPluginDescriptorOk(descriptor) : false,
+      enabledInUproject: enabled.enabled
+    };
+  })();
+  if (project && "error" in project) return { success: false, error: project.error };
+  if (installScope === "project" && !project) {
+    return { success: false, error: "Missing projectUprojectPath (required for installScope=project)." };
+  }
+  const engineInstalled = engineInfo.exists && engineInfo.descriptorOk && engineInfo.hasBinaries;
+  const projectInstalled = Boolean(project && project.exists && project.descriptorOk && project.enabledInUproject);
+  const effectiveScope = installScope === "engine" ? "engine" : installScope === "project" ? "project" : engineInstalled ? "engine" : project && !engineInfo.enginePluginsWritable ? "project" : "engine";
+  const conflict = engineInfo.conflicts.length > 0;
+  const legacyConflict = engineInfo.legacy.length > 0;
+  const baseInstalled = effectiveScope === "engine" ? engineInstalled : projectInstalled;
+  const installed = baseInstalled && !conflict && !legacyConflict;
+  const status = conflict ? "conflict" : legacyConflict ? "legacy_conflict" : installed ? "ok" : "not_installed";
+  const fix = status === "conflict" ? [
+    "Close Unreal Editor.",
+    "Delete/rename the conflicting FlockbayMCP plugin folder(s) listed under engine.conflicts.",
+    "Ensure there is only ONE FlockbayMCP.uplugin under Engine/Plugins (common conflict: Engine/Plugins/Marketplace/FlockbayMCP).",
+    "Reinstall the plugin and restart Unreal Editor so it rebuilds the plugin binaries."
+  ] : status === "legacy_conflict" ? [
+    "Close Unreal Editor.",
+    "Delete/rename the legacy UnrealMCP plugin folder(s) listed under engine.legacy.",
+    "Reinstall the Flockbay MCP plugin and restart Unreal Editor."
+  ] : void 0;
+  return {
+    success: true,
+    checkedAtMs,
+    engineRoot,
+    effectiveScope,
+    installed,
+    status,
+    engine: engineInfo,
+    project: project || void 0,
+    fix
+  };
+}
+
 async function openBrowser(url) {
   try {
     const forceOpen = process.env.FLOCKBAY_FORCE_BROWSER === "1" || process.env.FLOCKBAY_FORCE_BROWSER === "true";
@@ -4546,6 +4722,10 @@ class ApiMachineClient {
         return { success: true, engineRoot: result.engineRoot, destDir: result.destDir };
       }
     );
+    this.rpcHandlerManager.registerHandler(
+      "unreal-mcp-plugin-disk-status",
+      async (params) => getUnrealMcpPluginDiskStatus(params)
+    );
   }
   socket;
   keepAliveInterval = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flockbay",
-  "version": "0.10.43",
+  "version": "0.10.44",
   "description": "Flockbay CLI (local agent + daemon)",
   "author": "Eduardo Orellana",
   "license": "UNLICENSED",