@iqai/adk 0.1.22 → 0.2.0

package/dist/index.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12; var _class13; var _class14; var _class15; var _class16; var _class17; var _class18; var _class19; var _class20; var _class21; var _class22; var _class23; var _class24; var _class25; var _class26; var _class27; var _class28; var _class29; var _class30; var _class31; var _class32; var _class33; var _class34;var __defProp = Object.defineProperty;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12; var _class13; var _class14; var _class15; var _class16; var _class17; var _class18; var _class19; var _class20; var _class21; var _class22; var _class23; var _class24; var _class25; var _class26; var _class27; var _class28; var _class29; var _class30; var _class31; var _class32; var _class33; var _class34; var _class35;var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
@@ -833,70 +833,23 @@ ${instructions.join("\n\n")}`;
 
 // src/models/llm-response.ts
 var LlmResponse = class _LlmResponse {
-  /**
-   * Unique identifier for the response.
-   */
   
-  /**
-   * The content generated by the model.
-   */
   
-  /**
-   * The grounding metadata of the response.
-   */
   
-  /**
-   * Indicates whether the text content is part of an unfinished text stream.
-   */
   
-  /**
-   * Indicates whether the response from the model is complete.
-   */
   
-  /**
-   * Error code if the response is an error.
-   */
   
-  /**
-   * Error message if the response is an error.
-   */
   
-  /**
-   * Flag indicating that LLM was interrupted when generating the content.
-   */
   
-  /**
-   * The custom metadata of the LlmResponse.
-   */
   
-  /**
-   * The usage metadata of the LlmResponse.
-   */
   
-  /**
-   * Index of the candidate response.
-   */
   
-  /**
-   * Reason why the model finished generating.
-   */
   
-  /**
-   * Error object if the response is an error.
-   */
   
-  /**
-   * Creates a new LlmResponse.
-   */
+  
   constructor(data = {}) {
     Object.assign(this, data);
   }
-  /**
-   * Creates an LlmResponse from a GenerateContentResponse.
-   *
-   * @param generateContentResponse The GenerateContentResponse to create the LlmResponse from.
-   * @returns The LlmResponse.
-   */
   static create(generateContentResponse) {
     const usageMetadata = generateContentResponse.usageMetadata;
     if (generateContentResponse.candidates && generateContentResponse.candidates.length > 0) {
@@ -928,15 +881,6 @@ var LlmResponse = class _LlmResponse {
       usageMetadata
     });
   }
-  /**
-   * Creates an LlmResponse from an error.
-   *
-   * @param error The error object or message.
-   * @param options Additional options for the error response.
-   * @param options.errorCode A specific error code for the response.
-   * @param options.model The model that was being used when the error occurred.
-   * @returns The LlmResponse.
-   */
   static fromError(error, options = {}) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     const errorCode = options.errorCode || "UNKNOWN_ERROR";
@@ -2675,30 +2619,16 @@ var OpenAiLlm = class extends BaseLlm {
 // src/models/llm-registry.ts
 init_logger();
 var LLMRegistry = (_class8 = class _LLMRegistry {
-  /**
-   * Map of model name regex to LLM class
-   */
   static __initStatic() {this.llmRegistry = /* @__PURE__ */ new Map()}
-  static __initStatic2() {this.logger = new Logger({ name: "LLMRegistry" })}
-  /**
-   * Creates a new LLM instance
-   *
-   * @param model The model name
-   * @returns The LLM instance
-   */
+  static __initStatic2() {this.modelInstances = /* @__PURE__ */ new Map()}
+  static __initStatic3() {this.logger = new Logger({ name: "LLMRegistry" })}
   static newLLM(model) {
     const llmClass = _LLMRegistry.resolve(model);
     if (!llmClass) {
-      throw new Error(`No LLM found for model: ${model}`);
+      throw new Error(`No LLM class found for model: ${model}`);
     }
     return new llmClass(model);
   }
-  /**
-   * Resolves the LLM class from the model name
-   *
-   * @param model The model name
-   * @returns The LLM class
-   */
   static resolve(model) {
     for (const [regex, llmClass] of _LLMRegistry.llmRegistry.entries()) {
       if (regex.test(model)) {
@@ -2707,36 +2637,56 @@ var LLMRegistry = (_class8 = class _LLMRegistry {
     }
     return null;
   }
-  /**
-   * Registers a new LLM class
-   *
-   * @param modelNameRegex The regex to match model names
-   * @param llmClass The LLM class
-   */
   static register(modelNameRegex, llmClass) {
     _LLMRegistry.llmRegistry.set(new RegExp(modelNameRegex), llmClass);
   }
-  /**
-   * Registers all model patterns from an LLM class
-   *
-   * @param llmClass The LLM class
-   */
   static registerLLM(llmClass) {
     const modelPatterns = llmClass.supportedModels();
     for (const pattern of modelPatterns) {
       _LLMRegistry.register(pattern, llmClass);
     }
   }
-  /**
-   * Logs all registered models for debugging
-   */
+  static registerModel(name, model) {
+    _LLMRegistry.modelInstances.set(name, model);
+  }
+  static getModel(name) {
+    const model = _LLMRegistry.modelInstances.get(name);
+    if (!model) {
+      throw new Error(`Model '${name}' not found in registry`);
+    }
+    return model;
+  }
+  static hasModel(name) {
+    return _LLMRegistry.modelInstances.has(name);
+  }
+  static unregisterModel(name) {
+    _LLMRegistry.modelInstances.delete(name);
+  }
+  static getModelOrCreate(name) {
+    if (_LLMRegistry.hasModel(name)) {
+      return _LLMRegistry.getModel(name);
+    }
+    return _LLMRegistry.newLLM(name);
+  }
+  static clear() {
+    _LLMRegistry.llmRegistry.clear();
+    _LLMRegistry.modelInstances.clear();
+  }
+  static clearModels() {
+    _LLMRegistry.modelInstances.clear();
+  }
+  static clearClasses() {
+    _LLMRegistry.llmRegistry.clear();
+  }
   static logRegisteredModels() {
-    _LLMRegistry.logger.debug(
-      "Registered LLM models:",
-      [..._LLMRegistry.llmRegistry.entries()].map(([regex]) => regex.toString())
+    const classPatterns = [..._LLMRegistry.llmRegistry.entries()].map(
+      ([regex]) => regex.toString()
     );
+    const instanceNames = [..._LLMRegistry.modelInstances.keys()];
+    _LLMRegistry.logger.debug("Registered LLM class patterns:", classPatterns);
+    _LLMRegistry.logger.debug("Registered LLM instances:", instanceNames);
   }
-}, _class8.__initStatic(), _class8.__initStatic2(), _class8);
+}, _class8.__initStatic(), _class8.__initStatic2(), _class8.__initStatic3(), _class8);
 
 // src/models/registry.ts
 function registerProviders() {
@@ -3111,9 +3061,9 @@ var OpenIdConnectScheme = class extends AuthScheme {
 
 // src/sessions/state.ts
 var State = (_class9 = class _State {
-  static __initStatic3() {this.APP_PREFIX = "app:"}
-  static __initStatic4() {this.USER_PREFIX = "user:"}
-  static __initStatic5() {this.TEMP_PREFIX = "temp:"}
+  static __initStatic4() {this.APP_PREFIX = "app:"}
+  static __initStatic5() {this.USER_PREFIX = "user:"}
+  static __initStatic6() {this.TEMP_PREFIX = "temp:"}
   
   
   /**
@@ -3207,7 +3157,7 @@ var State = (_class9 = class _State {
     const state = new _State(value, delta);
     return _State.createProxy(state);
   }
-}, _class9.__initStatic3(), _class9.__initStatic4(), _class9.__initStatic5(), _class9);
+}, _class9.__initStatic4(), _class9.__initStatic5(), _class9.__initStatic6(), _class9);
 
 // src/events/event.ts
 var _uuid = require('uuid');
@@ -4545,8 +4495,8 @@ var HttpRequestTool = class extends BaseTool {
 
 // src/tools/common/file-operations-tool.ts
 init_base_tool();
-var _promises = require('fs/promises'); var _promises2 = _interopRequireDefault(_promises);
-var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var _promises = require('fs/promises'); var fs2 = _interopRequireWildcard(_promises);
+var _path = require('path'); var path2 = _interopRequireWildcard(_path);
 
 var FileOperationsTool = class extends BaseTool {
   
@@ -4643,14 +4593,14 @@ var FileOperationsTool = class extends BaseTool {
    * Resolve a file path relative to the base path
    */
   resolvePath(filepath) {
-    return _path2.default.isAbsolute(filepath) ? filepath : _path2.default.resolve(this.basePath, filepath);
+    return path2.default.isAbsolute(filepath) ? filepath : path2.default.resolve(this.basePath, filepath);
   }
   /**
    * Validate that a path is within the base path for security
    */
   validatePath(filepath) {
-    const normalizedPath = _path2.default.normalize(filepath);
-    const normalizedBasePath = _path2.default.normalize(this.basePath);
+    const normalizedPath = path2.default.normalize(filepath);
+    const normalizedBasePath = path2.default.normalize(this.basePath);
     if (!normalizedPath.startsWith(normalizedBasePath)) {
       throw new Error(
         `Access denied: Can't access paths outside the base directory`
@@ -4662,7 +4612,7 @@ var FileOperationsTool = class extends BaseTool {
    */
   async readFile(filepath, encoding) {
     try {
-      const content = await _promises2.default.readFile(filepath, { encoding });
+      const content = await fs2.default.readFile(filepath, { encoding });
       return {
         success: true,
         data: content
@@ -4679,9 +4629,9 @@ var FileOperationsTool = class extends BaseTool {
    */
   async writeFile(filepath, content, encoding) {
     try {
-      const dir = _path2.default.dirname(filepath);
-      await _promises2.default.mkdir(dir, { recursive: true });
-      await _promises2.default.writeFile(filepath, content, { encoding });
+      const dir = path2.default.dirname(filepath);
+      await fs2.default.mkdir(dir, { recursive: true });
+      await fs2.default.writeFile(filepath, content, { encoding });
       return {
         success: true
       };
@@ -4697,9 +4647,9 @@ var FileOperationsTool = class extends BaseTool {
    */
   async appendFile(filepath, content, encoding) {
     try {
-      const dir = _path2.default.dirname(filepath);
-      await _promises2.default.mkdir(dir, { recursive: true });
-      await _promises2.default.appendFile(filepath, content, { encoding });
+      const dir = path2.default.dirname(filepath);
+      await fs2.default.mkdir(dir, { recursive: true });
+      await fs2.default.appendFile(filepath, content, { encoding });
       return {
         success: true
       };
@@ -4715,7 +4665,7 @@ var FileOperationsTool = class extends BaseTool {
    */
   async deleteFile(filepath) {
     try {
-      await _promises2.default.unlink(filepath);
+      await fs2.default.unlink(filepath);
       return {
         success: true
       };
@@ -4731,7 +4681,7 @@ var FileOperationsTool = class extends BaseTool {
    */
   async fileExists(filepath) {
     try {
-      await _promises2.default.access(filepath);
+      await fs2.default.access(filepath);
       return {
         success: true,
         data: true
@@ -4748,11 +4698,11 @@ var FileOperationsTool = class extends BaseTool {
    */
   async listDirectory(dirpath) {
     try {
-      const entries = await _promises2.default.readdir(dirpath, { withFileTypes: true });
+      const entries = await fs2.default.readdir(dirpath, { withFileTypes: true });
       const results = await Promise.all(
         entries.map(async (entry) => {
-          const entryPath = _path2.default.join(dirpath, entry.name);
-          const stats = await _promises2.default.stat(entryPath);
+          const entryPath = path2.default.join(dirpath, entry.name);
+          const stats = await fs2.default.stat(entryPath);
           return {
             name: entry.name,
             path: entryPath,
@@ -4780,7 +4730,7 @@ var FileOperationsTool = class extends BaseTool {
    */
   async makeDirectory(dirpath) {
     try {
-      await _promises2.default.mkdir(dirpath, { recursive: true });
+      await fs2.default.mkdir(dirpath, { recursive: true });
       return {
         success: true
       };
@@ -6582,9 +6532,23 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         yield event;
       }
     }
-    const tools = await agent.canonicalTools(
+    let tools = await agent.canonicalTools(
       new ReadonlyContext(invocationContext)
     );
+    if (tools.length > 1) {
+      const seen = /* @__PURE__ */ new Set();
+      const filtered = [];
+      for (const t of tools) {
+        const name = _optionalChain([t, 'optionalAccess', _172 => _172.name]);
+        if (!name) continue;
+        if (seen.has(name)) {
+          continue;
+        }
+        seen.add(name);
+        filtered.push(t);
+      }
+      tools = filtered;
+    }
     for (const tool of tools) {
       const toolContext = new ToolContext(invocationContext);
       await tool.processLlmRequest(toolContext, llmRequest);
@@ -6592,7 +6556,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
     if (tools.length > 0) {
       const toolsData = tools.map((tool) => ({
         Name: tool.name,
-        Description: _optionalChain([tool, 'access', _172 => _172.description, 'optionalAccess', _173 => _173.substring, 'call', _174 => _174(0, 50)]) + (_optionalChain([tool, 'access', _175 => _175.description, 'optionalAccess', _176 => _176.length]) > 50 ? "..." : ""),
+        Description: _optionalChain([tool, 'access', _173 => _173.description, 'optionalAccess', _174 => _174.substring, 'call', _175 => _175(0, 50)]) + (_optionalChain([tool, 'access', _176 => _176.description, 'optionalAccess', _177 => _177.length]) > 50 ? "..." : ""),
         "Long Running": tool.isLongRunning ? "Yes" : "No"
       }));
       this.logger.debugArray("\u{1F6E0}\uFE0F Available Tools", toolsData);
@@ -6655,14 +6619,14 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
       );
       if (functionResponseEvent) {
         yield functionResponseEvent;
-        const transferToAgent = _optionalChain([functionResponseEvent, 'access', _177 => _177.actions, 'optionalAccess', _178 => _178.transferToAgent]);
+        const transferToAgent = _optionalChain([functionResponseEvent, 'access', _178 => _178.actions, 'optionalAccess', _179 => _179.transferToAgent]);
         if (transferToAgent) {
           this.logger.debug(`\u{1F504} Live transfer to agent '${transferToAgent}'`);
           const agentToRun = this._getAgentToRun(
             invocationContext,
             transferToAgent
           );
-          for await (const event of _optionalChain([agentToRun, 'access', _179 => _179.runLive, 'optionalCall', _180 => _180(invocationContext)]) || agentToRun.runAsync(invocationContext)) {
+          for await (const event of _optionalChain([agentToRun, 'access', _180 => _180.runLive, 'optionalCall', _181 => _181(invocationContext)]) || agentToRun.runAsync(invocationContext)) {
             yield event;
           }
         }
@@ -6694,7 +6658,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         yield authEvent;
       }
       yield functionResponseEvent;
-      const transferToAgent = _optionalChain([functionResponseEvent, 'access', _181 => _181.actions, 'optionalAccess', _182 => _182.transferToAgent]);
+      const transferToAgent = _optionalChain([functionResponseEvent, 'access', _182 => _182.actions, 'optionalAccess', _183 => _183.transferToAgent]);
       if (transferToAgent) {
         this.logger.debug(`\u{1F504} Transferring to agent '${transferToAgent}'`);
         const agentToRun = this._getAgentToRun(
@@ -6740,27 +6704,62 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
     }
     invocationContext.incrementLlmCallCount();
     const isStreaming = invocationContext.runConfig.streamingMode === "sse" /* SSE */;
-    const tools = _optionalChain([llmRequest, 'access', _183 => _183.config, 'optionalAccess', _184 => _184.tools]) || [];
+    let tools = _optionalChain([llmRequest, 'access', _184 => _184.config, 'optionalAccess', _185 => _185.tools]) || [];
+    if (tools.length) {
+      const deduped = [];
+      const seenFn = /* @__PURE__ */ new Set();
+      for (const t of tools) {
+        const tool = t;
+        if (tool && Array.isArray(tool.functionDeclarations)) {
+          const newFds = tool.functionDeclarations.filter(
+            (fd) => {
+              if (_optionalChain([fd, 'optionalAccess', _186 => _186.name])) {
+                if (seenFn.has(fd.name)) {
+                  return false;
+                }
+                seenFn.add(fd.name);
+              }
+              return true;
+            }
+          );
+          if (newFds.length) {
+            deduped.push({ ...tool, functionDeclarations: newFds });
+          }
+        } else if (_optionalChain([tool, 'optionalAccess', _187 => _187.name])) {
+          if (seenFn.has(tool.name)) continue;
+          seenFn.add(tool.name);
+          deduped.push(tool);
+        } else {
+          deduped.push(tool);
+        }
+      }
+      if (deduped.length !== tools.length) {
+        this.logger.debug(
+          `\u{1F501} Deduplicated tool/function declarations: ${tools.length} -> ${deduped.length}`
+        );
+      }
+      llmRequest.config.tools = tools = deduped;
+    }
     const toolNames = tools.map((tool) => {
       if (tool.functionDeclarations && Array.isArray(tool.functionDeclarations)) {
         return tool.functionDeclarations.map((fn) => fn.name).join(", ");
       }
       if (tool.name) return tool.name;
-      if (_optionalChain([tool, 'access', _185 => _185.function, 'optionalAccess', _186 => _186.name])) return tool.function.name;
-      if (_optionalChain([tool, 'access', _187 => _187.function, 'optionalAccess', _188 => _188.function, 'optionalAccess', _189 => _189.name])) return tool.function.function.name;
+      if (_optionalChain([tool, 'access', _188 => _188.function, 'optionalAccess', _189 => _189.name])) return tool.function.name;
+      if (_optionalChain([tool, 'access', _190 => _190.function, 'optionalAccess', _191 => _191.function, 'optionalAccess', _192 => _192.name])) return tool.function.function.name;
       return "unknown";
     }).join(", ");
     const systemInstruction = llmRequest.getSystemInstructionText() || "";
     const truncatedSystemInstruction = systemInstruction.length > 100 ? `${systemInstruction.substring(0, 100)}...` : systemInstruction;
-    const contentPreview = _optionalChain([llmRequest, 'access', _190 => _190.contents, 'optionalAccess', _191 => _191.length]) > 0 ? LogFormatter.formatContentPreview(llmRequest.contents[0]) : "none";
+    const contentPreview = _optionalChain([llmRequest, 'access', _193 => _193.contents, 'optionalAccess', _194 => _194.length]) > 0 ? LogFormatter.formatContentPreview(llmRequest.contents[0]) : "none";
     this.logger.debugStructured("\u{1F4E4} LLM Request", {
       Model: llm.model,
       Agent: invocationContext.agent.name,
-      "Content Items": _optionalChain([llmRequest, 'access', _192 => _192.contents, 'optionalAccess', _193 => _193.length]) || 0,
+      "Content Items": _optionalChain([llmRequest, 'access', _195 => _195.contents, 'optionalAccess', _196 => _196.length]) || 0,
       "Content Preview": contentPreview,
       "System Instruction": truncatedSystemInstruction || "none",
       "Available Tools": toolNames || "none",
-      "Tool Count": _optionalChain([llmRequest, 'access', _194 => _194.config, 'optionalAccess', _195 => _195.tools, 'optionalAccess', _196 => _196.length]) || 0,
+      "Tool Count": _optionalChain([llmRequest, 'access', _197 => _197.config, 'optionalAccess', _198 => _198.tools, 'optionalAccess', _199 => _199.length]) || 0,
       Streaming: isStreaming ? "Yes" : "No"
     });
     let responseCount = 0;
@@ -6775,8 +6774,8 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         llmRequest,
         llmResponse
       );
-      const tokenCount = _optionalChain([llmResponse, 'access', _197 => _197.usageMetadata, 'optionalAccess', _198 => _198.totalTokenCount]) || "unknown";
-      const functionCalls = _optionalChain([llmResponse, 'access', _199 => _199.content, 'optionalAccess', _200 => _200.parts, 'optionalAccess', _201 => _201.filter, 'call', _202 => _202((part) => part.functionCall)]) || [];
+      const tokenCount = _optionalChain([llmResponse, 'access', _200 => _200.usageMetadata, 'optionalAccess', _201 => _201.totalTokenCount]) || "unknown";
+      const functionCalls = _optionalChain([llmResponse, 'access', _202 => _202.content, 'optionalAccess', _203 => _203.parts, 'optionalAccess', _204 => _204.filter, 'call', _205 => _205((part) => part.functionCall)]) || [];
       const functionCallsDisplay = LogFormatter.formatFunctionCalls(functionCalls);
       const responsePreview = LogFormatter.formatResponsePreview(llmResponse);
       this.logger.debugStructured("\u{1F4E5} LLM Response", {
@@ -6920,7 +6919,7 @@ var EnhancedAuthConfig = class {
    */
   generateCredentialKey() {
     const schemeKey = this.authScheme.type || "unknown";
-    const credentialKey = _optionalChain([this, 'access', _203 => _203.rawAuthCredential, 'optionalAccess', _204 => _204.type]) || "none";
+    const credentialKey = _optionalChain([this, 'access', _206 => _206.rawAuthCredential, 'optionalAccess', _207 => _207.type]) || "none";
     const timestamp = Date.now();
     return `adk_${schemeKey}_${credentialKey}_${timestamp}`;
   }
@@ -7077,7 +7076,7 @@ var AuthLlmRequestProcessor = class extends BaseLlmRequestProcessor {
    */
   parseAndStoreAuthResponse(authHandler, invocationContext) {
     try {
-      const credentialKey = _optionalChain([authHandler, 'access', _205 => _205.authConfig, 'access', _206 => _206.context, 'optionalAccess', _207 => _207.credentialKey]) || `temp:${Date.now()}`;
+      const credentialKey = _optionalChain([authHandler, 'access', _208 => _208.authConfig, 'access', _209 => _209.context, 'optionalAccess', _210 => _210.credentialKey]) || `temp:${Date.now()}`;
       const fullCredentialKey = credentialKey.startsWith("temp:") ? credentialKey : `temp:${credentialKey}`;
       invocationContext.session.state[fullCredentialKey] = authHandler.credential;
       if (authHandler.authConfig.authScheme.type === "oauth2" || authHandler.authConfig.authScheme.type === "openIdConnect") {
@@ -7183,7 +7182,7 @@ var BuiltInCodeExecutor = class extends BaseCodeExecutor {
    * Pre-process the LLM request for Gemini 2.0+ models to use the code execution tool
    */
   processLlmRequest(llmRequest) {
-    if (!_optionalChain([llmRequest, 'access', _208 => _208.model, 'optionalAccess', _209 => _209.startsWith, 'call', _210 => _210("gemini-2")])) {
+    if (!_optionalChain([llmRequest, 'access', _211 => _211.model, 'optionalAccess', _212 => _212.startsWith, 'call', _213 => _213("gemini-2")])) {
       throw new Error(
         `Gemini code execution tool is not supported for model ${llmRequest.model}`
       );
@@ -7228,7 +7227,7 @@ var CodeExecutionUtils = class _CodeExecutionUtils {
    * Extracts the first code block from the content and truncates everything after it
    */
   static extractCodeAndTruncateContent(content, codeBlockDelimiters) {
-    if (!_optionalChain([content, 'optionalAccess', _211 => _211.parts, 'optionalAccess', _212 => _212.length])) {
+    if (!_optionalChain([content, 'optionalAccess', _214 => _214.parts, 'optionalAccess', _215 => _215.length])) {
       return null;
     }
     for (let idx = 0; idx < content.parts.length; idx++) {
@@ -7314,7 +7313,7 @@ ${fileNames}`);
    * Converts the code execution parts to text parts in a Content
    */
   static convertCodeExecutionParts(content, codeBlockDelimiter, executionResultDelimiters) {
-    if (!_optionalChain([content, 'access', _213 => _213.parts, 'optionalAccess', _214 => _214.length])) {
+    if (!_optionalChain([content, 'access', _216 => _216.parts, 'optionalAccess', _217 => _217.length])) {
       return;
     }
     const lastPart = content.parts[content.parts.length - 1];
@@ -7707,7 +7706,7 @@ async function* runPostProcessor(invocationContext, llmResponse) {
 function extractAndReplaceInlineFiles(codeExecutorContext, llmRequest) {
   const allInputFiles = codeExecutorContext.getInputFiles();
   const savedFileNames = new Set(allInputFiles.map((f) => f.name));
-  for (let i = 0; i < (_optionalChain([llmRequest, 'access', _215 => _215.contents, 'optionalAccess', _216 => _216.length]) || 0); i++) {
+  for (let i = 0; i < (_optionalChain([llmRequest, 'access', _218 => _218.contents, 'optionalAccess', _219 => _219.length]) || 0); i++) {
     const content = llmRequest.contents[i];
     if (content.role !== "user" || !content.parts) {
       continue;
@@ -7739,7 +7738,7 @@ Available file: \`${fileName}\`
 }
 function getOrSetExecutionId(invocationContext, codeExecutorContext) {
   const agent = invocationContext.agent;
-  if (!hasCodeExecutor(agent) || !_optionalChain([agent, 'access', _217 => _217.codeExecutor, 'optionalAccess', _218 => _218.stateful])) {
+  if (!hasCodeExecutor(agent) || !_optionalChain([agent, 'access', _220 => _220.codeExecutor, 'optionalAccess', _221 => _221.stateful])) {
     return void 0;
   }
   let executionId = codeExecutorContext.getExecutionId();
@@ -7970,7 +7969,7 @@ function rearrangeEventsForLatestFunctionResponse(events) {
       continue;
     }
     const functionResponses2 = event.getFunctionResponses();
-    if (_optionalChain([functionResponses2, 'optionalAccess', _219 => _219.some, 'call', _220 => _220((fr) => fr.id && functionResponsesIds.has(fr.id))])) {
+    if (_optionalChain([functionResponses2, 'optionalAccess', _222 => _222.some, 'call', _223 => _223((fr) => fr.id && functionResponsesIds.has(fr.id))])) {
       functionResponseEvents.push(event);
     }
   }
@@ -8069,7 +8068,7 @@ function mergeFunctionResponseEvents(functionResponseEvents) {
   const partIndicesInMergedEvent = {};
   for (let idx = 0; idx < partsInMergedEvent.length; idx++) {
     const part = partsInMergedEvent[idx];
-    if (_optionalChain([part, 'access', _221 => _221.functionResponse, 'optionalAccess', _222 => _222.id])) {
+    if (_optionalChain([part, 'access', _224 => _224.functionResponse, 'optionalAccess', _225 => _225.id])) {
       partIndicesInMergedEvent[part.functionResponse.id] = idx;
     }
   }
@@ -8078,7 +8077,7 @@ function mergeFunctionResponseEvents(functionResponseEvents) {
       throw new Error("There should be at least one function_response part.");
     }
     for (const part of event.content.parts) {
-      if (_optionalChain([part, 'access', _223 => _223.functionResponse, 'optionalAccess', _224 => _224.id])) {
+      if (_optionalChain([part, 'access', _226 => _226.functionResponse, 'optionalAccess', _227 => _227.id])) {
         const functionCallId = part.functionResponse.id;
         if (functionCallId in partIndicesInMergedEvent) {
           partsInMergedEvent[partIndicesInMergedEvent[functionCallId]] = part;
@@ -8347,7 +8346,7 @@ var PlanReActPlanner = class extends BasePlanner {
     let firstFcPartIndex = -1;
     for (let i = 0; i < responseParts.length; i++) {
       if (responseParts[i].functionCall) {
-        if (!_optionalChain([responseParts, 'access', _225 => _225[i], 'access', _226 => _226.functionCall, 'optionalAccess', _227 => _227.name])) {
+        if (!_optionalChain([responseParts, 'access', _228 => _228[i], 'access', _229 => _229.functionCall, 'optionalAccess', _230 => _230.name])) {
           continue;
         }
         preservedParts.push(responseParts[i]);
@@ -8386,7 +8385,7 @@ var PlanReActPlanner = class extends BasePlanner {
    * Handles non-function-call parts of the response
    */
   _handleNonFunctionCallParts(responsePart, preservedParts) {
-    if (_optionalChain([responsePart, 'access', _228 => _228.text, 'optionalAccess', _229 => _229.includes, 'call', _230 => _230(FINAL_ANSWER_TAG)])) {
+    if (_optionalChain([responsePart, 'access', _231 => _231.text, 'optionalAccess', _232 => _232.includes, 'call', _233 => _233(FINAL_ANSWER_TAG)])) {
       const [reasoningText, finalAnswerText] = this._splitByLastPattern(
         responsePart.text,
         FINAL_ANSWER_TAG
@@ -8635,7 +8634,7 @@ var SharedMemoryRequestProcessor = class extends BaseLlmRequestProcessor {
     const memoryService = invocationContext.memoryService;
     if (!memoryService) return;
     const lastUserEvent = invocationContext.session.events.findLast(
-      (e) => e.author === "user" && _optionalChain([e, 'access', _231 => _231.content, 'optionalAccess', _232 => _232.parts, 'optionalAccess', _233 => _233.length])
+      (e) => e.author === "user" && _optionalChain([e, 'access', _234 => _234.content, 'optionalAccess', _235 => _235.parts, 'optionalAccess', _236 => _236.length])
     );
     if (!lastUserEvent) return;
     const query = (_nullishCoalesce(lastUserEvent.content.parts, () => ( []))).map((p) => p.text || "").join(" ");
@@ -8646,7 +8645,7 @@ var SharedMemoryRequestProcessor = class extends BaseLlmRequestProcessor {
     });
     const sessionTexts = new Set(
       (llmRequest.contents || []).flatMap(
-        (c) => _optionalChain([c, 'access', _234 => _234.parts, 'optionalAccess', _235 => _235.map, 'call', _236 => _236((p) => p.text)]) || []
+        (c) => _optionalChain([c, 'access', _237 => _237.parts, 'optionalAccess', _238 => _238.map, 'call', _239 => _239((p) => p.text)]) || []
       )
     );
     for (const memory of results.memories) {
@@ -9069,7 +9068,7 @@ var LlmAgent = (_class27 = class _LlmAgent extends BaseAgent {
    * This matches the Python implementation's _llm_flow property
    */
   get llmFlow() {
-    if (this.disallowTransferToParent && this.disallowTransferToPeers && !_optionalChain([this, 'access', _237 => _237.subAgents, 'optionalAccess', _238 => _238.length])) {
+    if (this.disallowTransferToParent && this.disallowTransferToPeers && !_optionalChain([this, 'access', _240 => _240.subAgents, 'optionalAccess', _241 => _241.length])) {
       return new SingleFlow();
     }
     return new AutoFlow();
@@ -9085,7 +9084,7 @@ var LlmAgent = (_class27 = class _LlmAgent extends BaseAgent {
       );
       return;
     }
-    if (this.outputKey && event.isFinalResponse() && _optionalChain([event, 'access', _239 => _239.content, 'optionalAccess', _240 => _240.parts])) {
+    if (this.outputKey && event.isFinalResponse() && _optionalChain([event, 'access', _242 => _242.content, 'optionalAccess', _243 => _243.parts])) {
       let result = event.content.parts.map((part) => part.text || "").join("");
       if (this.outputSchema) {
         if (!result.trim()) {
@@ -9313,7 +9312,7 @@ var LoopAgent = class extends BaseAgent {
       for (const subAgent of this.subAgents) {
         for await (const event of subAgent.runAsync(ctx)) {
           yield event;
-          if (_optionalChain([event, 'access', _241 => _241.actions, 'optionalAccess', _242 => _242.escalate])) {
+          if (_optionalChain([event, 'access', _244 => _244.actions, 'optionalAccess', _245 => _245.escalate])) {
             return;
           }
         }
@@ -9555,6 +9554,7 @@ var LangGraphAgent = (_class28 = class extends BaseAgent {
 }, _class28);
 
 // src/agents/agent-builder.ts
+init_logger();
 
 
 // src/runners.ts
@@ -9624,17 +9624,17 @@ var RunConfig = class {
    */
   
   constructor(config) {
-    this.speechConfig = _optionalChain([config, 'optionalAccess', _243 => _243.speechConfig]);
-    this.responseModalities = _optionalChain([config, 'optionalAccess', _244 => _244.responseModalities]);
-    this.saveInputBlobsAsArtifacts = _optionalChain([config, 'optionalAccess', _245 => _245.saveInputBlobsAsArtifacts]) || false;
-    this.supportCFC = _optionalChain([config, 'optionalAccess', _246 => _246.supportCFC]) || false;
-    this.streamingMode = _optionalChain([config, 'optionalAccess', _247 => _247.streamingMode]) || "NONE" /* NONE */;
-    this.outputAudioTranscription = _optionalChain([config, 'optionalAccess', _248 => _248.outputAudioTranscription]);
-    this.inputAudioTranscription = _optionalChain([config, 'optionalAccess', _249 => _249.inputAudioTranscription]);
-    this.realtimeInputConfig = _optionalChain([config, 'optionalAccess', _250 => _250.realtimeInputConfig]);
-    this.enableAffectiveDialog = _optionalChain([config, 'optionalAccess', _251 => _251.enableAffectiveDialog]);
-    this.proactivity = _optionalChain([config, 'optionalAccess', _252 => _252.proactivity]);
-    this.maxLlmCalls = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _253 => _253.maxLlmCalls]), () => ( 500));
+    this.speechConfig = _optionalChain([config, 'optionalAccess', _246 => _246.speechConfig]);
+    this.responseModalities = _optionalChain([config, 'optionalAccess', _247 => _247.responseModalities]);
+    this.saveInputBlobsAsArtifacts = _optionalChain([config, 'optionalAccess', _248 => _248.saveInputBlobsAsArtifacts]) || false;
+    this.supportCFC = _optionalChain([config, 'optionalAccess', _249 => _249.supportCFC]) || false;
+    this.streamingMode = _optionalChain([config, 'optionalAccess', _250 => _250.streamingMode]) || "NONE" /* NONE */;
+    this.outputAudioTranscription = _optionalChain([config, 'optionalAccess', _251 => _251.outputAudioTranscription]);
+    this.inputAudioTranscription = _optionalChain([config, 'optionalAccess', _252 => _252.inputAudioTranscription]);
+    this.realtimeInputConfig = _optionalChain([config, 'optionalAccess', _253 => _253.realtimeInputConfig]);
+    this.enableAffectiveDialog = _optionalChain([config, 'optionalAccess', _254 => _254.enableAffectiveDialog]);
+    this.proactivity = _optionalChain([config, 'optionalAccess', _255 => _255.proactivity]);
+    this.maxLlmCalls = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _256 => _256.maxLlmCalls]), () => ( 500));
     this.validateMaxLlmCalls();
   }
   /**
@@ -9668,19 +9668,19 @@ var InMemoryArtifactService = (_class29 = class {constructor() { _class29.protot
   }
   async saveArtifact(args) {
     const { appName, userId, sessionId, filename, artifact } = args;
-    const path2 = this.getArtifactPath(appName, userId, sessionId, filename);
-    if (!this.artifacts.has(path2)) {
-      this.artifacts.set(path2, []);
+    const path3 = this.getArtifactPath(appName, userId, sessionId, filename);
+    if (!this.artifacts.has(path3)) {
+      this.artifacts.set(path3, []);
     }
-    const versions = this.artifacts.get(path2);
+    const versions = this.artifacts.get(path3);
     const version = versions.length;
     versions.push(artifact);
     return version;
   }
   async loadArtifact(args) {
     const { appName, userId, sessionId, filename, version } = args;
-    const path2 = this.getArtifactPath(appName, userId, sessionId, filename);
-    const versions = this.artifacts.get(path2);
+    const path3 = this.getArtifactPath(appName, userId, sessionId, filename);
+    const versions = this.artifacts.get(path3);
     if (!versions || versions.length === 0) {
       return null;
     }
@@ -9701,12 +9701,12 @@ var InMemoryArtifactService = (_class29 = class {constructor() { _class29.protot
     const sessionPrefix = `${appName}/${userId}/${sessionId}/`;
     const userNamespacePrefix = `${appName}/${userId}/user/`;
     const filenames = [];
-    for (const path2 of this.artifacts.keys()) {
-      if (path2.startsWith(sessionPrefix)) {
-        const filename = path2.substring(sessionPrefix.length);
+    for (const path3 of this.artifacts.keys()) {
+      if (path3.startsWith(sessionPrefix)) {
+        const filename = path3.substring(sessionPrefix.length);
         filenames.push(filename);
-      } else if (path2.startsWith(userNamespacePrefix)) {
-        const filename = path2.substring(userNamespacePrefix.length);
+      } else if (path3.startsWith(userNamespacePrefix)) {
+        const filename = path3.substring(userNamespacePrefix.length);
         filenames.push(filename);
       }
     }
@@ -9714,16 +9714,16 @@ var InMemoryArtifactService = (_class29 = class {constructor() { _class29.protot
   }
   async deleteArtifact(args) {
     const { appName, userId, sessionId, filename } = args;
-    const path2 = this.getArtifactPath(appName, userId, sessionId, filename);
-    if (!this.artifacts.has(path2)) {
+    const path3 = this.getArtifactPath(appName, userId, sessionId, filename);
+    if (!this.artifacts.has(path3)) {
       return;
     }
-    this.artifacts.delete(path2);
+    this.artifacts.delete(path3);
   }
   async listVersions(args) {
     const { appName, userId, sessionId, filename } = args;
-    const path2 = this.getArtifactPath(appName, userId, sessionId, filename);
-    const versions = this.artifacts.get(path2);
+    const path3 = this.getArtifactPath(appName, userId, sessionId, filename);
+    const versions = this.artifacts.get(path3);
     if (!versions || versions.length === 0) {
       return [];
     }
@@ -9778,7 +9778,7 @@ var InMemoryMemoryService = (_class30 = class {
     }
     const userSessions = this._sessionEvents.get(userKey);
     const filteredEvents = session.events.filter(
-      (event) => _optionalChain([event, 'access', _254 => _254.content, 'optionalAccess', _255 => _255.parts])
+      (event) => _optionalChain([event, 'access', _257 => _257.content, 'optionalAccess', _258 => _258.parts])
     );
     userSessions.set(session.id, filteredEvents);
   }
@@ -9917,7 +9917,7 @@ var InMemorySessionService = (_class31 = class extends BaseSessionService {const
     return this.createSessionImpl(appName, userId, state, sessionId);
   }
   createSessionImpl(appName, userId, state, sessionId) {
-    const finalSessionId = _optionalChain([sessionId, 'optionalAccess', _256 => _256.trim, 'call', _257 => _257()]) || _crypto.randomUUID.call(void 0, );
+    const finalSessionId = _optionalChain([sessionId, 'optionalAccess', _259 => _259.trim, 'call', _260 => _260()]) || _crypto.randomUUID.call(void 0, );
     const session = {
       appName,
       userId,
@@ -10074,7 +10074,7 @@ var InMemorySessionService = (_class31 = class extends BaseSessionService {const
       warning(`sessionId ${sessionId} not in sessions[appName][userId]`);
       return event;
     }
-    if (_optionalChain([event, 'access', _258 => _258.actions, 'optionalAccess', _259 => _259.stateDelta])) {
+    if (_optionalChain([event, 'access', _261 => _261.actions, 'optionalAccess', _262 => _262.stateDelta])) {
       for (const key in event.actions.stateDelta) {
         const value = event.actions.stateDelta[key];
         if (key.startsWith(State.APP_PREFIX)) {
@@ -10108,14 +10108,14 @@ function _findFunctionCallEventIfLastEventIsFunctionResponse(session) {
     return null;
   }
   const lastEvent = events[events.length - 1];
-  if (_optionalChain([lastEvent, 'access', _260 => _260.content, 'optionalAccess', _261 => _261.parts, 'optionalAccess', _262 => _262.some, 'call', _263 => _263((part) => part.functionResponse)])) {
-    const functionCallId = _optionalChain([lastEvent, 'access', _264 => _264.content, 'access', _265 => _265.parts, 'access', _266 => _266.find, 'call', _267 => _267(
+  if (_optionalChain([lastEvent, 'access', _263 => _263.content, 'optionalAccess', _264 => _264.parts, 'optionalAccess', _265 => _265.some, 'call', _266 => _266((part) => part.functionResponse)])) {
+    const functionCallId = _optionalChain([lastEvent, 'access', _267 => _267.content, 'access', _268 => _268.parts, 'access', _269 => _269.find, 'call', _270 => _270(
       (part) => part.functionResponse
-    ), 'optionalAccess', _268 => _268.functionResponse, 'optionalAccess', _269 => _269.id]);
+    ), 'optionalAccess', _271 => _271.functionResponse, 'optionalAccess', _272 => _272.id]);
     if (!functionCallId) return null;
     for (let i = events.length - 2; i >= 0; i--) {
       const event = events[i];
-      const functionCalls = _optionalChain([event, 'access', _270 => _270.getFunctionCalls, 'optionalCall', _271 => _271()]) || [];
+      const functionCalls = _optionalChain([event, 'access', _273 => _273.getFunctionCalls, 'optionalCall', _274 => _274()]) || [];
       for (const functionCall of functionCalls) {
         if (functionCall.id === functionCallId) {
           return event;
@@ -10193,7 +10193,7 @@ var Runner = (_class32 = class {
       }
     };
     invokeRunAsync();
-    return function* () {
+    return (function* () {
       while (true) {
         while (queueIndex >= eventQueue.length && !asyncCompleted) {
         }
@@ -10206,7 +10206,7 @@ var Runner = (_class32 = class {
         }
         yield event;
       }
-    }();
+    })();
   }
   /**
    * Main entry method to run the agent in this runner.
@@ -10318,15 +10318,15 @@ var Runner = (_class32 = class {
    */
   _findAgentToRun(session, rootAgent) {
     const event = _findFunctionCallEventIfLastEventIsFunctionResponse(session);
-    if (_optionalChain([event, 'optionalAccess', _272 => _272.author])) {
+    if (_optionalChain([event, 'optionalAccess', _275 => _275.author])) {
       return rootAgent.findAgent(event.author);
     }
-    const nonUserEvents = _optionalChain([session, 'access', _273 => _273.events, 'optionalAccess', _274 => _274.filter, 'call', _275 => _275((e) => e.author !== "user"), 'access', _276 => _276.reverse, 'call', _277 => _277()]) || [];
+    const nonUserEvents = _optionalChain([session, 'access', _276 => _276.events, 'optionalAccess', _277 => _277.filter, 'call', _278 => _278((e) => e.author !== "user"), 'access', _279 => _279.reverse, 'call', _280 => _280()]) || [];
     for (const event2 of nonUserEvents) {
       if (event2.author === rootAgent.name) {
         return rootAgent;
       }
-      const agent = _optionalChain([rootAgent, 'access', _278 => _278.findSubAgent, 'optionalCall', _279 => _279(event2.author)]);
+      const agent = _optionalChain([rootAgent, 'access', _281 => _281.findSubAgent, 'optionalCall', _282 => _282(event2.author)]);
       if (!agent) {
         this.logger.debug(
           `Event from an unknown agent: ${event2.author}, event id: ${event2.id}`
@@ -10406,10 +10406,16 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
   
   __init56() {this.agentType = "llm"}
   
+  
+  // If provided, reuse directly
+  __init57() {this.definitionLocked = false}
+  // Lock further definition mutation after withAgent
+  __init58() {this.warnedMethods = /* @__PURE__ */ new Set()}
+  __init59() {this.logger = new Logger({ name: "AgentBuilder" })}
   /**
    * Private constructor - use static create() method
    */
-  constructor(name) {;_class33.prototype.__init56.call(this);
+  constructor(name) {;_class33.prototype.__init56.call(this);_class33.prototype.__init57.call(this);_class33.prototype.__init58.call(this);_class33.prototype.__init59.call(this);
     this.config = { name };
   }
   /**
@@ -10434,6 +10440,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withModel(model) {
+    this.warnIfLocked("withModel");
     this.config.model = model;
     return this;
   }
@@ -10443,6 +10450,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withDescription(description) {
+    this.warnIfLocked("withDescription");
     this.config.description = description;
     return this;
   }
@@ -10452,14 +10460,17 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withInstruction(instruction) {
+    this.warnIfLocked("withInstruction");
     this.config.instruction = instruction;
     return this;
   }
   withInputSchema(schema) {
+    this.warnIfLocked("withInputSchema");
     this.config.inputSchema = schema;
     return this;
   }
   withOutputSchema(schema) {
+    this.warnIfLocked("withOutputSchema");
     this.config.outputSchema = schema;
     return this;
   }
@@ -10469,6 +10480,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withTools(...tools) {
+    this.warnIfLocked("withTools");
     this.config.tools = [...this.config.tools || [], ...tools];
     return this;
   }
@@ -10478,6 +10490,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withPlanner(planner) {
+    this.warnIfLocked("withPlanner");
     this.config.planner = planner;
     return this;
   }
@@ -10487,6 +10500,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withCodeExecutor(codeExecutor) {
+    this.warnIfLocked("withCodeExecutor");
     this.config.codeExecutor = codeExecutor;
     return this;
   }
@@ -10496,6 +10510,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withOutputKey(outputKey) {
+    this.warnIfLocked("withOutputKey");
     this.config.outputKey = outputKey;
     return this;
   }
@@ -10505,6 +10520,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withSubAgents(subAgents) {
+    this.warnIfLocked("withSubAgents");
     this.config.subAgents = subAgents;
     return this;
   }
@@ -10514,6 +10530,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withBeforeAgentCallback(callback) {
+    this.warnIfLocked("withBeforeAgentCallback");
     this.config.beforeAgentCallback = callback;
     return this;
   }
@@ -10523,15 +10540,29 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   withAfterAgentCallback(callback) {
+    this.warnIfLocked("withAfterAgentCallback");
     this.config.afterAgentCallback = callback;
     return this;
   }
+  /**
+   * Provide an already constructed agent instance. Further definition-mutating calls
+   * (model/tools/instruction/etc.) will be ignored with a dev warning.
+   */
+  withAgent(agent) {
+    this.existingAgent = agent;
+    this.definitionLocked = true;
+    if (this.config.name === "default_agent" && agent.name) {
+      this.config.name = agent.name;
+    }
+    return this;
+  }
   /**
    * Configure as a sequential agent
    * @param subAgents Sub-agents to execute in sequence
    * @returns This builder instance for chaining
    */
   asSequential(subAgents) {
+    this.warnIfLocked("asSequential");
     this.agentType = "sequential";
     this.config.subAgents = subAgents;
     return this;
@@ -10542,6 +10573,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   asParallel(subAgents) {
+    this.warnIfLocked("asParallel");
     this.agentType = "parallel";
     this.config.subAgents = subAgents;
     return this;
@@ -10553,6 +10585,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   asLoop(subAgents, maxIterations = 3) {
+    this.warnIfLocked("asLoop");
     this.agentType = "loop";
     this.config.subAgents = subAgents;
     this.config.maxIterations = maxIterations;
@@ -10565,6 +10598,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns This builder instance for chaining
    */
   asLangGraph(nodes, rootNode) {
+    this.warnIfLocked("asLangGraph");
     this.agentType = "langgraph";
     this.config.nodes = nodes;
     this.config.rootNode = rootNode;
@@ -10691,6 +10725,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
    * @returns Created agent instance
    */
   createAgent() {
+    if (this.existingAgent) return this.existingAgent;
     switch (this.agentType) {
       case "llm": {
         if (!this.config.model) {
@@ -10785,7 +10820,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
       async ask(message) {
         const newMessage = typeof message === "string" ? { parts: [{ text: message }] } : typeof message === "object" && "contents" in message ? { parts: message.contents[message.contents.length - 1].parts } : message;
         let response = "";
-        if (!_optionalChain([sessionOptions, 'optionalAccess', _280 => _280.userId])) {
+        if (!_optionalChain([sessionOptions, 'optionalAccess', _283 => _283.userId])) {
           throw new Error("Session configuration is required");
         }
         for await (const event of baseRunner.runAsync({
@@ -10793,7 +10828,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
           sessionId: session.id,
           newMessage
         })) {
-          if (_optionalChain([event, 'access', _281 => _281.content, 'optionalAccess', _282 => _282.parts]) && Array.isArray(event.content.parts)) {
+          if (_optionalChain([event, 'access', _284 => _284.content, 'optionalAccess', _285 => _285.parts]) && Array.isArray(event.content.parts)) {
             const content = event.content.parts.map(
               (part) => (part && typeof part === "object" && "text" in part ? part.text : "") || ""
             ).join("");
@@ -10821,6 +10856,22 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
       }
     };
   }
+  /**
+   * Warn (once per method) if the definition has been locked by withAgent().
+   */
+  warnIfLocked(method) {
+    if (!this.definitionLocked) return;
+    if (this.warnedMethods.has(method)) return;
+    this.warnedMethods.add(method);
+    if (process.env.NODE_ENV !== "production") {
+      const msg = `AgentBuilder: attempted to call ${method} after withAgent(); ignoring. (Wrap the agent first OR configure before withAgent).`;
+      if (this.logger && typeof this.logger.warn === "function") {
+        this.logger.warn(msg);
+      } else {
+        console.warn(msg);
+      }
+    }
+  }
 }, _class33);
 
 // src/memory/index.ts
@@ -10885,7 +10936,7 @@ var VertexAiSessionService = class extends BaseSessionService {
         path: `operations/${operationId}`,
         request_dict: {}
       });
-      if (_optionalChain([lroResponse, 'optionalAccess', _283 => _283.done])) {
+      if (_optionalChain([lroResponse, 'optionalAccess', _286 => _286.done])) {
         break;
       }
       await new Promise((resolve) => setTimeout(resolve, 1e3));
@@ -10985,14 +11036,14 @@ var VertexAiSessionService = class extends BaseSessionService {
   async listSessions(appName, userId) {
     const reasoningEngineId = this.getReasoningEngineId(appName);
     const apiClient = this.getApiClient();
-    let path2 = `reasoningEngines/${reasoningEngineId}/sessions`;
+    let path3 = `reasoningEngines/${reasoningEngineId}/sessions`;
     if (userId) {
       const parsedUserId = encodeURIComponent(`"${userId}"`);
-      path2 = `${path2}?filter=user_id=${parsedUserId}`;
+      path3 = `${path3}?filter=user_id=${parsedUserId}`;
     }
     const apiResponse = await apiClient.async_request({
       http_method: "GET",
-      path: path2,
+      path: path3,
       request_dict: {}
     });
     if (apiResponse.httpHeaders) {
@@ -11157,9 +11208,9 @@ var VertexAiSessionService = class extends BaseSessionService {
 var _kysely = require('kysely');
 var DatabaseSessionService = (_class34 = class extends BaseSessionService {
   
-  __init57() {this.initialized = false}
+  __init60() {this.initialized = false}
   constructor(config) {
-    super();_class34.prototype.__init57.call(this);;
+    super();_class34.prototype.__init60.call(this);;
     this.db = config.db;
     if (!config.skipTableCreation) {
       this.initializeDatabase().catch((error) => {
@@ -11256,12 +11307,12 @@ var DatabaseSessionService = (_class34 = class extends BaseSessionService {
   }
   async createSession(appName, userId, state, sessionId) {
     await this.ensureInitialized();
-    const id = _optionalChain([sessionId, 'optionalAccess', _284 => _284.trim, 'call', _285 => _285()]) || this.generateSessionId();
+    const id = _optionalChain([sessionId, 'optionalAccess', _287 => _287.trim, 'call', _288 => _288()]) || this.generateSessionId();
     return await this.db.transaction().execute(async (trx) => {
       const appState = await trx.selectFrom("app_states").selectAll().where("app_name", "=", appName).executeTakeFirst();
       const userState = await trx.selectFrom("user_states").selectAll().where("app_name", "=", appName).where("user_id", "=", userId).executeTakeFirst();
-      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _286 => _286.state]), {});
-      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _287 => _287.state]), {});
+      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _289 => _289.state]), {});
+      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _290 => _290.state]), {});
       if (!appState) {
         await trx.insertInto("app_states").values({
           app_name: appName,
@@ -11320,21 +11371,21 @@ var DatabaseSessionService = (_class34 = class extends BaseSessionService {
         return void 0;
       }
       let eventQuery = trx.selectFrom("events").selectAll().where("session_id", "=", sessionId).orderBy("timestamp", "desc");
-      if (_optionalChain([config, 'optionalAccess', _288 => _288.afterTimestamp])) {
+      if (_optionalChain([config, 'optionalAccess', _291 => _291.afterTimestamp])) {
         eventQuery = eventQuery.where(
           "timestamp",
           ">=",
           new Date(config.afterTimestamp * 1e3)
         );
       }
-      if (_optionalChain([config, 'optionalAccess', _289 => _289.numRecentEvents])) {
+      if (_optionalChain([config, 'optionalAccess', _292 => _292.numRecentEvents])) {
         eventQuery = eventQuery.limit(config.numRecentEvents);
       }
       const storageEvents = await eventQuery.execute();
       const appState = await trx.selectFrom("app_states").selectAll().where("app_name", "=", appName).executeTakeFirst();
       const userState = await trx.selectFrom("user_states").selectAll().where("app_name", "=", appName).where("user_id", "=", userId).executeTakeFirst();
-      const currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _290 => _290.state]), {});
-      const currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _291 => _291.state]), {});
+      const currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _293 => _293.state]), {});
+      const currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _294 => _294.state]), {});
       const sessionState = this.parseJsonSafely(storageSession.state, {});
       const mergedState = this.mergeState(
         currentAppState,
@@ -11392,13 +11443,13 @@ var DatabaseSessionService = (_class34 = class extends BaseSessionService {
       }
       const appState = await trx.selectFrom("app_states").selectAll().where("app_name", "=", session.appName).executeTakeFirst();
       const userState = await trx.selectFrom("user_states").selectAll().where("app_name", "=", session.appName).where("user_id", "=", session.userId).executeTakeFirst();
-      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _292 => _292.state]), {});
-      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _293 => _293.state]), {});
+      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _295 => _295.state]), {});
+      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _296 => _296.state]), {});
       let sessionState = this.parseJsonSafely(storageSession.state, {});
       let appStateDelta = {};
       let userStateDelta = {};
       let sessionStateDelta = {};
-      if (_optionalChain([event, 'access', _294 => _294.actions, 'optionalAccess', _295 => _295.stateDelta])) {
+      if (_optionalChain([event, 'access', _297 => _297.actions, 'optionalAccess', _298 => _298.stateDelta])) {
         const deltas = this.extractStateDelta(event.actions.stateDelta);
         appStateDelta = deltas.appStateDelta;
         userStateDelta = deltas.userStateDelta;
@@ -11544,7 +11595,7 @@ var DatabaseSessionService = (_class34 = class extends BaseSessionService {
    * Overrides the base class method to work with plain object state.
    */
   updateSessionState(session, event) {
-    if (!_optionalChain([event, 'access', _296 => _296.actions, 'optionalAccess', _297 => _297.stateDelta])) {
+    if (!_optionalChain([event, 'access', _299 => _299.actions, 'optionalAccess', _300 => _300.stateDelta])) {
       return;
     }
     for (const [key, value] of Object.entries(event.actions.stateDelta)) {
@@ -11714,7 +11765,7 @@ var GcsArtifactService = class {
       };
       return part;
     } catch (error) {
-      if (_optionalChain([error, 'optionalAccess', _298 => _298.code]) === 404) {
+      if (_optionalChain([error, 'optionalAccess', _301 => _301.code]) === 404) {
         return null;
       }
       throw error;
@@ -11808,6 +11859,1292 @@ __export(flows_exports, {
   removeClientFunctionCallId: () => removeClientFunctionCallId
 });
 
+// src/evaluation/index.ts
+var evaluation_exports = {};
+__export(evaluation_exports, {
+  AgentEvaluator: () => AgentEvaluator,
+  EvalResult: () => EvalResult,
+  EvalStatus: () => EvalStatus,
+  Evaluator: () => Evaluator,
+  FinalResponseMatchV2Evaluator: () => FinalResponseMatchV2Evaluator,
+  LocalEvalService: () => LocalEvalService,
+  PrebuiltMetrics: () => PrebuiltMetrics,
+  RougeEvaluator: () => RougeEvaluator,
+  SafetyEvaluatorV1: () => SafetyEvaluatorV1,
+  TrajectoryEvaluator: () => TrajectoryEvaluator
+});
+
+// src/evaluation/evaluator.ts
+var EvalStatus = /* @__PURE__ */ ((EvalStatus2) => {
+  EvalStatus2[EvalStatus2["PASSED"] = 1] = "PASSED";
+  EvalStatus2[EvalStatus2["FAILED"] = 2] = "FAILED";
+  EvalStatus2[EvalStatus2["NOT_EVALUATED"] = 3] = "NOT_EVALUATED";
+  return EvalStatus2;
+})(EvalStatus || {});
+var Evaluator = class {
+  constructor(metric) {
+    this.metric = metric;
+  }
+  static getMetricInfo(metricName) {
+    throw new Error("getMetricInfo() must be implemented by subclass");
+  }
+};
+
+// src/evaluation/eval-metrics.ts
+var PrebuiltMetrics = /* @__PURE__ */ ((PrebuiltMetrics2) => {
+  PrebuiltMetrics2["TOOL_TRAJECTORY_AVG_SCORE"] = "tool_trajectory_avg_score";
+  PrebuiltMetrics2["RESPONSE_EVALUATION_SCORE"] = "response_evaluation_score";
+  PrebuiltMetrics2["RESPONSE_MATCH_SCORE"] = "response_match_score";
+  PrebuiltMetrics2["SAFETY_V1"] = "safety_v1";
+  PrebuiltMetrics2["FINAL_RESPONSE_MATCH_V2"] = "final_response_match_v2";
+  PrebuiltMetrics2["TOOL_TRAJECTORY_SCORE"] = "tool_trajectory_score";
+  PrebuiltMetrics2["SAFETY"] = "safety";
+  PrebuiltMetrics2["RESPONSE_MATCH"] = "response_match";
+  return PrebuiltMetrics2;
+})(PrebuiltMetrics || {});
+
+// src/evaluation/eval-result.ts
+var EvalResult = class {
+  
+  
+  
+  
+  
+  constructor(init) {
+    this.evalSetResultId = init.evalSetResultId || "";
+    this.evalSetResultName = init.evalSetResultName;
+    this.evalSetId = init.evalSetId || "";
+    this.evalCaseResults = init.evalCaseResults || [];
+    this.creationTimestamp = init.creationTimestamp || Date.now() / 1e3;
+  }
+};
+
+// src/evaluation/agent-evaluator.ts
+
+
+
+// src/evaluation/base-eval-service.ts
+var BaseEvalService = class {
+  async *evaluateSession(session) {
+    const inferenceResults = [];
+    for await (const result of this.performInference({
+      evalSetId: session.evalSetId,
+      evalCases: session.evalCases
+    })) {
+      inferenceResults.push(result);
+    }
+    for await (const result of this.evaluate({
+      inferenceResults,
+      evaluateConfig: session.evaluateConfig
+    })) {
+      yield result;
+    }
+  }
+};
+
+// src/evaluation/vertex-ai-eval-facade.ts
+var ERROR_MESSAGE_SUFFIX = `
+You should specify both project id and location. This metric uses Vertex Gen AI
+Eval SDK, and it requires google cloud credentials.
+
+If using an .env file add the values there, or explicitly set in the code using
+the template below:
+
+process.env.GOOGLE_CLOUD_LOCATION = <LOCATION>
+process.env.GOOGLE_CLOUD_PROJECT = <PROJECT ID>
+`;
+var VertexAiEvalFacade = class _VertexAiEvalFacade {
+  
+  
+  constructor(config) {
+    this.threshold = config.threshold;
+    this.metricName = config.metricName;
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    let totalScore = 0;
+    let numInvocations = 0;
+    const perInvocationResults = [];
+    for (let i = 0; i < actualInvocations.length; i++) {
+      const actual = actualInvocations[i];
+      const expected = expectedInvocations[i];
+      const prompt = this._getText(expected.userContent);
+      const reference = this._getText(expected.finalResponse);
+      const response = this._getText(actual.finalResponse);
+      const evalCase = {
+        prompt,
+        reference,
+        response
+      };
+      try {
+        const evalCaseResult = await _VertexAiEvalFacade._performEval(
+          [evalCase],
+          [this.metricName]
+        );
+        const score = this._getScore(evalCaseResult);
+        perInvocationResults.push({
+          actualInvocation: actual,
+          expectedInvocation: expected,
+          score,
+          evalStatus: this._getEvalStatus(score)
+        });
+        if (score !== null && score !== void 0) {
+          totalScore += score;
+          numInvocations++;
+        }
+      } catch (error) {
+        console.error("Error evaluating invocation:", error);
+        perInvocationResults.push({
+          actualInvocation: actual,
+          expectedInvocation: expected,
+          score: void 0,
+          evalStatus: 3 /* NOT_EVALUATED */
+        });
+      }
+    }
+    if (perInvocationResults.length > 0) {
+      const overallScore = numInvocations > 0 ? totalScore / numInvocations : void 0;
+      return {
+        overallScore,
+        overallEvalStatus: this._getEvalStatus(overallScore),
+        perInvocationResults
+      };
+    }
+    return {
+      overallScore: void 0,
+      overallEvalStatus: 3 /* NOT_EVALUATED */,
+      perInvocationResults: []
+    };
+  }
+  _getText(content) {
+    if (_optionalChain([content, 'optionalAccess', _302 => _302.parts])) {
+      return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join("\n");
+    }
+    return "";
+  }
+  _getScore(evalResult) {
+    if (_optionalChain([evalResult, 'optionalAccess', _303 => _303.summaryMetrics, 'optionalAccess', _304 => _304[0], 'optionalAccess', _305 => _305.meanScore]) !== void 0 && typeof evalResult.summaryMetrics[0].meanScore === "number" && !Number.isNaN(evalResult.summaryMetrics[0].meanScore)) {
+      return evalResult.summaryMetrics[0].meanScore;
+    }
+    return void 0;
+  }
+  _getEvalStatus(score) {
+    if (score !== null && score !== void 0) {
+      return score >= this.threshold ? 1 /* PASSED */ : 2 /* FAILED */;
+    }
+    return 3 /* NOT_EVALUATED */;
+  }
+  static async _performEval(dataset, metrics) {
+    const projectId = process.env.GOOGLE_CLOUD_PROJECT;
+    const location = process.env.GOOGLE_CLOUD_LOCATION;
+    if (!projectId) {
+      throw new Error(`Missing project id. ${ERROR_MESSAGE_SUFFIX}`);
+    }
+    if (!location) {
+      throw new Error(`Missing location. ${ERROR_MESSAGE_SUFFIX}`);
+    }
+    console.warn(
+      "Vertex AI evaluation is not fully implemented. Using mock response."
+    );
+    return {
+      summaryMetrics: [
+        {
+          meanScore: Math.random() * 0.5 + 0.5
+        }
+      ]
+    };
+  }
+};
+
+// src/evaluation/response-evaluator.ts
+var ResponseEvaluator = class extends Evaluator {
+  
+  
+  constructor(evalMetric) {
+    super(evalMetric);
+    if (evalMetric.metricName === "response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */) {
+      this.metricName = "response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */;
+    } else if (evalMetric.metricName === "response_match_score" /* RESPONSE_MATCH_SCORE */) {
+      this.metricName = "response_match_score" /* RESPONSE_MATCH_SCORE */;
+    } else {
+      throw new Error(`Metric ${evalMetric.metricName} is not supported.`);
+    }
+    this.threshold = evalMetric.threshold;
+  }
+  static getMetricInfo(metricName) {
+    if (metricName === "response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */) {
+      return {
+        metricName: "response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */,
+        description: "This metric evaluates how coherent agent's response was. Value range of this metric is [1,5], with values closer to 5 more desirable.",
+        metricValueInfo: {
+          interval: {
+            minValue: 1,
+            maxValue: 5,
+            openAtMin: false,
+            openAtMax: false
+          }
+        }
+      };
+    }
+    if (metricName === "response_match_score" /* RESPONSE_MATCH_SCORE */) {
+      return {
+        metricName: "response_match_score" /* RESPONSE_MATCH_SCORE */,
+        description: "This metric evaluates if agent's final response matches a golden/expected final response using Rouge_1 metric. Value range for this metric is [0,1], with values closer to 1 more desirable.",
+        metricValueInfo: {
+          interval: {
+            minValue: 0,
+            maxValue: 1,
+            openAtMin: false,
+            openAtMax: false
+          }
+        }
+      };
+    }
+    throw new Error(`Metric ${metricName} is not supported.`);
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    if (this.metricName === "response_match_score" /* RESPONSE_MATCH_SCORE */) {
+      return this.evaluateRougeScore(actualInvocations, expectedInvocations);
+    }
+    const vertexAiFacade = new VertexAiEvalFacade({
+      threshold: this.threshold,
+      metricName: this.metricName
+    });
+    return vertexAiFacade.evaluateInvocations(
+      actualInvocations,
+      expectedInvocations
+    );
+  }
+  async evaluateRougeScore(actualInvocations, expectedInvocations) {
+    if (actualInvocations.length !== expectedInvocations.length) {
+      throw new Error("Number of actual and expected invocations must match");
+    }
+    const results = [];
+    for (let i = 0; i < actualInvocations.length; i++) {
+      const actual = actualInvocations[i];
+      const expected = expectedInvocations[i];
+      const result = await this.evaluateInvocation(actual, expected);
+      results.push(result);
+    }
+    const scores = results.map((r) => r.score).filter((s) => s !== void 0);
+    const overallScore = scores.length > 0 ? scores.reduce((a, b) => a + b, 0) / scores.length : void 0;
+    const overallStatus = overallScore !== void 0 && overallScore >= this.threshold ? 1 /* PASSED */ : 2 /* FAILED */;
+    return {
+      overallScore,
+      overallEvalStatus: overallStatus,
+      perInvocationResults: results
+    };
+  }
+  async evaluateInvocation(actual, expected) {
+    if (!actual.finalResponse || !expected.finalResponse) {
+      return {
+        actualInvocation: actual,
+        expectedInvocation: expected,
+        evalStatus: 3 /* NOT_EVALUATED */
+      };
+    }
+    const score = await this.computeRougeScore(
+      actual.finalResponse,
+      expected.finalResponse
+    );
+    return {
+      actualInvocation: actual,
+      expectedInvocation: expected,
+      score,
+      evalStatus: score >= this.threshold ? 1 /* PASSED */ : 2 /* FAILED */
+    };
+  }
+  async computeRougeScore(actual, expected) {
+    const actualText = this.extractText(actual);
+    const expectedText = this.extractText(expected);
+    if (!actualText.trim() || !expectedText.trim()) {
+      return 0;
+    }
+    const actualTokens = this.tokenizeText(actualText);
+    const expectedTokens = this.tokenizeText(expectedText);
+    const actualUnigrams = new Set(actualTokens);
+    const expectedUnigrams = new Set(expectedTokens);
+    const commonUnigrams = new Set(
+      [...actualUnigrams].filter((token) => expectedUnigrams.has(token))
+    );
+    const precision = actualUnigrams.size > 0 ? commonUnigrams.size / actualUnigrams.size : 0;
+    const recall = expectedUnigrams.size > 0 ? commonUnigrams.size / expectedUnigrams.size : 0;
+    const fmeasure = precision + recall > 0 ? 2 * precision * recall / (precision + recall) : 0;
+    return fmeasure;
+  }
+  extractText(content) {
+    if (_optionalChain([content, 'optionalAccess', _306 => _306.parts])) {
+      return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join(" ");
+    }
+    return "";
+  }
+  tokenizeText(text) {
+    return text.toLowerCase().replace(/[^\w\s]/g, " ").split(/\s+/).filter((token) => token.length > 0);
+  }
+};
+
+// src/evaluation/trajectory-evaluator.ts
+var TrajectoryEvaluator = class extends Evaluator {
+  static getMetricInfo() {
+    return {
+      metricName: "tool_trajectory_avg_score" /* TOOL_TRAJECTORY_AVG_SCORE */,
+      description: "This metric compares two tool call trajectories (expected vs. actual) for the same user interaction. It performs an exact match on the tool name and arguments for each step in the trajectory. A score of 1.0 indicates a perfect match, while 0.0 indicates a mismatch. Higher values are better.",
+      metricValueInfo: {
+        interval: {
+          minValue: 0,
+          maxValue: 1,
+          openAtMin: false,
+          openAtMax: false
+        }
+      }
+    };
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    let totalToolUseAccuracy = 0;
+    let numInvocations = 0;
+    const perInvocationResults = [];
+    for (let i = 0; i < actualInvocations.length; i++) {
+      const actual = actualInvocations[i];
+      const expected = expectedInvocations[i];
+      if (!_optionalChain([actual, 'access', _307 => _307.intermediateData, 'optionalAccess', _308 => _308.toolUses]) || !_optionalChain([expected, 'access', _309 => _309.intermediateData, 'optionalAccess', _310 => _310.toolUses])) {
+        perInvocationResults.push({
+          actualInvocation: actual,
+          expectedInvocation: expected,
+          evalStatus: 3 /* NOT_EVALUATED */
+        });
+        continue;
+      }
+      const toolUseAccuracy = this.areToolCallsEqual(
+        actual.intermediateData.toolUses,
+        expected.intermediateData.toolUses
+      ) ? 1 : 0;
+      perInvocationResults.push({
+        actualInvocation: actual,
+        expectedInvocation: expected,
+        score: toolUseAccuracy,
+        evalStatus: toolUseAccuracy >= this.metric.threshold ? 1 /* PASSED */ : 2 /* FAILED */
+      });
+      totalToolUseAccuracy += toolUseAccuracy;
+      numInvocations++;
+    }
+    const overallScore = numInvocations > 0 ? totalToolUseAccuracy / numInvocations : 0;
+    return {
+      overallScore,
+      overallEvalStatus: overallScore >= this.metric.threshold ? 1 /* PASSED */ : 2 /* FAILED */,
+      perInvocationResults
+    };
+  }
+  areToolCallsEqual(actual, expected) {
+    if (actual.length !== expected.length) {
+      return false;
+    }
+    return actual.every((actualCall, index) => {
+      const expectedCall = expected[index];
+      return this.isToolCallEqual(actualCall, expectedCall);
+    });
+  }
+  isToolCallEqual(actual, expected) {
+    if (actual.name !== expected.name) {
+      return false;
+    }
+    const actualArgs = actual.args || {};
+    const expectedArgs = expected.args || {};
+    const actualKeys = Object.keys(actualArgs).sort();
+    const expectedKeys = Object.keys(expectedArgs).sort();
+    if (actualKeys.length !== expectedKeys.length) {
+      return false;
+    }
+    return actualKeys.every((key, index) => {
+      const expectedKey = expectedKeys[index];
+      if (key !== expectedKey) {
+        return false;
+      }
+      return JSON.stringify(actualArgs[key]) === JSON.stringify(expectedArgs[key]);
+    });
+  }
+};
+
+// src/evaluation/safety-evaluator.ts
+var SafetyEvaluatorV1 = class extends Evaluator {
+  static getMetricInfo() {
+    return {
+      metricName: "safety_v1" /* SAFETY_V1 */,
+      description: "This metric evaluates the safety (harmlessness) of an Agent's Response. Value range of the metric is [0, 1], with values closer to 1 to be more desirable (safe).",
+      metricValueInfo: {
+        interval: {
+          minValue: 0,
+          maxValue: 1,
+          openAtMin: false,
+          openAtMax: false
+        }
+      }
+    };
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    const facade = new VertexAiEvalFacade({
+      threshold: this.metric.threshold,
+      metricName: "safety_v1" /* SAFETY_V1 */
+    });
+    return await facade.evaluateInvocations(
+      actualInvocations,
+      expectedInvocations
+    );
+  }
+};
+
+// src/evaluation/llm-as-judge-utils.ts
+function getTextFromContent(content) {
+  if (_optionalChain([content, 'optionalAccess', _311 => _311.parts])) {
+    return content.parts.map((part) => part.text).filter(Boolean).join("\n");
+  }
+  return "";
+}
+function getEvalStatus(score, threshold) {
+  return score >= threshold ? 1 /* PASSED */ : 2 /* FAILED */;
+}
+
+// src/evaluation/llm-as-judge.ts
+var LlmAsJudge = class {
+  async sampleJudge(prompt, numSamples, critiqueParser, judgeModelOptions) {
+    const modelName = _optionalChain([judgeModelOptions, 'optionalAccess', _312 => _312.judgeModel]) || "gemini-2.5-flash";
+    const model = LLMRegistry.getModelOrCreate(modelName);
+    const config = _optionalChain([judgeModelOptions, 'optionalAccess', _313 => _313.judgeModelConfig]) || {};
+    const samples = [];
+    for (let i = 0; i < numSamples; i++) {
+      try {
+        const response = await model.generateContent({
+          prompt,
+          ...config
+        });
+        const label = critiqueParser(response.text);
+        if (label !== "not_found" /* NOT_FOUND */) {
+          samples.push(label);
+        }
+      } catch (error) {
+        console.error("Error sampling judge model:", error);
+      }
+    }
+    return samples;
+  }
+};
+
+// src/evaluation/final-response-match-v2.ts
+var FINAL_RESPONSE_MATCH_V2_PROMPT = `You are an expert rater for an AI agent. The AI agent is going to call an API to answer the user query and generate API tool use code based for the choice of the API and API arguments. The ideal model response should be a function call that fulfills user query, or a natural language response hedges or asks users for further clarification if a function call does not apply.
+The primary focus of this rating task is to check correctness of the model responses.
+
+The data consists of:
+- A user query.
+- A model generated response for the prompt. The responses can consist of:
+  - Natural language, when the model is asking for clarification, or tells the user it does not possess the requested functionality / option.
+  - Code, in the form of one or multiple python function calls, and additional code as needed, for when the model is fulfilling the user request.
+You can use the help from a reference response annotated by a human rater. This reference response is of high quality. You can compare the agent's response with the reference response and decide if the agent's response is valid.
+Note sometimes the reference response only contains the key entities of the correct answer and you need to be flexible to allow the agent response to contain more information than the reference response, or to present the key entities in a different format or structure or in shorter or longer format.
+When the agent response is provided in the form of tables/dataframes or should be best provided in the form of tables/dataframes: focus on the key entities and main components requested in the user query and check whether you can retrieve those from the agent response. Likewise, if you have the reference response, then find out the key entities and main components in them and check whether you can retrieve those from the agent response. If the prompt does not specify any format instructions and the main items/components are included in the response then tolerate the differences in the formatting of those tables/dataframes.
+
+You should follow the constitutions below very carefully to rate the model response:
+- Allow flexibility of format even when reference code only uses one of the possible format, unless API spec or user prompt has explicit format requirement
+  - e.g. For state name, allow both abbreviation and full name unless API spec has explicit requirement. e.g. both 'tx' and 'Texas' should be allowed in the agent response even when reference code only uses one of them.
+  - e.g. If a reference response list outputs in a list format, the agent response is allowed to use sentence format and vice versa unless user prompt explicitly asks for a specific format.
+  - e.g. For numbers, allow flexibility of formatting, e.g. 1000000 vs 1,000,000.
+- The model shouldn't assume that it doesn't have access to according data or incapable of answering the question if reference response is able to find a legit answer.
+- If the model response contains the correct final answer, rate it as valid even when the model response contains more information than the reference response.
+- If the user prompt has csv or other table format data, don't read it yourself. Trust the reference response final answer instead.
+- When the validation needs maths, date calculations, do not use your own calculator. Trust the reference response final answer instead.
+- Be mindful about unit of numbers. For example, if the reference response says 100 miles, but the model response says 100 km, it is invalid.
+- When the agent response or the reference response is provided in the form of tables/dataframes: focus on the key entities and main components requested in the user query and check whether you can retrieve those from the agent response and whether those match the reference response. If the user query does not specify any format instructions and the main items/components are included in the response then tolerate the differences in the formatting of those tables/dataframes.
+- When the answer is in numeric format, check whether there are any format requirements in the numeric format, rounding, precision, number of decimals, etc. specified in the user query and the prompt. If there are no such instructions, then tolerate different numerical formats.
+- When the answer is in numeric format and there are rounding or precision differences between the agent response and the reference response, if no further instructions are provided evaluate if the rounding strategy or precision in the agent response follows the standards for that entity. For instance, model accuracy scores must be reported with at least two decimal places (e.g., 0.798 \u2192 0.80 is acceptable,  but 0.7 is not).
+
+Below are the inputs:
+{{
+  "User prompt": {prompt},
+  "Agent response": {response},
+  "Reference response": {golden_response},
+}}
+
+The answer should be a json alone which follows the json structure below:
+{{
+  "reasoning": [reasoning],
+  "is_the_agent_response_valid": [valid or invalid],
+}}
+Answer with assertiveness:
+`;
+var DEFAULT_NUM_SAMPLES = 5;
+function parseCritique(response) {
+  const labelMatchIsResponseValid = response.match(
+    /"is_the_agent_response_valid":\s*\[*[\n\s]*"*([^"^\]^\s]*)"*[\n\s]*\]*\s*[,\n\}]/
+  );
+  if (_optionalChain([labelMatchIsResponseValid, 'optionalAccess', _314 => _314[1]])) {
+    const label = labelMatchIsResponseValid[1].toLowerCase();
+    return label === "valid" ? "valid" /* VALID */ : "invalid" /* INVALID */;
+  }
+  return "not_found" /* NOT_FOUND */;
+}
+var FinalResponseMatchV2Evaluator = class extends Evaluator {
+  constructor(evalMetric, llmAsJudge = new LlmAsJudge()) {
+    super(evalMetric);
+    this.llmAsJudge = llmAsJudge;
+  }
+  static getMetricInfo() {
+    return {
+      metricName: "final_response_match_v2" /* FINAL_RESPONSE_MATCH_V2 */,
+      description: "This metric evaluates if the agent's final response matches a golden/expected final response using an LLM judge. Value range for this metric is [0,1], with values closer to 1 more desirable.",
+      metricValueInfo: {
+        interval: {
+          minValue: 0,
+          maxValue: 1,
+          openAtMin: false,
+          openAtMax: false
+        }
+      }
+    };
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    const perInvocationResults = [];
+    let totalScore = 0;
+    let numInvocations = 0;
+    if (!actualInvocations.length) {
+      return {
+        overallEvalStatus: 3 /* NOT_EVALUATED */,
+        perInvocationResults: []
+      };
+    }
+    for (let i = 0; i < actualInvocations.length; i++) {
+      const actual = actualInvocations[i];
+      const expected = expectedInvocations[i];
+      const prompt = getTextFromContent(expected.userContent);
+      const response = getTextFromContent(actual.finalResponse);
+      const goldenResponse = getTextFromContent(expected.finalResponse);
+      const formattedPrompt = FINAL_RESPONSE_MATCH_V2_PROMPT.replace(
+        "{prompt}",
+        prompt
+      ).replace("{response}", response).replace("{golden_response}", goldenResponse);
+      const numSamples = _nullishCoalesce(_optionalChain([this, 'access', _315 => _315.metric, 'access', _316 => _316.judgeModelOptions, 'optionalAccess', _317 => _317.numSamples]), () => ( DEFAULT_NUM_SAMPLES));
+      const labels = await this.llmAsJudge.sampleJudge(
+        formattedPrompt,
+        numSamples,
+        parseCritique,
+        this.metric.judgeModelOptions
+      );
+      const score = labels.filter((l) => l === "valid" /* VALID */).length / labels.length;
+      perInvocationResults.push({
+        actualInvocation: actual,
+        expectedInvocation: expected,
+        score,
+        evalStatus: getEvalStatus(score, this.metric.threshold)
+      });
+      totalScore += score;
+      numInvocations++;
+    }
+    const overallScore = totalScore / numInvocations;
+    return {
+      overallScore,
+      overallEvalStatus: getEvalStatus(overallScore, this.metric.threshold),
+      perInvocationResults
+    };
+  }
+};
+
+// src/evaluation/metric-evaluator-registry.ts
+var MetricEvaluatorRegistry = (_class35 = class {constructor() { _class35.prototype.__init61.call(this); }
+  __init61() {this.registry = /* @__PURE__ */ new Map()}
+  getEvaluator(evalMetric) {
+    const entry = this.registry.get(evalMetric.metricName);
+    if (!entry) {
+      throw new Error(`${evalMetric.metricName} not found in registry.`);
+    }
+    return new entry.evaluator(evalMetric);
+  }
+  registerEvaluator(metricInfo, evaluator) {
+    const metricName = metricInfo.metricName;
+    if (this.registry.has(metricName)) {
+      console.info(
+        `Updating Evaluator class for ${metricName} from ${_optionalChain([this, 'access', _318 => _318.registry, 'access', _319 => _319.get, 'call', _320 => _320(metricName), 'optionalAccess', _321 => _321.evaluator, 'access', _322 => _322.name])} to ${evaluator.name}`
+      );
+    }
+    this.registry.set(metricName, {
+      evaluator,
+      metricInfo: { ...metricInfo }
+    });
+  }
+  getRegisteredMetrics() {
+    return Array.from(this.registry.values()).map((entry) => ({
+      ...entry.metricInfo
+    }));
+  }
+}, _class35);
+function getDefaultMetricEvaluatorRegistry() {
+  const registry = new MetricEvaluatorRegistry();
+  registry.registerEvaluator(
+    TrajectoryEvaluator.getMetricInfo(),
+    TrajectoryEvaluator
+  );
+  registry.registerEvaluator(
+    ResponseEvaluator.getMetricInfo("response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */),
+    ResponseEvaluator
+  );
+  registry.registerEvaluator(
+    ResponseEvaluator.getMetricInfo("response_match_score" /* RESPONSE_MATCH_SCORE */),
+    ResponseEvaluator
+  );
+  registry.registerEvaluator(
+    SafetyEvaluatorV1.getMetricInfo(),
+    SafetyEvaluatorV1
+  );
+  registry.registerEvaluator(
+    FinalResponseMatchV2Evaluator.getMetricInfo(),
+    FinalResponseMatchV2Evaluator
+  );
+  return registry;
+}
+var DEFAULT_METRIC_EVALUATOR_REGISTRY = getDefaultMetricEvaluatorRegistry();
+
+// src/evaluation/local-eval-service.ts
+var LocalEvalService = class extends BaseEvalService {
+  constructor(agent, parallelism = 4) {
+    super();
+    this.agent = agent;
+    this.parallelism = parallelism;
+    this.initializeRunner();
+  }
+  
+  async initializeRunner() {
+    if ("ask" in this.agent) {
+      this.runner = this.agent;
+    } else {
+      try {
+        const { runner } = await AgentBuilder.create("eval_agent").withModel("gemini-2.5-flash").withDescription("Agent for evaluation purposes").build();
+        this.runner = {
+          ask: async (message) => {
+            return await runner.ask(message);
+          }
+        };
+      } catch (error) {
+        console.warn(
+          "Failed to create AgentBuilder runner, falling back to mock:",
+          error
+        );
+        this.runner = {
+          ask: async (message) => {
+            return `Mock response to: ${message}`;
+          }
+        };
+      }
+    }
+  }
+  async *performInference(request) {
+    for (const evalSet of request.evalCases) {
+      for (const evalCase of evalSet.evalCases) {
+        const expected = [];
+        for (const convo of evalCase.conversation) {
+          if (convo.finalResponse) {
+            expected.push({
+              invocationId: `${evalCase.evalId}-expected-${expected.length}`,
+              userContent: convo.userContent,
+              finalResponse: convo.finalResponse,
+              intermediateData: convo.intermediateData,
+              creationTimestamp: convo.creationTimestamp
+            });
+          }
+        }
+        const actual = await this.runInference(evalCase);
+        yield [...expected, ...actual];
+      }
+    }
+  }
+  async *evaluate(request) {
+    const { inferenceResults, evaluateConfig } = request;
+    const resultsByCase = /* @__PURE__ */ new Map();
+    for (const result of inferenceResults) {
+      const invocationId = result[0].invocationId;
+      if (!invocationId) continue;
+      const lastHyphenIndex = invocationId.lastIndexOf("-");
+      const evalId = lastHyphenIndex !== -1 ? invocationId.substring(0, lastHyphenIndex) : invocationId;
+      const existing = resultsByCase.get(evalId) || [];
+      resultsByCase.set(evalId, [...existing, ...result]);
+    }
+    for (const [evalId, results] of resultsByCase) {
+      const evalResult = {
+        evalSetResultId: `${evalId}-result-${Date.now()}`,
+        evalSetId: evalId,
+        evalCaseResults: [],
+        creationTimestamp: Date.now()
+      };
+      for (const evalMetric of evaluateConfig.evalMetrics) {
+        const evaluator = DEFAULT_METRIC_EVALUATOR_REGISTRY.getEvaluator(evalMetric);
+        const actual = results.filter(
+          (r) => !_optionalChain([r, 'access', _323 => _323.invocationId, 'optionalAccess', _324 => _324.includes, 'call', _325 => _325("expected")])
+        );
+        const expected = results.filter(
+          (r) => _optionalChain([r, 'access', _326 => _326.invocationId, 'optionalAccess', _327 => _327.includes, 'call', _328 => _328("expected")])
+        );
+        const result = await evaluator.evaluateInvocations(actual, expected);
+        evalResult.evalCaseResults.push({
+          evalSetId: evalId,
+          evalId,
+          finalEvalStatus: result.perInvocationResults.length > 0 ? result.perInvocationResults[0].evalStatus : 3 /* NOT_EVALUATED */,
+          overallEvalMetricResults: [],
+          sessionId: evalId,
+          evalMetricResultPerInvocation: result.perInvocationResults.map(
+            (r) => ({
+              actualInvocation: r.actualInvocation,
+              expectedInvocation: r.expectedInvocation,
+              evalMetricResults: [
+                {
+                  metricName: evalMetric.metricName,
+                  threshold: evalMetric.threshold,
+                  score: r.score,
+                  evalStatus: r.evalStatus
+                }
+              ]
+            })
+          )
+        });
+      }
+      yield evalResult;
+    }
+  }
+  async runInference(evalCase) {
+    const results = [];
+    if (!this.runner) {
+      await this.initializeRunner();
+    }
+    if (evalCase.sessionInput) {
+      try {
+        if (this.runner.initializeSession) {
+          await this.runner.initializeSession(evalCase.sessionInput);
+        } else if (this.runner.setSessionState) {
+          await this.runner.setSessionState(evalCase.sessionInput);
+        } else {
+          console.log(
+            `Session input provided for ${evalCase.evalId}:`,
+            evalCase.sessionInput
+          );
+        }
+      } catch (error) {
+        console.warn(
+          `Failed to initialize session for ${evalCase.evalId}:`,
+          error
+        );
+      }
+    }
+    for (const invocation of evalCase.conversation) {
+      try {
+        const response = await this.runner.ask(invocation.userContent);
+        results.push({
+          invocationId: `${evalCase.evalId}-${results.length}`,
+          userContent: invocation.userContent,
+          finalResponse: {
+            role: "model",
+            parts: [{ text: response || "" }]
+          },
+          intermediateData: {
+            toolUses: [],
+            intermediateResponses: []
+          },
+          creationTimestamp: Date.now()
+        });
+      } catch (error) {
+        console.error(`Error running inference for ${evalCase.evalId}:`, error);
+        results.push({
+          invocationId: `${evalCase.evalId}-${results.length}`,
+          userContent: invocation.userContent,
+          finalResponse: {
+            role: "model",
+            parts: [
+              {
+                text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+              }
+            ]
+          },
+          intermediateData: {
+            toolUses: [],
+            intermediateResponses: []
+          },
+          creationTimestamp: Date.now()
+        });
+      }
+    }
+    return results;
+  }
+};
+
+// src/evaluation/agent-evaluator.ts
+var NUM_RUNS = 2;
+var TOOL_TRAJECTORY_SCORE_KEY = "tool_trajectory_avg_score" /* TOOL_TRAJECTORY_AVG_SCORE */;
+var RESPONSE_EVALUATION_SCORE_KEY = "response_evaluation_score" /* RESPONSE_EVALUATION_SCORE */;
+var RESPONSE_MATCH_SCORE_KEY = "response_match_score" /* RESPONSE_MATCH_SCORE */;
+var SAFETY_V1_KEY = "safety_v1" /* SAFETY_V1 */;
+var ALLOWED_CRITERIA = [
+  TOOL_TRAJECTORY_SCORE_KEY,
+  RESPONSE_EVALUATION_SCORE_KEY,
+  RESPONSE_MATCH_SCORE_KEY,
+  SAFETY_V1_KEY
+];
+var QUERY_COLUMN = "query";
+var REFERENCE_COLUMN = "reference";
+var EXPECTED_TOOL_USE_COLUMN = "expected_tool_use";
+var DEFAULT_CRITERIA = {
+  [TOOL_TRAJECTORY_SCORE_KEY]: 1,
+  [RESPONSE_MATCH_SCORE_KEY]: 0.8
+};
+var loadJson = async (filePath) => {
+  try {
+    const fileContent = await fs2.readFile(filePath, "utf-8");
+    return JSON.parse(fileContent);
+  } catch (error) {
+    throw new Error(`Failed to load JSON from ${filePath}: ${error}`);
+  }
+};
+var AgentEvaluator = class _AgentEvaluator {
+  static async findConfigForTestFile(testFile) {
+    const testFolder = path2.dirname(testFile);
+    const configPath = path2.join(testFolder, "test_config.json");
+    try {
+      await fs2.access(configPath);
+      const configData = await loadJson(configPath);
+      if ("criteria" in configData && typeof configData.criteria === "object") {
+        return configData.criteria;
+      }
+      throw new Error(
+        `Invalid format for test_config.json at ${configPath}. Expected a 'criteria' dictionary.`
+      );
+    } catch (error) {
+      return DEFAULT_CRITERIA;
+    }
+  }
+  static async evaluateEvalSet(agent, evalSet, criteria, numRuns = NUM_RUNS, printDetailedResults = false) {
+    const evalMetrics = Object.entries(criteria).map(
+      ([metricName, threshold]) => ({
+        metricName,
+        threshold
+      })
+    );
+    const evalResultsByEvalId = await _AgentEvaluator._getEvalResultsByEvalId(
+      agent,
+      evalSet,
+      evalMetrics,
+      numRuns
+    );
+    const failures = [];
+    for (const [_, evalResultsPerEvalId] of evalResultsByEvalId) {
+      const evalMetricResults = _AgentEvaluator._getEvalMetricResultsWithInvocation(
+        evalResultsPerEvalId
+      );
+      const failuresPerEvalCase = _AgentEvaluator._processMetricsAndGetFailures(
+        evalMetricResults,
+        printDetailedResults,
+        agent.name || "Unknown Agent"
+      );
+      failures.push(...failuresPerEvalCase);
+    }
+    if (failures.length > 0) {
+      throw new Error(
+        `Following are all the test failures. If you looking to get more details on the failures, then please re-run this test with \`printDetailedResults\` set to \`true\`.
+${failures.join(
+          "\n"
+        )}`
+      );
+    }
+  }
+  static async evaluate(agent, evalDatasetFilePathOrDir, numRuns = NUM_RUNS, initialSessionFile) {
+    const testFiles = [];
+    try {
+      const stat2 = await fs2.stat(evalDatasetFilePathOrDir);
+      if (stat2.isDirectory()) {
+        const files = await this._findTestFilesRecursively(
+          evalDatasetFilePathOrDir
+        );
+        testFiles.push(...files);
+      } else {
+        testFiles.push(evalDatasetFilePathOrDir);
+      }
+    } catch (error) {
+      throw new Error(`Invalid path: ${evalDatasetFilePathOrDir}`);
+    }
+    const initialSession = await _AgentEvaluator._getInitialSession(initialSessionFile);
+    for (const testFile of testFiles) {
+      const criteria = await _AgentEvaluator.findConfigForTestFile(testFile);
+      const evalSet = await _AgentEvaluator._loadEvalSetFromFile(
+        testFile,
+        criteria,
+        initialSession
+      );
+      await _AgentEvaluator.evaluateEvalSet(agent, evalSet, criteria, numRuns);
+    }
+  }
+  static async migrateEvalDataToNewSchema(oldEvalDataFile, newEvalDataFile, initialSessionFile) {
+    if (!oldEvalDataFile || !newEvalDataFile) {
+      throw new Error("One of oldEvalDataFile or newEvalDataFile is empty.");
+    }
+    const criteria = await _AgentEvaluator.findConfigForTestFile(oldEvalDataFile);
+    const initialSession = await _AgentEvaluator._getInitialSession(initialSessionFile);
+    const evalSet = await _AgentEvaluator._getEvalSetFromOldFormat(
+      oldEvalDataFile,
+      criteria,
+      initialSession
+    );
+    await fs2.writeFile(newEvalDataFile, JSON.stringify(evalSet, null, 2));
+  }
+  static async _findTestFilesRecursively(dir) {
+    const testFiles = [];
+    async function walk(currentDir) {
+      const entries = await fs2.readdir(currentDir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path2.join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+          await walk(fullPath);
+        } else if (entry.name.endsWith(".test.json")) {
+          testFiles.push(fullPath);
+        }
+      }
+    }
+    await walk(dir);
+    return testFiles;
+  }
+  static async _loadEvalSetFromFile(evalSetFile, criteria, initialSession) {
+    try {
+      const content = await fs2.readFile(evalSetFile, "utf-8");
+      try {
+        const evalSet = JSON.parse(content);
+        if (evalSet.evalSetId && evalSet.evalCases) {
+          if (Object.keys(initialSession).length > 0) {
+            throw new Error(
+              "Initial session should be specified as a part of EvalSet file. Explicit initial session is only needed, when specifying data in the older schema."
+            );
+          }
+          return evalSet;
+        }
+      } catch (parseError) {
+        throw new Error(`Failed to parse eval set data: ${parseError}`);
+      }
+    } catch (error) {
+      throw new Error(`Failed to process eval set file: ${error}`);
+    }
+    console.warn(
+      `Contents of ${evalSetFile} appear to be in older format. To avoid this warning, please update your test files to contain data in EvalSet schema. You can use 'migrateEvalDataToNewSchema' for migrating your old test files.`
+    );
+    return _AgentEvaluator._getEvalSetFromOldFormat(
+      evalSetFile,
+      criteria,
+      initialSession
+    );
+  }
+  static async _getEvalSetFromOldFormat(evalSetFile, criteria, initialSession) {
+    const data = await _AgentEvaluator._loadDataset(evalSetFile);
+    _AgentEvaluator._validateInput(data, criteria);
+    return {
+      evalSetId: `eval-set-${Date.now()}`,
+      name: evalSetFile,
+      evalCases: data[0].map(
+        (item, index) => ({
+          evalId: `eval-${index}`,
+          conversation: [
+            {
+              invocationId: `invocation-${index}`,
+              userContent: {
+                role: "user",
+                parts: [{ text: item[QUERY_COLUMN] || "" }]
+              },
+              finalResponse: item[REFERENCE_COLUMN] ? {
+                role: "model",
+                parts: [{ text: item[REFERENCE_COLUMN] }]
+              } : void 0,
+              intermediateData: item[EXPECTED_TOOL_USE_COLUMN] ? {
+                toolUses: item[EXPECTED_TOOL_USE_COLUMN],
+                intermediateResponses: []
+              } : void 0,
+              creationTimestamp: Date.now()
+            }
+          ],
+          sessionInput: Object.keys(initialSession).length > 0 ? {
+            appName: "test-app",
+            userId: "test-user",
+            state: initialSession
+          } : void 0
+        })
+      ),
+      creationTimestamp: Date.now()
+    };
+  }
+  static async _getInitialSession(initialSessionFile) {
+    if (!initialSessionFile) {
+      return {};
+    }
+    try {
+      const content = await fs2.readFile(initialSessionFile, "utf-8");
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(
+        `Failed to load initial session from ${initialSessionFile}: ${error}`
+      );
+    }
+  }
+  static async _loadDataset(inputData) {
+    const stat2 = await fs2.stat(inputData);
+    if (stat2.isDirectory()) {
+      const testFiles = await this._findTestFilesRecursively(inputData);
+      const results = await Promise.all(testFiles.map((f) => loadJson(f)));
+      return results.map((r) => Array.isArray(r) ? r : [r]);
+    }
+    if (stat2.isFile()) {
+      const data = await loadJson(inputData);
+      return [Array.isArray(data) ? data : [data]];
+    }
+    throw new Error(`Invalid input path: ${inputData}`);
+  }
+  static _validateInput(evalDataset, criteria) {
+    if (!evalDataset || evalDataset.length === 0) {
+      throw new Error("The evaluation dataset is None or empty.");
+    }
+    for (const key of Object.keys(criteria)) {
+      if (!ALLOWED_CRITERIA.includes(key)) {
+        throw new Error(
+          `Invalid criteria key: ${key}. Expected one of ${ALLOWED_CRITERIA.join(
+            ", "
+          )}.`
+        );
+      }
+    }
+    const sample = evalDataset[0];
+    if (!Array.isArray(sample) || sample.length === 0) {
+      throw new Error("The evaluation dataset is empty.");
+    }
+    const firstQuery = sample[0];
+    if (typeof firstQuery !== "object") {
+      throw new Error(
+        `Each evaluation dataset sample must be list of dictionary. But it's ${JSON.stringify(
+          evalDataset
+        )}`
+      );
+    }
+    if (TOOL_TRAJECTORY_SCORE_KEY in criteria) {
+      if (!(QUERY_COLUMN in firstQuery) || !(EXPECTED_TOOL_USE_COLUMN in firstQuery)) {
+        throw new Error(
+          `Samples for ${TOOL_TRAJECTORY_SCORE_KEY} must include '${QUERY_COLUMN}' and '${EXPECTED_TOOL_USE_COLUMN}' keys. The sample is ${JSON.stringify(sample)}.`
+        );
+      }
+    }
+    if (RESPONSE_EVALUATION_SCORE_KEY in criteria) {
+      if (!(QUERY_COLUMN in firstQuery)) {
+        throw new Error(
+          `Samples for ${RESPONSE_EVALUATION_SCORE_KEY} must include '${QUERY_COLUMN}' key. The sample is ${JSON.stringify(sample)}.`
+        );
+      }
+    }
+    if (RESPONSE_MATCH_SCORE_KEY in criteria) {
+      if (!(QUERY_COLUMN in firstQuery) || !(REFERENCE_COLUMN in firstQuery)) {
+        throw new Error(
+          `Samples for ${RESPONSE_MATCH_SCORE_KEY} must include '${QUERY_COLUMN}' and '${REFERENCE_COLUMN}' keys. The sample is ${JSON.stringify(sample)}.`
+        );
+      }
+    }
+  }
+  static _printDetails(evalMetricResultWithInvocations, overallEvalStatus, overallScore, metricName = "", threshold = 0) {
+    console.log(
+      `Summary: \`${overallEvalStatus}\` for Metric: \`${metricName}\`. Expected threshold: \`${threshold}\`, actual value: \`${overallScore}\`.`
+    );
+    const data = evalMetricResultWithInvocations.map((per) => ({
+      evalStatus: per.evalMetricResult.evalStatus,
+      score: per.evalMetricResult.score,
+      threshold,
+      prompt: _AgentEvaluator._convertContentToText(
+        per.expectedInvocation.userContent
+      ),
+      expectedResponse: _AgentEvaluator._convertContentToText(
+        per.expectedInvocation.finalResponse
+      ),
+      actualResponse: _AgentEvaluator._convertContentToText(
+        per.actualInvocation.finalResponse
+      ),
+      expectedToolCalls: _AgentEvaluator._convertToolCallsToText(
+        per.expectedInvocation.intermediateData
+      ),
+      actualToolCalls: _AgentEvaluator._convertToolCallsToText(
+        per.actualInvocation.intermediateData
+      )
+    }));
+    console.table(data);
+    console.log("\n\n");
+  }
+  static _convertContentToText(content) {
+    if (_optionalChain([content, 'optionalAccess', _329 => _329.parts])) {
+      return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join("\n");
+    }
+    return "";
+  }
+  static _convertToolCallsToText(intermediateData) {
+    if (_optionalChain([intermediateData, 'optionalAccess', _330 => _330.toolUses])) {
+      return intermediateData.toolUses.map((t) => JSON.stringify(t)).join("\n");
+    }
+    return "";
+  }
+  static async _getEvalResultsByEvalId(agent, evalSet, evalMetrics, numRuns) {
+    const evalService = new LocalEvalService(agent);
+    const inferenceResults = [];
+    for (let run = 0; run < numRuns; run++) {
+      for await (const result of evalService.performInference({
+        evalSetId: evalSet.evalSetId,
+        evalCases: [evalSet]
+      })) {
+        inferenceResults.push(result);
+      }
+    }
+    const evalResultsByEvalId = /* @__PURE__ */ new Map();
+    for await (const evalResult of evalService.evaluate({
+      inferenceResults,
+      evaluateConfig: { evalMetrics }
+    })) {
+      for (const caseResult of evalResult.evalCaseResults) {
+        const evalId = caseResult.evalId;
+        if (!evalResultsByEvalId.has(evalId)) {
+          evalResultsByEvalId.set(evalId, []);
+        }
+        evalResultsByEvalId.get(evalId).push(caseResult);
+      }
+    }
+    return evalResultsByEvalId;
+  }
+  static _getEvalMetricResultsWithInvocation(evalResultsPerEvalId) {
+    const evalMetricResults = {};
+    for (const evalCaseResult of evalResultsPerEvalId) {
+      for (const evalMetricsPerInvocation of evalCaseResult.evalMetricResultPerInvocation) {
+        for (const evalMetricResult of evalMetricsPerInvocation.evalMetricResults) {
+          const metricName = evalMetricResult.metricName;
+          if (!(metricName in evalMetricResults)) {
+            evalMetricResults[metricName] = [];
+          }
+          evalMetricResults[metricName].push({
+            actualInvocation: evalMetricsPerInvocation.actualInvocation,
+            expectedInvocation: evalMetricsPerInvocation.expectedInvocation,
+            evalMetricResult
+          });
+        }
+      }
+    }
+    return evalMetricResults;
+  }
+  static _processMetricsAndGetFailures(evalMetricResults, printDetailedResults, agentModule) {
+    const failures = [];
+    for (const [metricName, evalMetricResultsWithInvocations] of Object.entries(
+      evalMetricResults
+    )) {
+      const threshold = _optionalChain([evalMetricResultsWithInvocations, 'access', _331 => _331[0], 'optionalAccess', _332 => _332.evalMetricResult, 'access', _333 => _333.threshold]) || 0;
+      const scores = evalMetricResultsWithInvocations.map((m) => m.evalMetricResult.score).filter((s) => s !== void 0);
+      let overallScore;
+      let overallEvalStatus;
+      if (scores.length > 0) {
+        overallScore = scores.reduce((a, b) => a + b, 0) / scores.length;
+        overallEvalStatus = overallScore >= threshold ? 1 /* PASSED */ : 2 /* FAILED */;
+      } else {
+        overallScore = void 0;
+        overallEvalStatus = 3 /* NOT_EVALUATED */;
+      }
+      if (overallEvalStatus !== 1 /* PASSED */) {
+        if (printDetailedResults) {
+          _AgentEvaluator._printDetails(
+            evalMetricResultsWithInvocations,
+            overallEvalStatus,
+            overallScore,
+            metricName,
+            threshold
+          );
+        }
+        failures.push(
+          `${metricName} for ${agentModule} Failed. Expected ${threshold}, but got ${overallScore}.`
+        );
+      }
+    }
+    return failures;
+  }
+};
+
+// src/evaluation/final-response-match-v1.ts
+var RougeEvaluator = class extends Evaluator {
+  
+  constructor(evalMetric) {
+    super(evalMetric);
+    this.evalMetric = evalMetric;
+  }
+  static getMetricInfo() {
+    return {
+      metricName: "response_match_score" /* RESPONSE_MATCH_SCORE */,
+      description: "This metric evaluates if the agent's final response matches a golden/expected final response using Rouge_1 metric. Value range for this metric is [0,1], with values closer to 1 more desirable.",
+      metricValueInfo: {
+        interval: {
+          minValue: 0,
+          maxValue: 1,
+          openAtMin: false,
+          openAtMax: false
+        }
+      }
+    };
+  }
+  async evaluateInvocations(actualInvocations, expectedInvocations) {
+    let totalScore = 0;
+    let numInvocations = 0;
+    const perInvocationResults = [];
+    for (let i = 0; i < actualInvocations.length; i++) {
+      const actual = actualInvocations[i];
+      const expected = expectedInvocations[i];
+      const reference = getTextFromContent2(expected.finalResponse);
+      const response = getTextFromContent2(actual.finalResponse);
+      const rouge1Scores = await calculateRouge1Scores(response, reference);
+      const score = rouge1Scores.fmeasure;
+      perInvocationResults.push({
+        actualInvocation: actual,
+        expectedInvocation: expected,
+        score,
+        evalStatus: getEvalStatus2(score, this.evalMetric.threshold)
+      });
+      totalScore += score;
+      numInvocations++;
+    }
+    if (perInvocationResults.length > 0) {
+      const overallScore = totalScore / numInvocations;
+      return {
+        overallScore,
+        overallEvalStatus: getEvalStatus2(
+          overallScore,
+          this.evalMetric.threshold
+        ),
+        perInvocationResults
+      };
+    }
+    return {
+      overallEvalStatus: 3 /* NOT_EVALUATED */,
+      perInvocationResults: []
+    };
+  }
+};
+function getTextFromContent2(content) {
+  if (_optionalChain([content, 'optionalAccess', _334 => _334.parts])) {
+    return content.parts.map((part) => part.text).filter(Boolean).join("\n");
+  }
+  return "";
+}
+function getEvalStatus2(score, threshold) {
+  return score >= threshold ? 1 /* PASSED */ : 2 /* FAILED */;
+}
+function calculateRouge1Scores(response, reference) {
+  if (!response.trim() || !reference.trim()) {
+    return { precision: 0, recall: 0, fmeasure: 0 };
+  }
+  const responseTokens = tokenizeText(response);
+  const referenceTokens = tokenizeText(reference);
+  const responseUnigrams = new Set(responseTokens);
+  const referenceUnigrams = new Set(referenceTokens);
+  const commonUnigrams = new Set(
+    [...responseUnigrams].filter((token) => referenceUnigrams.has(token))
+  );
+  const precision = responseUnigrams.size > 0 ? commonUnigrams.size / responseUnigrams.size : 0;
+  const recall = referenceUnigrams.size > 0 ? commonUnigrams.size / referenceUnigrams.size : 0;
+  const fmeasure = precision + recall > 0 ? 2 * precision * recall / (precision + recall) : 0;
+  return { precision, recall, fmeasure };
+}
+function tokenizeText(text) {
+  return text.toLowerCase().replace(/[^\w\s]/g, " ").split(/\s+/).filter((token) => token.length > 0);
+}
+
 // src/version.ts
 var VERSION = "0.1.0";
 
@@ -11961,4 +13298,15 @@ var VERSION = "0.1.0";
 
 
 
-exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.AgentTool = AgentTool; exports.Agents = agents_exports; exports.AiSdkLlm = AiSdkLlm; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseCodeExecutor = BaseCodeExecutor; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInCodeExecutor = BuiltInCodeExecutor; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.CodeExecutionUtils = CodeExecutionUtils; exports.CodeExecutorContext = CodeExecutorContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LoopAgent = LoopAgent; exports.McpAbi = McpAbi; exports.McpAtp = McpAtp; exports.McpBamm = McpBamm; exports.McpCoinGecko = McpCoinGecko; exports.McpDiscord = McpDiscord; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpFilesystem = McpFilesystem; exports.McpFraxlend = McpFraxlend; exports.McpGeneric = McpGeneric; exports.McpIqWiki = McpIqWiki; exports.McpMemory = McpMemory; exports.McpNearAgent = McpNearAgent; exports.McpNearIntents = McpNearIntents; exports.McpOdos = McpOdos; exports.McpSamplingHandler = McpSamplingHandler; exports.McpTelegram = McpTelegram; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports._findFunctionCallEventIfLastEventIsFunctionResponse = _findFunctionCallEventIfLastEventIsFunctionResponse; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor2; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor3; exports.codeExecutionResponseProcessor = responseProcessor; exports.contentRequestProcessor = requestProcessor4; exports.createAuthToolArguments = createAuthToolArguments; exports.createBranchContextForSubAgent = createBranchContextForSubAgent; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.createTool = createTool; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor5; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor6; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeAgentRun = mergeAgentRun; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor7; exports.nlPlanningResponseProcessor = responseProcessor2; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;
+
+
+
+
+
+
+
+
+
+
+
+exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.AgentEvaluator = AgentEvaluator; exports.AgentTool = AgentTool; exports.Agents = agents_exports; exports.AiSdkLlm = AiSdkLlm; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseCodeExecutor = BaseCodeExecutor; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInCodeExecutor = BuiltInCodeExecutor; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.CodeExecutionUtils = CodeExecutionUtils; exports.CodeExecutorContext = CodeExecutorContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.EvalResult = EvalResult; exports.EvalStatus = EvalStatus; exports.Evaluation = evaluation_exports; exports.Evaluator = Evaluator; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.FinalResponseMatchV2Evaluator = FinalResponseMatchV2Evaluator; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LocalEvalService = LocalEvalService; exports.LoopAgent = LoopAgent; exports.McpAbi = McpAbi; exports.McpAtp = McpAtp; exports.McpBamm = McpBamm; exports.McpCoinGecko = McpCoinGecko; exports.McpDiscord = McpDiscord; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpFilesystem = McpFilesystem; exports.McpFraxlend = McpFraxlend; exports.McpGeneric = McpGeneric; exports.McpIqWiki = McpIqWiki; exports.McpMemory = McpMemory; exports.McpNearAgent = McpNearAgent; exports.McpNearIntents = McpNearIntents; exports.McpOdos = McpOdos; exports.McpSamplingHandler = McpSamplingHandler; exports.McpTelegram = McpTelegram; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.PrebuiltMetrics = PrebuiltMetrics; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RougeEvaluator = RougeEvaluator; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SafetyEvaluatorV1 = SafetyEvaluatorV1; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TrajectoryEvaluator = TrajectoryEvaluator; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports._findFunctionCallEventIfLastEventIsFunctionResponse = _findFunctionCallEventIfLastEventIsFunctionResponse; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor2; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor3; exports.codeExecutionResponseProcessor = responseProcessor; exports.contentRequestProcessor = requestProcessor4; exports.createAuthToolArguments = createAuthToolArguments; exports.createBranchContextForSubAgent = createBranchContextForSubAgent; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.createTool = createTool; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor5; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor6; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeAgentRun = mergeAgentRun; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor7; exports.nlPlanningResponseProcessor = responseProcessor2; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;