addEventsToMemory

open suspend override fun addEventsToMemory(appName: String, userId: String, events: List<Event>, sessionId: String?, customMetadata: Map<String, Any?>?)

Adds an explicit list of events to the memory service.

This is intended for cases where callers want to persist only a subset of events (e.g., the latest turn), rather than re-ingesting the full session.

Implementations should treat events as an incremental update (delta) and must not assume it represents the full session.

Parameters

appName

The application name for memory scope.

userId

The user ID for memory scope.

events

The events to add to memory.

sessionId

Optional session ID for memory scope/partitioning.

customMetadata

Optional, portable metadata for memory generation.