flockbay-cli 0.10.9 → 0.10.12

package/README.md

@@ -2,7 +2,7 @@
 
 Code on the go controlling Claude/Codex sessions from your mobile device.
 
-Free. Open source. Code anywhere.
+Code anywhere.
 
 Flockbay CLI is the command-line tool for running and controlling Flockbay sessions (including daemon and Codex mode).
 
@@ -41,16 +41,7 @@ This will:
 - `--claude-env KEY=VALUE` - Set environment variable for Claude Code (e.g., for [claude-code-router](https://github.com/musistudio/claude-code-router))
 - `--claude-arg ARG` - Pass additional argument to Claude CLI
 
-## Environment Variables
-
-- `FLOCKBAY_SERVER_URL` - API base URL (default: https://api.flockbay.com)
-- `FLOCKBAY_WEBAPP_URL` - Web app base URL (default: https://flockbay.com)
-- `FLOCKBAY_HOME_DIR` - Home directory for local CLI state (default: `~/.flockbay`)
-- `FLOCKBAY_DISABLE_CAFFEINATE` - Disable macOS sleep prevention (set to `true`, `1`, or `yes`)
-- `FLOCKBAY_EXPERIMENTAL` - Enable experimental features (set to `true`, `1`, or `yes`)
-
-Legacy env vars are still supported for compatibility:
-- `FLOCKBAY_SERVER_URL`, `FLOCKBAY_WEBAPP_URL`, `FLOCKBAY_HOME_DIR`, `FLOCKBAY_DISABLE_CAFFEINATE`, `FLOCKBAY_EXPERIMENTAL`
+Run `flockbay --help` for the complete list of options.
 
 ## Requirements
 
@@ -62,4 +53,4 @@ Legacy env vars are still supported for compatibility:
 
 ## License
 
-MIT
+Proprietary. Copyright (c) 2024-2026 Flockbay. All rights reserved.

package/dist/codex/flockbayMcpStdioBridge.cjs

@@ -6,24 +6,7 @@ var index_js = require('@modelcontextprotocol/sdk/client/index.js');
 var streamableHttp_js = require('@modelcontextprotocol/sdk/client/streamableHttp.js');
 var z = require('zod');
 
-const INTERACTIVE_TOOL_TIMEOUT_MS = 14 * 24 * 60 * 60 * 1e3;
-function clampTimeoutMs(timeoutMs) {
-  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) return INTERACTIVE_TOOL_TIMEOUT_MS;
-  return Math.max(1e3, Math.min(INTERACTIVE_TOOL_TIMEOUT_MS, Math.floor(timeoutMs)));
-}
 function getToolCallTimeoutMs(name, args) {
-  if (name === "ask_user_question") return INTERACTIVE_TOOL_TIMEOUT_MS;
-  const timeoutMs = typeof args?.timeoutMs === "number" ? args.timeoutMs : void 0;
-  const bakeTimeoutMs = typeof args?.bakeTimeoutMs === "number" ? args.bakeTimeoutMs : void 0;
-  if (name === "unreal_fast_preview") {
-    const previewMs = timeoutMs ?? 6e5;
-    const bakeMs = bakeTimeoutMs ?? 18e5;
-    return clampTimeoutMs(previewMs + bakeMs + 5 * 6e4);
-  }
-  if (name === "unreal_headless_screenshot") {
-    const shotsMs = timeoutMs ?? 6e5;
-    return clampTimeoutMs(shotsMs + 2 * 6e4);
-  }
   return void 0;
 }
 function parseArgs(argv) {
@@ -301,21 +284,6 @@ async function main() {
     "Docs Import",
     "Import markdown files into the Documentation Library (copy into backend DB)."
   );
-  forwardTool(
-    "unreal_headless_screenshot",
-    {
-      uprojectPath: z.z.string().describe("Absolute path to the .uproject file."),
-      engineRoot: z.z.string().optional().describe("Unreal Engine install root (e.g. /Users/Shared/Epic Games/UE_5.7). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."),
-      resX: z.z.number().int().positive().optional().describe("Output resolution width (default 800)."),
-      resY: z.z.number().int().positive().optional().describe("Output resolution height (default 450)."),
-      fast: z.z.boolean().optional().describe("Enable fast screenshot mode (-FlockbayScreenshotFast)."),
-      focus: z.z.string().optional().describe('Focus point "x;y;z" (or "x,y,z"), forwarded as -FlockbayScreenshotFocus=...'),
-      extraArgs: z.z.array(z.z.string()).optional().describe("Additional Unreal command-line args (advanced)."),
-      timeoutMs: z.z.number().int().positive().optional().describe("Timeout in ms (default 600000).")
-    },
-    "Unreal Headless Screenshot",
-    "Run the Unreal Engine project in headless/offscreen mode and capture a screenshot using -FlockbayScreenshotMode."
-  );
   forwardTool(
     "unreal_latest_screenshots",
     {
@@ -328,33 +296,62 @@ async function main() {
     "Fetch the latest PNG screenshots from Saved/Screenshots/Flockbay and return views for the UI to display."
   );
   forwardTool(
-    "unreal_fast_preview",
+    "unreal_mcp_command",
     {
-      uprojectPath: z.z.string().describe("Absolute path to the .uproject file."),
-      engineRoot: z.z.string().optional().describe(
-        "Unreal Engine install root (e.g. /Users/Shared/Epic Games/UE_5.7). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."
-      ),
-      resX: z.z.number().int().positive().optional().describe("Output resolution width (default 800)."),
-      resY: z.z.number().int().positive().optional().describe("Output resolution height (default 450)."),
-      fast: z.z.boolean().optional().describe("Enable fast screenshot mode (-FlockbayScreenshotFast). Default true."),
-      focus: z.z.string().optional().describe('Focus point "x;y;z" (or "x,y,z"), forwarded as -FlockbayScreenshotFocus=...'),
-      extraArgs: z.z.array(z.z.string()).optional().describe("Additional Unreal command-line args (advanced)."),
-      timeoutMs: z.z.number().int().positive().optional().describe("Timeout in ms (default 600000)."),
-      expectedViews: z.z.array(z.z.string()).optional().describe('If provided, fail unless these view IDs exist (e.g. ["spawn_overview"]).'),
-      mode: z.z.enum(["auto", "preview_only", "bake_and_preview"]).optional().describe(
-        "auto=try preview, then bake+preview if preview fails. preview_only=never bake. bake_and_preview=always bake first. Default auto."
-      ),
-      bakeTimeoutMs: z.z.number().int().positive().optional().describe("Timeout in ms for bake step (default 1800000)."),
-      bakeMap: z.z.string().optional().describe("Map asset path used for baking (defaults to Config/GameConfig.json map.levelName; fail-hard if empty)."),
-      configRelPath: z.z.string().optional().describe("Game config path relative to project root (default Config/GameConfig.json)."),
-      reuseIfUnchanged: z.z.boolean().optional().describe("If inputs match the last successful run, reuse prior artifacts (upload existing screenshots) instead of rerunning Unreal. Default true."),
-      requireScatterBudget: z.z.boolean().optional().describe("Fail unless world.scatterBudget exists (prelaunch safety gate). Default false."),
-      baselineKey: z.z.string().optional().describe('Baseline key for compare/pin (stored under .flockbay/baselines/fast-preview/<baselineKey>). Default "default".'),
-      baselineAction: z.z.enum(["none", "compare", "set"]).optional().describe("compare=report differences vs baseline. set=overwrite baseline with this run. Default none."),
-      failOnBaselineDiff: z.z.boolean().optional().describe("When baselineAction=compare, fail if screenshots differ from baseline. Default false.")
+      type: z.z.string().describe('UnrealMCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
+      params: z.z.record(z.z.any()).optional().describe("Optional params object for the command."),
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Editor Command (UnrealMCP)",
+    "Send a single UnrealMCP command to the running Unreal Editor (engine plugin) and return the JSON response."
+  );
+  forwardTool(
+    "unreal_mcp_get_actors_in_level",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Actors In Level (UnrealMCP)",
+    "List all actors in the current Unreal Editor level via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_get_play_in_editor_status",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play Status (PIE)",
+    "Get Play-In-Editor status from the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_editor_health",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
+    },
+    "Unreal Editor Health (UnrealMCP)",
+    "Best-effort health check for Unreal Editor + UnrealMCP (detects if the editor is reachable)."
+  );
+  forwardTool(
+    "unreal_mcp_play_in_editor",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play In Editor (Viewport)",
+    "Start Play-In-Editor (PIE) in the active editor viewport via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_play_in_editor_windowed",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play In Editor (New Window)",
+    "Start Play-In-Editor (PIE) in a new editor window via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_stop_play_in_editor",
+    {
+      timeoutMs: z.z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Fast Preview (Evidence First)",
-    "Run a fast headless Unreal preview and attach stable screenshot evidence + a run manifest to the session."
+    "Unreal Stop Play In Editor",
+    "Stop a running Play-In-Editor session via the UnrealMCP engine plugin."
   );
   forwardTool(
     "unreal_mechanic_run",

package/dist/codex/flockbayMcpStdioBridge.mjs

@@ -4,24 +4,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { z } from 'zod';
 
-const INTERACTIVE_TOOL_TIMEOUT_MS = 14 * 24 * 60 * 60 * 1e3;
-function clampTimeoutMs(timeoutMs) {
-  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) return INTERACTIVE_TOOL_TIMEOUT_MS;
-  return Math.max(1e3, Math.min(INTERACTIVE_TOOL_TIMEOUT_MS, Math.floor(timeoutMs)));
-}
 function getToolCallTimeoutMs(name, args) {
-  if (name === "ask_user_question") return INTERACTIVE_TOOL_TIMEOUT_MS;
-  const timeoutMs = typeof args?.timeoutMs === "number" ? args.timeoutMs : void 0;
-  const bakeTimeoutMs = typeof args?.bakeTimeoutMs === "number" ? args.bakeTimeoutMs : void 0;
-  if (name === "unreal_fast_preview") {
-    const previewMs = timeoutMs ?? 6e5;
-    const bakeMs = bakeTimeoutMs ?? 18e5;
-    return clampTimeoutMs(previewMs + bakeMs + 5 * 6e4);
-  }
-  if (name === "unreal_headless_screenshot") {
-    const shotsMs = timeoutMs ?? 6e5;
-    return clampTimeoutMs(shotsMs + 2 * 6e4);
-  }
   return void 0;
 }
 function parseArgs(argv) {
@@ -299,21 +282,6 @@ async function main() {
     "Docs Import",
     "Import markdown files into the Documentation Library (copy into backend DB)."
   );
-  forwardTool(
-    "unreal_headless_screenshot",
-    {
-      uprojectPath: z.string().describe("Absolute path to the .uproject file."),
-      engineRoot: z.string().optional().describe("Unreal Engine install root (e.g. /Users/Shared/Epic Games/UE_5.7). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."),
-      resX: z.number().int().positive().optional().describe("Output resolution width (default 800)."),
-      resY: z.number().int().positive().optional().describe("Output resolution height (default 450)."),
-      fast: z.boolean().optional().describe("Enable fast screenshot mode (-FlockbayScreenshotFast)."),
-      focus: z.string().optional().describe('Focus point "x;y;z" (or "x,y,z"), forwarded as -FlockbayScreenshotFocus=...'),
-      extraArgs: z.array(z.string()).optional().describe("Additional Unreal command-line args (advanced)."),
-      timeoutMs: z.number().int().positive().optional().describe("Timeout in ms (default 600000).")
-    },
-    "Unreal Headless Screenshot",
-    "Run the Unreal Engine project in headless/offscreen mode and capture a screenshot using -FlockbayScreenshotMode."
-  );
   forwardTool(
     "unreal_latest_screenshots",
     {
@@ -326,33 +294,62 @@ async function main() {
     "Fetch the latest PNG screenshots from Saved/Screenshots/Flockbay and return views for the UI to display."
   );
   forwardTool(
-    "unreal_fast_preview",
+    "unreal_mcp_command",
     {
-      uprojectPath: z.string().describe("Absolute path to the .uproject file."),
-      engineRoot: z.string().optional().describe(
-        "Unreal Engine install root (e.g. /Users/Shared/Epic Games/UE_5.7). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."
-      ),
-      resX: z.number().int().positive().optional().describe("Output resolution width (default 800)."),
-      resY: z.number().int().positive().optional().describe("Output resolution height (default 450)."),
-      fast: z.boolean().optional().describe("Enable fast screenshot mode (-FlockbayScreenshotFast). Default true."),
-      focus: z.string().optional().describe('Focus point "x;y;z" (or "x,y,z"), forwarded as -FlockbayScreenshotFocus=...'),
-      extraArgs: z.array(z.string()).optional().describe("Additional Unreal command-line args (advanced)."),
-      timeoutMs: z.number().int().positive().optional().describe("Timeout in ms (default 600000)."),
-      expectedViews: z.array(z.string()).optional().describe('If provided, fail unless these view IDs exist (e.g. ["spawn_overview"]).'),
-      mode: z.enum(["auto", "preview_only", "bake_and_preview"]).optional().describe(
-        "auto=try preview, then bake+preview if preview fails. preview_only=never bake. bake_and_preview=always bake first. Default auto."
-      ),
-      bakeTimeoutMs: z.number().int().positive().optional().describe("Timeout in ms for bake step (default 1800000)."),
-      bakeMap: z.string().optional().describe("Map asset path used for baking (defaults to Config/GameConfig.json map.levelName; fail-hard if empty)."),
-      configRelPath: z.string().optional().describe("Game config path relative to project root (default Config/GameConfig.json)."),
-      reuseIfUnchanged: z.boolean().optional().describe("If inputs match the last successful run, reuse prior artifacts (upload existing screenshots) instead of rerunning Unreal. Default true."),
-      requireScatterBudget: z.boolean().optional().describe("Fail unless world.scatterBudget exists (prelaunch safety gate). Default false."),
-      baselineKey: z.string().optional().describe('Baseline key for compare/pin (stored under .flockbay/baselines/fast-preview/<baselineKey>). Default "default".'),
-      baselineAction: z.enum(["none", "compare", "set"]).optional().describe("compare=report differences vs baseline. set=overwrite baseline with this run. Default none."),
-      failOnBaselineDiff: z.boolean().optional().describe("When baselineAction=compare, fail if screenshots differ from baseline. Default false.")
+      type: z.string().describe('UnrealMCP command type (e.g. "get_actors_in_level", "spawn_actor").'),
+      params: z.record(z.any()).optional().describe("Optional params object for the command."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Editor Command (UnrealMCP)",
+    "Send a single UnrealMCP command to the running Unreal Editor (engine plugin) and return the JSON response."
+  );
+  forwardTool(
+    "unreal_mcp_get_actors_in_level",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Actors In Level (UnrealMCP)",
+    "List all actors in the current Unreal Editor level via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_get_play_in_editor_status",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play Status (PIE)",
+    "Get Play-In-Editor status from the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_editor_health",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 1500).")
+    },
+    "Unreal Editor Health (UnrealMCP)",
+    "Best-effort health check for Unreal Editor + UnrealMCP (detects if the editor is reachable)."
+  );
+  forwardTool(
+    "unreal_mcp_play_in_editor",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play In Editor (Viewport)",
+    "Start Play-In-Editor (PIE) in the active editor viewport via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_play_in_editor_windowed",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Play In Editor (New Window)",
+    "Start Play-In-Editor (PIE) in a new editor window via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_stop_play_in_editor",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
     },
-    "Unreal Fast Preview (Evidence First)",
-    "Run a fast headless Unreal preview and attach stable screenshot evidence + a run manifest to the session."
+    "Unreal Stop Play In Editor",
+    "Stop a running Play-In-Editor session via the UnrealMCP engine plugin."
   );
   forwardTool(
     "unreal_mechanic_run",