Feat: Add File Search API and Google Maps Tool SupportFeature/new gemini tools

[jfradj]

This PR introduces comprehensive support for the Gemini File Search API and the Google Maps tool, expanding the client's capabilities for retrieval-augmented generation and location-based interactions.

Key Changes:

• File Search API:

  • Implemented the FileSearchStores resource for managing file collections.
  • Added support for creating, listing, retrieving, and deleting file search stores.
  • Added support for uploading, listing, retrieving, and deleting documents within stores.
  • Integrated FileSearch configuration into Tool and ToolConfig.

• Google Maps Tool:

  • Added support for the Google Maps tool (GoogleMaps, Map, PlaceAnswerSources) within the Tool definition, enabling the model to utilize location data.

• Grounding & Retrieval:

  • Introduced GroundingMetadata, GroundingChunk, and RetrievedContext to handle grounding information in responses.
  • Added RetrievalConfig for configuring retrieval strategies.

• Client & Contracts:

  • Updated Client and ClientContract to expose the new fileSearchStores() resource.

• Documentation:

  • Updated README.md with detailed documentation and examples for using the new File Search APIs.

[jfradj]

@aydinfatih I've just created a whole new PR with everything in it.
My first attempt was to try to split it into smaller PR, but they're too related.
Also, I've updated the README accordingly, lint all the code and run all the test til the all pass.

[aydinfatih]

Hi @jfradj
A few GitHub actions have returned errors. Can you fix the errors?

[jfradj]

Hey @aydinfatih, the few errors should be fixed by my last commit. Thanks