From d759f9637fd3fc9cf14f959105e820688bb836f6 Mon Sep 17 00:00:00 2001
From: Sreeram Sreedhar <ssreedh9@asu.edu>
Date: Sun, 19 Apr 2026 16:29:48 -0700
Subject: [PATCH] bug fixes

---
 packages/tools/src/voltagent/middleware.ts |  9 +++++++++
 packages/tools/src/voltagent/types.ts      | 14 ++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/packages/tools/src/voltagent/middleware.ts b/packages/tools/src/voltagent/middleware.ts
index 3618b241..6c90d9e4 100644
--- a/packages/tools/src/voltagent/middleware.ts
+++ b/packages/tools/src/voltagent/middleware.ts
@@ -243,6 +243,15 @@ export const enhanceMessagesWithMemories = async (
 		ctx.include !== undefined ||
 		ctx.searchMode !== undefined
 
+	// Warn if advanced search params are set but mode is "profile"
+	// Profile mode only fetches static/dynamic user data, not query-based search
+	if (useAdvancedSearch && ctx.mode === "profile") {
+		ctx.logger.warn(
+			"Advanced search parameters (threshold, limit, rerank, rewriteQuery, filters, include, searchMode) " +
+				'are ignored when mode is "profile". Use mode "query" or "full" to enable advanced search.',
+		)
+	}
+
 	let memories: string
 
 	if (useAdvancedSearch && ctx.mode !== "profile") {
diff --git a/packages/tools/src/voltagent/types.ts b/packages/tools/src/voltagent/types.ts
index 9ee9ebc7..16ef95ef 100644
--- a/packages/tools/src/voltagent/types.ts
+++ b/packages/tools/src/voltagent/types.ts
@@ -29,34 +29,46 @@ export interface SupermemoryVoltAgent
 	 * Threshold / sensitivity for memory selection. 0 is least sensitive (returns
 	 * most memories, more results), 1 is most sensitive (returns fewer memories,
 	 * more accurate results). Default: 0.1
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	threshold?: number
 
 	/**
 	 * Maximum number of memory results to return. Default: 10
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	limit?: number
 
 	/**
 	 * If true, rerank the results based on the query. This helps ensure the most
 	 * relevant results are returned. Default: false
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	rerank?: boolean
 
 	/**
 	 * If true, rewrites the query to make it easier to find memories. This increases
 	 * latency by about 400ms. Default: false
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	rewriteQuery?: boolean
 
 	/**
 	 * Advanced filters to apply to the search using AND/OR logic.
 	 * Example: { OR: [{ metadata: { type: "note" } }, { metadata: { type: "conversation" } }] }
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	filters?: SearchFilters
 
 	/**
 	 * Control what additional data to include in search results
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	include?: IncludeOptions
 
@@ -71,6 +83,8 @@ export interface SupermemoryVoltAgent
 	 * - "memories": Search only memory entries (atomic facts)
 	 * - "documents": Search only document chunks
 	 * - "hybrid": Search both memories AND document chunks (recommended)
+	 *
+	 * Note: Only effective when mode is "query" or "full". Ignored in "profile" mode.
 	 */
 	searchMode?: "memories" | "documents" | "hybrid"