flockbay 0.10.48 → 0.10.49

package/dist/{index-BLsRYyPq.mjs → index-D8AeVbvv.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-KJ7kAYwk.mjs';
+import { l as logger, e as projectPath, f as backoff, g as delay, R as RawJSONLinesSchema, c as configuration, h as readDaemonState, j as clearDaemonState, p as packageJson, r as readSettings, k as readCredentials, u as updateSettings, o as openBrowser, w as writeCredentials, m as unrealMcpPythonDir, n as acquireDaemonLock, q as writeDaemonState, s as ApiMachineClient, t as releaseDaemonLock, v as sendUnrealMcpTcpCommand, A as ApiClient, x as validatePath, y as run, z as run$1, B as buildShellInvocation, C as clearCredentials, D as clearMachineId, E as authenticateCodex, F as syncCodexCliAuth, G as authenticateClaude, H as authenticateGemini, d as installUnrealMcpPluginToEngine, I as buildAndInstallUnrealMcpPlugin, i as installUnrealMcpPluginToProject, b as isInstalledEngineRoot, J as getLatestDaemonLog, K as normalizeServerUrlForNode } from './types-BRJuZQj_.mjs';
 import { spawn, execFileSync, execSync } from 'node:child_process';
 import * as path from 'node:path';
 import path__default, { resolve, join, dirname } from 'node:path';
@@ -15190,7 +15190,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-BPUAeqI_.mjs');
+        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-CEvGPul8.mjs');
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15300,19 +15300,36 @@ async function authAndSetupMachineIfNeeded() {
       if (!parsed.skipUnreal) {
         const engineRoot = readArgValue(startArgs, "--engine-root") || (process.env.UE_ENGINE_ROOT || "").trim() || (process.env.ENGINE_ROOT || "").trim() || null;
         if (engineRoot) {
-          const shouldInstall = await promptYesNo(`Install Flockbay MCP plugin into this Unreal Engine folder?
-${engineRoot}`, {
-            defaultYes: true
-          });
-          if (shouldInstall) {
-            const result = installUnrealMcpPluginToEngine(engineRoot);
-            if (result.ok) {
-              console.log(`Flockbay MCP plugin installed: ${result.destDir}`);
-              process.env.FLOCKBAY_UNREAL_MCP_ENABLED = "1";
-              process.env.ENGINE_ROOT = engineRoot;
-            } else {
-              console.error(chalk.yellow("Flockbay MCP plugin install skipped:"));
-              console.error(chalk.gray(result.errorMessage));
+          const installedEngine = isInstalledEngineRoot(engineRoot);
+          const detection = await detectUnrealProject(process.cwd());
+          const uproject = detection.ok ? detection.uprojectFile : null;
+          const promptTarget = installedEngine ? uproject ? `Install Flockbay MCP plugin into this Unreal project?
+${uproject}` : null : `Install Flockbay MCP plugin into this Unreal Engine folder?
+${engineRoot}`;
+          if (installedEngine && !uproject) {
+            console.error(chalk.yellow("Unreal MCP plugin install skipped:"));
+            console.error(
+              chalk.gray(
+                [
+                  "This engine appears to be an Installed Build (Epic Launcher).",
+                  "Engine-scope install can break builds. Run `flockbay start` from a project folder, or pass --project <path> to install as a project plugin."
+                ].join("\n")
+              )
+            );
+          } else {
+            const shouldInstall = await promptYesNo(promptTarget, {
+              defaultYes: true
+            });
+            if (shouldInstall) {
+              const result = installedEngine && uproject ? installUnrealMcpPluginToProject(uproject) : installUnrealMcpPluginToEngine(engineRoot);
+              if (result.ok) {
+                console.log(`Flockbay MCP plugin installed: ${result.destDir}`);
+                process.env.FLOCKBAY_UNREAL_MCP_ENABLED = "1";
+                process.env.ENGINE_ROOT = engineRoot;
+              } else {
+                console.error(chalk.yellow("Flockbay MCP plugin install skipped:"));
+                console.error(chalk.gray(result.errorMessage));
+              }
             }
           }
         }
@@ -15329,7 +15346,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await import('./runCodex-BkdEucuI.mjs');
+      const { runCodex } = await import('./runCodex-ZfUyhHF6.mjs');
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {
@@ -15431,7 +15448,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await import('./runGemini-p_aKQRTi.mjs');
+      const { runGemini } = await import('./runGemini-DBU1mMdp.mjs');
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {

package/dist/{index-jd6DaTy_.cjs → index-r3VTdgFI.cjs}

@@ -3,7 +3,7 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var types = require('./types-DbQtXaZC.cjs');
+var types = require('./types-DNr0xwSy.cjs');
 var node_child_process = require('node:child_process');
 var path = require('node:path');
 var node_readline = require('node:readline');
@@ -1319,7 +1319,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-jd6DaTy_.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-r3VTdgFI.cjs', document.baseURI).href)));
 const __dirname$1 = path.join(__filename$1, "..");
 function getGlobalClaudeVersion(claudeExecutable) {
   try {
@@ -15212,7 +15212,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-CyWWA8GW.cjs'); });
+        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-wFK-k3Wk.cjs'); });
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15322,19 +15322,36 @@ async function authAndSetupMachineIfNeeded() {
       if (!parsed.skipUnreal) {
         const engineRoot = readArgValue(startArgs, "--engine-root") || (process.env.UE_ENGINE_ROOT || "").trim() || (process.env.ENGINE_ROOT || "").trim() || null;
         if (engineRoot) {
-          const shouldInstall = await promptYesNo(`Install Flockbay MCP plugin into this Unreal Engine folder?
-${engineRoot}`, {
-            defaultYes: true
-          });
-          if (shouldInstall) {
-            const result = types.installUnrealMcpPluginToEngine(engineRoot);
-            if (result.ok) {
-              console.log(`Flockbay MCP plugin installed: ${result.destDir}`);
-              process.env.FLOCKBAY_UNREAL_MCP_ENABLED = "1";
-              process.env.ENGINE_ROOT = engineRoot;
-            } else {
-              console.error(chalk.yellow("Flockbay MCP plugin install skipped:"));
-              console.error(chalk.gray(result.errorMessage));
+          const installedEngine = types.isInstalledEngineRoot(engineRoot);
+          const detection = await detectUnrealProject(process.cwd());
+          const uproject = detection.ok ? detection.uprojectFile : null;
+          const promptTarget = installedEngine ? uproject ? `Install Flockbay MCP plugin into this Unreal project?
+${uproject}` : null : `Install Flockbay MCP plugin into this Unreal Engine folder?
+${engineRoot}`;
+          if (installedEngine && !uproject) {
+            console.error(chalk.yellow("Unreal MCP plugin install skipped:"));
+            console.error(
+              chalk.gray(
+                [
+                  "This engine appears to be an Installed Build (Epic Launcher).",
+                  "Engine-scope install can break builds. Run `flockbay start` from a project folder, or pass --project <path> to install as a project plugin."
+                ].join("\n")
+              )
+            );
+          } else {
+            const shouldInstall = await promptYesNo(promptTarget, {
+              defaultYes: true
+            });
+            if (shouldInstall) {
+              const result = installedEngine && uproject ? types.installUnrealMcpPluginToProject(uproject) : types.installUnrealMcpPluginToEngine(engineRoot);
+              if (result.ok) {
+                console.log(`Flockbay MCP plugin installed: ${result.destDir}`);
+                process.env.FLOCKBAY_UNREAL_MCP_ENABLED = "1";
+                process.env.ENGINE_ROOT = engineRoot;
+              } else {
+                console.error(chalk.yellow("Flockbay MCP plugin install skipped:"));
+                console.error(chalk.gray(result.errorMessage));
+              }
             }
           }
         }
@@ -15351,7 +15368,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-D8On-xj7.cjs'); });
+      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-DuyuYqoB.cjs'); });
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {
@@ -15453,7 +15470,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-BPLO-OFS.cjs'); });
+      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-D7j5Y5TF.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-jd6DaTy_.cjs');
-require('./types-DbQtXaZC.cjs');
+require('./index-r3VTdgFI.cjs');
+require('./types-DNr0xwSy.cjs');
 require('zod');
 require('node:child_process');
 require('node:fs');

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import 'chalk';
-import './index-BLsRYyPq.mjs';
-import './types-KJ7kAYwk.mjs';
+import './index-D8AeVbvv.mjs';
+import './types-BRJuZQj_.mjs';
 import 'zod';
 import 'node:child_process';
 import 'node:fs';

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-DbQtXaZC.cjs');
+var types = require('./types-DNr0xwSy.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-KJ7kAYwk.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-BRJuZQj_.mjs';
 import 'axios';
 import 'node:fs';
 import 'node:os';

package/dist/{migratePlugin-BPUAeqI_.mjs → migratePlugin-CEvGPul8.mjs}

@@ -1,6 +1,6 @@
 import fs__default from 'node:fs';
 import path__default from 'node:path';
-import { i as installUnrealMcpPluginToEngine } from './types-KJ7kAYwk.mjs';
+import { i as installUnrealMcpPluginToProject, b as isInstalledEngineRoot, d as installUnrealMcpPluginToEngine } from './types-BRJuZQj_.mjs';
 import 'axios';
 import 'node:os';
 import 'node:events';
@@ -138,6 +138,23 @@ Error: ${message}` };
       }
     }
   }
+  if (projectUprojectPath) {
+    const installedProject = installUnrealMcpPluginToProject(projectUprojectPath);
+    if (!installedProject.ok) return { ok: false, errorMessage: installedProject.errorMessage };
+    return { ok: true, installedDestDir: installedProject.destDir, changedProjectPath, removedLegacyPluginDirs };
+  }
+  if (isInstalledEngineRoot(engineRoot)) {
+    return {
+      ok: false,
+      errorMessage: [
+        "This Unreal Engine install appears to be an Installed Build (Epic Launcher / precompiled engine).",
+        "Engine-scope install of a source-only plugin can break builds.",
+        "",
+        "Fix: re-run migration with a project path to install as a project plugin:",
+        "  flockbay unreal-mcp migrate --engine-root <ENGINE_ROOT> --project <PATH_TO_.UPROJECT> --remove-legacy"
+      ].join("\n")
+    };
+  }
   const installed = installUnrealMcpPluginToEngine(engineRoot);
   if (!installed.ok) return installed;
   return { ok: true, installedDestDir: installed.destDir, changedProjectPath, removedLegacyPluginDirs };

package/dist/{migratePlugin-CyWWA8GW.cjs → migratePlugin-wFK-k3Wk.cjs}

@@ -2,7 +2,7 @@
 
 var fs = require('node:fs');
 var path = require('node:path');
-var types = require('./types-DbQtXaZC.cjs');
+var types = require('./types-DNr0xwSy.cjs');
 require('axios');
 require('node:os');
 require('node:events');
@@ -140,6 +140,23 @@ Error: ${message}` };
       }
     }
   }
+  if (projectUprojectPath) {
+    const installedProject = types.installUnrealMcpPluginToProject(projectUprojectPath);
+    if (!installedProject.ok) return { ok: false, errorMessage: installedProject.errorMessage };
+    return { ok: true, installedDestDir: installedProject.destDir, changedProjectPath, removedLegacyPluginDirs };
+  }
+  if (types.isInstalledEngineRoot(engineRoot)) {
+    return {
+      ok: false,
+      errorMessage: [
+        "This Unreal Engine install appears to be an Installed Build (Epic Launcher / precompiled engine).",
+        "Engine-scope install of a source-only plugin can break builds.",
+        "",
+        "Fix: re-run migration with a project path to install as a project plugin:",
+        "  flockbay unreal-mcp migrate --engine-root <ENGINE_ROOT> --project <PATH_TO_.UPROJECT> --remove-legacy"
+      ].join("\n")
+    };
+  }
   const installed = types.installUnrealMcpPluginToEngine(engineRoot);
   if (!installed.ok) return installed;
   return { ok: true, installedDestDir: installed.destDir, changedProjectPath, removedLegacyPluginDirs };

package/dist/{runCodex-D8On-xj7.cjs → runCodex-DuyuYqoB.cjs}

@@ -2,7 +2,7 @@
 
 var ink = require('ink');
 var React = require('react');
-var types = require('./types-DbQtXaZC.cjs');
+var types = require('./types-DNr0xwSy.cjs');
 var index_js = require('@modelcontextprotocol/sdk/client/index.js');
 var z = require('zod');
 var types_js = require('@modelcontextprotocol/sdk/types.js');
@@ -16,7 +16,7 @@ var process$1 = require('node:process');
 var node_stream = require('node:stream');
 var stdio_js$1 = require('@modelcontextprotocol/sdk/client/stdio.js');
 var stdio_js = require('@modelcontextprotocol/sdk/shared/stdio.js');
-var index = require('./index-jd6DaTy_.cjs');
+var index = require('./index-r3VTdgFI.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');

package/dist/{runCodex-BkdEucuI.mjs → runCodex-ZfUyhHF6.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-KJ7kAYwk.mjs';
+import { l as logger, A as ApiClient, p as packageJson, c as configuration, r as readSettings, e as projectPath } from './types-BRJuZQj_.mjs';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { z } from 'zod';
 import { ElicitRequestSchema } from '@modelcontextprotocol/sdk/types.js';
@@ -14,7 +14,7 @@ import process$1 from 'node:process';
 import { PassThrough } from 'node:stream';
 import { getDefaultEnvironment } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { ReadBuffer, serializeMessage } from '@modelcontextprotocol/sdk/shared/stdio.js';
-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-BLsRYyPq.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-D8AeVbvv.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';

package/dist/{runGemini-BPLO-OFS.cjs → runGemini-D7j5Y5TF.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-DbQtXaZC.cjs');
-var index = require('./index-jd6DaTy_.cjs');
+var types = require('./types-DNr0xwSy.cjs');
+var index = require('./index-r3VTdgFI.cjs');
 var node_child_process = require('node:child_process');
 var sdk = require('@agentclientprotocol/sdk');
 var fs = require('fs');

package/dist/{runGemini-p_aKQRTi.mjs → runGemini-DBU1mMdp.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-KJ7kAYwk.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-BLsRYyPq.mjs';
+import { l as logger, p as packageJson, A as ApiClient, c as configuration, r as readSettings, e as projectPath } from './types-BRJuZQj_.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-D8AeVbvv.mjs';
 import { spawn, spawnSync } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';

package/dist/{types-KJ7kAYwk.mjs → types-BRJuZQj_.mjs}

@@ -23,7 +23,7 @@ import { createServer } from 'http';
 import open$2 from 'open';
 
 var name = "flockbay";
-var version = "0.10.48";
+var version = "0.10.49";
 var description = "Flockbay CLI (local agent + daemon)";
 var author = "Eduardo Orellana";
 var license = "UNLICENSED";
@@ -3455,6 +3455,14 @@ function createBackoff(opts) {
 }
 let backoff = createBackoff();
 
+function isInstalledEngineRoot(engineRootRaw) {
+  const engineRoot = String(engineRootRaw || "").trim();
+  if (!engineRoot) return false;
+  if (fs__default.existsSync(path__default.join(engineRoot, "Engine", "Build", "InstalledBuild.txt"))) return true;
+  if (fs__default.existsSync(path__default.join(engineRoot, "Engine", "Build", "InstalledBuild.xml"))) return true;
+  return false;
+}
+
 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"));
@@ -3493,6 +3501,24 @@ function installUnrealMcpPluginToEngine(engineRootRaw) {
       errorMessage: `Invalid engine root (expected an Unreal Engine install folder containing Engine/\u2026): ${engineRoot || "(empty)"}`
     };
   }
+  if (isInstalledEngineRoot(engineRoot)) {
+    return {
+      ok: false,
+      errorMessage: [
+        "This Unreal Engine install appears to be an Installed Build (Epic Launcher / precompiled engine).",
+        "",
+        "Installing a source-only plugin into Engine/Plugins can break builds with errors like:",
+        `  Expecting to find a type to be declared in a module rules named 'FlockbayMCP' in 'UE5Rules'`,
+        "",
+        "Fix: install the Flockbay MCP plugin into your project instead:",
+        "  <YourProject>/Plugins/FlockbayMCP",
+        "",
+        "If you are using the Flockbay UI/CLI, choose a project-scope install or pass a project path.",
+        "Example:",
+        "  flockbay unreal-mcp migrate --engine-root <ENGINE_ROOT> --project <PATH_TO_.UPROJECT> --remove-legacy"
+      ].join("\n")
+    };
+  }
   const srcDir = unrealMcpPluginSourceDir();
   if (!fs__default.existsSync(srcDir)) {
     return { ok: false, errorMessage: `Missing Flockbay MCP plugin source folder: ${srcDir}` };
@@ -4725,9 +4751,35 @@ class ApiMachineClient {
         const enginePluginDir = path__default.join(enginePluginsDir, "FlockbayMCP");
         const enginePluginUplugin = path__default.join(enginePluginDir, "FlockbayMCP.uplugin");
         const enginePluginHasBinaries = fs__default.existsSync(path__default.join(enginePluginDir, "Binaries"));
-        const shouldUseProject = scope === "project" || scope === "auto" && // If the engine plugin is already installed+built, keep using it (no project mutation).
-        !(fs__default.existsSync(enginePluginUplugin) && enginePluginHasBinaries) && // Otherwise, use a project-scope install when the engine folder isn't writable.
-        !canWriteDir(enginePluginsDir) && Boolean(projectUprojectPath);
+        const installedEngine = isInstalledEngineRoot(engineRoot);
+        if (scope === "engine" && installedEngine) {
+          return {
+            success: false,
+            error: [
+              "Refusing engine-scope install: this engine is an Installed Build (Epic Launcher / precompiled rules).",
+              "Install the Flockbay MCP plugin into your project instead (recommended).",
+              "Provide projectUprojectPath and use installScope=project, or installScope=auto."
+            ].join("\n")
+          };
+        }
+        if (scope === "auto" && installedEngine && !projectUprojectPath) {
+          return {
+            success: false,
+            error: [
+              "This engine is an Installed Build (Epic Launcher / precompiled rules).",
+              "To avoid breaking Unreal builds, Flockbay must install the plugin into a project.",
+              "Missing required param: projectUprojectPath"
+            ].join("\n")
+          };
+        }
+        const shouldUseProject = scope === "project" || scope === "auto" && (installedEngine ? (
+          // Installed engines: always use project plugin install (even if an engine copy already exists).
+          Boolean(projectUprojectPath)
+        ) : (
+          // Non-installed engines: if the engine plugin is already installed+built, keep using it (no project mutation).
+          !(fs__default.existsSync(enginePluginUplugin) && enginePluginHasBinaries) && // Otherwise, use a project-scope install when the engine folder isn't writable.
+          !canWriteDir(enginePluginsDir) && Boolean(projectUprojectPath)
+        ));
         if (shouldUseProject) {
           if (!projectUprojectPath) return { success: false, error: "Missing projectUprojectPath (required for project-scope install)." };
           const installedProject = installUnrealMcpPluginToProject(projectUprojectPath);
@@ -5293,4 +5345,4 @@ const RawJSONLinesSchema = z$1.discriminatedUnion("type", [
   }).passthrough()
 ]);
 
-export { ApiClient as A, clearMachineId as B, authenticateCodex as C, syncCodexCliAuth as D, authenticateClaude as E, authenticateGemini as F, buildAndInstallUnrealMcpPlugin as G, installUnrealMcpPluginToProject as H, getLatestDaemonLog as I, normalizeServerUrlForNode as J, RawJSONLinesSchema as R, ApiSessionClient as a, projectPath as b, configuration as c, backoff as d, delay as e, readDaemonState as f, clearDaemonState as g, readCredentials as h, installUnrealMcpPluginToEngine as i, unrealMcpPythonDir as j, acquireDaemonLock as k, logger as l, writeDaemonState as m, ApiMachineClient as n, openBrowser as o, packageJson as p, releaseDaemonLock as q, readSettings as r, sendUnrealMcpTcpCommand as s, run$1 as t, updateSettings as u, validatePath as v, writeCredentials as w, run as x, buildShellInvocation as y, clearCredentials as z };
+export { ApiClient as A, buildShellInvocation as B, clearCredentials as C, clearMachineId as D, authenticateCodex as E, syncCodexCliAuth as F, authenticateClaude as G, authenticateGemini as H, buildAndInstallUnrealMcpPlugin as I, getLatestDaemonLog as J, normalizeServerUrlForNode as K, RawJSONLinesSchema as R, ApiSessionClient as a, isInstalledEngineRoot as b, configuration as c, installUnrealMcpPluginToEngine as d, projectPath as e, backoff as f, delay as g, readDaemonState as h, installUnrealMcpPluginToProject as i, clearDaemonState as j, readCredentials as k, logger as l, unrealMcpPythonDir as m, acquireDaemonLock as n, openBrowser as o, packageJson as p, writeDaemonState as q, readSettings as r, ApiMachineClient as s, releaseDaemonLock as t, updateSettings as u, sendUnrealMcpTcpCommand as v, writeCredentials as w, validatePath as x, run$1 as y, run as z };

package/dist/{types-DbQtXaZC.cjs → types-DNr0xwSy.cjs}

@@ -44,7 +44,7 @@ function _interopNamespaceDefault(e) {
 var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 
 var name = "flockbay";
-var version = "0.10.48";
+var version = "0.10.49";
 var description = "Flockbay CLI (local agent + daemon)";
 var author = "Eduardo Orellana";
 var license = "UNLICENSED";
@@ -832,7 +832,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-DbQtXaZC.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-DNr0xwSy.cjs', document.baseURI).href))));
 function projectPath() {
   const path = path$1.resolve(__dirname$1, "..");
   return path;
@@ -3476,6 +3476,14 @@ function createBackoff(opts) {
 }
 let backoff = createBackoff();
 
+function isInstalledEngineRoot(engineRootRaw) {
+  const engineRoot = String(engineRootRaw || "").trim();
+  if (!engineRoot) return false;
+  if (fs.existsSync(path.join(engineRoot, "Engine", "Build", "InstalledBuild.txt"))) return true;
+  if (fs.existsSync(path.join(engineRoot, "Engine", "Build", "InstalledBuild.xml"))) return true;
+  return false;
+}
+
 function looksLikeEngineRoot$1(engineRoot) {
   if (!engineRoot) return false;
   return fs.existsSync(path.join(engineRoot, "Engine")) && fs.existsSync(path.join(engineRoot, "Engine", "Plugins"));
@@ -3514,6 +3522,24 @@ function installUnrealMcpPluginToEngine(engineRootRaw) {
       errorMessage: `Invalid engine root (expected an Unreal Engine install folder containing Engine/\u2026): ${engineRoot || "(empty)"}`
     };
   }
+  if (isInstalledEngineRoot(engineRoot)) {
+    return {
+      ok: false,
+      errorMessage: [
+        "This Unreal Engine install appears to be an Installed Build (Epic Launcher / precompiled engine).",
+        "",
+        "Installing a source-only plugin into Engine/Plugins can break builds with errors like:",
+        `  Expecting to find a type to be declared in a module rules named 'FlockbayMCP' in 'UE5Rules'`,
+        "",
+        "Fix: install the Flockbay MCP plugin into your project instead:",
+        "  <YourProject>/Plugins/FlockbayMCP",
+        "",
+        "If you are using the Flockbay UI/CLI, choose a project-scope install or pass a project path.",
+        "Example:",
+        "  flockbay unreal-mcp migrate --engine-root <ENGINE_ROOT> --project <PATH_TO_.UPROJECT> --remove-legacy"
+      ].join("\n")
+    };
+  }
   const srcDir = unrealMcpPluginSourceDir();
   if (!fs.existsSync(srcDir)) {
     return { ok: false, errorMessage: `Missing Flockbay MCP plugin source folder: ${srcDir}` };
@@ -4746,9 +4772,35 @@ class ApiMachineClient {
         const enginePluginDir = path.join(enginePluginsDir, "FlockbayMCP");
         const enginePluginUplugin = path.join(enginePluginDir, "FlockbayMCP.uplugin");
         const enginePluginHasBinaries = fs.existsSync(path.join(enginePluginDir, "Binaries"));
-        const shouldUseProject = scope === "project" || scope === "auto" && // If the engine plugin is already installed+built, keep using it (no project mutation).
-        !(fs.existsSync(enginePluginUplugin) && enginePluginHasBinaries) && // Otherwise, use a project-scope install when the engine folder isn't writable.
-        !canWriteDir(enginePluginsDir) && Boolean(projectUprojectPath);
+        const installedEngine = isInstalledEngineRoot(engineRoot);
+        if (scope === "engine" && installedEngine) {
+          return {
+            success: false,
+            error: [
+              "Refusing engine-scope install: this engine is an Installed Build (Epic Launcher / precompiled rules).",
+              "Install the Flockbay MCP plugin into your project instead (recommended).",
+              "Provide projectUprojectPath and use installScope=project, or installScope=auto."
+            ].join("\n")
+          };
+        }
+        if (scope === "auto" && installedEngine && !projectUprojectPath) {
+          return {
+            success: false,
+            error: [
+              "This engine is an Installed Build (Epic Launcher / precompiled rules).",
+              "To avoid breaking Unreal builds, Flockbay must install the plugin into a project.",
+              "Missing required param: projectUprojectPath"
+            ].join("\n")
+          };
+        }
+        const shouldUseProject = scope === "project" || scope === "auto" && (installedEngine ? (
+          // Installed engines: always use project plugin install (even if an engine copy already exists).
+          Boolean(projectUprojectPath)
+        ) : (
+          // Non-installed engines: if the engine plugin is already installed+built, keep using it (no project mutation).
+          !(fs.existsSync(enginePluginUplugin) && enginePluginHasBinaries) && // Otherwise, use a project-scope install when the engine folder isn't writable.
+          !canWriteDir(enginePluginsDir) && Boolean(projectUprojectPath)
+        ));
         if (shouldUseProject) {
           if (!projectUprojectPath) return { success: false, error: "Missing projectUprojectPath (required for project-scope install)." };
           const installedProject = installUnrealMcpPluginToProject(projectUprojectPath);
@@ -5333,6 +5385,7 @@ exports.delay = delay;
 exports.getLatestDaemonLog = getLatestDaemonLog;
 exports.installUnrealMcpPluginToEngine = installUnrealMcpPluginToEngine;
 exports.installUnrealMcpPluginToProject = installUnrealMcpPluginToProject;
+exports.isInstalledEngineRoot = isInstalledEngineRoot;
 exports.logger = logger;
 exports.normalizeServerUrlForNode = normalizeServerUrlForNode;
 exports.openBrowser = openBrowser;

package/package.json

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