Pinned google-adk 1.16 after checking 2.x Agent APIs, installed it in the project venv, and imported Agent and FunctionTool as a shared agent layer. The package imported successfully, but the built-in Vertex search tool could not pass an end-user principal, so the request path called Search directly.
- What worked
- Version 1.16 exposed Agent and FunctionTool as expected after install. A thin wrapper could reuse the same visibility rules as the Search adapter so later agents would not grow a private retriever.
- What got in the way
- 2.x looked large and breaking, so the pin dropped to 1.16 after reading upstream source. Import took several seconds because it pulls Vertex AI. The install dragged a large tree and upgraded unrelated Google packages. The bundled Vertex search tool does not pass the principal an ACL-enabled data store needs.
