@iqai/adk 0.8.0 → 0.8.5

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @iqai/adk
 
+## 0.8.5
+
+### Patch Changes
+
+- d25219b: fix: deduplicate concurrent database session initialization
+- 2336621: fix: share endInvocation flag by reference between parent/child contexts
+
+  endInvocation was a primitive boolean copied by value when creating child
+  invocation contexts, so sub-agents setting it to true never propagated to
+  the parent. Wrapped in a shared InvocationFlags object passed by reference.
+
+- b4b6887: fix: standardize evaluation timestamps to milliseconds
+- 751b3e9: fix: handle all Part types in GcsArtifactService
+- 800239b: fix: use correct invocationId when merging parallel function responses
+- d35873a: fix: guard streaming tool call JSON.parse to prevent generator crashes
+- c6ff7ef: fix: vector storage delete/count bypass stale in-memory cache
+
+  Filter-based `delete()` and `count()` in `VectorStorageProvider` now delegate to the underlying vector store instead of relying on an in-memory cache that is empty after process restart.
+
+- fbb3c30: fix: replace random score stubs with real Vertex AI evaluation API calls
+- 7c9ddf6: fix: resolve race condition in LocalEvalService constructor
+
+## 0.8.4
+
+### Patch Changes
+
+- 621aa3f: fix: align Anthropic non-streaming path to use camelCase for function call properties
+
+## 0.8.3
+
+### Patch Changes
+
+- 0c189c7: security: fix SSRF, API key exposure, pattern bypass, symlink escapes
+
+## 0.8.2
+
+### Patch Changes
+
+- c1093ed: fix: clear LangGraphAgent results on each invocation
+- deb7ec5: fix: assign decodedData when input is string in getEncodedFileContent
+
+## 0.8.1
+
+### Patch Changes
+
+- 58eeac4: fix: handle null `answer` from Tavily API in WebSearchTool
+
+  Tavily returns `"answer": null` by default when `include_answer` is not set, but the Zod schema typed `answer` as `z.string().optional()` which rejects `null`. Changed to `z.string().nullish()` to accept both `null` and `undefined`.
+
 ## 0.8.0
 
 ### Minor Changes

package/README.md

@@ -26,7 +26,7 @@
 
 ## 🌟 Overview
 
-`@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.
+`@iqai/adk` is the core library for ADK-TS — the TypeScript-native AI agent framework. It provides the foundational tools and abstractions to build sophisticated AI agents in TypeScript, with seamless integration across multiple Large Language Models (LLMs), advanced tool usage, and persistent memory capabilities.
 
 ## 🚀 Key Features
 
@@ -169,7 +169,7 @@ async function createWorkflowAgent() {
 - **Automatic Management**: Handles session and runner creation automatically
 - **Quick Execution**: Built-in `ask()` method for immediate responses
 - **Flexible**: Supports all agent types (LLM, Sequential, Parallel, Loop, LangGraph)
-- **Backward Compatible**: Works alongside existing ADK patterns
+- **Backward Compatible**: Works alongside existing ADK-TS patterns
 
 ## 🛠️ Using Tools with an Agent
 

package/dist/constants.d.mts

@@ -1,6 +1,6 @@
 /**
  * Semantic Conventions and Constants
- * OpenTelemetry semantic conventions for ADK telemetry
+ * OpenTelemetry semantic conventions for ADK-TS telemetry
  */
 /**
  * Standard OpenTelemetry GenAI semantic conventions
@@ -65,7 +65,7 @@ declare const SEMCONV: {
 };
 /**
  * ADK-specific attribute namespace
- * Custom attributes for IQAI ADK framework
+ * Custom attributes for IQAI ADK-TS framework
  */
 declare const ADK_ATTRS: {
     readonly SYSTEM_NAME: "adk.system.name";

package/dist/constants.d.ts

@@ -1,6 +1,6 @@
 /**
  * Semantic Conventions and Constants
- * OpenTelemetry semantic conventions for ADK telemetry
+ * OpenTelemetry semantic conventions for ADK-TS telemetry
  */
 /**
  * Standard OpenTelemetry GenAI semantic conventions
@@ -65,7 +65,7 @@ declare const SEMCONV: {
 };
 /**
  * ADK-specific attribute namespace
- * Custom attributes for IQAI ADK framework
+ * Custom attributes for IQAI ADK-TS framework
  */
 declare const ADK_ATTRS: {
     readonly SYSTEM_NAME: "adk.system.name";

package/dist/constants.js

@@ -198,7 +198,7 @@ var OPERATIONS = {
   EXECUTE_TOOL: "execute_tool",
   // ============================================
   // ADK-specific operations (framework extensions)
-  // These are non-standard but useful for the ADK framework
+  // These are non-standard but useful for the ADK-TS framework
   // ============================================
   TRANSFER_AGENT: "transfer_agent",
   // Multi-agent transfer

package/dist/constants.mjs

@@ -168,7 +168,7 @@ var OPERATIONS = {
   EXECUTE_TOOL: "execute_tool",
   // ============================================
   // ADK-specific operations (framework extensions)
-  // These are non-standard but useful for the ADK framework
+  // These are non-standard but useful for the ADK-TS framework
   // ============================================
   TRANSFER_AGENT: "transfer_agent",
   // Multi-agent transfer

package/dist/index.d.mts

@@ -1242,6 +1242,10 @@ declare class VectorStorageProvider implements MemoryStorageProvider {
      * Build filter object for vector store query.
      */
     private buildFilter;
+    /**
+     * Build filter object for vector store delete/count operations.
+     */
+    private buildDeleteFilter;
     /**
      * Check if a record matches the given filter.
      */
@@ -2196,7 +2200,7 @@ declare class ReadonlyContext {
  */
 declare class CallbackContext extends ReadonlyContext {
     /**
-     * TODO: make this public for Agent Development Kit, but private for users.
+     * TODO: make this public for ADK-TS, but private for users.
      */
     readonly _eventActions: EventActions;
     private readonly _state;
@@ -2244,7 +2248,7 @@ declare class ToolContext extends CallbackContext {
     /**
      * The function call id of the current tool call. This id was
      * returned in the function call event from LLM to identify a function call.
-     * If LLM didn't return this id, ADK will assign one to it. This id is used
+     * If LLM didn't return this id, ADK-TS will assign one to it. This id is used
      * to map function call response to the original function call.
      */
     functionCallId?: string;
@@ -2705,7 +2709,7 @@ type BeforeAgentCallback = SingleAgentCallback | SingleAgentCallback[];
  */
 type AfterAgentCallback = SingleAgentCallback | SingleAgentCallback[];
 /**
- * Base class for all agents in Agent Development Kit.
+ * Base class for all agents in ADK-TS.
  */
 declare abstract class BaseAgent {
     /**
@@ -2824,12 +2828,12 @@ declare abstract class BaseAgent {
     private createInvocationContext;
     /**
      * The resolved beforeAgentCallback field as a list of SingleAgentCallback.
-     * This method is only for use by Agent Development Kit.
+     * This method is only for use by ADK-TS.
      */
     get canonicalBeforeAgentCallbacks(): SingleAgentCallback[];
     /**
      * The resolved afterAgentCallback field as a list of SingleAgentCallback.
-     * This method is only for use by Agent Development Kit.
+     * This method is only for use by ADK-TS.
      */
     get canonicalAfterAgentCallbacks(): SingleAgentCallback[];
     /**
@@ -3132,22 +3136,22 @@ declare class LlmAgent<T extends BaseLlm = BaseLlm> extends BaseAgent {
     constructor(config: LlmAgentConfig<T>);
     /**
      * The resolved model field as BaseLLM
-     * This method is only for use by Agent Development Kit
+     * This method is only for use by ADK-TS
      */
     get canonicalModel(): BaseLlm;
     /**
      * The resolved instruction field to construct instruction for this agent
-     * This method is only for use by Agent Development Kit
+     * This method is only for use by ADK-TS
      */
     canonicalInstruction(ctx: ReadonlyContext): Promise<[string, boolean]>;
     /**
      * The resolved global_instruction field to construct global instruction
-     * This method is only for use by Agent Development Kit
+     * This method is only for use by ADK-TS
      */
     canonicalGlobalInstruction(ctx: ReadonlyContext): Promise<[string, boolean]>;
     /**
      * The resolved tools field as a list of BaseTool based on the context
-     * This method is only for use by Agent Development Kit
+     * This method is only for use by ADK-TS
      */
     canonicalTools(_ctx?: ReadonlyContext): Promise<BaseTool[]>;
     /**
@@ -3318,7 +3322,8 @@ declare class FileOperationsTool extends BaseTool {
      */
     private resolvePath;
     /**
-     * Validate that a path is within the base path for security
+     * Validate that a path is within the base path for security.
+     * Resolves symlinks to prevent symlink escape attacks.
      */
     private validatePath;
     /**
@@ -3915,7 +3920,7 @@ declare const tavilySearchResponseSchema: z$1.ZodObject<{
         favicon: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
         score: z$1.ZodOptional<z$1.ZodNumber>;
     }, z$1.core.$strip>>;
-    answer: z$1.ZodOptional<z$1.ZodString>;
+    answer: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
     images: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
         url: z$1.ZodString;
         description: z$1.ZodOptional<z$1.ZodString>;
@@ -4059,7 +4064,7 @@ type McpConfig = {
     debug?: boolean;
     /**
      * Sampling handler for processing MCP sampling requests.
-     * This allows MCP servers to request LLM completions through your ADK agent.
+     * This allows MCP servers to request LLM completions through your ADK-TS agent.
      */
     samplingHandler?: SamplingHandler;
 };
@@ -4140,7 +4145,7 @@ declare class McpClientService {
     isConnected(): boolean;
     private setupSamplingHandler;
     /**
-     * Set a new ADK sampling handler
+     * Set a new ADK-TS sampling handler
      */
     setSamplingHandler(handler: SamplingHandler): void;
     /**
@@ -4157,12 +4162,12 @@ type ConvertMcpToolTooBaseToolParams = {
 declare function convertMcpToolToBaseTool(params: ConvertMcpToolTooBaseToolParams): Promise<BaseTool>;
 
 /**
- * Converts an ADK-style BaseTool to an MCP tool format
+ * Converts an ADK-TS-style BaseTool to an MCP tool format
  * Similar to Python's adk_to_mcp_tool_type function
  */
 declare function adkToMcpToolType(tool: BaseTool): Tool;
 /**
- * Converts MCP JSONSchema to ADK's FunctionDeclaration format
+ * Converts MCP JSONSchema to ADK-TS FunctionDeclaration format
  * Similar to handling in McpToolAdapter's getDeclaration
  */
 declare function jsonSchemaToDeclaration(name: string, description: string, schema: Record<string, any> | undefined): FunctionDeclaration;
@@ -4178,7 +4183,7 @@ declare function mcpSchemaToParameters(mcpTool: Tool): Schema;
 
 /**
  * MCP Sampling Handler class that handles message format conversion
- * between MCP format and ADK format
+ * between MCP format and ADK-TS format
  */
 declare class McpSamplingHandler {
     protected logger: Logger;
@@ -4189,23 +4194,23 @@ declare class McpSamplingHandler {
      */
     handleSamplingRequest(request: McpSamplingRequest): Promise<McpSamplingResponse>;
     /**
-     * Convert MCP messages to ADK Content format
+     * Convert MCP messages to ADK-TS Content format
      */
     private convertMcpMessagesToADK;
     /**
-     * Convert a single MCP message to ADK Content format
+     * Convert a single MCP message to ADK-TS Content format
      */
     private convertSingleMcpMessageToADK;
     /**
-     * Convert MCP message content to ADK parts format
+     * Convert MCP message content to ADK-TS parts format
      */
     private convertMcpContentToADKParts;
     /**
-     * Convert ADK response to MCP response format
+     * Convert ADK-TS response to MCP response format
      */
     private convertADKResponseToMcp;
     /**
-     * Update the ADK handler
+     * Update the ADK-TS handler
      */
     updateHandler(handler: SamplingHandler): void;
 }
@@ -4213,7 +4218,7 @@ declare class McpSamplingHandler {
  * Helper function to create a sampling handler with proper TypeScript types.
  *
  * @param handler - Function that handles sampling requests
- * @returns Properly typed ADK sampling handler
+ * @returns Properly typed ADK-TS sampling handler
  *
  * @example
  * ```typescript
@@ -4590,15 +4595,16 @@ declare class McpToolset {
      * Similar to Python's _is_selected method.
      */
     private isSelected;
+    private isCacheEnabled;
     /**
      * Initializes the client service and establishes a connection.
      */
     initialize(): Promise<McpClientService>;
     /**
      * Set a sampling handler for this MCP toolset.
-     * This allows MCP servers to request LLM completions through your ADK agent.
+     * This allows MCP servers to request LLM completions through your ADK-TS agent.
      *
-     * @param handler - ADK sampling handler that receives ADK-formatted messages
+     * @param handler - ADK-TS sampling handler that receives ADK-TS-formatted messages
      */
     setSamplingHandler(handler: SamplingHandler): void;
     /**
@@ -4611,7 +4617,7 @@ declare class McpToolset {
      */
     getTools(context?: ToolContext): Promise<BaseTool[]>;
     /**
-     * Converts ADK tools to MCP tool format for bidirectional support
+     * Converts ADK-TS tools to MCP tool format for bidirectional support
      */
     convertADKToolsToMCP(tools: BaseTool[]): any[];
     /**
@@ -5179,6 +5185,13 @@ type SpanCounters = {
     tool: number;
     agent: number;
 };
+/**
+ * Shared mutable flags for an invocation, passed by reference so that
+ * child contexts and parent contexts stay in sync.
+ */
+type InvocationFlags = {
+    endInvocation: boolean;
+};
 /**
  * Transfer context for multi-agent workflows
  * Tracks the chain of agent transfers for telemetry
@@ -5290,12 +5303,17 @@ declare class InvocationContext {
      * The current session of this invocation context. Readonly.
      */
     readonly session: Session;
+    /**
+     * Shared flags container so that child/parent contexts stay in sync.
+     */
+    private readonly _invocationFlags;
     /**
      * Whether to end this invocation.
      *
      * Set to True in callbacks or tools to terminate this invocation.
      */
-    endInvocation: boolean;
+    get endInvocation(): boolean;
+    set endInvocation(value: boolean);
     /**
      * The queue to receive live requests.
      */
@@ -5337,6 +5355,7 @@ declare class InvocationContext {
         userContent?: Content;
         session: Session;
         endInvocation?: boolean;
+        invocationFlags?: InvocationFlags;
         liveRequestQueue?: LiveRequestQueue;
         activeStreamingTools?: Record<string, ActiveStreamingTool>;
         transcriptionCache?: TranscriptionEntry[];
@@ -5375,6 +5394,10 @@ declare class InvocationContext {
      * Exposes shared span counters for child contexts.
      */
     getSpanCounters(): SpanCounters;
+    /**
+     * Exposes shared invocation flags for child contexts.
+     */
+    getInvocationFlags(): InvocationFlags;
     /**
      * Creates a child invocation context for a sub-agent
      */
@@ -5442,7 +5465,7 @@ declare class EnhancedAuthConfig {
     rawAuthCredential?: AuthCredential;
     /**
      * Exchanged auth credential after processing
-     * Filled by ADK and client working together
+     * Filled by ADK-TS and client working together
      */
     exchangedAuthCredential?: AuthCredential;
     /**
@@ -5676,7 +5699,7 @@ declare class OAuth2Credential extends AuthCredential {
 
 /**
  * AI SDK integration that accepts a pre-configured LanguageModel.
- * Enables ADK to work with any provider supported by Vercel's AI SDK.
+ * Enables ADK-TS to work with any provider supported by Vercel's AI SDK.
  */
 declare class AiSdkLlm extends BaseLlm {
     private modelInstance;
@@ -5735,7 +5758,7 @@ declare class AiSdkLlm extends BaseLlm {
      */
     private handleNonStreamingResponse;
     /**
-     * Convert ADK LlmRequest to AI SDK CoreMessage format
+     * Convert ADK-TS LlmRequest to AI SDK CoreMessage format
      */
     private convertToAiSdkMessages;
     /**
@@ -5743,19 +5766,19 @@ declare class AiSdkLlm extends BaseLlm {
      */
     private transformSchemaForAiSdk;
     /**
-     * Convert ADK tools to AI SDK tools format
+     * Convert ADK-TS tools to AI SDK tools format
      */
     private convertToAiSdkTools;
     /**
-     * Convert ADK Content to AI SDK CoreMessage
+     * Convert ADK-TS Content to AI SDK CoreMessage
      */
     private contentToAiSdkMessage;
     /**
-     * Map ADK role to AI SDK role
+     * Map ADK-TS role to AI SDK role
      */
     private mapRole;
     /**
-     * Map AI SDK finish reason to ADK finish reason
+     * Map AI SDK finish reason to ADK-TS finish reason
      */
     private mapFinishReason;
 }
@@ -5793,31 +5816,31 @@ declare class AnthropicLlm extends BaseLlm {
     private logCachePerformance;
     connect(_llmRequest: LlmRequest): BaseLLMConnection;
     /**
-     * Convert Anthropic Message to ADK LlmResponse
+     * Convert Anthropic Message to ADK-TS LlmResponse
      */
     private anthropicMessageToLlmResponse;
     /**
-     * Convert ADK Content to Anthropic MessageParam
+     * Convert ADK-TS Content to Anthropic MessageParam
      */
     private contentToAnthropicMessage;
     /**
-     * Convert ADK Part to Anthropic content block
+     * Convert ADK-TS Part to Anthropic content block
      */
     private partToAnthropicBlock;
     /**
-     * Convert Anthropic content block to ADK Part
+     * Convert Anthropic content block to ADK-TS Part
      */
     private anthropicBlockToPart;
     /**
-     * Convert ADK function declaration to Anthropic tool param
+     * Convert ADK-TS function declaration to Anthropic tool param
      */
     private functionDeclarationToAnthropicTool;
     /**
-     * Convert ADK role to Anthropic role format
+     * Convert ADK-TS role to Anthropic role format
      */
     private toAnthropicRole;
     /**
-     * Convert Anthropic stop reason to ADK finish reason
+     * Convert Anthropic stop reason to ADK-TS finish reason
      */
     private toAdkFinishReason;
     /**
@@ -6008,15 +6031,15 @@ declare class OpenAiLlm extends BaseLlm {
      */
     private createChunkResponse;
     /**
-     * Convert OpenAI message to ADK LlmResponse
+     * Convert OpenAI message to ADK-TS LlmResponse
      */
     private openAiMessageToLlmResponse;
     /**
-     * Convert ADK Content to OpenAI ChatCompletionMessage
+     * Convert ADK-TS Content to OpenAI ChatCompletionMessage
      */
     private contentToOpenAiMessage;
     /**
-     * Convert ADK Part to OpenAI message content
+     * Convert ADK-TS Part to OpenAI message content
      */
     private partToOpenAiContent;
     /**
@@ -6024,15 +6047,15 @@ declare class OpenAiLlm extends BaseLlm {
      */
     private transformSchemaForOpenAi;
     /**
-     * Convert ADK function declaration to OpenAI tool
+     * Convert ADK-TS function declaration to OpenAI tool
      */
     private functionDeclarationToOpenAiTool;
     /**
-     * Convert ADK role to OpenAI role format
+     * Convert ADK-TS role to OpenAI role format
      */
     private toOpenAiRole;
     /**
-     * Convert OpenAI finish reason to ADK finish reason
+     * Convert OpenAI finish reason to ADK-TS finish reason
      */
     private toAdkFinishReason;
     /**
@@ -6906,6 +6929,7 @@ type index$7_FullMessage = FullMessage;
 type index$7_InstructionProvider = InstructionProvider;
 type index$7_InvocationContext = InvocationContext;
 declare const index$7_InvocationContext: typeof InvocationContext;
+type index$7_InvocationFlags = InvocationFlags;
 type index$7_LangGraphAgent = LangGraphAgent;
 declare const index$7_LangGraphAgent: typeof LangGraphAgent;
 type index$7_LangGraphAgentConfig = LangGraphAgentConfig;
@@ -6947,7 +6971,7 @@ declare const index$7_createBranchContextForSubAgent: typeof createBranchContext
 declare const index$7_mergeAgentRun: typeof mergeAgentRun;
 declare const index$7_newInvocationContextId: typeof newInvocationContextId;
 declare namespace index$7 {
-  export { type index$7_AfterAgentCallback as AfterAgentCallback, type index$7_AfterModelCallback as AfterModelCallback, type index$7_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$7_AgentBuilder as AgentBuilder, type index$7_AgentBuilderConfig as AgentBuilderConfig, type index$7_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$7_AgentType as AgentType, index$7_BaseAgent as BaseAgent, type index$7_BeforeAgentCallback as BeforeAgentCallback, type index$7_BeforeModelCallback as BeforeModelCallback, type index$7_BeforeToolCallback as BeforeToolCallback, type index$7_BuiltAgent as BuiltAgent, index$7_CallbackContext as CallbackContext, index$7_ContextCacheConfig as ContextCacheConfig, type index$7_ContextCacheConfigProps as ContextCacheConfigProps, type index$7_EnhancedRunner as EnhancedRunner, type index$7_FullMessage as FullMessage, type index$7_InstructionProvider as InstructionProvider, index$7_InvocationContext as InvocationContext, index$7_LangGraphAgent as LangGraphAgent, type index$7_LangGraphAgentConfig as LangGraphAgentConfig, type index$7_LangGraphNode as LangGraphNode, index$7_LlmAgent as LlmAgent, type index$7_LlmAgentConfig as LlmAgentConfig, index$7_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$7_LoopAgent as LoopAgent, type index$7_LoopAgentConfig as LoopAgentConfig, type index$7_MessagePart as MessagePart, type index$7_MultiAgentResponse as MultiAgentResponse, index$7_ParallelAgent as ParallelAgent, type index$7_ParallelAgentConfig as ParallelAgentConfig, index$7_ReadonlyContext as ReadonlyContext, index$7_RunConfig as RunConfig, type index$7_RunnerAskReturn as RunnerAskReturn, index$7_SequentialAgent as SequentialAgent, type index$7_SequentialAgentConfig as SequentialAgentConfig, type index$7_SessionOptions as SessionOptions, type index$7_SingleAfterModelCallback as SingleAfterModelCallback, type index$7_SingleAfterToolCallback as SingleAfterToolCallback, type index$7_SingleAgentCallback as SingleAgentCallback, type index$7_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$7_SingleBeforeToolCallback as SingleBeforeToolCallback, type index$7_SpanCounters as SpanCounters, index$7_StreamingMode as StreamingMode, type index$7_ToolUnion as ToolUnion, type index$7_TransferContext as TransferContext, index$7_contextCacheConfigSchema as contextCacheConfigSchema, index$7_createBranchContextForSubAgent as createBranchContextForSubAgent, index$7_mergeAgentRun as mergeAgentRun, index$7_newInvocationContextId as newInvocationContextId };
+  export { type index$7_AfterAgentCallback as AfterAgentCallback, type index$7_AfterModelCallback as AfterModelCallback, type index$7_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$7_AgentBuilder as AgentBuilder, type index$7_AgentBuilderConfig as AgentBuilderConfig, type index$7_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$7_AgentType as AgentType, index$7_BaseAgent as BaseAgent, type index$7_BeforeAgentCallback as BeforeAgentCallback, type index$7_BeforeModelCallback as BeforeModelCallback, type index$7_BeforeToolCallback as BeforeToolCallback, type index$7_BuiltAgent as BuiltAgent, index$7_CallbackContext as CallbackContext, index$7_ContextCacheConfig as ContextCacheConfig, type index$7_ContextCacheConfigProps as ContextCacheConfigProps, type index$7_EnhancedRunner as EnhancedRunner, type index$7_FullMessage as FullMessage, type index$7_InstructionProvider as InstructionProvider, index$7_InvocationContext as InvocationContext, type index$7_InvocationFlags as InvocationFlags, index$7_LangGraphAgent as LangGraphAgent, type index$7_LangGraphAgentConfig as LangGraphAgentConfig, type index$7_LangGraphNode as LangGraphNode, index$7_LlmAgent as LlmAgent, type index$7_LlmAgentConfig as LlmAgentConfig, index$7_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$7_LoopAgent as LoopAgent, type index$7_LoopAgentConfig as LoopAgentConfig, type index$7_MessagePart as MessagePart, type index$7_MultiAgentResponse as MultiAgentResponse, index$7_ParallelAgent as ParallelAgent, type index$7_ParallelAgentConfig as ParallelAgentConfig, index$7_ReadonlyContext as ReadonlyContext, index$7_RunConfig as RunConfig, type index$7_RunnerAskReturn as RunnerAskReturn, index$7_SequentialAgent as SequentialAgent, type index$7_SequentialAgentConfig as SequentialAgentConfig, type index$7_SessionOptions as SessionOptions, type index$7_SingleAfterModelCallback as SingleAfterModelCallback, type index$7_SingleAfterToolCallback as SingleAfterToolCallback, type index$7_SingleAgentCallback as SingleAgentCallback, type index$7_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$7_SingleBeforeToolCallback as SingleBeforeToolCallback, type index$7_SpanCounters as SpanCounters, index$7_StreamingMode as StreamingMode, type index$7_ToolUnion as ToolUnion, type index$7_TransferContext as TransferContext, index$7_contextCacheConfigSchema as contextCacheConfigSchema, index$7_createBranchContextForSubAgent as createBranchContextForSubAgent, index$7_mergeAgentRun as mergeAgentRun, index$7_newInvocationContextId as newInvocationContextId };
 }
 
 interface ParsedArtifactUri {
@@ -7288,7 +7312,9 @@ declare class LocalEvalService extends BaseEvalService {
     private readonly agent;
     private readonly parallelism;
     private runner;
+    private readyPromise;
     constructor(agent: BaseAgent, parallelism?: number);
+    private ensureReady;
     private initializeRunner;
     performInference(request: {
         evalSetId: string;
@@ -7983,7 +8009,7 @@ interface ScheduledJob {
     onEvent?: (jobId: string, event: Event) => void;
 }
 /**
- * AgentScheduler - Manages scheduled execution of ADK agents.
+ * AgentScheduler - Manages scheduled execution of ADK-TS agents.
  *
  * Provides cron-based and interval-based scheduling for agent runs with
  * support for multiple concurrent schedules, execution tracking, and
@@ -8276,11 +8302,14 @@ interface DatabaseSessionServiceConfig {
 declare class DatabaseSessionService extends BaseSessionService {
     private db;
     private initialized;
+    private initPromise;
     constructor(config: DatabaseSessionServiceConfig);
     /**
-     * Initialize the database by creating required tables if they don't exist
+     * Initialize the database by creating required tables if they don't exist.
+     * Uses promise deduplication so concurrent callers share a single initialization.
      */
     private initializeDatabase;
+    private _doInitialize;
     /**
      * Ensure database is initialized before any operation
      */
@@ -9273,4 +9302,4 @@ declare const recordLlmCall: (dimensions: LlmMetricDimensions) => void;
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, AgentScheduler, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$7 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, CohereEmbeddingProvider, type CohereEmbeddingProviderConfig, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EditTool, type EmbeddingProvider, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type Entity, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$6 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$9 as Events, type EventsCompactionConfig, type EventsSummarizer, type ExecuteContext, type ExecuteFunction, ExitLoopTool, type File, FileOperationsTool, FileStorageProvider, type FileStorageProviderConfig, FileVectorStore, type FileVectorStoreConfig, type FilterConfig, FinalResponseMatchV2Evaluator, index$5 as Flows, type ForgetMemoryResult, ForgetMemoryTool, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, type GetSessionDetailsResult, GetSessionDetailsTool, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, InMemorySnapshotStore, InMemoryStorageProvider, InMemoryVectorStore, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmError, type LlmErrorOptions, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LlmSummaryProvider, type LlmSummaryProviderConfig, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDebank, McpDefillama, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpKalshi, McpLimitless, McpMemory, McpNearAgent, McpNearIntents, McpNotion, McpOdos, McpOpinion, McpPlaywright, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, McpSequentialThinking, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$b as Memory, MemoryBuilder, type MemoryContent, type MemoryDeleteFilter, type MemoryEntry, type MemoryRecord, type MemorySearchQuery, type MemorySearchResult, MemoryService, type MemoryServiceConfig, type MemoryStorageProvider, type MemorySummaryProvider, type MessagePart, type MetricInfo, type MetricValueInfo, ModelFallbackPlugin, index$8 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OllamaEmbeddingProvider, type OllamaEmbeddingProviderConfig, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderConfig, OpenAiLlm, OpenIdConnectScheme, OpenRouterEmbeddingProvider, type OpenRouterEmbeddingProviderConfig, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, PassthroughSummaryProvider, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$4 as Plugins, PrebuiltMetrics, PreloadMemoryTool, QdrantVectorStore, type QdrantVectorStoreConfig, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, RateLimitError, ReadTool, ReadonlyContext, RecallMemoryTool, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, Run, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type ScheduledJob, type SchedulerEvent, type SchedulerEventType, index$3 as Scheduling, type SearchMemoryResponse, type SearchMode, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$2 as Sessions, type SimpleMessage, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, type SnapshotStore, type SpanCounters, State, type Step, type StepDefinition, type StepFailed, type StepResult, type StepStatus, type StepSuccess, type StepSuspended, StreamingMode, type SuspendFunction, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, ToolOutputFilterPlugin, type ToolOutputFilterPluginOptions, type ToolSpanAttributes, type ToolUnion, index$a as Tools, type TopicSegment, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, index$1 as UnifiedMemory, type UnifiedMemoryConfig, UserInteractionTool, VERSION, VectorStorageProvider, type VectorStorageProviderConfig, type VectorStore, VertexAiSessionService, WebFetchTool, WebSearchTool, Workflow, type WorkflowConfig, type WorkflowResult, type WorkflowResultFailed, type WorkflowResultSuccess, type WorkflowResultSuspended, type WorkflowSnapshot, type WorkflowStatus, index as Workflows, type WorkingMemoryConfig, type WriteMemoryResult, WriteMemoryTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, collectTextFrom, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createStep, createTool, createWorkflow, defaultUnifiedMemoryConfig, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, getTraces, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, streamTextWithFinalEvent, telemetryService, textStreamFrom, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, AgentScheduler, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$7 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, CohereEmbeddingProvider, type CohereEmbeddingProviderConfig, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EditTool, type EmbeddingProvider, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type Entity, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$6 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$9 as Events, type EventsCompactionConfig, type EventsSummarizer, type ExecuteContext, type ExecuteFunction, ExitLoopTool, type File, FileOperationsTool, FileStorageProvider, type FileStorageProviderConfig, FileVectorStore, type FileVectorStoreConfig, type FilterConfig, FinalResponseMatchV2Evaluator, index$5 as Flows, type ForgetMemoryResult, ForgetMemoryTool, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, type GetSessionDetailsResult, GetSessionDetailsTool, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, InMemorySnapshotStore, InMemoryStorageProvider, InMemoryVectorStore, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type InvocationFlags, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmError, type LlmErrorOptions, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LlmSummaryProvider, type LlmSummaryProviderConfig, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDebank, McpDefillama, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpKalshi, McpLimitless, McpMemory, McpNearAgent, McpNearIntents, McpNotion, McpOdos, McpOpinion, McpPlaywright, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, McpSequentialThinking, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$b as Memory, MemoryBuilder, type MemoryContent, type MemoryDeleteFilter, type MemoryEntry, type MemoryRecord, type MemorySearchQuery, type MemorySearchResult, MemoryService, type MemoryServiceConfig, type MemoryStorageProvider, type MemorySummaryProvider, type MessagePart, type MetricInfo, type MetricValueInfo, ModelFallbackPlugin, index$8 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OllamaEmbeddingProvider, type OllamaEmbeddingProviderConfig, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderConfig, OpenAiLlm, OpenIdConnectScheme, OpenRouterEmbeddingProvider, type OpenRouterEmbeddingProviderConfig, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, PassthroughSummaryProvider, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$4 as Plugins, PrebuiltMetrics, PreloadMemoryTool, QdrantVectorStore, type QdrantVectorStoreConfig, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, RateLimitError, ReadTool, ReadonlyContext, RecallMemoryTool, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, Run, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type ScheduledJob, type SchedulerEvent, type SchedulerEventType, index$3 as Scheduling, type SearchMemoryResponse, type SearchMode, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$2 as Sessions, type SimpleMessage, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, type SnapshotStore, type SpanCounters, State, type Step, type StepDefinition, type StepFailed, type StepResult, type StepStatus, type StepSuccess, type StepSuspended, StreamingMode, type SuspendFunction, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, ToolOutputFilterPlugin, type ToolOutputFilterPluginOptions, type ToolSpanAttributes, type ToolUnion, index$a as Tools, type TopicSegment, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, index$1 as UnifiedMemory, type UnifiedMemoryConfig, UserInteractionTool, VERSION, VectorStorageProvider, type VectorStorageProviderConfig, type VectorStore, VertexAiSessionService, WebFetchTool, WebSearchTool, Workflow, type WorkflowConfig, type WorkflowResult, type WorkflowResultFailed, type WorkflowResultSuccess, type WorkflowResultSuspended, type WorkflowSnapshot, type WorkflowStatus, index as Workflows, type WorkingMemoryConfig, type WriteMemoryResult, WriteMemoryTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, collectTextFrom, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createStep, createTool, createWorkflow, defaultUnifiedMemoryConfig, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, getTraces, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, streamTextWithFinalEvent, telemetryService, textStreamFrom, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };