@google/adk 0.6.1 → 1.0.0

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 (402) hide show
  1. package/dist/cjs/agents/base_agent.js +11 -2
  2. package/dist/cjs/agents/context.js +1 -0
  3. package/dist/cjs/agents/functions.js +1 -0
  4. package/dist/cjs/agents/invocation_context.js +1 -0
  5. package/dist/cjs/agents/llm_agent.js +70 -13
  6. package/dist/cjs/agents/loop_agent.js +4 -0
  7. package/dist/cjs/agents/parallel_agent.js +4 -0
  8. package/dist/cjs/agents/processors/code_execution_request_processor.js +2 -0
  9. package/dist/cjs/agents/processors/context_compactor_request_processor.js +9 -0
  10. package/dist/cjs/agents/processors/tool_filter_request_processor.js +73 -0
  11. package/dist/cjs/agents/routed_agent.js +97 -0
  12. package/dist/cjs/auth/auth_handler.js +66 -1
  13. package/dist/cjs/auth/auth_preprocessor.js +178 -0
  14. package/dist/cjs/auth/auth_provider_registry.js +61 -0
  15. package/dist/cjs/auth/base_auth_provider.js +27 -0
  16. package/dist/cjs/auth/credential_service/session_state_credential_service.js +51 -0
  17. package/dist/cjs/auth/oauth2/oauth2_credential_exchanger.js +198 -0
  18. package/dist/cjs/auth/oauth2/oauth2_credential_refresher.js +109 -0
  19. package/dist/cjs/auth/oauth2/oauth2_discovery.js +186 -0
  20. package/dist/cjs/auth/oauth2/oauth2_utils.js +119 -0
  21. package/dist/cjs/auth/refresher/base_credential_refresher.js +44 -0
  22. package/dist/cjs/auth/refresher/credential_refresher_registry.js +68 -0
  23. package/dist/cjs/code_executors/base_code_executor.js +9 -5
  24. package/dist/cjs/code_executors/code_execution_utils.js +19 -0
  25. package/dist/cjs/code_executors/unsafe_local_code_executor.js +241 -0
  26. package/dist/cjs/common.js +61 -0
  27. package/dist/cjs/features/feature_registry.js +141 -0
  28. package/dist/cjs/index.js +32 -20
  29. package/dist/cjs/index.js.map +4 -4
  30. package/dist/cjs/models/apigee_llm.js +2 -2
  31. package/dist/cjs/models/google_llm.js +18 -53
  32. package/dist/cjs/models/routed_llm.js +99 -0
  33. package/dist/cjs/plugins/base_plugin.js +39 -2
  34. package/dist/cjs/plugins/plugin_manager.js +39 -0
  35. package/dist/cjs/runner/runner.js +31 -3
  36. package/dist/cjs/sessions/db/operations.js +3 -10
  37. package/dist/cjs/skills/loader.js +283 -0
  38. package/dist/cjs/skills/prompt.js +58 -0
  39. package/dist/cjs/skills/skill.js +78 -0
  40. package/dist/cjs/tools/agent_tool.js +10 -3
  41. package/dist/cjs/tools/mcp/mcp_tool.js +4 -1
  42. package/dist/cjs/tools/skill/list_skills_tool.js +76 -0
  43. package/dist/cjs/tools/skill/load_skill_resource_tool.js +225 -0
  44. package/dist/cjs/tools/skill/load_skill_tool.js +108 -0
  45. package/dist/cjs/tools/skill/run_skill_inline_script_tool.js +146 -0
  46. package/dist/cjs/tools/skill/run_skill_script_tool.js +224 -0
  47. package/dist/cjs/tools/skill/skill_toolset.js +163 -0
  48. package/dist/cjs/utils/experimental.js +74 -0
  49. package/dist/cjs/utils/failover_utils.js +93 -0
  50. package/dist/cjs/utils/file_extension_utils.js +77 -0
  51. package/dist/cjs/utils/file_utils.js +94 -0
  52. package/dist/cjs/utils/streaming_utils.js +333 -0
  53. package/dist/cjs/version.js +1 -1
  54. package/dist/esm/a2a/a2a_event.js +2 -0
  55. package/dist/esm/a2a/a2a_remote_agent.js +2 -0
  56. package/dist/esm/a2a/a2a_remote_agent_run_processor.js +2 -0
  57. package/dist/esm/a2a/a2a_remote_agent_utils.js +2 -0
  58. package/dist/esm/a2a/agent_card.js +2 -0
  59. package/dist/esm/a2a/agent_executor.js +2 -0
  60. package/dist/esm/a2a/agent_to_a2a.js +2 -0
  61. package/dist/esm/a2a/event_converter_utils.js +2 -0
  62. package/dist/esm/a2a/event_processor_utils.js +2 -0
  63. package/dist/esm/a2a/executor_context.js +2 -0
  64. package/dist/esm/a2a/metadata_converter_utils.js +2 -0
  65. package/dist/esm/a2a/part_converter_utils.js +2 -0
  66. package/dist/esm/agents/active_streaming_tool.js +2 -0
  67. package/dist/esm/agents/base_agent.js +13 -2
  68. package/dist/esm/agents/context.js +3 -0
  69. package/dist/esm/agents/functions.js +3 -0
  70. package/dist/esm/agents/instructions.js +2 -0
  71. package/dist/esm/agents/invocation_context.js +3 -0
  72. package/dist/esm/agents/live_request_queue.js +2 -0
  73. package/dist/esm/agents/llm_agent.js +72 -13
  74. package/dist/esm/agents/loop_agent.js +6 -0
  75. package/dist/esm/agents/parallel_agent.js +6 -0
  76. package/dist/esm/agents/processors/agent_transfer_llm_request_processor.js +2 -0
  77. package/dist/esm/agents/processors/base_llm_processor.js +2 -0
  78. package/dist/esm/agents/processors/basic_llm_request_processor.js +2 -0
  79. package/dist/esm/agents/processors/code_execution_request_processor.js +5 -0
  80. package/dist/esm/agents/processors/content_processor_utils.js +2 -0
  81. package/dist/esm/agents/processors/content_request_processor.js +2 -0
  82. package/dist/esm/agents/processors/context_compactor_request_processor.js +11 -0
  83. package/dist/esm/agents/processors/identity_llm_request_processor.js +2 -0
  84. package/dist/esm/agents/processors/instructions_llm_request_processor.js +2 -0
  85. package/dist/esm/agents/processors/request_confirmation_llm_request_processor.js +2 -0
  86. package/dist/esm/agents/processors/tool_filter_request_processor.js +44 -0
  87. package/dist/esm/agents/readonly_context.js +2 -0
  88. package/dist/esm/agents/routed_agent.js +70 -0
  89. package/dist/esm/agents/run_config.js +2 -0
  90. package/dist/esm/agents/sequential_agent.js +2 -0
  91. package/dist/esm/agents/transcription_entry.js +2 -0
  92. package/dist/esm/artifacts/base_artifact_service.js +2 -0
  93. package/dist/esm/artifacts/file_artifact_service.js +2 -0
  94. package/dist/esm/artifacts/gcs_artifact_service.js +2 -0
  95. package/dist/esm/artifacts/in_memory_artifact_service.js +2 -0
  96. package/dist/esm/artifacts/registry.js +2 -0
  97. package/dist/esm/auth/auth_credential.js +2 -0
  98. package/dist/esm/auth/auth_handler.js +68 -1
  99. package/dist/esm/auth/auth_preprocessor.js +155 -0
  100. package/dist/esm/auth/auth_provider_registry.js +33 -0
  101. package/dist/esm/auth/auth_schemes.js +2 -0
  102. package/dist/esm/auth/auth_tool.js +2 -0
  103. package/dist/esm/auth/base_auth_provider.js +7 -0
  104. package/dist/esm/auth/credential_service/base_credential_service.js +2 -0
  105. package/dist/esm/auth/credential_service/in_memory_credential_service.js +2 -0
  106. package/dist/esm/auth/credential_service/session_state_credential_service.js +23 -0
  107. package/dist/esm/auth/exchanger/base_credential_exchanger.js +2 -0
  108. package/dist/esm/auth/exchanger/credential_exchanger_registry.js +2 -0
  109. package/dist/esm/auth/oauth2/oauth2_credential_exchanger.js +177 -0
  110. package/dist/esm/auth/oauth2/oauth2_credential_refresher.js +85 -0
  111. package/dist/esm/auth/oauth2/oauth2_discovery.js +156 -0
  112. package/dist/esm/auth/oauth2/oauth2_utils.js +87 -0
  113. package/dist/esm/auth/refresher/base_credential_refresher.js +16 -0
  114. package/dist/esm/auth/refresher/credential_refresher_registry.js +40 -0
  115. package/dist/esm/code_executors/base_code_executor.js +11 -5
  116. package/dist/esm/code_executors/built_in_code_executor.js +2 -0
  117. package/dist/esm/code_executors/code_execution_utils.js +19 -0
  118. package/dist/esm/code_executors/code_executor_context.js +2 -0
  119. package/dist/esm/code_executors/unsafe_local_code_executor.js +205 -0
  120. package/dist/esm/common.js +47 -3
  121. package/dist/esm/context/base_context_compactor.js +2 -0
  122. package/dist/esm/context/summarizers/base_summarizer.js +2 -0
  123. package/dist/esm/context/summarizers/llm_summarizer.js +2 -0
  124. package/dist/esm/context/token_based_context_compactor.js +2 -0
  125. package/dist/esm/context/truncating_context_compactor.js +2 -0
  126. package/dist/esm/events/compacted_event.js +2 -0
  127. package/dist/esm/events/event.js +2 -0
  128. package/dist/esm/events/event_actions.js +2 -0
  129. package/dist/esm/events/structured_events.js +2 -0
  130. package/dist/esm/examples/base_example_provider.js +2 -0
  131. package/dist/esm/examples/example.js +2 -0
  132. package/dist/esm/examples/example_util.js +2 -0
  133. package/dist/esm/features/feature_registry.js +107 -0
  134. package/dist/esm/index.js +34 -21
  135. package/dist/esm/index.js.map +4 -4
  136. package/dist/esm/index_web.js +2 -0
  137. package/dist/esm/memory/base_memory_service.js +2 -0
  138. package/dist/esm/memory/in_memory_memory_service.js +2 -0
  139. package/dist/esm/memory/memory_entry.js +2 -0
  140. package/dist/esm/models/apigee_llm.js +4 -2
  141. package/dist/esm/models/base_llm.js +2 -0
  142. package/dist/esm/models/base_llm_connection.js +2 -0
  143. package/dist/esm/models/gemini_llm_connection.js +2 -0
  144. package/dist/esm/models/google_llm.js +20 -54
  145. package/dist/esm/models/llm_request.js +2 -0
  146. package/dist/esm/models/llm_response.js +2 -0
  147. package/dist/esm/models/registry.js +2 -0
  148. package/dist/esm/models/routed_llm.js +73 -0
  149. package/dist/esm/plugins/base_plugin.js +41 -1
  150. package/dist/esm/plugins/logging_plugin.js +2 -0
  151. package/dist/esm/plugins/plugin_manager.js +41 -0
  152. package/dist/esm/plugins/security_plugin.js +2 -0
  153. package/dist/esm/runner/in_memory_runner.js +2 -0
  154. package/dist/esm/runner/runner.js +33 -3
  155. package/dist/esm/sessions/base_session_service.js +2 -0
  156. package/dist/esm/sessions/database_session_service.js +2 -0
  157. package/dist/esm/sessions/db/operations.js +5 -10
  158. package/dist/esm/sessions/db/schema.js +2 -0
  159. package/dist/esm/sessions/in_memory_session_service.js +2 -0
  160. package/dist/esm/sessions/registry.js +2 -0
  161. package/dist/esm/sessions/session.js +2 -0
  162. package/dist/esm/sessions/state.js +2 -0
  163. package/dist/esm/skills/loader.js +244 -0
  164. package/dist/esm/skills/prompt.js +30 -0
  165. package/dist/esm/skills/skill.js +49 -0
  166. package/dist/esm/telemetry/google_cloud.js +2 -0
  167. package/dist/esm/telemetry/setup.js +2 -0
  168. package/dist/esm/telemetry/tracing.js +2 -0
  169. package/dist/esm/tools/agent_tool.js +12 -3
  170. package/dist/esm/tools/base_tool.js +2 -0
  171. package/dist/esm/tools/base_toolset.js +2 -0
  172. package/dist/esm/tools/exit_loop_tool.js +2 -0
  173. package/dist/esm/tools/forwarding_artifact_service.js +2 -0
  174. package/dist/esm/tools/function_tool.js +2 -0
  175. package/dist/esm/tools/google_search_tool.js +2 -0
  176. package/dist/esm/tools/load_artifacts_tool.js +2 -0
  177. package/dist/esm/tools/load_memory_tool.js +2 -0
  178. package/dist/esm/tools/long_running_tool.js +2 -0
  179. package/dist/esm/tools/mcp/mcp_session_manager.js +2 -0
  180. package/dist/esm/tools/mcp/mcp_tool.js +6 -1
  181. package/dist/esm/tools/mcp/mcp_toolset.js +2 -0
  182. package/dist/esm/tools/preload_memory_tool.js +2 -0
  183. package/dist/esm/tools/skill/list_skills_tool.js +50 -0
  184. package/dist/esm/tools/skill/load_skill_resource_tool.js +191 -0
  185. package/dist/esm/tools/skill/load_skill_tool.js +82 -0
  186. package/dist/esm/tools/skill/run_skill_inline_script_tool.js +120 -0
  187. package/dist/esm/tools/skill/run_skill_script_tool.js +192 -0
  188. package/dist/esm/tools/skill/skill_toolset.js +137 -0
  189. package/dist/esm/tools/tool_confirmation.js +2 -0
  190. package/dist/esm/utils/client_labels.js +2 -0
  191. package/dist/esm/utils/env_aware_utils.js +2 -0
  192. package/dist/esm/utils/experimental.js +46 -0
  193. package/dist/esm/utils/failover_utils.js +65 -0
  194. package/dist/esm/utils/file_extension_utils.js +51 -0
  195. package/dist/esm/utils/file_utils.js +56 -0
  196. package/dist/esm/utils/gemini_schema_util.js +2 -0
  197. package/dist/esm/utils/logger.js +2 -0
  198. package/dist/esm/utils/model_name.js +2 -0
  199. package/dist/esm/utils/object_notation_utils.js +2 -0
  200. package/dist/esm/utils/simple_zod_to_json.js +2 -0
  201. package/dist/esm/utils/streaming_utils.js +307 -0
  202. package/dist/esm/utils/variant_utils.js +2 -0
  203. package/dist/esm/version.js +3 -1
  204. package/dist/types/agents/context.d.ts +1 -0
  205. package/dist/types/agents/invocation_context.d.ts +5 -0
  206. package/dist/types/agents/processors/tool_filter_request_processor.d.ts +14 -0
  207. package/dist/types/agents/routed_agent.d.ts +59 -0
  208. package/dist/types/auth/auth_credential.d.ts +17 -0
  209. package/dist/types/auth/auth_handler.d.ts +1 -0
  210. package/dist/types/auth/auth_preprocessor.d.ts +12 -0
  211. package/dist/types/auth/auth_provider_registry.d.ts +27 -0
  212. package/dist/types/auth/base_auth_provider.d.ts +20 -0
  213. package/dist/types/auth/credential_service/session_state_credential_service.d.ts +20 -0
  214. package/dist/types/auth/exchanger/base_credential_exchanger.d.ts +12 -5
  215. package/dist/types/auth/oauth2/oauth2_credential_exchanger.d.ts +26 -0
  216. package/dist/types/auth/oauth2/oauth2_credential_refresher.d.ts +29 -0
  217. package/dist/types/auth/oauth2/oauth2_discovery.d.ts +38 -0
  218. package/dist/types/auth/oauth2/oauth2_utils.d.ts +56 -0
  219. package/dist/types/auth/refresher/base_credential_refresher.d.ts +38 -0
  220. package/dist/types/auth/refresher/credential_refresher_registry.d.ts +27 -0
  221. package/dist/types/code_executors/base_code_executor.d.ts +4 -4
  222. package/dist/types/code_executors/code_execution_utils.d.ts +29 -1
  223. package/dist/types/code_executors/unsafe_local_code_executor.d.ts +48 -0
  224. package/dist/types/common.d.ts +26 -3
  225. package/dist/types/features/feature_registry.d.ts +66 -0
  226. package/dist/types/index.d.ts +4 -0
  227. package/dist/types/memory/base_memory_service.d.ts +6 -0
  228. package/dist/types/memory/memory_entry.d.ts +11 -5
  229. package/dist/types/models/apigee_llm.d.ts +1 -1
  230. package/dist/types/models/base_llm.d.ts +1 -1
  231. package/dist/types/models/google_llm.d.ts +1 -1
  232. package/dist/types/models/llm_request.d.ts +4 -0
  233. package/dist/types/models/routed_llm.d.ts +38 -0
  234. package/dist/types/plugins/base_plugin.d.ts +49 -0
  235. package/dist/types/plugins/plugin_manager.d.ts +22 -1
  236. package/dist/types/runner/runner.d.ts +1 -0
  237. package/dist/types/skills/loader.d.ts +38 -0
  238. package/dist/types/skills/prompt.d.ts +13 -0
  239. package/dist/types/skills/skill.d.ts +48 -0
  240. package/dist/types/tools/skill/list_skills_tool.d.ts +14 -0
  241. package/dist/types/tools/skill/load_skill_resource_tool.d.ts +15 -0
  242. package/dist/types/tools/skill/load_skill_tool.d.ts +14 -0
  243. package/dist/types/tools/skill/run_skill_inline_script_tool.d.ts +14 -0
  244. package/dist/types/tools/skill/run_skill_script_tool.d.ts +17 -0
  245. package/dist/types/tools/skill/skill_toolset.d.ts +28 -0
  246. package/dist/types/utils/experimental.d.ts +11 -0
  247. package/dist/types/utils/failover_utils.d.ts +17 -0
  248. package/dist/types/utils/file_extension_utils.d.ts +21 -0
  249. package/dist/types/utils/file_utils.d.ts +11 -0
  250. package/dist/types/utils/streaming_utils.d.ts +40 -0
  251. package/dist/types/version.d.ts +1 -1
  252. package/dist/web/a2a/a2a_event.js +2 -0
  253. package/dist/web/a2a/a2a_remote_agent.js +2 -0
  254. package/dist/web/a2a/a2a_remote_agent_run_processor.js +2 -0
  255. package/dist/web/a2a/a2a_remote_agent_utils.js +2 -0
  256. package/dist/web/a2a/agent_card.js +2 -0
  257. package/dist/web/a2a/agent_executor.js +2 -0
  258. package/dist/web/a2a/agent_to_a2a.js +2 -0
  259. package/dist/web/a2a/event_converter_utils.js +2 -0
  260. package/dist/web/a2a/event_processor_utils.js +2 -0
  261. package/dist/web/a2a/executor_context.js +2 -0
  262. package/dist/web/a2a/metadata_converter_utils.js +2 -0
  263. package/dist/web/a2a/part_converter_utils.js +2 -0
  264. package/dist/web/agents/active_streaming_tool.js +2 -0
  265. package/dist/web/agents/base_agent.js +13 -2
  266. package/dist/web/agents/context.js +3 -0
  267. package/dist/web/agents/functions.js +3 -0
  268. package/dist/web/agents/instructions.js +2 -0
  269. package/dist/web/agents/invocation_context.js +3 -0
  270. package/dist/web/agents/live_request_queue.js +2 -0
  271. package/dist/web/agents/llm_agent.js +72 -13
  272. package/dist/web/agents/loop_agent.js +6 -0
  273. package/dist/web/agents/parallel_agent.js +6 -0
  274. package/dist/web/agents/processors/agent_transfer_llm_request_processor.js +2 -0
  275. package/dist/web/agents/processors/base_llm_processor.js +2 -0
  276. package/dist/web/agents/processors/basic_llm_request_processor.js +2 -0
  277. package/dist/web/agents/processors/code_execution_request_processor.js +5 -0
  278. package/dist/web/agents/processors/content_processor_utils.js +2 -0
  279. package/dist/web/agents/processors/content_request_processor.js +2 -0
  280. package/dist/web/agents/processors/context_compactor_request_processor.js +11 -0
  281. package/dist/web/agents/processors/identity_llm_request_processor.js +2 -0
  282. package/dist/web/agents/processors/instructions_llm_request_processor.js +2 -0
  283. package/dist/web/agents/processors/request_confirmation_llm_request_processor.js +2 -0
  284. package/dist/web/agents/processors/tool_filter_request_processor.js +62 -0
  285. package/dist/web/agents/readonly_context.js +2 -0
  286. package/dist/web/agents/routed_agent.js +138 -0
  287. package/dist/web/agents/run_config.js +2 -0
  288. package/dist/web/agents/sequential_agent.js +2 -0
  289. package/dist/web/agents/transcription_entry.js +2 -0
  290. package/dist/web/artifacts/base_artifact_service.js +2 -0
  291. package/dist/web/artifacts/file_artifact_service.js +2 -0
  292. package/dist/web/artifacts/gcs_artifact_service.js +2 -0
  293. package/dist/web/artifacts/in_memory_artifact_service.js +2 -0
  294. package/dist/web/artifacts/registry.js +2 -0
  295. package/dist/web/auth/auth_credential.js +2 -0
  296. package/dist/web/auth/auth_handler.js +85 -1
  297. package/dist/web/auth/auth_preprocessor.js +173 -0
  298. package/dist/web/auth/auth_provider_registry.js +33 -0
  299. package/dist/web/auth/auth_schemes.js +2 -0
  300. package/dist/web/auth/auth_tool.js +2 -0
  301. package/dist/web/auth/base_auth_provider.js +7 -0
  302. package/dist/web/auth/credential_service/base_credential_service.js +2 -0
  303. package/dist/web/auth/credential_service/in_memory_credential_service.js +2 -0
  304. package/dist/web/auth/credential_service/session_state_credential_service.js +23 -0
  305. package/dist/web/auth/exchanger/base_credential_exchanger.js +2 -0
  306. package/dist/web/auth/exchanger/credential_exchanger_registry.js +2 -0
  307. package/dist/web/auth/oauth2/oauth2_credential_exchanger.js +188 -0
  308. package/dist/web/auth/oauth2/oauth2_credential_refresher.js +102 -0
  309. package/dist/web/auth/oauth2/oauth2_discovery.js +156 -0
  310. package/dist/web/auth/oauth2/oauth2_utils.js +87 -0
  311. package/dist/web/auth/refresher/base_credential_refresher.js +16 -0
  312. package/dist/web/auth/refresher/credential_refresher_registry.js +40 -0
  313. package/dist/web/code_executors/base_code_executor.js +11 -5
  314. package/dist/web/code_executors/built_in_code_executor.js +2 -0
  315. package/dist/web/code_executors/code_execution_utils.js +19 -0
  316. package/dist/web/code_executors/code_executor_context.js +2 -0
  317. package/dist/web/code_executors/unsafe_local_code_executor.js +203 -0
  318. package/dist/web/common.js +47 -3
  319. package/dist/web/context/base_context_compactor.js +2 -0
  320. package/dist/web/context/summarizers/base_summarizer.js +2 -0
  321. package/dist/web/context/summarizers/llm_summarizer.js +2 -0
  322. package/dist/web/context/token_based_context_compactor.js +2 -0
  323. package/dist/web/context/truncating_context_compactor.js +2 -0
  324. package/dist/web/events/compacted_event.js +2 -0
  325. package/dist/web/events/event.js +2 -0
  326. package/dist/web/events/event_actions.js +2 -0
  327. package/dist/web/events/structured_events.js +2 -0
  328. package/dist/web/examples/base_example_provider.js +2 -0
  329. package/dist/web/examples/example.js +2 -0
  330. package/dist/web/examples/example_util.js +2 -0
  331. package/dist/web/features/feature_registry.js +107 -0
  332. package/dist/web/index.js +3 -2
  333. package/dist/web/index.js.map +4 -4
  334. package/dist/web/index_web.js +2 -0
  335. package/dist/web/memory/base_memory_service.js +2 -0
  336. package/dist/web/memory/in_memory_memory_service.js +2 -0
  337. package/dist/web/memory/memory_entry.js +2 -0
  338. package/dist/web/models/apigee_llm.js +4 -2
  339. package/dist/web/models/base_llm.js +2 -0
  340. package/dist/web/models/base_llm_connection.js +2 -0
  341. package/dist/web/models/gemini_llm_connection.js +2 -0
  342. package/dist/web/models/google_llm.js +37 -59
  343. package/dist/web/models/llm_request.js +2 -0
  344. package/dist/web/models/llm_response.js +2 -0
  345. package/dist/web/models/registry.js +2 -0
  346. package/dist/web/models/routed_llm.js +122 -0
  347. package/dist/web/plugins/base_plugin.js +41 -1
  348. package/dist/web/plugins/logging_plugin.js +2 -0
  349. package/dist/web/plugins/plugin_manager.js +41 -0
  350. package/dist/web/plugins/security_plugin.js +2 -0
  351. package/dist/web/runner/in_memory_runner.js +2 -0
  352. package/dist/web/runner/runner.js +33 -3
  353. package/dist/web/sessions/base_session_service.js +2 -0
  354. package/dist/web/sessions/database_session_service.js +2 -0
  355. package/dist/web/sessions/db/operations.js +5 -10
  356. package/dist/web/sessions/db/schema.js +2 -0
  357. package/dist/web/sessions/in_memory_session_service.js +2 -0
  358. package/dist/web/sessions/registry.js +2 -0
  359. package/dist/web/sessions/session.js +2 -0
  360. package/dist/web/sessions/state.js +2 -0
  361. package/dist/web/skills/loader.js +262 -0
  362. package/dist/web/skills/prompt.js +30 -0
  363. package/dist/web/skills/skill.js +67 -0
  364. package/dist/web/telemetry/google_cloud.js +2 -0
  365. package/dist/web/telemetry/setup.js +2 -0
  366. package/dist/web/telemetry/tracing.js +2 -0
  367. package/dist/web/tools/agent_tool.js +12 -3
  368. package/dist/web/tools/base_tool.js +2 -0
  369. package/dist/web/tools/base_toolset.js +2 -0
  370. package/dist/web/tools/exit_loop_tool.js +2 -0
  371. package/dist/web/tools/forwarding_artifact_service.js +2 -0
  372. package/dist/web/tools/function_tool.js +2 -0
  373. package/dist/web/tools/google_search_tool.js +2 -0
  374. package/dist/web/tools/load_artifacts_tool.js +2 -0
  375. package/dist/web/tools/load_memory_tool.js +2 -0
  376. package/dist/web/tools/long_running_tool.js +2 -0
  377. package/dist/web/tools/mcp/mcp_session_manager.js +2 -0
  378. package/dist/web/tools/mcp/mcp_tool.js +6 -1
  379. package/dist/web/tools/mcp/mcp_toolset.js +2 -0
  380. package/dist/web/tools/preload_memory_tool.js +2 -0
  381. package/dist/web/tools/skill/list_skills_tool.js +50 -0
  382. package/dist/web/tools/skill/load_skill_resource_tool.js +191 -0
  383. package/dist/web/tools/skill/load_skill_tool.js +82 -0
  384. package/dist/web/tools/skill/run_skill_inline_script_tool.js +120 -0
  385. package/dist/web/tools/skill/run_skill_script_tool.js +190 -0
  386. package/dist/web/tools/skill/skill_toolset.js +123 -0
  387. package/dist/web/tools/tool_confirmation.js +2 -0
  388. package/dist/web/utils/client_labels.js +2 -0
  389. package/dist/web/utils/env_aware_utils.js +2 -0
  390. package/dist/web/utils/experimental.js +46 -0
  391. package/dist/web/utils/failover_utils.js +96 -0
  392. package/dist/web/utils/file_extension_utils.js +51 -0
  393. package/dist/web/utils/file_utils.js +74 -0
  394. package/dist/web/utils/gemini_schema_util.js +2 -0
  395. package/dist/web/utils/logger.js +2 -0
  396. package/dist/web/utils/model_name.js +2 -0
  397. package/dist/web/utils/object_notation_utils.js +2 -0
  398. package/dist/web/utils/simple_zod_to_json.js +2 -0
  399. package/dist/web/utils/streaming_utils.js +325 -0
  400. package/dist/web/utils/variant_utils.js +2 -0
  401. package/dist/web/version.js +3 -1
  402. package/package.json +19 -17
@@ -0,0 +1,325 @@
1
+ import {createRequire as topLevelCreateRequire} from 'module';
2
+ const require = topLevelCreateRequire(import.meta.url);
3
+ var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
4
+ var __await = function(promise, isYieldStar) {
5
+ this[0] = promise;
6
+ this[1] = isYieldStar;
7
+ };
8
+ var __asyncGenerator = (__this, __arguments, generator) => {
9
+ var resume = (k, v, yes, no) => {
10
+ try {
11
+ var x = generator[k](v), isAwait = (v = x.value) instanceof __await, done = x.done;
12
+ Promise.resolve(isAwait ? v[0] : v).then((y) => isAwait ? resume(k === "return" ? k : "next", v[1] ? { done: y.done, value: y.value } : y, yes, no) : yes({ value: y, done })).catch((e) => resume("throw", e, yes, no));
13
+ } catch (e) {
14
+ no(e);
15
+ }
16
+ }, method = (k) => it[k] = (x) => new Promise((yes, no) => resume(k, x, yes, no)), it = {};
17
+ return generator = generator.apply(__this, __arguments), it[__knownSymbol("asyncIterator")] = () => it, method("next"), method("throw"), method("return"), it;
18
+ };
19
+ /**
20
+ * @license
21
+ * Copyright 2026 Google LLC
22
+ * SPDX-License-Identifier: Apache-2.0
23
+ */
24
+ import {
25
+ FinishReason
26
+ } from "@google/genai";
27
+ import { JSONPath } from "jsonpath-plus";
28
+ import { generateClientFunctionCallId } from "../agents/functions.js";
29
+ import { FeatureName, isFeatureEnabled } from "../features/feature_registry.js";
30
+ import { createLlmResponse } from "../models/llm_response.js";
31
+ class StreamingResponseAggregator {
32
+ constructor(isProgressiveMode = isFeatureEnabled(
33
+ FeatureName.PROGRESSIVE_SSE_STREAMING
34
+ )) {
35
+ this.isProgressiveMode = isProgressiveMode;
36
+ // For non-progressive SSE streaming mode
37
+ this.text = "";
38
+ this.thoughtText = "";
39
+ // For progressive SSE streaming mode: accumulate parts in order
40
+ this.partsSequence = [];
41
+ this.currentTextBuffer = "";
42
+ this.currentFcArgs = {};
43
+ }
44
+ flushTextBufferToSequence() {
45
+ if (!this.currentTextBuffer) {
46
+ return;
47
+ }
48
+ if (this.currentTextIsThought) {
49
+ this.partsSequence.push({
50
+ text: this.currentTextBuffer,
51
+ thought: true
52
+ });
53
+ } else {
54
+ this.partsSequence.push({
55
+ text: this.currentTextBuffer
56
+ });
57
+ }
58
+ this.currentTextBuffer = "";
59
+ this.currentTextIsThought = void 0;
60
+ }
61
+ getValueFromPartialArg(partialArg, jsonPath) {
62
+ let value = null;
63
+ let hasValue = false;
64
+ const stringValue = partialArg.stringValue;
65
+ const numberValue = partialArg.numberValue;
66
+ const boolValue = partialArg.boolValue;
67
+ const nullValue = partialArg.nullValue;
68
+ if (stringValue !== void 0) {
69
+ const stringChunk = stringValue;
70
+ hasValue = true;
71
+ const pathParts = JSONPath.toPathArray(jsonPath).filter(
72
+ (p) => p !== "$" && p !== "$["
73
+ );
74
+ let existingValue = this.currentFcArgs;
75
+ for (const part of pathParts) {
76
+ if (existingValue && typeof existingValue === "object" && part in existingValue) {
77
+ existingValue = existingValue[part];
78
+ } else {
79
+ existingValue = void 0;
80
+ break;
81
+ }
82
+ }
83
+ if (typeof existingValue === "string") {
84
+ value = existingValue + stringChunk;
85
+ } else {
86
+ value = stringChunk;
87
+ }
88
+ } else if (numberValue !== void 0) {
89
+ value = numberValue;
90
+ hasValue = true;
91
+ } else if (boolValue !== void 0) {
92
+ value = boolValue;
93
+ hasValue = true;
94
+ } else if (nullValue !== void 0) {
95
+ value = null;
96
+ hasValue = true;
97
+ }
98
+ return [value, hasValue];
99
+ }
100
+ setValueByJsonPath(jsonPath, value) {
101
+ const pathParts = JSONPath.toPathArray(jsonPath).filter(
102
+ (p) => p !== "$" && p !== "$["
103
+ );
104
+ let current = this.currentFcArgs;
105
+ for (let i = 0; i < pathParts.length - 1; i++) {
106
+ const part = pathParts[i];
107
+ if (!(part in current)) {
108
+ current[part] = {};
109
+ }
110
+ current = current[part];
111
+ }
112
+ if (pathParts.length > 0) {
113
+ current[pathParts[pathParts.length - 1]] = value;
114
+ }
115
+ }
116
+ flushFunctionCallToSequence() {
117
+ var _a;
118
+ if (this.currentFcName) {
119
+ const fcPart = {
120
+ functionCall: {
121
+ name: this.currentFcName,
122
+ args: JSON.parse(JSON.stringify(this.currentFcArgs)),
123
+ id: (_a = this.currentFcId) != null ? _a : generateClientFunctionCallId()
124
+ }
125
+ };
126
+ if (this.currentThoughtSignature) {
127
+ fcPart.thoughtSignature = this.currentThoughtSignature.toString();
128
+ }
129
+ this.partsSequence.push(fcPart);
130
+ this.currentFcName = void 0;
131
+ this.currentFcArgs = {};
132
+ this.currentFcId = void 0;
133
+ this.currentThoughtSignature = void 0;
134
+ }
135
+ }
136
+ processStreamingFunctionCall(fc) {
137
+ if (fc.name) {
138
+ this.currentFcName = fc.name;
139
+ }
140
+ if (fc.id) {
141
+ this.currentFcId = fc.id;
142
+ }
143
+ for (const partialArg of fc.partialArgs || []) {
144
+ const jsonPath = partialArg.jsonPath;
145
+ if (!jsonPath) {
146
+ continue;
147
+ }
148
+ const [value, hasValue] = this.getValueFromPartialArg(
149
+ partialArg,
150
+ jsonPath
151
+ );
152
+ if (hasValue) {
153
+ this.setValueByJsonPath(jsonPath, value);
154
+ }
155
+ }
156
+ if (!fc.willContinue) {
157
+ this.flushTextBufferToSequence();
158
+ this.flushFunctionCallToSequence();
159
+ }
160
+ }
161
+ processFunctionCallPart(part) {
162
+ const fc = part.functionCall;
163
+ if (!fc) {
164
+ return;
165
+ }
166
+ if (part.thoughtSignature) {
167
+ this.lastThoughtSignature = part.thoughtSignature;
168
+ } else if (this.lastThoughtSignature) {
169
+ part.thoughtSignature = this.lastThoughtSignature.toString();
170
+ }
171
+ if (fc.partialArgs || fc.willContinue) {
172
+ if (!fc.id && !this.currentFcId) {
173
+ fc.id = generateClientFunctionCallId();
174
+ }
175
+ if (part.thoughtSignature && !this.currentThoughtSignature) {
176
+ this.currentThoughtSignature = part.thoughtSignature;
177
+ }
178
+ this.processStreamingFunctionCall(fc);
179
+ } else {
180
+ if (fc.name) {
181
+ if (!fc.id) {
182
+ fc.id = generateClientFunctionCallId();
183
+ }
184
+ this.flushTextBufferToSequence();
185
+ this.partsSequence.push(part);
186
+ }
187
+ }
188
+ }
189
+ processResponse(response) {
190
+ return __asyncGenerator(this, null, function* () {
191
+ var _a, _b, _c;
192
+ this.response = response;
193
+ const llmResponse = createLlmResponse(response);
194
+ this.usageMetadata = llmResponse.usageMetadata;
195
+ if (llmResponse.groundingMetadata) {
196
+ this.groundingMetadata = llmResponse.groundingMetadata;
197
+ }
198
+ if (llmResponse.citationMetadata) {
199
+ this.citationMetadata = llmResponse.citationMetadata;
200
+ }
201
+ if (llmResponse.finishReason) {
202
+ this.finishReason = llmResponse.finishReason;
203
+ }
204
+ if (llmResponse.content && llmResponse.content.parts) {
205
+ for (const part of llmResponse.content.parts) {
206
+ if (part.thoughtSignature) {
207
+ this.lastThoughtSignature = part.thoughtSignature;
208
+ } else if (part.functionCall && this.lastThoughtSignature) {
209
+ part.thoughtSignature = this.lastThoughtSignature.toString();
210
+ }
211
+ }
212
+ }
213
+ if (this.isProgressiveMode) {
214
+ if (llmResponse.content && llmResponse.content.parts) {
215
+ for (const part of llmResponse.content.parts) {
216
+ if (part.text) {
217
+ const isThought = (_a = part.thought) != null ? _a : false;
218
+ if (this.currentTextBuffer && isThought !== this.currentTextIsThought) {
219
+ this.flushTextBufferToSequence();
220
+ }
221
+ if (!this.currentTextBuffer) {
222
+ this.currentTextIsThought = isThought;
223
+ }
224
+ this.currentTextBuffer += part.text;
225
+ } else if (part.functionCall) {
226
+ this.processFunctionCallPart(part);
227
+ } else {
228
+ this.flushTextBufferToSequence();
229
+ this.partsSequence.push(part);
230
+ }
231
+ }
232
+ }
233
+ llmResponse.partial = true;
234
+ yield llmResponse;
235
+ return;
236
+ }
237
+ if (llmResponse.content && llmResponse.content.parts && typeof ((_b = llmResponse.content.parts[0]) == null ? void 0 : _b.text) === "string") {
238
+ const part0 = llmResponse.content.parts[0];
239
+ const partText = part0.text || "";
240
+ if (part0.thought) {
241
+ this.thoughtText += partText;
242
+ } else {
243
+ this.text += partText;
244
+ }
245
+ llmResponse.partial = true;
246
+ } else if ((this.thoughtText || this.text) && (!llmResponse.content || !llmResponse.content.parts || !((_c = llmResponse.content.parts[0]) == null ? void 0 : _c.inlineData))) {
247
+ const parts = [];
248
+ if (this.thoughtText) {
249
+ parts.push({ text: this.thoughtText, thought: true });
250
+ }
251
+ if (this.text) {
252
+ parts.push({ text: this.text });
253
+ }
254
+ yield {
255
+ content: {
256
+ role: "model",
257
+ parts
258
+ },
259
+ usageMetadata: llmResponse.usageMetadata,
260
+ partial: false
261
+ };
262
+ this.thoughtText = "";
263
+ this.text = "";
264
+ }
265
+ yield llmResponse;
266
+ });
267
+ }
268
+ close() {
269
+ var _a, _b;
270
+ if (!((_a = this.response) == null ? void 0 : _a.candidates) || this.response.candidates.length === 0) {
271
+ return;
272
+ }
273
+ if (this.isProgressiveMode) {
274
+ this.flushTextBufferToSequence();
275
+ this.flushFunctionCallToSequence();
276
+ const finalParts = this.partsSequence;
277
+ if (finalParts.length === 0) {
278
+ return;
279
+ }
280
+ const candidate = this.response.candidates[0];
281
+ const finishReason = (_b = this.finishReason) != null ? _b : candidate.finishReason;
282
+ return {
283
+ content: {
284
+ role: "model",
285
+ parts: finalParts
286
+ },
287
+ groundingMetadata: this.groundingMetadata,
288
+ citationMetadata: this.citationMetadata,
289
+ errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
290
+ errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate.finishMessage,
291
+ usageMetadata: this.usageMetadata,
292
+ finishReason,
293
+ partial: false
294
+ };
295
+ }
296
+ if ((this.text || this.thoughtText) && this.response.candidates && this.response.candidates.length > 0) {
297
+ const parts = [];
298
+ if (this.thoughtText) {
299
+ parts.push({ text: this.thoughtText, thought: true });
300
+ }
301
+ if (this.text) {
302
+ parts.push({ text: this.text });
303
+ }
304
+ const candidate = this.response.candidates[0];
305
+ const finishReason = candidate.finishReason;
306
+ return {
307
+ content: {
308
+ role: "model",
309
+ parts
310
+ },
311
+ groundingMetadata: this.groundingMetadata,
312
+ citationMetadata: this.citationMetadata,
313
+ errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
314
+ errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate.finishMessage,
315
+ usageMetadata: this.usageMetadata,
316
+ finishReason,
317
+ partial: false
318
+ };
319
+ }
320
+ return void 0;
321
+ }
322
+ }
323
+ export {
324
+ StreamingResponseAggregator
325
+ };
@@ -1,3 +1,5 @@
1
+ import {createRequire as topLevelCreateRequire} from 'module';
2
+ const require = topLevelCreateRequire(import.meta.url);
1
3
  /**
2
4
  * @license
3
5
  * Copyright 2025 Google LLC
@@ -1,9 +1,11 @@
1
+ import {createRequire as topLevelCreateRequire} from 'module';
2
+ const require = topLevelCreateRequire(import.meta.url);
1
3
  /**
2
4
  * @license
3
5
  * Copyright 2025 Google LLC
4
6
  * SPDX-License-Identifier: Apache-2.0
5
7
  */
6
- const version = "0.6.1";
8
+ const version = "1.0.0";
7
9
  export {
8
10
  version
9
11
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@google/adk",
3
- "version": "0.6.1",
3
+ "version": "1.0.0",
4
4
  "description": "Google ADK JS",
5
5
  "author": "Google",
6
6
  "license": "Apache-2.0",
@@ -41,13 +41,29 @@
41
41
  },
42
42
  "dependencies": {
43
43
  "@a2a-js/sdk": "^0.3.10",
44
+ "@google-cloud/opentelemetry-cloud-monitoring-exporter": "^0.21.0",
45
+ "@google-cloud/opentelemetry-cloud-trace-exporter": "^3.0.0",
46
+ "@google-cloud/storage": "^7.17.1",
44
47
  "@google/genai": "^1.37.0",
45
48
  "@mikro-orm/core": "^6.6.10",
46
49
  "@mikro-orm/reflection": "^6.6.6",
47
50
  "@modelcontextprotocol/sdk": "^1.26.0",
51
+ "@opentelemetry/api": "1.9.0",
52
+ "@opentelemetry/api-logs": "^0.205.0",
53
+ "@opentelemetry/exporter-logs-otlp-http": "^0.205.0",
54
+ "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
55
+ "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
56
+ "@opentelemetry/resource-detector-gcp": "^0.40.0",
57
+ "@opentelemetry/resources": "^2.1.0",
58
+ "@opentelemetry/sdk-logs": "^0.205.0",
59
+ "@opentelemetry/sdk-metrics": "^2.1.0",
60
+ "@opentelemetry/sdk-trace-base": "^2.1.0",
61
+ "@opentelemetry/sdk-trace-node": "^2.1.0",
48
62
  "express": "^4.22.1",
49
63
  "google-auth-library": "^10.3.0",
50
- "lodash-es": "^4.17.23",
64
+ "js-yaml": "^4.1.1",
65
+ "jsonpath-plus": "^10.4.0",
66
+ "lodash-es": "^4.18.1",
51
67
  "winston": "^3.19.0",
52
68
  "zod": "^4.2.1",
53
69
  "zod-to-json-schema": "^3.25.1"
@@ -59,24 +75,10 @@
59
75
  "openapi-types": "^12.1.3"
60
76
  },
61
77
  "peerDependencies": {
62
- "@google-cloud/opentelemetry-cloud-monitoring-exporter": "^0.21.0",
63
- "@google-cloud/opentelemetry-cloud-trace-exporter": "^3.0.0",
64
- "@google-cloud/storage": "^7.17.1",
65
78
  "@mikro-orm/mariadb": "^6.6.6",
66
79
  "@mikro-orm/mssql": "^6.6.6",
67
80
  "@mikro-orm/mysql": "^6.6.6",
68
81
  "@mikro-orm/postgresql": "^6.6.6",
69
- "@mikro-orm/sqlite": "^6.6.6",
70
- "@opentelemetry/api": "1.9.0",
71
- "@opentelemetry/api-logs": "^0.205.0",
72
- "@opentelemetry/exporter-logs-otlp-http": "^0.205.0",
73
- "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
74
- "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
75
- "@opentelemetry/resource-detector-gcp": "^0.40.0",
76
- "@opentelemetry/resources": "^2.1.0",
77
- "@opentelemetry/sdk-logs": "^0.205.0",
78
- "@opentelemetry/sdk-metrics": "^2.1.0",
79
- "@opentelemetry/sdk-trace-base": "^2.1.0",
80
- "@opentelemetry/sdk-trace-node": "^2.1.0"
82
+ "@mikro-orm/sqlite": "^6.6.6"
81
83
  }
82
84
  }