@iqai/adk 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @iqai/adk
 
+## 0.5.2
+
+### Patch Changes
+
+- ae81c74: Add event compaction feature with configurable summarization
+
+## 0.5.1
+
+### Patch Changes
+
+- d8fd6e8: feat(agent-builder): add static withAgent method for cleaner API usage
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Part, Content, Blob, SpeechConfig, AudioTranscriptionConfig, RealtimeInputConfig, ProactivityConfig, FunctionDeclaration, GroundingMetadata, GenerateContentResponseUsageMetadata, GenerateContentConfig, Schema, LiveConnectConfig, GoogleGenAI, FunctionCall } from '@google/genai';
+import { Content, Part, Blob, SpeechConfig, AudioTranscriptionConfig, RealtimeInputConfig, ProactivityConfig, FunctionDeclaration, GroundingMetadata, GenerateContentResponseUsageMetadata, GenerateContentConfig, Schema, LiveConnectConfig, GoogleGenAI, FunctionCall } from '@google/genai';
 export { Blob, Content, FunctionDeclaration, Schema as JSONSchema } from '@google/genai';
 import { LanguageModel } from 'ai';
 import * as z from 'zod';
@@ -57,6 +57,15 @@ declare class Logger {
     private arrayToLines;
 }
 
+/**
+ * Event compaction data structure containing the summarized content
+ * and the timestamp range it covers.
+ */
+interface EventCompaction {
+    startTimestamp: number;
+    endTimestamp: number;
+    compactedContent: Content;
+}
 /**
  * Represents the actions attached to an event.
  */
@@ -87,6 +96,11 @@ declare class EventActions {
      * Requested authentication configurations.
      */
     requestedAuthConfigs?: Record<string, any>;
+    /**
+     * Event compaction information. When set, this event represents
+     * a compaction of events within the specified timestamp range.
+     */
+    compaction?: EventCompaction;
     /**
      * Constructor for EventActions
      */
@@ -97,6 +111,7 @@ declare class EventActions {
         transferToAgent?: string;
         escalate?: boolean;
         requestedAuthConfigs?: Record<string, any>;
+        compaction?: EventCompaction;
     });
 }
 
@@ -4021,6 +4036,45 @@ declare class LangGraphAgent extends BaseAgent {
     setMaxSteps(maxSteps: number): void;
 }
 
+/**
+ * Base interface for event summarizers.
+ * Implementations convert a list of events into a single compaction event.
+ */
+interface EventsSummarizer {
+    /**
+     * Attempts to summarize a list of events into a single compaction event.
+     * @param events - The events to summarize
+     * @returns A compaction carrier event with actions.compaction set, or undefined if no summarization is needed
+     */
+    maybeSummarizeEvents(events: Event[]): Promise<Event | undefined>;
+}
+
+/**
+ * Configuration for event compaction feature.
+ * Controls how and when session histories are compacted via summarization.
+ */
+interface EventsCompactionConfig {
+    /**
+     * The summarizer to use for compacting events.
+     * If not provided, a default LLM-based summarizer will be used.
+     */
+    summarizer?: EventsSummarizer;
+    /**
+     * Number of new invocations required to trigger compaction.
+     * When this many new invocations have been completed since the last
+     * compaction, a new compaction will be triggered.
+     * Default: 10
+     */
+    compactionInterval: number;
+    /**
+     * Number of prior invocations to include from the previous compacted
+     * range for continuity when creating a new compaction.
+     * This ensures some overlap between successive summaries.
+     * Default: 2
+     */
+    overlapSize: number;
+}
+
 /**
  * Configuration options for the AgentBuilder
  */
@@ -4161,6 +4215,7 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
     private sessionOptions?;
     private memoryService?;
     private artifactService?;
+    private eventsCompactionConfig?;
     private agentType;
     private existingSession?;
     private existingAgent?;
@@ -4273,6 +4328,12 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
      * @returns This builder instance for chaining
      */
     withAfterToolCallback(callback: AfterToolCallback): 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: BaseAgent): AgentBuilder<string, false>;
     /**
      * Provide an already constructed agent instance. Further definition-mutating calls
      * (model/tools/instruction/etc.) will be ignored with a dev warning.
@@ -4334,6 +4395,23 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
      * Configure runtime behavior for runs
      */
     withRunConfig(config: RunConfig | Partial<RunConfig>): 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: EventsCompactionConfig): 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
@@ -4834,12 +4912,46 @@ declare class InMemoryArtifactService implements BaseArtifactService {
     }): Promise<number[]>;
 }
 
+/**
+ * LLM-based event summarizer that uses a language model to generate summaries.
+ */
+declare class LlmEventSummarizer implements EventsSummarizer {
+    private model;
+    private prompt;
+    /**
+     * 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: BaseLlm, prompt?: string);
+    /**
+     * Summarizes events using the configured LLM.
+     */
+    maybeSummarizeEvents(events: Event[]): Promise<Event | undefined>;
+    /**
+     * Formats events into a readable text format for summarization.
+     */
+    private formatEventsForSummarization;
+}
+
+/**
+ * Runs compaction for a sliding window of invocations.
+ * This function implements the core sliding window logic from ADK Python.
+ */
+declare function runCompactionForSlidingWindow(config: EventsCompactionConfig, session: Session, sessionService: BaseSessionService, summarizer: EventsSummarizer): Promise<void>;
+
 type index$2_Event = Event;
 declare const index$2_Event: typeof Event;
 type index$2_EventActions = EventActions;
 declare const index$2_EventActions: typeof EventActions;
+type index$2_EventCompaction = EventCompaction;
+type index$2_EventsCompactionConfig = EventsCompactionConfig;
+type index$2_EventsSummarizer = EventsSummarizer;
+type index$2_LlmEventSummarizer = LlmEventSummarizer;
+declare const index$2_LlmEventSummarizer: typeof LlmEventSummarizer;
+declare const index$2_runCompactionForSlidingWindow: typeof runCompactionForSlidingWindow;
 declare namespace index$2 {
-  export { index$2_Event as Event, index$2_EventActions as EventActions };
+  export { index$2_Event as Event, index$2_EventActions as EventActions, type index$2_EventCompaction as EventCompaction, type index$2_EventsCompactionConfig as EventsCompactionConfig, type index$2_EventsSummarizer as EventsSummarizer, index$2_LlmEventSummarizer as LlmEventSummarizer, index$2_runCompactionForSlidingWindow as runCompactionForSlidingWindow };
 }
 
 declare abstract class BaseLlmFlow {
@@ -5537,16 +5649,21 @@ declare class Runner<T extends BaseAgent = BaseAgent> {
      * The memory service for the runner.
      */
     memoryService?: BaseMemoryService;
+    /**
+     * Configuration for event compaction.
+     */
+    eventsCompactionConfig?: EventsCompactionConfig;
     protected logger: Logger;
     /**
      * Initializes the Runner.
      */
-    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
+    constructor({ appName, agent, artifactService, sessionService, memoryService, eventsCompactionConfig, }: {
         appName: string;
         agent: T;
         artifactService?: BaseArtifactService;
         sessionService: BaseSessionService;
         memoryService?: BaseMemoryService;
+        eventsCompactionConfig?: EventsCompactionConfig;
     });
     /**
      * Runs the agent synchronously.
@@ -5584,6 +5701,14 @@ declare class Runner<T extends BaseAgent = BaseAgent> {
      * Creates a new invocation context.
      */
     private _newInvocationContext;
+    /**
+     * Runs compaction if configured.
+     */
+    private _runCompaction;
+    /**
+     * Gets the configured summarizer or creates a default LLM-based one.
+     */
+    private _getOrCreateSummarizer;
 }
 /**
  * An in-memory Runner for testing and development.
@@ -5673,4 +5798,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EnhancedAuthConfig, type EnhancedRunner, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, index$2 as Events, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$1 as Flows, type FullMessage, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$4 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type PerInvocationResult, PlanReActPlanner, PrebuiltMetrics, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$3 as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$7 as Tools, TrajectoryEvaluator, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EnhancedAuthConfig, type EnhancedRunner, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$2 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$1 as Flows, type FullMessage, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$4 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type PerInvocationResult, PlanReActPlanner, PrebuiltMetrics, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$3 as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$7 as Tools, TrajectoryEvaluator, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Part, Content, Blob, SpeechConfig, AudioTranscriptionConfig, RealtimeInputConfig, ProactivityConfig, FunctionDeclaration, GroundingMetadata, GenerateContentResponseUsageMetadata, GenerateContentConfig, Schema, LiveConnectConfig, GoogleGenAI, FunctionCall } from '@google/genai';
+import { Content, Part, Blob, SpeechConfig, AudioTranscriptionConfig, RealtimeInputConfig, ProactivityConfig, FunctionDeclaration, GroundingMetadata, GenerateContentResponseUsageMetadata, GenerateContentConfig, Schema, LiveConnectConfig, GoogleGenAI, FunctionCall } from '@google/genai';
 export { Blob, Content, FunctionDeclaration, Schema as JSONSchema } from '@google/genai';
 import { LanguageModel } from 'ai';
 import * as z from 'zod';
@@ -57,6 +57,15 @@ declare class Logger {
     private arrayToLines;
 }
 
+/**
+ * Event compaction data structure containing the summarized content
+ * and the timestamp range it covers.
+ */
+interface EventCompaction {
+    startTimestamp: number;
+    endTimestamp: number;
+    compactedContent: Content;
+}
 /**
  * Represents the actions attached to an event.
  */
@@ -87,6 +96,11 @@ declare class EventActions {
      * Requested authentication configurations.
      */
     requestedAuthConfigs?: Record<string, any>;
+    /**
+     * Event compaction information. When set, this event represents
+     * a compaction of events within the specified timestamp range.
+     */
+    compaction?: EventCompaction;
     /**
      * Constructor for EventActions
      */
@@ -97,6 +111,7 @@ declare class EventActions {
         transferToAgent?: string;
         escalate?: boolean;
         requestedAuthConfigs?: Record<string, any>;
+        compaction?: EventCompaction;
     });
 }
 
@@ -4021,6 +4036,45 @@ declare class LangGraphAgent extends BaseAgent {
     setMaxSteps(maxSteps: number): void;
 }
 
+/**
+ * Base interface for event summarizers.
+ * Implementations convert a list of events into a single compaction event.
+ */
+interface EventsSummarizer {
+    /**
+     * Attempts to summarize a list of events into a single compaction event.
+     * @param events - The events to summarize
+     * @returns A compaction carrier event with actions.compaction set, or undefined if no summarization is needed
+     */
+    maybeSummarizeEvents(events: Event[]): Promise<Event | undefined>;
+}
+
+/**
+ * Configuration for event compaction feature.
+ * Controls how and when session histories are compacted via summarization.
+ */
+interface EventsCompactionConfig {
+    /**
+     * The summarizer to use for compacting events.
+     * If not provided, a default LLM-based summarizer will be used.
+     */
+    summarizer?: EventsSummarizer;
+    /**
+     * Number of new invocations required to trigger compaction.
+     * When this many new invocations have been completed since the last
+     * compaction, a new compaction will be triggered.
+     * Default: 10
+     */
+    compactionInterval: number;
+    /**
+     * Number of prior invocations to include from the previous compacted
+     * range for continuity when creating a new compaction.
+     * This ensures some overlap between successive summaries.
+     * Default: 2
+     */
+    overlapSize: number;
+}
+
 /**
  * Configuration options for the AgentBuilder
  */
@@ -4161,6 +4215,7 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
     private sessionOptions?;
     private memoryService?;
     private artifactService?;
+    private eventsCompactionConfig?;
     private agentType;
     private existingSession?;
     private existingAgent?;
@@ -4273,6 +4328,12 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
      * @returns This builder instance for chaining
      */
     withAfterToolCallback(callback: AfterToolCallback): 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: BaseAgent): AgentBuilder<string, false>;
     /**
      * Provide an already constructed agent instance. Further definition-mutating calls
      * (model/tools/instruction/etc.) will be ignored with a dev warning.
@@ -4334,6 +4395,23 @@ declare class AgentBuilder<TOut = string, TMulti extends boolean = false> {
      * Configure runtime behavior for runs
      */
     withRunConfig(config: RunConfig | Partial<RunConfig>): 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: EventsCompactionConfig): 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
@@ -4834,12 +4912,46 @@ declare class InMemoryArtifactService implements BaseArtifactService {
     }): Promise<number[]>;
 }
 
+/**
+ * LLM-based event summarizer that uses a language model to generate summaries.
+ */
+declare class LlmEventSummarizer implements EventsSummarizer {
+    private model;
+    private prompt;
+    /**
+     * 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: BaseLlm, prompt?: string);
+    /**
+     * Summarizes events using the configured LLM.
+     */
+    maybeSummarizeEvents(events: Event[]): Promise<Event | undefined>;
+    /**
+     * Formats events into a readable text format for summarization.
+     */
+    private formatEventsForSummarization;
+}
+
+/**
+ * Runs compaction for a sliding window of invocations.
+ * This function implements the core sliding window logic from ADK Python.
+ */
+declare function runCompactionForSlidingWindow(config: EventsCompactionConfig, session: Session, sessionService: BaseSessionService, summarizer: EventsSummarizer): Promise<void>;
+
 type index$2_Event = Event;
 declare const index$2_Event: typeof Event;
 type index$2_EventActions = EventActions;
 declare const index$2_EventActions: typeof EventActions;
+type index$2_EventCompaction = EventCompaction;
+type index$2_EventsCompactionConfig = EventsCompactionConfig;
+type index$2_EventsSummarizer = EventsSummarizer;
+type index$2_LlmEventSummarizer = LlmEventSummarizer;
+declare const index$2_LlmEventSummarizer: typeof LlmEventSummarizer;
+declare const index$2_runCompactionForSlidingWindow: typeof runCompactionForSlidingWindow;
 declare namespace index$2 {
-  export { index$2_Event as Event, index$2_EventActions as EventActions };
+  export { index$2_Event as Event, index$2_EventActions as EventActions, type index$2_EventCompaction as EventCompaction, type index$2_EventsCompactionConfig as EventsCompactionConfig, type index$2_EventsSummarizer as EventsSummarizer, index$2_LlmEventSummarizer as LlmEventSummarizer, index$2_runCompactionForSlidingWindow as runCompactionForSlidingWindow };
 }
 
 declare abstract class BaseLlmFlow {
@@ -5537,16 +5649,21 @@ declare class Runner<T extends BaseAgent = BaseAgent> {
      * The memory service for the runner.
      */
     memoryService?: BaseMemoryService;
+    /**
+     * Configuration for event compaction.
+     */
+    eventsCompactionConfig?: EventsCompactionConfig;
     protected logger: Logger;
     /**
      * Initializes the Runner.
      */
-    constructor({ appName, agent, artifactService, sessionService, memoryService, }: {
+    constructor({ appName, agent, artifactService, sessionService, memoryService, eventsCompactionConfig, }: {
         appName: string;
         agent: T;
         artifactService?: BaseArtifactService;
         sessionService: BaseSessionService;
         memoryService?: BaseMemoryService;
+        eventsCompactionConfig?: EventsCompactionConfig;
     });
     /**
      * Runs the agent synchronously.
@@ -5584,6 +5701,14 @@ declare class Runner<T extends BaseAgent = BaseAgent> {
      * Creates a new invocation context.
      */
     private _newInvocationContext;
+    /**
+     * Runs compaction if configured.
+     */
+    private _runCompaction;
+    /**
+     * Gets the configured summarizer or creates a default LLM-based one.
+     */
+    private _getOrCreateSummarizer;
 }
 /**
  * An in-memory Runner for testing and development.
@@ -5673,4 +5798,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EnhancedAuthConfig, type EnhancedRunner, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, index$2 as Events, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$1 as Flows, type FullMessage, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$4 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type PerInvocationResult, PlanReActPlanner, PrebuiltMetrics, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$3 as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$7 as Tools, TrajectoryEvaluator, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DatabaseSessionService, EnhancedAuthConfig, type EnhancedRunner, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$2 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$1 as Flows, type FullMessage, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$4 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type PerInvocationResult, PlanReActPlanner, PrebuiltMetrics, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index$3 as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$7 as Tools, TrajectoryEvaluator, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };