@google/adk 2.3.0 → 2.4.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 (162) hide show
  1. package/dist/cjs/agents/agent_engine_client.js +172 -0
  2. package/dist/cjs/agents/base_agent.js +20 -4
  3. package/dist/cjs/agents/functions.js +28 -0
  4. package/dist/cjs/agents/instructions.js +2 -1
  5. package/dist/cjs/agents/llm_agent.js +19 -6
  6. package/dist/cjs/agents/processors/basic_llm_request_processor.js +1 -1
  7. package/dist/cjs/agents/processors/code_execution_request_processor.js +8 -0
  8. package/dist/cjs/agents/processors/content_processor_utils.js +38 -10
  9. package/dist/cjs/agents/processors/content_request_processor.js +34 -2
  10. package/dist/cjs/agents/processors/instructions_llm_request_processor.js +1 -1
  11. package/dist/cjs/agents/processors/nl_planning_processor.js +12 -3
  12. package/dist/cjs/cli/utils/logs.js +6 -6
  13. package/dist/cjs/code_executors/container_code_executor.js +27 -16
  14. package/dist/cjs/code_executors/unsafe_local_code_executor.js +6 -1
  15. package/dist/cjs/common.js +9 -20
  16. package/dist/cjs/errors/input_validation_error.js +3 -2
  17. package/dist/cjs/index.js +9 -2
  18. package/dist/cjs/plugins/base_plugin.js +13 -23
  19. package/dist/cjs/sessions/base_session_service.js +14 -8
  20. package/dist/cjs/sessions/database_session_service.js +50 -28
  21. package/dist/cjs/sessions/stale_session_error.js +59 -0
  22. package/dist/cjs/skills/loader.js +52 -18
  23. package/dist/cjs/telemetry/setup.js +0 -1
  24. package/dist/cjs/telemetry/tracing.js +53 -10
  25. package/dist/cjs/tools/apihub_tool/apihub_toolset.js +18 -23
  26. package/dist/cjs/tools/application_integration_tool/application_integration_toolset.js +120 -42
  27. package/dist/cjs/tools/application_integration_tool/clients/connections_client.js +163 -95
  28. package/dist/cjs/tools/application_integration_tool/clients/integration_client.js +13 -9
  29. package/dist/cjs/tools/application_integration_tool/integration_connector_tool.js +184 -0
  30. package/dist/cjs/tools/google_api_tool/google_api_tool.js +4 -1
  31. package/dist/cjs/tools/google_api_tool/google_api_toolset.js +173 -0
  32. package/dist/cjs/tools/google_api_tool/google_api_toolsets.js +124 -0
  33. package/dist/cjs/tools/google_api_tool/googleapi_to_openapi_converter.js +2 -2
  34. package/dist/cjs/tools/google_api_tool/index.js +20 -23
  35. package/dist/cjs/tools/load_artifacts_tool.js +12 -6
  36. package/dist/cjs/tools/load_memory_tool.js +12 -10
  37. package/dist/cjs/tools/mcp/mcp_toolset.js +1 -14
  38. package/dist/cjs/tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js +2 -2
  39. package/dist/cjs/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js +20 -6
  40. package/dist/cjs/tools/openapi_tool/openapi_spec_parser/operation_parser.js +17 -6
  41. package/dist/cjs/tools/openapi_tool/openapi_toolset.js +7 -13
  42. package/dist/cjs/tools/openapi_tool/rest_api_tool.js +17 -1
  43. package/dist/cjs/tools/toolbox_toolset.js +174 -0
  44. package/dist/cjs/tools/webmcp/webmcp_toolset.js +1 -14
  45. package/dist/cjs/utils/client_labels.js +19 -2
  46. package/dist/cjs/utils/failover_utils.js +1 -1
  47. package/dist/cjs/utils/gemini_schema_util.js +24 -6
  48. package/dist/cjs/utils/logger_node.js +4 -0
  49. package/dist/cjs/utils/output_schema_utils.js +5 -2
  50. package/dist/cjs/utils/task.js +1 -1
  51. package/dist/cjs/version.js +1 -1
  52. package/dist/esm/agents/agent_engine_client.js +144 -0
  53. package/dist/esm/agents/base_agent.js +20 -4
  54. package/dist/esm/agents/functions.js +28 -0
  55. package/dist/esm/agents/instructions.js +2 -1
  56. package/dist/esm/agents/llm_agent.js +19 -6
  57. package/dist/esm/agents/processors/basic_llm_request_processor.js +1 -1
  58. package/dist/esm/agents/processors/code_execution_request_processor.js +8 -0
  59. package/dist/esm/agents/processors/content_processor_utils.js +38 -10
  60. package/dist/esm/agents/processors/content_request_processor.js +34 -2
  61. package/dist/esm/agents/processors/instructions_llm_request_processor.js +1 -1
  62. package/dist/esm/agents/processors/nl_planning_processor.js +12 -3
  63. package/dist/esm/cli/utils/logs.js +4 -4
  64. package/dist/esm/code_executors/container_code_executor.js +27 -16
  65. package/dist/esm/code_executors/unsafe_local_code_executor.js +6 -1
  66. package/dist/esm/common.js +10 -13
  67. package/dist/esm/errors/input_validation_error.js +3 -2
  68. package/dist/esm/index.js +17 -3
  69. package/dist/esm/plugins/base_plugin.js +13 -23
  70. package/dist/esm/sessions/base_session_service.js +12 -7
  71. package/dist/esm/sessions/database_session_service.js +49 -28
  72. package/dist/esm/sessions/stale_session_error.js +31 -0
  73. package/dist/esm/skills/loader.js +51 -17
  74. package/dist/esm/telemetry/setup.js +1 -2
  75. package/dist/esm/telemetry/tracing.js +57 -11
  76. package/dist/esm/tools/apihub_tool/apihub_toolset.js +17 -22
  77. package/dist/esm/tools/application_integration_tool/application_integration_toolset.js +124 -42
  78. package/dist/esm/tools/application_integration_tool/clients/connections_client.js +163 -95
  79. package/dist/esm/tools/application_integration_tool/clients/integration_client.js +13 -9
  80. package/dist/esm/tools/application_integration_tool/integration_connector_tool.js +158 -0
  81. package/dist/esm/tools/google_api_tool/google_api_tool.js +4 -1
  82. package/dist/esm/tools/google_api_tool/google_api_toolset.js +146 -0
  83. package/dist/esm/tools/google_api_tool/google_api_toolsets.js +94 -0
  84. package/dist/esm/tools/google_api_tool/googleapi_to_openapi_converter.js +2 -2
  85. package/dist/esm/tools/google_api_tool/index.js +18 -20
  86. package/dist/esm/tools/load_artifacts_tool.js +10 -5
  87. package/dist/esm/tools/load_memory_tool.js +12 -10
  88. package/dist/esm/tools/mcp/mcp_toolset.js +1 -14
  89. package/dist/esm/tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js +2 -2
  90. package/dist/esm/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js +20 -6
  91. package/dist/esm/tools/openapi_tool/openapi_spec_parser/operation_parser.js +17 -6
  92. package/dist/esm/tools/openapi_tool/openapi_toolset.js +6 -12
  93. package/dist/esm/tools/openapi_tool/rest_api_tool.js +17 -1
  94. package/dist/esm/tools/toolbox_toolset.js +148 -0
  95. package/dist/esm/tools/webmcp/webmcp_toolset.js +1 -14
  96. package/dist/esm/utils/client_labels.js +19 -2
  97. package/dist/esm/utils/failover_utils.js +1 -1
  98. package/dist/esm/utils/gemini_schema_util.js +23 -6
  99. package/dist/esm/utils/logger_node.js +4 -0
  100. package/dist/esm/utils/output_schema_utils.js +5 -2
  101. package/dist/esm/utils/task.js +1 -1
  102. package/dist/esm/version.js +1 -1
  103. package/dist/types/agents/agent_engine_client.d.ts +37 -0
  104. package/dist/types/agents/base_agent.d.ts +12 -0
  105. package/dist/types/agents/llm_agent.d.ts +5 -1
  106. package/dist/types/agents/processors/content_processor_utils.d.ts +4 -2
  107. package/dist/types/agents/processors/nl_planning_processor.d.ts +2 -1
  108. package/dist/types/cli/utils/logs.d.ts +1 -1
  109. package/dist/types/code_executors/container_code_executor.d.ts +17 -5
  110. package/dist/types/common.d.ts +5 -9
  111. package/dist/types/errors/input_validation_error.d.ts +2 -1
  112. package/dist/types/index.d.ts +4 -2
  113. package/dist/types/plugins/base_plugin.d.ts +0 -10
  114. package/dist/types/sessions/base_session_service.d.ts +5 -0
  115. package/dist/types/sessions/database_session_service.d.ts +17 -1
  116. package/dist/types/sessions/stale_session_error.d.ts +21 -0
  117. package/dist/types/skills/loader.d.ts +3 -2
  118. package/dist/types/telemetry/tracing.d.ts +17 -3
  119. package/dist/types/tools/apihub_tool/apihub_toolset.d.ts +14 -21
  120. package/dist/types/tools/application_integration_tool/application_integration_toolset.d.ts +32 -9
  121. package/dist/types/tools/application_integration_tool/clients/connections_client.d.ts +22 -8
  122. package/dist/types/tools/application_integration_tool/clients/integration_client.d.ts +3 -3
  123. package/dist/types/tools/application_integration_tool/integration_connector_tool.d.ts +70 -0
  124. package/dist/types/tools/base_toolset.d.ts +6 -5
  125. package/dist/types/tools/google_api_tool/google_api_tool.d.ts +10 -3
  126. package/dist/types/tools/google_api_tool/google_api_toolset.d.ts +55 -0
  127. package/dist/types/tools/google_api_tool/google_api_toolsets.d.ts +48 -0
  128. package/dist/types/tools/google_api_tool/googleapi_to_openapi_converter.d.ts +5 -4
  129. package/dist/types/tools/google_api_tool/index.d.ts +4 -5
  130. package/dist/types/tools/load_artifacts_tool.d.ts +14 -1
  131. package/dist/types/tools/load_memory_tool.d.ts +23 -1
  132. package/dist/types/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.d.ts +12 -0
  133. package/dist/types/tools/openapi_tool/openapi_spec_parser/operation_parser.d.ts +8 -0
  134. package/dist/types/tools/openapi_tool/openapi_toolset.d.ts +5 -0
  135. package/dist/types/tools/openapi_tool/rest_api_tool.d.ts +10 -0
  136. package/dist/types/tools/toolbox_toolset.d.ts +159 -0
  137. package/dist/types/utils/client_labels.d.ts +2 -1
  138. package/dist/types/utils/gemini_schema_util.d.ts +8 -0
  139. package/dist/types/utils/output_schema_utils.d.ts +3 -2
  140. package/dist/types/utils/simple_zod_to_json.d.ts +1 -2
  141. package/dist/types/version.d.ts +1 -1
  142. package/dist/web/index_web.js +74 -66
  143. package/dist/web/index_web.js.map +4 -4
  144. package/package.json +34 -27
  145. package/dist/cjs/agents/remote_agent.js +0 -187
  146. package/dist/cjs/tools/crewai_tool.js +0 -132
  147. package/dist/cjs/tools/google_api_tool/google_api_tool_set.js +0 -226
  148. package/dist/cjs/tools/google_api_tool/google_api_tool_sets.js +0 -58
  149. package/dist/cjs/tools/langchain_tool.js +0 -172
  150. package/dist/cjs/tools/toolbox_tool.js +0 -108
  151. package/dist/esm/agents/remote_agent.js +0 -164
  152. package/dist/esm/tools/crewai_tool.js +0 -107
  153. package/dist/esm/tools/google_api_tool/google_api_tool_set.js +0 -188
  154. package/dist/esm/tools/google_api_tool/google_api_tool_sets.js +0 -24
  155. package/dist/esm/tools/langchain_tool.js +0 -148
  156. package/dist/esm/tools/toolbox_tool.js +0 -80
  157. package/dist/types/agents/remote_agent.d.ts +0 -68
  158. package/dist/types/tools/crewai_tool.d.ts +0 -85
  159. package/dist/types/tools/google_api_tool/google_api_tool_set.d.ts +0 -78
  160. package/dist/types/tools/google_api_tool/google_api_tool_sets.d.ts +0 -33
  161. package/dist/types/tools/langchain_tool.d.ts +0 -103
  162. package/dist/types/tools/toolbox_tool.d.ts +0 -73
@@ -1,33 +0,0 @@
1
- /**
2
- * @license
3
- * Copyright 2026 Google LLC
4
- * SPDX-License-Identifier: Apache-2.0
5
- */
6
- /**
7
- * Pre-configured {@link GoogleApiToolSet} for the Google Calendar v3 API.
8
- */
9
- export declare const calendarToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
10
- /**
11
- * Pre-configured {@link GoogleApiToolSet} for the Google BigQuery v2 API.
12
- */
13
- export declare const bigqueryToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
14
- /**
15
- * Pre-configured {@link GoogleApiToolSet} for the Gmail v1 API.
16
- */
17
- export declare const gmailToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
18
- /**
19
- * Pre-configured {@link GoogleApiToolSet} for the YouTube Data v3 API.
20
- */
21
- export declare const youtubeToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
22
- /**
23
- * Pre-configured {@link GoogleApiToolSet} for the Google Slides v1 API.
24
- */
25
- export declare const slidesToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
26
- /**
27
- * Pre-configured {@link GoogleApiToolSet} for the Google Sheets v4 API.
28
- */
29
- export declare const sheetsToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
30
- /**
31
- * Pre-configured {@link GoogleApiToolSet} for the Google Docs v1 API.
32
- */
33
- export declare const docsToolSet: import("./google_api_tool_set.js").GoogleApiToolSet;
@@ -1,103 +0,0 @@
1
- /**
2
- * @license
3
- * Copyright 2026 Google LLC
4
- * SPDX-License-Identifier: Apache-2.0
5
- */
6
- import { FunctionDeclaration } from '@google/genai';
7
- import { Context } from '../agents/context.js';
8
- import { SchemaLike } from '../utils/schema.js';
9
- import { FunctionTool, ToolInputParameters } from './function_tool.js';
10
- /**
11
- * Schema formats accepted on a wrapped LangChain tool.
12
- */
13
- export type LangchainSchemaLike = SchemaLike | {
14
- jsonSchema: () => Record<string, unknown>;
15
- } | {
16
- modelJsonSchema: () => Record<string, unknown>;
17
- } | Record<string, unknown>;
18
- /**
19
- * Structural interface for a LangChain tool instance.
20
- */
21
- export interface LangchainToolLike {
22
- /**
23
- * The name of the LangChain tool.
24
- */
25
- name?: string;
26
- /**
27
- * The description of the LangChain tool.
28
- */
29
- description?: string;
30
- /**
31
- * Optional parameter schema (`argsSchema`).
32
- */
33
- argsSchema?: LangchainSchemaLike;
34
- /**
35
- * Optional parameter schema (`StructuredTool.schema`).
36
- */
37
- schema?: LangchainSchemaLike;
38
- /**
39
- * Optional raw parameter properties map (`BaseTool.args`).
40
- */
41
- args?: Record<string, unknown>;
42
- /**
43
- * Executes the tool (`BaseTool._run`).
44
- */
45
- _run?(args: Record<string, unknown>, toolContext?: Context): unknown | Promise<unknown>;
46
- /**
47
- * Executes the tool (`StructuredTool._call`).
48
- */
49
- _call?(args: Record<string, unknown>, toolContext?: Context): unknown | Promise<unknown>;
50
- /**
51
- * Executes the tool (`Runnable.invoke`).
52
- */
53
- invoke?(args: Record<string, unknown>, toolContext?: Context): unknown | Promise<unknown>;
54
- /**
55
- * Executes a simple convention-based tool (`tool.run`).
56
- */
57
- run?(args: Record<string, unknown>, toolContext?: Context): unknown | Promise<unknown>;
58
- }
59
- /**
60
- * Configuration options for {@link LangchainTool}.
61
- */
62
- export interface LangchainToolConfig {
63
- /**
64
- * The wrapped LangChain tool instance.
65
- */
66
- tool: LangchainToolLike;
67
- /**
68
- * Optional custom name override.
69
- */
70
- name?: string;
71
- /**
72
- * Optional custom description override.
73
- */
74
- description?: string;
75
- }
76
- declare const LANGCHAIN_TOOL_SIGNATURE_SYMBOL: unique symbol;
77
- /**
78
- * Type guard to check if an object is an instance of {@link LangchainTool}.
79
- */
80
- export declare function isLangchainTool(obj: unknown): obj is LangchainTool;
81
- /**
82
- * Wrapper class that adapts a LangChain tool for use in ADK.
83
- *
84
- * If the original tool name and description are not suitable, you can override
85
- * them in the constructor.
86
- */
87
- export declare class LangchainTool extends FunctionTool<ToolInputParameters> {
88
- /** A unique symbol to identify ADK LangchainTool class. */
89
- readonly [LANGCHAIN_TOOL_SIGNATURE_SYMBOL] = true;
90
- /**
91
- * The wrapped LangChain tool.
92
- */
93
- readonly tool: LangchainToolLike;
94
- constructor(toolOrConfig: LangchainToolConfig | LangchainToolLike, options?: {
95
- name?: string;
96
- description?: string;
97
- });
98
- /**
99
- * Builds the `FunctionDeclaration` for the wrapped LangChain tool.
100
- */
101
- _getDeclaration(): FunctionDeclaration;
102
- }
103
- export {};
@@ -1,73 +0,0 @@
1
- /**
2
- * @license
3
- * Copyright 2026 Google LLC
4
- * SPDX-License-Identifier: Apache-2.0
5
- */
6
- import { LangchainTool, LangchainToolLike } from './langchain_tool.js';
7
- /**
8
- * Structural interface for a Toolbox client instance.
9
- */
10
- export interface ToolboxClientLike {
11
- /**
12
- * Loads a single tool by name (camelCase convention).
13
- */
14
- loadTool?: (toolName: string) => LangchainToolLike;
15
- /**
16
- * Loads a single tool by name (snake_case convention).
17
- */
18
- load_tool?: (toolName: string) => LangchainToolLike;
19
- /**
20
- * Loads a toolset by name (camelCase convention).
21
- */
22
- loadToolset?: (toolsetName: string) => LangchainToolLike[];
23
- /**
24
- * Loads a toolset by name (snake_case convention).
25
- */
26
- load_toolset?: (toolsetName: string) => LangchainToolLike[];
27
- }
28
- /**
29
- * Configuration options for {@link ToolboxTool}.
30
- */
31
- export interface ToolboxToolOptions {
32
- /**
33
- * The URL of the Toolbox server.
34
- */
35
- url?: string;
36
- /**
37
- * Optional pre-configured Toolbox client instance.
38
- */
39
- client?: ToolboxClientLike;
40
- }
41
- declare const TOOLBOX_TOOL_SIGNATURE_SYMBOL: unique symbol;
42
- /**
43
- * Type guard to check if an object is an instance of {@link ToolboxTool}.
44
- */
45
- export declare function isToolboxTool(obj: unknown): obj is ToolboxTool;
46
- /**
47
- * Provides access to Toolbox tools and toolsets wrapped as {@link LangchainTool}
48
- * instances.
49
- */
50
- export declare class ToolboxTool {
51
- /** A unique symbol to identify ADK ToolboxTool class. */
52
- readonly [TOOLBOX_TOOL_SIGNATURE_SYMBOL] = true;
53
- /**
54
- * The URL of the Toolbox server, if provided.
55
- */
56
- readonly url?: string;
57
- /**
58
- * The underlying Toolbox client.
59
- */
60
- readonly toolboxClient: ToolboxClientLike;
61
- constructor(urlOrOptions: string | ToolboxToolOptions);
62
- /**
63
- * Loads a single tool from the Toolbox client and wraps it in a
64
- * {@link LangchainTool}.
65
- */
66
- getTool(toolName: string): LangchainTool;
67
- /**
68
- * Loads a toolset from the Toolbox client and wraps each tool in a
69
- * {@link LangchainTool}.
70
- */
71
- getToolset(toolsetName: string): LangchainTool[];
72
- }
73
- export {};