@google/adk 2.2.1 → 2.3.0

package/dist/cjs/common.js

@@ -41,6 +41,7 @@ __export(common_exports, {
   AuthHandler: () => import_auth_handler.AuthHandler,
   AuthPreprocessor: () => import_auth_preprocessor.AuthPreprocessor,
   AuthProviderRegistry: () => import_auth_provider_registry.AuthProviderRegistry,
+  AuthSchemeType: () => import_auth_schemes.AuthSchemeType,
   BaseAgent: () => import_base_agent.BaseAgent,
   BaseCodeExecutor: () => import_base_code_executor.BaseCodeExecutor,
   BaseEnvironment: () => import_base_environment.BaseEnvironment,
@@ -64,6 +65,7 @@ __export(common_exports, {
   ChromeBuiltInLlm: () => import_chrome_prompt_llm.ChromeBuiltInLlm,
   ChromeModelUnavailableError: () => import_chrome_prompt_llm.ChromeModelUnavailableError,
   CodeExecutionLanguage: () => import_code_execution_utils.CodeExecutionLanguage,
+  CodeExecutionResponseProcessor: () => import_code_execution_request_processor.CodeExecutionResponseProcessor,
   ConsolidateContextTool: () => import_consolidate_context_tool.ConsolidateContextTool,
   ContentRequestProcessor: () => import_content_request_processor.ContentRequestProcessor,
   Context: () => import_context.Context,
@@ -71,6 +73,7 @@ __export(common_exports, {
   ContextCompactorRequestProcessor: () => import_context_compactor_request_processor.ContextCompactorRequestProcessor,
   CredentialExchangeError: () => import_base_credential_exchanger.CredentialExchangeError,
   CredentialRefresherRegistry: () => import_credential_refresher_registry.CredentialRefresherRegistry,
+  CrewaiTool: () => import_crewai_tool.CrewaiTool,
   DEFAULT_ROUTE: () => import_workflow.DEFAULT_ROUTE,
   ENTERPRISE_WEB_SEARCH: () => import_enterprise_web_search_tool.ENTERPRISE_WEB_SEARCH,
   EXIT_LOOP: () => import_exit_loop_tool.EXIT_LOOP,
@@ -111,10 +114,13 @@ __export(common_exports, {
   LLMRegistry: () => import_registry.LLMRegistry,
   LOAD_ARTIFACTS: () => import_load_artifacts_tool.LOAD_ARTIFACTS,
   LOAD_MEMORY: () => import_load_memory_tool.LOAD_MEMORY,
+  LangGraphAgent: () => import_langgraph_agent.LangGraphAgent,
+  LangchainTool: () => import_langchain_tool.LangchainTool,
   ListSkillsTool: () => import_list_skills_tool.ListSkillsTool,
   LiveRequestQueue: () => import_live_request_queue.LiveRequestQueue,
   LlamaIndexRetrieval: () => import_llama_index_retrieval.LlamaIndexRetrieval,
   LlmAgent: () => import_llm_agent.LlmAgent,
+  LlmCallsLimitExceededError: () => import_invocation_context.LlmCallsLimitExceededError,
   LlmSummarizer: () => import_llm_summarizer.LlmSummarizer,
   LoadArtifactsTool: () => import_load_artifacts_tool.LoadArtifactsTool,
   LoadMemoryTool: () => import_load_memory_tool.LoadMemoryTool,
@@ -149,6 +155,7 @@ __export(common_exports, {
   ReadonlyContext: () => import_readonly_context.ReadonlyContext,
   ReflectAndRetryModelPlugin: () => import_reflect_retry_model_plugin.ReflectAndRetryModelPlugin,
   ReflectAndRetryToolPlugin: () => import_reflect_retry_tool_plugin.ReflectAndRetryToolPlugin,
+  RemoteAgent: () => import_remote_agent.RemoteAgent,
   RequestInput: () => import_workflow.RequestInput,
   RoutedAgent: () => import_routed_agent.RoutedAgent,
   RoutedLlm: () => import_routed_llm.RoutedLlm,
@@ -173,6 +180,7 @@ __export(common_exports, {
   ToolErrorType: () => import_tool_execution_error.ToolErrorType,
   ToolExecutionError: () => import_tool_execution_error.ToolExecutionError,
   ToolNode: () => import_workflow.ToolNode,
+  ToolboxTool: () => import_toolbox_tool.ToolboxTool,
   TrackingScope: () => import_reflect_retry_utils.TrackingScope,
   TrajectoryThoughtPruningCompactor: () => import_trajectory_thought_pruning_compactor.TrajectoryThoughtPruningCompactor,
   TruncatingContextCompactor: () => import_truncating_context_compactor.TruncatingContextCompactor,
@@ -185,13 +193,21 @@ __export(common_exports, {
   WebMCPToolset: () => import_webmcp_toolset.WebMCPToolset,
   Workflow: () => import_workflow.Workflow,
   WorkflowNode: () => import_workflow.WorkflowNode,
+  appendInstructions: () => import_llm_request.appendInstructions,
   asRunnableRoot: () => import_workflow.asRunnableRoot,
+  buildFunctionDeclarationForLangchain: () => import_function_tool2.buildFunctionDeclarationForLangchain,
+  buildFunctionDeclarationForParamsForCrewai: () => import_function_tool2.buildFunctionDeclarationForParamsForCrewai,
+  buildFunctionDeclarationUtil: () => import_function_tool2.buildFunctionDeclarationUtil,
   commonPrefixOf: () => import_workflow.commonPrefixOf,
+  convertSessionToEvalFormat: () => import_evals.convertSessionToEvalFormat,
+  createEmptyState: () => import_evals.createEmptyState,
   createEvent: () => import_event.createEvent,
   createEventActions: () => import_event_actions.createEventActions,
+  createLlmResponse: () => import_llm_response.createLlmResponse,
   createNodeErrorEvent: () => import_workflow.createNodeErrorEvent,
   createNodeState: () => import_workflow.createNodeState,
   createResumabilityConfig: () => import_resumability_config.createResumabilityConfig,
+  createRunConfig: () => import_run_config.createRunConfig,
   createSession: () => import_session.createSession,
   createSubBranch: () => import_workflow.createSubBranch,
   determineAgentForResumption: () => import_runner.determineAgentForResumption,
@@ -200,16 +216,20 @@ __export(common_exports, {
   findMatchingFunctionCall: () => import_functions.findMatchingFunctionCall,
   functionsExportedForTestingOnly: () => import_functions.functionsExportedForTestingOnly,
   geminiInitParams: () => import_google_llm.geminiInitParams,
+  genaiSchemaToJsonSchema: () => import_genai_schema_to_json.genaiSchemaToJsonSchema,
   generateClientFunctionCallId: () => import_event.generateClientFunctionCallId,
   getAskUserConfirmationFunctionCalls: () => import_security_plugin.getAskUserConfirmationFunctionCalls,
   getClientLabels: () => import_client_labels.getClientLabels,
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
+  getLastHumanMessages: () => import_langgraph_agent.getLastHumanMessages,
   getLogger: () => import_logger.getLogger,
   getModelContext: () => import_webmcp_types.getModelContext,
+  getOAuthGrantTypeFromFlow: () => import_auth_schemes.getOAuthGrantTypeFromFlow,
   getPendingUserInputRequests: () => import_user_input_request.getPendingUserInputRequests,
   getUserChoiceTool: () => import_get_user_choice_tool.getUserChoiceTool,
   getUserInputRequests: () => import_user_input_request.getUserInputRequests,
+  handleFunctionCallsLive: () => import_functions.handleFunctionCallsLive,
   hasThoughts: () => import_event.hasThoughts,
   hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
   isAgentTool: () => import_agent_tool.isAgentTool,
@@ -219,10 +239,12 @@ __export(common_exports, {
   isBaseExampleProvider: () => import_base_example_provider.isBaseExampleProvider,
   isBaseLlm: () => import_base_llm.isBaseLlm,
   isBasePlanner: () => import_base_planner.isBasePlanner,
+  isBaseRetrievalTool: () => import_base_retrieval_tool2.isBaseRetrievalTool,
   isBaseTool: () => import_base_tool.isBaseTool,
   isBaseToolset: () => import_base_toolset.isBaseToolset,
   isBuiltInPlanner: () => import_built_in_planner.isBuiltInPlanner,
   isCompactedEvent: () => import_compacted_event.isCompactedEvent,
+  isCrewaiTool: () => import_crewai_tool.isCrewaiTool,
   isFinalResponse: () => import_event.isFinalResponse,
   isFunctionTool: () => import_function_tool.isFunctionTool,
   isGemini2OrAbove: () => import_model_name.isGemini2OrAbove,
@@ -230,7 +252,10 @@ __export(common_exports, {
   isGemini3xFlashLive: () => import_model_name.isGemini3xFlashLive,
   isGemini3xLive: () => import_model_name.isGemini3xLive,
   isIntentMismatchError: () => import_tool_confirmation.isIntentMismatchError,
+  isLangGraphAgent: () => import_langgraph_agent.isLangGraphAgent,
+  isLangchainTool: () => import_langchain_tool.isLangchainTool,
   isLlmAgent: () => import_llm_agent.isLlmAgent,
+  isLlmCallsLimitExceededError: () => import_invocation_context.isLlmCallsLimitExceededError,
   isLoopAgent: () => import_loop_agent.isLoopAgent,
   isNodeErrorEvent: () => import_workflow.isNodeErrorEvent,
   isNodeReportedError: () => import_workflow.isNodeReportedError,
@@ -238,6 +263,7 @@ __export(common_exports, {
   isNodeState: () => import_workflow.isNodeState,
   isNodeTimeoutError: () => import_workflow.isNodeTimeoutError,
   isParallelAgent: () => import_parallel_agent.isParallelAgent,
+  isRemoteAgent: () => import_remote_agent.isRemoteAgent,
   isRequestInput: () => import_workflow.isRequestInput,
   isRoutableLlmAgent: () => import_runner.isRoutableLlmAgent,
   isRoutedAgent: () => import_routed_agent.isRoutedAgent,
@@ -248,6 +274,7 @@ __export(common_exports, {
   isSessionArtifactService: () => import_session_artifact_service.isSessionArtifactService,
   isStateSchemaError: () => import_state.isStateSchemaError,
   isToolNotFound: () => import_functions.isToolNotFound,
+  isToolboxTool: () => import_toolbox_tool.isToolboxTool,
   isWebMCPSupported: () => import_webmcp_types.isWebMCPSupported,
   isWorkflow: () => import_workflow.isWorkflow,
   logger: () => import_logger.logger,
@@ -271,6 +298,8 @@ __export(common_exports, {
   setLogger: () => import_logger.setLogger,
   stringifyContent: () => import_event.stringifyContent,
   stripAdkIdentityPreamble: () => import_chrome_prompt_llm.stripAdkIdentityPreamble,
+  toGeminiSchema: () => import_gemini_schema_util.toGeminiSchema,
+  toJsonSchema: () => import_schema.toJsonSchema,
   toSnakeCaseName: () => import_case_utils.toSnakeCaseName,
   toStructuredEvents: () => import_structured_events.toStructuredEvents,
   validateAppName: () => import_app.validateAppName,
@@ -283,16 +312,19 @@ var import_base_agent = require("./agents/base_agent.js");
 var import_context = require("./agents/context.js");
 var import_functions = require("./agents/functions.js");
 var import_invocation_context = require("./agents/invocation_context.js");
+var import_langgraph_agent = require("./agents/langgraph_agent.js");
 var import_live_request_queue = require("./agents/live_request_queue.js");
 var import_llm_agent = require("./agents/llm_agent.js");
 var import_loop_agent = require("./agents/loop_agent.js");
 var import_parallel_agent = require("./agents/parallel_agent.js");
 var import_agent_transfer_llm_request_processor = require("./agents/processors/agent_transfer_llm_request_processor.js");
 var import_base_llm_processor = require("./agents/processors/base_llm_processor.js");
+var import_code_execution_request_processor = require("./agents/processors/code_execution_request_processor.js");
 var import_content_request_processor = require("./agents/processors/content_request_processor.js");
 var import_context_compactor_request_processor = require("./agents/processors/context_compactor_request_processor.js");
 var import_interactions_request_processor = require("./agents/processors/interactions_request_processor.js");
 var import_readonly_context = require("./agents/readonly_context.js");
+var import_remote_agent = require("./agents/remote_agent.js");
 var import_routed_agent = require("./agents/routed_agent.js");
 var import_run_config = require("./agents/run_config.js");
 var import_sequential_agent = require("./agents/sequential_agent.js");
@@ -339,6 +371,8 @@ var import_apigee_llm = require("./models/apigee_llm.js");
 var import_base_llm = require("./models/base_llm.js");
 var import_chrome_prompt_llm = require("./models/chrome_prompt_llm.js");
 var import_google_llm = require("./models/google_llm.js");
+var import_llm_request = require("./models/llm_request.js");
+var import_llm_response = require("./models/llm_response.js");
 var import_registry = require("./models/registry.js");
 var import_routed_llm = require("./models/routed_llm.js");
 var import_base_planner = require("./planners/base_planner.js");
@@ -391,8 +425,11 @@ var import_webmcp_types = require("./tools/webmcp/webmcp_types.js");
 var import_async_queue = require("./utils/async_queue.js");
 var import_case_utils = require("./utils/case_utils.js");
 var import_client_labels = require("./utils/client_labels.js");
+var import_gemini_schema_util = require("./utils/gemini_schema_util.js");
+var import_genai_schema_to_json = require("./utils/genai_schema_to_json.js");
 var import_logger = require("./utils/logger.js");
 var import_model_name = require("./utils/model_name.js");
+var import_schema = require("./utils/schema.js");
 var import_simple_zod_to_json = require("./utils/simple_zod_to_json.js");
 var import_task = require("./utils/task.js");
 var import_variant_utils = require("./utils/variant_utils.js");
@@ -412,6 +449,12 @@ __reExport(common_exports, require("./features/feature_registry.js"), module.exp
 __reExport(common_exports, require("./memory/base_memory_service.js"), module.exports);
 __reExport(common_exports, require("./sessions/base_session_service.js"), module.exports);
 __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
+var import_evals = require("./cli/utils/evals.js");
+var import_crewai_tool = require("./tools/crewai_tool.js");
+var import_function_tool2 = require("./tools/function_tool.js");
+var import_langchain_tool = require("./tools/langchain_tool.js");
+var import_base_retrieval_tool2 = require("./tools/retrieval/base_retrieval_tool.js");
+var import_toolbox_tool = require("./tools/toolbox_tool.js");
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -435,6 +478,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   AuthHandler,
   AuthPreprocessor,
   AuthProviderRegistry,
+  AuthSchemeType,
   BaseAgent,
   BaseCodeExecutor,
   BaseEnvironment,
@@ -458,6 +502,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ChromeBuiltInLlm,
   ChromeModelUnavailableError,
   CodeExecutionLanguage,
+  CodeExecutionResponseProcessor,
   ConsolidateContextTool,
   ContentRequestProcessor,
   Context,
@@ -465,6 +510,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ContextCompactorRequestProcessor,
   CredentialExchangeError,
   CredentialRefresherRegistry,
+  CrewaiTool,
   DEFAULT_ROUTE,
   ENTERPRISE_WEB_SEARCH,
   EXIT_LOOP,
@@ -505,10 +551,13 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   LLMRegistry,
   LOAD_ARTIFACTS,
   LOAD_MEMORY,
+  LangGraphAgent,
+  LangchainTool,
   ListSkillsTool,
   LiveRequestQueue,
   LlamaIndexRetrieval,
   LlmAgent,
+  LlmCallsLimitExceededError,
   LlmSummarizer,
   LoadArtifactsTool,
   LoadMemoryTool,
@@ -543,6 +592,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ReadonlyContext,
   ReflectAndRetryModelPlugin,
   ReflectAndRetryToolPlugin,
+  RemoteAgent,
   RequestInput,
   RoutedAgent,
   RoutedLlm,
@@ -567,6 +617,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ToolErrorType,
   ToolExecutionError,
   ToolNode,
+  ToolboxTool,
   TrackingScope,
   TrajectoryThoughtPruningCompactor,
   TruncatingContextCompactor,
@@ -579,13 +630,21 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   WebMCPToolset,
   Workflow,
   WorkflowNode,
+  appendInstructions,
   asRunnableRoot,
+  buildFunctionDeclarationForLangchain,
+  buildFunctionDeclarationForParamsForCrewai,
+  buildFunctionDeclarationUtil,
   commonPrefixOf,
+  convertSessionToEvalFormat,
+  createEmptyState,
   createEvent,
   createEventActions,
+  createLlmResponse,
   createNodeErrorEvent,
   createNodeState,
   createResumabilityConfig,
+  createRunConfig,
   createSession,
   createSubBranch,
   determineAgentForResumption,
@@ -594,16 +653,20 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   findMatchingFunctionCall,
   functionsExportedForTestingOnly,
   geminiInitParams,
+  genaiSchemaToJsonSchema,
   generateClientFunctionCallId,
   getAskUserConfirmationFunctionCalls,
   getClientLabels,
   getFunctionCalls,
   getFunctionResponses,
+  getLastHumanMessages,
   getLogger,
   getModelContext,
+  getOAuthGrantTypeFromFlow,
   getPendingUserInputRequests,
   getUserChoiceTool,
   getUserInputRequests,
+  handleFunctionCallsLive,
   hasThoughts,
   hasTrailingCodeExecutionResult,
   isAgentTool,
@@ -613,10 +676,12 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isBaseExampleProvider,
   isBaseLlm,
   isBasePlanner,
+  isBaseRetrievalTool,
   isBaseTool,
   isBaseToolset,
   isBuiltInPlanner,
   isCompactedEvent,
+  isCrewaiTool,
   isFinalResponse,
   isFunctionTool,
   isGemini2OrAbove,
@@ -624,7 +689,10 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isGemini3xFlashLive,
   isGemini3xLive,
   isIntentMismatchError,
+  isLangGraphAgent,
+  isLangchainTool,
   isLlmAgent,
+  isLlmCallsLimitExceededError,
   isLoopAgent,
   isNodeErrorEvent,
   isNodeReportedError,
@@ -632,6 +700,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isNodeState,
   isNodeTimeoutError,
   isParallelAgent,
+  isRemoteAgent,
   isRequestInput,
   isRoutableLlmAgent,
   isRoutedAgent,
@@ -642,6 +711,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isSessionArtifactService,
   isStateSchemaError,
   isToolNotFound,
+  isToolboxTool,
   isWebMCPSupported,
   isWorkflow,
   logger,
@@ -665,6 +735,8 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   setLogger,
   stringifyContent,
   stripAdkIdentityPreamble,
+  toGeminiSchema,
+  toJsonSchema,
   toSnakeCaseName,
   toStructuredEvents,
   validateAppName,

package/dist/cjs/context/summarizers/llm_summarizer.js

@@ -53,7 +53,7 @@ const _LlmSummarizer = class _LlmSummarizer {
    * @throws {Error} If `events` is empty or the LLM returns no content.
    */
   async summarize(events) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b;
     if (events.length === 0) {
       throw new Error("Cannot summarize an empty list of events.");
     }
@@ -75,18 +75,20 @@ ${formattedEvents}`;
       toolsDict: {},
       liveConnectConfig: {}
     };
-    const responseGen = this.llm.generateContentAsync(request, false);
     let compactedContent = "";
-    const firstResponse = await responseGen.next();
-    if (firstResponse.done || !((_c = (_b = (_a = firstResponse.value.content) == null ? void 0 : _a.parts) == null ? void 0 : _b[0]) == null ? void 0 : _c.text)) {
-      throw new Error("LLM failed to return a valid summary.");
-    }
-    compactedContent += firstResponse.value.content.parts[0].text;
-    for await (const chunk of responseGen) {
-      if ((_f = (_e = (_d = chunk.content) == null ? void 0 : _d.parts) == null ? void 0 : _e[0]) == null ? void 0 : _f.text) {
-        compactedContent += chunk.content.parts[0].text;
+    for await (const response of this.llm.generateContentAsync(
+      request,
+      false
+    )) {
+      for (const part of (_b = (_a = response.content) == null ? void 0 : _a.parts) != null ? _b : []) {
+        if (part.text && !part.thought) {
+          compactedContent += part.text;
+        }
       }
     }
+    if (!compactedContent) {
+      throw new Error("LLM failed to return a valid summary.");
+    }
     return (0, import_compacted_event.createCompactedEvent)({
       author: "system",
       content: {

package/dist/cjs/context/token_based_context_compactor.js

@@ -109,7 +109,8 @@ let TokenBasedContextCompactor = _TokenBasedContextCompactor;
 function latestPromptTokenCount(activeEvents, invocationContext) {
   var _a;
   for (let i = activeEvents.length - 1; i >= 0; i--) {
-    const count = (_a = activeEvents[i].usageMetadata) == null ? void 0 : _a.promptTokenCount;
+    const usage = activeEvents[i].usageMetadata;
+    const count = (_a = usage == null ? void 0 : usage.initialPromptTokenCount) != null ? _a : usage == null ? void 0 : usage.promptTokenCount;
     if (count !== void 0) {
       return count;
     }

package/dist/cjs/events/event.js

@@ -132,8 +132,10 @@ function stringifyContent(event) {
 __name(stringifyContent, "stringifyContent");
 function getEventTokens(event) {
   var _a;
-  if (((_a = event.usageMetadata) == null ? void 0 : _a.promptTokenCount) !== void 0) {
-    return event.usageMetadata.promptTokenCount;
+  const usage = event.usageMetadata;
+  const promptTokenCount = (_a = usage == null ? void 0 : usage.initialPromptTokenCount) != null ? _a : usage == null ? void 0 : usage.promptTokenCount;
+  if (promptTokenCount !== void 0) {
+    return promptTokenCount;
   }
   const contentStr = stringifyContent(event);
   return Math.ceil(contentStr.length / 4);

package/dist/cjs/examples/example_util.js

@@ -28,9 +28,12 @@ __export(example_util_exports, {
   _getLatestMessageFromUser: () => _getLatestMessageFromUser,
   buildExampleSi: () => buildExampleSi,
   convertExamplesToText: () => convertExamplesToText,
-  getLatestMessageFromUser: () => getLatestMessageFromUser
+  getLatestMessageFromUser: () => getLatestMessageFromUser,
+  validateExamples: () => validateExamples
 });
 module.exports = __toCommonJS(example_util_exports);
+var import_zod = require("zod");
+var import_input_validation_error = require("../errors/input_validation_error.js");
 var import_event = require("../events/event.js");
 var import_logger = require("../utils/logger.js");
 var import_base_example_provider = require("./base_example_provider.js");
@@ -39,6 +42,23 @@ var import_base_example_provider = require("./base_example_provider.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+const contentSchema = import_zod.z.object({
+  role: import_zod.z.string().optional(),
+  parts: import_zod.z.array(import_zod.z.object({}).loose()).optional()
+}).loose();
+const examplesSchema = import_zod.z.array(
+  import_zod.z.object({ input: contentSchema, output: import_zod.z.array(contentSchema) })
+);
+function validateExamples(examples) {
+  const result = examplesSchema.safeParse(examples);
+  if (!result.success) {
+    throw new import_input_validation_error.InputValidationError(
+      `Invalid few-shot examples:
+${import_zod.z.prettifyError(result.error)}`
+    );
+  }
+}
+__name(validateExamples, "validateExamples");
 const EXAMPLES_INTRO = "<EXAMPLES>\nBegin few-shot\nThe following are examples of user queries and model responses using the available tools.\n\n";
 const EXAMPLES_END = "End few-shot\n<EXAMPLES>";
 const EXAMPLE_START = "EXAMPLE {}:\nBegin example\n";
@@ -130,5 +150,6 @@ __name(buildExampleSi, "buildExampleSi");
   _getLatestMessageFromUser,
   buildExampleSi,
   convertExamplesToText,
-  getLatestMessageFromUser
+  getLatestMessageFromUser,
+  validateExamples
 });

package/dist/cjs/flows/llm_flows/audio_transcriber.js

@@ -0,0 +1,170 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var audio_transcriber_exports = {};
+__export(audio_transcriber_exports, {
+  AudioEncoding: () => AudioEncoding,
+  AudioTranscriber: () => AudioTranscriber
+});
+module.exports = __toCommonJS(audio_transcriber_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var AudioEncoding = /* @__PURE__ */ ((AudioEncoding2) => {
+  AudioEncoding2[AudioEncoding2["ENCODING_UNSPECIFIED"] = 0] = "ENCODING_UNSPECIFIED";
+  AudioEncoding2[AudioEncoding2["LINEAR16"] = 1] = "LINEAR16";
+  return AudioEncoding2;
+})(AudioEncoding || {});
+function isSpeechClientLike(value) {
+  return typeof value === "object" && value !== null && typeof value.recognize === "function";
+}
+__name(isSpeechClientLike, "isSpeechClientLike");
+function isContentEntry(data) {
+  return "parts" in data || !("data" in data) && !("mimeType" in data);
+}
+__name(isContentEntry, "isContentEntry");
+function blobDataToBytes(data) {
+  if (typeof data !== "string") {
+    return data;
+  }
+  if (data.length > 0 && data.length % 4 === 0 && /^[A-Za-z0-9+/]+={0,2}$/.test(data)) {
+    const atobFn = globalThis.atob;
+    if (typeof Buffer === "undefined" && typeof atobFn === "function") {
+      const binary = atobFn(data);
+      return Uint8Array.from(binary, (char) => char.charCodeAt(0));
+    }
+    return new Uint8Array(Buffer.from(data, "base64"));
+  }
+  return new TextEncoder().encode(data);
+}
+__name(blobDataToBytes, "blobDataToBytes");
+function concatBytes(first, second) {
+  const merged = new Uint8Array(first.length + second.length);
+  merged.set(first, 0);
+  merged.set(second, first.length);
+  return merged;
+}
+__name(concatBytes, "concatBytes");
+const _AudioTranscriber = class _AudioTranscriber {
+  constructor(optionsOrClient) {
+    if (isSpeechClientLike(optionsOrClient)) {
+      this.client = optionsOrClient;
+    } else if (optionsOrClient == null ? void 0 : optionsOrClient.client) {
+      this.client = optionsOrClient.client;
+    } else {
+      this.client = {
+        recognize() {
+          throw new Error(
+            "SpeechClient is not configured on AudioTranscriber. Pass a SpeechClientLike implementation to new AudioTranscriber({client})."
+          );
+        }
+      };
+    }
+  }
+  /**
+   * Bundles consecutive audio blobs from the same speaker in
+   * `invocationContext.transcriptionCache`, transcribes user audio bundles into
+   * text `Content` entries, preserves already-transcribed `Content`
+   * entries in order, clears `invocationContext.transcriptionCache`, and
+   * returns the resulting content list.
+   *
+   * @param invocationContext The invocation context holding `transcriptionCache`.
+   * @returns Ordered list of transcribed `Content` objects.
+   */
+  async transcribeFile(invocationContext) {
+    var _a, _b, _c, _d;
+    const bundledAudio = [];
+    const transcriptionHistory = [];
+    let currentSpeaker = void 0;
+    let currentAudioData = new Uint8Array(0);
+    for (const transcriptionEntry of (_a = invocationContext.transcriptionCache) != null ? _a : []) {
+      const speaker = transcriptionEntry.role;
+      const audioData = transcriptionEntry.data;
+      if (isContentEntry(audioData)) {
+        if (currentSpeaker !== void 0) {
+          bundledAudio.push([currentSpeaker, currentAudioData]);
+          currentSpeaker = void 0;
+          currentAudioData = new Uint8Array(0);
+        }
+        bundledAudio.push([speaker, audioData]);
+        continue;
+      }
+      const rawData = audioData.data;
+      if (!rawData) {
+        continue;
+      }
+      const chunkBytes = blobDataToBytes(rawData);
+      if (chunkBytes.length === 0) {
+        continue;
+      }
+      if (speaker === currentSpeaker) {
+        currentAudioData = concatBytes(currentAudioData, chunkBytes);
+      } else {
+        if (currentSpeaker !== void 0) {
+          bundledAudio.push([currentSpeaker, currentAudioData]);
+        }
+        currentSpeaker = speaker;
+        currentAudioData = chunkBytes;
+      }
+    }
+    if (currentSpeaker !== void 0) {
+      bundledAudio.push([currentSpeaker, currentAudioData]);
+    }
+    invocationContext.transcriptionCache = [];
+    for (const [speaker, data] of bundledAudio) {
+      if (ArrayBuffer.isView(data)) {
+        const audio = { content: data };
+        const config = {
+          encoding: 1 /* LINEAR16 */,
+          sampleRateHertz: 16e3,
+          languageCode: "en-US"
+        };
+        const rawResponse = await this.client.recognize({ config, audio });
+        const response = Array.isArray(rawResponse) ? rawResponse[0] : rawResponse;
+        for (const result of (_b = response.results) != null ? _b : []) {
+          const transcript = (_d = (_c = result.alternatives) == null ? void 0 : _c[0]) == null ? void 0 : _d.transcript;
+          if (transcript !== void 0 && transcript !== null) {
+            transcriptionHistory.push({
+              role: speaker ? speaker.toLowerCase() : "user",
+              parts: [{ text: transcript }]
+            });
+          }
+        }
+      } else {
+        transcriptionHistory.push(data);
+      }
+    }
+    return transcriptionHistory;
+  }
+};
+__name(_AudioTranscriber, "AudioTranscriber");
+let AudioTranscriber = _AudioTranscriber;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AudioEncoding,
+  AudioTranscriber
+});