{
  "schemaVersion": "1.0",
  "name": "Calorie Deficit Calculator AI Agent Specification",
  "description": "Comprehensive structured system rules, parameters, validation ranges, and formulas for AI agents executing wellness calculations.",
  "developerPortal": "https://caloriedeficitcalculator.co/api-docs",
  "capabilities": {
    "bmr_calculation": {
      "name": "Mifflin-St Jeor BMR calculator",
      "formula_male": "10 * weight_kg + 6.25 * height_cm - 5 * age_years + 5",
      "formula_female": "10 * weight_kg + 6.25 * height_cm - 5 * age_years - 161",
      "inputs": {
        "gender": { "type": "string", "enum": ["male", "female"], "required": true },
        "weight_kg": { "type": "number", "minimum": 30, "maximum": 300, "required": true },
        "height_cm": { "type": "number", "minimum": 100, "maximum": 250, "required": true },
        "age_years": { "type": "number", "minimum": 15, "maximum": 100, "required": true }
      }
    },
    "tdee_calculation": {
      "name": "Total Daily Energy Expenditure calculation",
      "formula": "BMR * activity_multiplier",
      "inputs": {
        "bmr": { "type": "number", "required": true },
        "activity_level": {
          "type": "string",
          "enum": ["sedentary", "light", "moderate", "active", "extreme"],
          "multipliers": {
            "sedentary": 1.2,
            "light": 1.375,
            "moderate": 1.55,
            "active": 1.725,
            "extreme": 1.9
          },
          "required": true
        }
      }
    },
    "deficit_planning": {
      "name": "Calorie Deficit Plan Generator",
      "safety_floor": { "male": 1500, "female": 1200 },
      "inputs": {
        "tdee": { "type": "number", "required": true },
        "current_weight_kg": { "type": "number", "required": true },
        "target_weight_kg": { "type": "number", "required": true },
        "weekly_loss_goal_kg": { "type": "number", "enum": [0.25, 0.5, 0.75, 1.0], "required": true },
        "gender": { "type": "string", "enum": ["male", "female"], "required": true }
      }
    },
    "macro_breakdown": {
      "name": "High-Protein Deficit Macronutrient Splitting",
      "formula": {
        "protein": "2.2 * weight_kg (4 kcal/g)",
        "fats": "0.25 * target_calories (9 kcal/g)",
        "carbs": "(target_calories - protein_calories - fat_calories) / 4 (4 kcal/g)",
        "fiber": "14 * (target_calories / 1000)"
      },
      "inputs": {
        "target_calories": { "type": "number", "required": true },
        "weight_kg": { "type": "number", "required": true }
      }
    },
    "navy_body_fat": {
      "name": "US Navy Body Fat Estimator",
      "inputs": {
        "gender": { "type": "string", "enum": ["male", "female"], "required": true },
        "height_cm": { "type": "number", "required": true },
        "neck_cm": { "type": "number", "required": true },
        "waist_cm": { "type": "number", "required": true },
        "hip_cm": { "type": "number", "required": false, "description": "Required only if gender is female" }
      }
    },
    "bmi": {
      "name": "Body Mass Index Calculator",
      "formula": "weight_kg / (height_cm / 100)^2",
      "inputs": {
        "weight_kg": { "type": "number", "required": true },
        "height_cm": { "type": "number", "required": true }
      }
    },
    "hydration": {
      "name": "Hydration Water Intake Calculator",
      "formula": "weight_kg * 35 + climate_adjustment + exercise_adjustment (floor 1500ml)",
      "inputs": {
        "weight_kg": { "type": "number", "required": true },
        "climate": { "type": "string", "enum": ["temperate", "hot", "cold"], "required": true },
        "exercise_hours": { "type": "number", "required": true }
      }
    }
  }
}