@iqai/adk 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { Part, Content as Content$1, Blob, SpeechConfig, AudioTranscriptionConfig, RealtimeInputConfig, ProactivityConfig, GenerateContentConfig, LiveConnectConfig, GroundingMetadata, GenerateContentResponseUsageMetadata, GoogleGenAI, FunctionCall } from '@google/genai';
 export { Blob, Content } from '@google/genai';
+import { LanguageModel } from 'ai';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { CreateMessageRequestSchema, CreateMessageResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
@@ -7,6 +8,29 @@ import { Kysely, Generated } from 'kysely';
 import { StorageOptions } from '@google-cloud/storage';
 import { Tracer } from '@opentelemetry/api';
 
+interface LoggerOpts {
+    name: string;
+}
+declare class Logger {
+    name: string;
+    isDebugEnabled: boolean;
+    constructor({ name }: LoggerOpts);
+    private colorize;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    /**
+     * Logs structured data in a visually appealing table format.
+     * Uses vertical layout for better readability and respects debug settings.
+     */
+    debugStructured(title: string, data: Record<string, any>): void;
+    /**
+     * Logs array data in a compact, readable format.
+     */
+    debugArray(title: string, items: Array<Record<string, any>>): void;
+}
+
 /**
  * JSON Schema type for function parameters
  */
@@ -816,6 +840,7 @@ declare abstract class BaseTool {
      * Maximum delay for retry in ms
      */
     maxRetryDelay: number;
+    protected logger: Logger;
     /**
      * Constructor for BaseTool
      */
@@ -983,7 +1008,7 @@ declare function createFunctionTool(func: (...args: any[]) => any, options?: {
  * Simple GoogleSearch tool implementation
  */
 declare class GoogleSearch extends BaseTool {
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for GoogleSearch
      */
@@ -1126,7 +1151,7 @@ declare class UserInteractionTool extends BaseTool {
  * Tool that allows an agent to exit the current execution loop
  */
 declare class ExitLoopTool extends BaseTool {
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for ExitLoopTool
      */
@@ -1141,7 +1166,7 @@ declare class ExitLoopTool extends BaseTool {
  * Tool that allows an agent to get a choice from the user
  */
 declare class GetUserChoiceTool extends BaseTool {
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for GetUserChoiceTool
      */
@@ -1165,7 +1190,7 @@ declare class GetUserChoiceTool extends BaseTool {
  * Tool that allows an agent to transfer control to another agent
  */
 declare class TransferToAgentTool extends BaseTool {
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for TransferToAgentTool
      */
@@ -1182,7 +1207,7 @@ declare class TransferToAgentTool extends BaseTool {
  * Tool that allows an agent to load memories relevant to a query
  */
 declare class LoadMemoryTool extends BaseTool {
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for LoadMemoryTool
      */
@@ -1307,7 +1332,7 @@ declare class McpClientService {
     private transport;
     private isClosing;
     private mcpSamplingHandler;
-    private logger;
+    protected logger: Logger;
     constructor(config: McpConfig);
     /**
      * Initializes and returns an MCP client based on configuration.
@@ -1378,7 +1403,7 @@ declare function mcpSchemaToParameters(mcpTool: Tool): JSONSchema;
  * between MCP format and ADK format
  */
 declare class McpSamplingHandler {
-    private logger;
+    protected logger: Logger;
     private samplingHandler;
     constructor(samplingHandler: SamplingHandler);
     /**
@@ -1442,8 +1467,8 @@ declare function createSamplingHandler(handler: SamplingHandler): SamplingHandle
  * ```typescript
  * // Old verbose way:
  * const toolset = new McpToolset({
- *   name: "Near Intent Swaps MCP Client",
- *   description: "Client for Near Intent Swaps",
+ *   name: "Near Intents Swaps MCP Client",
+ *   description: "Client for Near Intents Swaps",
  *   debug: env.DEBUG,
  *   retryOptions: { maxRetries: 2, initialDelay: 200 },
  *   transport: {
@@ -1500,6 +1525,38 @@ declare function createSamplingHandler(handler: SamplingHandler): SamplingHandle
  *   tools: [...atpTools, ...fraxlendTools],
  * });
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Using MCP servers with sampling handlers:
+ * import { createSamplingHandler, LlmResponse } from "@iqai/adk";
+ *
+ * const samplingHandler = createSamplingHandler(async (request) => {
+ *   // Handle MCP sampling requests
+ *   return new LlmResponse({
+ *     content: {
+ *       role: "model",
+ *       parts: [{ text: "Response from sampling handler" }],
+ *     },
+ *   });
+ * });
+ *
+ * const nearTools = await McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   },
+ *   samplingHandler
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
  */
 /**
  * Base configuration interface for MCP servers
@@ -1516,6 +1573,8 @@ interface McpServerConfig {
         maxRetries?: number;
         initialDelay?: number;
     };
+    /** Sampling handler for processing MCP sampling requests */
+    samplingHandler?: SamplingHandler;
 }
 /**
  * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
@@ -1556,7 +1615,7 @@ declare function McpIqWiki(config?: McpServerConfig): McpToolset;
  */
 declare function McpNearAgent(config?: McpServerConfig): McpToolset;
 /**
- * MCP NEAR Intent Swaps - NEAR Protocol intent swaps functionality
+ * MCP Near Intents Swaps - NEAR Protocol intent swaps functionality
  *
  * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
  * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
@@ -1594,7 +1653,7 @@ declare function McpMemory(config?: McpServerConfig): McpToolset;
  * Generic MCP server function for any package
  *
  * @param packageName The npm package name of the MCP server
- * @param config Configuration object with environment variables
+ * @param config Configuration object with environment variables and optional sampling handler
  * @param name Optional custom name for the client
  */
 declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;
@@ -1878,6 +1937,10 @@ declare class LlmResponse {
      * Reason why the model finished generating.
      */
     finishReason?: string;
+    /**
+     * Error object if the response is an error.
+     */
+    error?: Error;
     /**
      * Creates a new LlmResponse.
      */
@@ -1889,6 +1952,19 @@ declare class LlmResponse {
      * @returns The LlmResponse.
      */
     static create(generateContentResponse: GenerateContentResponse): LlmResponse;
+    /**
+     * Creates an LlmResponse from an error.
+     *
+     * @param error The error object or message.
+     * @param options Additional options for the error response.
+     * @param options.errorCode A specific error code for the response.
+     * @param options.model The model that was being used when the error occurred.
+     * @returns The LlmResponse.
+     */
+    static fromError(error: unknown, options?: {
+        errorCode?: string;
+        model?: string;
+    }): LlmResponse;
 }
 
 /**
@@ -1944,6 +2020,7 @@ declare abstract class BaseLlm {
      * The name of the LLM, e.g. gemini-1.5-flash or gemini-1.5-flash-001.
      */
     model: string;
+    protected logger: Logger;
     /**
      * Constructor for BaseLlm
      */
@@ -2001,7 +2078,6 @@ declare class GoogleLlm extends BaseLlm {
     private _liveApiClient?;
     private _apiBackend?;
     private _trackingHeaders?;
-    private logger;
     /**
      * Constructor for Gemini
      */
@@ -2042,14 +2118,6 @@ declare class GoogleLlm extends BaseLlm {
      * Builds function declaration log string.
      */
     private buildFunctionDeclarationLog;
-    /**
-     * Builds request log string.
-     */
-    private buildRequestLog;
-    /**
-     * Builds response log string.
-     */
-    private buildResponseLog;
     /**
      * Provides the api client.
      */
@@ -2077,6 +2145,7 @@ declare class GoogleLlm extends BaseLlm {
  */
 declare class AnthropicLlm extends BaseLlm {
     private _client?;
+    protected logger: Logger;
     /**
      * Constructor for Anthropic LLM
      */
@@ -2199,17 +2268,48 @@ declare class OpenAiLlm extends BaseLlm {
      */
     private hasInlineData;
     /**
-     * Build request log string for debugging (similar to Google LLM)
+     * Gets the OpenAI client
      */
-    private buildRequestLog;
+    private get client();
+}
+
+/**
+ * AI SDK integration that accepts a pre-configured LanguageModel.
+ * Enables ADK to work with any provider supported by Vercel's AI SDK.
+ */
+declare class AiSdkLlm extends BaseLlm {
+    private modelInstance;
+    protected logger: Logger;
     /**
-     * Build response log string for debugging (similar to Google LLM)
+     * Constructor accepts a pre-configured LanguageModel instance
+     * @param model - Pre-configured LanguageModel from provider(modelName)
      */
-    private buildResponseLog;
+    constructor(modelInstance: LanguageModel);
     /**
-     * Gets the OpenAI client
+     * Returns empty array - following Python ADK pattern
      */
-    private get client();
+    static supportedModels(): string[];
+    protected generateContentAsyncImpl(request: LlmRequest, stream?: boolean): AsyncGenerator<LlmResponse, void, unknown>;
+    /**
+     * Convert ADK LlmRequest to AI SDK CoreMessage format
+     */
+    private convertToAiSdkMessages;
+    /**
+     * Convert ADK tools to AI SDK tools format
+     */
+    private convertToAiSdkTools;
+    /**
+     * Convert ADK Content to AI SDK CoreMessage
+     */
+    private contentToAiSdkMessage;
+    /**
+     * Map ADK role to AI SDK role
+     */
+    private mapRole;
+    /**
+     * Map AI SDK finish reason to ADK finish reason
+     */
+    private mapFinishReason;
 }
 
 /**
@@ -2227,6 +2327,7 @@ declare class LLMRegistry {
      * Map of model name regex to LLM class
      */
     private static llmRegistry;
+    private static logger;
     /**
      * Creates a new LLM instance
      *
@@ -2759,6 +2860,8 @@ declare class OAuth2Credential extends AuthCredential {
  * Models module exports - consolidated to match Python structure
  */
 
+type index$5_AiSdkLlm = AiSdkLlm;
+declare const index$5_AiSdkLlm: typeof AiSdkLlm;
 type index$5_AnthropicLlm = AnthropicLlm;
 declare const index$5_AnthropicLlm: typeof AnthropicLlm;
 type index$5_ApiKeyCredential = ApiKeyCredential;
@@ -2816,7 +2919,7 @@ declare const index$5_State: typeof State;
 type index$5_ThinkingConfig = ThinkingConfig;
 declare const index$5_registerProviders: typeof registerProviders;
 declare namespace index$5 {
-  export { index$5_AnthropicLlm as AnthropicLlm, index$5_ApiKeyCredential as ApiKeyCredential, index$5_ApiKeyScheme as ApiKeyScheme, index$5_AuthConfig as AuthConfig, index$5_AuthCredential as AuthCredential, index$5_AuthCredentialType as AuthCredentialType, index$5_AuthHandler as AuthHandler, index$5_AuthScheme as AuthScheme, index$5_AuthSchemeType as AuthSchemeType, index$5_BaseLLMConnection as BaseLLMConnection, index$5_BaseLlm as BaseLlm, type index$5_BaseMemoryService as BaseMemoryService, index$5_BasicAuthCredential as BasicAuthCredential, index$5_BearerTokenCredential as BearerTokenCredential, index$5_Blob as Blob, Content$1 as Content, type index$5_FunctionDeclaration as FunctionDeclaration, index$5_GoogleLlm as GoogleLlm, index$5_HttpScheme as HttpScheme, type index$5_JSONSchema as JSONSchema, index$5_LLMRegistry as LLMRegistry, index$5_LlmRequest as LlmRequest, index$5_LlmResponse as LlmResponse, index$5_OAuth2Credential as OAuth2Credential, index$5_OAuth2Scheme as OAuth2Scheme, type index$5_OAuthFlow as OAuthFlow, type index$5_OAuthFlows as OAuthFlows, index$5_OpenAiLlm as OpenAiLlm, index$5_OpenIdConnectScheme as OpenIdConnectScheme, type index$5_SearchMemoryResponse as SearchMemoryResponse, type index$5_Session as Session, index$5_State as State, type index$5_ThinkingConfig as ThinkingConfig, index$5_registerProviders as registerProviders };
+  export { index$5_AiSdkLlm as AiSdkLlm, index$5_AnthropicLlm as AnthropicLlm, index$5_ApiKeyCredential as ApiKeyCredential, index$5_ApiKeyScheme as ApiKeyScheme, index$5_AuthConfig as AuthConfig, index$5_AuthCredential as AuthCredential, index$5_AuthCredentialType as AuthCredentialType, index$5_AuthHandler as AuthHandler, index$5_AuthScheme as AuthScheme, index$5_AuthSchemeType as AuthSchemeType, index$5_BaseLLMConnection as BaseLLMConnection, index$5_BaseLlm as BaseLlm, type index$5_BaseMemoryService as BaseMemoryService, index$5_BasicAuthCredential as BasicAuthCredential, index$5_BearerTokenCredential as BearerTokenCredential, index$5_Blob as Blob, Content$1 as Content, type index$5_FunctionDeclaration as FunctionDeclaration, index$5_GoogleLlm as GoogleLlm, index$5_HttpScheme as HttpScheme, type index$5_JSONSchema as JSONSchema, index$5_LLMRegistry as LLMRegistry, index$5_LlmRequest as LlmRequest, index$5_LlmResponse as LlmResponse, index$5_OAuth2Credential as OAuth2Credential, index$5_OAuth2Scheme as OAuth2Scheme, type index$5_OAuthFlow as OAuthFlow, type index$5_OAuthFlows as OAuthFlows, index$5_OpenAiLlm as OpenAiLlm, index$5_OpenIdConnectScheme as OpenIdConnectScheme, type index$5_SearchMemoryResponse as SearchMemoryResponse, type index$5_Session as Session, index$5_State as State, type index$5_ThinkingConfig as ThinkingConfig, index$5_registerProviders as registerProviders };
 }
 
 /**
@@ -3050,6 +3153,101 @@ declare abstract class BaseAgent {
     private setParentAgentForSubAgents;
 }
 
+interface File {
+    /** The name of the file with file extension (e.g., "file.csv") */
+    name: string;
+    /** The base64-encoded bytes of the file content */
+    content: string;
+    /** The mime type of the file (e.g., "image/png") */
+    mimeType: string;
+}
+interface CodeExecutionInput {
+    /** The code to execute */
+    code: string;
+    /** The input files available to the code */
+    inputFiles: File[];
+    /** The execution ID for the stateful code execution */
+    executionId?: string;
+}
+interface CodeExecutionResult {
+    /** The standard output of the code execution */
+    stdout: string;
+    /** The standard error of the code execution */
+    stderr: string;
+    /** The output files from the code execution */
+    outputFiles: File[];
+}
+declare class CodeExecutionUtils {
+    /**
+     * Gets the file content as a base64-encoded string
+     */
+    static getEncodedFileContent(data: string | ArrayBuffer): string;
+    private static isBase64Encoded;
+    /**
+     * Extracts the first code block from the content and truncates everything after it
+     */
+    static extractCodeAndTruncateContent(content: Content$1, codeBlockDelimiters: Array<[string, string]>): string | null;
+    private static escapeRegex;
+    /**
+     * Builds an executable code part with code string
+     */
+    static buildExecutableCodePart(code: string): Part;
+    /**
+     * Builds the code execution result part from the code execution result
+     */
+    static buildCodeExecutionResultPart(codeExecutionResult: CodeExecutionResult): Part;
+    /**
+     * Converts the code execution parts to text parts in a Content
+     */
+    static convertCodeExecutionParts(content: Content$1, codeBlockDelimiter: [string, string], executionResultDelimiters: [string, string]): void;
+}
+
+interface BaseCodeExecutorConfig {
+    /**
+     * If true, extract and process data files from the model request
+     * and attach them to the code executor.
+     * Supported data file MimeTypes are [text/csv].
+     * Default to false.
+     */
+    optimizeDataFile?: boolean;
+    /**
+     * Whether the code executor is stateful. Default to false.
+     */
+    stateful?: boolean;
+    /**
+     * The number of attempts to retry on consecutive code execution errors.
+     * Default to 2.
+     */
+    errorRetryAttempts?: number;
+    /**
+     * The list of the enclosing delimiters to identify the code blocks.
+     * For example, the delimiter ['```python\n', '\n```'] can be
+     * used to identify code blocks with the following format:
+     *
+     * ```python
+     * print("hello")
+     * ```
+     */
+    codeBlockDelimiters?: Array<[string, string]>;
+    /**
+     * The delimiters to format the code execution result.
+     */
+    executionResultDelimiters?: [string, string];
+}
+declare abstract class BaseCodeExecutor {
+    protected readonly config: Required<BaseCodeExecutorConfig>;
+    constructor(config?: BaseCodeExecutorConfig);
+    /**
+     * Executes code and returns the code execution result.
+     */
+    abstract executeCode(invocationContext: InvocationContext, codeExecutionInput: CodeExecutionInput): Promise<CodeExecutionResult>;
+    get optimizeDataFile(): boolean;
+    get stateful(): boolean;
+    get errorRetryAttempts(): number;
+    get codeBlockDelimiters(): Array<[string, string]>;
+    get executionResultDelimiters(): [string, string];
+}
+
 /**
  * Abstract base class for all planners.
  *
@@ -3085,7 +3283,7 @@ type ToolUnion = BaseTool | ((...args: any[]) => any);
 /**
  * Configuration for LlmAgent
  */
-interface LlmAgentConfig {
+interface LlmAgentConfig<T extends BaseLlm = BaseLlm> {
     /**
      * Name of the agent
      */
@@ -3098,7 +3296,7 @@ interface LlmAgentConfig {
      * The LLM model to use
      * When not set, the agent will inherit the model from its ancestor
      */
-    model?: string | BaseLlm;
+    model?: string | T | LanguageModel;
     /**
      * Instructions for the LLM model, guiding the agent's behavior
      */
@@ -3112,6 +3310,10 @@ interface LlmAgentConfig {
      * Tools available to this agent
      */
     tools?: ToolUnion[];
+    /**
+     * Code executor for this agent
+     */
+    codeExecutor?: BaseCodeExecutor;
     /**
      * Disallows LLM-controlled transferring to the parent agent
      */
@@ -3171,12 +3373,12 @@ interface LlmAgentConfig {
 /**
  * LLM-based Agent
  */
-declare class LlmAgent extends BaseAgent {
+declare class LlmAgent<T extends BaseLlm = BaseLlm> extends BaseAgent {
     /**
      * The model to use for the agent
      * When not set, the agent will inherit the model from its ancestor
      */
-    model: string | BaseLlm;
+    model: string | T | LanguageModel;
     /**
      * Instructions for the LLM model, guiding the agent's behavior
      */
@@ -3190,6 +3392,10 @@ declare class LlmAgent extends BaseAgent {
      * Tools available to this agent
      */
     tools: ToolUnion[];
+    /**
+     * Code executor for this agent
+     */
+    codeExecutor?: BaseCodeExecutor;
     /**
      * Disallows LLM-controlled transferring to the parent agent
      */
@@ -3242,11 +3448,11 @@ declare class LlmAgent extends BaseAgent {
      * The output schema when agent replies
      */
     outputSchema?: any;
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for LlmAgent
      */
-    constructor(config: LlmAgentConfig);
+    constructor(config: LlmAgentConfig<T>);
     /**
      * The resolved model field as BaseLLM
      * This method is only for use by Agent Development Kit
@@ -3481,7 +3687,7 @@ declare class LangGraphAgent extends BaseAgent {
      * Results from node executions
      */
     private results;
-    private logger;
+    protected logger: Logger;
     /**
      * Constructor for LangGraphAgent
      */
@@ -3542,7 +3748,7 @@ declare class LangGraphAgent extends BaseAgent {
  * processing, event generation, and interaction with various services like
  * artifact storage, session management, and memory.
  */
-declare class Runner {
+declare class Runner<T extends BaseAgent = BaseAgent> {
     /**
      * The app name of the runner.
      */
@@ -3550,7 +3756,7 @@ declare class Runner {
     /**
      * The root agent to run.
      */
-    agent: BaseAgent;
+    agent: T;
     /**
      * The artifact service for the runner.
      */
@@ -3563,12 +3769,13 @@ declare class Runner {
      * The memory service for the runner.
      */
     memoryService?: BaseMemoryService;
+    protected logger: Logger;
     /**
      * Initializes the Runner.
      */
     constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
         appName: string;
-        agent: BaseAgent;
+        agent: T;
         artifactService?: BaseArtifactService;
         sessionService: BaseSessionService;
         memoryService?: BaseMemoryService;
@@ -3613,7 +3820,7 @@ declare class Runner {
 /**
  * An in-memory Runner for testing and development.
  */
-declare class InMemoryRunner extends Runner {
+declare class InMemoryRunner<T extends BaseAgent = BaseAgent> extends Runner<T> {
     /**
      * Deprecated. Please don't use. The in-memory session service for the runner.
      */
@@ -3621,7 +3828,7 @@ declare class InMemoryRunner extends Runner {
     /**
      * Initializes the InMemoryRunner.
      */
-    constructor(agent: BaseAgent, { appName }?: {
+    constructor(agent: T, { appName }?: {
         appName?: string;
     });
 }
@@ -3631,7 +3838,7 @@ declare class InMemoryRunner extends Runner {
  */
 interface AgentBuilderConfig {
     name: string;
-    model?: string;
+    model?: string | BaseLlm | LanguageModel;
     description?: string;
     instruction?: string;
     tools?: BaseTool[];
@@ -3690,6 +3897,10 @@ type AgentType = "llm" | "sequential" | "parallel" | "loop" | "langgraph";
  *   .withModel("gemini-2.5-flash")
  *   .withSession(sessionService, "user123", "myApp")
  *   .build();
+ *
+ * // Using an AI SDK provider directly
+ * import { google } from "@ai-sdk/google";
+ * const response = await AgentBuilder.withModel(google()).ask("Hi");
  * ```
  */
 declare class AgentBuilder {
@@ -3711,13 +3922,13 @@ declare class AgentBuilder {
      * @param model The model identifier (e.g., "gemini-2.5-flash")
      * @returns New AgentBuilder instance with model set
      */
-    static withModel(model: string): AgentBuilder;
+    static withModel(model: string | BaseLlm | LanguageModel): AgentBuilder;
     /**
      * Set the model for the agent
      * @param model The model identifier (e.g., "gemini-2.5-flash")
      * @returns This builder instance for chaining
      */
-    withModel(model: string): this;
+    withModel(model: string | BaseLlm | LanguageModel): this;
     /**
      * Set the description for the agent
      * @param description Agent description
@@ -3821,9 +4032,9 @@ type index$4_LangGraphAgent = LangGraphAgent;
 declare const index$4_LangGraphAgent: typeof LangGraphAgent;
 type index$4_LangGraphAgentConfig = LangGraphAgentConfig;
 type index$4_LangGraphNode = LangGraphNode;
-type index$4_LlmAgent = LlmAgent;
+type index$4_LlmAgent<T extends BaseLlm = BaseLlm> = LlmAgent<T>;
 declare const index$4_LlmAgent: typeof LlmAgent;
-type index$4_LlmAgentConfig = LlmAgentConfig;
+type index$4_LlmAgentConfig<T extends BaseLlm = BaseLlm> = LlmAgentConfig<T>;
 type index$4_LlmCallsLimitExceededError = LlmCallsLimitExceededError;
 declare const index$4_LlmCallsLimitExceededError: typeof LlmCallsLimitExceededError;
 type index$4_LoopAgent = LoopAgent;
@@ -4219,7 +4430,7 @@ declare namespace index$1 {
 declare abstract class BaseLlmFlow {
     requestProcessors: Array<any>;
     responseProcessors: Array<any>;
-    private logger;
+    protected logger: Logger;
     runAsync(invocationContext: InvocationContext): AsyncGenerator<Event>;
     runLive(invocationContext: InvocationContext): AsyncGenerator<Event>;
     _runOneStepAsync(invocationContext: InvocationContext): AsyncGenerator<Event>;
@@ -4233,6 +4444,15 @@ declare abstract class BaseLlmFlow {
     _handleBeforeModelCallback(invocationContext: InvocationContext, llmRequest: LlmRequest, modelResponseEvent: Event): Promise<LlmResponse | undefined>;
     _handleAfterModelCallback(invocationContext: InvocationContext, llmResponse: LlmResponse, modelResponseEvent: Event): Promise<LlmResponse | undefined>;
     _finalizeModelResponseEvent(llmRequest: LlmRequest, llmResponse: LlmResponse, modelResponseEvent: Event): Event;
+    /**
+     * Logs data in a visually appealing format that works well in any terminal size.
+     * Uses vertical layout for better readability and respects debug settings.
+     */
+    _formatContentPreview(content: any): string;
+    /**
+     * Formats response content preview for debug logging
+     */
+    _formatResponsePreview(llmResponse: LlmResponse): string;
     __getLlm(invocationContext: InvocationContext): BaseLlm;
 }
 
@@ -4371,39 +4591,83 @@ declare const requestProcessor$1: NlPlanningRequestProcessor;
  */
 declare const responseProcessor$1: NlPlanningResponseProcessor;
 
+/**
+ * The persistent context used to configure the code executor.
+ */
+declare class CodeExecutorContext {
+    private readonly context;
+    private readonly sessionState;
+    constructor(sessionState: State);
+    /**
+     * Gets the state delta to update in the persistent session state.
+     */
+    getStateDelta(): Record<string, any>;
+    /**
+     * Gets the session ID for the code executor.
+     */
+    getExecutionId(): string | null;
+    /**
+     * Sets the session ID for the code executor.
+     */
+    setExecutionId(sessionId: string): void;
+    /**
+     * Gets the processed file names from the session state.
+     */
+    getProcessedFileNames(): string[];
+    /**
+     * Adds the processed file names to the session state.
+     */
+    addProcessedFileNames(fileNames: string[]): void;
+    /**
+     * Gets the code executor input files from the session state.
+     */
+    getInputFiles(): File[];
+    /**
+     * Adds the input files to the code executor context.
+     */
+    addInputFiles(inputFiles: File[]): void;
+    /**
+     * Removes the input files and processed file names from the code executor context.
+     */
+    clearInputFiles(): void;
+    /**
+     * Gets the error count from the session state.
+     */
+    getErrorCount(invocationId: string): number;
+    /**
+     * Increments the error count for the given invocation ID.
+     */
+    incrementErrorCount(invocationId: string): void;
+    /**
+     * Resets the error count for the given invocation ID.
+     */
+    resetErrorCount(invocationId: string): void;
+    /**
+     * Updates the code execution result.
+     */
+    updateCodeExecutionResult(invocationId: string, code: string, resultStdout: string, resultStderr: string): void;
+    /**
+     * Gets the code executor context from the session state.
+     */
+    private getCodeExecutorContext;
+}
+
 /**
  * Request processor for code execution
- * This is a placeholder implementation that will be enhanced when code-executors are ready
  */
 declare class CodeExecutionRequestProcessor extends BaseLlmRequestProcessor {
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event>;
-    /**
-     * Placeholder for pre-processor logic
-     * TODO: Implement when code-executors are ready
-     */
-    private runPreProcessor;
 }
 /**
  * Response processor for code execution
- * This is a placeholder implementation that will be enhanced when code-executors are ready
  */
 declare class CodeExecutionResponseProcessor extends BaseLlmResponseProcessor {
     runAsync(invocationContext: InvocationContext, llmResponse: LlmResponse): AsyncGenerator<Event>;
-    /**
-     * Placeholder for post-processor logic
-     * TODO: Implement when code-executors are ready
-     */
-    private runPostProcessor;
 }
 /**
- * Exported request processor instance for use in flow configurations
- * Ready to be connected when code-executors module is implemented
+ * Exported processor instances
  */
 declare const requestProcessor: CodeExecutionRequestProcessor;
-/**
- * Exported response processor instance for use in flow configurations
- * Ready to be connected when code-executors module is implemented
- */
 declare const responseProcessor: CodeExecutionResponseProcessor;
 
 declare const AF_FUNCTION_CALL_ID_PREFIX = "adk-";
@@ -4496,6 +4760,21 @@ declare namespace index {
  */
 declare function injectSessionState(template: string, readonlyContext: ReadonlyContext): Promise<string>;
 
+/**
+ * A code executor that uses the Model's built-in code executor.
+ *
+ * Currently only supports Gemini 2.0+ models, but will be expanded to
+ * other models.
+ */
+declare class BuiltInCodeExecutor extends BaseCodeExecutor {
+    constructor(config?: BaseCodeExecutorConfig);
+    executeCode(invocationContext: InvocationContext, codeExecutionInput: CodeExecutionInput): Promise<CodeExecutionResult>;
+    /**
+     * Pre-process the LLM request for Gemini 2.0+ models to use the code execution tool
+     */
+    processLlmRequest(llmRequest: LlmRequest): void;
+}
+
 /**
  * The built-in planner that uses model's built-in thinking features.
  */
@@ -4634,4 +4913,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInPlanner, CallbackContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, type McpConfig, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntentSwaps, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, type File, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, type McpConfig, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntentSwaps, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };