@paean-ai/adk 0.2.16 → 0.2.17

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 (253) hide show
  1. package/dist/cjs/agents/active_streaming_tool.js +44 -0
  2. package/dist/cjs/agents/base_agent.js +245 -0
  3. package/dist/cjs/agents/base_llm_processor.js +44 -0
  4. package/dist/cjs/agents/callback_context.js +98 -0
  5. package/dist/cjs/agents/content_processor_utils.js +346 -0
  6. package/dist/cjs/agents/functions.js +424 -0
  7. package/dist/cjs/agents/instructions.js +110 -0
  8. package/dist/cjs/agents/invocation_context.js +107 -0
  9. package/dist/cjs/agents/live_request_queue.js +136 -0
  10. package/dist/cjs/agents/llm_agent.js +1247 -0
  11. package/dist/cjs/agents/loop_agent.js +68 -0
  12. package/dist/cjs/agents/parallel_agent.js +78 -0
  13. package/dist/cjs/agents/readonly_context.js +68 -0
  14. package/dist/cjs/agents/run_config.js +70 -0
  15. package/dist/cjs/agents/sequential_agent.js +84 -0
  16. package/dist/cjs/agents/transcription_entry.js +27 -0
  17. package/dist/cjs/artifacts/base_artifact_service.js +27 -0
  18. package/dist/cjs/artifacts/gcs_artifact_service.js +140 -0
  19. package/dist/cjs/artifacts/in_memory_artifact_service.js +119 -0
  20. package/dist/cjs/auth/auth_credential.js +46 -0
  21. package/dist/cjs/auth/auth_handler.js +92 -0
  22. package/dist/cjs/auth/auth_schemes.js +62 -0
  23. package/dist/cjs/auth/auth_tool.js +27 -0
  24. package/dist/cjs/auth/credential_service/base_credential_service.js +27 -0
  25. package/dist/cjs/auth/credential_service/in_memory_credential_service.js +63 -0
  26. package/dist/cjs/auth/exchanger/base_credential_exchanger.js +40 -0
  27. package/dist/cjs/auth/exchanger/credential_exchanger_registry.js +59 -0
  28. package/dist/cjs/code_executors/base_code_executor.js +76 -0
  29. package/dist/cjs/code_executors/built_in_code_executor.js +58 -0
  30. package/dist/cjs/code_executors/code_execution_utils.js +142 -0
  31. package/dist/cjs/code_executors/code_executor_context.js +198 -0
  32. package/dist/cjs/common.js +181 -0
  33. package/dist/cjs/events/event.js +119 -0
  34. package/dist/cjs/events/event_actions.js +83 -0
  35. package/dist/cjs/examples/base_example_provider.js +40 -0
  36. package/dist/cjs/examples/example.js +27 -0
  37. package/dist/cjs/examples/example_util.js +107 -0
  38. package/dist/cjs/index.js +10 -10
  39. package/dist/cjs/index.js.map +3 -3
  40. package/dist/cjs/index_web.js +33 -0
  41. package/dist/cjs/memory/base_memory_service.js +27 -0
  42. package/dist/cjs/memory/in_memory_memory_service.js +97 -0
  43. package/dist/cjs/memory/memory_entry.js +27 -0
  44. package/dist/cjs/models/base_llm.js +95 -0
  45. package/dist/cjs/models/base_llm_connection.js +27 -0
  46. package/dist/cjs/models/gemini_llm_connection.js +132 -0
  47. package/dist/cjs/models/google_llm.js +559 -0
  48. package/dist/cjs/models/llm_request.js +82 -0
  49. package/dist/cjs/models/llm_response.js +71 -0
  50. package/dist/cjs/models/registry.js +121 -0
  51. package/dist/cjs/plugins/base_plugin.js +236 -0
  52. package/dist/cjs/plugins/logging_plugin.js +222 -0
  53. package/dist/cjs/plugins/plugin_manager.js +239 -0
  54. package/dist/cjs/plugins/security_plugin.js +153 -0
  55. package/dist/cjs/runner/in_memory_runner.js +58 -0
  56. package/dist/cjs/runner/runner.js +277 -0
  57. package/dist/cjs/sessions/base_session_service.js +71 -0
  58. package/dist/cjs/sessions/in_memory_session_service.js +184 -0
  59. package/dist/cjs/sessions/session.js +48 -0
  60. package/dist/cjs/sessions/state.js +101 -0
  61. package/dist/cjs/telemetry/google_cloud.js +85 -0
  62. package/dist/cjs/telemetry/setup.js +97 -0
  63. package/dist/cjs/telemetry/tracing.js +231 -0
  64. package/dist/cjs/tools/agent_tool.js +134 -0
  65. package/dist/cjs/tools/base_tool.js +107 -0
  66. package/dist/cjs/tools/base_toolset.js +76 -0
  67. package/dist/cjs/tools/forwarding_artifact_service.js +71 -0
  68. package/dist/cjs/tools/function_tool.js +101 -0
  69. package/dist/cjs/tools/google_search_tool.js +77 -0
  70. package/dist/cjs/tools/long_running_tool.js +63 -0
  71. package/dist/cjs/tools/mcp/mcp_session_manager.js +65 -0
  72. package/dist/cjs/tools/mcp/mcp_tool.js +65 -0
  73. package/dist/cjs/tools/mcp/mcp_toolset.js +61 -0
  74. package/dist/cjs/tools/tool_confirmation.js +49 -0
  75. package/dist/cjs/tools/tool_context.js +129 -0
  76. package/dist/cjs/utils/client_labels.js +56 -0
  77. package/dist/cjs/utils/deep_clone.js +44 -0
  78. package/dist/cjs/utils/env_aware_utils.js +83 -0
  79. package/dist/cjs/utils/gemini_schema_util.js +88 -0
  80. package/dist/cjs/utils/logger.js +121 -0
  81. package/dist/cjs/utils/model_name.js +76 -0
  82. package/dist/cjs/utils/simple_zod_to_json.js +191 -0
  83. package/dist/cjs/utils/variant_utils.js +55 -0
  84. package/dist/cjs/version.js +39 -0
  85. package/dist/esm/agents/active_streaming_tool.js +14 -0
  86. package/dist/esm/agents/base_agent.js +214 -0
  87. package/dist/esm/agents/base_llm_processor.js +13 -0
  88. package/dist/esm/agents/callback_context.js +68 -0
  89. package/dist/esm/agents/content_processor_utils.js +315 -0
  90. package/dist/esm/agents/functions.js +383 -0
  91. package/dist/esm/agents/instructions.js +80 -0
  92. package/dist/esm/agents/invocation_context.js +76 -0
  93. package/dist/esm/agents/live_request_queue.js +106 -0
  94. package/dist/esm/agents/llm_agent.js +1215 -0
  95. package/dist/esm/agents/loop_agent.js +38 -0
  96. package/dist/esm/agents/parallel_agent.js +48 -0
  97. package/dist/esm/agents/readonly_context.js +38 -0
  98. package/dist/esm/agents/run_config.js +39 -0
  99. package/dist/esm/agents/sequential_agent.js +54 -0
  100. package/dist/esm/agents/transcription_entry.js +5 -0
  101. package/dist/esm/artifacts/base_artifact_service.js +5 -0
  102. package/dist/esm/artifacts/gcs_artifact_service.js +110 -0
  103. package/dist/esm/artifacts/in_memory_artifact_service.js +89 -0
  104. package/dist/esm/auth/auth_credential.js +16 -0
  105. package/dist/esm/auth/auth_handler.js +62 -0
  106. package/dist/esm/auth/auth_schemes.js +31 -0
  107. package/dist/esm/auth/auth_tool.js +5 -0
  108. package/dist/esm/auth/credential_service/base_credential_service.js +5 -0
  109. package/dist/esm/auth/credential_service/in_memory_credential_service.js +33 -0
  110. package/dist/esm/auth/exchanger/base_credential_exchanger.js +10 -0
  111. package/dist/esm/auth/exchanger/credential_exchanger_registry.js +29 -0
  112. package/dist/esm/code_executors/base_code_executor.js +46 -0
  113. package/dist/esm/code_executors/built_in_code_executor.js +28 -0
  114. package/dist/esm/code_executors/code_execution_utils.js +108 -0
  115. package/dist/esm/code_executors/code_executor_context.js +168 -0
  116. package/dist/esm/common.js +98 -0
  117. package/dist/esm/events/event.js +83 -0
  118. package/dist/esm/events/event_actions.js +52 -0
  119. package/dist/esm/examples/base_example_provider.js +10 -0
  120. package/dist/esm/examples/example.js +5 -0
  121. package/dist/esm/examples/example_util.js +76 -0
  122. package/dist/esm/index.js +10 -10
  123. package/dist/esm/index.js.map +3 -3
  124. package/dist/esm/index_web.js +6 -0
  125. package/dist/esm/memory/base_memory_service.js +5 -0
  126. package/dist/esm/memory/in_memory_memory_service.js +67 -0
  127. package/dist/esm/memory/memory_entry.js +5 -0
  128. package/dist/esm/models/base_llm.js +64 -0
  129. package/dist/esm/models/base_llm_connection.js +5 -0
  130. package/dist/esm/models/gemini_llm_connection.js +102 -0
  131. package/dist/esm/models/google_llm.js +533 -0
  132. package/dist/esm/models/llm_request.js +50 -0
  133. package/dist/esm/models/llm_response.js +41 -0
  134. package/dist/esm/models/registry.js +91 -0
  135. package/dist/esm/plugins/base_plugin.js +206 -0
  136. package/dist/esm/plugins/logging_plugin.js +192 -0
  137. package/dist/esm/plugins/plugin_manager.js +209 -0
  138. package/dist/esm/plugins/security_plugin.js +119 -0
  139. package/dist/esm/runner/in_memory_runner.js +28 -0
  140. package/dist/esm/runner/runner.js +247 -0
  141. package/dist/esm/sessions/base_session_service.js +41 -0
  142. package/dist/esm/sessions/in_memory_session_service.js +154 -0
  143. package/dist/esm/sessions/session.js +18 -0
  144. package/dist/esm/sessions/state.js +71 -0
  145. package/dist/esm/telemetry/google_cloud.js +54 -0
  146. package/dist/esm/telemetry/setup.js +67 -0
  147. package/dist/esm/telemetry/tracing.js +195 -0
  148. package/dist/esm/tools/agent_tool.js +104 -0
  149. package/dist/esm/tools/base_tool.js +77 -0
  150. package/dist/esm/tools/base_toolset.js +46 -0
  151. package/dist/esm/tools/forwarding_artifact_service.js +41 -0
  152. package/dist/esm/tools/function_tool.js +71 -0
  153. package/dist/esm/tools/google_search_tool.js +47 -0
  154. package/dist/esm/tools/long_running_tool.js +33 -0
  155. package/dist/esm/tools/mcp/mcp_session_manager.js +35 -0
  156. package/dist/esm/tools/mcp/mcp_tool.js +35 -0
  157. package/dist/esm/tools/mcp/mcp_toolset.js +31 -0
  158. package/dist/esm/tools/tool_confirmation.js +19 -0
  159. package/dist/esm/tools/tool_context.js +99 -0
  160. package/dist/esm/utils/client_labels.js +26 -0
  161. package/dist/esm/utils/deep_clone.js +14 -0
  162. package/dist/esm/utils/env_aware_utils.js +49 -0
  163. package/dist/esm/utils/gemini_schema_util.js +58 -0
  164. package/dist/esm/utils/logger.js +89 -0
  165. package/dist/esm/utils/model_name.js +41 -0
  166. package/dist/esm/utils/simple_zod_to_json.js +160 -0
  167. package/dist/esm/utils/variant_utils.js +24 -0
  168. package/dist/esm/version.js +9 -0
  169. package/dist/web/agents/active_streaming_tool.js +14 -0
  170. package/dist/web/agents/base_agent.js +265 -0
  171. package/dist/web/agents/base_llm_processor.js +13 -0
  172. package/dist/web/agents/callback_context.js +68 -0
  173. package/dist/web/agents/content_processor_utils.js +315 -0
  174. package/dist/web/agents/functions.js +383 -0
  175. package/dist/web/agents/instructions.js +80 -0
  176. package/dist/web/agents/invocation_context.js +76 -0
  177. package/dist/web/agents/live_request_queue.js +124 -0
  178. package/dist/web/agents/llm_agent.js +1345 -0
  179. package/dist/web/agents/loop_agent.js +71 -0
  180. package/dist/web/agents/parallel_agent.js +83 -0
  181. package/dist/web/agents/readonly_context.js +38 -0
  182. package/dist/web/agents/run_config.js +54 -0
  183. package/dist/web/agents/sequential_agent.js +99 -0
  184. package/dist/web/agents/transcription_entry.js +5 -0
  185. package/dist/web/artifacts/base_artifact_service.js +5 -0
  186. package/dist/web/artifacts/gcs_artifact_service.js +126 -0
  187. package/dist/web/artifacts/in_memory_artifact_service.js +89 -0
  188. package/dist/web/auth/auth_credential.js +16 -0
  189. package/dist/web/auth/auth_handler.js +62 -0
  190. package/dist/web/auth/auth_schemes.js +31 -0
  191. package/dist/web/auth/auth_tool.js +5 -0
  192. package/dist/web/auth/credential_service/base_credential_service.js +5 -0
  193. package/dist/web/auth/credential_service/in_memory_credential_service.js +33 -0
  194. package/dist/web/auth/exchanger/base_credential_exchanger.js +10 -0
  195. package/dist/web/auth/exchanger/credential_exchanger_registry.js +29 -0
  196. package/dist/web/code_executors/base_code_executor.js +46 -0
  197. package/dist/web/code_executors/built_in_code_executor.js +28 -0
  198. package/dist/web/code_executors/code_execution_utils.js +105 -0
  199. package/dist/web/code_executors/code_executor_context.js +168 -0
  200. package/dist/web/common.js +98 -0
  201. package/dist/web/events/event.js +101 -0
  202. package/dist/web/events/event_actions.js +67 -0
  203. package/dist/web/examples/base_example_provider.js +10 -0
  204. package/dist/web/examples/example.js +5 -0
  205. package/dist/web/examples/example_util.js +75 -0
  206. package/dist/web/index.js +1 -1
  207. package/dist/web/index.js.map +3 -3
  208. package/dist/web/index_web.js +6 -0
  209. package/dist/web/memory/base_memory_service.js +5 -0
  210. package/dist/web/memory/in_memory_memory_service.js +67 -0
  211. package/dist/web/memory/memory_entry.js +5 -0
  212. package/dist/web/models/base_llm.js +64 -0
  213. package/dist/web/models/base_llm_connection.js +5 -0
  214. package/dist/web/models/gemini_llm_connection.js +120 -0
  215. package/dist/web/models/google_llm.js +574 -0
  216. package/dist/web/models/llm_request.js +50 -0
  217. package/dist/web/models/llm_response.js +41 -0
  218. package/dist/web/models/registry.js +91 -0
  219. package/dist/web/plugins/base_plugin.js +206 -0
  220. package/dist/web/plugins/logging_plugin.js +192 -0
  221. package/dist/web/plugins/plugin_manager.js +209 -0
  222. package/dist/web/plugins/security_plugin.js +119 -0
  223. package/dist/web/runner/in_memory_runner.js +28 -0
  224. package/dist/web/runner/runner.js +278 -0
  225. package/dist/web/sessions/base_session_service.js +41 -0
  226. package/dist/web/sessions/in_memory_session_service.js +154 -0
  227. package/dist/web/sessions/session.js +18 -0
  228. package/dist/web/sessions/state.js +87 -0
  229. package/dist/web/telemetry/google_cloud.js +54 -0
  230. package/dist/web/telemetry/setup.js +67 -0
  231. package/dist/web/telemetry/tracing.js +210 -0
  232. package/dist/web/tools/agent_tool.js +118 -0
  233. package/dist/web/tools/base_tool.js +77 -0
  234. package/dist/web/tools/base_toolset.js +46 -0
  235. package/dist/web/tools/forwarding_artifact_service.js +41 -0
  236. package/dist/web/tools/function_tool.js +71 -0
  237. package/dist/web/tools/google_search_tool.js +47 -0
  238. package/dist/web/tools/long_running_tool.js +50 -0
  239. package/dist/web/tools/mcp/mcp_session_manager.js +35 -0
  240. package/dist/web/tools/mcp/mcp_tool.js +35 -0
  241. package/dist/web/tools/mcp/mcp_toolset.js +31 -0
  242. package/dist/web/tools/tool_confirmation.js +19 -0
  243. package/dist/web/tools/tool_context.js +99 -0
  244. package/dist/web/utils/client_labels.js +26 -0
  245. package/dist/web/utils/deep_clone.js +14 -0
  246. package/dist/web/utils/env_aware_utils.js +49 -0
  247. package/dist/web/utils/gemini_schema_util.js +58 -0
  248. package/dist/web/utils/logger.js +89 -0
  249. package/dist/web/utils/model_name.js +41 -0
  250. package/dist/web/utils/simple_zod_to_json.js +174 -0
  251. package/dist/web/utils/variant_utils.js +24 -0
  252. package/dist/web/version.js +9 -0
  253. package/package.json +1 -1
@@ -0,0 +1,67 @@
1
+ var __defProp = Object.defineProperty;
2
+ var __getOwnPropSymbols = Object.getOwnPropertySymbols;
3
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
4
+ var __propIsEnum = Object.prototype.propertyIsEnumerable;
5
+ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
6
+ var __spreadValues = (a, b) => {
7
+ for (var prop in b || (b = {}))
8
+ if (__hasOwnProp.call(b, prop))
9
+ __defNormalProp(a, prop, b[prop]);
10
+ if (__getOwnPropSymbols)
11
+ for (var prop of __getOwnPropSymbols(b)) {
12
+ if (__propIsEnum.call(b, prop))
13
+ __defNormalProp(a, prop, b[prop]);
14
+ }
15
+ return a;
16
+ };
17
+ /**
18
+ * @license
19
+ * Copyright 2025 Google LLC
20
+ * SPDX-License-Identifier: Apache-2.0
21
+ */
22
+ function createEventActions(state = {}) {
23
+ return __spreadValues({
24
+ stateDelta: {},
25
+ artifactDelta: {},
26
+ requestedAuthConfigs: {},
27
+ requestedToolConfirmations: {}
28
+ }, state);
29
+ }
30
+ function mergeEventActions(sources, target) {
31
+ const result = createEventActions();
32
+ if (target) {
33
+ Object.assign(result, target);
34
+ }
35
+ for (const source of sources) {
36
+ if (!source) continue;
37
+ if (source.stateDelta) {
38
+ Object.assign(result.stateDelta, source.stateDelta);
39
+ }
40
+ if (source.artifactDelta) {
41
+ Object.assign(result.artifactDelta, source.artifactDelta);
42
+ }
43
+ if (source.requestedAuthConfigs) {
44
+ Object.assign(result.requestedAuthConfigs, source.requestedAuthConfigs);
45
+ }
46
+ if (source.requestedToolConfirmations) {
47
+ Object.assign(
48
+ result.requestedToolConfirmations,
49
+ source.requestedToolConfirmations
50
+ );
51
+ }
52
+ if (source.skipSummarization !== void 0) {
53
+ result.skipSummarization = source.skipSummarization;
54
+ }
55
+ if (source.transferToAgent !== void 0) {
56
+ result.transferToAgent = source.transferToAgent;
57
+ }
58
+ if (source.escalate !== void 0) {
59
+ result.escalate = source.escalate;
60
+ }
61
+ }
62
+ return result;
63
+ }
64
+ export {
65
+ createEventActions,
66
+ mergeEventActions
67
+ };
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ class BaseExampleProvider {
7
+ }
8
+ export {
9
+ BaseExampleProvider
10
+ };
@@ -0,0 +1,5 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
@@ -0,0 +1,75 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { BaseExampleProvider } from "./base_example_provider.js";
7
+ const EXAMPLES_INTRO = "<EXAMPLES>\nBegin few-shot\nThe following are examples of user queries and model responses using the available tools.\n\n";
8
+ const EXAMPLES_END = "End few-shot\n<EXAMPLES>";
9
+ const EXAMPLE_START = "EXAMPLE {}:\nBegin example\n";
10
+ const EXAMPLE_END = "End example\n\n";
11
+ const USER_PREFIX = "[user]\n";
12
+ const MODEL_PREFIX = "[model]\n";
13
+ const FUNCTION_PREFIX = "```\n";
14
+ const FUNCTION_CALL_PREFIX = "```tool_code\n";
15
+ const FUNCTION_CALL_SUFFIX = "\n```\n";
16
+ const FUNCTION_RESPONSE_PREFIX = "```tool_outputs\n";
17
+ const FUNCTION_RESPONSE_SUFFIX = "\n```\n";
18
+ function convertExamplesToText(examples, model) {
19
+ var _a;
20
+ let examplesStr = "";
21
+ for (const [exampleNum, example] of examples.entries()) {
22
+ let output = "".concat(EXAMPLE_START.replace("{}", String(exampleNum + 1))).concat(USER_PREFIX);
23
+ if ((_a = example.input) == null ? void 0 : _a.parts) {
24
+ output += example.input.parts.filter((part) => part.text).map((part) => part.text).join("\n") + "\n";
25
+ }
26
+ const gemini2 = !model || model.includes("gemini-2");
27
+ let previousRole;
28
+ for (const content of example.output) {
29
+ const role = content.role === "model" ? MODEL_PREFIX : USER_PREFIX;
30
+ if (role !== previousRole) {
31
+ output += role;
32
+ }
33
+ previousRole = role;
34
+ for (const part of content.parts || []) {
35
+ if (part.functionCall) {
36
+ const prefix = gemini2 ? FUNCTION_PREFIX : FUNCTION_CALL_PREFIX;
37
+ const functionCall = part.functionCall;
38
+ const args = [];
39
+ if (functionCall.args) {
40
+ for (const [k, v] of Object.entries(functionCall.args)) {
41
+ if (typeof v === "string") {
42
+ args.push("".concat(k, "='").concat(v, "'"));
43
+ } else {
44
+ args.push("".concat(k, "=").concat(v));
45
+ }
46
+ }
47
+ }
48
+ const functionCallString = "".concat(functionCall.name, "(").concat(args.join(", "), ")");
49
+ output += "".concat(prefix).concat(functionCallString).concat(FUNCTION_CALL_SUFFIX);
50
+ } else if (part.functionResponse) {
51
+ const prefix = gemini2 ? FUNCTION_PREFIX : FUNCTION_RESPONSE_PREFIX;
52
+ output += "".concat(prefix).concat(JSON.stringify(part.functionResponse)).concat(FUNCTION_RESPONSE_SUFFIX);
53
+ } else if (part.text) {
54
+ output += "".concat(part.text, "\n");
55
+ }
56
+ }
57
+ }
58
+ output += EXAMPLE_END;
59
+ examplesStr += output;
60
+ }
61
+ return "".concat(EXAMPLES_INTRO).concat(examplesStr).concat(EXAMPLES_END);
62
+ }
63
+ function buildExampleSi(examples, query, model) {
64
+ if (Array.isArray(examples)) {
65
+ return convertExamplesToText(examples, model);
66
+ }
67
+ if (examples instanceof BaseExampleProvider) {
68
+ return convertExamplesToText(examples.getExamples(query), model);
69
+ }
70
+ throw new Error("Invalid example configuration");
71
+ }
72
+ export {
73
+ buildExampleSi,
74
+ convertExamplesToText
75
+ };