flockbay 0.10.15 → 0.10.16

package/dist/codex/flockbayMcpStdioBridge.mjs

@@ -94,6 +94,22 @@ async function main() {
     "Read Images",
     "Read one or more local PNG images by path and return a `{ views: [...] }` payload for the UI."
   );
+  forwardTool(
+    "evidence_list",
+    {
+      limit: z.number().int().positive().optional().describe("Max items to return (default 50).")
+    },
+    "Evidence List",
+    "List server-stored evidence manifests for this chat session (uploaded by tools like fast preview and headless screenshots)."
+  );
+  forwardTool(
+    "evidence_get",
+    {
+      evidenceArtifactId: z.string().describe("Evidence id (e.g. ea_...).")
+    },
+    "Evidence Get",
+    "Fetch one server-stored evidence manifest by id."
+  );
   forwardTool(
     "ask_user_question",
     {
@@ -293,6 +309,19 @@ async function main() {
     "Latest Unreal Screenshots",
     "Fetch the latest PNG screenshots from Saved/Screenshots/Flockbay and return views for the UI to display."
   );
+  forwardTool(
+    "unreal_build_project",
+    {
+      uprojectPath: z.string().describe("Absolute path to the .uproject file."),
+      engineRoot: z.string().optional().describe("Optional Unreal Engine install root. Defaults to ENGINE_ROOT / UE_ENGINE_ROOT, or inferred from EngineAssociation when possible."),
+      configuration: z.enum(["Debug", "DebugGame", "Development", "Shipping"]).optional().describe("Build configuration (default Development)."),
+      target: z.enum(["Editor", "Game"]).optional().describe("Build target (default Editor)."),
+      timeoutMs: z.number().int().positive().optional().describe("Timeout in ms (default 20m)."),
+      issuesLimit: z.number().int().positive().optional().describe("Max issues to return (default 250, max 2000).")
+    },
+    "Unreal Build Project (UBT)",
+    "Build the project via Unreal Build Tool (via Engine/Build/BatchFiles/Build.*). Returns structured errors (file/line) and a log path."
+  );
   forwardTool(
     "unreal_mcp_command",
     {
@@ -303,6 +332,226 @@ async function main() {
     "Unreal Editor Command (UnrealMCP)",
     "Send a single UnrealMCP command to the running Unreal Editor (engine plugin) and return the JSON response."
   );
+  forwardTool(
+    "unreal_mcp_search_assets",
+    {
+      query: z.string().optional().describe("Fuzzy search string (name/path)."),
+      class: z.union([z.string(), z.array(z.string())]).optional().describe('Optional asset class filter (e.g. "StaticMesh", "Blueprint", "Material").'),
+      root: z.string().optional().describe('Root path to search (default "/Game/").'),
+      limit: z.number().int().positive().optional().describe("Max results (default 25, max 200)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Search Assets (UnrealMCP)",
+    "Search for assets in the current Unreal project via the UnrealMCP engine plugin (AssetRegistry-backed)."
+  );
+  forwardTool(
+    "unreal_mcp_get_asset_info",
+    {
+      objectPath: z.string().describe('Unreal asset object path (e.g. "/Game/MyPack/MyMesh.MyMesh").'),
+      includeDependencies: z.boolean().optional().describe("Include package dependencies (default false)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Asset Info (UnrealMCP)",
+    "Get metadata for a single Unreal asset (class/path + optional dependencies) via the UnrealMCP engine plugin."
+  );
+  forwardTool(
+    "unreal_mcp_list_asset_packs",
+    {
+      limit: z.number().int().positive().optional().describe("Max number of packs (default 200)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal List Asset Packs (UnrealMCP)",
+    'List top-level /Game content folders (best-effort "asset packs") via the UnrealMCP engine plugin.'
+  );
+  forwardTool(
+    "unreal_mcp_place_asset",
+    {
+      objectPath: z.string().describe('Unreal asset object path (e.g. "/Game/MyPack/MyMesh.MyMesh").'),
+      name: z.string().optional().describe("Optional actor name (default: derived from asset name)."),
+      location: z.array(z.number()).length(3).optional().describe("Spawn location [X,Y,Z] in cm."),
+      rotation: z.array(z.number()).length(3).optional().describe("Spawn rotation [Pitch,Yaw,Roll] in degrees."),
+      scale: z.array(z.number()).length(3).optional().describe("Spawn scale [X,Y,Z]."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Place Asset (UnrealMCP)",
+    "Place an asset into the current Unreal level by object path (StaticMesh/Blueprint). Fails if PIE is running."
+  );
+  forwardTool(
+    "unreal_mcp_get_editor_context",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Editor Context (UnrealMCP)",
+    "Return a compact snapshot of editor context: map, selection, and active viewport camera."
+  );
+  forwardTool(
+    "unreal_mcp_get_player_context",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Player Context (PIE)",
+    "Return a compact snapshot of runtime player context (PIE): pawn transform and camera transform."
+  );
+  forwardTool(
+    "unreal_mcp_raycast_from_camera",
+    {
+      source: z.enum(["editor", "pie"]).optional().describe("Camera source (default editor)."),
+      maxDistance: z.number().positive().optional().describe("Max distance in cm (default 10000)."),
+      ignoreActors: z.array(z.string()).optional().describe("Actor names/labels to ignore (best-effort)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Raycast From Camera (Editor/PIE)",
+    "Raycast from the editor viewport camera or the PIE player camera and return hit location + normal."
+  );
+  forwardTool(
+    "unreal_mcp_raycast_down",
+    {
+      source: z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
+      startLocation: z.array(z.number()).length(3).describe("Start location [X,Y,Z] in cm."),
+      maxDistance: z.number().positive().optional().describe("Max distance in cm (default 100000)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Raycast Down (Drop To Ground)",
+    "Raycast straight down from a given startLocation."
+  );
+  forwardTool(
+    "unreal_mcp_get_actor_transform",
+    {
+      name: z.string().describe("Actor name or label."),
+      source: z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Actor Transform (UnrealMCP)",
+    "Get a single actor transform (location/rotation/scale) by actor name or label."
+  );
+  forwardTool(
+    "unreal_mcp_get_actor_bounds",
+    {
+      name: z.string().describe("Actor name or label."),
+      source: z.enum(["editor", "pie"]).optional().describe("World source (default editor)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal Actor Bounds (UnrealMCP)",
+    "Get a single actor bounds (origin/extent + min/max) by actor name or label."
+  );
+  forwardTool(
+    "unreal_mcp_map_check",
+    {
+      includeWarnings: z.boolean().optional().describe("Include warnings in the issues list (default true)."),
+      limit: z.number().int().positive().optional().describe("Max number of issues to return (default 200, max 1000)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 15000).")
+    },
+    "Unreal Map Check (UnrealMCP)",
+    "Run Unreal Map Check and return structured issues. Fails if PIE is running."
+  );
+  forwardTool(
+    "unreal_mcp_compile_blueprints_all",
+    {
+      paths: z.array(z.string()).optional().describe('Root content paths to search (default ["/Game"]).'),
+      includeWarnings: z.boolean().optional().describe("Include warnings in the per-blueprint messages list (default true)."),
+      limit: z.number().int().positive().optional().describe("Max number of blueprints to compile (default 500, max 10000)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
+    },
+    "Unreal Compile All Blueprints (UnrealMCP)",
+    "Compile all Blueprints and return a structured list of compile messages. Fails if PIE is running."
+  );
+  forwardTool(
+    "unreal_mcp_save_all",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 60000).")
+    },
+    "Unreal Save All (UnrealMCP)",
+    "Save all dirty packages (maps + content) in the running Unreal Editor without prompting. Fails if PIE is running."
+  );
+  forwardTool(
+    "unreal_mcp_create_landscape",
+    {
+      name: z.string().describe("New landscape actor name (must be unique)."),
+      componentCountX: z.number().int().positive().optional().describe("Number of components in X (default 8)."),
+      componentCountY: z.number().int().positive().optional().describe("Number of components in Y (default 8)."),
+      sectionsPerComponent: z.number().int().optional().describe("Sections per component (1 or 2, default 1)."),
+      quadsPerSection: z.number().int().positive().optional().describe("Quads per section (default 63)."),
+      location: z.array(z.number()).length(3).optional().describe("Center location [X,Y,Z] in cm (default [0,0,0])."),
+      rotation: z.array(z.number()).length(3).optional().describe("Rotation [Pitch,Yaw,Roll] in degrees (default [0,0,0])."),
+      scale: z.array(z.number()).length(3).optional().describe("Scale [X,Y,Z] (default [100,100,100])."),
+      materialPath: z.string().optional().describe('Optional landscape material object path (e.g. "/Game/\u2026/M_Landscape.M_Landscape").'),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 30000).")
+    },
+    "Unreal Create Landscape (UnrealMCP)",
+    "Create a new Landscape in the current editor level via the UnrealMCP engine plugin. Fails if PIE is running."
+  );
+  forwardTool(
+    "unreal_mcp_list_capabilities",
+    {
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
+    },
+    "Unreal MCP: Capabilities",
+    "Query the running UnrealMCP plugin for build info, supported commands, and capability flags."
+  );
+  forwardTool(
+    "unreal_mcp_get_command_schema",
+    {
+      command: z.string().optional().describe('Command type to fetch schema for (e.g. "create_blueprint").'),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 2000).")
+    },
+    "Unreal MCP: Command Schema",
+    "Fetch per-command schema (required params, aliases, examples) from the running UnrealMCP plugin."
+  );
+  forwardTool(
+    "unreal_mcp_search_blueprint_functions",
+    {
+      query: z.string().describe('Substring to search for (e.g. "MakeVector").'),
+      target: z.string().optional().describe('Optional target class constraint (e.g. "KismetMathLibrary").'),
+      limit: z.number().int().positive().optional().describe("Max results (default 25)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal MCP: Search Blueprint Functions",
+    "Search for Blueprint-callable functions and return candidates (owner class path + signature hints)."
+  );
+  forwardTool(
+    "unreal_mcp_resolve_blueprint_function",
+    {
+      functionName: z.string().describe('Function name to resolve (e.g. "MakeVector").'),
+      target: z.string().optional().describe("Optional target class constraint."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 5000).")
+    },
+    "Unreal MCP: Resolve Blueprint Function",
+    "Resolve a Blueprint-callable function to an explicit owner class path usable with add_blueprint_function_node."
+  );
+  forwardTool(
+    "unreal_place_asset_relative",
+    {
+      objectPath: z.string().describe('Unreal asset object path (e.g. "/Game/MyPack/MyMesh.MyMesh").'),
+      name: z.string().optional().describe("Optional actor name (default: derived from asset name)."),
+      anchor: z.enum(["selection", "editor_camera", "player", "player_camera", "hit_result", "actor"]).describe("Reference anchor for placement."),
+      actorName: z.string().optional().describe('When anchor="actor", the actor name/label to anchor to.'),
+      offset: z.array(z.number()).length(3).optional().describe("Offset in anchor local axes [forwardCm, rightCm, upCm] (default [200,0,0])."),
+      alignToSurface: z.boolean().optional().describe("Align actor up to hit normal when available (default false)."),
+      dropToGround: z.boolean().optional().describe("Raycast down and snap to hit location (default false)."),
+      raySource: z.enum(["editor", "pie"]).optional().describe('When anchor="hit_result", which camera to raycast from (default editor).'),
+      maxDistance: z.number().positive().optional().describe("Raycast max distance in cm (default 10000)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 8000).")
+    },
+    "Unreal Place Asset Relative (Context-Aware)",
+    "Place an asset relative to selection/camera/player/hit result, with optional surface alignment and drop-to-ground."
+  );
+  forwardTool(
+    "unreal_spawn_actor_relative",
+    {
+      type: z.string().describe('Actor class/type (e.g. "PointLight", "CameraActor").'),
+      name: z.string().describe("Actor name."),
+      anchor: z.enum(["selection", "editor_camera", "player", "player_camera", "hit_result", "actor"]).describe("Reference anchor for placement."),
+      actorName: z.string().optional().describe('When anchor="actor", the actor name/label to anchor to.'),
+      offset: z.array(z.number()).length(3).optional().describe("Offset in anchor local axes [forwardCm, rightCm, upCm] (default [200,0,0])."),
+      alignToSurface: z.boolean().optional().describe("Align actor up to hit normal when available (default false)."),
+      dropToGround: z.boolean().optional().describe("Raycast down and snap to hit location (default false)."),
+      raySource: z.enum(["editor", "pie"]).optional().describe('When anchor="hit_result", which camera to raycast from (default editor).'),
+      maxDistance: z.number().positive().optional().describe("Raycast max distance in cm (default 10000)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms (default 8000).")
+    },
+    "Unreal Spawn Actor Relative (Context-Aware)",
+    "Spawn an actor relative to selection/camera/player/hit result, with optional surface alignment and drop-to-ground."
+  );
   forwardTool(
     "unreal_mcp_get_actors_in_level",
     {
@@ -351,6 +600,96 @@ async function main() {
     "Unreal Stop Play In Editor",
     "Stop a running Play-In-Editor session via the UnrealMCP engine plugin."
   );
+  forwardTool(
+    "unreal_editor_launch",
+    {
+      uprojectPath: z.string().describe("Absolute path to the .uproject file."),
+      engineRoot: z.string().optional().describe(
+        "Optional Unreal Engine install root. Defaults to ENGINE_ROOT / UE_ENGINE_ROOT, or inferred from EngineAssociation when possible."
+      ),
+      extraArgs: z.array(z.string()).optional().describe("Additional UnrealEditor command-line args (advanced).")
+    },
+    "Unreal Editor: Launch Project",
+    "Launch Unreal Editor for a given .uproject (no auto-restart). If the editor later crashes or becomes unreachable, Flockbay will abort the current agent run and report it in the chat."
+  );
+  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.x). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."
+      ),
+      mode: z.enum(["auto", "choose", "sandbox"]).optional().describe("Screenshot mode: auto (project default map), choose (explicit map), sandbox (Flockbay seed sandbox)."),
+      map: z.string().optional().describe('Map for choose/auto override (e.g. "/Game/Maps/MyMap" or "/abs/.../Content/Maps/MyMap.umap").'),
+      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=...'),
+      timeoutMs: z.number().int().positive().optional().describe("Timeout in ms (default 600000).")
+    },
+    "Unreal Headless Screenshot",
+    "Run the project-local headless screenshots script (Tools/run-headless-screenshots.mjs) and upload the resulting views to the current session."
+  );
+  forwardTool(
+    "unreal_fast_preview",
+    {
+      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.x). Defaults to UE_ENGINE_ROOT / ENGINE_ROOT env vars."
+      ),
+      map: z.string().optional().describe(
+        'Optional explicit map to run (e.g. "/Game/Maps/MyMap" or "/abs/.../Content/Maps/MyMap.umap"). Default: use the project default map (Config/DefaultEngine.ini).'
+      ),
+      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. Required if running bake without a module config."),
+      configRelPath: z.string().optional().describe(
+        "Optional module config path relative to project root (e.g. Config/GameConfig.json). Required for bake/perf-budget module features."
+      ),
+      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."),
+      applyAssetKits: z.boolean().optional().describe("Apply .flockbay asset kit adapters (TileMeshLibrary/ScatterCategoryRegistry/LayoutPropRegistry) to Config/DefaultGame.ini before preview. Default false (non-mutating)."),
+      kitIds: z.array(z.string()).optional().describe("When applyAssetKits=true, limit to these kitIds. Default: all kits in .flockbay/assets/kits.json."),
+      contentLint: z.boolean().optional().describe("Fail-hard if config/DefaultGame.ini reference missing /Game assets on disk. Default false."),
+      previewDurationBudgetMs: z.number().int().positive().optional().describe("Fail-hard if the final preview run exceeds this duration (ms). Optional."),
+      perfBudgetLint: z.boolean().optional().describe("Run Tools/run-perf-budget-lint.mjs (scatter budgets + perf budgets file sanity). Module-only (requires configRelPath). Default false."),
+      perfCapture: z.boolean().optional().describe("Run headless perf capture (memreport + frame stats), then validate against Config/PerfBudgets.json. Default false."),
+      perfBudgetsRelPath: z.string().optional().describe("Perf budgets path relative to project root (default Config/PerfBudgets.json)."),
+      perfBaselineKey: z.string().optional().describe('Perf baseline key stored under .flockbay/baselines/perf/<perfBaselineKey>. Default "default".'),
+      perfBaselineAction: z.enum(["none", "compare", "set"]).optional().describe(
+        "none=skip perf baseline. compare=diff vs baseline report. set=overwrite baseline report. Default compare when perfCapture=true; otherwise none."
+      ),
+      perfFailOnBaselineDiff: z.boolean().optional().describe("When perfBaselineAction=compare, fail if perf metrics differ from baseline. Default false."),
+      perfCaptureTimeoutMs: z.number().int().positive().optional().describe("Timeout in ms for perf capture (default timeoutMs).")
+    },
+    "Unreal Fast Preview (Evidence First)",
+    "Run a fast headless Unreal preview and attach stable screenshot evidence + a run manifest to the session. Includes optional bake planning, caching, and baseline comparisons."
+  );
+  forwardTool(
+    "unreal_smoke_test",
+    {
+      uprojectPath: z.string().describe("Absolute path to the .uproject file."),
+      stabilizeMs: z.number().int().positive().optional().describe("Time to wait before taking screenshot (default 1500)."),
+      timeoutMs: z.number().int().positive().optional().describe("Socket timeout in ms for each step (default 30000)."),
+      stopIfPlaying: z.boolean().optional().describe("If PIE is already running, stop it first (default true).")
+    },
+    "Unreal Smoke Test (PIE + Screenshot Proof)",
+    "Starts PIE (windowed), captures a screenshot, stops PIE, and uploads the screenshot to the current session."
+  );
   forwardTool(
     "unreal_mechanic_run",
     {