/**
 * Volume Handlers
 *
 * Complete volume and trigger system management including:
 * - Trigger Volumes: create_trigger_volume, add_trigger_volume, trigger_box, trigger_sphere, trigger_capsule
 * - Gameplay Volumes: create_blocking, add_blocking, kill_z, pain_causing, physics
 * - Audio Volumes: audio, reverb
 * - Rendering Volumes: create_cull_distance, add_cull_distance, precomputed_visibility, lightmass_importance
 * - Navigation Volumes: nav_mesh_bounds, nav_modifier, camera_blocking
 * - Volume Configuration: extent, properties
 * - Post Process: create_post_process_volume, add_post_process_volume (UE 5.1-5.6)
 *
 * Note: add_*_volume actions create volumes attached to existing actors (require actorPath)
 * create_*_volume actions create standalone volumes
 *
 * @module volume-handlers
 */

import { ITools } from '../../../types/tools/tool-interfaces.js';
import { cleanObject } from '../../../utils/serialization/safe-json.js';
import type { HandlerArgs } from '../../../types/handlers/handler-types.js';
import { createSubActionDispatcher } from '../foundation/dispatch/common-handlers.js';

/**
 * Normalize parameter names from snake_case to camelCase for C++ compatibility.
 * Tests may send volume_name but C++ expects volumeName.
 */
function normalizeParamNames(args: Record<string, unknown>): Record<string, unknown> {
  const result = { ...args };
  const paramMappings: Record<string, string> = {
    'volume_name': 'volumeName',
    'box_extent': 'boxExtent',
    'sphere_radius': 'sphereRadius',
    'capsule_radius': 'capsuleRadius',
    'capsule_half_height': 'capsuleHalfHeight'
  };

  for (const [snakeCase, camelCase] of Object.entries(paramMappings)) {
    if (snakeCase in result && !(camelCase in result)) {
      result[camelCase] = result[snakeCase];
      delete result[snakeCase];
    }
  }
  return result;
}

/**
 * Handles all volume actions for the manage_volumes tool.
 */
export async function handleVolumeTools(
  action: string,
  args: HandlerArgs,
  tools: ITools
): Promise<Record<string, unknown>> {
  const normalizedArgs = normalizeParamNames(args as Record<string, unknown>);
  const { sendRequest } = createSubActionDispatcher(tools, normalizedArgs as HandlerArgs, {
    toolName: 'manage_volumes',
    domainName: 'volume'
  });

  switch (action) {
    // ========================================================================
    // Trigger Volumes (4 actions)
    // ========================================================================
    case 'create_trigger_volume':
      return sendRequest('create_trigger_volume');

    case 'add_trigger_volume':
      // add_trigger_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_trigger_volume');

    case 'create_trigger_box':
      return sendRequest('create_trigger_box');

    case 'create_trigger_sphere':
      return sendRequest('create_trigger_sphere');

    case 'create_trigger_capsule':
      return sendRequest('create_trigger_capsule');

    // ========================================================================
    // Gameplay Volumes (11 actions)
    // ========================================================================
    case 'create_blocking_volume':
      return sendRequest('create_blocking_volume');

    case 'add_blocking_volume':
      // add_blocking_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_blocking_volume');

    case 'create_kill_z_volume':
      return sendRequest('create_kill_z_volume');

    case 'add_kill_z_volume':
      // add_kill_z_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_kill_z_volume');

    case 'create_pain_causing_volume':
      return sendRequest('create_pain_causing_volume');

    case 'create_physics_volume':
      return sendRequest('create_physics_volume');

    case 'add_physics_volume':
      // add_physics_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_physics_volume');

    case 'create_audio_volume':
      return sendRequest('create_audio_volume');

    case 'create_reverb_volume':
      return sendRequest('create_reverb_volume');

    case 'create_cull_distance_volume':
      return sendRequest('create_cull_distance_volume');

    case 'add_cull_distance_volume':
      // add_cull_distance_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_cull_distance_volume');

    case 'create_precomputed_visibility_volume':
      return sendRequest('create_precomputed_visibility_volume');

    case 'create_lightmass_importance_volume':
      return sendRequest('create_lightmass_importance_volume');

    case 'create_nav_mesh_bounds_volume':
      return sendRequest('create_nav_mesh_bounds_volume');

    case 'create_nav_modifier_volume':
      return sendRequest('create_nav_modifier_volume');

    case 'create_camera_blocking_volume':
      return sendRequest('create_camera_blocking_volume');

    // ========================================================================
    // Post Process Volume (UE 5.1-5.6 only, removed in 5.7+)
    // ========================================================================
    case 'create_post_process_volume':
      return sendRequest('create_post_process_volume');

    case 'add_post_process_volume':
      // add_post_process_volume creates volume attached to existing actor (requires actorPath)
      return sendRequest('add_post_process_volume');

    // ========================================================================
    // Volume Configuration (3 actions)
    // ========================================================================
    case 'set_volume_extent':
    case 'set_volume_bounds': // Alias for compatibility
      return sendRequest('set_volume_extent');

    case 'set_volume_properties':
      return sendRequest('set_volume_properties');

    // ========================================================================
    // Volume Removal (1 action)
    // ========================================================================
    case 'remove_volume':
      return sendRequest('remove_volume');

    // ========================================================================
    // Utility (1 action)
    // ========================================================================
    case 'get_volumes_info':
      return sendRequest('get_volumes_info');

    default:
      return cleanObject({
        success: false,
        error: 'UNKNOWN_ACTION',
        message: `Unknown volume action: ${action}`
      });
  }
}