{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "SAAP Agent Schema",
  "description": "Modular schema for SAAP AI Agents - enables dynamic agent creation and management",
  "type": "object",
  "required": ["id", "name", "type", "model_config"],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_]*$",
      "description": "Unique agent identifier (snake_case)",
      "examples": ["jane_alesi", "john_alesi", "lara_alesi"]
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 50,
      "description": "Human-readable agent name",
      "examples": ["Jane Alesi", "John Alesi", "Lara Alesi"]
    },
    "type": {
      "type": "string",
      "enum": ["coordinator", "specialist", "analyst", "developer", "support"],
      "description": "Agent role category for UI grouping and behavior"
    },
    "color": {
      "type": "string",
      "pattern": "^#([0-9A-Fa-f]{6}|[0-9A-Fa-f]{3})$",
      "description": "Agent brand color (hex code for UI theming)",
      "examples": ["#8B5CF6", "#14B8A6", "#EC4899", "#F59E0B"]
    },
    "avatar": {
      "type": "string",
      "format": "uri",
      "description": "Agent avatar image URL or path",
      "examples": ["/avatars/jane.png", "https://cdn.satware.ai/agents/john.jpg"]
    },
    "description": {
      "type": "string",
      "maxLength": 200,
      "description": "Brief agent description for UI display"
    },
    "model_config": {
      "type": "object",
      "required": ["provider", "model"],
      "properties": {
        "provider": {
          "type": "string",
          "enum": ["colossus", "huggingface", "ollama", "openrouter"],
          "description": "LLM provider for this agent"
        },
        "model": {
          "type": "string",
          "description": "Specific model identifier",
          "examples": [
            "mistral-small3.2:24b-instruct-2506",
            "qwen2.5:7b",
            "deepseek-coder:6.7b"
          ]
        },
        "api_key": {
          "type": "string",
          "description": "API key for external providers (optional for local models)"
        },
        "api_base": {
          "type": "string",
          "format": "uri",
          "description": "Custom API endpoint URL",
          "examples": ["https://ai.adrian-schupp.de", "http://localhost:11434"]
        },
        "temperature": {
          "type": "number",
          "minimum": 0,
          "maximum": 2,
          "default": 0.7,
          "description": "Model creativity/randomness parameter"
        },
        "max_tokens": {
          "type": "integer",
          "minimum": 1,
          "maximum": 4096,
          "default": 1000,
          "description": "Maximum response length"
        },
        "timeout": {
          "type": "integer",
          "minimum": 1,
          "maximum": 300,
          "default": 30,
          "description": "Request timeout in seconds"
        }
      }
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "orchestration", "coordination", "strategy",
          "coding", "debugging", "architecture",
          "analysis", "research", "reporting", 
          "medical_advice", "diagnosis", "treatment",
          "legal_advice", "compliance", "contracts",
          "financial_analysis", "investment", "budgeting",
          "system_integration", "devops", "monitoring",
          "coaching", "training", "change_management"
        ]
      },
      "description": "Agent capabilities for automatic task routing"
    },
    "personality": {
      "type": "object",
      "properties": {
        "system_prompt": {
          "type": "string",
          "description": "Base system prompt defining agent behavior",
          "maxLength": 2000
        },
        "communication_style": {
          "type": "string",
          "enum": ["professional", "friendly", "technical", "empathetic", "direct"],
          "default": "professional"
        },
        "expertise_areas": {
          "type": "array",
          "items": {"type": "string"},
          "description": "Specific knowledge domains"
        },
        "response_format": {
          "type": "string",
          "enum": ["structured", "conversational", "bullet_points", "detailed"],
          "default": "conversational"
        }
      }
    },
    "status": {
      "type": "string",
      "enum": ["inactive", "starting", "active", "stopping", "error", "maintenance"],
      "default": "inactive",
      "description": "Current agent operational status"
    },
    "metrics": {
      "type": "object",
      "properties": {
        "messages_processed": {
          "type": "integer",
          "minimum": 0,
          "description": "Total messages handled by this agent"
        },
        "average_response_time": {
          "type": "number",
          "minimum": 0,
          "description": "Average response time in seconds"
        },
        "uptime": {
          "type": "string",
          "pattern": "^\\d+[dhms]\\s*\\d*[dhms]*$",
          "description": "Agent uptime (e.g., '2h 34m')"
        },
        "error_rate": {
          "type": "number",
          "minimum": 0,
          "maximum": 100,
          "description": "Error rate percentage"
        },
        "last_active": {
          "type": "string",
          "format": "date-time",
          "description": "Last activity timestamp (ISO 8601)"
        }
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Agent creation timestamp"
    },
    "updated_at": {
      "type": "string", 
      "format": "date-time",
      "description": "Last configuration update timestamp"
    },
    "tags": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Custom tags for agent categorization and filtering"
    }
  },
  "examples": [
    {
      "id": "jane_alesi",
      "name": "Jane Alesi",
      "type": "coordinator",
      "color": "#8B5CF6",
      "avatar": "/avatars/jane.png",
      "description": "Lead AI Architect coordinating multi-agent operations",
      "model_config": {
        "provider": "colossus",
        "model": "mistral-small3.2:24b-instruct-2506",
        "api_key": "{{COLOSSUS_API_KEY}}",
        "api_base": "https://ai.adrian-schupp.de",
        "temperature": 0.7,
        "max_tokens": 1500,
        "timeout": 30
      },
      "capabilities": ["orchestration", "coordination", "strategy"],
      "personality": {
        "system_prompt": "You are Jane Alesi, the lead AI architect for the SAAP platform. Your role is to coordinate other AI agents, make strategic decisions, and ensure optimal multi-agent collaboration. You are professional, insightful, and always focused on achieving the best outcomes for the entire agent ecosystem.",
        "communication_style": "professional",
        "expertise_areas": ["AI architecture", "agent coordination", "strategic planning"],
        "response_format": "structured"
      },
      "status": "inactive",
      "tags": ["lead", "coordinator", "satware_alesi"]
    },
    {
      "id": "john_alesi", 
      "name": "John Alesi",
      "type": "developer",
      "color": "#14B8A6",
      "avatar": "/avatars/john.png", 
      "description": "Expert software developer and AGI architecture specialist",
      "model_config": {
        "provider": "colossus",
        "model": "mistral-small3.2:24b-instruct-2506",
        "api_key": "{{COLOSSUS_API_KEY}}",
        "api_base": "https://ai.adrian-schupp.de",
        "temperature": 0.3,
        "max_tokens": 2000
      },
      "capabilities": ["coding", "debugging", "architecture"],
      "personality": {
        "system_prompt": "You are John Alesi, an expert software developer specializing in AGI architectures. You excel at writing clean, efficient code, debugging complex systems, and designing scalable software architectures. You prefer technical precision and detailed explanations.",
        "communication_style": "technical",
        "expertise_areas": ["Python", "JavaScript", "AGI systems", "software architecture"],
        "response_format": "detailed"
      },
      "status": "inactive",
      "tags": ["developer", "coder", "satware_alesi"]
    },
    {
      "id": "lara_alesi",
      "name": "Lara Alesi", 
      "type": "specialist",
      "color": "#EC4899",
      "avatar": "/avatars/lara.png",
      "description": "Advanced medical AI assistant and healthcare specialist",
      "model_config": {
        "provider": "colossus",
        "model": "mistral-small3.2:24b-instruct-2506",
        "api_key": "{{COLOSSUS_API_KEY}}", 
        "api_base": "https://ai.adrian-schupp.de",
        "temperature": 0.4,
        "max_tokens": 1200
      },
      "capabilities": ["medical_advice", "diagnosis", "treatment"],
      "personality": {
        "system_prompt": "You are Lara Alesi, an advanced medical AI specialist. You provide expert medical knowledge, help with diagnosis and treatment recommendations, and ensure healthcare-related queries are handled with the utmost care and accuracy. You are empathetic yet precise.",
        "communication_style": "empathetic", 
        "expertise_areas": ["general medicine", "diagnostics", "treatment planning", "healthcare AI"],
        "response_format": "structured"
      },
      "status": "inactive",
      "tags": ["medical", "healthcare", "specialist", "satware_alesi"]
    }
  ]
}