@iqai/adk 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1431,6 +1431,174 @@ declare class McpSamplingHandler {
  */
 declare function createSamplingHandler(handler: SamplingHandler): SamplingHandler;
 
+/**
+ * Simplified MCP Server Wrappers
+ *
+ * This module provides simplified wrapper functions for IQAI MCP servers and popular third-party MCP servers.
+ * Instead of manually configuring McpToolset with verbose configuration objects, you can use these
+ * convenience functions with flexible configuration objects.
+ *
+ * @example
+ * ```typescript
+ * // Old verbose way:
+ * const toolset = new McpToolset({
+ *   name: "Near Intent Swaps MCP Client",
+ *   description: "Client for Near Intent Swaps",
+ *   debug: env.DEBUG,
+ *   retryOptions: { maxRetries: 2, initialDelay: 200 },
+ *   transport: {
+ *     mode: "stdio",
+ *     command: "npx",
+ *     args: ["-y", "@iqai/mcp-near"],
+ *     env: {
+ *       ACCOUNT_ID: env.ACCOUNT_ID,
+ *       ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *       NEAR_NETWORK_ID: "testnet",
+ *       PATH: env.PATH
+ *     },
+ *   },
+ * });
+ *
+ * // New simplified way:
+ * const toolset = McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   }
+ * });
+ *
+ * // Usage with LLM Agent:
+ * const nearTools = await toolset.getTools();
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multiple MCP servers:
+ * const atpTools = await McpAtp({
+ *   env: {
+ *     ATP_WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY,
+ *     ATP_API_KEY: env.ATP_API_KEY
+ *   }
+ * }).getTools();
+ *
+ * const fraxlendTools = await McpFraxlend({
+ *   env: {
+ *     WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY
+ *   }
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "defi_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: [...atpTools, ...fraxlendTools],
+ * });
+ * ```
+ */
+/**
+ * Base configuration interface for MCP servers
+ */
+interface McpServerConfig {
+    /** Environment variables to pass to the MCP server */
+    env?: Record<string, any>;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom description for the MCP server */
+    description?: string;
+    /** Retry configuration */
+    retryOptions?: {
+        maxRetries?: number;
+        initialDelay?: number;
+    };
+}
+/**
+ * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
+ *
+ * Required env vars: CONTRACT_ABI, CONTRACT_ADDRESS
+ * Optional env vars: CONTRACT_NAME, CHAIN_ID, RPC_URL, WALLET_PRIVATE_KEY
+ */
+declare function McpAbi(config: McpServerConfig): McpToolset;
+/**
+ * MCP ATP - Interact with the IQ AI Agent Tokenization Platform
+ *
+ * Required env vars: ATP_WALLET_PRIVATE_KEY, ATP_API_KEY
+ */
+declare function McpAtp(config: McpServerConfig): McpToolset;
+/**
+ * MCP BAMM - Borrow Automated Market Maker operations on Fraxtal
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpBamm(config: McpServerConfig): McpToolset;
+/**
+ * MCP FRAXLEND - Interact with the Fraxlend lending platform
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpFraxlend(config: McpServerConfig): McpToolset;
+/**
+ * MCP IQWiki - Access and manage IQ.wiki data and user activities
+ *
+ * No required env vars
+ */
+declare function McpIqWiki(config?: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Agent - NEAR Protocol blockchain integration with AI-driven event processing
+ *
+ * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
+ * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
+ */
+declare function McpNearAgent(config: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Intent 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
+ */
+declare function McpNearIntentSwaps(config: McpServerConfig): McpToolset;
+/**
+ * MCP ODOS - Interact with decentralized exchanges through ODOS aggregation
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpOdos(config: McpServerConfig): McpToolset;
+/**
+ * MCP Telegram - Interact with Telegram bots and channels
+ *
+ * Required env vars: TELEGRAM_BOT_TOKEN
+ */
+declare function McpTelegram(config: McpServerConfig): McpToolset;
+/**
+ * Popular third-party MCP servers
+ * These can be added as we expand support for community MCP servers
+ */
+/**
+ * MCP Filesystem - File system operations (third-party)
+ *
+ * Optional env vars: ALLOWED_DIRECTORIES (comma-separated list)
+ */
+declare function McpFilesystem(config?: McpServerConfig): McpToolset;
+/**
+ * MCP Memory - Memory and note-taking capabilities (third-party)
+ *
+ * No required env vars
+ */
+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 name Optional custom name for the client
+ */
+declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;
+
 /**
  * A class for managing MCP tools similar to Python's MCPToolset.
  * Provides functionality to retrieve and use tools from an MCP server.
@@ -1520,15 +1688,28 @@ type index$6_LoadArtifactsTool = LoadArtifactsTool;
 declare const index$6_LoadArtifactsTool: typeof LoadArtifactsTool;
 type index$6_LoadMemoryTool = LoadMemoryTool;
 declare const index$6_LoadMemoryTool: typeof LoadMemoryTool;
+declare const index$6_McpAbi: typeof McpAbi;
+declare const index$6_McpAtp: typeof McpAtp;
+declare const index$6_McpBamm: typeof McpBamm;
 type index$6_McpConfig = McpConfig;
 type index$6_McpError = McpError;
 declare const index$6_McpError: typeof McpError;
 type index$6_McpErrorType = McpErrorType;
 declare const index$6_McpErrorType: typeof McpErrorType;
+declare const index$6_McpFilesystem: typeof McpFilesystem;
+declare const index$6_McpFraxlend: typeof McpFraxlend;
+declare const index$6_McpGeneric: typeof McpGeneric;
+declare const index$6_McpIqWiki: typeof McpIqWiki;
+declare const index$6_McpMemory: typeof McpMemory;
+declare const index$6_McpNearAgent: typeof McpNearAgent;
+declare const index$6_McpNearIntentSwaps: typeof McpNearIntentSwaps;
+declare const index$6_McpOdos: typeof McpOdos;
 type index$6_McpSamplingHandler = McpSamplingHandler;
 declare const index$6_McpSamplingHandler: typeof McpSamplingHandler;
 type index$6_McpSamplingRequest = McpSamplingRequest;
 type index$6_McpSamplingResponse = McpSamplingResponse;
+type index$6_McpServerConfig = McpServerConfig;
+declare const index$6_McpTelegram: typeof McpTelegram;
 type index$6_McpToolset = McpToolset;
 declare const index$6_McpToolset: typeof McpToolset;
 type index$6_McpTransportType = McpTransportType;
@@ -1549,7 +1730,7 @@ declare const index$6_jsonSchemaToDeclaration: typeof jsonSchemaToDeclaration;
 declare const index$6_mcpSchemaToParameters: typeof mcpSchemaToParameters;
 declare const index$6_normalizeJsonSchema: typeof normalizeJsonSchema;
 declare namespace index$6 {
-  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
+  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, index$6_McpAbi as McpAbi, index$6_McpAtp as McpAtp, index$6_McpBamm as McpBamm, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpFilesystem as McpFilesystem, index$6_McpFraxlend as McpFraxlend, index$6_McpGeneric as McpGeneric, index$6_McpIqWiki as McpIqWiki, index$6_McpMemory as McpMemory, index$6_McpNearAgent as McpNearAgent, index$6_McpNearIntentSwaps as McpNearIntentSwaps, index$6_McpOdos as McpOdos, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, type index$6_McpServerConfig as McpServerConfig, index$6_McpTelegram as McpTelegram, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
 }
 
 /**
@@ -3355,10 +3536,282 @@ declare class LangGraphAgent extends BaseAgent {
     setMaxSteps(maxSteps: number): void;
 }
 
+/**
+ * The Runner class is used to run agents.
+ * It manages the execution of an agent within a session, handling message
+ * processing, event generation, and interaction with various services like
+ * artifact storage, session management, and memory.
+ */
+declare class Runner {
+    /**
+     * The app name of the runner.
+     */
+    appName: string;
+    /**
+     * The root agent to run.
+     */
+    agent: BaseAgent;
+    /**
+     * The artifact service for the runner.
+     */
+    artifactService?: BaseArtifactService;
+    /**
+     * The session service for the runner.
+     */
+    sessionService: BaseSessionService;
+    /**
+     * The memory service for the runner.
+     */
+    memoryService?: BaseMemoryService;
+    /**
+     * Initializes the Runner.
+     */
+    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
+        appName: string;
+        agent: BaseAgent;
+        artifactService?: BaseArtifactService;
+        sessionService: BaseSessionService;
+        memoryService?: BaseMemoryService;
+    });
+    /**
+     * Runs the agent synchronously.
+     * NOTE: This sync interface is only for local testing and convenience purpose.
+     * Consider using `runAsync` for production usage.
+     */
+    run({ userId, sessionId, newMessage, runConfig, }: {
+        userId: string;
+        sessionId: string;
+        newMessage: Content$1;
+        runConfig?: RunConfig;
+    }): Generator<Event, void, unknown>;
+    /**
+     * Main entry method to run the agent in this runner.
+     */
+    runAsync({ userId, sessionId, newMessage, runConfig, }: {
+        userId: string;
+        sessionId: string;
+        newMessage: Content$1;
+        runConfig?: RunConfig;
+    }): AsyncGenerator<Event, void, unknown>;
+    /**
+     * Appends a new message to the session.
+     */
+    private _appendNewMessageToSession;
+    /**
+     * Finds the agent to run to continue the session.
+     */
+    private _findAgentToRun;
+    /**
+     * Whether the agent to run can transfer to any other agent in the agent tree.
+     */
+    private _isTransferableAcrossAgentTree;
+    /**
+     * Creates a new invocation context.
+     */
+    private _newInvocationContext;
+}
+/**
+ * An in-memory Runner for testing and development.
+ */
+declare class InMemoryRunner extends Runner {
+    /**
+     * Deprecated. Please don't use. The in-memory session service for the runner.
+     */
+    private _inMemorySessionService;
+    /**
+     * Initializes the InMemoryRunner.
+     */
+    constructor(agent: BaseAgent, { appName }?: {
+        appName?: string;
+    });
+}
+
+/**
+ * Configuration options for the AgentBuilder
+ */
+interface AgentBuilderConfig {
+    name: string;
+    model?: string;
+    description?: string;
+    instruction?: string;
+    tools?: BaseTool[];
+    planner?: BasePlanner;
+    subAgents?: BaseAgent[];
+    maxIterations?: number;
+    nodes?: LangGraphNode[];
+    rootNode?: string;
+}
+/**
+ * Session configuration for the AgentBuilder
+ */
+interface SessionConfig {
+    service: BaseSessionService;
+    userId: string;
+    appName: string;
+    memoryService?: BaseMemoryService;
+    artifactService?: BaseArtifactService;
+}
+/**
+ * Built agent result containing the agent and optional runner/session
+ */
+interface BuiltAgent {
+    agent: BaseAgent;
+    runner?: Runner;
+    session?: Session;
+}
+/**
+ * Agent types that can be built
+ */
+type AgentType = "llm" | "sequential" | "parallel" | "loop" | "langgraph";
+/**
+ * AgentBuilder - A fluent interface for building agents with optional session management
+ *
+ * This builder provides a convenient way to create agents, manage sessions, and
+ * automatically set up runners without the boilerplate code. It supports all
+ * agent types and maintains backward compatibility with existing interfaces.
+ *
+ * Examples:
+ * ```typescript
+ * // Simplest possible usage
+ * const response = await AgentBuilder
+ *   .withModel("gemini-2.5-flash")
+ *   .ask("What is the capital of Australia?");
+ *
+ * // Simple agent with name
+ * const { agent } = AgentBuilder
+ *   .create("my-agent")
+ *   .withModel("gemini-2.5-flash")
+ *   .withInstruction("You are helpful")
+ *   .build();
+ *
+ * // Agent with session and runner
+ * const { agent, runner, session } = await AgentBuilder
+ *   .create("my-agent")
+ *   .withModel("gemini-2.5-flash")
+ *   .withSession(sessionService, "user123", "myApp")
+ *   .build();
+ * ```
+ */
+declare class AgentBuilder {
+    private config;
+    private sessionConfig?;
+    private agentType;
+    /**
+     * Private constructor - use static create() method
+     */
+    private constructor();
+    /**
+     * Create a new AgentBuilder instance
+     * @param name The name of the agent (defaults to "default_agent")
+     * @returns New AgentBuilder instance
+     */
+    static create(name?: string): AgentBuilder;
+    /**
+     * Convenience method to start building with a model directly
+     * @param model The model identifier (e.g., "gemini-2.5-flash")
+     * @returns New AgentBuilder instance with model set
+     */
+    static withModel(model: string): 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;
+    /**
+     * Set the description for the agent
+     * @param description Agent description
+     * @returns This builder instance for chaining
+     */
+    withDescription(description: string): this;
+    /**
+     * Set the instruction for the agent
+     * @param instruction System instruction for the agent
+     * @returns This builder instance for chaining
+     */
+    withInstruction(instruction: string): this;
+    /**
+     * Add tools to the agent
+     * @param tools Tools to add to the agent
+     * @returns This builder instance for chaining
+     */
+    withTools(...tools: BaseTool[]): this;
+    /**
+     * Set the planner for the agent
+     * @param planner The planner to use
+     * @returns This builder instance for chaining
+     */
+    withPlanner(planner: BasePlanner): this;
+    /**
+     * Configure as a sequential agent
+     * @param subAgents Sub-agents to execute in sequence
+     * @returns This builder instance for chaining
+     */
+    asSequential(subAgents: BaseAgent[]): this;
+    /**
+     * Configure as a parallel agent
+     * @param subAgents Sub-agents to execute in parallel
+     * @returns This builder instance for chaining
+     */
+    asParallel(subAgents: BaseAgent[]): this;
+    /**
+     * Configure as a loop agent
+     * @param subAgents Sub-agents to execute iteratively
+     * @param maxIterations Maximum number of iterations
+     * @returns This builder instance for chaining
+     */
+    asLoop(subAgents: BaseAgent[], maxIterations?: number): this;
+    /**
+     * Configure as a LangGraph agent
+     * @param nodes Graph nodes defining the workflow
+     * @param rootNode The starting node name
+     * @returns This builder instance for chaining
+     */
+    asLangGraph(nodes: LangGraphNode[], rootNode: string): this;
+    /**
+     * Configure session management
+     * @param service Session service to use
+     * @param userId User identifier
+     * @param appName Application name
+     * @param memoryService Optional memory service
+     * @param artifactService Optional artifact service
+     * @returns This builder instance for chaining
+     */
+    withSession(service: BaseSessionService, userId: string, appName: string, memoryService?: BaseMemoryService, artifactService?: BaseArtifactService): this;
+    /**
+     * Configure with an in-memory session (for quick setup)
+     * @param appName Application name
+     * @param userId User identifier
+     * @returns This builder instance for chaining
+     */
+    withQuickSession(appName: string, userId: string): this;
+    /**
+     * Build the agent and optionally create runner and session
+     * @returns Built agent with optional runner and session
+     */
+    build(): Promise<BuiltAgent>;
+    /**
+     * Quick execution helper - build and run a message
+     * @param message Message to send to the agent
+     * @returns Agent response
+     */
+    ask(message: string): Promise<string>;
+    /**
+     * Create the appropriate agent type based on configuration
+     * @returns Created agent instance
+     */
+    private createAgent;
+}
+
 type index$4_AfterAgentCallback = AfterAgentCallback;
+type index$4_AgentBuilder = AgentBuilder;
+declare const index$4_AgentBuilder: typeof AgentBuilder;
+type index$4_AgentBuilderConfig = AgentBuilderConfig;
+type index$4_AgentType = AgentType;
 type index$4_BaseAgent = BaseAgent;
 declare const index$4_BaseAgent: typeof BaseAgent;
 type index$4_BeforeAgentCallback = BeforeAgentCallback;
+type index$4_BuiltAgent = BuiltAgent;
 type index$4_CallbackContext = CallbackContext;
 declare const index$4_CallbackContext: typeof CallbackContext;
 type index$4_InstructionProvider = InstructionProvider;
@@ -3386,13 +3839,14 @@ declare const index$4_RunConfig: typeof RunConfig;
 type index$4_SequentialAgent = SequentialAgent;
 declare const index$4_SequentialAgent: typeof SequentialAgent;
 type index$4_SequentialAgentConfig = SequentialAgentConfig;
+type index$4_SessionConfig = SessionConfig;
 type index$4_SingleAgentCallback = SingleAgentCallback;
 type index$4_StreamingMode = StreamingMode;
 declare const index$4_StreamingMode: typeof StreamingMode;
 type index$4_ToolUnion = ToolUnion;
 declare const index$4_newInvocationContextId: typeof newInvocationContextId;
 declare namespace index$4 {
-  export { type index$4_AfterAgentCallback as AfterAgentCallback, LlmAgent as Agent, index$4_BaseAgent as BaseAgent, type index$4_BeforeAgentCallback as BeforeAgentCallback, index$4_CallbackContext as CallbackContext, type index$4_InstructionProvider as InstructionProvider, index$4_InvocationContext as InvocationContext, index$4_LangGraphAgent as LangGraphAgent, type index$4_LangGraphAgentConfig as LangGraphAgentConfig, type index$4_LangGraphNode as LangGraphNode, index$4_LlmAgent as LlmAgent, type index$4_LlmAgentConfig as LlmAgentConfig, index$4_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$4_LoopAgent as LoopAgent, type index$4_LoopAgentConfig as LoopAgentConfig, index$4_ParallelAgent as ParallelAgent, type index$4_ParallelAgentConfig as ParallelAgentConfig, index$4_ReadonlyContext as ReadonlyContext, index$4_RunConfig as RunConfig, index$4_SequentialAgent as SequentialAgent, type index$4_SequentialAgentConfig as SequentialAgentConfig, type index$4_SingleAgentCallback as SingleAgentCallback, index$4_StreamingMode as StreamingMode, type index$4_ToolUnion as ToolUnion, index$4_newInvocationContextId as newInvocationContextId };
+  export { type index$4_AfterAgentCallback as AfterAgentCallback, LlmAgent as Agent, index$4_AgentBuilder as AgentBuilder, type index$4_AgentBuilderConfig as AgentBuilderConfig, type index$4_AgentType as AgentType, index$4_BaseAgent as BaseAgent, type index$4_BeforeAgentCallback as BeforeAgentCallback, type index$4_BuiltAgent as BuiltAgent, index$4_CallbackContext as CallbackContext, type index$4_InstructionProvider as InstructionProvider, index$4_InvocationContext as InvocationContext, index$4_LangGraphAgent as LangGraphAgent, type index$4_LangGraphAgentConfig as LangGraphAgentConfig, type index$4_LangGraphNode as LangGraphNode, index$4_LlmAgent as LlmAgent, type index$4_LlmAgentConfig as LlmAgentConfig, index$4_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$4_LoopAgent as LoopAgent, type index$4_LoopAgentConfig as LoopAgentConfig, index$4_ParallelAgent as ParallelAgent, type index$4_ParallelAgentConfig as ParallelAgentConfig, index$4_ReadonlyContext as ReadonlyContext, index$4_RunConfig as RunConfig, index$4_SequentialAgent as SequentialAgent, type index$4_SequentialAgentConfig as SequentialAgentConfig, type index$4_SessionConfig as SessionConfig, type index$4_SingleAgentCallback as SingleAgentCallback, index$4_StreamingMode as StreamingMode, type index$4_ToolUnion as ToolUnion, index$4_newInvocationContextId as newInvocationContextId };
 }
 
 /**
@@ -4108,96 +4562,6 @@ declare class PlanReActPlanner extends BasePlanner {
     private _buildNlPlannerInstruction;
 }
 
-/**
- * The Runner class is used to run agents.
- * It manages the execution of an agent within a session, handling message
- * processing, event generation, and interaction with various services like
- * artifact storage, session management, and memory.
- */
-declare class Runner {
-    /**
-     * The app name of the runner.
-     */
-    appName: string;
-    /**
-     * The root agent to run.
-     */
-    agent: BaseAgent;
-    /**
-     * The artifact service for the runner.
-     */
-    artifactService?: BaseArtifactService;
-    /**
-     * The session service for the runner.
-     */
-    sessionService: BaseSessionService;
-    /**
-     * The memory service for the runner.
-     */
-    memoryService?: BaseMemoryService;
-    /**
-     * Initializes the Runner.
-     */
-    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
-        appName: string;
-        agent: BaseAgent;
-        artifactService?: BaseArtifactService;
-        sessionService: BaseSessionService;
-        memoryService?: BaseMemoryService;
-    });
-    /**
-     * Runs the agent synchronously.
-     * NOTE: This sync interface is only for local testing and convenience purpose.
-     * Consider using `runAsync` for production usage.
-     */
-    run({ userId, sessionId, newMessage, runConfig, }: {
-        userId: string;
-        sessionId: string;
-        newMessage: Content$1;
-        runConfig?: RunConfig;
-    }): Generator<Event, void, unknown>;
-    /**
-     * Main entry method to run the agent in this runner.
-     */
-    runAsync({ userId, sessionId, newMessage, runConfig, }: {
-        userId: string;
-        sessionId: string;
-        newMessage: Content$1;
-        runConfig?: RunConfig;
-    }): AsyncGenerator<Event, void, unknown>;
-    /**
-     * Appends a new message to the session.
-     */
-    private _appendNewMessageToSession;
-    /**
-     * Finds the agent to run to continue the session.
-     */
-    private _findAgentToRun;
-    /**
-     * Whether the agent to run can transfer to any other agent in the agent tree.
-     */
-    private _isTransferableAcrossAgentTree;
-    /**
-     * Creates a new invocation context.
-     */
-    private _newInvocationContext;
-}
-/**
- * An in-memory Runner for testing and development.
- */
-declare class InMemoryRunner extends Runner {
-    /**
-     * Deprecated. Please don't use. The in-memory session service for the runner.
-     */
-    private _inMemorySessionService;
-    /**
-     * Initializes the InMemoryRunner.
-     */
-    constructor(agent: BaseAgent, { appName }?: {
-        appName?: string;
-    });
-}
-
 interface TelemetryConfig {
     appName: string;
     appVersion?: string;
@@ -4270,4 +4634,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, 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, 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, type McpConfig, McpError, McpErrorType, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, 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, 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, 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 };