@iqai/adk 0.5.0 → 0.5.3

package/dist/index.js

@@ -3389,6 +3389,15 @@ var EventActions = (_class10 = class {
    * Requested authentication configurations.
    */
   
+  /**
+   * Event compaction information. When set, this event represents
+   * a compaction of events within the specified timestamp range.
+   */
+  
+  /**
+   * The invocation id to rewind to. This is only set for rewind event.
+   */
+  
   /**
    * Constructor for EventActions
    */
@@ -3399,6 +3408,8 @@ var EventActions = (_class10 = class {
     this.transferToAgent = options.transferToAgent;
     this.escalate = options.escalate;
     this.requestedAuthConfigs = options.requestedAuthConfigs;
+    this.compaction = options.compaction;
+    this.rewindBeforeInvocationId = options.rewindBeforeInvocationId;
   }
 }, _class10);
 
@@ -3941,9 +3952,196 @@ init_logger();
 var events_exports = {};
 __export(events_exports, {
   Event: () => Event,
-  EventActions: () => EventActions
+  EventActions: () => EventActions,
+  LlmEventSummarizer: () => LlmEventSummarizer,
+  runCompactionForSlidingWindow: () => runCompactionForSlidingWindow
 });
 
+// src/events/llm-event-summarizer.ts
+var DEFAULT_SUMMARIZATION_PROMPT = `You are a helpful assistant tasked with summarizing a conversation history.
+Please provide a concise summary of the following events, capturing the key information and context.
+Focus on the main topics discussed, important decisions made, and any action items or results.
+
+Events to summarize:
+{events}
+
+Provide your summary in a clear, concise format.`;
+var LlmEventSummarizer = class {
+  
+  
+  /**
+   * Creates a new LLM event summarizer.
+   * @param model - The LLM model to use for summarization
+   * @param prompt - Optional custom prompt template. Use {events} as placeholder for event content.
+   */
+  constructor(model, prompt) {
+    this.model = model;
+    this.prompt = prompt || DEFAULT_SUMMARIZATION_PROMPT;
+  }
+  /**
+   * Summarizes events using the configured LLM.
+   */
+  async maybeSummarizeEvents(events) {
+    if (!events || events.length === 0) {
+      return void 0;
+    }
+    const eventsText = this.formatEventsForSummarization(events);
+    const promptWithEvents = this.prompt.replace("{events}", eventsText);
+    const llmRequest = new LlmRequest({
+      contents: [
+        {
+          role: "user",
+          parts: [{ text: promptWithEvents }]
+        }
+      ]
+    });
+    let summaryText = "";
+    for await (const response of this.model.generateContentAsync(llmRequest)) {
+      summaryText += _optionalChain([response, 'access', _143 => _143.content, 'optionalAccess', _144 => _144.parts, 'optionalAccess', _145 => _145.map, 'call', _146 => _146((part) => part.text || ""), 'access', _147 => _147.join, 'call', _148 => _148("")]);
+    }
+    summaryText = summaryText.trim();
+    if (!summaryText) {
+      return void 0;
+    }
+    const summaryContent = {
+      role: "model",
+      parts: [{ text: summaryText }]
+    };
+    const compactionEvent = new Event({
+      invocationId: Event.newId(),
+      author: "user",
+      actions: new EventActions({
+        compaction: {
+          startTimestamp: events[0].timestamp,
+          endTimestamp: events[events.length - 1].timestamp,
+          compactedContent: summaryContent
+        }
+      })
+    });
+    return compactionEvent;
+  }
+  /**
+   * Formats events into a readable text format for summarization.
+   */
+  formatEventsForSummarization(events) {
+    const lines = [];
+    for (const event of events) {
+      const timestamp = new Date(event.timestamp * 1e3).toISOString();
+      const author = event.author;
+      if (_optionalChain([event, 'access', _149 => _149.content, 'optionalAccess', _150 => _150.parts])) {
+        for (const part of event.content.parts) {
+          if (part.text) {
+            lines.push(`[${timestamp}] ${author}: ${part.text}`);
+          } else if (part.functionCall) {
+            lines.push(
+              `[${timestamp}] ${author}: Called tool '${part.functionCall.name}' with args ${JSON.stringify(part.functionCall.args)}`
+            );
+          } else if (part.functionResponse) {
+            lines.push(
+              `[${timestamp}] ${author}: Tool '${part.functionResponse.name}' returned: ${JSON.stringify(part.functionResponse.response)}`
+            );
+          }
+        }
+      }
+    }
+    return lines.join("\n");
+  }
+};
+
+// src/events/compaction.ts
+init_logger();
+var logger = new Logger({ name: "EventCompaction" });
+async function runCompactionForSlidingWindow(config, session, sessionService, summarizer) {
+  if (!session.events || session.events.length === 0) {
+    return;
+  }
+  const lastCompactedEndTimestamp = findLastCompactedEndTimestamp(
+    session.events
+  );
+  const latestTimestampByInvocation = buildLatestTimestampByInvocation(
+    session.events
+  );
+  const uniqueInvocationIds = Array.from(latestTimestampByInvocation.keys());
+  const newInvocationIds = uniqueInvocationIds.filter(
+    (invId) => (latestTimestampByInvocation.get(invId) || 0) > lastCompactedEndTimestamp
+  );
+  if (newInvocationIds.length < config.compactionInterval) {
+    logger.debug(
+      `Not enough new invocations for compaction. Need ${config.compactionInterval}, have ${newInvocationIds.length}`
+    );
+    return;
+  }
+  const endInvId = newInvocationIds[newInvocationIds.length - 1];
+  const firstNewInvId = newInvocationIds[0];
+  const firstNewInvIdx = uniqueInvocationIds.indexOf(firstNewInvId);
+  const startIdx = Math.max(0, firstNewInvIdx - config.overlapSize);
+  const startInvId = uniqueInvocationIds[startIdx];
+  logger.debug(
+    `Compacting invocations from ${startInvId} to ${endInvId} (${newInvocationIds.length} new invocations, overlap: ${config.overlapSize})`
+  );
+  const eventsToCompact = sliceEventsByInvocationRange(
+    session.events,
+    startInvId,
+    endInvId
+  );
+  if (eventsToCompact.length === 0) {
+    logger.debug("No events to compact after filtering");
+    return;
+  }
+  logger.debug(`Summarizing ${eventsToCompact.length} events`);
+  const compactionEvent = await summarizer.maybeSummarizeEvents(eventsToCompact);
+  if (compactionEvent) {
+    logger.debug(
+      `Compaction created covering timestamps ${_optionalChain([compactionEvent, 'access', _151 => _151.actions, 'access', _152 => _152.compaction, 'optionalAccess', _153 => _153.startTimestamp])} to ${_optionalChain([compactionEvent, 'access', _154 => _154.actions, 'access', _155 => _155.compaction, 'optionalAccess', _156 => _156.endTimestamp])}`
+    );
+    await sessionService.appendEvent(session, compactionEvent);
+  }
+}
+function findLastCompactedEndTimestamp(events) {
+  for (let i = events.length - 1; i >= 0; i--) {
+    const event = events[i];
+    if (_optionalChain([event, 'access', _157 => _157.actions, 'optionalAccess', _158 => _158.compaction])) {
+      return event.actions.compaction.endTimestamp;
+    }
+  }
+  return 0;
+}
+function buildLatestTimestampByInvocation(events) {
+  const latestByInvocation = /* @__PURE__ */ new Map();
+  for (const event of events) {
+    if (_optionalChain([event, 'access', _159 => _159.actions, 'optionalAccess', _160 => _160.compaction])) {
+      continue;
+    }
+    const invId = event.invocationId;
+    if (!invId) {
+      continue;
+    }
+    const current = latestByInvocation.get(invId) || 0;
+    if (event.timestamp > current) {
+      latestByInvocation.set(invId, event.timestamp);
+    }
+  }
+  return latestByInvocation;
+}
+function sliceEventsByInvocationRange(events, startInvId, endInvId) {
+  let firstIndex = -1;
+  let lastIndex = -1;
+  for (let i = 0; i < events.length; i++) {
+    const event = events[i];
+    if (event.invocationId === startInvId && firstIndex === -1) {
+      firstIndex = i;
+    }
+    if (event.invocationId === endInvId) {
+      lastIndex = i;
+    }
+  }
+  if (firstIndex === -1 || lastIndex === -1 || firstIndex > lastIndex) {
+    return [];
+  }
+  const slicedEvents = events.slice(firstIndex, lastIndex + 1);
+  return slicedEvents.filter((event) => !_optionalChain([event, 'access', _161 => _161.actions, 'optionalAccess', _162 => _162.compaction]));
+}
+
 // src/flows/llm-flows/base-llm-flow.ts
 init_logger();
 
@@ -4454,7 +4652,7 @@ var AgentTool = (_class15 = class extends BaseTool {
       } catch (e3) {
         toolResult = mergedText;
       }
-      if (this.outputKey && _optionalChain([context4, 'optionalAccess', _143 => _143.state])) {
+      if (this.outputKey && _optionalChain([context4, 'optionalAccess', _163 => _163.state])) {
         context4.state[this.outputKey] = toolResult;
       }
       return toolResult;
@@ -4721,7 +4919,7 @@ var FileOperationsTool = class extends BaseTool {
       name: "file_operations",
       description: "Perform file system operations like reading, writing, and managing files"
     });
-    this.basePath = _optionalChain([options, 'optionalAccess', _144 => _144.basePath]) || process.cwd();
+    this.basePath = _optionalChain([options, 'optionalAccess', _164 => _164.basePath]) || process.cwd();
   }
   /**
    * Get the function declaration for the tool
@@ -5204,7 +5402,7 @@ var LoadMemoryTool = (_class20 = class extends BaseTool {
       const searchResult = await context4.searchMemory(args.query);
       return {
         memories: searchResult.memories || [],
-        count: _optionalChain([searchResult, 'access', _145 => _145.memories, 'optionalAccess', _146 => _146.length]) || 0
+        count: _optionalChain([searchResult, 'access', _165 => _165.memories, 'optionalAccess', _166 => _166.length]) || 0
       };
     } catch (error) {
       console.error("Error searching memory:", error);
@@ -5761,7 +5959,7 @@ var McpClientService = (_class22 = class {
         },
         this,
         async (instance) => await instance.reinitialize(),
-        _optionalChain([this, 'access', _147 => _147.config, 'access', _148 => _148.retryOptions, 'optionalAccess', _149 => _149.maxRetries]) || 2
+        _optionalChain([this, 'access', _167 => _167.config, 'access', _168 => _168.retryOptions, 'optionalAccess', _169 => _169.maxRetries]) || 2
       );
       return await wrappedCall();
     } catch (error) {
@@ -5845,7 +6043,7 @@ var McpClientService = (_class22 = class {
     this.mcpSamplingHandler = null;
     if (this.client) {
       try {
-        _optionalChain([this, 'access', _150 => _150.client, 'access', _151 => _151.removeRequestHandler, 'optionalCall', _152 => _152("sampling/createMessage")]);
+        _optionalChain([this, 'access', _170 => _170.client, 'access', _171 => _171.removeRequestHandler, 'optionalCall', _172 => _172("sampling/createMessage")]);
       } catch (error) {
         this.logger.error("Failed to remove sampling handler:", error);
       }
@@ -6381,7 +6579,7 @@ var McpToolset = (_class24 = class {
           "resource_closed_error" /* RESOURCE_CLOSED_ERROR */
         );
       }
-      if (this.tools.length > 0 && !_optionalChain([this, 'access', _153 => _153.config, 'access', _154 => _154.cacheConfig, 'optionalAccess', _155 => _155.enabled]) === false) {
+      if (this.tools.length > 0 && !_optionalChain([this, 'access', _173 => _173.config, 'access', _174 => _174.cacheConfig, 'optionalAccess', _175 => _175.enabled]) === false) {
         return this.tools;
       }
       if (!this.clientService) {
@@ -6410,7 +6608,7 @@ var McpToolset = (_class24 = class {
           }
         }
       }
-      if (_optionalChain([this, 'access', _156 => _156.config, 'access', _157 => _157.cacheConfig, 'optionalAccess', _158 => _158.enabled]) !== false) {
+      if (_optionalChain([this, 'access', _176 => _176.config, 'access', _177 => _177.cacheConfig, 'optionalAccess', _178 => _178.enabled]) !== false) {
         this.tools = tools;
       }
       return tools;
@@ -6499,12 +6697,12 @@ function populateClientFunctionCallId(modelResponseEvent) {
   }
 }
 function removeClientFunctionCallId(content) {
-  if (_optionalChain([content, 'optionalAccess', _159 => _159.parts])) {
+  if (_optionalChain([content, 'optionalAccess', _179 => _179.parts])) {
     for (const part of content.parts) {
-      if (_optionalChain([part, 'access', _160 => _160.functionCall, 'optionalAccess', _161 => _161.id, 'optionalAccess', _162 => _162.startsWith, 'call', _163 => _163(AF_FUNCTION_CALL_ID_PREFIX)])) {
+      if (_optionalChain([part, 'access', _180 => _180.functionCall, 'optionalAccess', _181 => _181.id, 'optionalAccess', _182 => _182.startsWith, 'call', _183 => _183(AF_FUNCTION_CALL_ID_PREFIX)])) {
         part.functionCall.id = void 0;
       }
-      if (_optionalChain([part, 'access', _164 => _164.functionResponse, 'optionalAccess', _165 => _165.id, 'optionalAccess', _166 => _166.startsWith, 'call', _167 => _167(AF_FUNCTION_CALL_ID_PREFIX)])) {
+      if (_optionalChain([part, 'access', _184 => _184.functionResponse, 'optionalAccess', _185 => _185.id, 'optionalAccess', _186 => _186.startsWith, 'call', _187 => _187(AF_FUNCTION_CALL_ID_PREFIX)])) {
         part.functionResponse.id = void 0;
       }
     }
@@ -6699,7 +6897,7 @@ function mergeParallelFunctionResponseEvents(functionResponseEvents) {
   }
   const mergedParts = [];
   for (const event of functionResponseEvents) {
-    if (_optionalChain([event, 'access', _168 => _168.content, 'optionalAccess', _169 => _169.parts])) {
+    if (_optionalChain([event, 'access', _188 => _188.content, 'optionalAccess', _189 => _189.parts])) {
       for (const part of event.content.parts) {
         mergedParts.push(part);
       }
@@ -6820,7 +7018,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
       const seen = /* @__PURE__ */ new Set();
       const filtered = [];
       for (const t of tools) {
-        const name = _optionalChain([t, 'optionalAccess', _170 => _170.name]);
+        const name = _optionalChain([t, 'optionalAccess', _190 => _190.name]);
         if (!name) continue;
         if (seen.has(name)) {
           continue;
@@ -6837,7 +7035,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', _171 => _171.description, 'optionalAccess', _172 => _172.substring, 'call', _173 => _173(0, 50)]) + (_optionalChain([tool, 'access', _174 => _174.description, 'optionalAccess', _175 => _175.length]) > 50 ? "..." : ""),
+        Description: _optionalChain([tool, 'access', _191 => _191.description, 'optionalAccess', _192 => _192.substring, 'call', _193 => _193(0, 50)]) + (_optionalChain([tool, 'access', _194 => _194.description, 'optionalAccess', _195 => _195.length]) > 50 ? "..." : ""),
         "Long Running": tool.isLongRunning ? "Yes" : "No"
       }));
       this.logger.debugArray("\u{1F6E0}\uFE0F Available Tools", toolsData);
@@ -6900,14 +7098,14 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
       );
       if (functionResponseEvent) {
         yield functionResponseEvent;
-        const transferToAgent = _optionalChain([functionResponseEvent, 'access', _176 => _176.actions, 'optionalAccess', _177 => _177.transferToAgent]);
+        const transferToAgent = _optionalChain([functionResponseEvent, 'access', _196 => _196.actions, 'optionalAccess', _197 => _197.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', _178 => _178.runLive, 'optionalCall', _179 => _179(invocationContext)]) || agentToRun.runAsync(invocationContext)) {
+          for await (const event of _optionalChain([agentToRun, 'access', _198 => _198.runLive, 'optionalCall', _199 => _199(invocationContext)]) || agentToRun.runAsync(invocationContext)) {
             yield event;
           }
         }
@@ -6939,7 +7137,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         yield authEvent;
       }
       yield functionResponseEvent;
-      const transferToAgent = _optionalChain([functionResponseEvent, 'access', _180 => _180.actions, 'optionalAccess', _181 => _181.transferToAgent]);
+      const transferToAgent = _optionalChain([functionResponseEvent, 'access', _200 => _200.actions, 'optionalAccess', _201 => _201.transferToAgent]);
       if (transferToAgent) {
         this.logger.debug(`\u{1F504} Transferring to agent '${transferToAgent}'`);
         const agentToRun = this._getAgentToRun(
@@ -6985,7 +7183,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
     }
     invocationContext.incrementLlmCallCount();
     const isStreaming = invocationContext.runConfig.streamingMode === "sse" /* SSE */;
-    let tools = _optionalChain([llmRequest, 'access', _182 => _182.config, 'optionalAccess', _183 => _183.tools]) || [];
+    let tools = _optionalChain([llmRequest, 'access', _202 => _202.config, 'optionalAccess', _203 => _203.tools]) || [];
     if (tools.length) {
       const deduped = [];
       const seenFn = /* @__PURE__ */ new Set();
@@ -6994,7 +7192,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         if (tool && Array.isArray(tool.functionDeclarations)) {
           const newFds = tool.functionDeclarations.filter(
             (fd) => {
-              if (_optionalChain([fd, 'optionalAccess', _184 => _184.name])) {
+              if (_optionalChain([fd, 'optionalAccess', _204 => _204.name])) {
                 if (seenFn.has(fd.name)) {
                   return false;
                 }
@@ -7006,7 +7204,7 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
           if (newFds.length) {
             deduped.push({ ...tool, functionDeclarations: newFds });
           }
-        } else if (_optionalChain([tool, 'optionalAccess', _185 => _185.name])) {
+        } else if (_optionalChain([tool, 'optionalAccess', _205 => _205.name])) {
           if (seenFn.has(tool.name)) continue;
           seenFn.add(tool.name);
           deduped.push(tool);
@@ -7026,21 +7224,21 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         return tool.functionDeclarations.map((fn) => fn.name).join(", ");
       }
       if (tool.name) return tool.name;
-      if (_optionalChain([tool, 'access', _186 => _186.function, 'optionalAccess', _187 => _187.name])) return tool.function.name;
-      if (_optionalChain([tool, 'access', _188 => _188.function, 'optionalAccess', _189 => _189.function, 'optionalAccess', _190 => _190.name])) return tool.function.function.name;
+      if (_optionalChain([tool, 'access', _206 => _206.function, 'optionalAccess', _207 => _207.name])) return tool.function.name;
+      if (_optionalChain([tool, 'access', _208 => _208.function, 'optionalAccess', _209 => _209.function, 'optionalAccess', _210 => _210.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', _191 => _191.contents, 'optionalAccess', _192 => _192.length]) > 0 ? LogFormatter.formatContentPreview(llmRequest.contents[0]) : "none";
+    const contentPreview = _optionalChain([llmRequest, 'access', _211 => _211.contents, 'optionalAccess', _212 => _212.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', _193 => _193.contents, 'optionalAccess', _194 => _194.length]) || 0,
+      "Content Items": _optionalChain([llmRequest, 'access', _213 => _213.contents, 'optionalAccess', _214 => _214.length]) || 0,
       "Content Preview": contentPreview,
       "System Instruction": truncatedSystemInstruction || "none",
       "Available Tools": toolNames || "none",
-      "Tool Count": _optionalChain([llmRequest, 'access', _195 => _195.config, 'optionalAccess', _196 => _196.tools, 'optionalAccess', _197 => _197.length]) || 0,
+      "Tool Count": _optionalChain([llmRequest, 'access', _215 => _215.config, 'optionalAccess', _216 => _216.tools, 'optionalAccess', _217 => _217.length]) || 0,
       Streaming: isStreaming ? "Yes" : "No"
     });
     let responseCount = 0;
@@ -7055,8 +7253,8 @@ var BaseLlmFlow = (_class25 = class {constructor() { _class25.prototype.__init43
         llmRequest,
         llmResponse
       );
-      const tokenCount = _optionalChain([llmResponse, 'access', _198 => _198.usageMetadata, 'optionalAccess', _199 => _199.totalTokenCount]) || "unknown";
-      const functionCalls = _optionalChain([llmResponse, 'access', _200 => _200.content, 'optionalAccess', _201 => _201.parts, 'optionalAccess', _202 => _202.filter, 'call', _203 => _203((part) => part.functionCall)]) || [];
+      const tokenCount = _optionalChain([llmResponse, 'access', _218 => _218.usageMetadata, 'optionalAccess', _219 => _219.totalTokenCount]) || "unknown";
+      const functionCalls = _optionalChain([llmResponse, 'access', _220 => _220.content, 'optionalAccess', _221 => _221.parts, 'optionalAccess', _222 => _222.filter, 'call', _223 => _223((part) => part.functionCall)]) || [];
       const functionCallsDisplay = LogFormatter.formatFunctionCalls(functionCalls);
       const responsePreview = LogFormatter.formatResponsePreview(llmResponse);
       this.logger.debugStructured("\u{1F4E5} LLM Response", {
@@ -7200,7 +7398,7 @@ var EnhancedAuthConfig = class {
    */
   generateCredentialKey() {
     const schemeKey = this.authScheme.type || "unknown";
-    const credentialKey = _optionalChain([this, 'access', _204 => _204.rawAuthCredential, 'optionalAccess', _205 => _205.type]) || "none";
+    const credentialKey = _optionalChain([this, 'access', _224 => _224.rawAuthCredential, 'optionalAccess', _225 => _225.type]) || "none";
     const timestamp = Date.now();
     return `adk_${schemeKey}_${credentialKey}_${timestamp}`;
   }
@@ -7357,7 +7555,7 @@ var AuthLlmRequestProcessor = class extends BaseLlmRequestProcessor {
    */
   parseAndStoreAuthResponse(authHandler, invocationContext) {
     try {
-      const credentialKey = _optionalChain([authHandler, 'access', _206 => _206.authConfig, 'access', _207 => _207.context, 'optionalAccess', _208 => _208.credentialKey]) || `temp:${Date.now()}`;
+      const credentialKey = _optionalChain([authHandler, 'access', _226 => _226.authConfig, 'access', _227 => _227.context, 'optionalAccess', _228 => _228.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") {
@@ -7386,15 +7584,15 @@ var BasicLlmRequestProcessor = class extends BaseLlmRequestProcessor {
       llmRequest.config = {};
     }
     if (agent.outputSchema) {
-      const hasTools = await _asyncOptionalChain([(await _optionalChain([agent, 'access', _209 => _209.canonicalTools, 'optionalCall', _210 => _210(invocationContext)])), 'optionalAccess', async _211 => _211.length]) > 0;
+      const hasTools = await _asyncOptionalChain([(await _optionalChain([agent, 'access', _229 => _229.canonicalTools, 'optionalCall', _230 => _230(invocationContext)])), 'optionalAccess', async _231 => _231.length]) > 0;
       const hasTransfers = !!("subAgents" in agent && agent.subAgents && agent.subAgents.length > 0 && !(agent.disallowTransferToParent && agent.disallowTransferToPeers));
       if (!hasTools && !hasTransfers) {
         llmRequest.setOutputSchema(agent.outputSchema);
       } else {
         (() => {
           try {
-            const logger = new Logger({ name: "BasicLlmRequestProcessor" });
-            logger.debug(
+            const logger2 = new Logger({ name: "BasicLlmRequestProcessor" });
+            logger2.debug(
               `Skipping request-level output schema for agent ${agent.name} because tools/transfers are present. Schema will be validated during response processing.`
             );
           } catch (e) {
@@ -7478,7 +7676,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', _212 => _212.model, 'optionalAccess', _213 => _213.startsWith, 'call', _214 => _214("gemini-2")])) {
+    if (!_optionalChain([llmRequest, 'access', _232 => _232.model, 'optionalAccess', _233 => _233.startsWith, 'call', _234 => _234("gemini-2")])) {
       throw new Error(
         `Gemini code execution tool is not supported for model ${llmRequest.model}`
       );
@@ -7523,7 +7721,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', _215 => _215.parts, 'optionalAccess', _216 => _216.length])) {
+    if (!_optionalChain([content, 'optionalAccess', _235 => _235.parts, 'optionalAccess', _236 => _236.length])) {
       return null;
     }
     for (let idx = 0; idx < content.parts.length; idx++) {
@@ -7609,7 +7807,7 @@ ${fileNames}`);
    * Converts the code execution parts to text parts in a Content
    */
   static convertCodeExecutionParts(content, codeBlockDelimiter, executionResultDelimiters) {
-    if (!_optionalChain([content, 'access', _217 => _217.parts, 'optionalAccess', _218 => _218.length])) {
+    if (!_optionalChain([content, 'access', _237 => _237.parts, 'optionalAccess', _238 => _238.length])) {
       return;
     }
     const lastPart = content.parts[content.parts.length - 1];
@@ -8002,7 +8200,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', _219 => _219.contents, 'optionalAccess', _220 => _220.length]) || 0); i++) {
+  for (let i = 0; i < (_optionalChain([llmRequest, 'access', _239 => _239.contents, 'optionalAccess', _240 => _240.length]) || 0); i++) {
     const content = llmRequest.contents[i];
     if (content.role !== "user" || !content.parts) {
       continue;
@@ -8034,7 +8232,7 @@ Available file: \`${fileName}\`
 }
 function getOrSetExecutionId(invocationContext, codeExecutorContext) {
   const agent = invocationContext.agent;
-  if (!hasCodeExecutor(agent) || !_optionalChain([agent, 'access', _221 => _221.codeExecutor, 'optionalAccess', _222 => _222.stateful])) {
+  if (!hasCodeExecutor(agent) || !_optionalChain([agent, 'access', _241 => _241.codeExecutor, 'optionalAccess', _242 => _242.stateful])) {
     return void 0;
   }
   let executionId = codeExecutorContext.getExecutionId();
@@ -8265,7 +8463,7 @@ function rearrangeEventsForLatestFunctionResponse(events) {
       continue;
     }
     const functionResponses2 = event.getFunctionResponses();
-    if (_optionalChain([functionResponses2, 'optionalAccess', _223 => _223.some, 'call', _224 => _224((fr) => fr.id && functionResponsesIds.has(fr.id))])) {
+    if (_optionalChain([functionResponses2, 'optionalAccess', _243 => _243.some, 'call', _244 => _244((fr) => fr.id && functionResponsesIds.has(fr.id))])) {
       functionResponseEvents.push(event);
     }
   }
@@ -8275,8 +8473,30 @@ function rearrangeEventsForLatestFunctionResponse(events) {
   return resultEvents;
 }
 function getContents(currentBranch, events, agentName = "") {
+  const invocationIdToIndex = /* @__PURE__ */ new Map();
+  for (let idx = 0; idx < events.length; idx++) {
+    if (events[idx].invocationId) {
+      invocationIdToIndex.set(events[idx].invocationId, idx);
+    }
+  }
+  const rewindFilteredEvents = [];
+  let i = events.length - 1;
+  while (i >= 0) {
+    const event = events[i];
+    if (_optionalChain([event, 'access', _245 => _245.actions, 'optionalAccess', _246 => _246.rewindBeforeInvocationId])) {
+      const rewindInvocationId = event.actions.rewindBeforeInvocationId;
+      const rewindIndex = invocationIdToIndex.get(rewindInvocationId);
+      if (rewindIndex !== void 0 && rewindIndex < i) {
+        i = rewindIndex;
+      }
+    } else {
+      rewindFilteredEvents.push(event);
+    }
+    i--;
+  }
+  rewindFilteredEvents.reverse();
   const filteredEvents = [];
-  for (const event of events) {
+  for (const event of rewindFilteredEvents) {
     if (!event.content || !event.content.role || !event.content.parts || event.content.parts.length === 0) {
       continue;
     }
@@ -8296,7 +8516,8 @@ function getContents(currentBranch, events, agentName = "") {
       isOtherAgentReply(agentName, event) ? convertForeignEvent(event) : event
     );
   }
-  let resultEvents = rearrangeEventsForLatestFunctionResponse(filteredEvents);
+  const processedEvents = processCompactionEvents(filteredEvents);
+  let resultEvents = rearrangeEventsForLatestFunctionResponse(processedEvents);
   resultEvents = rearrangeEventsForAsyncFunctionResponsesInHistory(resultEvents);
   const contents = [];
   for (const event of resultEvents) {
@@ -8364,7 +8585,7 @@ function mergeFunctionResponseEvents(functionResponseEvents) {
   const partIndicesInMergedEvent = {};
   for (let idx = 0; idx < partsInMergedEvent.length; idx++) {
     const part = partsInMergedEvent[idx];
-    if (_optionalChain([part, 'access', _225 => _225.functionResponse, 'optionalAccess', _226 => _226.id])) {
+    if (_optionalChain([part, 'access', _247 => _247.functionResponse, 'optionalAccess', _248 => _248.id])) {
       partIndicesInMergedEvent[part.functionResponse.id] = idx;
     }
   }
@@ -8373,7 +8594,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', _227 => _227.functionResponse, 'optionalAccess', _228 => _228.id])) {
+      if (_optionalChain([part, 'access', _249 => _249.functionResponse, 'optionalAccess', _250 => _250.id])) {
         const functionCallId = part.functionResponse.id;
         if (functionCallId in partIndicesInMergedEvent) {
           partsInMergedEvent[partIndicesInMergedEvent[functionCallId]] = part;
@@ -8408,6 +8629,31 @@ function isAuthEvent(event) {
   }
   return false;
 }
+function processCompactionEvents(events) {
+  const result = [];
+  let lastCompactionStartTime = Number.POSITIVE_INFINITY;
+  for (let i = events.length - 1; i >= 0; i--) {
+    const event = events[i];
+    if (_optionalChain([event, 'access', _251 => _251.actions, 'optionalAccess', _252 => _252.compaction])) {
+      const compaction = event.actions.compaction;
+      const synthesizedEvent = new Event({
+        timestamp: compaction.endTimestamp,
+        author: "model",
+        content: compaction.compactedContent,
+        branch: event.branch,
+        invocationId: event.invocationId
+      });
+      result.unshift(synthesizedEvent);
+      lastCompactionStartTime = Math.min(
+        lastCompactionStartTime,
+        compaction.startTimestamp
+      );
+    } else if (event.timestamp < lastCompactionStartTime) {
+      result.unshift(event);
+    }
+  }
+  return result;
+}
 
 // src/flows/llm-flows/identity.ts
 var IdentityLlmRequestProcessor = class extends BaseLlmRequestProcessor {
@@ -8640,7 +8886,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', _229 => _229[i], 'access', _230 => _230.functionCall, 'optionalAccess', _231 => _231.name])) {
+        if (!_optionalChain([responseParts, 'access', _253 => _253[i], 'access', _254 => _254.functionCall, 'optionalAccess', _255 => _255.name])) {
           continue;
         }
         preservedParts.push(responseParts[i]);
@@ -8679,7 +8925,7 @@ var PlanReActPlanner = class extends BasePlanner {
    * Handles non-function-call parts of the response
    */
   _handleNonFunctionCallParts(responsePart, preservedParts) {
-    if (_optionalChain([responsePart, 'access', _232 => _232.text, 'optionalAccess', _233 => _233.includes, 'call', _234 => _234(FINAL_ANSWER_TAG)])) {
+    if (_optionalChain([responsePart, 'access', _256 => _256.text, 'optionalAccess', _257 => _257.includes, 'call', _258 => _258(FINAL_ANSWER_TAG)])) {
       const [reasoningText, finalAnswerText] = this._splitByLastPattern(
         responsePart.text,
         FINAL_ANSWER_TAG
@@ -8777,14 +9023,7 @@ var NlPlanningRequestProcessor = class extends BaseLlmRequestProcessor {
       llmRequest
     );
     if (planningInstruction) {
-      if (llmRequest.appendInstructions) {
-        llmRequest.appendInstructions([planningInstruction]);
-      } else {
-        const existingInstructions = llmRequest.instructions || "";
-        llmRequest.instructions = `${existingInstructions}
-
-${planningInstruction}`;
-      }
+      llmRequest.appendInstructions([planningInstruction]);
     }
     removeThoughtFromRequest(llmRequest);
     for await (const _ of []) {
@@ -8925,7 +9164,7 @@ var OutputSchemaResponseProcessor = (_class26 = class extends BaseLlmResponsePro
   stripCodeFences(raw) {
     const fencePattern = /```(?:json)?\s*([\s\S]*?)```/i;
     const fenceMatch = raw.match(fencePattern);
-    if (_optionalChain([fenceMatch, 'optionalAccess', _235 => _235[1]])) {
+    if (_optionalChain([fenceMatch, 'optionalAccess', _259 => _259[1]])) {
       return fenceMatch[1].trim();
     }
     const lines = raw.split(/\r?\n/).map((l) => l.trim());
@@ -8962,7 +9201,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', _236 => _236.content, 'optionalAccess', _237 => _237.parts, 'optionalAccess', _238 => _238.length])
+      (e) => e.author === "user" && _optionalChain([e, 'access', _260 => _260.content, 'optionalAccess', _261 => _261.parts, 'optionalAccess', _262 => _262.length])
     );
     if (!lastUserEvent) return;
     const query = (_nullishCoalesce(lastUserEvent.content.parts, () => ( []))).map((p) => p.text || "").join(" ");
@@ -8973,7 +9212,7 @@ var SharedMemoryRequestProcessor = class extends BaseLlmRequestProcessor {
     });
     const sessionTexts = new Set(
       (llmRequest.contents || []).flatMap(
-        (c) => _optionalChain([c, 'access', _239 => _239.parts, 'optionalAccess', _240 => _240.map, 'call', _241 => _241((p) => p.text)]) || []
+        (c) => _optionalChain([c, 'access', _263 => _263.parts, 'optionalAccess', _264 => _264.map, 'call', _265 => _265((p) => p.text)]) || []
       )
     );
     for (const memory of results.memories) {
@@ -9394,7 +9633,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', _242 => _242.subAgents, 'optionalAccess', _243 => _243.length])) {
+    if (this.disallowTransferToParent && this.disallowTransferToPeers && !_optionalChain([this, 'access', _266 => _266.subAgents, 'optionalAccess', _267 => _267.length])) {
       return new SingleFlow();
     }
     return new AutoFlow();
@@ -9410,7 +9649,7 @@ var LlmAgent = (_class27 = class _LlmAgent extends BaseAgent {
       );
       return;
     }
-    if (this.outputKey && event.isFinalResponse() && _optionalChain([event, 'access', _244 => _244.content, 'optionalAccess', _245 => _245.parts])) {
+    if (this.outputKey && event.isFinalResponse() && _optionalChain([event, 'access', _268 => _268.content, 'optionalAccess', _269 => _269.parts])) {
       let result = event.content.parts.map((part) => part.text || "").join("");
       if (this.outputSchema) {
         if (!result.trim()) {
@@ -9630,7 +9869,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', _246 => _246.actions, 'optionalAccess', _247 => _247.escalate])) {
+          if (_optionalChain([event, 'access', _270 => _270.actions, 'optionalAccess', _271 => _271.escalate])) {
             return;
           }
         }
@@ -9942,17 +10181,17 @@ var RunConfig = class {
    */
   
   constructor(config) {
-    this.speechConfig = _optionalChain([config, 'optionalAccess', _248 => _248.speechConfig]);
-    this.responseModalities = _optionalChain([config, 'optionalAccess', _249 => _249.responseModalities]);
-    this.saveInputBlobsAsArtifacts = _optionalChain([config, 'optionalAccess', _250 => _250.saveInputBlobsAsArtifacts]) || false;
-    this.supportCFC = _optionalChain([config, 'optionalAccess', _251 => _251.supportCFC]) || false;
-    this.streamingMode = _optionalChain([config, 'optionalAccess', _252 => _252.streamingMode]) || "NONE" /* NONE */;
-    this.outputAudioTranscription = _optionalChain([config, 'optionalAccess', _253 => _253.outputAudioTranscription]);
-    this.inputAudioTranscription = _optionalChain([config, 'optionalAccess', _254 => _254.inputAudioTranscription]);
-    this.realtimeInputConfig = _optionalChain([config, 'optionalAccess', _255 => _255.realtimeInputConfig]);
-    this.enableAffectiveDialog = _optionalChain([config, 'optionalAccess', _256 => _256.enableAffectiveDialog]);
-    this.proactivity = _optionalChain([config, 'optionalAccess', _257 => _257.proactivity]);
-    this.maxLlmCalls = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _258 => _258.maxLlmCalls]), () => ( 500));
+    this.speechConfig = _optionalChain([config, 'optionalAccess', _272 => _272.speechConfig]);
+    this.responseModalities = _optionalChain([config, 'optionalAccess', _273 => _273.responseModalities]);
+    this.saveInputBlobsAsArtifacts = _optionalChain([config, 'optionalAccess', _274 => _274.saveInputBlobsAsArtifacts]) || false;
+    this.supportCFC = _optionalChain([config, 'optionalAccess', _275 => _275.supportCFC]) || false;
+    this.streamingMode = _optionalChain([config, 'optionalAccess', _276 => _276.streamingMode]) || "NONE" /* NONE */;
+    this.outputAudioTranscription = _optionalChain([config, 'optionalAccess', _277 => _277.outputAudioTranscription]);
+    this.inputAudioTranscription = _optionalChain([config, 'optionalAccess', _278 => _278.inputAudioTranscription]);
+    this.realtimeInputConfig = _optionalChain([config, 'optionalAccess', _279 => _279.realtimeInputConfig]);
+    this.enableAffectiveDialog = _optionalChain([config, 'optionalAccess', _280 => _280.enableAffectiveDialog]);
+    this.proactivity = _optionalChain([config, 'optionalAccess', _281 => _281.proactivity]);
+    this.maxLlmCalls = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _282 => _282.maxLlmCalls]), () => ( 500));
     this.validateMaxLlmCalls();
   }
   /**
@@ -9972,6 +10211,48 @@ var RunConfig = class {
   }
 };
 
+// src/artifacts/artifact-util.ts
+var SESSION_SCOPED_ARTIFACT_URI_RE = /^artifact:\/\/apps\/([^/]+)\/users\/([^/]+)\/sessions\/([^/]+)\/artifacts\/([^/]+)\/versions\/(\d+)$/;
+var USER_SCOPED_ARTIFACT_URI_RE = /^artifact:\/\/apps\/([^/]+)\/users\/([^/]+)\/artifacts\/([^/]+)\/versions\/(\d+)$/;
+function parseArtifactUri(uri) {
+  if (!uri || !uri.startsWith("artifact://")) {
+    return null;
+  }
+  let match = SESSION_SCOPED_ARTIFACT_URI_RE.exec(uri);
+  if (match) {
+    return {
+      appName: match[1],
+      userId: match[2],
+      sessionId: match[3],
+      filename: match[4],
+      version: Number.parseInt(match[5], 10)
+    };
+  }
+  match = USER_SCOPED_ARTIFACT_URI_RE.exec(uri);
+  if (match) {
+    return {
+      appName: match[1],
+      userId: match[2],
+      sessionId: void 0,
+      filename: match[3],
+      version: Number.parseInt(match[4], 10)
+    };
+  }
+  return null;
+}
+function getArtifactUri(args) {
+  const { appName, userId, filename, version, sessionId } = args;
+  if (sessionId) {
+    return `artifact://apps/${appName}/users/${userId}/sessions/${sessionId}/artifacts/${filename}/versions/${version}`;
+  }
+  return `artifact://apps/${appName}/users/${userId}/artifacts/${filename}/versions/${version}`;
+}
+function isArtifactRef(artifact) {
+  return Boolean(
+    _optionalChain([artifact, 'access', _283 => _283.fileData, 'optionalAccess', _284 => _284.fileUri]) && artifact.fileData.fileUri.startsWith("artifact://")
+  );
+}
+
 // src/artifacts/in-memory-artifact-service.ts
 var InMemoryArtifactService = (_class29 = class {constructor() { _class29.prototype.__init50.call(this); }
   __init50() {this.artifacts = /* @__PURE__ */ new Map()}
@@ -10012,7 +10293,29 @@ var InMemoryArtifactService = (_class29 = class {constructor() { _class29.protot
     if (targetVersion < 0 || targetVersion >= versions.length) {
       return null;
     }
-    return versions[targetVersion];
+    const artifactEntry = versions[targetVersion];
+    if (!artifactEntry) {
+      return null;
+    }
+    if (isArtifactRef(artifactEntry)) {
+      const parsedUri = parseArtifactUri(_optionalChain([artifactEntry, 'access', _285 => _285.fileData, 'optionalAccess', _286 => _286.fileUri]) || "");
+      if (!parsedUri) {
+        throw new Error(
+          `Invalid artifact reference URI: ${_optionalChain([artifactEntry, 'access', _287 => _287.fileData, 'optionalAccess', _288 => _288.fileUri])}`
+        );
+      }
+      return await this.loadArtifact({
+        appName: parsedUri.appName,
+        userId: parsedUri.userId,
+        sessionId: parsedUri.sessionId || sessionId,
+        filename: parsedUri.filename,
+        version: parsedUri.version
+      });
+    }
+    if (!artifactEntry.text && (!_optionalChain([artifactEntry, 'access', _289 => _289.inlineData, 'optionalAccess', _290 => _290.data]) || artifactEntry.inlineData.data.length === 0) && !artifactEntry.fileData) {
+      return null;
+    }
+    return artifactEntry;
   }
   async listArtifactKeys(args) {
     const { appName, userId, sessionId } = args;
@@ -10096,7 +10399,7 @@ var InMemoryMemoryService = (_class30 = class {
     }
     const userSessions = this._sessionEvents.get(userKey);
     const filteredEvents = session.events.filter(
-      (event) => _optionalChain([event, 'access', _259 => _259.content, 'optionalAccess', _260 => _260.parts])
+      (event) => _optionalChain([event, 'access', _291 => _291.content, 'optionalAccess', _292 => _292.parts])
     );
     userSessions.set(session.id, filteredEvents);
   }
@@ -10197,11 +10500,16 @@ var BaseSessionService = class {
       return;
     }
     for (const key in event.actions.stateDelta) {
-      if (Object.prototype.hasOwnProperty.call(event.actions.stateDelta, key)) {
+      if (Object.hasOwn(event.actions.stateDelta, key)) {
         if (key.startsWith("temp_")) {
           continue;
         }
-        session.state[key] = event.actions.stateDelta[key];
+        const value = event.actions.stateDelta[key];
+        if (value === null || value === void 0) {
+          delete session.state[key];
+        } else {
+          session.state[key] = value;
+        }
       }
     }
   }
@@ -10235,7 +10543,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', _261 => _261.trim, 'call', _262 => _262()]) || _crypto.randomUUID.call(void 0, );
+    const finalSessionId = _optionalChain([sessionId, 'optionalAccess', _293 => _293.trim, 'call', _294 => _294()]) || _crypto.randomUUID.call(void 0, );
     const session = {
       appName,
       userId,
@@ -10392,7 +10700,7 @@ var InMemorySessionService = (_class31 = class extends BaseSessionService {const
       warning(`sessionId ${sessionId} not in sessions[appName][userId]`);
       return event;
     }
-    if (_optionalChain([event, 'access', _263 => _263.actions, 'optionalAccess', _264 => _264.stateDelta])) {
+    if (_optionalChain([event, 'access', _295 => _295.actions, 'optionalAccess', _296 => _296.stateDelta])) {
       for (const key in event.actions.stateDelta) {
         const value = event.actions.stateDelta[key];
         if (key.startsWith(State.APP_PREFIX)) {
@@ -10426,14 +10734,14 @@ function _findFunctionCallEventIfLastEventIsFunctionResponse(session) {
     return null;
   }
   const lastEvent = events[events.length - 1];
-  if (_optionalChain([lastEvent, 'access', _265 => _265.content, 'optionalAccess', _266 => _266.parts, 'optionalAccess', _267 => _267.some, 'call', _268 => _268((part) => part.functionResponse)])) {
-    const functionCallId = _optionalChain([lastEvent, 'access', _269 => _269.content, 'access', _270 => _270.parts, 'access', _271 => _271.find, 'call', _272 => _272(
+  if (_optionalChain([lastEvent, 'access', _297 => _297.content, 'optionalAccess', _298 => _298.parts, 'optionalAccess', _299 => _299.some, 'call', _300 => _300((part) => part.functionResponse)])) {
+    const functionCallId = _optionalChain([lastEvent, 'access', _301 => _301.content, 'access', _302 => _302.parts, 'access', _303 => _303.find, 'call', _304 => _304(
       (part) => part.functionResponse
-    ), 'optionalAccess', _273 => _273.functionResponse, 'optionalAccess', _274 => _274.id]);
+    ), 'optionalAccess', _305 => _305.functionResponse, 'optionalAccess', _306 => _306.id]);
     if (!functionCallId) return null;
     for (let i = events.length - 2; i >= 0; i--) {
       const event = events[i];
-      const functionCalls = _optionalChain([event, 'access', _275 => _275.getFunctionCalls, 'optionalCall', _276 => _276()]) || [];
+      const functionCalls = _optionalChain([event, 'access', _307 => _307.getFunctionCalls, 'optionalCall', _308 => _308()]) || [];
       for (const functionCall of functionCalls) {
         if (functionCall.id === functionCallId) {
           return event;
@@ -10464,6 +10772,10 @@ var Runner = (_class32 = class {
    * The memory service for the runner.
    */
   
+  /**
+   * Configuration for event compaction.
+   */
+  
   __init55() {this.logger = new Logger({ name: "Runner" })}
   /**
    * Initializes the Runner.
@@ -10473,13 +10785,15 @@ var Runner = (_class32 = class {
     agent,
     artifactService,
     sessionService,
-    memoryService
+    memoryService,
+    eventsCompactionConfig
   }) {;_class32.prototype.__init55.call(this);
     this.appName = appName;
     this.agent = agent;
     this.artifactService = artifactService;
     this.sessionService = sessionService;
     this.memoryService = memoryService;
+    this.eventsCompactionConfig = eventsCompactionConfig;
   }
   /**
    * Runs the agent synchronously.
@@ -10581,6 +10895,10 @@ var Runner = (_class32 = class {
         }
         yield event;
       }
+      await _api.context.with(
+        spanContext,
+        () => this._runCompaction(session, invocationContext)
+      );
     } catch (error) {
       this.logger.debug("Error running agent:", error);
       span.recordException(error);
@@ -10636,15 +10954,15 @@ var Runner = (_class32 = class {
    */
   _findAgentToRun(session, rootAgent) {
     const event = _findFunctionCallEventIfLastEventIsFunctionResponse(session);
-    if (_optionalChain([event, 'optionalAccess', _277 => _277.author])) {
+    if (_optionalChain([event, 'optionalAccess', _309 => _309.author])) {
       return rootAgent.findAgent(event.author);
     }
-    const nonUserEvents = _optionalChain([session, 'access', _278 => _278.events, 'optionalAccess', _279 => _279.filter, 'call', _280 => _280((e) => e.author !== "user"), 'access', _281 => _281.reverse, 'call', _282 => _282()]) || [];
+    const nonUserEvents = _optionalChain([session, 'access', _310 => _310.events, 'optionalAccess', _311 => _311.filter, 'call', _312 => _312((e) => e.author !== "user"), 'access', _313 => _313.reverse, 'call', _314 => _314()]) || [];
     for (const event2 of nonUserEvents) {
       if (event2.author === rootAgent.name) {
         return rootAgent;
       }
-      const agent = _optionalChain([rootAgent, 'access', _283 => _283.findSubAgent, 'optionalCall', _284 => _284(event2.author)]);
+      const agent = _optionalChain([rootAgent, 'access', _315 => _315.findSubAgent, 'optionalCall', _316 => _316(event2.author)]);
       if (!agent) {
         this.logger.debug(
           `Event from an unknown agent: ${event2.author}, event id: ${event2.id}`
@@ -10693,6 +11011,188 @@ var Runner = (_class32 = class {
       runConfig
     });
   }
+  /**
+   * Runs compaction if configured.
+   */
+  async _runCompaction(session, _invocationContext) {
+    if (!this.eventsCompactionConfig) {
+      return;
+    }
+    const summarizer = this._getOrCreateSummarizer();
+    if (!summarizer) {
+      this.logger.warn(
+        "Event compaction configured but no summarizer available"
+      );
+      return;
+    }
+    try {
+      await runCompactionForSlidingWindow(
+        this.eventsCompactionConfig,
+        session,
+        this.sessionService,
+        summarizer
+      );
+    } catch (error) {
+      this.logger.error("Error running compaction:", error);
+    }
+  }
+  /**
+   * Gets the configured summarizer or creates a default LLM-based one.
+   */
+  _getOrCreateSummarizer() {
+    if (_optionalChain([this, 'access', _317 => _317.eventsCompactionConfig, 'optionalAccess', _318 => _318.summarizer])) {
+      return this.eventsCompactionConfig.summarizer;
+    }
+    if (this.agent instanceof LlmAgent) {
+      try {
+        const model = this.agent.canonicalModel;
+        return new LlmEventSummarizer(model);
+      } catch (error) {
+        this.logger.warn(
+          "Could not get canonical model for default summarizer:",
+          error
+        );
+        return void 0;
+      }
+    }
+    return void 0;
+  }
+  async rewind(args) {
+    const { userId, sessionId, rewindBeforeInvocationId } = args;
+    const session = await this.sessionService.getSession(
+      this.appName,
+      userId,
+      sessionId
+    );
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    let rewindEventIndex = -1;
+    for (let i = 0; i < session.events.length; i++) {
+      if (session.events[i].invocationId === rewindBeforeInvocationId) {
+        rewindEventIndex = i;
+        break;
+      }
+    }
+    if (rewindEventIndex === -1) {
+      throw new Error(`Invocation ID not found: ${rewindBeforeInvocationId}`);
+    }
+    const stateDelta = await this._computeStateDeltaForRewind(
+      session,
+      rewindEventIndex
+    );
+    const artifactDelta = await this._computeArtifactDeltaForRewind(
+      session,
+      rewindEventIndex
+    );
+    const rewindEvent = new Event({
+      invocationId: newInvocationContextId(),
+      author: "user",
+      actions: new EventActions({
+        rewindBeforeInvocationId,
+        stateDelta,
+        artifactDelta
+      })
+    });
+    this.logger.info(
+      "Rewinding session to invocation:",
+      rewindBeforeInvocationId
+    );
+    await this.sessionService.appendEvent(session, rewindEvent);
+  }
+  async _computeStateDeltaForRewind(session, rewindEventIndex) {
+    const stateAtRewindPoint = {};
+    for (let i = 0; i < rewindEventIndex; i++) {
+      const event = session.events[i];
+      if (_optionalChain([event, 'access', _319 => _319.actions, 'optionalAccess', _320 => _320.stateDelta])) {
+        for (const [k, v] of Object.entries(event.actions.stateDelta)) {
+          if (k.startsWith("app:") || k.startsWith("user:")) {
+            continue;
+          }
+          if (v === null || v === void 0) {
+            delete stateAtRewindPoint[k];
+          } else {
+            stateAtRewindPoint[k] = v;
+          }
+        }
+      }
+    }
+    const currentState = session.state;
+    const rewindStateDelta = {};
+    for (const [key, valueAtRewind] of Object.entries(stateAtRewindPoint)) {
+      if (!(key in currentState) || currentState[key] !== valueAtRewind) {
+        rewindStateDelta[key] = valueAtRewind;
+      }
+    }
+    for (const key of Object.keys(currentState)) {
+      if (key.startsWith("app:") || key.startsWith("user:")) {
+        continue;
+      }
+      if (!(key in stateAtRewindPoint)) {
+        rewindStateDelta[key] = null;
+      }
+    }
+    return rewindStateDelta;
+  }
+  async _computeArtifactDeltaForRewind(session, rewindEventIndex) {
+    if (!this.artifactService) {
+      return {};
+    }
+    const versionsAtRewindPoint = {};
+    for (let i = 0; i < rewindEventIndex; i++) {
+      const event = session.events[i];
+      if (_optionalChain([event, 'access', _321 => _321.actions, 'optionalAccess', _322 => _322.artifactDelta])) {
+        Object.assign(versionsAtRewindPoint, event.actions.artifactDelta);
+      }
+    }
+    const currentVersions = {};
+    for (const event of session.events) {
+      if (_optionalChain([event, 'access', _323 => _323.actions, 'optionalAccess', _324 => _324.artifactDelta])) {
+        Object.assign(currentVersions, event.actions.artifactDelta);
+      }
+    }
+    const rewindArtifactDelta = {};
+    for (const [filename, vn] of Object.entries(currentVersions)) {
+      if (filename.startsWith("user:")) {
+        continue;
+      }
+      const vt = versionsAtRewindPoint[filename];
+      if (vt === vn) {
+        continue;
+      }
+      let artifact;
+      if (vt === void 0 || vt === null) {
+        artifact = {
+          inlineData: {
+            mimeType: "application/octet-stream",
+            data: ""
+          }
+        };
+      } else {
+        const artifactUri = getArtifactUri({
+          appName: this.appName,
+          userId: session.userId,
+          sessionId: session.id,
+          filename,
+          version: vt
+        });
+        artifact = {
+          fileData: {
+            fileUri: artifactUri
+          }
+        };
+      }
+      const newVersion = await this.artifactService.saveArtifact({
+        appName: this.appName,
+        userId: session.userId,
+        sessionId: session.id,
+        filename,
+        artifact
+      });
+      rewindArtifactDelta[filename] = newVersion;
+    }
+    return rewindArtifactDelta;
+  }
 }, _class32);
 var InMemoryRunner = class extends Runner {
   /**
@@ -10722,6 +11222,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
   
   
   
+  
   __init56() {this.agentType = "llm"}
   
   
@@ -10935,6 +11436,14 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
     this.config.afterToolCallback = callback;
     return this;
   }
+  /**
+   * Convenience method to start building with an existing agent
+   * @param agent The agent instance to wrap
+   * @returns New AgentBuilder instance with agent set
+   */
+  static withAgent(agent) {
+    return new _AgentBuilder(agent.name || "default_agent").withAgent(agent);
+  }
   /**
    * Provide an already constructed agent instance. Further definition-mutating calls
    * (model/tools/instruction/etc.) will be ignored with a dev warning.
@@ -11116,6 +11625,26 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
     this.runConfig = config instanceof RunConfig ? config : new RunConfig({ ...this.runConfig || {}, ...config });
     return this;
   }
+  /**
+   * Configure event compaction for automatic history management
+   * @param config Event compaction configuration
+   * @returns This builder instance for chaining
+   * @example
+   * ```typescript
+   * const { runner } = await AgentBuilder
+   *   .create("assistant")
+   *   .withModel("gemini-2.5-flash")
+   *   .withEventsCompaction({
+   *     compactionInterval: 10,  // Compact every 10 invocations
+   *     overlapSize: 2,          // Include 2 prior invocations
+   *   })
+   *   .build();
+   * ```
+   */
+  withEventsCompaction(config) {
+    this.eventsCompactionConfig = config;
+    return this;
+  }
   /**
    * Configure with an in-memory session with custom IDs
    * Note: In-memory sessions are created automatically by default, use this only if you need custom appName/userId
@@ -11152,7 +11681,8 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
         agent,
         sessionService: this.sessionService,
         memoryService: this.memoryService,
-        artifactService: this.artifactService
+        artifactService: this.artifactService,
+        eventsCompactionConfig: this.eventsCompactionConfig
       };
       const baseRunner = new Runner(runnerConfig);
       runner = this.createEnhancedRunner(baseRunner, session);
@@ -11302,7 +11832,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
     const outputSchema = this.config.outputSchema;
     const agentType = this.agentType;
     const isMulti = agentType === "parallel" || agentType === "sequential";
-    const subAgentNames = _optionalChain([this, 'access', _285 => _285.config, 'access', _286 => _286.subAgents, 'optionalAccess', _287 => _287.map, 'call', _288 => _288((a) => a.name)]) || [];
+    const subAgentNames = _optionalChain([this, 'access', _325 => _325.config, 'access', _326 => _326.subAgents, 'optionalAccess', _327 => _327.map, 'call', _328 => _328((a) => a.name)]) || [];
     const runConfig = this.runConfig;
     return {
       __outputSchema: outputSchema,
@@ -11311,7 +11841,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
         let combinedResponse = "";
         const perAgentBuffers = {};
         const authors = /* @__PURE__ */ new Set();
-        if (!_optionalChain([sessionOptions, 'optionalAccess', _289 => _289.userId])) {
+        if (!_optionalChain([sessionOptions, 'optionalAccess', _329 => _329.userId])) {
           throw new Error("Session configuration is required");
         }
         for await (const event of baseRunner.runAsync({
@@ -11320,7 +11850,7 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
           newMessage,
           runConfig
         })) {
-          if (_optionalChain([event, 'access', _290 => _290.content, 'optionalAccess', _291 => _291.parts]) && Array.isArray(event.content.parts)) {
+          if (_optionalChain([event, 'access', _330 => _330.content, 'optionalAccess', _331 => _331.parts]) && Array.isArray(event.content.parts)) {
             const content = event.content.parts.map(
               (part) => (part && typeof part === "object" && "text" in part ? part.text : "") || ""
             ).join("");
@@ -11366,6 +11896,9 @@ var AgentBuilder = (_class33 = class _AgentBuilder {
           ...params,
           runConfig: _nullishCoalesce(params.runConfig, () => ( runConfig))
         });
+      },
+      rewind(params) {
+        return baseRunner.rewind(params);
       }
     };
   }
@@ -11607,7 +12140,7 @@ var VertexAiSessionService = class extends BaseSessionService {
         path: `operations/${operationId}`,
         request_dict: {}
       });
-      if (_optionalChain([lroResponse, 'optionalAccess', _292 => _292.done])) {
+      if (_optionalChain([lroResponse, 'optionalAccess', _332 => _332.done])) {
         break;
       }
       await new Promise((resolve) => setTimeout(resolve, 1e3));
@@ -11978,12 +12511,12 @@ var DatabaseSessionService = (_class34 = class extends BaseSessionService {
   }
   async createSession(appName, userId, state, sessionId) {
     await this.ensureInitialized();
-    const id = _optionalChain([sessionId, 'optionalAccess', _293 => _293.trim, 'call', _294 => _294()]) || this.generateSessionId();
+    const id = _optionalChain([sessionId, 'optionalAccess', _333 => _333.trim, 'call', _334 => _334()]) || 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', _295 => _295.state]), {});
-      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _296 => _296.state]), {});
+      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _335 => _335.state]), {});
+      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _336 => _336.state]), {});
       if (!appState) {
         await trx.insertInto("app_states").values({
           app_name: appName,
@@ -12042,21 +12575,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', _297 => _297.afterTimestamp])) {
+      if (_optionalChain([config, 'optionalAccess', _337 => _337.afterTimestamp])) {
         eventQuery = eventQuery.where(
           "timestamp",
           ">=",
           new Date(config.afterTimestamp * 1e3)
         );
       }
-      if (_optionalChain([config, 'optionalAccess', _298 => _298.numRecentEvents])) {
+      if (_optionalChain([config, 'optionalAccess', _338 => _338.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', _299 => _299.state]), {});
-      const currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _300 => _300.state]), {});
+      const currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _339 => _339.state]), {});
+      const currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _340 => _340.state]), {});
       const sessionState = this.parseJsonSafely(storageSession.state, {});
       const mergedState = this.mergeState(
         currentAppState,
@@ -12114,13 +12647,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', _301 => _301.state]), {});
-      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _302 => _302.state]), {});
+      let currentAppState = this.parseJsonSafely(_optionalChain([appState, 'optionalAccess', _341 => _341.state]), {});
+      let currentUserState = this.parseJsonSafely(_optionalChain([userState, 'optionalAccess', _342 => _342.state]), {});
       let sessionState = this.parseJsonSafely(storageSession.state, {});
       let appStateDelta = {};
       let userStateDelta = {};
       let sessionStateDelta = {};
-      if (_optionalChain([event, 'access', _303 => _303.actions, 'optionalAccess', _304 => _304.stateDelta])) {
+      if (_optionalChain([event, 'access', _343 => _343.actions, 'optionalAccess', _344 => _344.stateDelta])) {
         const deltas = this.extractStateDelta(event.actions.stateDelta);
         appStateDelta = deltas.appStateDelta;
         userStateDelta = deltas.userStateDelta;
@@ -12266,7 +12799,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', _305 => _305.actions, 'optionalAccess', _306 => _306.stateDelta])) {
+    if (!_optionalChain([event, 'access', _345 => _345.actions, 'optionalAccess', _346 => _346.stateDelta])) {
       return;
     }
     for (const [key, value] of Object.entries(event.actions.stateDelta)) {
@@ -12436,7 +12969,7 @@ var GcsArtifactService = class {
       };
       return part;
     } catch (error) {
-      if (_optionalChain([error, 'optionalAccess', _307 => _307.code]) === 404) {
+      if (_optionalChain([error, 'optionalAccess', _347 => _347.code]) === 404) {
         return null;
       }
       throw error;
@@ -12687,13 +13220,13 @@ var VertexAiEvalFacade = class _VertexAiEvalFacade {
     };
   }
   _getText(content) {
-    if (_optionalChain([content, 'optionalAccess', _308 => _308.parts])) {
+    if (_optionalChain([content, 'optionalAccess', _348 => _348.parts])) {
       return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join("\n");
     }
     return "";
   }
   _getScore(evalResult) {
-    if (_optionalChain([evalResult, 'optionalAccess', _309 => _309.summaryMetrics, 'optionalAccess', _310 => _310[0], 'optionalAccess', _311 => _311.meanScore]) !== void 0 && typeof evalResult.summaryMetrics[0].meanScore === "number" && !Number.isNaN(evalResult.summaryMetrics[0].meanScore)) {
+    if (_optionalChain([evalResult, 'optionalAccess', _349 => _349.summaryMetrics, 'optionalAccess', _350 => _350[0], 'optionalAccess', _351 => _351.meanScore]) !== void 0 && typeof evalResult.summaryMetrics[0].meanScore === "number" && !Number.isNaN(evalResult.summaryMetrics[0].meanScore)) {
       return evalResult.summaryMetrics[0].meanScore;
     }
     return void 0;
@@ -12843,7 +13376,7 @@ var ResponseEvaluator = class extends Evaluator {
     return fmeasure;
   }
   extractText(content) {
-    if (_optionalChain([content, 'optionalAccess', _312 => _312.parts])) {
+    if (_optionalChain([content, 'optionalAccess', _352 => _352.parts])) {
       return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join(" ");
     }
     return "";
@@ -12876,7 +13409,7 @@ var TrajectoryEvaluator = class extends Evaluator {
     for (let i = 0; i < actualInvocations.length; i++) {
       const actual = actualInvocations[i];
       const expected = expectedInvocations[i];
-      if (!_optionalChain([actual, 'access', _313 => _313.intermediateData, 'optionalAccess', _314 => _314.toolUses]) || !_optionalChain([expected, 'access', _315 => _315.intermediateData, 'optionalAccess', _316 => _316.toolUses])) {
+      if (!_optionalChain([actual, 'access', _353 => _353.intermediateData, 'optionalAccess', _354 => _354.toolUses]) || !_optionalChain([expected, 'access', _355 => _355.intermediateData, 'optionalAccess', _356 => _356.toolUses])) {
         perInvocationResults.push({
           actualInvocation: actual,
           expectedInvocation: expected,
@@ -12964,7 +13497,7 @@ var SafetyEvaluatorV1 = class extends Evaluator {
 
 // src/evaluation/llm-as-judge-utils.ts
 function getTextFromContent(content) {
-  if (_optionalChain([content, 'optionalAccess', _317 => _317.parts])) {
+  if (_optionalChain([content, 'optionalAccess', _357 => _357.parts])) {
     return content.parts.map((part) => part.text).filter(Boolean).join("\n");
   }
   return "";
@@ -12976,9 +13509,9 @@ function getEvalStatus(score, threshold) {
 // src/evaluation/llm-as-judge.ts
 var LlmAsJudge = class {
   async sampleJudge(prompt, numSamples, critiqueParser, judgeModelOptions) {
-    const modelName = _optionalChain([judgeModelOptions, 'optionalAccess', _318 => _318.judgeModel]) || "gemini-2.5-flash";
+    const modelName = _optionalChain([judgeModelOptions, 'optionalAccess', _358 => _358.judgeModel]) || "gemini-2.5-flash";
     const model = LLMRegistry.getModelOrCreate(modelName);
-    const config = _optionalChain([judgeModelOptions, 'optionalAccess', _319 => _319.judgeModelConfig]) || {};
+    const config = _optionalChain([judgeModelOptions, 'optionalAccess', _359 => _359.judgeModelConfig]) || {};
     const samples = [];
     for (let i = 0; i < numSamples; i++) {
       try {
@@ -13044,7 +13577,7 @@ function parseCritique(response) {
   const labelMatchIsResponseValid = response.match(
     /"is_the_agent_response_valid":\s*\[*[\n\s]*"*([^"^\]^\s]*)"*[\n\s]*\]*\s*[,\n\}]/
   );
-  if (_optionalChain([labelMatchIsResponseValid, 'optionalAccess', _320 => _320[1]])) {
+  if (_optionalChain([labelMatchIsResponseValid, 'optionalAccess', _360 => _360[1]])) {
     const label = labelMatchIsResponseValid[1].toLowerCase();
     return label === "valid" ? "valid" /* VALID */ : "invalid" /* INVALID */;
   }
@@ -13089,7 +13622,7 @@ var FinalResponseMatchV2Evaluator = class extends Evaluator {
         "{prompt}",
         prompt
       ).replace("{response}", response).replace("{golden_response}", goldenResponse);
-      const numSamples = _nullishCoalesce(_optionalChain([this, 'access', _321 => _321.metric, 'access', _322 => _322.judgeModelOptions, 'optionalAccess', _323 => _323.numSamples]), () => ( DEFAULT_NUM_SAMPLES));
+      const numSamples = _nullishCoalesce(_optionalChain([this, 'access', _361 => _361.metric, 'access', _362 => _362.judgeModelOptions, 'optionalAccess', _363 => _363.numSamples]), () => ( DEFAULT_NUM_SAMPLES));
       const labels = await this.llmAsJudge.sampleJudge(
         formattedPrompt,
         numSamples,
@@ -13129,7 +13662,7 @@ var MetricEvaluatorRegistry = (_class35 = class {constructor() { _class35.protot
     const metricName = metricInfo.metricName;
     if (this.registry.has(metricName)) {
       console.info(
-        `Updating Evaluator class for ${metricName} from ${_optionalChain([this, 'access', _324 => _324.registry, 'access', _325 => _325.get, 'call', _326 => _326(metricName), 'optionalAccess', _327 => _327.evaluator, 'access', _328 => _328.name])} to ${evaluator.name}`
+        `Updating Evaluator class for ${metricName} from ${_optionalChain([this, 'access', _364 => _364.registry, 'access', _365 => _365.get, 'call', _366 => _366(metricName), 'optionalAccess', _367 => _367.evaluator, 'access', _368 => _368.name])} to ${evaluator.name}`
       );
     }
     this.registry.set(metricName, {
@@ -13243,10 +13776,10 @@ var LocalEvalService = class extends BaseEvalService {
       for (const evalMetric of evaluateConfig.evalMetrics) {
         const evaluator = DEFAULT_METRIC_EVALUATOR_REGISTRY.getEvaluator(evalMetric);
         const actual = results.filter(
-          (r) => !_optionalChain([r, 'access', _329 => _329.invocationId, 'optionalAccess', _330 => _330.includes, 'call', _331 => _331("expected")])
+          (r) => !_optionalChain([r, 'access', _369 => _369.invocationId, 'optionalAccess', _370 => _370.includes, 'call', _371 => _371("expected")])
         );
         const expected = results.filter(
-          (r) => _optionalChain([r, 'access', _332 => _332.invocationId, 'optionalAccess', _333 => _333.includes, 'call', _334 => _334("expected")])
+          (r) => _optionalChain([r, 'access', _372 => _372.invocationId, 'optionalAccess', _373 => _373.includes, 'call', _374 => _374("expected")])
         );
         const result = await evaluator.evaluateInvocations(actual, expected);
         evalResult.evalCaseResults.push({
@@ -13638,13 +14171,13 @@ ${failures.join(
     console.log("\n\n");
   }
   static _convertContentToText(content) {
-    if (_optionalChain([content, 'optionalAccess', _335 => _335.parts])) {
+    if (_optionalChain([content, 'optionalAccess', _375 => _375.parts])) {
       return content.parts.map((p) => p.text || "").filter((text) => text.length > 0).join("\n");
     }
     return "";
   }
   static _convertToolCallsToText(intermediateData) {
-    if (_optionalChain([intermediateData, 'optionalAccess', _336 => _336.toolUses])) {
+    if (_optionalChain([intermediateData, 'optionalAccess', _376 => _376.toolUses])) {
       return intermediateData.toolUses.map((t) => JSON.stringify(t)).join("\n");
     }
     return "";
@@ -13699,7 +14232,7 @@ ${failures.join(
     for (const [metricName, evalMetricResultsWithInvocations] of Object.entries(
       evalMetricResults
     )) {
-      const threshold = _optionalChain([evalMetricResultsWithInvocations, 'access', _337 => _337[0], 'optionalAccess', _338 => _338.evalMetricResult, 'access', _339 => _339.threshold]) || 0;
+      const threshold = _optionalChain([evalMetricResultsWithInvocations, 'access', _377 => _377[0], 'optionalAccess', _378 => _378.evalMetricResult, 'access', _379 => _379.threshold]) || 0;
       const scores = evalMetricResultsWithInvocations.map((m) => m.evalMetricResult.score).filter((s) => s !== void 0);
       let overallScore;
       let overallEvalStatus;
@@ -13788,7 +14321,7 @@ var RougeEvaluator = class extends Evaluator {
   }
 };
 function getTextFromContent2(content) {
-  if (_optionalChain([content, 'optionalAccess', _340 => _340.parts])) {
+  if (_optionalChain([content, 'optionalAccess', _380 => _380.parts])) {
     return content.parts.map((part) => part.text).filter(Boolean).join("\n");
   }
   return "";
@@ -13984,4 +14517,9 @@ var VERSION = "0.1.0";
 
 
 
-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.McpCoinGeckoPro = McpCoinGeckoPro; 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.McpUpbit = McpUpbit; 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.VertexAiRagMemoryService = VertexAiRagMemoryService; 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.convertMcpToolToBaseTool = convertMcpToolToBaseTool; 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.LlmEventSummarizer = LlmEventSummarizer; 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.McpCoinGeckoPro = McpCoinGeckoPro; 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.McpUpbit = McpUpbit; 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.VertexAiRagMemoryService = VertexAiRagMemoryService; 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.convertMcpToolToBaseTool = convertMcpToolToBaseTool; 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.getArtifactUri = getArtifactUri; 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.isArtifactRef = isArtifactRef; 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.parseArtifactUri = parseArtifactUri; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor; exports.runCompactionForSlidingWindow = runCompactionForSlidingWindow; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;