@iqai/adk 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1633,6 +1633,12 @@ declare function McpOdos(config?: McpServerConfig): McpToolset;
1633
1633
  * Required env vars: TELEGRAM_BOT_TOKEN
1634
1634
  */
1635
1635
  declare function McpTelegram(config?: McpServerConfig): McpToolset;
1636
+ /**
1637
+ * MCP CoinGecko - Access cryptocurrency market data and analytics
1638
+ *
1639
+ * Optional env vars: COINGECKO_PRO_API_KEY, COINGECKO_DEMO_API_KEY, COINGECKO_ENVIRONMENT
1640
+ */
1641
+ declare function McpCoinGecko(config?: McpServerConfig): McpToolset;
1636
1642
  /**
1637
1643
  * Popular third-party MCP servers
1638
1644
  * These can be added as we expand support for community MCP servers
@@ -1750,6 +1756,7 @@ declare const index$6_LoadMemoryTool: typeof LoadMemoryTool;
1750
1756
  declare const index$6_McpAbi: typeof McpAbi;
1751
1757
  declare const index$6_McpAtp: typeof McpAtp;
1752
1758
  declare const index$6_McpBamm: typeof McpBamm;
1759
+ declare const index$6_McpCoinGecko: typeof McpCoinGecko;
1753
1760
  type index$6_McpConfig = McpConfig;
1754
1761
  type index$6_McpError = McpError;
1755
1762
  declare const index$6_McpError: typeof McpError;
@@ -1789,7 +1796,7 @@ declare const index$6_jsonSchemaToDeclaration: typeof jsonSchemaToDeclaration;
1789
1796
  declare const index$6_mcpSchemaToParameters: typeof mcpSchemaToParameters;
1790
1797
  declare const index$6_normalizeJsonSchema: typeof normalizeJsonSchema;
1791
1798
  declare namespace index$6 {
1792
- 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 };
1799
+ 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 };
1793
1800
  }
1794
1801
 
1795
1802
  /**
@@ -3531,6 +3538,17 @@ declare class SequentialAgent extends BaseAgent {
3531
3538
  protected runLiveImpl(ctx: InvocationContext): AsyncGenerator<Event, void, unknown>;
3532
3539
  }
3533
3540
 
3541
+ /**
3542
+ * Create isolated branch for every sub-agent.
3543
+ */
3544
+ declare function createBranchContextForSubAgent(agent: BaseAgent, subAgent: BaseAgent, invocationContext: InvocationContext): InvocationContext;
3545
+ /**
3546
+ * Merges the agent run event generator.
3547
+ *
3548
+ * This implementation guarantees for each agent, it won't move on until the
3549
+ * generated event is processed by upstream runner.
3550
+ */
3551
+ declare function mergeAgentRun(agentRuns: AsyncGenerator<Event, void, unknown>[]): AsyncGenerator<Event, void, unknown>;
3534
3552
  /**
3535
3553
  * Configuration for ParallelAgent
3536
3554
  */
@@ -3742,97 +3760,6 @@ declare class LangGraphAgent extends BaseAgent {
3742
3760
  setMaxSteps(maxSteps: number): void;
3743
3761
  }
3744
3762
 
3745
- /**
3746
- * The Runner class is used to run agents.
3747
- * It manages the execution of an agent within a session, handling message
3748
- * processing, event generation, and interaction with various services like
3749
- * artifact storage, session management, and memory.
3750
- */
3751
- declare class Runner<T extends BaseAgent = BaseAgent> {
3752
- /**
3753
- * The app name of the runner.
3754
- */
3755
- appName: string;
3756
- /**
3757
- * The root agent to run.
3758
- */
3759
- agent: T;
3760
- /**
3761
- * The artifact service for the runner.
3762
- */
3763
- artifactService?: BaseArtifactService;
3764
- /**
3765
- * The session service for the runner.
3766
- */
3767
- sessionService: BaseSessionService;
3768
- /**
3769
- * The memory service for the runner.
3770
- */
3771
- memoryService?: BaseMemoryService;
3772
- protected logger: Logger;
3773
- /**
3774
- * Initializes the Runner.
3775
- */
3776
- constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
3777
- appName: string;
3778
- agent: T;
3779
- artifactService?: BaseArtifactService;
3780
- sessionService: BaseSessionService;
3781
- memoryService?: BaseMemoryService;
3782
- });
3783
- /**
3784
- * Runs the agent synchronously.
3785
- * NOTE: This sync interface is only for local testing and convenience purpose.
3786
- * Consider using `runAsync` for production usage.
3787
- */
3788
- run({ userId, sessionId, newMessage, runConfig, }: {
3789
- userId: string;
3790
- sessionId: string;
3791
- newMessage: Content$1;
3792
- runConfig?: RunConfig;
3793
- }): Generator<Event, void, unknown>;
3794
- /**
3795
- * Main entry method to run the agent in this runner.
3796
- */
3797
- runAsync({ userId, sessionId, newMessage, runConfig, }: {
3798
- userId: string;
3799
- sessionId: string;
3800
- newMessage: Content$1;
3801
- runConfig?: RunConfig;
3802
- }): AsyncGenerator<Event, void, unknown>;
3803
- /**
3804
- * Appends a new message to the session.
3805
- */
3806
- private _appendNewMessageToSession;
3807
- /**
3808
- * Finds the agent to run to continue the session.
3809
- */
3810
- private _findAgentToRun;
3811
- /**
3812
- * Whether the agent to run can transfer to any other agent in the agent tree.
3813
- */
3814
- private _isTransferableAcrossAgentTree;
3815
- /**
3816
- * Creates a new invocation context.
3817
- */
3818
- private _newInvocationContext;
3819
- }
3820
- /**
3821
- * An in-memory Runner for testing and development.
3822
- */
3823
- declare class InMemoryRunner<T extends BaseAgent = BaseAgent> extends Runner<T> {
3824
- /**
3825
- * Deprecated. Please don't use. The in-memory session service for the runner.
3826
- */
3827
- private _inMemorySessionService;
3828
- /**
3829
- * Initializes the InMemoryRunner.
3830
- */
3831
- constructor(agent: T, { appName }?: {
3832
- appName?: string;
3833
- });
3834
- }
3835
-
3836
3763
  /**
3837
3764
  * Configuration options for the AgentBuilder
3838
3765
  */
@@ -3858,12 +3785,35 @@ interface SessionConfig {
3858
3785
  memoryService?: BaseMemoryService;
3859
3786
  artifactService?: BaseArtifactService;
3860
3787
  }
3788
+ /**
3789
+ * Message part interface for flexible message input
3790
+ */
3791
+ interface MessagePart extends Part {
3792
+ image?: string;
3793
+ }
3794
+ /**
3795
+ * Full message interface for advanced usage
3796
+ */
3797
+ interface FullMessage extends Content$1 {
3798
+ parts?: MessagePart[];
3799
+ }
3800
+ /**
3801
+ * Enhanced runner interface with simplified API
3802
+ */
3803
+ interface EnhancedRunner {
3804
+ ask(message: string | FullMessage): Promise<string>;
3805
+ runAsync(params: {
3806
+ userId: string;
3807
+ sessionId: string;
3808
+ newMessage: FullMessage;
3809
+ }): AsyncIterable<Event>;
3810
+ }
3861
3811
  /**
3862
3812
  * Built agent result containing the agent and optional runner/session
3863
3813
  */
3864
3814
  interface BuiltAgent {
3865
3815
  agent: BaseAgent;
3866
- runner?: Runner;
3816
+ runner?: EnhancedRunner;
3867
3817
  session?: Session;
3868
3818
  }
3869
3819
  /**
@@ -3871,36 +3821,30 @@ interface BuiltAgent {
3871
3821
  */
3872
3822
  type AgentType = "llm" | "sequential" | "parallel" | "loop" | "langgraph";
3873
3823
  /**
3874
- * AgentBuilder - A fluent interface for building agents with optional session management
3824
+ * AgentBuilder - A fluent interface for creating AI agents with automatic session management
3875
3825
  *
3876
- * This builder provides a convenient way to create agents, manage sessions, and
3877
- * automatically set up runners without the boilerplate code. It supports all
3878
- * agent types and maintains backward compatibility with existing interfaces.
3826
+ * Provides a simple, chainable API for building different types of agents (LLM, Sequential,
3827
+ * Parallel, Loop, LangGraph) with tools, custom instructions, and multi-agent workflows.
3828
+ * Sessions are automatically created using in-memory storage by default.
3879
3829
  *
3880
- * Examples:
3830
+ * @example
3881
3831
  * ```typescript
3882
- * // Simplest possible usage
3883
- * const response = await AgentBuilder
3884
- * .withModel("gemini-2.5-flash")
3885
- * .ask("What is the capital of Australia?");
3832
+ * // Simple usage
3833
+ * const response = await AgentBuilder.withModel("gemini-2.5-flash").ask("Hello");
3886
3834
  *
3887
- * // Simple agent with name
3888
- * const { agent } = AgentBuilder
3889
- * .create("my-agent")
3835
+ * // With tools and instructions
3836
+ * const { runner } = await AgentBuilder
3837
+ * .create("research-agent")
3890
3838
  * .withModel("gemini-2.5-flash")
3891
- * .withInstruction("You are helpful")
3839
+ * .withTools(new GoogleSearch())
3840
+ * .withInstruction("You are a research assistant")
3892
3841
  * .build();
3893
3842
  *
3894
- * // Agent with session and runner
3895
- * const { agent, runner, session } = await AgentBuilder
3896
- * .create("my-agent")
3897
- * .withModel("gemini-2.5-flash")
3898
- * .withSession(sessionService, "user123", "myApp")
3843
+ * // Multi-agent workflow
3844
+ * const { runner } = await AgentBuilder
3845
+ * .create("workflow")
3846
+ * .asSequential([agent1, agent2])
3899
3847
  * .build();
3900
- *
3901
- * // Using an AI SDK provider directly
3902
- * import { google } from "@ai-sdk/google";
3903
- * const response = await AgentBuilder.withModel(google()).ask("Hi");
3904
3848
  * ```
3905
3849
  */
3906
3850
  declare class AgentBuilder {
@@ -3980,22 +3924,23 @@ declare class AgentBuilder {
3980
3924
  */
3981
3925
  asLangGraph(nodes: LangGraphNode[], rootNode: string): this;
3982
3926
  /**
3983
- * Configure session management
3927
+ * Configure session management with optional smart defaults
3984
3928
  * @param service Session service to use
3985
- * @param userId User identifier
3986
- * @param appName Application name
3929
+ * @param userId User identifier (optional, defaults to agent-based ID)
3930
+ * @param appName Application name (optional, defaults to agent-based name)
3987
3931
  * @param memoryService Optional memory service
3988
3932
  * @param artifactService Optional artifact service
3989
3933
  * @returns This builder instance for chaining
3990
3934
  */
3991
- withSession(service: BaseSessionService, userId: string, appName: string, memoryService?: BaseMemoryService, artifactService?: BaseArtifactService): this;
3935
+ withSession(service: BaseSessionService, userId?: string, appName?: string, memoryService?: BaseMemoryService, artifactService?: BaseArtifactService): this;
3992
3936
  /**
3993
- * Configure with an in-memory session (for quick setup)
3994
- * @param appName Application name
3995
- * @param userId User identifier
3937
+ * Configure with an in-memory session with custom IDs
3938
+ * Note: In-memory sessions are created automatically by default, use this only if you need custom appName/userId
3939
+ * @param appName Application name (optional, defaults to agent-based name)
3940
+ * @param userId User identifier (optional, defaults to agent-based ID)
3996
3941
  * @returns This builder instance for chaining
3997
3942
  */
3998
- withQuickSession(appName: string, userId: string): this;
3943
+ withQuickSession(appName?: string, userId?: string): this;
3999
3944
  /**
4000
3945
  * Build the agent and optionally create runner and session
4001
3946
  * @returns Built agent with optional runner and session
@@ -4003,15 +3948,32 @@ declare class AgentBuilder {
4003
3948
  build(): Promise<BuiltAgent>;
4004
3949
  /**
4005
3950
  * Quick execution helper - build and run a message
4006
- * @param message Message to send to the agent
3951
+ * @param message Message to send to the agent (string or full message object)
4007
3952
  * @returns Agent response
4008
3953
  */
4009
- ask(message: string): Promise<string>;
3954
+ ask(message: string | FullMessage): Promise<string>;
4010
3955
  /**
4011
3956
  * Create the appropriate agent type based on configuration
4012
3957
  * @returns Created agent instance
4013
3958
  */
4014
3959
  private createAgent;
3960
+ /**
3961
+ * Generate default user ID based on agent name and id
3962
+ * @returns Generated user ID
3963
+ */
3964
+ private generateDefaultUserId;
3965
+ /**
3966
+ * Generate default app name based on agent name
3967
+ * @returns Generated app name
3968
+ */
3969
+ private generateDefaultAppName;
3970
+ /**
3971
+ * Create enhanced runner with simplified API
3972
+ * @param baseRunner The base runner instance
3973
+ * @param session The session instance
3974
+ * @returns Enhanced runner with simplified API
3975
+ */
3976
+ private createEnhancedRunner;
4015
3977
  }
4016
3978
 
4017
3979
  type index$4_AfterAgentCallback = AfterAgentCallback;
@@ -4025,6 +3987,8 @@ type index$4_BeforeAgentCallback = BeforeAgentCallback;
4025
3987
  type index$4_BuiltAgent = BuiltAgent;
4026
3988
  type index$4_CallbackContext = CallbackContext;
4027
3989
  declare const index$4_CallbackContext: typeof CallbackContext;
3990
+ type index$4_EnhancedRunner = EnhancedRunner;
3991
+ type index$4_FullMessage = FullMessage;
4028
3992
  type index$4_InstructionProvider = InstructionProvider;
4029
3993
  type index$4_InvocationContext = InvocationContext;
4030
3994
  declare const index$4_InvocationContext: typeof InvocationContext;
@@ -4040,6 +4004,7 @@ declare const index$4_LlmCallsLimitExceededError: typeof LlmCallsLimitExceededEr
4040
4004
  type index$4_LoopAgent = LoopAgent;
4041
4005
  declare const index$4_LoopAgent: typeof LoopAgent;
4042
4006
  type index$4_LoopAgentConfig = LoopAgentConfig;
4007
+ type index$4_MessagePart = MessagePart;
4043
4008
  type index$4_ParallelAgent = ParallelAgent;
4044
4009
  declare const index$4_ParallelAgent: typeof ParallelAgent;
4045
4010
  type index$4_ParallelAgentConfig = ParallelAgentConfig;
@@ -4055,9 +4020,11 @@ type index$4_SingleAgentCallback = SingleAgentCallback;
4055
4020
  type index$4_StreamingMode = StreamingMode;
4056
4021
  declare const index$4_StreamingMode: typeof StreamingMode;
4057
4022
  type index$4_ToolUnion = ToolUnion;
4023
+ declare const index$4_createBranchContextForSubAgent: typeof createBranchContextForSubAgent;
4024
+ declare const index$4_mergeAgentRun: typeof mergeAgentRun;
4058
4025
  declare const index$4_newInvocationContextId: typeof newInvocationContextId;
4059
4026
  declare namespace index$4 {
4060
- 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 };
4027
+ 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 };
4061
4028
  }
4062
4029
 
4063
4030
  /**
@@ -4841,6 +4808,101 @@ declare class PlanReActPlanner extends BasePlanner {
4841
4808
  private _buildNlPlannerInstruction;
4842
4809
  }
4843
4810
 
4811
+ /**
4812
+ * Find function call event if last event is function response.
4813
+ */
4814
+ declare function _findFunctionCallEventIfLastEventIsFunctionResponse(session: Session): Event | null;
4815
+ /**
4816
+ * The Runner class is used to run agents.
4817
+ * It manages the execution of an agent within a session, handling message
4818
+ * processing, event generation, and interaction with various services like
4819
+ * artifact storage, session management, and memory.
4820
+ */
4821
+ declare class Runner<T extends BaseAgent = BaseAgent> {
4822
+ /**
4823
+ * The app name of the runner.
4824
+ */
4825
+ appName: string;
4826
+ /**
4827
+ * The root agent to run.
4828
+ */
4829
+ agent: T;
4830
+ /**
4831
+ * The artifact service for the runner.
4832
+ */
4833
+ artifactService?: BaseArtifactService;
4834
+ /**
4835
+ * The session service for the runner.
4836
+ */
4837
+ sessionService: BaseSessionService;
4838
+ /**
4839
+ * The memory service for the runner.
4840
+ */
4841
+ memoryService?: BaseMemoryService;
4842
+ protected logger: Logger;
4843
+ /**
4844
+ * Initializes the Runner.
4845
+ */
4846
+ constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
4847
+ appName: string;
4848
+ agent: T;
4849
+ artifactService?: BaseArtifactService;
4850
+ sessionService: BaseSessionService;
4851
+ memoryService?: BaseMemoryService;
4852
+ });
4853
+ /**
4854
+ * Runs the agent synchronously.
4855
+ * NOTE: This sync interface is only for local testing and convenience purpose.
4856
+ * Consider using `runAsync` for production usage.
4857
+ */
4858
+ run({ userId, sessionId, newMessage, runConfig, }: {
4859
+ userId: string;
4860
+ sessionId: string;
4861
+ newMessage: Content$1;
4862
+ runConfig?: RunConfig;
4863
+ }): Generator<Event, void, unknown>;
4864
+ /**
4865
+ * Main entry method to run the agent in this runner.
4866
+ */
4867
+ runAsync({ userId, sessionId, newMessage, runConfig, }: {
4868
+ userId: string;
4869
+ sessionId: string;
4870
+ newMessage: Content$1;
4871
+ runConfig?: RunConfig;
4872
+ }): AsyncGenerator<Event, void, unknown>;
4873
+ /**
4874
+ * Appends a new message to the session.
4875
+ */
4876
+ private _appendNewMessageToSession;
4877
+ /**
4878
+ * Finds the agent to run to continue the session.
4879
+ */
4880
+ private _findAgentToRun;
4881
+ /**
4882
+ * Whether the agent to run can transfer to any other agent in the agent tree.
4883
+ */
4884
+ private _isTransferableAcrossAgentTree;
4885
+ /**
4886
+ * Creates a new invocation context.
4887
+ */
4888
+ private _newInvocationContext;
4889
+ }
4890
+ /**
4891
+ * An in-memory Runner for testing and development.
4892
+ */
4893
+ declare class InMemoryRunner<T extends BaseAgent = BaseAgent> extends Runner<T> {
4894
+ /**
4895
+ * Deprecated. Please don't use. The in-memory session service for the runner.
4896
+ */
4897
+ private _inMemorySessionService;
4898
+ /**
4899
+ * Initializes the InMemoryRunner.
4900
+ */
4901
+ constructor(agent: T, { appName }?: {
4902
+ appName?: string;
4903
+ });
4904
+ }
4905
+
4844
4906
  interface TelemetryConfig {
4845
4907
  appName: string;
4846
4908
  appVersion?: string;
@@ -4913,4 +4975,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
4913
4975
 
4914
4976
  declare const VERSION = "0.1.0";
4915
4977
 
4916
- 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 };
4978
+ 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 };