aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMahesh Sanikommmu <[email protected]>2025-10-19 18:21:48 -0700
committerMahesh Sanikommmu <[email protected]>2025-10-19 18:21:48 -0700
commitde6a1aef9ca3bc4630f3621ac98d8c9c6b569286 (patch)
treebbfe4d0c637c336fcb2049a0f035bfaca04af93b
parentadd conversationId functionality to map to customId in ingestion (#499) (diff)
downloadsupermemory-de6a1aef9ca3bc4630f3621ac98d8c9c6b569286.tar.xz
supermemory-de6a1aef9ca3bc4630f3621ac98d8c9c6b569286.zip
fix(tools): update the docs for conversational
-rw-r--r--packages/tools/README.md26
-rw-r--r--packages/tools/package.json2
2 files changed, 24 insertions, 4 deletions
diff --git a/packages/tools/README.md b/packages/tools/README.md
index 2b3f51d9..aae102f3 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -62,9 +62,6 @@ const addTool = addMemoryTool(process.env.SUPERMEMORY_API_KEY!, {
#### AI SDK Middleware with Supermemory
-> [!CAUTION]
-> `withSupermemory` is in beta
-
- `withSupermemory` will take advantage supermemory profile v4 endpoint personalized based on container tag
- Make sure you have `SUPERMEMORY_API_KEY` in env
@@ -83,6 +80,27 @@ const result = await generateText({
console.log(result.text)
```
+#### Conversation Grouping
+
+Use the `conversationId` option to group messages into a single document for contextual memory generation:
+
+```typescript
+import { generateText } from "ai"
+import { withSupermemory } from "@supermemory/tools/ai-sdk"
+import { openai } from "@ai-sdk/openai"
+
+const modelWithMemory = withSupermemory(openai("gpt-5"), "user_id_life", {
+ conversationId: "conversation-456"
+})
+
+const result = await generateText({
+ model: modelWithMemory,
+ messages: [{ role: "user", content: "where do i live?" }],
+})
+
+console.log(result.text)
+```
+
#### Verbose Mode
Enable verbose logging to see detailed information about memory search and transformation:
@@ -280,12 +298,14 @@ The `withSupermemory` middleware accepts additional configuration options:
```typescript
interface WithSupermemoryOptions {
+ conversationId?: string
verbose?: boolean
mode?: "profile" | "query" | "full"
addMemory?: "always" | "never"
}
```
+- **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"
- **addMemory**: Automatic memory storage mode - "always" or "never" (default: "never")
diff --git a/packages/tools/package.json b/packages/tools/package.json
index 536d7c1c..9d820ddc 100644
--- a/packages/tools/package.json
+++ b/packages/tools/package.json
@@ -1,7 +1,7 @@
{
"name": "@supermemory/tools",
"type": "module",
- "version": "1.2.13",
+ "version": "1.2.15",
"description": "Memory tools for AI SDK and OpenAI function calling with supermemory",
"scripts": {
"build": "tsdown",