@iqai/adk 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @iqai/adk
 
+## 0.1.7
+
+### Patch Changes
+
+- 6e97c5a: Improve agent builder to take minimal params and improved experience with runner.ask
+
+## 0.1.6
+
+### Patch Changes
+
+- 6bc189d: Adds coingecko mcp server definition
+
 ## 0.1.5
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,14 @@
-# @iqai/adk - Agent Development Kit Core
+<div align="center">
 
-`@iqai/adk` is the core TypeScript library for the Agent Development Kit, providing the foundational tools and abstractions to build sophisticated AI agents. It enables seamless integration with multiple Large Language Models (LLMs), advanced tool usage, and persistent memory capabilities.
+<img src="https://files.catbox.moe/vumztw.png" alt="ADK TypeScript Logo" width="100" />
+
+<br/>
+
+# @iqai/adk
+
+**The core TypeScript library for building sophisticated AI agents with multi-LLM support, advanced tools, and flexible conversation flows.**
+
+*Production-ready • Multi-Agent Systems • Extensible Architecture*
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@iqai/adk">
@@ -17,30 +25,43 @@
   </a>
 </p>
 
-## 🚀 Core Features
+---
+
+</div>
 
-The `@iqai/adk` package empowers your AI agent development with:
+## 🌟 Overview
 
-*   **Multi-Provider LLM Support:** Flexibly integrate and switch between leading LLM providers like OpenAI, Anthropic, and Google.
-*   **Extensible Tool System:** Define and utilize custom tools with declarative schemas, allowing LLMs to intelligently leverage external functionalities.
-*   **Advanced Agent Reasoning Loop:** A complete reasoning loop implementation for complex task execution and iterative problem-solving.
-*   **Real-Time Streaming:** Support for streaming responses from LLMs for dynamic user interactions.
-*   **Flexible Authentication:** Mechanisms for securing agent API access.
-*   **Persistent Memory Systems:** Capabilities for agents to retain context and learn from past interactions.
+`@iqai/adk` is the core TypeScript library for the Agent Development Kit, providing the foundational tools and abstractions to build sophisticated AI agents. It enables seamless integration with multiple Large Language Models (LLMs), advanced tool usage, and persistent memory capabilities.
+
+## 🚀 Key Features
+
+- **🤖 Multi-Provider LLM Support** - Seamlessly integrate OpenAI, Anthropic, Google, and other leading providers
+- **🛠️ Extensible Tool System** - Define custom tools with declarative schemas for intelligent LLM integration
+- **🧠 Advanced Agent Reasoning** - Complete reasoning loop implementation for complex task execution
+- **⚡ Real-Time Streaming** - Support for streaming responses and dynamic user interactions
+- **🔐 Flexible Authentication** - Secure agent API access with multiple auth mechanisms
+- **💾 Persistent Memory Systems** - Context retention and learning from past interactions
+- **🔄 Multi-Agent Orchestration** - Sequential, parallel, and loop-based agent workflows
+- **📊 Built-in Telemetry** - Comprehensive monitoring and analytics capabilities
 
-## 🚦 Installation
+## 🚀 Quick Start
 
-Install the `@iqai/adk` package using your preferred package manager:
+### Installation
 
 ```bash
-# Using npm
 npm install @iqai/adk
+```
+
+### Simple Example
+
+```typescript
+import { AgentBuilder } from '@iqai/adk';
 
-# Using yarn
-yarn add @iqai/adk
+const response = await AgentBuilder
+  .withModel("gpt-4")
+  .ask("What is the primary function of an AI agent?");
 
-# Using pnpm
-pnpm add @iqai/adk
+console.log(response);
 ```
 
 ## ⚙️ Environment Configuration
@@ -228,12 +249,84 @@ async function performCalculation() {
 performCalculation().catch(console.error);
 ```
 
-More detailed examples and advanced usage patterns can be found in the `apps/examples` directory of the main [ADK TypeScript repository](https://github.com/IQAIcom/adk-ts).
+## 🏗️ Advanced Features
+
+### Multi-Agent Systems
+
+```typescript
+import { AgentBuilder } from '@iqai/adk';
+
+// Sequential workflow
+const workflow = await AgentBuilder
+  .create("data_pipeline")
+  .asSequential([dataCollector, dataProcessor, dataAnalyzer])
+  .withQuickSession("pipeline-app", "admin")
+  .build();
+
+// Parallel execution
+const parallelAnalysis = await AgentBuilder
+  .create("multi_analysis")
+  .asParallel([sentimentAnalyzer, topicExtractor, summaryGenerator])
+  .build();
+```
+
+### Memory & Sessions
+
+```typescript
+import { Agent, InMemorySessionService } from '@iqai/adk';
+
+const agent = new Agent({
+  name: "persistent_assistant",
+  model: "gpt-4-turbo",
+  sessionService: new InMemorySessionService(),
+  instructions: "Remember our conversation history."
+});
+```
+
+### Custom Tools
+
+```typescript
+import { BaseTool } from '@iqai/adk';
+
+class WeatherTool extends BaseTool {
+  constructor() {
+    super({
+      name: 'weather',
+      description: 'Get current weather information'
+    });
+  }
+
+  async runAsync(args: { location: string }) {
+    // Implementation here
+    return { temperature: 72, condition: 'sunny' };
+  }
+}
+```
+
+## 📚 Documentation
+
+For comprehensive guides, API reference, and advanced examples:
+
+**[https://adk.iqai.com](https://adk.iqai.com)**
+
+## 🧪 Examples
+
+Explore comprehensive examples in the main repository:
+
+```bash
+git clone https://github.com/IQAIcom/adk-ts
+cd adk-ts/apps/examples
+pnpm install && pnpm dev
+```
 
 ## 🤝 Contributing
 
-While this README focuses on the `@iqai/adk` package, contributions to the overall ADK TypeScript project are welcome. Please see the [Contributing Guide](https://github.com/IQAIcom/adk-ts/blob/main/CONTRIBUTING.md) in the main repository for details on how to contribute.
+Contributions are welcome! See our [Contributing Guide](https://github.com/IQAIcom/adk-ts/blob/main/CONTRIBUTION.md) for details.
 
 ## 📜 License
 
-This package is licensed under the [MIT License](https://github.com/IQAIcom/adk-ts/blob/main/LICENSE.md).
+MIT License - see [LICENSE](https://github.com/IQAIcom/adk-ts/blob/main/LICENSE.md) for details.
+
+---
+
+**Ready to build your first AI agent?** Visit [https://adk.iqai.com](https://adk.iqai.com) to get started!

package/dist/index.d.mts

@@ -1633,6 +1633,12 @@ declare function McpOdos(config?: McpServerConfig): McpToolset;
  * Required env vars: TELEGRAM_BOT_TOKEN
  */
 declare function McpTelegram(config?: McpServerConfig): McpToolset;
+/**
+ * MCP CoinGecko - Access cryptocurrency market data and analytics
+ *
+ * Optional env vars: COINGECKO_PRO_API_KEY, COINGECKO_DEMO_API_KEY, COINGECKO_ENVIRONMENT
+ */
+declare function McpCoinGecko(config?: McpServerConfig): McpToolset;
 /**
  * Popular third-party MCP servers
  * These can be added as we expand support for community MCP servers
@@ -1750,6 +1756,7 @@ 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;
+declare const index$6_McpCoinGecko: typeof McpCoinGecko;
 type index$6_McpConfig = McpConfig;
 type index$6_McpError = McpError;
 declare const index$6_McpError: typeof McpError;
@@ -1789,7 +1796,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, 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 };
+  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, index$6_McpCoinGecko as McpCoinGecko, 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 };
 }
 
 /**
@@ -3531,6 +3538,17 @@ declare class SequentialAgent extends BaseAgent {
     protected runLiveImpl(ctx: InvocationContext): AsyncGenerator<Event, void, unknown>;
 }
 
+/**
+ * Create isolated branch for every sub-agent.
+ */
+declare function createBranchContextForSubAgent(agent: BaseAgent, subAgent: BaseAgent, invocationContext: InvocationContext): InvocationContext;
+/**
+ * Merges the agent run event generator.
+ *
+ * This implementation guarantees for each agent, it won't move on until the
+ * generated event is processed by upstream runner.
+ */
+declare function mergeAgentRun(agentRuns: AsyncGenerator<Event, void, unknown>[]): AsyncGenerator<Event, void, unknown>;
 /**
  * Configuration for ParallelAgent
  */
@@ -3742,97 +3760,6 @@ 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<T extends BaseAgent = BaseAgent> {
-    /**
-     * The app name of the runner.
-     */
-    appName: string;
-    /**
-     * The root agent to run.
-     */
-    agent: T;
-    /**
-     * The artifact service for the runner.
-     */
-    artifactService?: BaseArtifactService;
-    /**
-     * The session service for the runner.
-     */
-    sessionService: BaseSessionService;
-    /**
-     * The memory service for the runner.
-     */
-    memoryService?: BaseMemoryService;
-    protected logger: Logger;
-    /**
-     * Initializes the Runner.
-     */
-    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
-        appName: string;
-        agent: T;
-        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<T extends BaseAgent = BaseAgent> extends Runner<T> {
-    /**
-     * Deprecated. Please don't use. The in-memory session service for the runner.
-     */
-    private _inMemorySessionService;
-    /**
-     * Initializes the InMemoryRunner.
-     */
-    constructor(agent: T, { appName }?: {
-        appName?: string;
-    });
-}
-
 /**
  * Configuration options for the AgentBuilder
  */
@@ -3858,12 +3785,35 @@ interface SessionConfig {
     memoryService?: BaseMemoryService;
     artifactService?: BaseArtifactService;
 }
+/**
+ * Message part interface for flexible message input
+ */
+interface MessagePart extends Part {
+    image?: string;
+}
+/**
+ * Full message interface for advanced usage
+ */
+interface FullMessage extends Content$1 {
+    parts?: MessagePart[];
+}
+/**
+ * Enhanced runner interface with simplified API
+ */
+interface EnhancedRunner {
+    ask(message: string | FullMessage): Promise<string>;
+    runAsync(params: {
+        userId: string;
+        sessionId: string;
+        newMessage: FullMessage;
+    }): AsyncIterable<Event>;
+}
 /**
  * Built agent result containing the agent and optional runner/session
  */
 interface BuiltAgent {
     agent: BaseAgent;
-    runner?: Runner;
+    runner?: EnhancedRunner;
     session?: Session;
 }
 /**
@@ -3871,36 +3821,30 @@ interface BuiltAgent {
  */
 type AgentType = "llm" | "sequential" | "parallel" | "loop" | "langgraph";
 /**
- * AgentBuilder - A fluent interface for building agents with optional session management
+ * AgentBuilder - A fluent interface for creating AI agents with automatic 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.
+ * Provides a simple, chainable API for building different types of agents (LLM, Sequential,
+ * Parallel, Loop, LangGraph) with tools, custom instructions, and multi-agent workflows.
+ * Sessions are automatically created using in-memory storage by default.
  *
- * Examples:
+ * @example
  * ```typescript
- * // Simplest possible usage
- * const response = await AgentBuilder
- *   .withModel("gemini-2.5-flash")
- *   .ask("What is the capital of Australia?");
+ * // Simple usage
+ * const response = await AgentBuilder.withModel("gemini-2.5-flash").ask("Hello");
  *
- * // Simple agent with name
- * const { agent } = AgentBuilder
- *   .create("my-agent")
+ * // With tools and instructions
+ * const { runner } = await AgentBuilder
+ *   .create("research-agent")
  *   .withModel("gemini-2.5-flash")
- *   .withInstruction("You are helpful")
+ *   .withTools(new GoogleSearch())
+ *   .withInstruction("You are a research assistant")
  *   .build();
  *
- * // Agent with session and runner
- * const { agent, runner, session } = await AgentBuilder
- *   .create("my-agent")
- *   .withModel("gemini-2.5-flash")
- *   .withSession(sessionService, "user123", "myApp")
+ * // Multi-agent workflow
+ * const { runner } = await AgentBuilder
+ *   .create("workflow")
+ *   .asSequential([agent1, agent2])
  *   .build();
- *
- * // Using an AI SDK provider directly
- * import { google } from "@ai-sdk/google";
- * const response = await AgentBuilder.withModel(google()).ask("Hi");
  * ```
  */
 declare class AgentBuilder {
@@ -3980,22 +3924,23 @@ declare class AgentBuilder {
      */
     asLangGraph(nodes: LangGraphNode[], rootNode: string): this;
     /**
-     * Configure session management
+     * Configure session management with optional smart defaults
      * @param service Session service to use
-     * @param userId User identifier
-     * @param appName Application name
+     * @param userId User identifier (optional, defaults to agent-based ID)
+     * @param appName Application name (optional, defaults to agent-based 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;
+    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
+     * Configure with an in-memory session with custom IDs
+     * Note: In-memory sessions are created automatically by default, use this only if you need custom appName/userId
+     * @param appName Application name (optional, defaults to agent-based name)
+     * @param userId User identifier (optional, defaults to agent-based ID)
      * @returns This builder instance for chaining
      */
-    withQuickSession(appName: string, userId: string): this;
+    withQuickSession(appName?: string, userId?: string): this;
     /**
      * Build the agent and optionally create runner and session
      * @returns Built agent with optional runner and session
@@ -4003,15 +3948,32 @@ declare class AgentBuilder {
     build(): Promise<BuiltAgent>;
     /**
      * Quick execution helper - build and run a message
-     * @param message Message to send to the agent
+     * @param message Message to send to the agent (string or full message object)
      * @returns Agent response
      */
-    ask(message: string): Promise<string>;
+    ask(message: string | FullMessage): Promise<string>;
     /**
      * Create the appropriate agent type based on configuration
      * @returns Created agent instance
      */
     private createAgent;
+    /**
+     * Generate default user ID based on agent name and id
+     * @returns Generated user ID
+     */
+    private generateDefaultUserId;
+    /**
+     * Generate default app name based on agent name
+     * @returns Generated app name
+     */
+    private generateDefaultAppName;
+    /**
+     * Create enhanced runner with simplified API
+     * @param baseRunner The base runner instance
+     * @param session The session instance
+     * @returns Enhanced runner with simplified API
+     */
+    private createEnhancedRunner;
 }
 
 type index$4_AfterAgentCallback = AfterAgentCallback;
@@ -4025,6 +3987,8 @@ 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_EnhancedRunner = EnhancedRunner;
+type index$4_FullMessage = FullMessage;
 type index$4_InstructionProvider = InstructionProvider;
 type index$4_InvocationContext = InvocationContext;
 declare const index$4_InvocationContext: typeof InvocationContext;
@@ -4040,6 +4004,7 @@ declare const index$4_LlmCallsLimitExceededError: typeof LlmCallsLimitExceededEr
 type index$4_LoopAgent = LoopAgent;
 declare const index$4_LoopAgent: typeof LoopAgent;
 type index$4_LoopAgentConfig = LoopAgentConfig;
+type index$4_MessagePart = MessagePart;
 type index$4_ParallelAgent = ParallelAgent;
 declare const index$4_ParallelAgent: typeof ParallelAgent;
 type index$4_ParallelAgentConfig = ParallelAgentConfig;
@@ -4055,9 +4020,11 @@ 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_createBranchContextForSubAgent: typeof createBranchContextForSubAgent;
+declare const index$4_mergeAgentRun: typeof mergeAgentRun;
 declare const index$4_newInvocationContextId: typeof newInvocationContextId;
 declare namespace index$4 {
-  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 };
+  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_EnhancedRunner as EnhancedRunner, type index$4_FullMessage as FullMessage, 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, type index$4_MessagePart as MessagePart, 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_createBranchContextForSubAgent as createBranchContextForSubAgent, index$4_mergeAgentRun as mergeAgentRun, index$4_newInvocationContextId as newInvocationContextId };
 }
 
 /**
@@ -4841,6 +4808,101 @@ declare class PlanReActPlanner extends BasePlanner {
     private _buildNlPlannerInstruction;
 }
 
+/**
+ * Find function call event if last event is function response.
+ */
+declare function _findFunctionCallEventIfLastEventIsFunctionResponse(session: Session): Event | null;
+/**
+ * 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<T extends BaseAgent = BaseAgent> {
+    /**
+     * The app name of the runner.
+     */
+    appName: string;
+    /**
+     * The root agent to run.
+     */
+    agent: T;
+    /**
+     * The artifact service for the runner.
+     */
+    artifactService?: BaseArtifactService;
+    /**
+     * The session service for the runner.
+     */
+    sessionService: BaseSessionService;
+    /**
+     * The memory service for the runner.
+     */
+    memoryService?: BaseMemoryService;
+    protected logger: Logger;
+    /**
+     * Initializes the Runner.
+     */
+    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
+        appName: string;
+        agent: T;
+        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<T extends BaseAgent = BaseAgent> extends Runner<T> {
+    /**
+     * Deprecated. Please don't use. The in-memory session service for the runner.
+     */
+    private _inMemorySessionService;
+    /**
+     * Initializes the InMemoryRunner.
+     */
+    constructor(agent: T, { appName }?: {
+        appName?: string;
+    });
+}
+
 interface TelemetryConfig {
     appName: string;
     appVersion?: string;
@@ -4913,4 +4975,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, 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 };
+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, type EnhancedRunner, Event, EventActions, index$1 as Events, ExitLoopTool, type File, FileOperationsTool, index as Flows, type FullMessage, 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, McpCoinGecko, 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, type MessagePart, 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, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createBranchContextForSubAgent, 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, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };