google-adk 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (345) hide show
  1. google/adk/._version.py +0 -0
  2. google/adk/__init__.py +20 -0
  3. google/adk/agents/__init__.py +32 -0
  4. google/adk/agents/active_streaming_tool.py +38 -0
  5. google/adk/agents/base_agent.py +345 -0
  6. google/adk/agents/callback_context.py +112 -0
  7. google/adk/agents/invocation_context.py +181 -0
  8. google/adk/agents/langgraph_agent.py +140 -0
  9. google/adk/agents/live_request_queue.py +64 -0
  10. google/adk/agents/llm_agent.py +376 -0
  11. google/adk/agents/loop_agent.py +62 -0
  12. google/adk/agents/parallel_agent.py +96 -0
  13. google/adk/agents/readonly_context.py +46 -0
  14. google/adk/agents/remote_agent.py +50 -0
  15. google/adk/agents/run_config.py +87 -0
  16. google/adk/agents/sequential_agent.py +45 -0
  17. google/adk/agents/transcription_entry.py +34 -0
  18. google/adk/artifacts/__init__.py +23 -0
  19. google/adk/artifacts/base_artifact_service.py +128 -0
  20. google/adk/artifacts/gcs_artifact_service.py +195 -0
  21. google/adk/artifacts/in_memory_artifact_service.py +133 -0
  22. google/adk/auth/__init__.py +22 -0
  23. google/adk/auth/auth_credential.py +220 -0
  24. google/adk/auth/auth_handler.py +268 -0
  25. google/adk/auth/auth_preprocessor.py +116 -0
  26. google/adk/auth/auth_schemes.py +67 -0
  27. google/adk/auth/auth_tool.py +55 -0
  28. google/adk/cli/__init__.py +15 -0
  29. google/adk/cli/__main__.py +18 -0
  30. google/adk/cli/agent_graph.py +148 -0
  31. google/adk/cli/browser/adk_favicon.svg +17 -0
  32. google/adk/cli/browser/assets/audio-processor.js +51 -0
  33. google/adk/cli/browser/assets/config/runtime-config.json +3 -0
  34. google/adk/cli/browser/index.html +33 -0
  35. google/adk/cli/browser/main-SY2WYYGV.js +75 -0
  36. google/adk/cli/browser/polyfills-FFHMD2TL.js +18 -0
  37. google/adk/cli/browser/styles-4VDSPQ37.css +17 -0
  38. google/adk/cli/cli.py +181 -0
  39. google/adk/cli/cli_deploy.py +181 -0
  40. google/adk/cli/cli_eval.py +282 -0
  41. google/adk/cli/cli_tools_click.py +524 -0
  42. google/adk/cli/fast_api.py +784 -0
  43. google/adk/cli/utils/__init__.py +49 -0
  44. google/adk/cli/utils/envs.py +57 -0
  45. google/adk/cli/utils/evals.py +93 -0
  46. google/adk/cli/utils/logs.py +72 -0
  47. google/adk/code_executors/__init__.py +49 -0
  48. google/adk/code_executors/base_code_executor.py +97 -0
  49. google/adk/code_executors/code_execution_utils.py +256 -0
  50. google/adk/code_executors/code_executor_context.py +202 -0
  51. google/adk/code_executors/container_code_executor.py +196 -0
  52. google/adk/code_executors/unsafe_local_code_executor.py +71 -0
  53. google/adk/code_executors/vertex_ai_code_executor.py +234 -0
  54. google/adk/docs/Makefile +20 -0
  55. google/adk/docs/build/doctrees/google-adk.doctree +0 -0
  56. google/adk/docs/build/html/_sources/google-adk.rst.txt +98 -0
  57. google/adk/docs/build/html/_sources/index.rst.txt +7 -0
  58. google/adk/docs/build/html/_static/autodoc_pydantic.css +27 -0
  59. google/adk/docs/build/html/_static/basic.css +925 -0
  60. google/adk/docs/build/html/_static/debug.css +85 -0
  61. google/adk/docs/build/html/_static/doctools.js +156 -0
  62. google/adk/docs/build/html/_static/documentation_options.js +29 -0
  63. google/adk/docs/build/html/_static/file.png +0 -0
  64. google/adk/docs/build/html/_static/language_data.js +199 -0
  65. google/adk/docs/build/html/_static/minus.png +0 -0
  66. google/adk/docs/build/html/_static/plus.png +0 -0
  67. google/adk/docs/build/html/_static/pygments.css +274 -0
  68. google/adk/docs/build/html/_static/scripts/furo-extensions.js +16 -0
  69. google/adk/docs/build/html/_static/scripts/furo.js +19 -0
  70. google/adk/docs/build/html/_static/scripts/furo.js.LICENSE.txt +7 -0
  71. google/adk/docs/build/html/_static/scripts/furo.js.map +1 -0
  72. google/adk/docs/build/html/_static/searchtools.js +620 -0
  73. google/adk/docs/build/html/_static/skeleton.css +312 -0
  74. google/adk/docs/build/html/_static/sphinx_highlight.js +170 -0
  75. google/adk/docs/build/html/_static/styles/furo-extensions.css +18 -0
  76. google/adk/docs/build/html/_static/styles/furo-extensions.css.map +1 -0
  77. google/adk/docs/build/html/_static/styles/furo.css +18 -0
  78. google/adk/docs/build/html/_static/styles/furo.css.map +1 -0
  79. google/adk/docs/build/html/genindex.html +861 -0
  80. google/adk/docs/build/html/google-adk.html +5461 -0
  81. google/adk/docs/build/html/index.html +567 -0
  82. google/adk/docs/build/html/objects.inv +0 -0
  83. google/adk/docs/build/html/py-modindex.html +373 -0
  84. google/adk/docs/build/html/search.html +333 -0
  85. google/adk/docs/build/html/searchindex.js +17 -0
  86. google/adk/docs/source/conf.py +133 -0
  87. google/adk/docs/source/google-adk.rst +98 -0
  88. google/adk/docs/source/index.rst +7 -0
  89. google/adk/evaluation/__init__.py +31 -0
  90. google/adk/evaluation/agent_evaluator.py +329 -0
  91. google/adk/evaluation/evaluation_constants.py +24 -0
  92. google/adk/evaluation/evaluation_generator.py +270 -0
  93. google/adk/evaluation/response_evaluator.py +135 -0
  94. google/adk/evaluation/trajectory_evaluator.py +184 -0
  95. google/adk/events/__init__.py +21 -0
  96. google/adk/events/event.py +130 -0
  97. google/adk/events/event_actions.py +55 -0
  98. google/adk/examples/__init__.py +28 -0
  99. google/adk/examples/base_example_provider.py +35 -0
  100. google/adk/examples/example.py +27 -0
  101. google/adk/examples/example_util.py +123 -0
  102. google/adk/examples/vertex_ai_example_store.py +104 -0
  103. google/adk/flows/__init__.py +14 -0
  104. google/adk/flows/llm_flows/__init__.py +20 -0
  105. google/adk/flows/llm_flows/_base_llm_processor.py +52 -0
  106. google/adk/flows/llm_flows/_code_execution.py +458 -0
  107. google/adk/flows/llm_flows/_nl_planning.py +129 -0
  108. google/adk/flows/llm_flows/agent_transfer.py +132 -0
  109. google/adk/flows/llm_flows/audio_transcriber.py +109 -0
  110. google/adk/flows/llm_flows/auto_flow.py +49 -0
  111. google/adk/flows/llm_flows/base_llm_flow.py +559 -0
  112. google/adk/flows/llm_flows/basic.py +72 -0
  113. google/adk/flows/llm_flows/contents.py +370 -0
  114. google/adk/flows/llm_flows/functions.py +486 -0
  115. google/adk/flows/llm_flows/identity.py +47 -0
  116. google/adk/flows/llm_flows/instructions.py +137 -0
  117. google/adk/flows/llm_flows/single_flow.py +57 -0
  118. google/adk/memory/__init__.py +35 -0
  119. google/adk/memory/base_memory_service.py +74 -0
  120. google/adk/memory/in_memory_memory_service.py +62 -0
  121. google/adk/memory/vertex_ai_rag_memory_service.py +177 -0
  122. google/adk/models/__init__.py +31 -0
  123. google/adk/models/anthropic_llm.py +243 -0
  124. google/adk/models/base_llm.py +87 -0
  125. google/adk/models/base_llm_connection.py +76 -0
  126. google/adk/models/gemini_llm_connection.py +200 -0
  127. google/adk/models/google_llm.py +331 -0
  128. google/adk/models/lite_llm.py +673 -0
  129. google/adk/models/llm_request.py +98 -0
  130. google/adk/models/llm_response.py +111 -0
  131. google/adk/models/registry.py +102 -0
  132. google/adk/planners/__init__.py +23 -0
  133. google/adk/planners/base_planner.py +66 -0
  134. google/adk/planners/built_in_planner.py +75 -0
  135. google/adk/planners/plan_re_act_planner.py +208 -0
  136. google/adk/runners.py +456 -0
  137. google/adk/sessions/__init__.py +41 -0
  138. google/adk/sessions/base_session_service.py +133 -0
  139. google/adk/sessions/database_session_service.py +522 -0
  140. google/adk/sessions/in_memory_session_service.py +206 -0
  141. google/adk/sessions/session.py +54 -0
  142. google/adk/sessions/state.py +71 -0
  143. google/adk/sessions/vertex_ai_session_service.py +356 -0
  144. google/adk/telemetry.py +189 -0
  145. google/adk/tests/__init__.py +14 -0
  146. google/adk/tests/integration/.env.example +10 -0
  147. google/adk/tests/integration/__init__.py +18 -0
  148. google/adk/tests/integration/conftest.py +119 -0
  149. google/adk/tests/integration/fixture/__init__.py +14 -0
  150. google/adk/tests/integration/fixture/agent_with_config/__init__.py +15 -0
  151. google/adk/tests/integration/fixture/agent_with_config/agent.py +88 -0
  152. google/adk/tests/integration/fixture/callback_agent/__init__.py +15 -0
  153. google/adk/tests/integration/fixture/callback_agent/agent.py +105 -0
  154. google/adk/tests/integration/fixture/context_update_test/OWNERS +1 -0
  155. google/adk/tests/integration/fixture/context_update_test/__init__.py +15 -0
  156. google/adk/tests/integration/fixture/context_update_test/agent.py +43 -0
  157. google/adk/tests/integration/fixture/context_update_test/successful_test.session.json +582 -0
  158. google/adk/tests/integration/fixture/context_variable_agent/__init__.py +15 -0
  159. google/adk/tests/integration/fixture/context_variable_agent/agent.py +115 -0
  160. google/adk/tests/integration/fixture/customer_support_ma/__init__.py +15 -0
  161. google/adk/tests/integration/fixture/customer_support_ma/agent.py +172 -0
  162. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/__init__.py +15 -0
  163. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/agent.py +338 -0
  164. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/order_query.test.json +69 -0
  165. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/test_config.json +6 -0
  166. google/adk/tests/integration/fixture/flow_complex_spark/__init__.py +15 -0
  167. google/adk/tests/integration/fixture/flow_complex_spark/agent.py +182 -0
  168. google/adk/tests/integration/fixture/flow_complex_spark/sample.session.json +190 -0
  169. google/adk/tests/integration/fixture/hello_world_agent/__init__.py +15 -0
  170. google/adk/tests/integration/fixture/hello_world_agent/agent.py +95 -0
  171. google/adk/tests/integration/fixture/hello_world_agent/roll_die.test.json +24 -0
  172. google/adk/tests/integration/fixture/hello_world_agent/test_config.json +6 -0
  173. google/adk/tests/integration/fixture/home_automation_agent/__init__.py +15 -0
  174. google/adk/tests/integration/fixture/home_automation_agent/agent.py +304 -0
  175. google/adk/tests/integration/fixture/home_automation_agent/simple_test.test.json +5 -0
  176. google/adk/tests/integration/fixture/home_automation_agent/simple_test2.test.json +5 -0
  177. google/adk/tests/integration/fixture/home_automation_agent/test_config.json +5 -0
  178. google/adk/tests/integration/fixture/home_automation_agent/test_files/dependent_tool_calls.test.json +18 -0
  179. google/adk/tests/integration/fixture/home_automation_agent/test_files/memorizing_past_events/eval_data.test.json +17 -0
  180. google/adk/tests/integration/fixture/home_automation_agent/test_files/memorizing_past_events/test_config.json +6 -0
  181. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_multi_turn_conversation.test.json +18 -0
  182. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_test.test.json +17 -0
  183. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_test2.test.json +5 -0
  184. google/adk/tests/integration/fixture/home_automation_agent/test_files/test_config.json +5 -0
  185. google/adk/tests/integration/fixture/tool_agent/__init__.py +15 -0
  186. google/adk/tests/integration/fixture/tool_agent/agent.py +218 -0
  187. google/adk/tests/integration/fixture/tool_agent/files/Agent_test_plan.pdf +0 -0
  188. google/adk/tests/integration/fixture/trip_planner_agent/__init__.py +15 -0
  189. google/adk/tests/integration/fixture/trip_planner_agent/agent.py +110 -0
  190. google/adk/tests/integration/fixture/trip_planner_agent/initial.session.json +13 -0
  191. google/adk/tests/integration/fixture/trip_planner_agent/test_config.json +5 -0
  192. google/adk/tests/integration/fixture/trip_planner_agent/test_files/initial.session.json +13 -0
  193. google/adk/tests/integration/fixture/trip_planner_agent/test_files/test_config.json +5 -0
  194. google/adk/tests/integration/fixture/trip_planner_agent/test_files/trip_inquiry_sub_agent.test.json +7 -0
  195. google/adk/tests/integration/fixture/trip_planner_agent/trip_inquiry.test.json +19 -0
  196. google/adk/tests/integration/models/__init__.py +14 -0
  197. google/adk/tests/integration/models/test_google_llm.py +65 -0
  198. google/adk/tests/integration/test_callback.py +70 -0
  199. google/adk/tests/integration/test_context_variable.py +67 -0
  200. google/adk/tests/integration/test_evalute_agent_in_fixture.py +76 -0
  201. google/adk/tests/integration/test_multi_agent.py +28 -0
  202. google/adk/tests/integration/test_multi_turn.py +42 -0
  203. google/adk/tests/integration/test_single_agent.py +23 -0
  204. google/adk/tests/integration/test_sub_agent.py +26 -0
  205. google/adk/tests/integration/test_system_instruction.py +177 -0
  206. google/adk/tests/integration/test_tools.py +287 -0
  207. google/adk/tests/integration/test_with_test_file.py +34 -0
  208. google/adk/tests/integration/tools/__init__.py +14 -0
  209. google/adk/tests/integration/utils/__init__.py +16 -0
  210. google/adk/tests/integration/utils/asserts.py +75 -0
  211. google/adk/tests/integration/utils/test_runner.py +97 -0
  212. google/adk/tests/unittests/__init__.py +14 -0
  213. google/adk/tests/unittests/agents/__init__.py +14 -0
  214. google/adk/tests/unittests/agents/test_base_agent.py +407 -0
  215. google/adk/tests/unittests/agents/test_langgraph_agent.py +191 -0
  216. google/adk/tests/unittests/agents/test_llm_agent_callbacks.py +138 -0
  217. google/adk/tests/unittests/agents/test_llm_agent_fields.py +231 -0
  218. google/adk/tests/unittests/agents/test_loop_agent.py +136 -0
  219. google/adk/tests/unittests/agents/test_parallel_agent.py +92 -0
  220. google/adk/tests/unittests/agents/test_sequential_agent.py +114 -0
  221. google/adk/tests/unittests/artifacts/__init__.py +14 -0
  222. google/adk/tests/unittests/artifacts/test_artifact_service.py +276 -0
  223. google/adk/tests/unittests/auth/test_auth_handler.py +575 -0
  224. google/adk/tests/unittests/conftest.py +73 -0
  225. google/adk/tests/unittests/fast_api/__init__.py +14 -0
  226. google/adk/tests/unittests/fast_api/test_fast_api.py +269 -0
  227. google/adk/tests/unittests/flows/__init__.py +14 -0
  228. google/adk/tests/unittests/flows/llm_flows/__init__.py +14 -0
  229. google/adk/tests/unittests/flows/llm_flows/_test_examples.py +142 -0
  230. google/adk/tests/unittests/flows/llm_flows/test_agent_transfer.py +311 -0
  231. google/adk/tests/unittests/flows/llm_flows/test_functions_long_running.py +244 -0
  232. google/adk/tests/unittests/flows/llm_flows/test_functions_request_euc.py +346 -0
  233. google/adk/tests/unittests/flows/llm_flows/test_functions_sequential.py +93 -0
  234. google/adk/tests/unittests/flows/llm_flows/test_functions_simple.py +258 -0
  235. google/adk/tests/unittests/flows/llm_flows/test_identity.py +66 -0
  236. google/adk/tests/unittests/flows/llm_flows/test_instructions.py +164 -0
  237. google/adk/tests/unittests/flows/llm_flows/test_model_callbacks.py +142 -0
  238. google/adk/tests/unittests/flows/llm_flows/test_other_configs.py +46 -0
  239. google/adk/tests/unittests/flows/llm_flows/test_tool_callbacks.py +269 -0
  240. google/adk/tests/unittests/models/__init__.py +14 -0
  241. google/adk/tests/unittests/models/test_google_llm.py +224 -0
  242. google/adk/tests/unittests/models/test_litellm.py +804 -0
  243. google/adk/tests/unittests/models/test_models.py +60 -0
  244. google/adk/tests/unittests/sessions/__init__.py +14 -0
  245. google/adk/tests/unittests/sessions/test_session_service.py +227 -0
  246. google/adk/tests/unittests/sessions/test_vertex_ai_session_service.py +246 -0
  247. google/adk/tests/unittests/streaming/__init__.py +14 -0
  248. google/adk/tests/unittests/streaming/test_streaming.py +50 -0
  249. google/adk/tests/unittests/tools/__init__.py +14 -0
  250. google/adk/tests/unittests/tools/apihub_tool/clients/test_apihub_client.py +499 -0
  251. google/adk/tests/unittests/tools/apihub_tool/test_apihub_toolset.py +204 -0
  252. google/adk/tests/unittests/tools/application_integration_tool/clients/test_connections_client.py +600 -0
  253. google/adk/tests/unittests/tools/application_integration_tool/clients/test_integration_client.py +630 -0
  254. google/adk/tests/unittests/tools/application_integration_tool/test_application_integration_toolset.py +345 -0
  255. google/adk/tests/unittests/tools/google_api_tool/__init__.py +13 -0
  256. google/adk/tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py +657 -0
  257. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_auto_auth_credential_exchanger.py +145 -0
  258. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_base_auth_credential_exchanger.py +68 -0
  259. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_oauth2_exchanger.py +153 -0
  260. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_service_account_exchanger.py +196 -0
  261. google/adk/tests/unittests/tools/openapi_tool/auth/test_auth_helper.py +573 -0
  262. google/adk/tests/unittests/tools/openapi_tool/common/test_common.py +436 -0
  263. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test.yaml +1367 -0
  264. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_openapi_spec_parser.py +628 -0
  265. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_openapi_toolset.py +139 -0
  266. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_operation_parser.py +406 -0
  267. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_rest_api_tool.py +966 -0
  268. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_tool_auth_handler.py +201 -0
  269. google/adk/tests/unittests/tools/retrieval/__init__.py +14 -0
  270. google/adk/tests/unittests/tools/retrieval/test_vertex_ai_rag_retrieval.py +147 -0
  271. google/adk/tests/unittests/tools/test_agent_tool.py +167 -0
  272. google/adk/tests/unittests/tools/test_base_tool.py +141 -0
  273. google/adk/tests/unittests/tools/test_build_function_declaration.py +277 -0
  274. google/adk/tests/unittests/utils.py +304 -0
  275. google/adk/tools/__init__.py +51 -0
  276. google/adk/tools/_automatic_function_calling_util.py +346 -0
  277. google/adk/tools/agent_tool.py +176 -0
  278. google/adk/tools/apihub_tool/__init__.py +19 -0
  279. google/adk/tools/apihub_tool/apihub_toolset.py +209 -0
  280. google/adk/tools/apihub_tool/clients/__init__.py +13 -0
  281. google/adk/tools/apihub_tool/clients/apihub_client.py +332 -0
  282. google/adk/tools/apihub_tool/clients/secret_client.py +115 -0
  283. google/adk/tools/application_integration_tool/__init__.py +19 -0
  284. google/adk/tools/application_integration_tool/application_integration_toolset.py +230 -0
  285. google/adk/tools/application_integration_tool/clients/connections_client.py +903 -0
  286. google/adk/tools/application_integration_tool/clients/integration_client.py +253 -0
  287. google/adk/tools/base_tool.py +144 -0
  288. google/adk/tools/built_in_code_execution_tool.py +59 -0
  289. google/adk/tools/crewai_tool.py +72 -0
  290. google/adk/tools/example_tool.py +62 -0
  291. google/adk/tools/exit_loop_tool.py +23 -0
  292. google/adk/tools/function_parameter_parse_util.py +307 -0
  293. google/adk/tools/function_tool.py +87 -0
  294. google/adk/tools/get_user_choice_tool.py +28 -0
  295. google/adk/tools/google_api_tool/__init__.py +14 -0
  296. google/adk/tools/google_api_tool/google_api_tool.py +59 -0
  297. google/adk/tools/google_api_tool/google_api_tool_set.py +107 -0
  298. google/adk/tools/google_api_tool/google_api_tool_sets.py +55 -0
  299. google/adk/tools/google_api_tool/googleapi_to_openapi_converter.py +521 -0
  300. google/adk/tools/google_search_tool.py +68 -0
  301. google/adk/tools/langchain_tool.py +86 -0
  302. google/adk/tools/load_artifacts_tool.py +113 -0
  303. google/adk/tools/load_memory_tool.py +58 -0
  304. google/adk/tools/load_web_page.py +41 -0
  305. google/adk/tools/long_running_tool.py +39 -0
  306. google/adk/tools/mcp_tool/__init__.py +42 -0
  307. google/adk/tools/mcp_tool/conversion_utils.py +161 -0
  308. google/adk/tools/mcp_tool/mcp_tool.py +113 -0
  309. google/adk/tools/mcp_tool/mcp_toolset.py +272 -0
  310. google/adk/tools/openapi_tool/__init__.py +21 -0
  311. google/adk/tools/openapi_tool/auth/__init__.py +19 -0
  312. google/adk/tools/openapi_tool/auth/auth_helpers.py +498 -0
  313. google/adk/tools/openapi_tool/auth/credential_exchangers/__init__.py +25 -0
  314. google/adk/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.py +105 -0
  315. google/adk/tools/openapi_tool/auth/credential_exchangers/base_credential_exchanger.py +55 -0
  316. google/adk/tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.py +117 -0
  317. google/adk/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.py +97 -0
  318. google/adk/tools/openapi_tool/common/__init__.py +19 -0
  319. google/adk/tools/openapi_tool/common/common.py +300 -0
  320. google/adk/tools/openapi_tool/openapi_spec_parser/__init__.py +32 -0
  321. google/adk/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.py +231 -0
  322. google/adk/tools/openapi_tool/openapi_spec_parser/openapi_toolset.py +144 -0
  323. google/adk/tools/openapi_tool/openapi_spec_parser/operation_parser.py +260 -0
  324. google/adk/tools/openapi_tool/openapi_spec_parser/rest_api_tool.py +496 -0
  325. google/adk/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.py +268 -0
  326. google/adk/tools/preload_memory_tool.py +72 -0
  327. google/adk/tools/retrieval/__init__.py +36 -0
  328. google/adk/tools/retrieval/base_retrieval_tool.py +37 -0
  329. google/adk/tools/retrieval/files_retrieval.py +33 -0
  330. google/adk/tools/retrieval/llama_index_retrieval.py +41 -0
  331. google/adk/tools/retrieval/vertex_ai_rag_retrieval.py +107 -0
  332. google/adk/tools/tool_context.py +90 -0
  333. google/adk/tools/toolbox_tool.py +46 -0
  334. google/adk/tools/transfer_to_agent_tool.py +21 -0
  335. google/adk/tools/vertex_ai_search_tool.py +96 -0
  336. google/adk/version.py +16 -0
  337. google_adk-0.0.3.dist-info/METADATA +73 -0
  338. google_adk-0.0.3.dist-info/RECORD +340 -0
  339. {google_adk-0.0.1.dist-info → google_adk-0.0.3.dist-info}/WHEEL +1 -2
  340. google_adk-0.0.3.dist-info/entry_points.txt +3 -0
  341. agent_kit/__init__.py +0 -0
  342. google_adk-0.0.1.dist-info/LICENSE.txt +0 -170
  343. google_adk-0.0.1.dist-info/METADATA +0 -15
  344. google_adk-0.0.1.dist-info/RECORD +0 -6
  345. google_adk-0.0.1.dist-info/top_level.txt +0 -1
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Copyright 2025 Google LLC
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+
17
+ /*
18
+ This CSS file should be overridden by the theme authors. It's
19
+ meant for debugging and developing the skeleton that this theme provides.
20
+ */
21
+ body {
22
+ font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif,
23
+ "Apple Color Emoji", "Segoe UI Emoji";
24
+ background: lavender;
25
+ }
26
+ .sb-announcement {
27
+ background: rgb(131, 131, 131);
28
+ }
29
+ .sb-announcement__inner {
30
+ background: black;
31
+ color: white;
32
+ }
33
+ .sb-header {
34
+ background: lightskyblue;
35
+ }
36
+ .sb-header__inner {
37
+ background: royalblue;
38
+ color: white;
39
+ }
40
+ .sb-header-secondary {
41
+ background: lightcyan;
42
+ }
43
+ .sb-header-secondary__inner {
44
+ background: cornflowerblue;
45
+ color: white;
46
+ }
47
+ .sb-sidebar-primary {
48
+ background: lightgreen;
49
+ }
50
+ .sb-main {
51
+ background: blanchedalmond;
52
+ }
53
+ .sb-main__inner {
54
+ background: antiquewhite;
55
+ }
56
+ .sb-header-article {
57
+ background: lightsteelblue;
58
+ }
59
+ .sb-article-container {
60
+ background: snow;
61
+ }
62
+ .sb-article-main {
63
+ background: white;
64
+ }
65
+ .sb-footer-article {
66
+ background: lightpink;
67
+ }
68
+ .sb-sidebar-secondary {
69
+ background: lightgoldenrodyellow;
70
+ }
71
+ .sb-footer-content {
72
+ background: plum;
73
+ }
74
+ .sb-footer-content__inner {
75
+ background: palevioletred;
76
+ }
77
+ .sb-footer {
78
+ background: pink;
79
+ }
80
+ .sb-footer__inner {
81
+ background: salmon;
82
+ }
83
+ .sb-article {
84
+ background: white;
85
+ }
@@ -0,0 +1,156 @@
1
+ /*
2
+ * doctools.js
3
+ * ~~~~~~~~~~~
4
+ *
5
+ * Base JavaScript utilities for all Sphinx HTML documentation.
6
+ *
7
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
8
+ * :license: BSD, see LICENSE for details.
9
+ *
10
+ */
11
+ "use strict";
12
+
13
+ const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([
14
+ "TEXTAREA",
15
+ "INPUT",
16
+ "SELECT",
17
+ "BUTTON",
18
+ ]);
19
+
20
+ const _ready = (callback) => {
21
+ if (document.readyState !== "loading") {
22
+ callback();
23
+ } else {
24
+ document.addEventListener("DOMContentLoaded", callback);
25
+ }
26
+ };
27
+
28
+ /**
29
+ * Small JavaScript module for the documentation.
30
+ */
31
+ const Documentation = {
32
+ init: () => {
33
+ Documentation.initDomainIndexTable();
34
+ Documentation.initOnKeyListeners();
35
+ },
36
+
37
+ /**
38
+ * i18n support
39
+ */
40
+ TRANSLATIONS: {},
41
+ PLURAL_EXPR: (n) => (n === 1 ? 0 : 1),
42
+ LOCALE: "unknown",
43
+
44
+ // gettext and ngettext don't access this so that the functions
45
+ // can safely bound to a different name (_ = Documentation.gettext)
46
+ gettext: (string) => {
47
+ const translated = Documentation.TRANSLATIONS[string];
48
+ switch (typeof translated) {
49
+ case "undefined":
50
+ return string; // no translation
51
+ case "string":
52
+ return translated; // translation exists
53
+ default:
54
+ return translated[0]; // (singular, plural) translation tuple exists
55
+ }
56
+ },
57
+
58
+ ngettext: (singular, plural, n) => {
59
+ const translated = Documentation.TRANSLATIONS[singular];
60
+ if (typeof translated !== "undefined")
61
+ return translated[Documentation.PLURAL_EXPR(n)];
62
+ return n === 1 ? singular : plural;
63
+ },
64
+
65
+ addTranslations: (catalog) => {
66
+ Object.assign(Documentation.TRANSLATIONS, catalog.messages);
67
+ Documentation.PLURAL_EXPR = new Function(
68
+ "n",
69
+ `return (${catalog.plural_expr})`
70
+ );
71
+ Documentation.LOCALE = catalog.locale;
72
+ },
73
+
74
+ /**
75
+ * helper function to focus on search bar
76
+ */
77
+ focusSearchBar: () => {
78
+ document.querySelectorAll("input[name=q]")[0]?.focus();
79
+ },
80
+
81
+ /**
82
+ * Initialise the domain index toggle buttons
83
+ */
84
+ initDomainIndexTable: () => {
85
+ const toggler = (el) => {
86
+ const idNumber = el.id.substr(7);
87
+ const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`);
88
+ if (el.src.substr(-9) === "minus.png") {
89
+ el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`;
90
+ toggledRows.forEach((el) => (el.style.display = "none"));
91
+ } else {
92
+ el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`;
93
+ toggledRows.forEach((el) => (el.style.display = ""));
94
+ }
95
+ };
96
+
97
+ const togglerElements = document.querySelectorAll("img.toggler");
98
+ togglerElements.forEach((el) =>
99
+ el.addEventListener("click", (event) => toggler(event.currentTarget))
100
+ );
101
+ togglerElements.forEach((el) => (el.style.display = ""));
102
+ if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler);
103
+ },
104
+
105
+ initOnKeyListeners: () => {
106
+ // only install a listener if it is really needed
107
+ if (
108
+ !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
109
+ !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS
110
+ )
111
+ return;
112
+
113
+ document.addEventListener("keydown", (event) => {
114
+ // bail for input elements
115
+ if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
116
+ // bail with special keys
117
+ if (event.altKey || event.ctrlKey || event.metaKey) return;
118
+
119
+ if (!event.shiftKey) {
120
+ switch (event.key) {
121
+ case "ArrowLeft":
122
+ if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
123
+
124
+ const prevLink = document.querySelector('link[rel="prev"]');
125
+ if (prevLink && prevLink.href) {
126
+ window.location.href = prevLink.href;
127
+ event.preventDefault();
128
+ }
129
+ break;
130
+ case "ArrowRight":
131
+ if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
132
+
133
+ const nextLink = document.querySelector('link[rel="next"]');
134
+ if (nextLink && nextLink.href) {
135
+ window.location.href = nextLink.href;
136
+ event.preventDefault();
137
+ }
138
+ break;
139
+ }
140
+ }
141
+
142
+ // some keyboard layouts may need Shift to get /
143
+ switch (event.key) {
144
+ case "/":
145
+ if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break;
146
+ Documentation.focusSearchBar();
147
+ event.preventDefault();
148
+ }
149
+ });
150
+ },
151
+ };
152
+
153
+ // quick alias for translations
154
+ const _ = Documentation.gettext;
155
+
156
+ _ready(Documentation.init);
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Copyright 2025 Google LLC
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+
17
+ const DOCUMENTATION_OPTIONS = {
18
+ VERSION: '',
19
+ LANGUAGE: 'en',
20
+ COLLAPSE_INDEX: false,
21
+ BUILDER: 'html',
22
+ FILE_SUFFIX: '.html',
23
+ LINK_SUFFIX: '.html',
24
+ HAS_SOURCE: true,
25
+ SOURCELINK_SUFFIX: '.txt',
26
+ NAVIGATION_WITH_KEYS: false,
27
+ SHOW_SEARCH_SUMMARY: true,
28
+ ENABLE_SEARCH_SHORTCUTS: true,
29
+ };
@@ -0,0 +1,199 @@
1
+ /*
2
+ * language_data.js
3
+ * ~~~~~~~~~~~~~~~~
4
+ *
5
+ * This script contains the language-specific data used by searchtools.js,
6
+ * namely the list of stopwords, stemmer, scorer and splitter.
7
+ *
8
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
9
+ * :license: BSD, see LICENSE for details.
10
+ *
11
+ */
12
+
13
+ var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"];
14
+
15
+
16
+ /* Non-minified version is copied as a separate JS file, if available */
17
+
18
+ /**
19
+ * Porter Stemmer
20
+ */
21
+ var Stemmer = function() {
22
+
23
+ var step2list = {
24
+ ational: 'ate',
25
+ tional: 'tion',
26
+ enci: 'ence',
27
+ anci: 'ance',
28
+ izer: 'ize',
29
+ bli: 'ble',
30
+ alli: 'al',
31
+ entli: 'ent',
32
+ eli: 'e',
33
+ ousli: 'ous',
34
+ ization: 'ize',
35
+ ation: 'ate',
36
+ ator: 'ate',
37
+ alism: 'al',
38
+ iveness: 'ive',
39
+ fulness: 'ful',
40
+ ousness: 'ous',
41
+ aliti: 'al',
42
+ iviti: 'ive',
43
+ biliti: 'ble',
44
+ logi: 'log'
45
+ };
46
+
47
+ var step3list = {
48
+ icate: 'ic',
49
+ ative: '',
50
+ alize: 'al',
51
+ iciti: 'ic',
52
+ ical: 'ic',
53
+ ful: '',
54
+ ness: ''
55
+ };
56
+
57
+ var c = "[^aeiou]"; // consonant
58
+ var v = "[aeiouy]"; // vowel
59
+ var C = c + "[^aeiouy]*"; // consonant sequence
60
+ var V = v + "[aeiou]*"; // vowel sequence
61
+
62
+ var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0
63
+ var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
64
+ var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
65
+ var s_v = "^(" + C + ")?" + v; // vowel in stem
66
+
67
+ this.stemWord = function (w) {
68
+ var stem;
69
+ var suffix;
70
+ var firstch;
71
+ var origword = w;
72
+
73
+ if (w.length < 3)
74
+ return w;
75
+
76
+ var re;
77
+ var re2;
78
+ var re3;
79
+ var re4;
80
+
81
+ firstch = w.substr(0,1);
82
+ if (firstch == "y")
83
+ w = firstch.toUpperCase() + w.substr(1);
84
+
85
+ // Step 1a
86
+ re = /^(.+?)(ss|i)es$/;
87
+ re2 = /^(.+?)([^s])s$/;
88
+
89
+ if (re.test(w))
90
+ w = w.replace(re,"$1$2");
91
+ else if (re2.test(w))
92
+ w = w.replace(re2,"$1$2");
93
+
94
+ // Step 1b
95
+ re = /^(.+?)eed$/;
96
+ re2 = /^(.+?)(ed|ing)$/;
97
+ if (re.test(w)) {
98
+ var fp = re.exec(w);
99
+ re = new RegExp(mgr0);
100
+ if (re.test(fp[1])) {
101
+ re = /.$/;
102
+ w = w.replace(re,"");
103
+ }
104
+ }
105
+ else if (re2.test(w)) {
106
+ var fp = re2.exec(w);
107
+ stem = fp[1];
108
+ re2 = new RegExp(s_v);
109
+ if (re2.test(stem)) {
110
+ w = stem;
111
+ re2 = /(at|bl|iz)$/;
112
+ re3 = new RegExp("([^aeiouylsz])\\1$");
113
+ re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
114
+ if (re2.test(w))
115
+ w = w + "e";
116
+ else if (re3.test(w)) {
117
+ re = /.$/;
118
+ w = w.replace(re,"");
119
+ }
120
+ else if (re4.test(w))
121
+ w = w + "e";
122
+ }
123
+ }
124
+
125
+ // Step 1c
126
+ re = /^(.+?)y$/;
127
+ if (re.test(w)) {
128
+ var fp = re.exec(w);
129
+ stem = fp[1];
130
+ re = new RegExp(s_v);
131
+ if (re.test(stem))
132
+ w = stem + "i";
133
+ }
134
+
135
+ // Step 2
136
+ re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
137
+ if (re.test(w)) {
138
+ var fp = re.exec(w);
139
+ stem = fp[1];
140
+ suffix = fp[2];
141
+ re = new RegExp(mgr0);
142
+ if (re.test(stem))
143
+ w = stem + step2list[suffix];
144
+ }
145
+
146
+ // Step 3
147
+ re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
148
+ if (re.test(w)) {
149
+ var fp = re.exec(w);
150
+ stem = fp[1];
151
+ suffix = fp[2];
152
+ re = new RegExp(mgr0);
153
+ if (re.test(stem))
154
+ w = stem + step3list[suffix];
155
+ }
156
+
157
+ // Step 4
158
+ re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
159
+ re2 = /^(.+?)(s|t)(ion)$/;
160
+ if (re.test(w)) {
161
+ var fp = re.exec(w);
162
+ stem = fp[1];
163
+ re = new RegExp(mgr1);
164
+ if (re.test(stem))
165
+ w = stem;
166
+ }
167
+ else if (re2.test(w)) {
168
+ var fp = re2.exec(w);
169
+ stem = fp[1] + fp[2];
170
+ re2 = new RegExp(mgr1);
171
+ if (re2.test(stem))
172
+ w = stem;
173
+ }
174
+
175
+ // Step 5
176
+ re = /^(.+?)e$/;
177
+ if (re.test(w)) {
178
+ var fp = re.exec(w);
179
+ stem = fp[1];
180
+ re = new RegExp(mgr1);
181
+ re2 = new RegExp(meq1);
182
+ re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
183
+ if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
184
+ w = stem;
185
+ }
186
+ re = /ll$/;
187
+ re2 = new RegExp(mgr1);
188
+ if (re.test(w) && re2.test(w)) {
189
+ re = /.$/;
190
+ w = w.replace(re,"");
191
+ }
192
+
193
+ // and turn initial Y back to y
194
+ if (firstch == "y")
195
+ w = firstch.toLowerCase() + w.substr(1);
196
+ return w;
197
+ }
198
+ }
199
+