Vercel AI SDK backfilling

apps/docs/ai-sdk/overview.mdx

@@ -40,6 +40,7 @@ const result = await generateText({
 
   ```typescript
   const modelWithMemory = withSupermemory(openai("gpt-5"), "user-123", {
+    conversationId: "conv-1",
     addMemory: "always"
   })
   ```

apps/docs/ai-sdk/user-profiles.mdx

@@ -50,6 +50,7 @@ All of this happens transparently - you write code as if using a normal model, b
 
   ```typescript
   const model = withSupermemory(openai("gpt-5"), "user-123", {
+    conversationId: "conv-1",
     addMemory: "always"
   })
   ```
@@ -117,6 +118,32 @@ const result = await generateText({
 // Uses both profile (user's expertise) AND search (previous debugging sessions)
 ```
 
+### Hybrid Search Mode 
+
+Use `searchMode: "hybrid"` to search both memories AND document chunks. 
+
+```typescript
+const model = withSupermemory(openai("gpt-4"), "user-123", { 
+  mode: "full",
+  searchMode: "hybrid",  // Search memories + document chunks
+  searchLimit: 15        // Max results (default: 10)
+})
+
+const result = await generateText({
+  model,
+  messages: [{ 
+    role: "user", 
+    content: "What's in my documents about quarterly goals?" 
+  }]
+})
+// Searches both extracted memories AND raw document content
+```
+
+**Search Mode Options:**
+- `"memories"` (default) - Search only memory entries
+- `"hybrid"` - Search memories + document chunks
+- `"documents"` - Search only document chunks
+
 ## Custom Prompt Templates
 
 Customize how memories are formatted and injected into the system prompt using the `promptTemplate` option. This is useful for:

apps/docs/integrations/ai-sdk.mdx

@@ -48,6 +48,7 @@ const result = await generateText({
 
   ```typescript
   const modelWithMemory = withSupermemory(openai("gpt-5"), "user-123", {
+    conversationId: "conv-1",
     addMemory: "always"
   })
   ```

packages/tools/README.md

@@ -184,6 +184,29 @@ const result = await generateText({
 })
 ```
 
+**Hybrid Search Mode (RAG)** - Search both memories AND document chunks:
+```typescript
+import { generateText } from "ai"
+import { withSupermemory } from "@supermemory/tools/ai-sdk"
+import { openai } from "@ai-sdk/openai"
+
+const modelWithHybrid = withSupermemory(openai("gpt-4"), "user-123", { 
+  mode: "full",
+  searchMode: "hybrid",  // Search memories + document chunks
+  searchLimit: 15        // Max results (default: 10)
+})
+
+const result = await generateText({
+  model: modelWithHybrid,
+  messages: [{ role: "user", content: "What's in my documents about quarterly goals?" }],
+})
+```
+
+Search mode options:
+- `"memories"` (default) - Search only memory entries
+- `"hybrid"` - Search memories + document chunks (recommended for RAG)
+- `"documents"` - Search only document chunks
+
 #### Automatic Memory Capture
 
 The middleware can automatically save user messages as memories:
@@ -653,6 +676,8 @@ interface WithSupermemoryOptions {
   conversationId?: string
   verbose?: boolean
   mode?: "profile" | "query" | "full"
+  searchMode?: "memories" | "hybrid" | "documents"
+  searchLimit?: number
   addMemory?: "always" | "never"
   /** Optional Supermemory API key. Use this in browser environments. */
   apiKey?: string
@@ -662,6 +687,8 @@ interface WithSupermemoryOptions {
 - **conversationId**: Optional conversation ID to group messages into a single document for contextual memory generation
 - **verbose**: Enable detailed logging of memory search and injection process (default: false)
 - **mode**: Memory search mode - "profile" (default), "query", or "full"
+- **searchMode**: Search mode - "memories" (default), "hybrid", or "documents". Use "hybrid" for RAG applications
+- **searchLimit**: Maximum number of search results when using hybrid/documents mode (default: 10)
 - **addMemory**: Automatic memory storage mode - "always" or "never" (default: "never")
 
 ## Available Tools

packages/tools/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@supermemory/tools",
   "type": "module",
-  "version": "1.4.01",
+  "version": "1.5.0",
   "description": "Memory tools for AI SDK and OpenAI function calling with supermemory",
   "scripts": {
     "build": "tsdown",

packages/tools/src/shared/index.ts

@@ -3,6 +3,7 @@ export type {
 	MemoryPromptData,
 	PromptTemplate,
 	MemoryMode,
+	SearchMode,
 	AddMemoryMode,
 	Logger,
 	ProfileStructure,
@@ -34,9 +35,12 @@ export {
 // Memory client
 export {
 	supermemoryProfileSearch,
+	supermemoryHybridSearch,
 	buildMemoriesText,
 	extractQueryText,
 	getLastUserMessageText,
 	type BuildMemoriesTextOptions,
 	type GenericMessage,
+	type SearchResultItem,
+	type SearchResponse,
 } from "./memory-client"