supermemory/packages/tools/test/chatapp
MaheshtheDev 5c24e67d60 feat(tools)!: @supermemory/tools 3.0 on the v5 API, retire @supermemory/ai-sdk (#1773)
Every integration (AI SDK, OpenAI, Mastra, VoltAgent, Claude memory) now calls v5 through `supermemory@5`. The config takes one `namespace` instead of `containerTags` or `projectId`, and `withSupermemory` takes `namespace` and `id` instead of `containerTag` and `customId`. No aliases. With no config the tools still use `sm_project_default`.

Conversations are stored as one document per conversation keyed by `id` instead of `/v4/conversations`. `memoryForget` drops `reason`; forgetting by text previews with `forgetMatching` and then forgets exact matches by id. Claude memory marks its files with `metadata.source` instead of a second tag. Search keeps the 2.x defaults so results do not shift.

`packages/ai-sdk` is removed: npm already deprecates it in favor of `@supermemory/tools/ai-sdk`, so its CI steps and playground wiring go too. `apps/sdk-playground` moves to the new tools API and v5 routes, including its Python server.

Tested against production: add, search, profile, list and delete. 112 unit tests pass; type errors drop from 148 to 141, none new. The `supermemory` dependency pins the rc until 5.0.0 is published.
2026-10-06 17:03:47 +00:00
..
app feat(tools)!: @supermemory/tools 3.0 on the v5 API, retire @supermemory/ai-sdk (#1773) 2026-10-06 17:03:47 +00:00
public chat app withSupermemory test 2025-10-22 14:00:59 -07:00
.gitignore Support for conversations in SDKs (#618) 2025-12-20 00:46:13 +00:00
bun.lock fix(chatapp): patch high severity transitive dependencies (#1723) 2026-09-29 15:28:16 -07:00
eslint.config.mjs feat: mobile responsive, lint formats, toast, render issue fix (#688) 2026-01-21 03:11:53 +00:00
next.config.ts feat: mobile responsive, lint formats, toast, render issue fix (#688) 2026-01-21 03:11:53 +00:00
package.json fix(chatapp): patch high severity transitive dependencies (#1723) 2026-09-29 15:28:16 -07:00
postcss.config.mjs feat: mobile responsive, lint formats, toast, render issue fix (#688) 2026-01-21 03:11:53 +00:00
README.md chat app withSupermemory test 2025-10-22 14:00:59 -07:00
tsconfig.json feat: mobile responsive, lint formats, toast, render issue fix (#688) 2026-01-21 03:11:53 +00:00

Chat App - Test Application

This is a basic Next.js chat application created for testing the Supermemory packages and tools. It demonstrates how to integrate Supermemory with a simple chat interface.

Features

  • Real-time Chat Interface: Clean, modern chat UI with message bubbles
  • Supermemory Integration: Uses Supermemory tools for enhanced AI conversations
  • Responsive Design: Works on desktop and mobile devices
  • Dark Mode Support: Automatic theme switching based on system preferences
  • Loading States: Visual feedback during AI processing
  • Error Handling: Graceful error handling for API failures

Tech Stack

  • Next.js 16: React framework with App Router
  • React 19: Latest React with concurrent features
  • TypeScript: Full type safety
  • Tailwind CSS: Utility-first styling
  • AI SDK: OpenAI integration for chat functionality
  • Supermemory: Memory management and retrieval

Getting Started

  1. Install Dependencies:

    npm install
    
  2. Set up Environment Variables: Create a .env.local file with your API keys:

    OPENAI_API_KEY=your_openai_api_key_here
    SUPERMEMORY_API_KEY=your_supermemory_api_key_here
    
  3. Run the Development Server:

    npm run dev
    
  4. Open in Browser: Navigate to http://localhost:3000

Usage

  • Type a message in the input field and press Enter or click Send
  • The AI will respond using Supermemory for context-aware conversations
  • Messages are displayed in a chat bubble format
  • Loading indicator shows when the AI is processing

Testing Supermemory Features

This app is specifically designed to test:

  • Memory storage and retrieval
  • Context-aware conversations
  • Package integration
  • API functionality
  • UI/UX patterns

Development

This is a test application and should not be used in production. It's designed for:

  • Testing Supermemory package functionality
  • Demonstrating integration patterns
  • UI/UX experimentation
  • Development and debugging

File Structure

app/
├── api/chat/route.ts    # API endpoint for chat functionality
├── globals.css          # Global styles and Tailwind imports
├── layout.tsx           # Root layout with fonts and metadata
└── page.tsx            # Main chat interface component