{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://ai-universe.com/schemas/agent.second-opinion.schema.json",
  "title": "Agent Second Opinion Response",
  "description": "Schema for agent.second_opinion MCP tool responses. Defines the contract for multi-model consultation results.",
  "type": "object",
  "required": ["primary", "conversationId"],
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1,
      "description": "ID of the conversation where this consultation was stored"
    },
    "conversationCreated": {
      "type": "boolean",
      "description": "Whether a new conversation was created for this consultation"
    },
    "conversationTitle": {
      "type": ["string", "null"],
      "description": "Title of the conversation"
    },
    "primary": {
      "$ref": "#/definitions/modelOpinion",
      "description": "Primary model response"
    },
    "secondaryOpinions": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/modelOpinion"
      },
      "description": "Additional model opinions for comparison"
    },
    "synthesis": {
      "oneOf": [
        { "$ref": "#/definitions/synthesis" },
        { "type": "null" }
      ],
      "description": "Synthesized response combining all model insights (null when maxOpinions=0)"
    },
    "userMessageId": {
      "type": ["string", "null"],
      "description": "ID of the user message in the conversation"
    },
    "assistantMessageId": {
      "type": ["string", "null"],
      "description": "ID of the assistant message in the conversation"
    },
    "persistenceStatus": {
      "$ref": "#/definitions/persistenceStatus",
      "description": "Status of conversation persistence operations"
    },
    "assistantMessage": {
      "$ref": "#/definitions/conversationMessage",
      "description": "Full assistant message object with metadata"
    },
    "metadata": {
      "type": "object",
      "required": ["secondOpinion"],
      "properties": {
        "secondOpinion": {
          "type": "object",
          "required": ["primary", "synthesis"],
          "properties": {
            "primary": {
              "$ref": "#/definitions/modelOpinion"
            },
            "secondaryOpinions": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/modelOpinion"
              }
            },
            "synthesis": {
              "$ref": "#/definitions/synthesis"
            },
            "summary": {
              "$ref": "#/definitions/summary"
            }
          }
        }
      },
      "description": "Metadata containing structured second opinion data"
    },
    "summary": {
      "$ref": "#/definitions/summary",
      "description": "Summary statistics for the consultation"
    }
  },
  "definitions": {
    "modelOpinion": {
      "type": "object",
      "required": ["model", "response"],
      "properties": {
        "model": {
          "type": "string",
          "minLength": 1,
          "description": "Model identifier (e.g., 'cerebras', 'gemini', 'grok')"
        },
        "modelId": {
          "type": "string",
          "description": "Full model ID with version (e.g., 'cerebras-llama-3.3-70b')"
        },
        "modelDisplayName": {
          "type": "string",
          "description": "Human-readable model name"
        },
        "response": {
          "type": "string",
          "description": "Model's response text"
        },
        "tokensUsed": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of tokens used"
        },
        "latencyMs": {
          "type": "number",
          "minimum": 0,
          "description": "Response latency in milliseconds"
        },
        "cost": {
          "type": "number",
          "minimum": 0,
          "description": "Cost in USD"
        },
        "citations": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["title", "url"],
            "properties": {
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "snippet": {
                "type": "string"
              }
            }
          },
          "description": "Source citations from the model"
        },
        "error": {
          "type": "boolean",
          "description": "Whether this response contains an error"
        }
      },
      "additionalProperties": true
    },
    "synthesis": {
      "type": "object",
      "required": ["model", "response"],
      "properties": {
        "model": {
          "type": "string",
          "minLength": 1,
          "description": "Model used for synthesis"
        },
        "modelId": {
          "type": "string",
          "description": "Full model ID for synthesis"
        },
        "modelDisplayName": {
          "type": "string",
          "description": "Display name for synthesis model"
        },
        "response": {
          "type": "string",
          "minLength": 1,
          "description": "Synthesized response combining all insights"
        },
        "tokensUsed": {
          "type": "integer",
          "minimum": 0
        },
        "latencyMs": {
          "type": "number",
          "minimum": 0
        },
        "cost": {
          "type": "number",
          "minimum": 0
        },
        "sources": {
          "type": "array",
          "items": true,
          "description": "Source references used in synthesis"
        },
        "error": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    },
    "summary": {
      "type": "object",
      "properties": {
        "totalModels": {
          "type": "integer",
          "minimum": 0,
          "description": "Total number of models consulted"
        },
        "totalTokens": {
          "type": "integer",
          "minimum": 0,
          "description": "Total tokens used across all models"
        },
        "totalCost": {
          "type": "number",
          "minimum": 0,
          "description": "Total cost in USD"
        },
        "totalLatencyMs": {
          "type": "number",
          "minimum": 0,
          "description": "Total latency in milliseconds"
        }
      }
    },
    "persistenceStatus": {
      "type": "object",
      "required": ["userMessageSaved", "assistantMessageSaved", "userMessageId", "assistantMessageId"],
      "properties": {
        "userMessageSaved": {
          "type": "boolean"
        },
        "assistantMessageSaved": {
          "type": "boolean"
        },
        "userMessageId": {
          "type": ["string", "null"]
        },
        "assistantMessageId": {
          "type": ["string", "null"]
        },
        "error": {
          "type": ["string", "null"]
        }
      },
      "additionalProperties": true
    },
    "conversationMessage": {
      "type": "object",
      "required": ["id", "content", "role", "sequence", "createdAt"],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1
        },
        "content": {
          "type": "string"
        },
        "role": {
          "type": "string",
          "enum": ["user", "assistant", "system"]
        },
        "sequence": {
          "type": "integer",
          "minimum": 0
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "metadata": {
          "type": "object",
          "additionalProperties": true
        }
      }
    }
  }
}