# =====================================================
# AI CAPABILITY DICTIONARY
# SINGLE SOURCE OF TRUTH
# Version: 1.0
# Last Updated: 2026-01-01
# =====================================================
# 
# GOVERNANCE RULES:
# 1. All AI capabilities MUST be defined in this registry
# 2. No capability may exist outside this registry
# 3. No duplication allowed across agents, spaces, or repos
# 4. Every capability must support audit and explainability
# 5. Enterprise-ready for regulated industries (Insurance/Finance)
#
# =====================================================

A_GENERATION:
  - id: GEN_IMAGE
    name: Image Generation
    category: Generation
    description: Generate images from text prompts
    supported_domains: [insurance, marketing, simulation]
    insurance_use_cases:
      - Damage visualization
      - Claim scenario reconstruction
    decision_types:
      - Claim validation
    governance_flags:
      explainable: false
      auditable: true

  - id: GEN_VIDEO
    name: Video Generation
    category: Generation
    description: Generate videos from prompts or sequences
    supported_domains: [insurance, media]
    insurance_use_cases:
      - Accident reenactment
    decision_types:
      - Investigation support
    governance_flags:
      explainable: false
      auditable: true

  - id: GEN_TEXT
    name: Text Generation
    category: Generation
    description: Generate structured or unstructured text
    supported_domains: [insurance, finance]
    insurance_use_cases:
      - Claim summaries
      - Customer communication
    decision_types:
      - Decision explanation
    governance_flags:
      explainable: true
      auditable: true

  - id: GEN_MUSIC
    name: Music Generation
    category: Generation
    description: Generate music or soundtracks
    supported_domains: [media]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: GEN_TTS
    name: Speech Synthesis (TTS)
    category: Generation
    description: Convert text to speech
    supported_domains: [insurance, call_centers]
    insurance_use_cases:
      - Automated claim calls
    decision_types:
      - Communication
    governance_flags:
      explainable: true
      auditable: true

  - id: GEN_3D
    name: 3D Asset Generation
    category: Generation
    description: Generate 3D assets and objects
    supported_domains: [insurance, simulation]
    insurance_use_cases:
      - Vehicle damage modeling
    decision_types:
      - Assessment support
    governance_flags:
      explainable: false
      auditable: true

# -----------------------------------------------------

B_TRANSFORMATION_EDITING:
  - id: IMG_EDIT
    name: Image Editing
    category: Transformation
    description: Edit and manipulate images
    supported_domains: [insurance]
    insurance_use_cases:
      - Evidence cleanup
    decision_types:
      - Claim review
    governance_flags:
      explainable: false
      auditable: true

  - id: VID_EDIT
    name: Video Editing
    category: Transformation
    description: Edit and enhance videos
    supported_domains: [insurance]
    insurance_use_cases:
      - CCTV evidence processing
    decision_types:
      - Investigation
    governance_flags:
      explainable: false
      auditable: true

  - id: STYLE_TRANSFER
    name: Style Transfer
    category: Transformation
    description: Apply visual styles
    supported_domains: [media]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: BG_REMOVAL
    name: Background Removal
    category: Transformation
    description: Remove backgrounds from images
    supported_domains: [insurance]
    insurance_use_cases:
      - Object isolation
    decision_types:
      - Damage assessment
    governance_flags:
      explainable: false
      auditable: true

  - id: IMG_UPSCALE
    name: Image Upscaling
    category: Transformation
    description: Enhance image resolution
    supported_domains: [insurance]
    insurance_use_cases:
      - Improve evidence clarity
    decision_types:
      - Assessment support
    governance_flags:
      explainable: false
      auditable: true

  - id: INPAINT_OUTPAINT
    name: Inpainting / Outpainting
    category: Transformation
    description: Fill or extend images
    supported_domains: [insurance]
    insurance_use_cases:
      - Damage extrapolation
    decision_types:
      - Investigation
    governance_flags:
      explainable: false
      auditable: true

# -----------------------------------------------------

C_LANGUAGE_TEXT:
  - id: LANG_TRANSLATION
    name: Language Translation
    category: Language
    description: Translate between languages
    supported_domains: [insurance]
    insurance_use_cases:
      - Multilingual claims
    decision_types:
      - Communication
    governance_flags:
      explainable: true
      auditable: true

  - id: TEXT_ANALYSIS
    name: Text Analysis
    category: Language
    description: Analyze text content
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim text review
    decision_types:
      - Risk assessment
    governance_flags:
      explainable: true
      auditable: true

  - id: SENTIMENT_ANALYSIS
    name: Sentiment Analysis
    category: Language
    description: Detect emotional tone
    supported_domains: [insurance]
    insurance_use_cases:
      - Fraud suspicion signals
    decision_types:
      - Risk flagging
    governance_flags:
      explainable: true
      auditable: true

  - id: TEXT_SUMMARY
    name: Text Summarization
    category: Language
    description: Summarize long documents
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim reports
    decision_types:
      - Decision support
    governance_flags:
      explainable: true
      auditable: true

  - id: TEXT_QA
    name: Question Answering
    category: Language
    description: Answer questions from text or knowledge
    supported_domains: [insurance]
    insurance_use_cases:
      - Policy clarification
      - Claim review
    decision_types:
      - Decision assistance
    governance_flags:
      explainable: true
      auditable: true

  - id: CONVERSATIONAL_AI
    name: Conversational AI
    category: Language
    description: Chatbot-style interaction
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim intake bots
    decision_types:
      - Intake routing
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

D_SPEECH_AUDIO:
  - id: ASR
    name: Speech Recognition
    category: Audio
    description: Convert speech to text
    supported_domains: [insurance]
    insurance_use_cases:
      - Call transcription
    decision_types:
      - Evidence extraction
    governance_flags:
      explainable: true
      auditable: true

  - id: VOICE_AI
    name: Voice Calling AI
    category: Audio
    description: Automated voice calls
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim follow-ups
    decision_types:
      - Communication
    governance_flags:
      explainable: true
      auditable: true

  - id: REALTIME_VOICE_AGENT
    name: Real-Time Voice Agent
    category: Audio
    description: Live conversational agents
    supported_domains: [insurance]
    insurance_use_cases:
      - Live support
    decision_types:
      - Assistance
    governance_flags:
      explainable: true
      auditable: true

  - id: VOICE_EMOTION
    name: Emotion Detection (Voice)
    category: Audio
    description: Detect emotion from voice
    supported_domains: [insurance]
    insurance_use_cases:
      - Fraud signals
    decision_types:
      - Risk scoring
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

E_VISION_IMAGE:
  - id: OBJECT_DETECTION
    name: Object Detection
    category: Vision
    description: Detect objects in images
    supported_domains: [insurance]
    insurance_use_cases:
      - Vehicle damage detection
    decision_types:
      - Assessment
    governance_flags:
      explainable: true
      auditable: true

  - id: IMAGE_CLASSIFICATION
    name: Image Classification
    category: Vision
    description: Classify images
    supported_domains: [insurance]
    insurance_use_cases:
      - Damage type classification
    decision_types:
      - Assessment
    governance_flags:
      explainable: true
      auditable: true

  - id: OCR
    name: OCR
    category: Vision
    description: Extract text from images
    supported_domains: [insurance]
    insurance_use_cases:
      - Document digitization
    decision_types:
      - Data extraction
    governance_flags:
      explainable: true
      auditable: true

  - id: IMAGE_CAPTION
    name: Image Captioning
    category: Vision
    description: Describe images in text
    supported_domains: [insurance]
    insurance_use_cases:
      - Evidence explanation
    decision_types:
      - Review
    governance_flags:
      explainable: true
      auditable: true

  - id: VQA
    name: Visual Question Answering
    category: Vision
    description: Answer questions about images
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim investigation
    decision_types:
      - Decision support
    governance_flags:
      explainable: true
      auditable: true

  - id: POSE_ESTIMATION
    name: Pose Estimation
    category: Vision
    description: Detect body pose
    supported_domains: [insurance]
    insurance_use_cases:
      - Injury assessment
    decision_types:
      - Medical review
    governance_flags:
      explainable: true
      auditable: true

  - id: FACE_RECOGNITION
    name: Face Recognition
    category: Vision
    description: Identify faces
    supported_domains: [security]
    insurance_use_cases:
      - Identity verification
    decision_types:
      - Fraud prevention
    governance_flags:
      explainable: false
      auditable: true

  - id: MEDICAL_IMAGE_ANALYSIS
    name: Medical Image Analysis
    category: Vision
    description: Analyze medical imagery
    supported_domains: [medical_insurance]
    insurance_use_cases:
      - Injury validation
    decision_types:
      - Medical approval
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

F_DOCUMENT_KNOWLEDGE:
  - id: DOCUMENT_ANALYSIS
    name: Document Analysis
    category: Knowledge
    description: Analyze structured documents
    supported_domains: [insurance]
    insurance_use_cases:
      - Policy analysis
    decision_types:
      - Coverage decision
    governance_flags:
      explainable: true
      auditable: true

  - id: RAG
    name: Retrieval-Augmented Generation
    category: Knowledge
    description: Grounded generation from documents
    supported_domains: [insurance]
    insurance_use_cases:
      - Policy Q&A
    decision_types:
      - Explanation
    governance_flags:
      explainable: true
      auditable: true

  - id: CONTRACT_INTELLIGENCE
    name: Contract & Policy Intelligence
    category: Knowledge
    description: Understand legal documents
    supported_domains: [insurance]
    insurance_use_cases:
      - Coverage determination
    decision_types:
      - Approval / rejection
    governance_flags:
      explainable: true
      auditable: true

  - id: KNOWLEDGE_GRAPH
    name: Knowledge Graph Extraction
    category: Knowledge
    description: Extract entities and relations
    supported_domains: [insurance]
    insurance_use_cases:
      - Fraud networks
    decision_types:
      - Investigation
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

G_DATA_ANALYTICS:
  - id: DATA_VIZ
    name: Data Visualization
    category: Analytics
    description: Visual analytics
    supported_domains: [insurance]
    insurance_use_cases:
      - Portfolio insights
    decision_types:
      - Strategy
    governance_flags:
      explainable: true
      auditable: true

  - id: FIN_ANALYSIS
    name: Financial Analysis
    category: Analytics
    description: Analyze financial data
    supported_domains: [insurance]
    insurance_use_cases:
      - Loss ratios
    decision_types:
      - Pricing
    governance_flags:
      explainable: true
      auditable: true

  - id: TIME_SERIES
    name: Time-Series Forecasting
    category: Analytics
    description: Forecast trends
    supported_domains: [insurance]
    insurance_use_cases:
      - Claims forecasting
    decision_types:
      - Planning
    governance_flags:
      explainable: true
      auditable: true

  - id: ANOMALY_DETECTION
    name: Anomaly Detection
    category: Analytics
    description: Detect abnormal patterns
    supported_domains: [insurance]
    insurance_use_cases:
      - Fraud detection
    decision_types:
      - Risk flag
    governance_flags:
      explainable: true
      auditable: true

  - id: RISK_SCORING
    name: Risk Scoring
    category: Analytics
    description: Score risk levels
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim risk
    decision_types:
      - Approval / review
    governance_flags:
      explainable: true
      auditable: true

  - id: DECISION_INTELLIGENCE
    name: Decision Intelligence
    category: Analytics
    description: Combine signals into decisions
    supported_domains: [insurance]
    insurance_use_cases:
      - Automated claim decisions
    decision_types:
      - Final decision
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

H_CODE_DEV:
  - id: CODE_GEN
    name: Code Generation
    category: Developer
    description: Generate code
    supported_domains: [engineering]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: CODE_REVIEW
    name: Code Review
    category: Developer
    description: Review code quality
    supported_domains: [engineering]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: BUG_DETECTION
    name: Bug Detection
    category: Developer
    description: Detect bugs
    supported_domains: [engineering]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: API_GEN
    name: API Generation
    category: Developer
    description: Generate APIs
    supported_domains: [engineering]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

# -----------------------------------------------------

I_MODELS_DATASETS:
  - id: MODEL_BENCHMARK
    name: Model Benchmarking
    category: Models
    description: Benchmark models
    supported_domains: [ai]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: true
      auditable: true

  - id: MODEL_EVAL
    name: Model Evaluation
    category: Models
    description: Evaluate models
    supported_domains: [ai]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: true
      auditable: true

  - id: BIAS_FAIRNESS
    name: Bias & Fairness Analysis
    category: Models
    description: Detect bias
    supported_domains: [ai]
    insurance_use_cases:
      - Regulatory compliance
    decision_types:
      - Governance
    governance_flags:
      explainable: true
      auditable: true

  - id: DATASET_CREATION
    name: Dataset Creation
    category: Models
    description: Create datasets
    supported_domains: [ai]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: true
      auditable: true

  - id: SYNTHETIC_DATA
    name: Synthetic Data Generation
    category: Models
    description: Generate synthetic data
    supported_domains: [insurance]
    insurance_use_cases:
      - Fraud training
    decision_types:
      - Model training
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

J_RECOMMENDATION_DECISION:
  - id: RECOMMENDER
    name: Recommendation Systems
    category: Decision
    description: Recommend actions
    supported_domains: [insurance]
    insurance_use_cases:
      - Next best action
    decision_types:
      - Recommendation
    governance_flags:
      explainable: true
      auditable: true

  - id: PERSONALIZATION
    name: Personalization
    category: Decision
    description: Personalize experiences
    supported_domains: [insurance]
    insurance_use_cases:
      - Customer journeys
    decision_types:
      - Engagement
    governance_flags:
      explainable: true
      auditable: true

  - id: OPTIMIZATION
    name: Optimization Engines
    category: Decision
    description: Optimize outcomes
    supported_domains: [insurance]
    insurance_use_cases:
      - Pricing optimization
    decision_types:
      - Optimization
    governance_flags:
      explainable: true
      auditable: true

  - id: SCENARIO_SIM
    name: Scenario Simulation
    category: Decision
    description: Simulate scenarios
    supported_domains: [insurance]
    insurance_use_cases:
      - Stress testing
    decision_types:
      - Planning
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

K_GAMING_SIMULATION:
  - id: GAME_AI
    name: Game AI
    category: Simulation
    description: Game agents
    supported_domains: [simulation]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: RL_AGENT
    name: Reinforcement Learning Agent
    category: Simulation
    description: RL-based agents
    supported_domains: [simulation]
    insurance_use_cases:
      - Policy optimization
    decision_types:
      - Strategy
    governance_flags:
      explainable: false
      auditable: true

  - id: SIM_ENV
    name: Simulation Environment
    category: Simulation
    description: Simulated environments
    supported_domains: [insurance]
    insurance_use_cases:
      - Claim stress tests
    decision_types:
      - Planning
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

L_3D_XR:
  - id: MODEL_3D
    name: 3D Modeling
    category: Spatial
    description: 3D modeling
    supported_domains: [insurance]
    insurance_use_cases:
      - Damage modeling
    decision_types:
      - Assessment
    governance_flags:
      explainable: false
      auditable: true

  - id: SCENE_RECON
    name: Scene Reconstruction
    category: Spatial
    description: Reconstruct scenes
    supported_domains: [insurance]
    insurance_use_cases:
      - Accident scenes
    decision_types:
      - Investigation
    governance_flags:
      explainable: false
      auditable: true

  - id: NERF
    name: NeRF / Gaussian Splatting
    category: Spatial
    description: Neural rendering
    supported_domains: [insurance]
    insurance_use_cases:
      - Damage visualization
    decision_types:
      - Review
    governance_flags:
      explainable: false
      auditable: true

# -----------------------------------------------------

M_SEARCH_TOOLS:
  - id: MODEL_FINDER
    name: Model Finder
    category: Search
    description: Discover models
    supported_domains: [ai]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: TOOL_DISCOVERY
    name: Tool Discovery
    category: Search
    description: Discover tools
    supported_domains: [ai]
    insurance_use_cases: []
    decision_types: []
    governance_flags:
      explainable: false
      auditable: false

  - id: CAPABILITY_SEARCH
    name: Capability Search
    category: Search
    description: Search capabilities
    supported_domains: [platform]
    insurance_use_cases:
      - Platform navigation
    decision_types:
      - Selection
    governance_flags:
      explainable: true
      auditable: true

# -----------------------------------------------------

N_SECURITY_GOVERNANCE:
  - id: AI_GOVERNANCE
    name: AI Governance
    category: Governance
    description: Governance controls
    supported_domains: [insurance]
    insurance_use_cases:
      - Regulatory alignment
    decision_types:
      - Compliance
    governance_flags:
      explainable: true
      auditable: true

  - id: AUDIT_LOGS
    name: Audit Logs
    category: Governance
    description: Full audit trails
    supported_domains: [insurance]
    insurance_use_cases:
      - Decision traceability
    decision_types:
      - Audit
    governance_flags:
      explainable: true
      auditable: true

  - id: XAI
    name: Explainability (XAI)
    category: Governance
    description: Explain decisions
    supported_domains: [insurance]
    insurance_use_cases:
      - Regulatory explanations
    decision_types:
      - Explanation
    governance_flags:
      explainable: true
      auditable: true

  - id: DRIFT_MONITOR
    name: Drift & Bias Monitoring
    category: Governance
    description: Monitor drift and bias
    supported_domains: [insurance]
    insurance_use_cases:
      - Model governance
    decision_types:
      - Monitoring
    governance_flags:
      explainable: true
      auditable: true

  - id: REG_COMPLIANCE
    name: Regulatory Compliance
    category: Governance
    description: Ensure compliance (IFRS, AML, etc.)
    supported_domains: [insurance]
    insurance_use_cases:
      - Legal deployment
    decision_types:
      - Compliance approval
    governance_flags:
      explainable: true
      auditable: true