flockbay 0.10.47 → 0.10.49

package/dist/{index-BWNZJMIV.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-e5yrDcQZ.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';
@@ -793,6 +793,9 @@ async function createSessionScanner(opts) {
       await sync.invalidateAndAwait();
       sync.stop();
     },
+    flush: async () => {
+      await sync.invalidateAndAwait();
+    },
     onNewSession: (sessionId) => {
       if (currentSessionId === sessionId) {
         logger.debug(`[SESSION_SCANNER] New session: ${sessionId} is the same as the current session, skipping`);
@@ -13953,6 +13956,16 @@ function permissionModeForAgent(agent) {
   if (agent === "claude") return "bypassPermissions";
   return "yolo";
 }
+function modelOverrideForAgent(agent, args) {
+  const explicitCodexModel = readArgValue$2(args, "--codex-model");
+  const explicitModel = readArgValue$2(args, "--model");
+  const explicitGeminiModel = readArgValue$2(args, "--gemini-model");
+  const explicitClaudeModel = readArgValue$2(args, "--claude-model");
+  if (agent === "codex") return (explicitCodexModel || explicitModel || "gpt-5-codex-medium").trim();
+  if (agent === "gemini") return explicitGeminiModel ? explicitGeminiModel.trim() : null;
+  if (agent === "claude") return explicitClaudeModel ? explicitClaudeModel.trim() : null;
+  return null;
+}
 function nowIsoCompact() {
   const d = /* @__PURE__ */ new Date();
   const pad = (n) => String(n).padStart(2, "0");
@@ -13990,14 +14003,26 @@ async function ensureDaemonRunning({ skipUnreal }) {
 async function createSmokeWorkspaceDir(baseDir) {
   const root = baseDir?.trim() ? path__default.resolve(baseDir) : path__default.join(os__default.tmpdir(), "flockbay-smoke", nowIsoCompact() + "_" + randomUUID().slice(0, 8));
   await fs$1.mkdir(root, { recursive: true });
-  const secret = `SMOKE_SECRET_${randomUUID().slice(0, 8)}`;
+  const marker = `SMOKE_MARKER_${randomUUID().slice(0, 8)}`;
   await fs$1.writeFile(path__default.join(root, "smoke.txt"), `flockbay smoke test
-SMOKE_SECRET=${secret}
+SMOKE_MARKER=${marker}
 `, "utf8");
-  return { dir: root, secret };
+  return { dir: root, secret: marker };
 }
-function isAgentRecord(record) {
-  return record && typeof record === "object" && record.role === "agent";
+function isUserRecord(record) {
+  return record && typeof record === "object" && record.role === "user";
+}
+function isProviderErrorRecord(record) {
+  return recordIncludesNeedle(record, '"code":-32603') || recordIncludesNeedle(record, "Internal error") || recordIncludesNeedle(record, "No capacity available") || recordIncludesNeedle(record, "authentication required") || recordIncludesNeedle(record, "login required") || recordIncludesNeedle(record, "Model not found");
+}
+function formatRecordExcerpt(record) {
+  const text = extractTextFromRecord(record);
+  if (text && text.trim()) return text.trim().slice(0, 400);
+  try {
+    return JSON.stringify(record).slice(0, 400);
+  } catch {
+    return String(record ?? "").slice(0, 400);
+  }
 }
 function extractTextFromRecord(record) {
   try {
@@ -14224,43 +14249,70 @@ Update: ${updateCommand}`);
     await sessionClient.connectAndWait();
     await ensureSessionActive(api, sessionId, 25e3);
     const permissionMode = permissionModeForAgent(agent);
+    const modelOverride = modelOverrideForAgent(agent, args);
+    const baseMeta = modelOverride ? { permissionMode, model: modelOverride } : { permissionMode };
     scenarios.push(await runScenario("basic-message", async () => {
       const token = `SMOKE_OK_${agent}_${randomUUID().slice(0, 6)}`;
-      sessionClient.sendUserText(`Reply with exactly: ${token}`, { permissionMode });
-      await waitForMessage({
+      sessionClient.sendUserText(`Reply with exactly: ${token}`, baseMeta);
+      const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && recordIncludesNeedle(r, token),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, token) || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:basic-message`
       });
+      const record = msg?.content;
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_basic_message: ${formatRecordExcerpt(record)}`);
+      }
     }));
     scenarios.push(await runScenario("tool-search", async () => {
       const token = `TOOL_SEARCH_OK_${randomUUID().slice(0, 6)}`;
+      const promptLines = agent === "codex" ? [
+        "Use your Terminal tool to read `smoke.txt` in the project directory (do NOT ask for confirmation).",
+        "Use this exact command so it works cross-platform:",
+        "",
+        `node -e "const fs=require('fs');console.log(fs.readFileSync('smoke.txt','utf8'))"`,
+        "",
+        "Find the value after `SMOKE_MARKER=`.",
+        "",
+        `Reply with two lines exactly:`,
+        `1) SMOKE_MARKER=<value>`,
+        `2) ${token}`
+      ] : [
+        "Read the file `smoke.txt` in the project directory using MCP tools (e.g. `read_file_chunk` or `search`).",
+        "Find the value after `SMOKE_MARKER=`.",
+        "",
+        `Reply with two lines exactly:`,
+        `1) SMOKE_MARKER=<value>`,
+        `2) ${token}`
+      ];
       sessionClient.sendUserText(
-        [
-          "Read the file `smoke.txt` in the project directory using MCP tools (e.g. `read_file_chunk` or `search`).",
-          "Find the value after `SMOKE_SECRET=`.",
-          "",
-          `Reply with two lines exactly:`,
-          `1) SMOKE_SECRET=<value>`,
-          `2) ${token}`
-        ].join("\n"),
-        { permissionMode }
+        promptLines.join("\n"),
+        baseMeta
       );
-      await waitForMessage({
+      const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && recordIncludesNeedle(r, `SMOKE_SECRET=${secret}`) && recordIncludesNeedle(r, token),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, `SMOKE_MARKER=${secret}`) && recordIncludesNeedle(r, token) || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:tool-search`
       });
+      const record = msg?.content;
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_tool_search: ${formatRecordExcerpt(record)}`);
+      }
     }));
     scenarios.push(await runScenario("image-attachment", async () => {
       const token = `IMAGE_OK_${randomUUID().slice(0, 6)}`;
       const base64 = tinyPngBase64();
+      const prompt = agent === "codex" ? `Describe the attached image in one short sentence, then reply with exactly: ${token}` : [
+        'Call `mcp__flockbay__latest_user_images` with {"limit": 1} to fetch the attached image.',
+        "Then describe the attached image in one short sentence.",
+        `Finally, reply with exactly: ${token}`
+      ].join("\n");
       sessionClient.sendUserText(
-        `Describe the attached image in one short sentence, then reply with exactly: ${token}`,
+        prompt,
         {
-          permissionMode,
+          ...baseMeta,
           attachments: {
             images: [{ mimeType: "image/png", base64, name: "smoke.png" }]
           }
@@ -14268,7 +14320,7 @@ Update: ${updateCommand}`);
       );
       const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && (recordIncludesNeedle(r, token) || agent === "codex" && recordIncludesNeedle(r, "image-attachment-missing") || recordIncludesNeedle(r, "Could not process image") || recordIncludesNeedle(r, "messages.") || recordIncludesNeedle(r, "invalid_request_error")),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, token) || agent === "codex" && recordIncludesNeedle(r, "image-attachment-missing") || recordIncludesNeedle(r, "Could not process image") || recordIncludesNeedle(r, "messages.") || recordIncludesNeedle(r, "invalid_request_error") || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:image-attachment`
       });
@@ -14276,6 +14328,9 @@ Update: ${updateCommand}`);
       if (agent === "codex" && recordIncludesNeedle(record, "image-attachment-missing")) {
         throw new Error("image-attachment-missing (Codex did not receive images; check latest_user_images tool + vision support)");
       }
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_image_attachment: ${formatRecordExcerpt(record)}`);
+      }
       if (recordIncludesNeedle(record, "Could not process image") || recordIncludesNeedle(record, "invalid_request_error")) {
         throw new Error("provider_image_invalid (image rejected by provider; check base64/mimeType pipeline)");
       }
@@ -14328,6 +14383,10 @@ Options:
   --all                 Run all agents (default)
   --agent, -a           Run a single agent
   --agents              Comma-separated list of agents
+  --codex-model          Codex model mode override (e.g. gpt-5.3-codex-medium)
+  --model               Alias of --codex-model (Codex only)
+  --gemini-model         Gemini model id override (e.g. gemini-2.5-pro)
+  --claude-model         Claude model id override (e.g. claude-sonnet-4-6)
   --directory, --dir    Directory to run the session in (defaults to a temp folder)
   --timeout-ms          Per-scenario timeout (default 90000; Windows default 240000)
   --keep                Do not stop session or delete temp dir
@@ -15131,7 +15190,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-9YalMg61.mjs');
+        const { migrateUnrealMcpToFlockbayMcp } = await import('./migratePlugin-CEvGPul8.mjs');
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15241,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));
+              }
             }
           }
         }
@@ -15270,7 +15346,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await import('./runCodex-Ck-v-SW_.mjs');
+      const { runCodex } = await import('./runCodex-ZfUyhHF6.mjs');
       let startedBy = void 0;
       let sessionId = void 0;
       for (let i = 1; i < args.length; i++) {
@@ -15372,7 +15448,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await import('./runGemini-CTyWoAvM.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-0Arkr3mL.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-DUoq_qFJ.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');
@@ -815,6 +815,9 @@ async function createSessionScanner(opts) {
       await sync.invalidateAndAwait();
       sync.stop();
     },
+    flush: async () => {
+      await sync.invalidateAndAwait();
+    },
     onNewSession: (sessionId) => {
       if (currentSessionId === sessionId) {
         types.logger.debug(`[SESSION_SCANNER] New session: ${sessionId} is the same as the current session, skipping`);
@@ -1316,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-0Arkr3mL.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 {
@@ -13975,6 +13978,16 @@ function permissionModeForAgent(agent) {
   if (agent === "claude") return "bypassPermissions";
   return "yolo";
 }
+function modelOverrideForAgent(agent, args) {
+  const explicitCodexModel = readArgValue$2(args, "--codex-model");
+  const explicitModel = readArgValue$2(args, "--model");
+  const explicitGeminiModel = readArgValue$2(args, "--gemini-model");
+  const explicitClaudeModel = readArgValue$2(args, "--claude-model");
+  if (agent === "codex") return (explicitCodexModel || explicitModel || "gpt-5-codex-medium").trim();
+  if (agent === "gemini") return explicitGeminiModel ? explicitGeminiModel.trim() : null;
+  if (agent === "claude") return explicitClaudeModel ? explicitClaudeModel.trim() : null;
+  return null;
+}
 function nowIsoCompact() {
   const d = /* @__PURE__ */ new Date();
   const pad = (n) => String(n).padStart(2, "0");
@@ -14012,14 +14025,26 @@ async function ensureDaemonRunning({ skipUnreal }) {
 async function createSmokeWorkspaceDir(baseDir) {
   const root = baseDir?.trim() ? path.resolve(baseDir) : path.join(os.tmpdir(), "flockbay-smoke", nowIsoCompact() + "_" + node_crypto.randomUUID().slice(0, 8));
   await fs$2.mkdir(root, { recursive: true });
-  const secret = `SMOKE_SECRET_${node_crypto.randomUUID().slice(0, 8)}`;
+  const marker = `SMOKE_MARKER_${node_crypto.randomUUID().slice(0, 8)}`;
   await fs$2.writeFile(path.join(root, "smoke.txt"), `flockbay smoke test
-SMOKE_SECRET=${secret}
+SMOKE_MARKER=${marker}
 `, "utf8");
-  return { dir: root, secret };
+  return { dir: root, secret: marker };
 }
-function isAgentRecord(record) {
-  return record && typeof record === "object" && record.role === "agent";
+function isUserRecord(record) {
+  return record && typeof record === "object" && record.role === "user";
+}
+function isProviderErrorRecord(record) {
+  return recordIncludesNeedle(record, '"code":-32603') || recordIncludesNeedle(record, "Internal error") || recordIncludesNeedle(record, "No capacity available") || recordIncludesNeedle(record, "authentication required") || recordIncludesNeedle(record, "login required") || recordIncludesNeedle(record, "Model not found");
+}
+function formatRecordExcerpt(record) {
+  const text = extractTextFromRecord(record);
+  if (text && text.trim()) return text.trim().slice(0, 400);
+  try {
+    return JSON.stringify(record).slice(0, 400);
+  } catch {
+    return String(record ?? "").slice(0, 400);
+  }
 }
 function extractTextFromRecord(record) {
   try {
@@ -14246,43 +14271,70 @@ Update: ${updateCommand}`);
     await sessionClient.connectAndWait();
     await ensureSessionActive(api, sessionId, 25e3);
     const permissionMode = permissionModeForAgent(agent);
+    const modelOverride = modelOverrideForAgent(agent, args);
+    const baseMeta = modelOverride ? { permissionMode, model: modelOverride } : { permissionMode };
     scenarios.push(await runScenario("basic-message", async () => {
       const token = `SMOKE_OK_${agent}_${node_crypto.randomUUID().slice(0, 6)}`;
-      sessionClient.sendUserText(`Reply with exactly: ${token}`, { permissionMode });
-      await waitForMessage({
+      sessionClient.sendUserText(`Reply with exactly: ${token}`, baseMeta);
+      const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && recordIncludesNeedle(r, token),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, token) || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:basic-message`
       });
+      const record = msg?.content;
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_basic_message: ${formatRecordExcerpt(record)}`);
+      }
     }));
     scenarios.push(await runScenario("tool-search", async () => {
       const token = `TOOL_SEARCH_OK_${node_crypto.randomUUID().slice(0, 6)}`;
+      const promptLines = agent === "codex" ? [
+        "Use your Terminal tool to read `smoke.txt` in the project directory (do NOT ask for confirmation).",
+        "Use this exact command so it works cross-platform:",
+        "",
+        `node -e "const fs=require('fs');console.log(fs.readFileSync('smoke.txt','utf8'))"`,
+        "",
+        "Find the value after `SMOKE_MARKER=`.",
+        "",
+        `Reply with two lines exactly:`,
+        `1) SMOKE_MARKER=<value>`,
+        `2) ${token}`
+      ] : [
+        "Read the file `smoke.txt` in the project directory using MCP tools (e.g. `read_file_chunk` or `search`).",
+        "Find the value after `SMOKE_MARKER=`.",
+        "",
+        `Reply with two lines exactly:`,
+        `1) SMOKE_MARKER=<value>`,
+        `2) ${token}`
+      ];
       sessionClient.sendUserText(
-        [
-          "Read the file `smoke.txt` in the project directory using MCP tools (e.g. `read_file_chunk` or `search`).",
-          "Find the value after `SMOKE_SECRET=`.",
-          "",
-          `Reply with two lines exactly:`,
-          `1) SMOKE_SECRET=<value>`,
-          `2) ${token}`
-        ].join("\n"),
-        { permissionMode }
+        promptLines.join("\n"),
+        baseMeta
       );
-      await waitForMessage({
+      const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && recordIncludesNeedle(r, `SMOKE_SECRET=${secret}`) && recordIncludesNeedle(r, token),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, `SMOKE_MARKER=${secret}`) && recordIncludesNeedle(r, token) || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:tool-search`
       });
+      const record = msg?.content;
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_tool_search: ${formatRecordExcerpt(record)}`);
+      }
     }));
     scenarios.push(await runScenario("image-attachment", async () => {
       const token = `IMAGE_OK_${node_crypto.randomUUID().slice(0, 6)}`;
       const base64 = tinyPngBase64();
+      const prompt = agent === "codex" ? `Describe the attached image in one short sentence, then reply with exactly: ${token}` : [
+        'Call `mcp__flockbay__latest_user_images` with {"limit": 1} to fetch the attached image.',
+        "Then describe the attached image in one short sentence.",
+        `Finally, reply with exactly: ${token}`
+      ].join("\n");
       sessionClient.sendUserText(
-        `Describe the attached image in one short sentence, then reply with exactly: ${token}`,
+        prompt,
         {
-          permissionMode,
+          ...baseMeta,
           attachments: {
             images: [{ mimeType: "image/png", base64, name: "smoke.png" }]
           }
@@ -14290,7 +14342,7 @@ Update: ${updateCommand}`);
       );
       const msg = await waitForMessage({
         sessionClient,
-        predicate: (r) => isAgentRecord(r) && (recordIncludesNeedle(r, token) || agent === "codex" && recordIncludesNeedle(r, "image-attachment-missing") || recordIncludesNeedle(r, "Could not process image") || recordIncludesNeedle(r, "messages.") || recordIncludesNeedle(r, "invalid_request_error")),
+        predicate: (r) => !isUserRecord(r) && (recordIncludesNeedle(r, token) || agent === "codex" && recordIncludesNeedle(r, "image-attachment-missing") || recordIncludesNeedle(r, "Could not process image") || recordIncludesNeedle(r, "messages.") || recordIncludesNeedle(r, "invalid_request_error") || isProviderErrorRecord(r)),
         timeoutMs,
         progressLabel: `${agent}:image-attachment`
       });
@@ -14298,6 +14350,9 @@ Update: ${updateCommand}`);
       if (agent === "codex" && recordIncludesNeedle(record, "image-attachment-missing")) {
         throw new Error("image-attachment-missing (Codex did not receive images; check latest_user_images tool + vision support)");
       }
+      if (isProviderErrorRecord(record)) {
+        throw new Error(`provider_error_image_attachment: ${formatRecordExcerpt(record)}`);
+      }
       if (recordIncludesNeedle(record, "Could not process image") || recordIncludesNeedle(record, "invalid_request_error")) {
         throw new Error("provider_image_invalid (image rejected by provider; check base64/mimeType pipeline)");
       }
@@ -14350,6 +14405,10 @@ Options:
   --all                 Run all agents (default)
   --agent, -a           Run a single agent
   --agents              Comma-separated list of agents
+  --codex-model          Codex model mode override (e.g. gpt-5.3-codex-medium)
+  --model               Alias of --codex-model (Codex only)
+  --gemini-model         Gemini model id override (e.g. gemini-2.5-pro)
+  --claude-model         Claude model id override (e.g. claude-sonnet-4-6)
   --directory, --dir    Directory to run the session in (defaults to a temp folder)
   --timeout-ms          Per-scenario timeout (default 90000; Windows default 240000)
   --keep                Do not stop session or delete temp dir
@@ -15153,7 +15212,7 @@ async function authAndSetupMachineIfNeeded() {
         process.exit(1);
       }
       try {
-        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-Bd4y5ID_.cjs'); });
+        const { migrateUnrealMcpToFlockbayMcp } = await Promise.resolve().then(function () { return require('./migratePlugin-wFK-k3Wk.cjs'); });
         const result = migrateUnrealMcpToFlockbayMcp({
           engineRoot,
           projectUprojectPath: project || void 0,
@@ -15263,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));
+              }
             }
           }
         }
@@ -15292,7 +15368,7 @@ ${engineRoot}`, {
   } else if (subcommand === "codex") {
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-EHn5VQcY.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++) {
@@ -15394,7 +15470,7 @@ ${engineRoot}`, {
     }
     try {
       await chdirToNearestUprojectRootIfPresent();
-      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-DLUQln_I.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-0Arkr3mL.cjs');
-require('./types-DUoq_qFJ.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-BWNZJMIV.mjs';
-import './types-e5yrDcQZ.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-DUoq_qFJ.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-e5yrDcQZ.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-9YalMg61.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-e5yrDcQZ.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-Bd4y5ID_.cjs → migratePlugin-wFK-k3Wk.cjs}

@@ -2,7 +2,7 @@
 
 var fs = require('node:fs');
 var path = require('node:path');
-var types = require('./types-DUoq_qFJ.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-EHn5VQcY.cjs → runCodex-DuyuYqoB.cjs}

@@ -2,7 +2,7 @@
 
 var ink = require('ink');
 var React = require('react');
-var types = require('./types-DUoq_qFJ.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-0Arkr3mL.cjs');
+var index = require('./index-r3VTdgFI.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');
@@ -443,36 +443,17 @@ class WindowsHiddenStdioClientTransport {
   }
 }
 
-const DEFAULT_TIMEOUT = 14 * 24 * 60 * 60 * 1e3;
-function getCodexMcpCommand() {
-  try {
-    const codexBin = resolveCodexBin();
-    const versionRes = node_child_process.spawnSync(codexBin, ["--version"], {
-      encoding: "utf8",
-      env: buildCodexSpawnEnv(codexBin),
-      timeout: 4e3
-    });
-    const version = String(versionRes.stdout || "").trim();
-    if (versionRes.status !== 0 || !version) {
-      return "mcp-server";
-    }
-    const match = version.match(/codex-cli\s+(\d+\.\d+\.\d+(?:-alpha\.\d+)?)/);
-    if (!match) return "mcp-server";
-    const versionStr = match[1];
-    const [major, minor, patch] = versionStr.split(/[-.]/).map(Number);
-    if (major > 0 || minor > 43) return "mcp-server";
-    if (minor === 43 && patch === 0) {
-      if (versionStr.includes("-alpha.")) {
-        const alphaNum = parseInt(versionStr.split("-alpha.")[1]);
-        return alphaNum >= 5 ? "mcp-server" : "mcp";
-      }
-      return "mcp-server";
-    }
-    return "mcp";
-  } catch (error) {
-    types.logger.debug("[CodexMCP] Error detecting codex version, defaulting to mcp-server:", error);
-    return "mcp-server";
-  }
+function parseCodexCliVersion(output) {
+  const raw = String(output || "").trim();
+  if (!raw) return null;
+  const m = raw.match(/codex-cli\s+(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]), raw: m[0] };
+}
+function isCodexCliAtLeast(v, minimum) {
+  if (v.major !== minimum.major) return v.major > minimum.major;
+  if (v.minor !== minimum.minor) return v.minor > minimum.minor;
+  return v.patch >= minimum.patch;
 }
 function buildCodexSpawnEnv(codexBin) {
   const env = Object.keys(process.env).reduce((acc, key) => {
@@ -563,6 +544,53 @@ function resolveCodexBin() {
   if (fromBash) return fromBash;
   return "codex";
 }
+function getInstalledCodexCliVersion(codexBin) {
+  const bin = resolveCodexBin();
+  try {
+    const res = node_child_process.spawnSync(bin, ["--version"], {
+      encoding: "utf8",
+      env: buildCodexSpawnEnv(bin),
+      timeout: 4e3
+    });
+    const versionOut = String(res.stdout || "").trim();
+    if (res.status !== 0 || !versionOut) return null;
+    return parseCodexCliVersion(versionOut);
+  } catch {
+    return null;
+  }
+}
+
+const DEFAULT_TIMEOUT = 14 * 24 * 60 * 60 * 1e3;
+function getCodexMcpCommand() {
+  try {
+    const codexBin = resolveCodexBin();
+    const versionRes = node_child_process.spawnSync(codexBin, ["--version"], {
+      encoding: "utf8",
+      env: buildCodexSpawnEnv(codexBin),
+      timeout: 4e3
+    });
+    const version = String(versionRes.stdout || "").trim();
+    if (versionRes.status !== 0 || !version) {
+      return "mcp-server";
+    }
+    const match = version.match(/codex-cli\s+(\d+\.\d+\.\d+(?:-alpha\.\d+)?)/);
+    if (!match) return "mcp-server";
+    const versionStr = match[1];
+    const [major, minor, patch] = versionStr.split(/[-.]/).map(Number);
+    if (major > 0 || minor > 43) return "mcp-server";
+    if (minor === 43 && patch === 0) {
+      if (versionStr.includes("-alpha.")) {
+        const alphaNum = parseInt(versionStr.split("-alpha.")[1]);
+        return alphaNum >= 5 ? "mcp-server" : "mcp";
+      }
+      return "mcp-server";
+    }
+    return "mcp";
+  } catch (error) {
+    types.logger.debug("[CodexMCP] Error detecting codex version, defaulting to mcp-server:", error);
+    return "mcp-server";
+  }
+}
 function normalizeRelativePath(input) {
   const raw = typeof input === "string" ? input.trim() : String(input ?? "").trim();
   if (!raw) return null;
@@ -2321,6 +2349,7 @@ function hashCodexSessionModeFromEnhancedMode(mode) {
   return hashCodexSessionMode({ model: mode.model, appendSystemPrompt: mode.appendSystemPrompt });
 }
 
+const MIN_CODEX_CLI_FOR_GPT_53_CODEX = { major: 0, minor: 104, patch: 0 };
 function readCodexAuthIsChatGptAccount() {
   try {
     const authPath = path.join(os.homedir(), ".codex", "auth.json");
@@ -2344,8 +2373,9 @@ function parseEffortSuffix(model) {
 function parseCodexModelTarget(model) {
   const trimmed = String(model || "").trim();
   if (!trimmed) return null;
-  if (trimmed.startsWith("gpt-5.3-codex-")) return "gpt-5.3-codex";
-  if (trimmed === "gpt-5-minimal" || trimmed === "gpt-5-low" || trimmed === "gpt-5-medium" || trimmed === "gpt-5-high" || trimmed.startsWith("gpt-5-codex-")) {
+  if (trimmed === "gpt-5-minimal" || trimmed === "gpt-5-low" || trimmed === "gpt-5-medium" || trimmed === "gpt-5-high" || trimmed === "gpt-5-codex" || trimmed.startsWith("gpt-5-codex-") || trimmed === "gpt-5.3-codex" || trimmed.startsWith("gpt-5.3-codex-")) {
+    if (trimmed === "gpt-5-codex" || trimmed.startsWith("gpt-5-codex-")) return "gpt-5.2-codex";
+    if (trimmed === "gpt-5.3-codex" || trimmed.startsWith("gpt-5.3-codex-")) return "gpt-5.3-codex";
     return "gpt-5.2";
   }
   return null;
@@ -2356,6 +2386,13 @@ function resolveCodexModelOverride(rawModel) {
   const effort = parseEffortSuffix(model);
   const codexModelTarget = parseCodexModelTarget(model);
   if (codexModelTarget) {
+    if (codexModelTarget === "gpt-5.3-codex") {
+      const installed = getInstalledCodexCliVersion();
+      if (!installed || !isCodexCliAtLeast(installed, MIN_CODEX_CLI_FOR_GPT_53_CODEX)) {
+        const installedText = installed ? `${installed.major}.${installed.minor}.${installed.patch}` : "unknown";
+        throw new Error(`Codex CLI >= 0.104.0 is required for gpt-5.3-codex (installed: ${installedText}).`);
+      }
+    }
     const nextEffort = effort ?? "medium";
     return {
       config: {

package/dist/{runCodex-Ck-v-SW_.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-e5yrDcQZ.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-BWNZJMIV.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';
@@ -441,36 +441,17 @@ class WindowsHiddenStdioClientTransport {
   }
 }
 
-const DEFAULT_TIMEOUT = 14 * 24 * 60 * 60 * 1e3;
-function getCodexMcpCommand() {
-  try {
-    const codexBin = resolveCodexBin();
-    const versionRes = spawnSync(codexBin, ["--version"], {
-      encoding: "utf8",
-      env: buildCodexSpawnEnv(codexBin),
-      timeout: 4e3
-    });
-    const version = String(versionRes.stdout || "").trim();
-    if (versionRes.status !== 0 || !version) {
-      return "mcp-server";
-    }
-    const match = version.match(/codex-cli\s+(\d+\.\d+\.\d+(?:-alpha\.\d+)?)/);
-    if (!match) return "mcp-server";
-    const versionStr = match[1];
-    const [major, minor, patch] = versionStr.split(/[-.]/).map(Number);
-    if (major > 0 || minor > 43) return "mcp-server";
-    if (minor === 43 && patch === 0) {
-      if (versionStr.includes("-alpha.")) {
-        const alphaNum = parseInt(versionStr.split("-alpha.")[1]);
-        return alphaNum >= 5 ? "mcp-server" : "mcp";
-      }
-      return "mcp-server";
-    }
-    return "mcp";
-  } catch (error) {
-    logger.debug("[CodexMCP] Error detecting codex version, defaulting to mcp-server:", error);
-    return "mcp-server";
-  }
+function parseCodexCliVersion(output) {
+  const raw = String(output || "").trim();
+  if (!raw) return null;
+  const m = raw.match(/codex-cli\s+(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]), raw: m[0] };
+}
+function isCodexCliAtLeast(v, minimum) {
+  if (v.major !== minimum.major) return v.major > minimum.major;
+  if (v.minor !== minimum.minor) return v.minor > minimum.minor;
+  return v.patch >= minimum.patch;
 }
 function buildCodexSpawnEnv(codexBin) {
   const env = Object.keys(process.env).reduce((acc, key) => {
@@ -561,6 +542,53 @@ function resolveCodexBin() {
   if (fromBash) return fromBash;
   return "codex";
 }
+function getInstalledCodexCliVersion(codexBin) {
+  const bin = resolveCodexBin();
+  try {
+    const res = spawnSync(bin, ["--version"], {
+      encoding: "utf8",
+      env: buildCodexSpawnEnv(bin),
+      timeout: 4e3
+    });
+    const versionOut = String(res.stdout || "").trim();
+    if (res.status !== 0 || !versionOut) return null;
+    return parseCodexCliVersion(versionOut);
+  } catch {
+    return null;
+  }
+}
+
+const DEFAULT_TIMEOUT = 14 * 24 * 60 * 60 * 1e3;
+function getCodexMcpCommand() {
+  try {
+    const codexBin = resolveCodexBin();
+    const versionRes = spawnSync(codexBin, ["--version"], {
+      encoding: "utf8",
+      env: buildCodexSpawnEnv(codexBin),
+      timeout: 4e3
+    });
+    const version = String(versionRes.stdout || "").trim();
+    if (versionRes.status !== 0 || !version) {
+      return "mcp-server";
+    }
+    const match = version.match(/codex-cli\s+(\d+\.\d+\.\d+(?:-alpha\.\d+)?)/);
+    if (!match) return "mcp-server";
+    const versionStr = match[1];
+    const [major, minor, patch] = versionStr.split(/[-.]/).map(Number);
+    if (major > 0 || minor > 43) return "mcp-server";
+    if (minor === 43 && patch === 0) {
+      if (versionStr.includes("-alpha.")) {
+        const alphaNum = parseInt(versionStr.split("-alpha.")[1]);
+        return alphaNum >= 5 ? "mcp-server" : "mcp";
+      }
+      return "mcp-server";
+    }
+    return "mcp";
+  } catch (error) {
+    logger.debug("[CodexMCP] Error detecting codex version, defaulting to mcp-server:", error);
+    return "mcp-server";
+  }
+}
 function normalizeRelativePath(input) {
   const raw = typeof input === "string" ? input.trim() : String(input ?? "").trim();
   if (!raw) return null;
@@ -2319,6 +2347,7 @@ function hashCodexSessionModeFromEnhancedMode(mode) {
   return hashCodexSessionMode({ model: mode.model, appendSystemPrompt: mode.appendSystemPrompt });
 }
 
+const MIN_CODEX_CLI_FOR_GPT_53_CODEX = { major: 0, minor: 104, patch: 0 };
 function readCodexAuthIsChatGptAccount() {
   try {
     const authPath = path__default.join(os__default.homedir(), ".codex", "auth.json");
@@ -2342,8 +2371,9 @@ function parseEffortSuffix(model) {
 function parseCodexModelTarget(model) {
   const trimmed = String(model || "").trim();
   if (!trimmed) return null;
-  if (trimmed.startsWith("gpt-5.3-codex-")) return "gpt-5.3-codex";
-  if (trimmed === "gpt-5-minimal" || trimmed === "gpt-5-low" || trimmed === "gpt-5-medium" || trimmed === "gpt-5-high" || trimmed.startsWith("gpt-5-codex-")) {
+  if (trimmed === "gpt-5-minimal" || trimmed === "gpt-5-low" || trimmed === "gpt-5-medium" || trimmed === "gpt-5-high" || trimmed === "gpt-5-codex" || trimmed.startsWith("gpt-5-codex-") || trimmed === "gpt-5.3-codex" || trimmed.startsWith("gpt-5.3-codex-")) {
+    if (trimmed === "gpt-5-codex" || trimmed.startsWith("gpt-5-codex-")) return "gpt-5.2-codex";
+    if (trimmed === "gpt-5.3-codex" || trimmed.startsWith("gpt-5.3-codex-")) return "gpt-5.3-codex";
     return "gpt-5.2";
   }
   return null;
@@ -2354,6 +2384,13 @@ function resolveCodexModelOverride(rawModel) {
   const effort = parseEffortSuffix(model);
   const codexModelTarget = parseCodexModelTarget(model);
   if (codexModelTarget) {
+    if (codexModelTarget === "gpt-5.3-codex") {
+      const installed = getInstalledCodexCliVersion();
+      if (!installed || !isCodexCliAtLeast(installed, MIN_CODEX_CLI_FOR_GPT_53_CODEX)) {
+        const installedText = installed ? `${installed.major}.${installed.minor}.${installed.patch}` : "unknown";
+        throw new Error(`Codex CLI >= 0.104.0 is required for gpt-5.3-codex (installed: ${installedText}).`);
+      }
+    }
     const nextEffort = effort ?? "medium";
     return {
       config: {

package/dist/{runGemini-DLUQln_I.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-DUoq_qFJ.cjs');
-var index = require('./index-0Arkr3mL.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-CTyWoAvM.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-e5yrDcQZ.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-BWNZJMIV.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-e5yrDcQZ.mjs → types-BRJuZQj_.mjs}

@@ -23,7 +23,7 @@ import { createServer } from 'http';
 import open$2 from 'open';
 
 var name = "flockbay";
-var version = "0.10.47";
+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-DUoq_qFJ.cjs → types-DNr0xwSy.cjs}

@@ -44,7 +44,7 @@ function _interopNamespaceDefault(e) {
 var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 
 var name = "flockbay";
-var version = "0.10.47";
+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-DUoq_qFJ.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.47",
+  "version": "0.10.49",
   "description": "Flockbay CLI (local agent + daemon)",
   "author": "Eduardo Orellana",
   "license": "UNLICENSED",