fixed merge conflicts and updated conversationid bug

Author: sreedharsreeram

packages/tools/src/voltagent/hooks.ts

@@ -35,7 +35,7 @@ import {
  * const hooks = createSupermemoryHooks("user-123", {
  *   mode: "full",
  *   addMemory: "always",
- *   threadId: "conv-456",
+ *   conversationId: "conv-456",
  * })
  *
  * const agent = new Agent({
@@ -49,7 +49,7 @@ import {
  */
 export function createSupermemoryHooks(
 	containerTag: string,
-	options: SupermemoryVoltAgent = {},
+	options: SupermemoryVoltAgent,
 ): VoltAgentHooks {
 	const ctx = createSupermemoryContext(containerTag, options)
 

packages/tools/src/voltagent/index.ts

@@ -27,7 +27,7 @@ import type { VoltAgentConfig, SupermemoryVoltAgent } from "./types"
  * @param options.containerTag - Required. The container tag/user ID for scoping memories (e.g., "user-123")
  * @param options.mode - Memory retrieval mode: "profile" (default), "query", or "full"
  * @param options.addMemory - Memory persistence: "always" (default for VoltAgent) or "never"
- * @param options.threadId - Optional conversation/thread ID to group messages
+ * @param options.conversationId - Conversation ID to group messages into a single document
  * @param options.apiKey - Supermemory API key (falls back to SUPERMEMORY_API_KEY env var)
  * @param options.baseUrl - Custom Supermemory API base URL
  * @param options.promptTemplate - Custom function to format memory data into prompt
@@ -37,7 +37,6 @@ import type { VoltAgentConfig, SupermemoryVoltAgent } from "./types"
  * @param options.rewriteQuery - If true, AI-rewrite query for better results (+400ms latency). Default: false
  * @param options.filters - Advanced AND/OR filters for search
  * @param options.include - Control what additional data to include (chunks, documents, etc.)
- * @param options.customId - Optional custom ID for document creation (alternative to threadId)
  * @param options.metadata - Optional metadata to attach to saved conversations
  * @param options.searchMode - Search mode: "memories" (atomic facts), "documents" (chunks), or "hybrid" (both)
  * @param options.entityContext - Context for memory extraction (max 1500 chars), guides how memories are understood
@@ -84,7 +83,7 @@ import type { VoltAgentConfig, SupermemoryVoltAgent } from "./types"
  *   containerTag: "user-123",  // Required: user/project ID
  *   mode: "full",              // "profile" | "query" | "full"
  *   addMemory: "always",       // "always" | "never"
- *   threadId: "conv-456",      // Group messages by conversation
+ *   conversationId: "conv-456", // Group messages by conversation
  *   threshold: 0.7,            // 0.0-1.0 (higher = more accurate)
  *   limit: 15,                 // Max results to return
  *   rerank: true,              // Rerank for best relevance

packages/tools/src/voltagent/middleware.ts

@@ -27,7 +27,7 @@ export interface SupermemoryMiddlewareContext {
 	client: Supermemory
 	logger: Logger
 	containerTag: string
-	threadId?: string
+	conversationId: string
 	mode: MemoryMode
 	addMemory: "always" | "never"
 	normalizedBaseUrl: string
@@ -56,7 +56,6 @@ export interface SupermemoryMiddlewareContext {
 		summaries?: boolean
 	}
 	// Storage parameters
-	customId?: string
 	metadata?: Record<string, string | number | boolean>
 	searchMode?: "memories" | "documents" | "hybrid"
 	entityContext?: string
@@ -67,7 +66,7 @@ export interface SupermemoryMiddlewareContext {
  */
 export const createSupermemoryContext = (
 	containerTag: string,
-	options: SupermemoryVoltAgent = {},
+	options: SupermemoryVoltAgent,
 ): SupermemoryMiddlewareContext => {
 	const apiKey = options.apiKey ?? process.env.SUPERMEMORY_API_KEY
 	if (!apiKey) {
@@ -77,7 +76,7 @@ export const createSupermemoryContext = (
 	}
 
 	const {
-		threadId,
+		conversationId,
 		mode = "profile",
 		addMemory = "always", // VoltAgent default: save conversations by default for chat apps
 		baseUrl,
@@ -88,7 +87,6 @@ export const createSupermemoryContext = (
 		rewriteQuery,
 		filters,
 		include,
-		customId,
 		metadata,
 		searchMode,
 		entityContext,
@@ -108,7 +106,7 @@ export const createSupermemoryContext = (
 		client,
 		logger,
 		containerTag,
-		threadId,
+		conversationId,
 		mode,
 		addMemory,
 		normalizedBaseUrl,
@@ -121,7 +119,6 @@ export const createSupermemoryContext = (
 		rewriteQuery,
 		filters,
 		include,
-		customId,
 		metadata,
 		searchMode,
 		entityContext,
@@ -137,7 +134,7 @@ const makeTurnKey = (
 ): string => {
 	return MemoryCache.makeTurnKey(
 		ctx.containerTag,
-		ctx.threadId,
+		ctx.conversationId,
 		ctx.mode,
 		userMessage,
 	)
@@ -218,7 +215,7 @@ export const enhanceMessagesWithMemories = async (
 
 	ctx.logger.info("Starting memory search", {
 		containerTag: ctx.containerTag,
-		threadId: ctx.threadId,
+		conversationId: ctx.conversationId,
 		mode: ctx.mode,
 		isNewTurn,
 	})
@@ -444,13 +441,7 @@ export const saveConversation = async (
 		return
 	}
 
-	const conversationId = ctx.threadId || ctx.customId
-	if (!conversationId) {
-		ctx.logger.debug(
-			"No threadId or customId provided, skipping conversation save",
-		)
-		return
-	}
+	const conversationId = ctx.conversationId
 
 	try {
 		const conversationMessages = convertToConversationMessages(messages)

packages/tools/src/voltagent/types.ts

@@ -20,10 +20,10 @@ import type {
 export interface SupermemoryVoltAgent
 	extends Omit<SupermemoryBaseOptions, "verbose"> {
 	/**
-	 * When using memory storage, set this to enable automatic conversation saving.
-	 * The threadId is used to group messages into a single conversation.
+	 * Conversation ID to group messages into a single document.
+	 * Ensures related messages are added to the same document for that conversation.
 	 */
-	threadId?: string
+	conversationId: string
 
 	/**
 	 * Threshold / sensitivity for memory selection. 0 is least sensitive (returns
@@ -60,11 +60,6 @@ export interface SupermemoryVoltAgent
 	 */
 	include?: IncludeOptions
 
-	/**
-	 * Optional custom ID for document creation (alternative to threadId).
-	 * Max 100 characters, alphanumeric with hyphens and underscores only.
-	 */
-	customId?: string
 
 	/**
 	 * Optional metadata to attach to saved documents/conversations.