@google/adk 1.5.0 → 2.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.
- package/dist/cjs/a2a/a2a_event.js +18 -0
- package/dist/cjs/a2a/a2a_remote_agent.js +17 -4
- package/dist/cjs/a2a/a2a_remote_agent_run_processor.js +7 -3
- package/dist/cjs/a2a/a2a_remote_agent_utils.js +9 -2
- package/dist/cjs/a2a/agent_card.js +33 -3
- package/dist/cjs/a2a/agent_executor.js +25 -16
- package/dist/cjs/a2a/agent_to_a2a.js +22 -11
- package/dist/cjs/a2a/auth.js +68 -0
- package/dist/cjs/a2a/event_converter_utils.js +50 -15
- package/dist/cjs/a2a/event_processor_utils.js +71 -35
- package/dist/cjs/a2a/executor_context.js +2 -0
- package/dist/cjs/a2a/index.js +53 -0
- package/dist/cjs/a2a/metadata_converter_utils.js +5 -0
- package/dist/cjs/a2a/part_converter_utils.js +12 -0
- package/dist/cjs/agents/active_streaming_tool.js +5 -2
- package/dist/cjs/agents/base_agent.js +46 -9
- package/dist/cjs/agents/context.js +5 -2
- package/dist/cjs/agents/framework_function_calls.js +64 -0
- package/dist/cjs/agents/functions.js +58 -23
- package/dist/cjs/agents/instructions.js +51 -12
- package/dist/cjs/agents/invocation_context.js +42 -8
- package/dist/cjs/agents/live_request_queue.js +29 -5
- package/dist/cjs/agents/llm_agent.js +536 -45
- package/dist/cjs/agents/loop_agent.js +19 -2
- package/dist/cjs/agents/parallel_agent.js +21 -2
- package/dist/cjs/agents/processors/agent_transfer_llm_request_processor.js +7 -4
- package/dist/cjs/agents/processors/base_llm_processor.js +9 -4
- package/dist/cjs/agents/processors/basic_llm_request_processor.js +8 -4
- package/dist/cjs/agents/processors/code_execution_request_processor.js +18 -5
- package/dist/cjs/agents/processors/content_processor_utils.js +85 -15
- package/dist/cjs/agents/processors/content_request_processor.js +11 -25
- package/dist/cjs/agents/processors/context_compactor_request_processor.js +5 -2
- package/dist/cjs/agents/processors/identity_llm_request_processor.js +12 -4
- package/dist/cjs/agents/processors/instructions_llm_request_processor.js +8 -3
- package/dist/cjs/agents/processors/interactions_request_processor.js +5 -2
- package/dist/cjs/agents/processors/request_confirmation_llm_request_processor.js +313 -92
- package/dist/cjs/agents/processors/request_input_llm_request_processor.js +218 -0
- package/dist/cjs/agents/processors/tool_filter_request_processor.js +5 -2
- package/dist/cjs/agents/readonly_context.js +7 -3
- package/dist/cjs/agents/routed_agent.js +6 -13
- package/dist/cjs/agents/run_config.js +12 -0
- package/dist/cjs/agents/sequential_agent.js +20 -3
- package/dist/cjs/agents/user_input_request.js +145 -0
- package/dist/cjs/apps/app.js +11 -11
- package/dist/cjs/apps/resumability_config.js +2 -0
- package/dist/cjs/artifacts/file_artifact_service.js +21 -2
- package/dist/cjs/artifacts/gcs_artifact_service.js +46 -11
- package/dist/cjs/artifacts/in_memory_artifact_service.js +19 -11
- package/dist/cjs/artifacts/registry.js +6 -1
- package/dist/cjs/artifacts/scoped_artifact_service.js +5 -2
- package/dist/cjs/auth/auth_handler.js +5 -2
- package/dist/cjs/auth/auth_preprocessor.js +48 -40
- package/dist/cjs/auth/auth_provider_registry.js +5 -2
- package/dist/cjs/auth/auth_schemes.js +2 -0
- package/dist/cjs/auth/credential_response_binding.js +101 -0
- package/dist/cjs/auth/credential_service/in_memory_credential_service.js +19 -5
- package/dist/cjs/auth/credential_service/session_state_credential_service.js +5 -2
- package/dist/cjs/auth/exchanger/base_credential_exchanger.js +5 -2
- package/dist/cjs/auth/exchanger/credential_exchanger_registry.js +5 -2
- package/dist/cjs/auth/oauth2/oauth2_credential_exchanger.js +8 -2
- package/dist/cjs/auth/oauth2/oauth2_credential_refresher.js +5 -2
- package/dist/cjs/auth/oauth2/oauth2_discovery.js +7 -2
- package/dist/cjs/auth/oauth2/oauth2_utils.js +6 -0
- package/dist/cjs/auth/refresher/base_credential_refresher.js +5 -2
- package/dist/cjs/auth/refresher/credential_refresher_registry.js +5 -2
- package/dist/cjs/code_executors/agent_engine_sandbox_code_executor.js +3 -0
- package/dist/cjs/code_executors/base_code_executor.js +6 -2
- package/dist/cjs/code_executors/built_in_code_executor.js +6 -2
- package/dist/cjs/code_executors/code_execution_utils.js +6 -0
- package/dist/cjs/code_executors/code_executor_context.js +5 -2
- package/dist/cjs/code_executors/unsafe_local_code_executor.js +31 -14
- package/dist/cjs/common.js +112 -1
- package/dist/cjs/context/agent_controlled_context_compactor.js +7 -13
- package/dist/cjs/context/anchored_context_compactor.js +5 -2
- package/dist/cjs/context/compaction_utils.js +17 -2
- package/dist/cjs/context/summarizers/llm_summarizer.js +5 -2
- package/dist/cjs/context/token_based_context_compactor.js +11 -23
- package/dist/cjs/context/trajectory_thought_pruning_compactor.js +5 -2
- package/dist/cjs/context/truncating_context_compactor.js +5 -2
- package/dist/cjs/environment/base_environment.js +97 -0
- package/dist/cjs/environment/local_environment.js +186 -0
- package/dist/cjs/events/compacted_event.js +4 -0
- package/dist/cjs/events/event.js +38 -3
- package/dist/cjs/events/event_actions.js +5 -0
- package/dist/cjs/events/structured_events.js +2 -0
- package/dist/cjs/examples/base_example_provider.js +6 -2
- package/dist/cjs/examples/example_util.js +3 -0
- package/dist/cjs/features/feature_registry.js +7 -0
- package/dist/cjs/index.js +7 -22
- package/dist/cjs/integrations/agent_registry/agent_registry.js +7 -4
- package/dist/cjs/integrations/agent_registry/agent_registry_mcp_toolset.js +7 -4
- package/dist/cjs/integrations/agent_registry/helpers.js +3 -0
- package/dist/cjs/memory/in_memory_memory_service.js +21 -4
- package/dist/cjs/memory/vertex_ai_memory_bank_service.js +20 -2
- package/dist/cjs/models/apigee_llm.js +9 -3
- package/dist/cjs/models/base_llm.js +7 -3
- package/dist/cjs/models/gemini_llm_connection.js +5 -2
- package/dist/cjs/models/google_llm.js +24 -12
- package/dist/cjs/models/interactions_utils.js +16 -0
- package/dist/cjs/models/llm_request.js +4 -0
- package/dist/cjs/models/llm_response.js +2 -0
- package/dist/cjs/models/registry.js +6 -2
- package/dist/cjs/models/routed_llm.js +4 -13
- package/dist/cjs/plugins/base_plugin.js +43 -7
- package/dist/cjs/plugins/global_instruction_plugin.js +5 -2
- package/dist/cjs/plugins/logging_plugin.js +13 -8
- package/dist/cjs/plugins/plugin_manager.js +37 -2
- package/dist/cjs/plugins/security_plugin.js +15 -8
- package/dist/cjs/runner/in_memory_runner.js +5 -2
- package/dist/cjs/runner/runner.js +226 -29
- package/dist/cjs/sessions/base_session_service.js +21 -5
- package/dist/cjs/sessions/database_session_service.js +6 -2
- package/dist/cjs/sessions/db/operations.js +34 -6
- package/dist/cjs/sessions/db/schema.js +16 -8
- package/dist/cjs/sessions/in_memory_session_service.js +30 -22
- package/dist/cjs/sessions/registry.js +4 -1
- package/dist/cjs/sessions/session.js +2 -0
- package/dist/cjs/sessions/state.js +80 -8
- package/dist/cjs/sessions/state_write_order.js +105 -0
- package/dist/cjs/sessions/vertex_ai_session_service.js +132 -25
- package/dist/cjs/skills/gcp_skill_registry.js +2 -0
- package/dist/cjs/skills/loader.js +62 -16
- package/dist/cjs/skills/prompt.js +3 -0
- package/dist/cjs/telemetry/google_cloud.js +42 -9
- package/dist/cjs/telemetry/setup.js +5 -0
- package/dist/cjs/telemetry/tracing.js +60 -4
- package/dist/cjs/tools/agent_tool.js +6 -2
- package/dist/cjs/tools/base_tool.js +24 -2
- package/dist/cjs/tools/base_toolset.js +6 -2
- package/dist/cjs/tools/consolidate_context_tool.js +5 -2
- package/dist/cjs/tools/enterprise_web_search_tool.js +6 -2
- package/dist/cjs/tools/example_tool.js +5 -2
- package/dist/cjs/tools/exit_loop_tool.js +5 -2
- package/dist/cjs/tools/finish_task_tool.js +119 -0
- package/dist/cjs/tools/forwarding_artifact_service.js +5 -2
- package/dist/cjs/tools/function_tool.js +73 -8
- package/dist/cjs/tools/get_user_choice_tool.js +54 -0
- package/dist/cjs/tools/google_maps_grounding_tool.js +6 -2
- package/dist/cjs/tools/google_search_tool.js +5 -2
- package/dist/cjs/tools/load_artifacts_tool.js +8 -2
- package/dist/cjs/tools/load_memory_tool.js +5 -2
- package/dist/cjs/tools/load_web_page.js +21 -1
- package/dist/cjs/tools/long_running_tool.js +5 -2
- package/dist/cjs/tools/mcp/index.js +39 -0
- package/dist/cjs/tools/mcp/load_mcp_resource_tool.js +5 -2
- package/dist/cjs/tools/mcp/mcp_session_manager.js +69 -27
- package/dist/cjs/tools/mcp/mcp_tool.js +5 -2
- package/dist/cjs/tools/mcp/mcp_toolset.js +5 -2
- package/dist/cjs/tools/openapi_tool/auth/auth_helpers.js +4 -0
- package/dist/cjs/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js +2 -0
- package/dist/cjs/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js +2 -0
- package/dist/cjs/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js +30 -9
- package/dist/cjs/tools/openapi_tool/openapi_spec_parser/operation_parser.js +2 -0
- package/dist/cjs/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js +6 -2
- package/dist/cjs/tools/openapi_tool/openapi_toolset.js +2 -0
- package/dist/cjs/tools/openapi_tool/rest_api_tool.js +23 -5
- package/dist/cjs/tools/preload_memory_tool.js +5 -2
- package/dist/cjs/tools/request_input_tool.js +56 -0
- package/dist/cjs/tools/skill/list_skills_tool.js +2 -0
- package/dist/cjs/tools/skill/load_skill_resource_tool.js +2 -0
- package/dist/cjs/tools/skill/load_skill_tool.js +4 -1
- package/dist/cjs/tools/skill/run_skill_inline_script_tool.js +8 -2
- package/dist/cjs/tools/skill/run_skill_script_tool.js +10 -2
- package/dist/cjs/tools/skill/search_skills_tool.js +2 -0
- package/dist/cjs/tools/skill/skill_toolset.js +35 -0
- package/dist/cjs/tools/tool_confirmation.js +26 -3
- package/dist/cjs/tools/url_context_tool.js +5 -2
- package/dist/cjs/tools/vertex_ai_search_tool.js +5 -2
- package/dist/cjs/tools/vertex_rag_retrieval_tool.js +5 -2
- package/dist/cjs/utils/async_hooks_shim.js +5 -2
- package/dist/cjs/utils/async_queue.js +45 -18
- package/dist/cjs/utils/branch_trie.js +2 -0
- package/dist/cjs/utils/case_utils.js +2 -0
- package/dist/cjs/utils/client_labels.js +5 -0
- package/dist/cjs/utils/crypto_shim.js +45 -0
- package/dist/cjs/utils/deprecated.js +68 -0
- package/dist/cjs/utils/env_aware_utils.js +56 -13
- package/dist/cjs/utils/error_utils.js +128 -0
- package/dist/cjs/utils/experimental.js +9 -2
- package/dist/cjs/utils/failover_utils.js +3 -0
- package/dist/cjs/utils/file_extension_utils.js +3 -0
- package/dist/cjs/utils/file_utils.js +12 -4
- package/dist/cjs/utils/gemini_schema_util.js +6 -2
- package/dist/cjs/utils/genai_schema_to_json.js +107 -0
- package/dist/cjs/utils/live_connection_utils.js +5 -2
- package/dist/cjs/utils/logger.js +13 -4
- package/dist/cjs/utils/model_name.js +8 -0
- package/dist/cjs/utils/object_notation_utils.js +7 -3
- package/dist/cjs/utils/optional_peer.js +68 -0
- package/dist/cjs/utils/output_schema_utils.js +45 -0
- package/dist/cjs/utils/partial_copy.js +2 -0
- package/dist/cjs/utils/redact_uri.js +66 -0
- package/dist/cjs/utils/schema.js +178 -0
- package/dist/cjs/utils/simple_zod_to_json.js +17 -4
- package/dist/cjs/utils/streaming_utils.js +14 -6
- package/dist/cjs/utils/task.js +7 -4
- package/dist/cjs/utils/variant_utils.js +3 -1
- package/dist/cjs/utils/vertex_ai_utils.js +6 -1
- package/dist/cjs/version.js +1 -1
- package/dist/cjs/workflow/base_node.js +211 -0
- package/dist/cjs/workflow/branch_path.js +108 -0
- package/dist/cjs/workflow/dynamic_node_scheduler.js +220 -0
- package/dist/cjs/workflow/errors.js +178 -0
- package/dist/cjs/workflow/graph.js +158 -0
- package/dist/cjs/workflow/index.js +131 -0
- package/dist/cjs/workflow/node.js +65 -0
- package/dist/cjs/workflow/node_builders.js +68 -0
- package/dist/cjs/workflow/node_context.js +246 -0
- package/dist/cjs/workflow/node_error_event.js +86 -0
- package/dist/cjs/workflow/node_runner.js +459 -0
- package/dist/cjs/workflow/node_state.js +57 -0
- package/dist/cjs/workflow/node_status.js +48 -0
- package/dist/cjs/workflow/nodes/function_node.js +195 -0
- package/dist/cjs/workflow/nodes/join_node.js +56 -0
- package/dist/cjs/workflow/nodes/node_tool.js +156 -0
- package/dist/cjs/workflow/nodes/parallel_worker.js +129 -0
- package/dist/cjs/workflow/nodes/tool_node.js +117 -0
- package/dist/cjs/workflow/request_input.js +64 -0
- package/dist/cjs/workflow/retry_config.js +71 -0
- package/dist/cjs/workflow/run_llm_agent_as_node.js +192 -0
- package/dist/cjs/workflow/run_node_as_invocation.js +165 -0
- package/dist/cjs/workflow/schedule_dynamic_node.js +53 -0
- package/dist/cjs/workflow/trigger.js +27 -0
- package/dist/cjs/workflow/utils/graph_parser.js +212 -0
- package/dist/cjs/workflow/utils/graph_validation.js +216 -0
- package/dist/cjs/workflow/utils/hitl_utils.js +252 -0
- package/dist/cjs/workflow/utils/rehydration_utils.js +373 -0
- package/dist/cjs/workflow/utils/retry_utils.js +112 -0
- package/dist/cjs/workflow/utils/workflow_graph_utils.js +144 -0
- package/dist/cjs/workflow/workflow.js +509 -0
- package/dist/esm/a2a/a2a_event.js +19 -0
- package/dist/esm/a2a/a2a_remote_agent.js +18 -4
- package/dist/esm/a2a/a2a_remote_agent_run_processor.js +8 -3
- package/dist/esm/a2a/a2a_remote_agent_utils.js +10 -2
- package/dist/esm/a2a/agent_card.js +34 -3
- package/dist/esm/a2a/agent_executor.js +27 -17
- package/dist/esm/a2a/agent_to_a2a.js +44 -16
- package/dist/esm/a2a/auth.js +41 -0
- package/dist/esm/a2a/event_converter_utils.js +51 -15
- package/dist/esm/a2a/event_processor_utils.js +74 -34
- package/dist/esm/a2a/executor_context.js +3 -0
- package/dist/esm/a2a/index.js +20 -0
- package/dist/esm/a2a/metadata_converter_utils.js +6 -0
- package/dist/esm/a2a/part_converter_utils.js +13 -0
- package/dist/esm/agents/active_streaming_tool.js +6 -2
- package/dist/esm/agents/base_agent.js +47 -9
- package/dist/esm/agents/context.js +6 -2
- package/dist/esm/agents/framework_function_calls.js +34 -0
- package/dist/esm/agents/functions.js +62 -20
- package/dist/esm/agents/instructions.js +52 -12
- package/dist/esm/agents/invocation_context.js +41 -7
- package/dist/esm/agents/live_request_queue.js +30 -5
- package/dist/esm/agents/llm_agent.js +537 -45
- package/dist/esm/agents/loop_agent.js +21 -2
- package/dist/esm/agents/parallel_agent.js +23 -2
- package/dist/esm/agents/processors/agent_transfer_llm_request_processor.js +8 -4
- package/dist/esm/agents/processors/base_llm_processor.js +10 -4
- package/dist/esm/agents/processors/basic_llm_request_processor.js +9 -4
- package/dist/esm/agents/processors/code_execution_request_processor.js +19 -5
- package/dist/esm/agents/processors/content_processor_utils.js +88 -16
- package/dist/esm/agents/processors/content_request_processor.js +12 -25
- package/dist/esm/agents/processors/context_compactor_request_processor.js +6 -2
- package/dist/esm/agents/processors/identity_llm_request_processor.js +13 -4
- package/dist/esm/agents/processors/instructions_llm_request_processor.js +9 -3
- package/dist/esm/agents/processors/interactions_request_processor.js +6 -2
- package/dist/esm/agents/processors/request_confirmation_llm_request_processor.js +318 -93
- package/dist/esm/agents/processors/request_input_llm_request_processor.js +197 -0
- package/dist/esm/agents/processors/tool_filter_request_processor.js +6 -2
- package/dist/esm/agents/readonly_context.js +8 -3
- package/dist/esm/agents/routed_agent.js +6 -14
- package/dist/esm/agents/run_config.js +13 -0
- package/dist/esm/agents/sequential_agent.js +22 -3
- package/dist/esm/agents/user_input_request.js +120 -0
- package/dist/esm/apps/app.js +14 -11
- package/dist/esm/apps/resumability_config.js +3 -0
- package/dist/esm/artifacts/file_artifact_service.js +22 -2
- package/dist/esm/artifacts/gcs_artifact_service.js +58 -11
- package/dist/esm/artifacts/in_memory_artifact_service.js +20 -11
- package/dist/esm/artifacts/registry.js +7 -1
- package/dist/esm/artifacts/scoped_artifact_service.js +6 -2
- package/dist/esm/auth/auth_handler.js +6 -2
- package/dist/esm/auth/auth_preprocessor.js +50 -41
- package/dist/esm/auth/auth_provider_registry.js +6 -2
- package/dist/esm/auth/auth_schemes.js +3 -0
- package/dist/esm/auth/credential_response_binding.js +74 -0
- package/dist/esm/auth/credential_service/in_memory_credential_service.js +20 -5
- package/dist/esm/auth/credential_service/session_state_credential_service.js +6 -2
- package/dist/esm/auth/exchanger/base_credential_exchanger.js +6 -2
- package/dist/esm/auth/exchanger/credential_exchanger_registry.js +6 -2
- package/dist/esm/auth/oauth2/oauth2_credential_exchanger.js +9 -2
- package/dist/esm/auth/oauth2/oauth2_credential_refresher.js +6 -2
- package/dist/esm/auth/oauth2/oauth2_discovery.js +8 -2
- package/dist/esm/auth/oauth2/oauth2_utils.js +7 -0
- package/dist/esm/auth/refresher/base_credential_refresher.js +6 -2
- package/dist/esm/auth/refresher/credential_refresher_registry.js +6 -2
- package/dist/esm/code_executors/agent_engine_sandbox_code_executor.js +3 -0
- package/dist/esm/code_executors/base_code_executor.js +7 -2
- package/dist/esm/code_executors/built_in_code_executor.js +7 -2
- package/dist/esm/code_executors/code_execution_utils.js +7 -0
- package/dist/esm/code_executors/code_executor_context.js +6 -2
- package/dist/esm/code_executors/unsafe_local_code_executor.js +31 -13
- package/dist/esm/common.js +113 -4
- package/dist/esm/context/agent_controlled_context_compactor.js +8 -13
- package/dist/esm/context/anchored_context_compactor.js +6 -2
- package/dist/esm/context/compaction_utils.js +16 -1
- package/dist/esm/context/summarizers/llm_summarizer.js +6 -2
- package/dist/esm/context/token_based_context_compactor.js +16 -24
- package/dist/esm/context/trajectory_thought_pruning_compactor.js +6 -2
- package/dist/esm/context/truncating_context_compactor.js +6 -2
- package/dist/esm/environment/base_environment.js +71 -0
- package/dist/esm/environment/local_environment.js +150 -0
- package/dist/esm/events/compacted_event.js +5 -0
- package/dist/esm/events/event.js +38 -3
- package/dist/esm/events/event_actions.js +6 -0
- package/dist/esm/events/structured_events.js +3 -0
- package/dist/esm/examples/base_example_provider.js +7 -2
- package/dist/esm/examples/example_util.js +4 -0
- package/dist/esm/features/feature_registry.js +8 -0
- package/dist/esm/index.js +4 -13
- package/dist/esm/integrations/agent_registry/agent_registry.js +8 -4
- package/dist/esm/integrations/agent_registry/agent_registry_mcp_toolset.js +6 -2
- package/dist/esm/integrations/agent_registry/helpers.js +4 -0
- package/dist/esm/memory/in_memory_memory_service.js +22 -4
- package/dist/esm/memory/vertex_ai_memory_bank_service.js +25 -3
- package/dist/esm/models/apigee_llm.js +10 -3
- package/dist/esm/models/base_llm.js +8 -3
- package/dist/esm/models/gemini_llm_connection.js +6 -2
- package/dist/esm/models/google_llm.js +26 -13
- package/dist/esm/models/interactions_utils.js +17 -0
- package/dist/esm/models/llm_request.js +5 -0
- package/dist/esm/models/llm_response.js +3 -0
- package/dist/esm/models/registry.js +7 -2
- package/dist/esm/models/routed_llm.js +4 -14
- package/dist/esm/plugins/base_plugin.js +43 -7
- package/dist/esm/plugins/global_instruction_plugin.js +6 -2
- package/dist/esm/plugins/logging_plugin.js +14 -8
- package/dist/esm/plugins/plugin_manager.js +38 -2
- package/dist/esm/plugins/security_plugin.js +14 -6
- package/dist/esm/runner/in_memory_runner.js +6 -2
- package/dist/esm/runner/runner.js +233 -31
- package/dist/esm/sessions/base_session_service.js +22 -5
- package/dist/esm/sessions/database_session_service.js +7 -2
- package/dist/esm/sessions/db/operations.js +34 -6
- package/dist/esm/sessions/db/schema.js +16 -8
- package/dist/esm/sessions/in_memory_session_service.js +31 -22
- package/dist/esm/sessions/registry.js +5 -1
- package/dist/esm/sessions/session.js +3 -0
- package/dist/esm/sessions/state.js +78 -7
- package/dist/esm/sessions/state_write_order.js +74 -0
- package/dist/esm/sessions/vertex_ai_session_service.js +136 -26
- package/dist/esm/skills/gcp_skill_registry.js +2 -0
- package/dist/esm/skills/loader.js +63 -16
- package/dist/esm/skills/prompt.js +4 -0
- package/dist/esm/telemetry/google_cloud.js +54 -9
- package/dist/esm/telemetry/setup.js +6 -0
- package/dist/esm/telemetry/tracing.js +59 -4
- package/dist/esm/tools/agent_tool.js +7 -2
- package/dist/esm/tools/base_tool.js +25 -2
- package/dist/esm/tools/base_toolset.js +7 -2
- package/dist/esm/tools/consolidate_context_tool.js +6 -2
- package/dist/esm/tools/enterprise_web_search_tool.js +7 -2
- package/dist/esm/tools/example_tool.js +6 -2
- package/dist/esm/tools/exit_loop_tool.js +6 -2
- package/dist/esm/tools/finish_task_tool.js +92 -0
- package/dist/esm/tools/forwarding_artifact_service.js +6 -2
- package/dist/esm/tools/function_tool.js +74 -8
- package/dist/esm/tools/get_user_choice_tool.js +27 -0
- package/dist/esm/tools/google_maps_grounding_tool.js +7 -2
- package/dist/esm/tools/google_search_tool.js +6 -2
- package/dist/esm/tools/load_artifacts_tool.js +9 -2
- package/dist/esm/tools/load_memory_tool.js +6 -2
- package/dist/esm/tools/load_web_page.js +22 -1
- package/dist/esm/tools/long_running_tool.js +6 -2
- package/dist/esm/tools/mcp/index.js +11 -0
- package/dist/esm/tools/mcp/load_mcp_resource_tool.js +6 -2
- package/dist/esm/tools/mcp/mcp_session_manager.js +80 -30
- package/dist/esm/tools/mcp/mcp_tool.js +6 -2
- package/dist/esm/tools/mcp/mcp_toolset.js +6 -2
- package/dist/esm/tools/openapi_tool/auth/auth_helpers.js +5 -0
- package/dist/esm/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js +2 -0
- package/dist/esm/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js +2 -0
- package/dist/esm/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js +30 -9
- package/dist/esm/tools/openapi_tool/openapi_spec_parser/operation_parser.js +2 -0
- package/dist/esm/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js +6 -2
- package/dist/esm/tools/openapi_tool/openapi_toolset.js +2 -0
- package/dist/esm/tools/openapi_tool/rest_api_tool.js +23 -5
- package/dist/esm/tools/preload_memory_tool.js +6 -2
- package/dist/esm/tools/request_input_tool.js +29 -0
- package/dist/esm/tools/skill/list_skills_tool.js +2 -0
- package/dist/esm/tools/skill/load_skill_resource_tool.js +2 -0
- package/dist/esm/tools/skill/load_skill_tool.js +4 -1
- package/dist/esm/tools/skill/run_skill_inline_script_tool.js +8 -2
- package/dist/esm/tools/skill/run_skill_script_tool.js +10 -2
- package/dist/esm/tools/skill/search_skills_tool.js +2 -0
- package/dist/esm/tools/skill/skill_toolset.js +25 -0
- package/dist/esm/tools/tool_confirmation.js +24 -2
- package/dist/esm/tools/url_context_tool.js +6 -2
- package/dist/esm/tools/vertex_ai_search_tool.js +6 -2
- package/dist/esm/tools/vertex_rag_retrieval_tool.js +6 -2
- package/dist/esm/utils/async_hooks_shim.js +6 -2
- package/dist/esm/utils/async_queue.js +46 -18
- package/dist/esm/utils/branch_trie.js +3 -0
- package/dist/esm/utils/case_utils.js +3 -0
- package/dist/esm/utils/client_labels.js +6 -0
- package/dist/esm/utils/crypto_shim.js +18 -0
- package/dist/esm/utils/deprecated.js +40 -0
- package/dist/esm/utils/env_aware_utils.js +56 -13
- package/dist/esm/utils/error_utils.js +101 -0
- package/dist/esm/utils/experimental.js +10 -2
- package/dist/esm/utils/failover_utils.js +4 -0
- package/dist/esm/utils/file_extension_utils.js +4 -0
- package/dist/esm/utils/file_utils.js +13 -4
- package/dist/esm/utils/gemini_schema_util.js +7 -2
- package/dist/esm/utils/genai_schema_to_json.js +80 -0
- package/dist/esm/utils/live_connection_utils.js +6 -2
- package/dist/esm/utils/logger.js +14 -4
- package/dist/esm/utils/model_name.js +9 -0
- package/dist/esm/utils/object_notation_utils.js +8 -3
- package/dist/esm/utils/optional_peer.js +41 -0
- package/dist/esm/utils/output_schema_utils.js +18 -0
- package/dist/esm/utils/partial_copy.js +3 -0
- package/dist/esm/utils/redact_uri.js +39 -0
- package/dist/esm/utils/schema.js +152 -0
- package/dist/esm/utils/simple_zod_to_json.js +15 -4
- package/dist/esm/utils/streaming_utils.js +15 -6
- package/dist/esm/utils/task.js +8 -4
- package/dist/esm/utils/variant_utils.js +5 -2
- package/dist/esm/utils/vertex_ai_utils.js +7 -2
- package/dist/esm/version.js +1 -1
- package/dist/esm/workflow/base_node.js +182 -0
- package/dist/esm/workflow/branch_path.js +77 -0
- package/dist/esm/workflow/dynamic_node_scheduler.js +202 -0
- package/dist/esm/workflow/errors.js +140 -0
- package/dist/esm/workflow/graph.js +127 -0
- package/dist/esm/workflow/index.js +80 -0
- package/dist/esm/workflow/node.js +38 -0
- package/dist/esm/workflow/node_builders.js +40 -0
- package/dist/esm/workflow/node_context.js +219 -0
- package/dist/esm/workflow/node_error_event.js +57 -0
- package/dist/esm/workflow/node_runner.js +439 -0
- package/dist/esm/workflow/node_state.js +29 -0
- package/dist/esm/workflow/node_status.js +20 -0
- package/dist/esm/workflow/nodes/function_node.js +172 -0
- package/dist/esm/workflow/nodes/join_node.js +29 -0
- package/dist/esm/workflow/nodes/node_tool.js +131 -0
- package/dist/esm/workflow/nodes/parallel_worker.js +102 -0
- package/dist/esm/workflow/nodes/tool_node.js +90 -0
- package/dist/esm/workflow/request_input.js +36 -0
- package/dist/esm/workflow/retry_config.js +43 -0
- package/dist/esm/workflow/run_llm_agent_as_node.js +172 -0
- package/dist/esm/workflow/run_node_as_invocation.js +139 -0
- package/dist/esm/workflow/schedule_dynamic_node.js +26 -0
- package/dist/esm/workflow/trigger.js +7 -0
- package/dist/esm/workflow/utils/graph_parser.js +188 -0
- package/dist/esm/workflow/utils/graph_validation.js +189 -0
- package/dist/esm/workflow/utils/hitl_utils.js +222 -0
- package/dist/esm/workflow/utils/rehydration_utils.js +342 -0
- package/dist/esm/workflow/utils/retry_utils.js +82 -0
- package/dist/esm/workflow/utils/workflow_graph_utils.js +115 -0
- package/dist/esm/workflow/workflow.js +493 -0
- package/dist/types/a2a/agent_card.d.ts +3 -3
- package/dist/types/a2a/agent_to_a2a.d.ts +4 -4
- package/dist/types/a2a/auth.d.ts +30 -0
- package/dist/types/a2a/event_converter_utils.d.ts +4 -1
- package/dist/types/a2a/event_processor_utils.d.ts +17 -2
- package/dist/types/a2a/index.d.ts +18 -0
- package/dist/types/agents/base_agent.d.ts +37 -9
- package/dist/types/agents/framework_function_calls.d.ts +26 -0
- package/dist/types/agents/functions.d.ts +1 -2
- package/dist/types/agents/invocation_context.d.ts +95 -3
- package/dist/types/agents/live_request_queue.d.ts +7 -1
- package/dist/types/agents/llm_agent.d.ts +77 -1
- package/dist/types/agents/loop_agent.d.ts +5 -0
- package/dist/types/agents/parallel_agent.d.ts +5 -0
- package/dist/types/agents/processors/content_processor_utils.d.ts +3 -2
- package/dist/types/agents/processors/identity_llm_request_processor.d.ts +4 -1
- package/dist/types/agents/processors/request_input_llm_request_processor.d.ts +21 -0
- package/dist/types/agents/run_config.d.ts +57 -2
- package/dist/types/agents/sequential_agent.d.ts +5 -0
- package/dist/types/agents/user_input_request.d.ts +71 -0
- package/dist/types/apps/app.d.ts +8 -3
- package/dist/types/artifacts/gcs_artifact_service.d.ts +9 -2
- package/dist/types/auth/credential_response_binding.d.ts +24 -0
- package/dist/types/auth/credential_service/in_memory_credential_service.d.ts +11 -0
- package/dist/types/code_executors/unsafe_local_code_executor.d.ts +5 -1
- package/dist/types/common.d.ts +20 -8
- package/dist/types/context/agent_controlled_context_compactor.d.ts +0 -1
- package/dist/types/context/compaction_utils.d.ts +8 -0
- package/dist/types/context/token_based_context_compactor.d.ts +0 -1
- package/dist/types/environment/base_environment.d.ts +101 -0
- package/dist/types/environment/local_environment.d.ts +72 -0
- package/dist/types/events/event.d.ts +94 -1
- package/dist/types/events/event_actions.d.ts +10 -0
- package/dist/types/index.d.ts +6 -13
- package/dist/types/memory/in_memory_memory_service.d.ts +11 -0
- package/dist/types/models/apigee_llm.d.ts +4 -4
- package/dist/types/models/google_llm.d.ts +2 -1
- package/dist/types/plugins/base_plugin.d.ts +39 -2
- package/dist/types/plugins/plugin_manager.d.ts +20 -0
- package/dist/types/plugins/security_plugin.d.ts +4 -2
- package/dist/types/runner/in_memory_runner.d.ts +2 -2
- package/dist/types/runner/runner.d.ts +59 -3
- package/dist/types/sessions/base_session_service.d.ts +10 -2
- package/dist/types/sessions/in_memory_session_service.d.ts +9 -0
- package/dist/types/sessions/state.d.ts +34 -1
- package/dist/types/sessions/state_write_order.d.ts +39 -0
- package/dist/types/sessions/vertex_ai_session_service.d.ts +19 -1
- package/dist/types/skills/loader.d.ts +5 -0
- package/dist/types/telemetry/tracing.d.ts +15 -0
- package/dist/types/tools/base_tool.d.ts +15 -0
- package/dist/types/tools/finish_task_tool.d.ts +47 -0
- package/dist/types/tools/function_tool.d.ts +46 -1
- package/dist/types/tools/get_user_choice_tool.d.ts +14 -0
- package/dist/types/tools/mcp/index.d.ts +13 -0
- package/dist/types/tools/mcp/mcp_session_manager.d.ts +3 -3
- package/dist/types/tools/mcp/mcp_tool.d.ts +1 -1
- package/dist/types/tools/mcp/mcp_toolset.d.ts +1 -1
- package/dist/types/tools/request_input_tool.d.ts +20 -0
- package/dist/types/tools/skill/skill_toolset.d.ts +26 -0
- package/dist/types/tools/tool_confirmation.d.ts +47 -0
- package/dist/types/utils/async_queue.d.ts +34 -2
- package/dist/types/utils/crypto_shim.d.ts +16 -0
- package/dist/types/utils/deprecated.d.ts +21 -0
- package/dist/types/utils/env_aware_utils.d.ts +39 -0
- package/dist/types/utils/error_utils.d.ts +18 -0
- package/dist/types/utils/file_utils.d.ts +10 -2
- package/dist/types/utils/genai_schema_to_json.d.ts +25 -0
- package/dist/types/utils/optional_peer.d.ts +36 -0
- package/dist/types/utils/output_schema_utils.d.ts +18 -0
- package/dist/types/utils/redact_uri.d.ts +28 -0
- package/dist/types/utils/schema.d.ts +73 -0
- package/dist/types/utils/simple_zod_to_json.d.ts +8 -0
- package/dist/types/utils/vertex_ai_utils.d.ts +5 -0
- package/dist/types/version.d.ts +1 -1
- package/dist/types/workflow/base_node.d.ts +142 -0
- package/dist/types/workflow/branch_path.d.ts +40 -0
- package/dist/types/workflow/dynamic_node_scheduler.d.ts +64 -0
- package/dist/types/workflow/errors.d.ts +132 -0
- package/dist/types/workflow/graph.d.ts +127 -0
- package/dist/types/workflow/index.d.ts +46 -0
- package/dist/types/workflow/node.d.ts +48 -0
- package/dist/types/workflow/node_builders.d.ts +25 -0
- package/dist/types/workflow/node_context.d.ts +208 -0
- package/dist/types/workflow/node_error_event.d.ts +18 -0
- package/dist/types/workflow/node_runner.d.ts +82 -0
- package/dist/types/workflow/node_state.d.ts +47 -0
- package/dist/types/workflow/node_status.d.ts +28 -0
- package/dist/types/workflow/nodes/function_node.d.ts +78 -0
- package/dist/types/workflow/nodes/join_node.d.ts +24 -0
- package/dist/types/workflow/nodes/node_tool.d.ts +53 -0
- package/dist/types/workflow/nodes/parallel_worker.d.ts +55 -0
- package/dist/types/workflow/nodes/tool_node.d.ts +34 -0
- package/dist/types/workflow/request_input.d.ts +73 -0
- package/dist/types/workflow/retry_config.d.ts +84 -0
- package/dist/types/workflow/run_llm_agent_as_node.d.ts +28 -0
- package/dist/types/workflow/run_node_as_invocation.d.ts +72 -0
- package/dist/types/workflow/schedule_dynamic_node.d.ts +66 -0
- package/dist/types/workflow/trigger.d.ts +22 -0
- package/dist/types/workflow/utils/graph_parser.d.ts +8 -0
- package/dist/types/workflow/utils/graph_validation.d.ts +18 -0
- package/dist/types/workflow/utils/hitl_utils.d.ts +92 -0
- package/dist/types/workflow/utils/rehydration_utils.d.ts +132 -0
- package/dist/types/workflow/utils/retry_utils.d.ts +54 -0
- package/dist/types/workflow/utils/workflow_graph_utils.d.ts +76 -0
- package/dist/types/workflow/workflow.d.ts +115 -0
- package/dist/web/a2a/a2a_event.js +19 -0
- package/dist/web/a2a/a2a_remote_agent.js +18 -4
- package/dist/web/a2a/a2a_remote_agent_run_processor.js +8 -3
- package/dist/web/a2a/a2a_remote_agent_utils.js +10 -2
- package/dist/web/a2a/agent_card.js +34 -3
- package/dist/web/a2a/agent_executor.js +45 -17
- package/dist/web/a2a/agent_to_a2a.js +44 -16
- package/dist/web/a2a/auth.js +41 -0
- package/dist/web/a2a/event_converter_utils.js +50 -15
- package/dist/web/a2a/event_processor_utils.js +73 -34
- package/dist/web/a2a/executor_context.js +3 -0
- package/dist/web/a2a/index.js +20 -0
- package/dist/web/a2a/metadata_converter_utils.js +5 -0
- package/dist/web/a2a/part_converter_utils.js +13 -0
- package/dist/web/agents/active_streaming_tool.js +6 -2
- package/dist/web/agents/base_agent.js +48 -9
- package/dist/web/agents/context.js +6 -2
- package/dist/web/agents/framework_function_calls.js +34 -0
- package/dist/web/agents/functions.js +62 -20
- package/dist/web/agents/instructions.js +52 -12
- package/dist/web/agents/invocation_context.js +56 -7
- package/dist/web/agents/live_request_queue.js +30 -5
- package/dist/web/agents/llm_agent.js +631 -52
- package/dist/web/agents/loop_agent.js +21 -2
- package/dist/web/agents/parallel_agent.js +23 -2
- package/dist/web/agents/processors/agent_transfer_llm_request_processor.js +8 -4
- package/dist/web/agents/processors/base_llm_processor.js +10 -4
- package/dist/web/agents/processors/basic_llm_request_processor.js +8 -4
- package/dist/web/agents/processors/code_execution_request_processor.js +19 -5
- package/dist/web/agents/processors/content_processor_utils.js +87 -16
- package/dist/web/agents/processors/content_request_processor.js +12 -25
- package/dist/web/agents/processors/context_compactor_request_processor.js +6 -2
- package/dist/web/agents/processors/identity_llm_request_processor.js +13 -4
- package/dist/web/agents/processors/instructions_llm_request_processor.js +9 -3
- package/dist/web/agents/processors/interactions_request_processor.js +6 -2
- package/dist/web/agents/processors/request_confirmation_llm_request_processor.js +329 -104
- package/dist/web/agents/processors/request_input_llm_request_processor.js +228 -0
- package/dist/web/agents/processors/tool_filter_request_processor.js +6 -2
- package/dist/web/agents/readonly_context.js +8 -3
- package/dist/web/agents/routed_agent.js +6 -14
- package/dist/web/agents/run_config.js +12 -0
- package/dist/web/agents/sequential_agent.js +22 -3
- package/dist/web/agents/user_input_request.js +135 -0
- package/dist/web/apps/app.js +14 -11
- package/dist/web/apps/resumability_config.js +2 -0
- package/dist/web/artifacts/file_artifact_service.js +22 -2
- package/dist/web/artifacts/gcs_artifact_service.js +56 -11
- package/dist/web/artifacts/in_memory_artifact_service.js +20 -11
- package/dist/web/artifacts/registry.js +7 -1
- package/dist/web/artifacts/scoped_artifact_service.js +5 -2
- package/dist/web/auth/auth_handler.js +5 -2
- package/dist/web/auth/auth_preprocessor.js +50 -41
- package/dist/web/auth/auth_provider_registry.js +6 -2
- package/dist/web/auth/auth_schemes.js +3 -0
- package/dist/web/auth/credential_response_binding.js +91 -0
- package/dist/web/auth/credential_service/in_memory_credential_service.js +20 -5
- package/dist/web/auth/credential_service/session_state_credential_service.js +6 -2
- package/dist/web/auth/exchanger/base_credential_exchanger.js +6 -2
- package/dist/web/auth/exchanger/credential_exchanger_registry.js +6 -2
- package/dist/web/auth/oauth2/oauth2_credential_exchanger.js +8 -2
- package/dist/web/auth/oauth2/oauth2_credential_refresher.js +5 -2
- package/dist/web/auth/oauth2/oauth2_discovery.js +8 -2
- package/dist/web/auth/oauth2/oauth2_utils.js +7 -0
- package/dist/web/auth/refresher/base_credential_refresher.js +6 -2
- package/dist/web/auth/refresher/credential_refresher_registry.js +6 -2
- package/dist/web/code_executors/agent_engine_sandbox_code_executor.js +3 -0
- package/dist/web/code_executors/base_code_executor.js +7 -2
- package/dist/web/code_executors/built_in_code_executor.js +7 -2
- package/dist/web/code_executors/code_execution_utils.js +7 -0
- package/dist/web/code_executors/code_executor_context.js +6 -2
- package/dist/web/code_executors/unsafe_local_code_executor.js +31 -13
- package/dist/web/common.js +113 -4
- package/dist/web/context/agent_controlled_context_compactor.js +8 -13
- package/dist/web/context/anchored_context_compactor.js +5 -2
- package/dist/web/context/compaction_utils.js +16 -1
- package/dist/web/context/summarizers/llm_summarizer.js +6 -2
- package/dist/web/context/token_based_context_compactor.js +16 -24
- package/dist/web/context/trajectory_thought_pruning_compactor.js +6 -2
- package/dist/web/context/truncating_context_compactor.js +6 -2
- package/dist/web/environment/base_environment.js +71 -0
- package/dist/web/environment/local_environment.js +165 -0
- package/dist/web/events/compacted_event.js +4 -0
- package/dist/web/events/event.js +37 -3
- package/dist/web/events/event_actions.js +5 -0
- package/dist/web/events/structured_events.js +3 -0
- package/dist/web/examples/base_example_provider.js +7 -2
- package/dist/web/examples/example_util.js +4 -0
- package/dist/web/features/feature_registry.js +8 -0
- package/dist/web/index.js +4 -13
- package/dist/web/integrations/agent_registry/agent_registry.js +8 -4
- package/dist/web/integrations/agent_registry/agent_registry_mcp_toolset.js +5 -2
- package/dist/web/integrations/agent_registry/helpers.js +4 -0
- package/dist/web/memory/in_memory_memory_service.js +22 -4
- package/dist/web/memory/vertex_ai_memory_bank_service.js +24 -3
- package/dist/web/models/apigee_llm.js +9 -3
- package/dist/web/models/base_llm.js +8 -3
- package/dist/web/models/gemini_llm_connection.js +6 -2
- package/dist/web/models/google_llm.js +25 -13
- package/dist/web/models/interactions_utils.js +17 -0
- package/dist/web/models/llm_request.js +5 -0
- package/dist/web/models/llm_response.js +3 -0
- package/dist/web/models/registry.js +7 -2
- package/dist/web/models/routed_llm.js +4 -14
- package/dist/web/plugins/base_plugin.js +43 -7
- package/dist/web/plugins/global_instruction_plugin.js +6 -2
- package/dist/web/plugins/logging_plugin.js +14 -8
- package/dist/web/plugins/plugin_manager.js +38 -2
- package/dist/web/plugins/security_plugin.js +14 -6
- package/dist/web/runner/in_memory_runner.js +6 -2
- package/dist/web/runner/runner.js +249 -31
- package/dist/web/sessions/base_session_service.js +22 -5
- package/dist/web/sessions/database_session_service.js +6 -2
- package/dist/web/sessions/db/operations.js +34 -6
- package/dist/web/sessions/db/schema.js +16 -8
- package/dist/web/sessions/in_memory_session_service.js +31 -22
- package/dist/web/sessions/registry.js +5 -1
- package/dist/web/sessions/session.js +3 -0
- package/dist/web/sessions/state.js +77 -7
- package/dist/web/sessions/state_write_order.js +74 -0
- package/dist/web/sessions/vertex_ai_session_service.js +142 -26
- package/dist/web/skills/gcp_skill_registry.js +2 -0
- package/dist/web/skills/loader.js +62 -16
- package/dist/web/skills/prompt.js +4 -0
- package/dist/web/telemetry/google_cloud.js +54 -9
- package/dist/web/telemetry/setup.js +6 -0
- package/dist/web/telemetry/tracing.js +77 -7
- package/dist/web/tools/agent_tool.js +7 -2
- package/dist/web/tools/base_tool.js +25 -2
- package/dist/web/tools/base_toolset.js +7 -2
- package/dist/web/tools/consolidate_context_tool.js +6 -2
- package/dist/web/tools/enterprise_web_search_tool.js +7 -2
- package/dist/web/tools/example_tool.js +6 -2
- package/dist/web/tools/exit_loop_tool.js +6 -2
- package/dist/web/tools/finish_task_tool.js +92 -0
- package/dist/web/tools/forwarding_artifact_service.js +6 -2
- package/dist/web/tools/function_tool.js +74 -8
- package/dist/web/tools/get_user_choice_tool.js +27 -0
- package/dist/web/tools/google_maps_grounding_tool.js +7 -2
- package/dist/web/tools/google_search_tool.js +6 -2
- package/dist/web/tools/load_artifacts_tool.js +9 -2
- package/dist/web/tools/load_memory_tool.js +6 -2
- package/dist/web/tools/load_web_page.js +22 -1
- package/dist/web/tools/long_running_tool.js +5 -2
- package/dist/web/tools/mcp/index.js +11 -0
- package/dist/web/tools/mcp/load_mcp_resource_tool.js +6 -2
- package/dist/web/tools/mcp/mcp_session_manager.js +80 -30
- package/dist/web/tools/mcp/mcp_tool.js +6 -2
- package/dist/web/tools/mcp/mcp_toolset.js +5 -2
- package/dist/web/tools/openapi_tool/auth/auth_helpers.js +5 -0
- package/dist/web/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js +2 -0
- package/dist/web/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js +2 -0
- package/dist/web/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js +30 -9
- package/dist/web/tools/openapi_tool/openapi_spec_parser/operation_parser.js +2 -0
- package/dist/web/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js +6 -2
- package/dist/web/tools/openapi_tool/openapi_toolset.js +2 -0
- package/dist/web/tools/openapi_tool/rest_api_tool.js +23 -5
- package/dist/web/tools/preload_memory_tool.js +6 -2
- package/dist/web/tools/request_input_tool.js +29 -0
- package/dist/web/tools/skill/list_skills_tool.js +2 -0
- package/dist/web/tools/skill/load_skill_resource_tool.js +2 -0
- package/dist/web/tools/skill/load_skill_tool.js +4 -1
- package/dist/web/tools/skill/run_skill_inline_script_tool.js +26 -2
- package/dist/web/tools/skill/run_skill_script_tool.js +28 -2
- package/dist/web/tools/skill/search_skills_tool.js +2 -0
- package/dist/web/tools/skill/skill_toolset.js +25 -0
- package/dist/web/tools/tool_confirmation.js +24 -2
- package/dist/web/tools/url_context_tool.js +6 -2
- package/dist/web/tools/vertex_ai_search_tool.js +6 -2
- package/dist/web/tools/vertex_rag_retrieval_tool.js +6 -2
- package/dist/web/utils/async_hooks_shim.js +6 -2
- package/dist/web/utils/async_queue.js +46 -18
- package/dist/web/utils/branch_trie.js +3 -0
- package/dist/web/utils/case_utils.js +3 -0
- package/dist/web/utils/client_labels.js +6 -0
- package/dist/web/utils/crypto_shim.js +18 -0
- package/dist/web/utils/deprecated.js +40 -0
- package/dist/web/utils/env_aware_utils.js +56 -13
- package/dist/web/utils/error_utils.js +101 -0
- package/dist/web/utils/experimental.js +10 -2
- package/dist/web/utils/failover_utils.js +4 -0
- package/dist/web/utils/file_extension_utils.js +4 -0
- package/dist/web/utils/file_utils.js +12 -4
- package/dist/web/utils/gemini_schema_util.js +6 -2
- package/dist/web/utils/genai_schema_to_json.js +80 -0
- package/dist/web/utils/live_connection_utils.js +5 -2
- package/dist/web/utils/logger.js +14 -4
- package/dist/web/utils/model_name.js +9 -0
- package/dist/web/utils/object_notation_utils.js +8 -3
- package/dist/web/utils/optional_peer.js +38 -0
- package/dist/web/utils/output_schema_utils.js +18 -0
- package/dist/web/utils/partial_copy.js +3 -0
- package/dist/web/utils/redact_uri.js +39 -0
- package/dist/web/utils/schema.js +167 -0
- package/dist/web/utils/simple_zod_to_json.js +15 -4
- package/dist/web/utils/streaming_utils.js +14 -6
- package/dist/web/utils/task.js +8 -4
- package/dist/web/utils/variant_utils.js +5 -2
- package/dist/web/utils/vertex_ai_utils.js +7 -2
- package/dist/web/version.js +1 -1
- package/dist/web/workflow/base_node.js +215 -0
- package/dist/web/workflow/branch_path.js +77 -0
- package/dist/web/workflow/dynamic_node_scheduler.js +202 -0
- package/dist/web/workflow/errors.js +140 -0
- package/dist/web/workflow/graph.js +127 -0
- package/dist/web/workflow/index.js +80 -0
- package/dist/web/workflow/node.js +87 -0
- package/dist/web/workflow/node_builders.js +40 -0
- package/dist/web/workflow/node_context.js +236 -0
- package/dist/web/workflow/node_error_event.js +86 -0
- package/dist/web/workflow/node_runner.js +481 -0
- package/dist/web/workflow/node_state.js +43 -0
- package/dist/web/workflow/node_status.js +20 -0
- package/dist/web/workflow/nodes/function_node.js +221 -0
- package/dist/web/workflow/nodes/join_node.js +47 -0
- package/dist/web/workflow/nodes/node_tool.js +131 -0
- package/dist/web/workflow/nodes/parallel_worker.js +120 -0
- package/dist/web/workflow/nodes/tool_node.js +126 -0
- package/dist/web/workflow/request_input.js +36 -0
- package/dist/web/workflow/retry_config.js +43 -0
- package/dist/web/workflow/run_llm_agent_as_node.js +266 -0
- package/dist/web/workflow/run_node_as_invocation.js +170 -0
- package/dist/web/workflow/schedule_dynamic_node.js +26 -0
- package/dist/web/workflow/trigger.js +7 -0
- package/dist/web/workflow/utils/graph_parser.js +188 -0
- package/dist/web/workflow/utils/graph_validation.js +189 -0
- package/dist/web/workflow/utils/hitl_utils.js +239 -0
- package/dist/web/workflow/utils/rehydration_utils.js +342 -0
- package/dist/web/workflow/utils/retry_utils.js +82 -0
- package/dist/web/workflow/utils/workflow_graph_utils.js +115 -0
- package/dist/web/workflow/workflow.js +529 -0
- package/package.json +82 -8
|
@@ -1,6 +1,26 @@
|
|
|
1
1
|
import {createRequire as topLevelCreateRequire} from 'module';
|
|
2
2
|
const require = topLevelCreateRequire(import.meta.url);
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __defProps = Object.defineProperties;
|
|
5
|
+
var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
|
|
6
|
+
var __getOwnPropSymbols = Object.getOwnPropertySymbols;
|
|
7
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
8
|
+
var __propIsEnum = Object.prototype.propertyIsEnumerable;
|
|
3
9
|
var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
|
|
10
|
+
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
11
|
+
var __spreadValues = (a, b) => {
|
|
12
|
+
for (var prop in b || (b = {}))
|
|
13
|
+
if (__hasOwnProp.call(b, prop))
|
|
14
|
+
__defNormalProp(a, prop, b[prop]);
|
|
15
|
+
if (__getOwnPropSymbols)
|
|
16
|
+
for (var prop of __getOwnPropSymbols(b)) {
|
|
17
|
+
if (__propIsEnum.call(b, prop))
|
|
18
|
+
__defNormalProp(a, prop, b[prop]);
|
|
19
|
+
}
|
|
20
|
+
return a;
|
|
21
|
+
};
|
|
22
|
+
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
23
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
4
24
|
var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
|
|
5
25
|
/**
|
|
6
26
|
* @license
|
|
@@ -18,7 +38,7 @@ import {
|
|
|
18
38
|
} from "./a2a_event.js";
|
|
19
39
|
import {
|
|
20
40
|
getFinalTaskStatusUpdate,
|
|
21
|
-
|
|
41
|
+
getUnansweredRequestEvent
|
|
22
42
|
} from "./event_processor_utils.js";
|
|
23
43
|
import { createExecutorContext } from "./executor_context.js";
|
|
24
44
|
import {
|
|
@@ -26,7 +46,7 @@ import {
|
|
|
26
46
|
getA2ASessionMetadata
|
|
27
47
|
} from "./metadata_converter_utils.js";
|
|
28
48
|
import { toA2AParts, toGenAIContent } from "./part_converter_utils.js";
|
|
29
|
-
class
|
|
49
|
+
const _A2AAgentExecutor = class _A2AAgentExecutor {
|
|
30
50
|
constructor(config) {
|
|
31
51
|
this.config = config;
|
|
32
52
|
this.agentPartialArtifactIdsMap = {};
|
|
@@ -56,19 +76,20 @@ class A2AAgentExecutor {
|
|
|
56
76
|
if (this.config.beforeExecuteCallback) {
|
|
57
77
|
await this.config.beforeExecuteCallback(ctx);
|
|
58
78
|
}
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
}
|
|
79
|
+
const unansweredRequestEvent = getUnansweredRequestEvent({
|
|
80
|
+
taskId: ctx.taskId,
|
|
81
|
+
contextId: ctx.contextId,
|
|
82
|
+
task: ctx.task,
|
|
83
|
+
sessionEvents: session.events,
|
|
84
|
+
genAIContent: genAIUserMessage
|
|
85
|
+
});
|
|
86
|
+
if (unansweredRequestEvent) {
|
|
87
|
+
await this.publishFinalTaskStatus({
|
|
88
|
+
executorContext,
|
|
89
|
+
eventBus,
|
|
90
|
+
event: unansweredRequestEvent
|
|
91
|
+
});
|
|
92
|
+
return;
|
|
72
93
|
}
|
|
73
94
|
if (!ctx.task) {
|
|
74
95
|
eventBus.publish(
|
|
@@ -91,7 +112,10 @@ class A2AAgentExecutor {
|
|
|
91
112
|
userId,
|
|
92
113
|
sessionId,
|
|
93
114
|
newMessage: genAIUserMessage,
|
|
94
|
-
|
|
115
|
+
// Marked remote so the run knows this message came from a peer rather
|
|
116
|
+
// than from the operator: a human-in-the-loop gate is not answerable
|
|
117
|
+
// over A2A unless the deployment opts in.
|
|
118
|
+
runConfig: __spreadProps(__spreadValues({}, this.config.runConfig), { remoteDelivered: true })
|
|
95
119
|
})), more, temp, error; more = !(temp = await iter.next()).done; more = false) {
|
|
96
120
|
const adkEvent = temp.value;
|
|
97
121
|
adkEvents.push(adkEvent);
|
|
@@ -187,7 +211,9 @@ class A2AAgentExecutor {
|
|
|
187
211
|
}
|
|
188
212
|
eventBus.publish(event);
|
|
189
213
|
}
|
|
190
|
-
}
|
|
214
|
+
};
|
|
215
|
+
__name(_A2AAgentExecutor, "A2AAgentExecutor");
|
|
216
|
+
let A2AAgentExecutor = _A2AAgentExecutor;
|
|
191
217
|
async function getAdkSession(userId, sessionId, sessionService, appName) {
|
|
192
218
|
const session = await sessionService.getSession({
|
|
193
219
|
appName,
|
|
@@ -203,6 +229,7 @@ async function getAdkSession(userId, sessionId, sessionService, appName) {
|
|
|
203
229
|
sessionId
|
|
204
230
|
});
|
|
205
231
|
}
|
|
232
|
+
__name(getAdkSession, "getAdkSession");
|
|
206
233
|
async function getAdkRunner(runnerOrConfig) {
|
|
207
234
|
if (typeof runnerOrConfig === "function") {
|
|
208
235
|
const result = await runnerOrConfig();
|
|
@@ -213,6 +240,7 @@ async function getAdkRunner(runnerOrConfig) {
|
|
|
213
240
|
}
|
|
214
241
|
return new Runner(runnerOrConfig);
|
|
215
242
|
}
|
|
243
|
+
__name(getAdkRunner, "getAdkRunner");
|
|
216
244
|
export {
|
|
217
245
|
A2AAgentExecutor
|
|
218
246
|
};
|
|
@@ -1,5 +1,28 @@
|
|
|
1
1
|
import {createRequire as topLevelCreateRequire} from 'module';
|
|
2
2
|
const require = topLevelCreateRequire(import.meta.url);
|
|
3
|
+
var __create = Object.create;
|
|
4
|
+
var __defProp = Object.defineProperty;
|
|
5
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
6
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
7
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
8
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
9
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
19
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
20
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
21
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
22
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
23
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
24
|
+
mod
|
|
25
|
+
));
|
|
3
26
|
/**
|
|
4
27
|
* @license
|
|
5
28
|
* Copyright 2026 Google LLC
|
|
@@ -7,19 +30,22 @@ const require = topLevelCreateRequire(import.meta.url);
|
|
|
7
30
|
*/
|
|
8
31
|
import { AGENT_CARD_PATH } from "@a2a-js/sdk";
|
|
9
32
|
import { DefaultRequestHandler, InMemoryTaskStore } from "@a2a-js/sdk/server";
|
|
10
|
-
import {
|
|
11
|
-
agentCardHandler,
|
|
12
|
-
jsonRpcHandler,
|
|
13
|
-
restHandler,
|
|
14
|
-
UserBuilder
|
|
15
|
-
} from "@a2a-js/sdk/server/express";
|
|
16
|
-
import express from "express";
|
|
17
33
|
import { StreamingMode } from "../agents/run_config.js";
|
|
18
34
|
import { InMemorySessionService } from "../sessions/in_memory_session_service.js";
|
|
19
35
|
import { logger } from "../utils/logger.js";
|
|
36
|
+
import { loadOptionalPeer } from "../utils/optional_peer.js";
|
|
20
37
|
import { getA2AAgentCard, resolveAgentCard } from "./agent_card.js";
|
|
21
38
|
import { A2AAgentExecutor } from "./agent_executor.js";
|
|
22
|
-
function
|
|
39
|
+
async function loadExpressBindings() {
|
|
40
|
+
const expressModule = await loadOptionalPeer(
|
|
41
|
+
{ packageName: "express", feature: "toA2a" },
|
|
42
|
+
() => Promise.resolve().then(() => __toESM(require("express"), 1))
|
|
43
|
+
);
|
|
44
|
+
const a2aExpress = await Promise.resolve().then(() => __toESM(require("@a2a-js/sdk/server/express"), 1));
|
|
45
|
+
return { express: expressModule.default, a2aExpress };
|
|
46
|
+
}
|
|
47
|
+
__name(loadExpressBindings, "loadExpressBindings");
|
|
48
|
+
function resolveA2aUserBuilder(options, a2aExpress) {
|
|
23
49
|
if (options.authentication) {
|
|
24
50
|
return options.authentication;
|
|
25
51
|
}
|
|
@@ -27,15 +53,17 @@ function resolveA2aUserBuilder(options) {
|
|
|
27
53
|
logger.warn(
|
|
28
54
|
"SECURITY WARNING: Mounting the A2A server WITHOUT authentication because `allowUnauthenticated: true` was set. The agent and all of its tools are exposed to any network-reachable caller, which can invoke them with arbitrary input and read the output. Do NOT use this outside of local, trusted development."
|
|
29
55
|
);
|
|
30
|
-
return UserBuilder.noAuthentication;
|
|
56
|
+
return a2aExpress.UserBuilder.noAuthentication;
|
|
31
57
|
}
|
|
32
58
|
throw new Error(
|
|
33
59
|
"toA2a: refusing to mount the A2A server without authentication. The A2A surface lets any network-reachable caller invoke this agent and its tools with arbitrary input and read the output, so it must be authenticated. Provide `authentication` (a UserBuilder that validates the request, e.g. a bearer token or OIDC credential) or, only for local/trusted development, explicitly set `allowUnauthenticated: true`."
|
|
34
60
|
);
|
|
35
61
|
}
|
|
62
|
+
__name(resolveA2aUserBuilder, "resolveA2aUserBuilder");
|
|
36
63
|
async function toA2a(agent, options = {}) {
|
|
37
64
|
var _a, _b, _c, _d;
|
|
38
|
-
const
|
|
65
|
+
const { express: expressFactory, a2aExpress } = await loadExpressBindings();
|
|
66
|
+
const userBuilder = resolveA2aUserBuilder(options, a2aExpress);
|
|
39
67
|
const host = (_a = options.host) != null ? _a : "localhost";
|
|
40
68
|
const port = (_b = options.port) != null ? _b : 8e3;
|
|
41
69
|
const protocol = (_c = options.protocol) != null ? _c : "http";
|
|
@@ -68,31 +96,31 @@ async function toA2a(agent, options = {}) {
|
|
|
68
96
|
new InMemoryTaskStore(),
|
|
69
97
|
agentExecutor
|
|
70
98
|
);
|
|
71
|
-
const app = (_d = options.app) != null ? _d :
|
|
99
|
+
const app = (_d = options.app) != null ? _d : expressFactory();
|
|
72
100
|
if (!options.app) {
|
|
73
|
-
app.use(
|
|
74
|
-
app.use(express.json({ limit: "50mb" }));
|
|
101
|
+
app.use(expressFactory.json({ limit: "50mb" }));
|
|
75
102
|
}
|
|
76
103
|
app.use(
|
|
77
104
|
"".concat(basePath, "/").concat(AGENT_CARD_PATH),
|
|
78
|
-
agentCardHandler({ agentCardProvider: requestHandler })
|
|
105
|
+
a2aExpress.agentCardHandler({ agentCardProvider: requestHandler })
|
|
79
106
|
);
|
|
80
107
|
app.use(
|
|
81
108
|
"".concat(basePath, "/rest"),
|
|
82
|
-
restHandler({
|
|
109
|
+
a2aExpress.restHandler({
|
|
83
110
|
requestHandler,
|
|
84
111
|
userBuilder
|
|
85
112
|
})
|
|
86
113
|
);
|
|
87
114
|
app.use(
|
|
88
115
|
"".concat(basePath, "/jsonrpc"),
|
|
89
|
-
jsonRpcHandler({
|
|
116
|
+
a2aExpress.jsonRpcHandler({
|
|
90
117
|
requestHandler,
|
|
91
118
|
userBuilder
|
|
92
119
|
})
|
|
93
120
|
);
|
|
94
121
|
return app;
|
|
95
122
|
}
|
|
123
|
+
__name(toA2a, "toA2a");
|
|
96
124
|
export {
|
|
97
125
|
toA2a
|
|
98
126
|
};
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import {createRequire as topLevelCreateRequire} from 'module';
|
|
2
|
+
const require = topLevelCreateRequire(import.meta.url);
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
5
|
+
/**
|
|
6
|
+
* @license
|
|
7
|
+
* Copyright 2026 Google LLC
|
|
8
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
9
|
+
*/
|
|
10
|
+
import { timingSafeEqual } from "node:crypto";
|
|
11
|
+
const AUTHENTICATED_USER_NAME = "a2a-bearer-token";
|
|
12
|
+
const BEARER_SCHEME_PREFIX = "bearer ";
|
|
13
|
+
function timingSafeEqualStrings(a, b) {
|
|
14
|
+
const left = Buffer.from(a, "utf8");
|
|
15
|
+
const right = Buffer.from(b, "utf8");
|
|
16
|
+
return left.length === right.length && timingSafeEqual(left, right);
|
|
17
|
+
}
|
|
18
|
+
__name(timingSafeEqualStrings, "timingSafeEqualStrings");
|
|
19
|
+
function bearerTokenUserBuilder(token) {
|
|
20
|
+
const expected = token.trim();
|
|
21
|
+
if (!expected) {
|
|
22
|
+
throw new Error(
|
|
23
|
+
"bearerTokenUserBuilder: an empty A2A bearer token is not a valid authenticator. Supply a real shared secret, or configure no token at all to run the A2A surface unauthenticated."
|
|
24
|
+
);
|
|
25
|
+
}
|
|
26
|
+
return async (req) => {
|
|
27
|
+
var _a;
|
|
28
|
+
const header = (_a = req.headers.authorization) != null ? _a : "";
|
|
29
|
+
const credential = header.toLowerCase().startsWith(BEARER_SCHEME_PREFIX) ? header.slice(BEARER_SCHEME_PREFIX.length) : "";
|
|
30
|
+
if (!timingSafeEqualStrings(credential, expected)) {
|
|
31
|
+
throw new Error(
|
|
32
|
+
"A2A request rejected: missing or invalid `Authorization: Bearer` credential."
|
|
33
|
+
);
|
|
34
|
+
}
|
|
35
|
+
return { isAuthenticated: true, userName: AUTHENTICATED_USER_NAME };
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
__name(bearerTokenUserBuilder, "bearerTokenUserBuilder");
|
|
39
|
+
export {
|
|
40
|
+
bearerTokenUserBuilder
|
|
41
|
+
};
|
|
@@ -19,6 +19,7 @@ var __spreadValues = (a, b) => {
|
|
|
19
19
|
return a;
|
|
20
20
|
};
|
|
21
21
|
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
22
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
22
23
|
/**
|
|
23
24
|
* @license
|
|
24
25
|
* Copyright 2026 Google LLC
|
|
@@ -62,33 +63,37 @@ function toA2AMessage(event, {
|
|
|
62
63
|
metadata: getA2AEventMetadata(event, { appName, userId, sessionId })
|
|
63
64
|
};
|
|
64
65
|
}
|
|
65
|
-
|
|
66
|
+
__name(toA2AMessage, "toA2AMessage");
|
|
67
|
+
function toAdkEvent(event, invocationId, agentName, branch) {
|
|
66
68
|
if (isMessage(event)) {
|
|
67
|
-
return messageToAdkEvent(event, invocationId, agentName);
|
|
69
|
+
return messageToAdkEvent(event, invocationId, agentName, branch);
|
|
68
70
|
}
|
|
69
71
|
if (isTask(event)) {
|
|
70
|
-
return taskToAdkEvent(event, invocationId, agentName);
|
|
72
|
+
return taskToAdkEvent(event, invocationId, agentName, branch);
|
|
71
73
|
}
|
|
72
74
|
if (isTaskArtifactUpdateEvent(event)) {
|
|
73
|
-
return artifactUpdateToAdkEvent(event, invocationId, agentName);
|
|
75
|
+
return artifactUpdateToAdkEvent(event, invocationId, agentName, branch);
|
|
74
76
|
}
|
|
75
77
|
if (isTaskStatusUpdateEvent(event)) {
|
|
76
|
-
return event.final ? finalTaskStatusUpdateToAdkEvent(event, invocationId, agentName) : taskStatusUpdateToAdkEvent(event, invocationId, agentName);
|
|
78
|
+
return event.final ? finalTaskStatusUpdateToAdkEvent(event, invocationId, agentName, branch) : taskStatusUpdateToAdkEvent(event, invocationId, agentName, branch);
|
|
77
79
|
}
|
|
78
80
|
return void 0;
|
|
79
81
|
}
|
|
80
|
-
|
|
82
|
+
__name(toAdkEvent, "toAdkEvent");
|
|
83
|
+
function messageToAdkEvent(msg, invocationId, agentName, branch) {
|
|
81
84
|
const parts = toGenAIParts(msg.parts);
|
|
82
85
|
const content = parts.length === 0 ? void 0 : msg.role === MessageRole.USER ? createUserContent(parts) : createModelContent(parts);
|
|
83
86
|
return __spreadProps(__spreadValues({}, createAdkEventFromMetadata(msg)), {
|
|
84
87
|
invocationId,
|
|
85
88
|
author: msg.role === MessageRole.USER ? MessageRole.USER : agentName,
|
|
89
|
+
branch,
|
|
86
90
|
content,
|
|
87
91
|
turnComplete: true,
|
|
88
92
|
partial: false
|
|
89
93
|
});
|
|
90
94
|
}
|
|
91
|
-
|
|
95
|
+
__name(messageToAdkEvent, "messageToAdkEvent");
|
|
96
|
+
function artifactUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
|
|
92
97
|
var _a;
|
|
93
98
|
const partsToConvert = ((_a = a2aEvent.artifact) == null ? void 0 : _a.parts) || [];
|
|
94
99
|
if (partsToConvert.length === 0) {
|
|
@@ -98,12 +103,14 @@ function artifactUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
|
|
|
98
103
|
return __spreadProps(__spreadValues({}, createAdkEventFromMetadata(a2aEvent)), {
|
|
99
104
|
invocationId,
|
|
100
105
|
author: agentName,
|
|
106
|
+
branch,
|
|
101
107
|
content: createModelContent(toGenAIParts(partsToConvert)),
|
|
102
108
|
longRunningToolIds: getLongRunningToolIDs(partsToConvert),
|
|
103
109
|
partial
|
|
104
110
|
});
|
|
105
111
|
}
|
|
106
|
-
|
|
112
|
+
__name(artifactUpdateToAdkEvent, "artifactUpdateToAdkEvent");
|
|
113
|
+
function finalTaskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
|
|
107
114
|
var _a;
|
|
108
115
|
const partsToConvert = ((_a = a2aEvent.status.message) == null ? void 0 : _a.parts) || [];
|
|
109
116
|
if (partsToConvert.length === 0) {
|
|
@@ -115,13 +122,15 @@ function finalTaskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
|
|
|
115
122
|
return __spreadProps(__spreadValues({}, createAdkEventFromMetadata(a2aEvent)), {
|
|
116
123
|
invocationId,
|
|
117
124
|
author: agentName,
|
|
125
|
+
branch,
|
|
118
126
|
errorMessage: isFailedTask ? getFailedTaskStatusUpdateEventError(a2aEvent) : void 0,
|
|
119
127
|
content: hasContent ? createModelContent(parts) : void 0,
|
|
120
128
|
longRunningToolIds: getLongRunningToolIDs(partsToConvert),
|
|
121
129
|
turnComplete: true
|
|
122
130
|
});
|
|
123
131
|
}
|
|
124
|
-
|
|
132
|
+
__name(finalTaskStatusUpdateToAdkEvent, "finalTaskStatusUpdateToAdkEvent");
|
|
133
|
+
function taskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
|
|
125
134
|
const msg = a2aEvent.status.message;
|
|
126
135
|
if (!msg) {
|
|
127
136
|
return void 0;
|
|
@@ -133,12 +142,14 @@ function taskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
|
|
|
133
142
|
return __spreadProps(__spreadValues({}, createAdkEventFromMetadata(a2aEvent)), {
|
|
134
143
|
invocationId,
|
|
135
144
|
author: agentName,
|
|
145
|
+
branch,
|
|
136
146
|
content: createModelContent(parts),
|
|
137
147
|
turnComplete: false,
|
|
138
148
|
partial: true
|
|
139
149
|
});
|
|
140
150
|
}
|
|
141
|
-
|
|
151
|
+
__name(taskStatusUpdateToAdkEvent, "taskStatusUpdateToAdkEvent");
|
|
152
|
+
function taskToAdkEvent(a2aTask, invocationId, agentName, branch) {
|
|
142
153
|
var _a, _b;
|
|
143
154
|
const parts = [];
|
|
144
155
|
const longRunningToolIds = [];
|
|
@@ -165,16 +176,27 @@ function taskToAdkEvent(a2aTask, invocationId, agentName) {
|
|
|
165
176
|
return __spreadProps(__spreadValues({}, createAdkEventFromMetadata(a2aTask)), {
|
|
166
177
|
invocationId,
|
|
167
178
|
author: agentName,
|
|
179
|
+
branch,
|
|
168
180
|
content: isFailed ? void 0 : createModelContent(parts),
|
|
169
181
|
errorMessage: isFailed ? getFailedTaskStatusUpdateEventError(a2aTask) : void 0,
|
|
170
182
|
longRunningToolIds,
|
|
171
183
|
turnComplete: isTerminal
|
|
172
184
|
});
|
|
173
185
|
}
|
|
186
|
+
__name(taskToAdkEvent, "taskToAdkEvent");
|
|
187
|
+
const PEER_SETTABLE_ACTION_FIELDS = /* @__PURE__ */ new Set(["escalate"]);
|
|
174
188
|
function createAdkEventFromMetadata(a2aEvent) {
|
|
175
189
|
const metadata = a2aEvent.metadata || {};
|
|
176
190
|
return createEvent({
|
|
177
|
-
branch
|
|
191
|
+
// `branch` is intentionally NOT restored from peer metadata here (unlike
|
|
192
|
+
// the other fields below): it is the mechanism getContents() (see
|
|
193
|
+
// content_processor_utils.ts) uses to keep sibling sub-agent branches'
|
|
194
|
+
// conversation contexts isolated from each other. A remote A2A peer that
|
|
195
|
+
// controls its own outgoing metadata could otherwise forge `adk_branch`
|
|
196
|
+
// (set it to a shared ancestor branch, or omit it) to leak its content
|
|
197
|
+
// into an unrelated sibling agent's LLM context. Every caller of the
|
|
198
|
+
// `*ToAdkEvent` functions in this file force-sets `branch` from its own
|
|
199
|
+
// local `InvocationContext` instead, the same way `author` is handled.
|
|
178
200
|
author: metadata[A2AMetadataKeys.AUTHOR],
|
|
179
201
|
partial: metadata[A2AMetadataKeys.PARTIAL],
|
|
180
202
|
errorCode: metadata[A2AMetadataKeys.ERROR_CODE],
|
|
@@ -183,12 +205,24 @@ function createAdkEventFromMetadata(a2aEvent) {
|
|
|
183
205
|
groundingMetadata: metadata[A2AMetadataKeys.GROUNDING_METADATA],
|
|
184
206
|
usageMetadata: metadata[A2AMetadataKeys.USAGE_METADATA],
|
|
185
207
|
customMetadata: metadata[A2AMetadataKeys.CUSTOM_METADATA],
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
208
|
+
// Only fields in PEER_SETTABLE_ACTION_FIELDS may be restored from
|
|
209
|
+
// metadata a remote A2A peer controls. Every other action field either
|
|
210
|
+
// mutates the caller's own session or drives the caller's own control
|
|
211
|
+
// flow (e.g. `transferToAgent`, see llm_agent.ts), so it must never be
|
|
212
|
+
// rebuilt from peer-supplied data. Filtering through an allowlist here
|
|
213
|
+
// (rather than just omitting the unsafe field) means a future action
|
|
214
|
+
// field is unsafe-by-default: adding it to `candidateActions` alone
|
|
215
|
+
// does nothing until it's also added to the allowlist.
|
|
216
|
+
actions: createEventActions(
|
|
217
|
+
Object.fromEntries(
|
|
218
|
+
Object.entries({
|
|
219
|
+
escalate: !!metadata[A2AMetadataKeys.ESCALATE]
|
|
220
|
+
}).filter(([key]) => PEER_SETTABLE_ACTION_FIELDS.has(key))
|
|
221
|
+
)
|
|
222
|
+
)
|
|
190
223
|
});
|
|
191
224
|
}
|
|
225
|
+
__name(createAdkEventFromMetadata, "createAdkEventFromMetadata");
|
|
192
226
|
function getLongRunningToolIDs(parts) {
|
|
193
227
|
const ids = [];
|
|
194
228
|
for (const a2aPart of parts) {
|
|
@@ -201,6 +235,7 @@ function getLongRunningToolIDs(parts) {
|
|
|
201
235
|
}
|
|
202
236
|
return ids;
|
|
203
237
|
}
|
|
238
|
+
__name(getLongRunningToolIDs, "getLongRunningToolIDs");
|
|
204
239
|
export {
|
|
205
240
|
toA2AMessage,
|
|
206
241
|
toAdkEvent
|
|
@@ -19,11 +19,16 @@ var __spreadValues = (a, b) => {
|
|
|
19
19
|
return a;
|
|
20
20
|
};
|
|
21
21
|
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
22
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
22
23
|
/**
|
|
23
24
|
* @license
|
|
24
25
|
* Copyright 2026 Google LLC
|
|
25
26
|
* SPDX-License-Identifier: Apache-2.0
|
|
26
27
|
*/
|
|
28
|
+
import {
|
|
29
|
+
getPendingUserInputRequests,
|
|
30
|
+
getUserInputRequests
|
|
31
|
+
} from "../agents/user_input_request.js";
|
|
27
32
|
import { createEventActions } from "../events/event_actions.js";
|
|
28
33
|
import {
|
|
29
34
|
createInputMissingErrorEvent,
|
|
@@ -67,6 +72,7 @@ function getFinalTaskStatusUpdate(adkEvents, context) {
|
|
|
67
72
|
metadata: __spreadValues(__spreadValues({}, getA2ASessionMetadata(context)), getA2AEventMetadataFromActions(finalEventActions))
|
|
68
73
|
});
|
|
69
74
|
}
|
|
75
|
+
__name(getFinalTaskStatusUpdate, "getFinalTaskStatusUpdate");
|
|
70
76
|
function scanForInputRequiredEvents(adkEvents, context) {
|
|
71
77
|
var _a, _b;
|
|
72
78
|
const inputRequiredParts = [];
|
|
@@ -104,6 +110,7 @@ function scanForInputRequiredEvents(adkEvents, context) {
|
|
|
104
110
|
}
|
|
105
111
|
return void 0;
|
|
106
112
|
}
|
|
113
|
+
__name(scanForInputRequiredEvents, "scanForInputRequiredEvents");
|
|
107
114
|
function getLongRunnningFunctionCallId(genAIPart, longRunningToolIds = [], inputRequiredParts = []) {
|
|
108
115
|
var _a, _b, _c;
|
|
109
116
|
const functionCallId = (_a = genAIPart.functionCall) == null ? void 0 : _a.id;
|
|
@@ -124,47 +131,79 @@ function getLongRunnningFunctionCallId(genAIPart, longRunningToolIds = [], input
|
|
|
124
131
|
}
|
|
125
132
|
return;
|
|
126
133
|
}
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
134
|
+
__name(getLongRunnningFunctionCallId, "getLongRunnningFunctionCallId");
|
|
135
|
+
function getUnansweredRequestEvent(options) {
|
|
136
|
+
var _a, _b, _c;
|
|
137
|
+
const { taskId, contextId, task, sessionEvents, genAIContent } = options;
|
|
138
|
+
const pending = pendingRequestParts(task, sessionEvents);
|
|
139
|
+
const answered = new Set(
|
|
140
|
+
((_a = genAIContent == null ? void 0 : genAIContent.parts) != null ? _a : []).map((part) => {
|
|
141
|
+
var _a2;
|
|
142
|
+
return (_a2 = part.functionResponse) == null ? void 0 : _a2.id;
|
|
143
|
+
}).filter((id) => !!id)
|
|
144
|
+
);
|
|
145
|
+
const missingId = [...pending.keys()].find((id) => !answered.has(id));
|
|
146
|
+
if (!missingId) {
|
|
130
147
|
return void 0;
|
|
131
148
|
}
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
149
|
+
return createInputMissingErrorEvent({
|
|
150
|
+
taskId: (_b = task == null ? void 0 : task.id) != null ? _b : taskId,
|
|
151
|
+
contextId: (_c = task == null ? void 0 : task.contextId) != null ? _c : contextId,
|
|
152
|
+
parts: [
|
|
153
|
+
...toA2AParts([...pending.values()]),
|
|
154
|
+
{
|
|
155
|
+
kind: "text",
|
|
156
|
+
text: "No input provided for function call id ".concat(missingId),
|
|
157
|
+
metadata: {
|
|
158
|
+
validation_error: true
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
]
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
__name(getUnansweredRequestEvent, "getUnansweredRequestEvent");
|
|
165
|
+
function pendingRequestParts(task, sessionEvents) {
|
|
166
|
+
var _a, _b, _c, _d, _e, _f;
|
|
167
|
+
const pending = /* @__PURE__ */ new Map();
|
|
168
|
+
if (task && isInputRequiredTaskStatusUpdateEvent(task) && task.status.message) {
|
|
169
|
+
for (const part of toGenAIParts(task.status.message.parts)) {
|
|
170
|
+
if ((_a = part.functionCall) == null ? void 0 : _a.id) {
|
|
171
|
+
pending.set(part.functionCall.id, part);
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
const pendingIds = new Set(
|
|
176
|
+
getPendingUserInputRequests(sessionEvents).map(
|
|
177
|
+
(request) => request.interruptId
|
|
178
|
+
)
|
|
179
|
+
);
|
|
180
|
+
for (const event of sessionEvents) {
|
|
181
|
+
for (const part of (_c = (_b = event.content) == null ? void 0 : _b.parts) != null ? _c : []) {
|
|
182
|
+
const id = interruptIdOfPart(event, part);
|
|
183
|
+
if (id && pendingIds.has(id)) {
|
|
184
|
+
pending.set(id, part);
|
|
185
|
+
}
|
|
138
186
|
}
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
187
|
+
}
|
|
188
|
+
for (const event of sessionEvents) {
|
|
189
|
+
for (const part of (_e = (_d = event.content) == null ? void 0 : _d.parts) != null ? _e : []) {
|
|
190
|
+
if ((_f = part.functionResponse) == null ? void 0 : _f.id) {
|
|
191
|
+
pending.delete(part.functionResponse.id);
|
|
143
192
|
}
|
|
144
|
-
);
|
|
145
|
-
if (!hasMatchingResponse) {
|
|
146
|
-
return createInputMissingErrorEvent({
|
|
147
|
-
taskId: task.id,
|
|
148
|
-
contextId: task.contextId,
|
|
149
|
-
parts: [
|
|
150
|
-
...statusMsg.parts.filter((p) => {
|
|
151
|
-
var _a2;
|
|
152
|
-
return !((_a2 = p.metadata) == null ? void 0 : _a2.validation_error);
|
|
153
|
-
}),
|
|
154
|
-
{
|
|
155
|
-
kind: "text",
|
|
156
|
-
text: "No input provided for function call id ".concat(functionCallId),
|
|
157
|
-
metadata: {
|
|
158
|
-
validation_error: true
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
]
|
|
162
|
-
});
|
|
163
193
|
}
|
|
164
194
|
}
|
|
165
|
-
return
|
|
195
|
+
return pending;
|
|
196
|
+
}
|
|
197
|
+
__name(pendingRequestParts, "pendingRequestParts");
|
|
198
|
+
function interruptIdOfPart(event, part) {
|
|
199
|
+
if (!part.functionCall) {
|
|
200
|
+
return void 0;
|
|
201
|
+
}
|
|
202
|
+
const [request] = getUserInputRequests(__spreadProps(__spreadValues({}, event), { content: { parts: [part] } }));
|
|
203
|
+
return request == null ? void 0 : request.interruptId;
|
|
166
204
|
}
|
|
205
|
+
__name(interruptIdOfPart, "interruptIdOfPart");
|
|
167
206
|
export {
|
|
168
207
|
getFinalTaskStatusUpdate,
|
|
169
|
-
|
|
208
|
+
getUnansweredRequestEvent
|
|
170
209
|
};
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import {createRequire as topLevelCreateRequire} from 'module';
|
|
2
2
|
const require = topLevelCreateRequire(import.meta.url);
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
3
5
|
/**
|
|
4
6
|
* @license
|
|
5
7
|
* Copyright 2026 Google LLC
|
|
@@ -20,6 +22,7 @@ function createExecutorContext({
|
|
|
20
22
|
requestContext
|
|
21
23
|
};
|
|
22
24
|
}
|
|
25
|
+
__name(createExecutorContext, "createExecutorContext");
|
|
23
26
|
export {
|
|
24
27
|
createExecutorContext
|
|
25
28
|
};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import {createRequire as topLevelCreateRequire} from 'module';
|
|
2
|
+
const require = topLevelCreateRequire(import.meta.url);
|
|
3
|
+
/**
|
|
4
|
+
* @license
|
|
5
|
+
* Copyright 2026 Google LLC
|
|
6
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
7
|
+
*/
|
|
8
|
+
import { AGENT_CARD_PATH, RemoteA2AAgent } from "./a2a_remote_agent.js";
|
|
9
|
+
import { getA2AAgentCard } from "./agent_card.js";
|
|
10
|
+
import { A2AAgentExecutor } from "./agent_executor.js";
|
|
11
|
+
import { toA2a } from "./agent_to_a2a.js";
|
|
12
|
+
import { bearerTokenUserBuilder } from "./auth.js";
|
|
13
|
+
export {
|
|
14
|
+
A2AAgentExecutor,
|
|
15
|
+
AGENT_CARD_PATH,
|
|
16
|
+
RemoteA2AAgent,
|
|
17
|
+
bearerTokenUserBuilder,
|
|
18
|
+
getA2AAgentCard,
|
|
19
|
+
toA2a
|
|
20
|
+
};
|
|
@@ -19,6 +19,7 @@ var __spreadValues = (a, b) => {
|
|
|
19
19
|
return a;
|
|
20
20
|
};
|
|
21
21
|
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
22
|
+
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
22
23
|
/**
|
|
23
24
|
* @license
|
|
24
25
|
* Copyright 2026 Google LLC
|
|
@@ -60,6 +61,7 @@ function getAdkEventMetadata(a2aEvent) {
|
|
|
60
61
|
[AdkMetadataKeys.CONTEXT_ID]: a2aEvent.contextId
|
|
61
62
|
};
|
|
62
63
|
}
|
|
64
|
+
__name(getAdkEventMetadata, "getAdkEventMetadata");
|
|
63
65
|
function getA2AEventMetadata(adkEvent, {
|
|
64
66
|
appName,
|
|
65
67
|
userId,
|
|
@@ -83,6 +85,7 @@ function getA2AEventMetadata(adkEvent, {
|
|
|
83
85
|
[A2AMetadataKeys.IS_LONG_RUNNING]: (adkEvent.longRunningToolIds || []).length > 0
|
|
84
86
|
});
|
|
85
87
|
}
|
|
88
|
+
__name(getA2AEventMetadata, "getA2AEventMetadata");
|
|
86
89
|
function getA2ASessionMetadata({
|
|
87
90
|
appName,
|
|
88
91
|
userId,
|
|
@@ -94,12 +97,14 @@ function getA2ASessionMetadata({
|
|
|
94
97
|
[A2AMetadataKeys.SESSION_ID]: sessionId
|
|
95
98
|
};
|
|
96
99
|
}
|
|
100
|
+
__name(getA2ASessionMetadata, "getA2ASessionMetadata");
|
|
97
101
|
function getA2AEventMetadataFromActions(actions) {
|
|
98
102
|
return {
|
|
99
103
|
[A2AMetadataKeys.ESCALATE]: actions.escalate,
|
|
100
104
|
[A2AMetadataKeys.TRANSFER_TO_AGENT]: actions.transferToAgent
|
|
101
105
|
};
|
|
102
106
|
}
|
|
107
|
+
__name(getA2AEventMetadataFromActions, "getA2AEventMetadataFromActions");
|
|
103
108
|
export {
|
|
104
109
|
A2AMetadataKeys,
|
|
105
110
|
AdkMetadataKeys,
|