Update doc

Author: serge-p7v

agents/agents-features/agents-features-longterm-memory/Module.md

@@ -19,9 +19,9 @@ The agents-features-longterm-memory module adds long-term memory capabilities to
 | [`LongTermMemory`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/feature/LongTermMemory.kt)                              | Agent feature with DSL config for retrieval & ingestion                |
 | [`SearchStorage`](../../../../../../rag/rag-base/src/commonMain/kotlin/ai/koog/rag/base/storage/SearchStorage.kt)              | Interface for searching memory records (defined in `rag-base`)         |
 | [`WriteStorage`](../../../../../../rag/rag-base/src/commonMain/kotlin/ai/koog/rag/base/storage/WriteStorage.kt)                | Interface for adding memory records (defined in `rag-base`)            |
-| [`SearchStrategy`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/SearchStrategy.kt)                            | Converts user query into a `SearchRequest`; `SimilaritySearchStrategy` is the default implementation |
-| [`SearchQueryProvider`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/SearchQueryProvider.kt)                  | Provides the search query string from a `Prompt` for retrieval         |
-| [`LastUserMessageQueryProvider`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/LastUserMessageQueryProvider.kt) | Default `SearchQueryProvider` that uses the last user message content  |
+| [`SearchStrategy`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/search/SearchStrategy.kt)                            | Converts user query into a `SearchRequest`; `SimilaritySearchStrategy` is the default implementation |
+| [`SearchQueryProvider`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/search/SearchQueryProvider.kt)                  | Provides the search query string from a `Prompt` for retrieval         |
+| [`LastUserMessageQueryProvider`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/search/LastUserMessageQueryProvider.kt) | Default `SearchQueryProvider` that uses the last user message content  |
 | [`DocumentExtractor`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/ingestion/extraction/DocumentExtractor.kt)           | Transforms messages into `TextDocument`s for storage                   |
 | [`MessagePassingDocumentExtractor`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/ingestion/extraction/MessagePassingDocumentExtractor.kt) | Default `DocumentExtractor`; filters messages by role (`User`/`Assistant` by default) |
 | [`PromptAugmenter`](src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/augmentation/PromptAugmenter.kt)             | Interface for augmenting prompts with relevant context                 |

agents/agents-features/agents-features-longterm-memory/src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/RetrievalSettings.kt

@@ -15,7 +15,7 @@ import ai.koog.rag.base.storage.search.SearchRequest
  * Settings controlling how memory records are retrieved and injected into prompts (RAG).
  *
  * @param storage The retrieval storage to search for relevant memory records.
- * @param searchQueryProvider The extractor that defines how to derive the search query from the prompt.
+ * @param searchQueryProvider The provider that defines how to derive the search query from the prompt.
  *   Defaults to [ai.koog.agents.longtermmemory.retrieval.search.LastUserMessageQueryProvider], which uses the last user message content.
  * @param searchStrategy The strategy that defines how to search the retrieval store.
  * @param promptAugmenter The augmenter that defines how retrieved context is inserted into the prompt.

agents/agents-features/agents-features-longterm-memory/src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/augmentation/SystemPromptAugmenter.kt

@@ -9,8 +9,7 @@ import ai.koog.rag.base.storage.search.SearchResult
 /**
  * A [PromptAugmenter] that inserts retrieved context as a system message at the beginning of the prompt.
  *
- * If an existing system message is present, the new context system message is inserted
- * before it, keeping each system message focused on a single concern.
+ * The new context system message is prepended before all existing messages.
  * If there is no system message in the prompt, the prompt is returned unchanged.
  *
  * @param template The template for the system message. Use [PromptAugmenter.RELEVANT_CONTEXT_PLACEHOLDER] placeholder.

agents/agents-features/agents-features-longterm-memory/src/commonMain/kotlin/ai/koog/agents/longtermmemory/retrieval/search/SearchStrategy.kt

@@ -8,7 +8,7 @@ import kotlin.jvm.JvmStatic
  * Search strategy for creating search requests during prompt augmentation.
  *
  * This is a functional interface (SAM) that defines how a user query string
- * should be transformed into a [SimilaritySearchRequest] for storage.
+ * should be transformed into a [SearchRequest] for storage.
  *
  * **[SimilaritySearchStrategy] is the default implementation.**
  * It uses vector embeddings for semantic search and works with all supported vector backends.

agents/agents-features/agents-features-longterm-memory/src/commonMain/kotlin/ai/koog/agents/longtermmemory/storage/InMemoryRecordStorage.kt

@@ -18,8 +18,8 @@ import kotlin.uuid.ExperimentalUuidApi
 import kotlin.uuid.Uuid
 
 /**
- * In-memory implementation of [SearchStorage]
- * and [WriteStorage] that stores records in a map.
+ * In-memory implementation of [SearchStorage], [WriteStorage], [LookupStorage],
+ * and [DeletionStorage] that stores records in a map.
  *
  * This implementation is useful for testing, development, and scenarios where persistence
  * is not required. All data is stored in memory and will be lost when the application stops.

docs/docs/features/long-term-memory.md

@@ -175,7 +175,7 @@ Ingestion runs once when the agent run completes: the final accumulated session
 
 ## Disabling Automatic Behavior
 
-By default, retrieval and ingestion run automatically (before and after LLM calls, respectively). You can disable automatic behavior while still having access to the configured storage and strategies from within strategy nodes:
+By default, retrieval and ingestion run automatically (retrieval runs before each LLM call; ingestion runs once when the agent completes). You can disable automatic behavior while still having access to the configured storage and strategies from within strategy nodes:
 
 === "Kotlin"