Improve LLM prompts with Ogre3D material reference and available textures

[fernandotonon]

Summary

• Enhanced system prompt with comprehensive Ogre3D material syntax reference
• Added available textures context from Ogre's TextureManager to prompts
• LLM now knows which textures are available in the project

Changes

Enhanced System Prompt

Added comprehensive documentation for:

• Pass attributes: ambient, diffuse, specular, emissive, lighting, shading, scene_blend, depth_check, depth_write, cull_hardware, polygon_mode
• Texture unit attributes: texture, filtering, tex_address_mode, scroll, scroll_anim, rotate, rotate_anim, scale, colour_op, env_map, alpha_rejection
• Blend operations: colour_op_ex operations and sources
• Multiple examples: textured material, transparent material, animated water

Available Textures Context

• Gets list of textures from Ogre's TextureManager when generating materials
• Filters out internal Ogre textures (RTT, Ogre/, etc.)
• Limits to 50 textures to avoid excessive prompt length
• Instructs LLM to only use textures from the available list

Improved Retry Logic

• Retry prompts now include the available textures list
• Better error messages with specific validation failure reasons

Benefits

• LLM generates more valid material scripts
• Materials reference actual project textures instead of non-existent files
• Better understanding of Ogre3D material syntax reduces validation failures

Related Issues

• Relates to Enhancement: Multi-step AI material generation with image creation #104 (future RAG/image generation enhancement)

Test Plan

• Build succeeds
• Load a model with textures
• Open Material Editor and use AI to generate a material
• Verify the LLM references actual available textures
• Verify generated materials are syntactically valid

🤖 Generated with Claude Code