@google/adk 2.2.1 → 2.4.0

package/dist/types/code_executors/code_execution_utils.d.ts

@@ -90,6 +90,29 @@ export interface CodeExecutionResult {
  * @return The file content as a base64-encoded bytes.
  */
 export declare function getEncodedFileContent(data: string): string;
+/**
+ * Gets the language of the code in a block from the block's leading delimiter.
+ *
+ * @param leadingDelimiter The leading delimiter of a code block, for example
+ *     '```javascript\n'.
+ * @return The language that the fence tag names, or
+ *     `CodeExecutionLanguage.UNSPECIFIED` for a tag that is not known. The
+ *     executor decides what to do with an unspecified language.
+ */
+export declare function getCodeBlockLanguage(leadingDelimiter: string): CodeExecutionLanguage;
+/**
+ * A code block extracted from a model response.
+ */
+export interface ExtractedCodeBlock {
+    /**
+     * The code in the block, or an empty string if there is no block.
+     */
+    code: string;
+    /**
+     * The language of the code, from the fence that matched it.
+     */
+    language: CodeExecutionLanguage;
+}
 /**
  * Extracts the first code block from the content and truncate everything after
  * it.
@@ -100,6 +123,22 @@ export declare function getEncodedFileContent(data: string): string;
  * @return The first code block if found, otherwise an empty string.
  */
 export declare function extractCodeAndTruncateContent(content: Content, codeBlockDelimiters: Array<[string, string]>): string;
+/**
+ * Extracts the first code block and its language from the content, and
+ * truncates everything after it.
+ *
+ * An `executableCode` part holds Python. A code block in text has the
+ * language of the fence tag in its leading delimiter: see
+ * {@link getCodeBlockLanguage}.
+ *
+ * @param content The mutable content to extract the code from.
+ * @param codeBlockDelimiters The list of the enclosing delimiters to identify
+ *     the code blocks.
+ * @return The first code block and its language. With no code block, the
+ *     code is an empty string and the language is
+ *     `CodeExecutionLanguage.UNSPECIFIED`.
+ */
+export declare function extractCodeBlockAndTruncateContent(content: Content, codeBlockDelimiters: Array<[string, string]>): ExtractedCodeBlock;
 /**
  * Builds an executable code part with code string.
  *

package/dist/types/code_executors/code_executor_context.d.ts

@@ -1,5 +1,6 @@
 import { State } from '../sessions/state.js';
 import { File } from './code_execution_utils.js';
+export declare const CONTEXT_KEY = "_code_execution_context";
 /**
  * The parameters for updating the code execution result.
  * */

package/dist/types/code_executors/container_code_executor.d.ts

@@ -56,6 +56,17 @@ export interface ContainerCodeExecutorOptions {
  * can be re-enabled via `networkEnabled: true` when the executed code is
  * trusted.
  *
+ * A separate container is started per session (keyed on `appName`, `userId`,
+ * and `session.id` from `ExecuteCodeParams.invocationContext`) rather than
+ * one container shared across every call: `codeExecutor` is a single
+ * property set once on an `LlmAgent` instance, and that instance is the
+ * long-lived object serving every session the agent handles, so a single
+ * shared container would let one session's files, environment, and
+ * background processes persist into a later, unrelated session's execution.
+ * A container is still reused across multiple calls *within* the same
+ * session, so the per-call container-startup cost is paid once per session,
+ * not once per call.
+ *
  * Limitations: this executor runs a code string only. `inputFiles` and `args`
  * on the request are not copied into the container, and output files are not
  * collected (`outputFiles` is always empty), so tools that stage resource
@@ -67,8 +78,8 @@ export declare class ContainerCodeExecutor extends BaseCodeExecutor {
     private readonly dockerPath?;
     private readonly containerOptions;
     private readonly timeoutSeconds;
-    private container?;
-    private initPromise?;
+    private readonly containers;
+    private readonly initPromises;
     constructor(options?: ContainerCodeExecutorOptions);
     executeCode(params: ExecuteCodeParams): Promise<CodeExecutionResult>;
     /**
@@ -79,11 +90,12 @@ export declare class ContainerCodeExecutor extends BaseCodeExecutor {
      */
     private describeExit;
     /**
-     * Stops and removes the container. Safe to call when no container has been
-     * started; provided for deterministic teardown in tests and app shutdown.
+     * Stops and removes every session's container. Safe to call when none has
+     * been started; provided for deterministic teardown in tests and app
+     * shutdown.
      */
     close(): Promise<void>;
-    /** Lazily builds/starts the container exactly once. */
+    /** Lazily builds/starts the given session's container exactly once. */
     private ensureContainer;
     private initContainer;
 }

package/dist/types/common.d.ts

@@ -8,9 +8,11 @@ export type { ActiveStreamingToolParams } from './agents/active_streaming_tool.j
 export { BaseAgent, isBaseAgent } from './agents/base_agent.js';
 export type { AfterAgentCallback, BaseAgentConfig, BeforeAgentCallback, SingleAgentCallback, } from './agents/base_agent.js';
 export { Context } from './agents/context.js';
-export { REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, REQUEST_CREDENTIAL_FUNCTION_CALL_NAME, REQUEST_INPUT_FUNCTION_CALL_NAME, findEventByFunctionCallId, findMatchingFunctionCall, functionsExportedForTestingOnly, isToolNotFound, } from './agents/functions.js';
-export { InvocationContext, requireAgent } from './agents/invocation_context.js';
+export { REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, REQUEST_CREDENTIAL_FUNCTION_CALL_NAME, REQUEST_INPUT_FUNCTION_CALL_NAME, findEventByFunctionCallId, findMatchingFunctionCall, functionsExportedForTestingOnly, handleFunctionCallsLive, isToolNotFound, } from './agents/functions.js';
+export { InvocationContext, LlmCallsLimitExceededError, isLlmCallsLimitExceededError, requireAgent, } from './agents/invocation_context.js';
 export type { InvocationContextParams, WorkflowInstructionScope, } from './agents/invocation_context.js';
+export { LangGraphAgent, getLastHumanMessages, isLangGraphAgent, } from './agents/langgraph_agent.js';
+export type { CompiledGraphLike, LangGraphAIMessage, LangGraphAgentConfig, LangGraphContentPart, LangGraphHumanMessage, LangGraphInvokeInput, LangGraphInvokeOutput, LangGraphMessageContent, LangGraphMessageLike, LangGraphRunnableConfig, LangGraphStateSnapshot, LangGraphSystemMessage, } from './agents/langgraph_agent.js';
 export { LiveRequestQueue } from './agents/live_request_queue.js';
 export type { LiveRequest } from './agents/live_request_queue.js';
 export { LlmAgent as Agent, LlmAgent, isLlmAgent } from './agents/llm_agent.js';
@@ -20,13 +22,14 @@ export type { LoopAgentConfig } from './agents/loop_agent.js';
 export { ParallelAgent, isParallelAgent } from './agents/parallel_agent.js';
 export { AgentTransferLlmRequestProcessor } from './agents/processors/agent_transfer_llm_request_processor.js';
 export { BaseLlmRequestProcessor, BaseLlmResponseProcessor, } from './agents/processors/base_llm_processor.js';
+export { CodeExecutionResponseProcessor } from './agents/processors/code_execution_request_processor.js';
 export { CONTENT_REQUEST_PROCESSOR, ContentRequestProcessor, } from './agents/processors/content_request_processor.js';
 export { ContextCompactorRequestProcessor } from './agents/processors/context_compactor_request_processor.js';
 export { INTERACTIONS_REQUEST_PROCESSOR, InteractionsRequestProcessor, } from './agents/processors/interactions_request_processor.js';
 export { ReadonlyContext } from './agents/readonly_context.js';
 export { RoutedAgent, isRoutedAgent } from './agents/routed_agent.js';
 export type { AgentRouter, RoutedAgentConfig } from './agents/routed_agent.js';
-export { StreamingMode } from './agents/run_config.js';
+export { StreamingMode, createRunConfig } from './agents/run_config.js';
 export type { RunConfig } from './agents/run_config.js';
 export { SequentialAgent, isSequentialAgent } from './agents/sequential_agent.js';
 export type { TranscriptionEntry } from './agents/transcription_entry.js';
@@ -44,7 +47,7 @@ export type { AuthCredential, HttpAuth, HttpCredentials, OAuth2Auth, ServiceAcco
 export { AuthHandler } from './auth/auth_handler.js';
 export { AUTH_PREPROCESSOR, AuthPreprocessor } from './auth/auth_preprocessor.js';
 export { AuthProviderRegistry } from './auth/auth_provider_registry.js';
-export { OAuthGrantType } from './auth/auth_schemes.js';
+export { AuthSchemeType, OAuthGrantType, getOAuthGrantTypeFromFlow, } from './auth/auth_schemes.js';
 export type { AuthScheme, OpenIdConnectWithConfig } from './auth/auth_schemes.js';
 export type { AuthConfig } from './auth/auth_tool.js';
 export type { BaseAuthProvider } from './auth/base_auth_provider.js';
@@ -104,7 +107,9 @@ export { ChromeBuiltInLlm, ChromeModelUnavailableError, stripAdkIdentityPreamble
 export type { ChromeBuiltInDiagnostic, ChromeBuiltInLlmParams, ChromeCreateCoreOptions, ChromeCreateMonitor, ChromeCreateOptions, ChromeExpectedModality, ChromeLanguageModelFactory, ChromeLanguageModelSession, ChromeMessage, ChromeMessageContent, ChromeModelAvailability, ChromePromptOptions, } from './models/chrome_prompt_llm.js';
 export { Gemini, geminiInitParams } from './models/google_llm.js';
 export type { GeminiParams } from './models/google_llm.js';
+export { appendInstructions } from './models/llm_request.js';
 export type { LlmRequest } from './models/llm_request.js';
+export { createLlmResponse } from './models/llm_response.js';
 export type { LlmResponse } from './models/llm_response.js';
 export { LLMRegistry } from './models/registry.js';
 export type { BaseLlmType } from './models/registry.js';
@@ -115,6 +120,7 @@ export { BuiltInPlanner, isBuiltInPlanner } from './planners/built_in_planner.js
 export { PlanReActPlanner } from './planners/plan_re_act_planner.js';
 export { GLOBAL_SCOPE_KEY, REFLECT_AND_RETRY_RESPONSE_TYPE, ScopedFailureTracker, TrackingScope, resolveScopeKey, type PerItemFailuresCounter, type ToolFailureResponse, } from './plugins/_reflect_retry_utils.js';
 export { BasePlugin, ContextCompactionTrigger } from './plugins/base_plugin.js';
+export type { DebugEntry, DebugLoggingPluginOptions, InvocationDebugState, } from './plugins/debug_logging_plugin.js';
 export { GlobalInstructionPlugin } from './plugins/global_instruction_plugin.js';
 export { LoggingPlugin } from './plugins/logging_plugin.js';
 export { PluginManager } from './plugins/plugin_manager.js';
@@ -176,11 +182,16 @@ export type { WebMCPDocument, WebMCPExecuteToolOptions, WebMCPGetToolsOptions, W
 export { AsyncQueue } from './utils/async_queue.js';
 export { renameReservedKeywords, toSnakeCaseName } from './utils/case_utils.js';
 export { getClientLabels, runWithClientLabel } from './utils/client_labels.js';
+export { toGeminiSchema } from './utils/gemini_schema_util.js';
+export type { MCPToolSchema } from './utils/gemini_schema_util.js';
+export { genaiSchemaToJsonSchema } from './utils/genai_schema_to_json.js';
 export { LogLevel, getLogger, logger, resetLogger, setLogLevel, setLogger, } from './utils/logger.js';
 export type { Logger } from './utils/logger.js';
 export { isGemini2OrAbove, isGemini35LiveTranslate, isGemini3xFlashLive, isGemini3xLive, } from './utils/model_name.js';
+export { toJsonSchema } from './utils/schema.js';
 export type { SchemaLike } from './utils/schema.js';
-export { zodObjectToSchema } from './utils/simple_zod_to_json.js';
+export { isZodObject, isZodSchema, zodObjectToSchema, } from './utils/simple_zod_to_json.js';
+export type { ZodSchema } from './utils/simple_zod_to_json.js';
 export { Task } from './utils/task.js';
 export type { TaskExecutable } from './utils/task.js';
 export { GoogleLLMVariant } from './utils/variant_utils.js';
@@ -204,3 +215,11 @@ export * from './features/feature_registry.js';
 export * from './memory/base_memory_service.js';
 export * from './sessions/base_session_service.js';
 export * from './tools/base_tool.js';
+export { convertSessionToEvalFormat, createEmptyState, } from './cli/utils/evals.js';
+export type { EvaluationItem, IntermediateAgentResponseItem, ToolUseItem, } from './cli/utils/evals.js';
+export { buildFunctionDeclarationForLangchain, buildFunctionDeclarationForParamsForCrewai, buildFunctionDeclarationUtil, } from './tools/function_tool.js';
+export type { CallLiveToolRequest } from './tools/function_tool.js';
+export type { LoadMemoryResponse, LoadMemoryToolOptions, } from './tools/load_memory_tool.js';
+export { isBaseRetrievalTool } from './tools/retrieval/base_retrieval_tool.js';
+export { ToolboxToolset, isToolboxToolset } from './tools/toolbox_toolset.js';
+export type { ToolboxLoadOptions, ToolboxToolLike, ToolboxToolsetClientLike, ToolboxToolsetOptions, } from './tools/toolbox_toolset.js';

package/dist/types/errors/input_validation_error.d.ts

@@ -9,6 +9,7 @@
 export declare class InputValidationError extends Error {
     /**
      * @param message A message describing why the input is invalid.
+     * @param options Standard error options, e.g. `{cause}`.
      */
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }

package/dist/types/events/event.d.ts

@@ -178,6 +178,10 @@ export declare function hasTrailingCodeExecutionResult(event: Event): boolean;
 export declare function stringifyContent(event: Event): string;
 /**
  * Estimates the number of tokens in the event based on usage metadata or characters.
+ *
+ * Prefers `initialPromptTokenCount`, because the promptTokenCount of a
+ * generation that @google/genai resumed after continuation pauses is summed
+ * over every resumed request, each of which resent the prompt.
  */
 export declare function getEventTokens(event: Event): number;
 /**

package/dist/types/examples/example_util.d.ts

@@ -6,6 +6,23 @@
 import { Session } from '../sessions/session.js';
 import { BaseExampleProvider } from './base_example_provider.js';
 import { Example } from './example.js';
+/**
+ * Throws unless `examples` is a well-formed list of {@link Example}s.
+ *
+ * Mirrors `TypeAdapter(list[Example]).validate_python` in the adk-python
+ * `ExampleTool` constructor. {@link Example} is erased at compile time, so a
+ * value that reaches the SDK from untyped JavaScript or from a configuration
+ * file is otherwise unchecked, and a malformed entry only fails later while the
+ * few-shot instruction is rendered.
+ *
+ * The value is checked but not replaced, so it keeps reference identity and no
+ * defensive copy is made.
+ *
+ * @param examples - The value to check.
+ * @throws {InputValidationError} When the value is not a list of well-formed
+ *   examples. The message names the path of each failing field.
+ */
+export declare function validateExamples(examples: unknown): asserts examples is Example[];
 /**
  * Converts a list of examples to a string that can be used in a system
  * instruction.

package/dist/types/flows/llm_flows/audio_transcriber.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Content } from '@google/genai';
+import { InvocationContext } from '../../agents/invocation_context.js';
+/**
+ * Audio encoding values matching Google Cloud Speech-to-Text `AudioEncoding`.
+ */
+export declare enum AudioEncoding {
+    ENCODING_UNSPECIFIED = 0,
+    LINEAR16 = 1
+}
+/**
+ * Configuration passed to a Speech-to-Text client `recognize` call.
+ */
+export interface RecognitionConfig {
+    encoding: AudioEncoding | keyof typeof AudioEncoding | number;
+    sampleRateHertz: number;
+    languageCode: string;
+}
+/**
+ * Audio payload passed to a Speech-to-Text client `recognize` call.
+ */
+export interface RecognitionAudio {
+    content: Uint8Array | string;
+}
+/**
+ * A single alternative hypothesis from a Speech-to-Text recognition result.
+ */
+export interface SpeechRecognitionAlternative {
+    transcript?: string | null;
+    confidence?: number | null;
+}
+/**
+ * A single Speech-to-Text recognition result segment.
+ */
+export interface SpeechRecognitionResult {
+    alternatives?: SpeechRecognitionAlternative[] | null;
+}
+/**
+ * Response returned by a Speech-to-Text client `recognize` call.
+ */
+export interface RecognizeResponse {
+    results?: SpeechRecognitionResult[] | null;
+}
+/**
+ * Duck-typed interface compatible with `@google-cloud/speech`'s `SpeechClient`
+ * as well as lightweight test or browser speech recognition clients.
+ */
+export interface SpeechClientLike {
+    recognize(request: {
+        config: RecognitionConfig;
+        audio: RecognitionAudio;
+    }): Promise<RecognizeResponse | [RecognizeResponse, ...unknown[]]> | RecognizeResponse | [RecognizeResponse, ...unknown[]];
+}
+/**
+ * Options for constructing an {@link AudioTranscriber}.
+ */
+export interface AudioTranscriberOptions {
+    /**
+     * Pre-configured Speech-to-Text client used to transcribe bundled user audio.
+     */
+    client?: SpeechClientLike;
+}
+/**
+ * Transcribes cached audio entries in an {@link InvocationContext} into
+ * conversation `Content` objects.
+ */
+export declare class AudioTranscriber {
+    client: SpeechClientLike;
+    constructor(optionsOrClient?: AudioTranscriberOptions | SpeechClientLike);
+    /**
+     * 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.
+     */
+    transcribeFile(invocationContext: InvocationContext): Promise<Content[]>;
+}

package/dist/types/index.d.ts

@@ -20,20 +20,30 @@ export { VertexAiMemoryBankService } from './memory/vertex_ai_memory_bank_servic
 export type { VertexAiMemoryBankServiceOptions } from './memory/vertex_ai_memory_bank_service.js';
 export { VertexAiRagMemoryService } from './memory/vertex_ai_rag_memory_service.js';
 export type { VertexAiRagMemoryServiceOptions } from './memory/vertex_ai_rag_memory_service.js';
-export { DatabaseSessionService } from './sessions/database_session_service.js';
+export { DebugLoggingPlugin, isDebugLoggingPlugin, } from './plugins/debug_logging_plugin.js';
+export { DatabaseSessionService, isStaleSessionError, StaleSessionError, } from './sessions/database_session_service.js';
+export type { DatabaseSessionServiceOptions } from './sessions/database_session_service.js';
 export { getSessionServiceFromUri } from './sessions/registry.js';
 export { VertexAiSessionService } from './sessions/vertex_ai_session_service.js';
 export type { VertexAiCreateSessionRequest, VertexAiSessionServiceOptions, } from './sessions/vertex_ai_session_service.js';
 export { GCPSkillRegistry } from './skills/gcp_skill_registry.js';
 export type { GCPSkillRegistryOptions } from './skills/gcp_skill_registry.js';
 export { loadAllSkillsInDir, loadSkillFromDir, loadSkillFromZipBuffer, validateSkillDir, } from './skills/loader.js';
+export { APIHubToolset, type APIHubToolsetOptions, } from './tools/apihub_tool/apihub_toolset.js';
+export { APIHubClient, type APIHubApi, type APIHubApiVersion, type APIHubClientOptions, type BaseAPIHubClient, } from './tools/apihub_tool/clients/apihub_client.js';
+export { SecretManagerClient, type SecretManagerClientOptions, } from './tools/apihub_tool/clients/secret_client.js';
+export { ApplicationIntegrationToolset, type ApplicationIntegrationToolsetOptions, } from './tools/application_integration_tool/application_integration_toolset.js';
+export { actionRequest, actionResponse, ConnectionsClient, CONNECTOR_BASE_SPEC, connectorPayload, createOperation, createOperationRequest, deleteOperation, deleteOperationRequest, executeCustomQueryRequest, getActionOperation, getOperation, getOperationRequest, listOperation, listOperationRequest, updateOperation, updateOperationRequest, type ActionSchema, type ConnectionDetails, type ConnectionsClientOptions, type ConnectorSpec, type EntityOperationOptions, type EntitySchemaAndOperations, type EntitySchemaOperationOptions, type GetActionOperationOptions, } from './tools/application_integration_tool/clients/connections_client.js';
+export { IntegrationClient, type IntegrationClientOptions, } from './tools/application_integration_tool/clients/integration_client.js';
+export { IntegrationConnectorTool, type IntegrationConnectorToolOptions, } from './tools/application_integration_tool/integration_connector_tool.js';
 export { LOAD_WEB_PAGE, loadWebPage } from './tools/load_web_page.js';
 export type { LoadWebPageOptions } from './tools/load_web_page.js';
 export { credentialToParam, dictToAuthScheme, INTERNAL_AUTH_PREFIX, openidDictToSchemeCredential, openidUrlToSchemeCredential, serviceAccountDictToSchemeCredential, serviceAccountSchemeCredential, tokenToSchemeCredential, } from './tools/openapi_tool/auth/auth_helpers.js';
+export type { OpenIdConfig } from './tools/openapi_tool/auth/auth_helpers.js';
 export { AutoAuthCredentialExchanger } from './tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js';
 export type { CustomCredentialExchangers } from './tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js';
 export { AuthCredentialMissingError, BaseAuthCredentialExchanger, } from './tools/openapi_tool/auth/credential_exchangers/base_auth_credential_exchanger.js';
-export { exchangeCredential, OAuth2BearerExchanger, } from './tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js';
+export { exchangeCredential, generateAuthToken, OAuth2BearerExchanger, } from './tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js';
 export { ServiceAccountCredentialExchanger } from './tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js';
 export { createApiParameter, generateParamDoc, generateReturnDoc, getTypeHint, } from './tools/openapi_tool/common/common.js';
 export type { ApiParameterInit } from './tools/openapi_tool/common/common.js';
@@ -52,7 +62,14 @@ export { LoadSkillResourceTool } from './tools/skill/load_skill_resource_tool.js
 export { RunSkillInlineScriptErrorCode, RunSkillInlineScriptTool, } from './tools/skill/run_skill_inline_script_tool.js';
 export { RunSkillScriptTool } from './tools/skill/run_skill_script_tool.js';
 export { SkillToolset } from './tools/skill/skill_toolset.js';
+export type { JsonObject } from './utils/json_utils.js';
 export * from './integrations/agent_registry/agent_registry.js';
 export * from './telemetry/google_cloud.js';
 export * from './telemetry/setup.js';
+export * from './tools/google_api_tool/index.js';
+export { DEFAULT_CRITERIA, EVAL_SESSION_ID_PREFIX, EvalStatus, getEvaluationCriteriaOrDefault, getRootAgent, MISSING_EVAL_DEPENDENCIES_MESSAGE, parseAndGetEvalsToRun, RESPONSE_EVALUATION_SCORE_KEY, RESPONSE_MATCH_SCORE_KEY, runEvals, TOOL_TRAJECTORY_SCORE_KEY, tryGetResetFunc, } from './cli/cli_eval.js';
+export type { AddSessionToEvalSetRequest, EvalEntry, EvalInitialSession, EvalMetric, EvalMetricResult, EvalResult, EvalSetItem, InvocationEvalMetricResult, RunEvalRequest, RunEvalResult, RunEvalsOptions, } from './cli/cli_eval.js';
+export { loadDotenvForAgent, walkToRootUntilFound } from './cli/utils/envs.js';
+export { LOGGING_FORMAT, logToTmpFolder, setupAdkLogger, } from './cli/utils/logs.js';
+export type { LogToTmpFolderOptions } from './cli/utils/logs.js';
 export * from './tools/mcp/index.js';

package/dist/types/models/gemini_llm_connection.d.ts

@@ -11,6 +11,7 @@ export declare class GeminiLlmConnection implements BaseLlmConnection {
     private readonly geminiSession;
     private readonly modelVersion?;
     private readonly messageQueue?;
+    private messageIterator?;
     constructor(geminiSession: Session, modelVersion?: string | undefined, messageQueue?: AsyncIterable<LiveServerMessage> | undefined);
     /**
      * Sends the conversation history to the gemini model.
@@ -47,15 +48,13 @@ export declare class GeminiLlmConnection implements BaseLlmConnection {
      */
     sendActivityEnd(): Promise<void>;
     /**
-     * Builds a full text response.
+     * Receives the model responses for one model turn.
      *
-     * The text should not be partial and the returned LlmResponse is not be
-     * partial.
+     * The generator ends after the message that completes the turn has been
+     * processed, or when the server closes the connection. Call `receive()`
+     * again to read the next turn; it continues from the next server message.
      *
-     * @param text The text to be included in the response.
-     * @param isThought Whether the text is a thought.
-     * @param groundingMetadata The grounding metadata to include.
-     * @returns An LlmResponse containing the full text.
+     * @returns A generator of the LlmResponses of one model turn.
      */
     receive(): AsyncGenerator<LlmResponse, void, void>;
     /**

package/dist/types/models/routed_llm.d.ts

@@ -28,7 +28,7 @@ export declare class RoutedLlm extends BaseLlm {
     /**
      * Generates content by delegating to the selected model.
      */
-    generateContentAsync(llmRequest: LlmRequest, stream?: boolean): AsyncGenerator<LlmResponse, void>;
+    generateContentAsync(llmRequest: LlmRequest, stream?: boolean, abortSignal?: AbortSignal): AsyncGenerator<LlmResponse, void>;
     /**
      * Creates a live connection to the LLM by delegating to the selected model.
      * This live connection cannot be switched mid-stream, it is tied to the model

package/dist/types/plugins/base_plugin.d.ts

@@ -375,16 +375,6 @@ export declare abstract class BasePlugin {
         toolContext: Context;
         result: Record<string, unknown>;
     }): Promise<Record<string, unknown> | undefined>;
-    /**
-     * Callback executed when a tool call encounters an error.
-      tool: BaseTool;
-      toolArgs: Record<string, unknown>;
-      toolContext: Context;
-      result: Record<string, unknown>;
-    }): Promise<Record<string, unknown> | undefined> {
-      return;
-    }
-  
     /**
      * Callback executed when a tool call encounters an error.
      *

package/dist/types/runner/in_memory_runner.d.ts

@@ -34,7 +34,8 @@ export declare class InMemoryRunner extends Runner {
      * @param params The configuration for the runner.
      * @param params.app An optional application instance to run.
      * @param params.agent The root agent to run.
-     * @param params.appName The application name. Defaults to `'InMemoryRunner'`.
+     * @param params.appName The application name. Defaults to `app.name` when
+     *     `app` is provided, or `'InMemoryRunner'` otherwise.
      * @param params.plugins An optional list of plugins.
      * @param params.resumabilityConfig An optional resumability configuration.
      */

package/dist/types/runner/runner.d.ts

@@ -65,6 +65,17 @@ export interface RunnerConfig {
      * An optional resumability configuration applied to the runner.
      */
     resumabilityConfig?: ResumabilityConfig;
+    /**
+     * Whether to create the session when `runAsync` is given a session id that
+     * does not exist. Defaults to `false`, which reports the missing session as
+     * an error instead.
+     *
+     * Enabling this trades a loud failure for a silent one: a caller that
+     * mistypes a session id gets a new empty conversation rather than an error.
+     * Turn it on only where the session id is a key the caller owns and a first
+     * use is expected to create it.
+     */
+    autoCreateSession?: boolean;
 }
 /**
  * A unique symbol to identify ADK agent classes.
@@ -116,12 +127,20 @@ export declare class Runner {
     readonly memoryService?: BaseMemoryService;
     readonly credentialService?: BaseCredentialService;
     readonly resumabilityConfig?: ResumabilityConfig;
+    readonly autoCreateSession: boolean;
     /**
      * Creates a new Runner instance.
      *
      * @param input The configuration for the runner.
      */
     constructor(input: RunnerConfig);
+    /**
+     * Looks the session up, creating it first when `autoCreateSession` is set.
+     *
+     * A runner with no `appName` cannot address a session, so it falls through to
+     * the plain lookup rather than creating one under an undefined app name.
+     */
+    private resolveSession;
     /**
      * Runs the agent with a new, ephemeral session.
      *
@@ -171,6 +190,21 @@ export declare class Runner {
      * plugins; there is nothing to lack if there is only one loop.
      */
     private runRoot;
+    /**
+     * Runs the on_event plugin callbacks on an event and appends the result to
+     * the session unless it is partial.
+     *
+     * @returns The event as streamed to the caller.
+     */
+    private processAndAppendEvent;
+    /**
+     * Seals an aborted invocation in session history: answers its dangling
+     * function calls with error responses, or records a plain abort event when
+     * there is nothing to answer.
+     *
+     * @returns The synthetic events after plugin processing and persistence.
+     */
+    private synthesizeAbortEvents;
     /**
      * Saves artifacts from the message parts and replaces the inline data with
      * a file name placeholder and optional file reference.

package/dist/types/sessions/base_session_service.d.ts

@@ -139,6 +139,11 @@ export declare abstract class BaseSessionService {
      */
     private updateSessionState;
 }
+/**
+ * Places `event` into `session.events`, replacing the entry with the same id
+ * if one is already there and appending it otherwise.
+ */
+export declare function upsertSessionEvent(session: Session, event: Event): void;
 /**
  * Removes temporary state delta keys from the event.
  */

package/dist/types/sessions/database_session_service.d.ts

@@ -7,6 +7,21 @@ import type { MikroORMOptions as MikroDBOptions } from './db/operations.js';
 import { Event } from '../events/event.js';
 import { AppendEventRequest, BaseSessionService, CreateSessionRequest, DeleteSessionRequest, GetSessionRequest, ListSessionsRequest, ListSessionsResponse } from './base_session_service.js';
 import { Session } from './session.js';
+export { isStaleSessionError, StaleSessionError } from './stale_session_error.js';
+/**
+ * Options for configuring {@link DatabaseSessionService}.
+ */
+export interface DatabaseSessionServiceOptions extends MikroDBOptions {
+    /**
+     * How to handle stale sessions in {@link DatabaseSessionService.appendEvent}.
+     *
+     * - `'reject'` (default): throws a {@link StaleSessionError} without persisting changes.
+     * - `'reload'`: reloads stored events and state into the session object after writing.
+     *
+     * @deprecated 'reload' is deprecated and will be removed in a future release. Use 'reject' (the default) and re-read the session with `getSession` to retry.
+     */
+    staleSession?: 'reject' | 'reload';
+}
 /**
  * Checks if a URI is a database connection URI.
  *
@@ -22,7 +37,8 @@ export declare class DatabaseSessionService extends BaseSessionService {
     private initialized;
     private options?;
     private connectionString?;
-    constructor(connectionStringOrOptions: MikroDBOptions | string);
+    private readonly staleSession;
+    constructor(connectionStringOrOptions: DatabaseSessionServiceOptions | string, options?: DatabaseSessionServiceOptions);
     init(): Promise<void>;
     createSession({ appName, userId, state, sessionId, }: CreateSessionRequest): Promise<Session>;
     getSession({ appName, userId, sessionId, config, }: GetSessionRequest): Promise<Session | undefined>;

package/dist/types/sessions/stale_session_error.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare const STALE_SESSION_ERROR_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Error thrown when a session write loses an optimistic concurrency race.
+ */
+export declare class StaleSessionError extends Error {
+    readonly [STALE_SESSION_ERROR_SIGNATURE_SYMBOL] = true;
+    constructor(message: string);
+}
+/**
+ * Type guard for {@link StaleSessionError}.
+ *
+ * @param obj The value to check.
+ * @returns True if obj is a {@link StaleSessionError}.
+ */
+export declare function isStaleSessionError(obj: unknown): obj is StaleSessionError;
+export {};

package/dist/types/sessions/state.d.ts

@@ -56,6 +56,9 @@ export declare class State {
     /**
      * Returns the value of the state dict for the given key.
      *
+     * Only keys the state holds itself are found. Names inherited from
+     * `Object.prototype`, such as `toString`, are treated as missing.
+     *
      * @param key The key to get the value for.
      * @param defaultValue The default value to return if the key is not found.
      * @return The value of the state for the given key, or the default value if
@@ -70,7 +73,8 @@ export declare class State {
      */
     set(key: string, value: unknown): void;
     /**
-     * Whether the state has pending delta.
+     * Whether the state holds the given key, either as a stored value or as a
+     * pending delta. Names inherited from `Object.prototype` are not keys.
      */
     has(key: string): boolean;
     /**

package/dist/types/sessions/vertex_ai_session_service.d.ts

@@ -20,7 +20,15 @@ export declare function isVertexAiConnectionString(uri?: string): boolean;
  */
 export declare function quoteFilterLiteral(value: string): string;
 export interface VertexAiSessionServiceOptions {
+    /**
+     * Google Cloud project ID. Defaults to `process.env.GOOGLE_CLOUD_PROJECT`
+     * unless `expressModeApiKey` is passed.
+     */
     projectId?: string;
+    /**
+     * Google Cloud location. Defaults to `process.env.GOOGLE_CLOUD_LOCATION`
+     * unless `expressModeApiKey` is passed.
+     */
     location?: string;
     agentEngineId?: string;
     expressModeApiKey?: string;

package/dist/types/skills/loader.d.ts

@@ -9,7 +9,7 @@ import { Frontmatter, Skill } from './skill.js';
  *
  * @param content - The raw content of the SKILL.md file.
  * @returns An object containing the parsed frontmatter and the remaining markdown body.
- * @throws {Error} If the content is not properly formatted with YAML frontmatter.
+ * @throws {InputValidationError} If the content is not properly formatted with YAML frontmatter.
  */
 export declare function parseSkillMdContent(content: string): {
     frontmatter: Frontmatter;
@@ -44,7 +44,8 @@ export declare function loadAllSkillsInDir(skillsBasePath: string): Promise<Reco
  *
  * @param zipBuffer - The raw Buffer of the zip file containing the skill.
  * @returns A Skill object with all components loaded.
- * @throws {Error} If a member name is a traversal path, if SKILL.md is missing,
+ * @throws {NotFoundError} If the archive has no SKILL.md.
+ * @throws {InputValidationError} If a member name is a traversal path,
  * or if the skill name is missing or is not a bare path segment.
  */
 export declare function loadSkillFromZipBuffer(zipBuffer: Buffer): Skill;

package/dist/types/skills/skill.d.ts

@@ -15,7 +15,7 @@ export declare const FrontmatterSchema: z.ZodPreprocess<z.ZodObject<{
     compatibility: z.ZodOptional<z.ZodString>;
     'allowed-tools': z.ZodOptional<z.ZodString>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-}, z.core.$loose>>;
+}, z.core.$loose>, unknown>;
 export interface Frontmatter {
     name: string;
     description: string;