curl -X POST "http://localhost:8000/api/v2/agents/my-agent/upload-file" \
  -H "X-Session-Token: your_session_token" \
  -F "file=@report.pdf"

{
  "agent_id": "my-agent",
  "session_id": "session_abc123",
  "namespace": "memanto_agent_my-agent",
  "file_name": "quarterly-report.pdf",
  "file_size": 2516582,
  "status": "uploaded",
  "message": ""
}

{
  "detail": "File type '.exe' is not supported. Allowed types: .csv, .docx, .json, .md, .pdf, .txt, .xlsx"
}

{
  "detail": "Missing session token. Use X-Session-Token header."
}

{
  "detail": {
    "error": "SessionExpired",
    "message": "Session has expired",
    "details": {}
  }
}

{
  "detail": [
    {
      "type": "missing",
      "loc": ["body", "file"],
      "msg": "Field required",
      "input": {}
    }
  ]
}

{
  "detail": {
    "error": "file_too_large",
    "message": "File exceeds the maximum upload size of 5 GB",
    "max_bytes": 5368709120
  }
}

{
  "detail": {
    "error": "InternalServerError",
    "message": "An unexpected error occurred",
    "details": {
      "original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
    }
  }
}