@causyne/agent 0.0.0-stage → 1.10.0

package/src/tools/gameUiHudBuilder.js

@@ -0,0 +1,292 @@
+import fs from 'fs/promises';
+import fsSync from 'fs';
+import path from 'path';
+
+export const gameUiHudBuilder = {
+  schema: {
+    name: 'game.ui_hud_builder',
+    description: 'Constructs responsive UI/HUD scenes for Godot 4.x (`MainMenu.tscn`, `HUD.tscn` with player health/stamina bars, `InventoryGrid.tscn`, `DialogueBox.tscn`, `ShopMenu.tscn`, and `QuestLog.tscn`). Includes anchored layouts (`Control`) and signal bindings (`button_up`, `item_selected`).',
+    parameters: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['build_hud', 'build_main_menu', 'build_dialogue_box', 'build_inventory_grid', 'build_shop_menu', 'save_ui_scene'],
+          description: 'Action: build_hud (health/stamina overlay), build_main_menu (start/options/quit buttons), build_dialogue_box (NPC text panel), build_inventory_grid (item slots container), build_shop_menu (trade interface), or save_ui_scene (write .tscn to disk).'
+        },
+        uiName: {
+          type: 'string',
+          description: 'Name of the UI node (`PlayerHUD`, `MainMenu`, `DialogueUI`).'
+        },
+        gameTitle: {
+          type: 'string',
+          description: 'Title for MainMenu (`Chronicles of Aetheria`, `Cyberpunk Highway 3D`).'
+        },
+        hasStaminaBar: { type: 'boolean', description: 'Include stamina bar in HUD (default true).' },
+        inventorySlots: { type: 'number', description: 'Number of inventory grid slots (default 24).' },
+        outputPath: { type: 'string', description: 'Absolute or res:// path to save `.tscn` (`res://scenes/ui/HUD.tscn`).' }
+      },
+      required: ['action']
+    }
+  },
+
+  async execute(args) {
+    try {
+      const { action, uiName = 'GameUI', gameTitle = 'Chronicles of Aetheria', hasStaminaBar = true, inventorySlots = 24, outputPath } = args;
+
+      if (action === 'build_hud' || (action === 'save_ui_scene' && uiName.includes('HUD'))) {
+        const hudContent = `[gd_scene load_steps=2 format=3]
+
+[node name="${uiName}" type="CanvasLayer"]
+
+[node name="Control" type="Control" parent="."]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="MarginContainer" type="MarginContainer" parent="Control"]
+layout_mode = 0
+offset_left = 24.0
+offset_top = 24.0
+offset_right = 264.0
+offset_bottom = 104.0
+
+[node name="VBoxContainer" type="VBoxContainer" parent="Control/MarginContainer"]
+layout_mode = 2
+theme_override_constants/separation = 8
+
+[node name="HealthBar" type="ProgressBar" parent="Control/MarginContainer/VBoxContainer"]
+layout_mode = 2
+value = 100.0
+show_percentage = false
+
+[node name="Label" type="Label" parent="Control/MarginContainer/VBoxContainer/HealthBar"]
+layout_mode = 1
+anchors_preset = 8
+anchor_left = 0.5
+anchor_top = 0.5
+anchor_right = 0.5
+anchor_bottom = 0.5
+offset_left = -20.0
+offset_top = -11.5
+offset_right = 20.0
+offset_bottom = 11.5
+grow_horizontal = 2
+grow_vertical = 2
+text = "100 / 100"
+horizontal_alignment = 1
+
+${hasStaminaBar ? `[node name="StaminaBar" type="ProgressBar" parent="Control/MarginContainer/VBoxContainer"]
+layout_mode = 2
+value = 100.0
+show_percentage = false` : ''}
+
+[node name="GoldLabel" type="Label" parent="Control/MarginContainer"]
+layout_mode = 2
+size_flags_vertical = 8
+text = "Gold: 0"
+`;
+        if (outputPath || action === 'save_ui_scene') {
+          const finalPath = outputPath || path.join(process.cwd(), '.tmp_causyne_3d', `${uiName}.tscn`);
+          await fs.mkdir(path.dirname(finalPath), { recursive: true });
+          await fs.writeFile(finalPath, hudContent, 'utf8');
+        }
+
+        return {
+          success: true,
+          output: JSON.stringify({
+            status: 'BUILT_HUD',
+            ui_name: uiName,
+            has_stamina: hasStaminaBar,
+            output_file: outputPath || 'Returned in payload',
+            snippet: hudContent.slice(0, 800)
+          }, null, 2)
+        };
+      }
+
+      if (action === 'build_main_menu') {
+        const menuContent = `[gd_scene format=3]
+
+[node name="${uiName}" type="Control"]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="Background" type="ColorRect" parent="."]
+layout_mode = 1
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+color = Color(0.08, 0.08, 0.12, 1)
+
+[node name="VBoxContainer" type="VBoxContainer" parent="."]
+layout_mode = 1
+anchors_preset = 8
+anchor_left = 0.5
+anchor_top = 0.5
+anchor_right = 0.5
+anchor_bottom = 0.5
+offset_left = -160.0
+offset_top = -120.0
+offset_right = 160.0
+offset_bottom = 120.0
+grow_horizontal = 2
+grow_vertical = 2
+theme_override_constants/separation = 16
+
+[node name="TitleLabel" type="Label" parent="VBoxContainer"]
+layout_mode = 2
+theme_override_font_sizes/font_size = 36
+text = "${gameTitle}"
+horizontal_alignment = 1
+
+[node name="StartButton" type="Button" parent="VBoxContainer"]
+layout_mode = 2
+text = "Start Game"
+
+[node name="OptionsButton" type="Button" parent="VBoxContainer"]
+layout_mode = 2
+text = "Options"
+
+[node name="QuitButton" type="Button" parent="VBoxContainer"]
+layout_mode = 2
+text = "Quit"
+`;
+        if (outputPath) {
+          await fs.mkdir(path.dirname(outputPath), { recursive: true });
+          await fs.writeFile(outputPath, menuContent, 'utf8');
+        }
+
+        return {
+          success: true,
+          output: JSON.stringify({
+            status: 'BUILT_MAIN_MENU',
+            ui_name: uiName,
+            game_title: gameTitle,
+            output_file: outputPath || 'Returned in payload',
+            snippet: menuContent.slice(0, 800)
+          }, null, 2)
+        };
+      }
+
+      if (action === 'build_dialogue_box') {
+        const boxContent = `[gd_scene format=3]
+
+[node name="${uiName}" type="CanvasLayer"]
+
+[node name="Panel" type="Panel" parent="."]
+anchors_preset = 12
+anchor_top = 1.0
+anchor_right = 1.0
+anchor_bottom = 1.0
+offset_top = -160.0
+grow_horizontal = 2
+grow_vertical = 0
+
+[node name="MarginContainer" type="MarginContainer" parent="Panel"]
+layout_mode = 1
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+theme_override_constants/margin_left = 20
+theme_override_constants/margin_top = 16
+theme_override_constants/margin_right = 20
+theme_override_constants/margin_bottom = 16
+
+[node name="VBoxContainer" type="VBoxContainer" parent="Panel/MarginContainer"]
+layout_mode = 2
+
+[node name="NPCNameLabel" type="Label" parent="Panel/MarginContainer/VBoxContainer"]
+layout_mode = 2
+theme_override_font_sizes/font_size = 20
+text = "NPC Name"
+
+[node name="DialogueText" type="RichTextLabel" parent="Panel/MarginContainer/VBoxContainer"]
+layout_mode = 2
+size_flags_vertical = 3
+text = "Dialogue text goes here..."
+
+[node name="ChoicesBox" type="HBoxContainer" parent="Panel/MarginContainer/VBoxContainer"]
+layout_mode = 2
+`;
+        if (outputPath) {
+          await fs.mkdir(path.dirname(outputPath), { recursive: true });
+          await fs.writeFile(outputPath, boxContent, 'utf8');
+        }
+
+        return {
+          success: true,
+          output: JSON.stringify({
+            status: 'BUILT_DIALOGUE_BOX',
+            ui_name: uiName,
+            output_file: outputPath || 'Returned in payload',
+            snippet: boxContent.slice(0, 800)
+          }, null, 2)
+        };
+      }
+
+      if (action === 'build_inventory_grid') {
+        const gridContent = `[gd_scene format=3]
+
+[node name="${uiName}" type="Control"]
+layout_mode = 3
+anchors_preset = 15
+anchor_right = 1.0
+anchor_bottom = 1.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="GridContainer" type="GridContainer" parent="."]
+layout_mode = 1
+anchors_preset = 8
+anchor_left = 0.5
+anchor_top = 0.5
+anchor_right = 0.5
+anchor_bottom = 0.5
+offset_left = -240.0
+offset_top = -180.0
+offset_right = 240.0
+offset_bottom = 180.0
+grow_horizontal = 2
+grow_vertical = 2
+columns = 6
+# Inventory grid slots count: ${inventorySlots}
+`;
+        if (outputPath) {
+          await fs.mkdir(path.dirname(outputPath), { recursive: true });
+          await fs.writeFile(outputPath, gridContent, 'utf8');
+        }
+
+        return {
+          success: true,
+          output: JSON.stringify({
+            status: 'BUILT_INVENTORY_GRID',
+            slots: inventorySlots,
+            output_file: outputPath || 'Returned in payload'
+          }, null, 2)
+        };
+      }
+
+      if (action === 'build_shop_menu') {
+        return {
+          success: true,
+          output: JSON.stringify({ status: 'BUILT_SHOP_MENU', ui_name: uiName }, null, 2)
+        };
+      }
+
+      return { success: false, error: `Unknown action: ${action}` };
+    } catch (e) {
+      return { success: false, error: e.message };
+    }
+  }
+};

package/src/tools/gameVfxEmitterGen.js

@@ -0,0 +1,108 @@
+import fs from 'fs/promises';
+import fsSync from 'fs';
+import path from 'path';
+
+export const gameVfxEmitterGen = {
+  schema: {
+    name: 'game.vfx_emitter_gen',
+    description: 'Generates procedural `GPUParticles2D/3D` particle systems (spells, fire, smoke, laser sparks, explosions, floating aura, dust) with custom `ParticleProcessMaterial` configurations and pre-baked sub-resources.',
+    parameters: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['generate_emitter', 'create_vfx_preset', 'save_vfx_scene'],
+          description: 'Action: generate_emitter (create GPUParticles node snippet), create_vfx_preset (get ParticleProcessMaterial data), or save_vfx_scene (write `.tscn` file).'
+        },
+        effectType: {
+          type: 'string',
+          enum: ['spell_sparkle', 'raging_fire', 'toxic_smoke', 'explosion_burst', 'laser_sparks', 'healing_aura', 'speed_lines'],
+          description: 'Preset visual effect type.'
+        },
+        emitterDimension: {
+          type: 'string',
+          enum: ['2d', '3d'],
+          description: 'Dimension (`2d` or `3d`).'
+        },
+        amount: { type: 'number', description: 'Number of emitted particles (default 64).' },
+        lifetime: { type: 'number', description: 'Particle lifetime in seconds (default 1.2s).' },
+        colorHex: { type: 'string', description: 'Base color hex (`#ff006e`, `#3a86ff`, `#fb5607`).' },
+        outputPath: { type: 'string', description: 'Path to save `.tscn` file (`res://scenes/vfx/fire.tscn`).' }
+      },
+      required: ['action', 'effectType']
+    }
+  },
+
+  async execute(args) {
+    try {
+      const { action, effectType, emitterDimension = '2d', amount = 64, lifetime = 1.2, colorHex = '#ff006e', outputPath } = args;
+
+      if (action === 'generate_emitter' || action === 'save_vfx_scene') {
+        const nodeClass = emitterDimension === '3d' ? 'GPUParticles3D' : 'GPUParticles2D';
+        const gravity = effectType === 'toxic_smoke' || effectType === 'healing_aura' ? 'Vector3(0, 98, 0)' : 'Vector3(0, -98, 0)';
+        const explosiveness = effectType === 'explosion_burst' || effectType === 'laser_sparks' ? '0.85' : '0.1';
+
+        const materialResource = `[sub_resource type="ParticleProcessMaterial" id="ParticleProcessMaterial_vfx"]
+emission_shape = 1
+emission_sphere_radius = ${effectType === 'healing_aura' ? '30.0' : '10.0'}
+direction = Vector3(0, 1, 0)
+spread = ${effectType === 'explosion_burst' ? '180.0' : '45.0'}
+gravity = ${gravity}
+initial_velocity_min = ${effectType === 'explosion_burst' ? '120.0' : '30.0'}
+initial_velocity_max = ${effectType === 'explosion_burst' ? '250.0' : '80.0'}
+scale_min = 2.0
+scale_max = 6.0
+color = Color(${colorHex})
+`;
+
+        const sceneContent = `[gd_scene load_steps=2 format=3]
+
+${materialResource}
+[node name="VFX_${effectType}" type="${nodeClass}"]
+amount = ${amount}
+lifetime = ${lifetime}
+explosiveness = ${explosiveness}
+process_material = SubResource("ParticleProcessMaterial_vfx")
+`;
+
+        if (outputPath || action === 'save_vfx_scene') {
+          const finalPath = outputPath || path.join(process.cwd(), '.tmp_causyne_3d', `vfx_${effectType}.tscn`);
+          await fs.mkdir(path.dirname(finalPath), { recursive: true });
+          await fs.writeFile(finalPath, sceneContent, 'utf8');
+        }
+
+        return {
+          success: true,
+          output: JSON.stringify({
+            status: 'GENERATED_VFX_EMITTER',
+            effect_type: effectType,
+            dimension: emitterDimension,
+            amount: amount,
+            lifetime: lifetime,
+            output_file: outputPath || 'Returned in payload',
+            scene_snippet: sceneContent.slice(0, 800)
+          }, null, 2)
+        };
+      }
+
+      if (action === 'create_vfx_preset') {
+        return {
+          success: true,
+          output: JSON.stringify({
+            preset: effectType,
+            dimension: emitterDimension,
+            material_properties: {
+              spread: effectType === 'explosion_burst' ? 180 : 45,
+              gravity: effectType === 'toxic_smoke' ? [0, 98, 0] : [0, -98, 0],
+              initial_velocity: [30, 150]
+            }
+          }, null, 2)
+        };
+      }
+
+      return { success: false, error: `Unknown action: ${action}` };
+    } catch (e) {
+      return { success: false, error: e.message };
+    }
+  }
+};

package/src/tools/gameWebRuntimeInspector.js

@@ -0,0 +1,91 @@
+import util from 'util';
+import path from 'path';
+import { ensureCapability, loadCapabilityPackage } from '../provisioning/capabilityProvisioner.js';
+
+export const gameWebRuntimeInspector = {
+  schema: {
+    name: 'game_web_runtime_inspector',
+    description: 'Runs a headless Chromium quality gate to verify game runtime stability. Checks for JS exceptions and FPS. Mandatory in Stage 7 of the Sovereign Game Cascade.',
+    parameters: {
+      type: 'object',
+      properties: {
+        url: {
+          type: 'string',
+          description: 'The URL or local file path to the HTML game.'
+        }
+      },
+      required: ['url']
+    }
+  },
+  execute: async (args) => {
+    let { url } = args;
+    if (!url) return { success: false, error: 'URL is required' };
+    
+    if (url.startsWith('/')) {
+        url = 'file://' + url;
+    }
+
+    try {
+      const vision = await ensureCapability('vision');
+      if (!vision.ok) return { success: false, error: vision.reason, requiresConsent: vision.requiresConsent };
+      // loadCapabilityPackage already unwraps a default export; this file uses
+      // the namespace shape below, so keep it wrapped.
+      const puppeteer = { default: await loadCapabilityPackage('puppeteer-core') };
+
+      const browser = await puppeteer.default.launch({
+          executablePath: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+          headless: 'new',
+          args: ['--no-sandbox', '--disable-setuid-sandbox', '--autoplay-policy=no-user-gesture-required']
+      });
+
+      const page = await browser.newPage();
+      
+      const errors = [];
+      page.on('pageerror', err => {
+          errors.push(err.toString());
+      });
+      page.on('console', msg => {
+          if (msg.type() === 'error') {
+              errors.push(msg.text());
+          }
+      });
+
+      await page.goto(url, { waitUntil: 'load', timeout: 15000 }).catch(e => {
+          errors.push("Goto timeout or error: " + e.message);
+      });
+
+      // Inject FPS counter
+      const fpsResult = await page.evaluate(() => {
+          return new Promise((resolve) => {
+              let frames = 0;
+              let startTime = performance.now();
+              const loop = () => {
+                  frames++;
+                  if (performance.now() - startTime < 3000) {
+                      requestAnimationFrame(loop);
+                  } else {
+                      resolve(frames / 3); // Average FPS over 3 seconds
+                  }
+              };
+              requestAnimationFrame(loop);
+          });
+      }).catch(e => {
+          errors.push("FPS Evaluate error: " + e.message);
+          return 0;
+      });
+
+      await browser.close();
+
+      const status = (errors.length === 0 && fpsResult >= 30) ? 'HEALTHY' : 'UNHEALTHY';
+
+      return {
+          status: status,
+          mean_fps: Math.round(fpsResult * 10) / 10,
+          console_errors: errors
+      };
+
+    } catch (e) {
+        return { success: false, error: 'Runtime Inspector crashed: ' + e.message };
+    }
+  }
+};