@cortexmemory/cli 0.26.0 → 0.27.1

package/dist/utils/schema-sync.js

@@ -12,32 +12,32 @@
  * This will use the schema files from that directory's convex-dev folder instead
  * of the installed @cortexmemory/sdk package.
  */
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, readdirSync } from "fs";
 import { copyFile, mkdir } from "fs/promises";
 import { createHash } from "crypto";
 import { join, dirname } from "path";
 import pc from "picocolors";
 /**
- * Files to sync from SDK to project
- * These are the Convex backend files that define the schema and mutations
+ * Discover all syncable files from the SDK's convex-dev folder
+ * Includes all .ts files and tsconfig.json, excludes _generated/ directory
  */
-const SCHEMA_FILES = [
-    "schema.ts",
-    "a2a.ts",
-    "admin.ts",
-    "agents.ts",
-    "contexts.ts",
-    "conversations.ts",
-    "facts.ts",
-    "governance.ts",
-    "graphSync.ts",
-    "immutable.ts",
-    "memories.ts",
-    "memorySpaces.ts",
-    "mutable.ts",
-    "users.ts",
-    "tsconfig.json",
-];
+function discoverSchemaFiles(sdkConvexPath) {
+    try {
+        const entries = readdirSync(sdkConvexPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => {
+            // Skip directories (like _generated/)
+            if (entry.isDirectory())
+                return false;
+            // Include .ts files and tsconfig.json
+            return entry.name.endsWith(".ts") || entry.name === "tsconfig.json";
+        })
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * Find the @cortexmemory/sdk package
  *
@@ -132,6 +132,12 @@ export async function syncConvexSchema(projectPath, options) {
     }
     result.sdkConvexPath = sdkConvexPath;
     result.sdkVersion = getSdkVersion(sdkPath);
+    // Discover all syncable files from SDK
+    const schemaFiles = discoverSchemaFiles(sdkConvexPath);
+    if (schemaFiles.length === 0) {
+        result.error = `No schema files found in ${sdkConvexPath}`;
+        return result;
+    }
     // Ensure project's convex folder exists
     if (!existsSync(result.projectConvexPath)) {
         if (!options?.dryRun) {
@@ -139,7 +145,7 @@ export async function syncConvexSchema(projectPath, options) {
         }
     }
     // Compare and sync each file
-    for (const fileName of SCHEMA_FILES) {
+    for (const fileName of schemaFiles) {
         const sdkFilePath = join(sdkConvexPath, fileName);
         const projectFilePath = join(result.projectConvexPath, fileName);
         // Skip if SDK doesn't have this file

package/dist/utils/schema-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-sync.js","sourceRoot":"","sources":["../../src/utils/schema-sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema-sync.js","sourceRoot":"","sources":["../../src/utils/schema-sync.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexmemory/cli",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "description": "CLI tool for managing Cortex Memory deployments, performing administrative tasks, and streamlining development workflows",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc && chmod +x dist/index.js",
+    "prebuild": "node scripts/sync-quickstart-template.js",
+    "build": "npm run prebuild && tsc && chmod +x dist/index.js",
     "dev": "tsc --watch",
     "lint": "eslint . --report-unused-disable-directives",
     "test": "node --experimental-vm-modules $(npm root)/.bin/jest",

package/templates/vercel-ai-quickstart/.env.local.example

@@ -0,0 +1,45 @@
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Required Configuration
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Your Convex deployment URL
+# Get this from: https://dashboard.convex.dev
+CONVEX_URL=https://your-project.convex.cloud
+
+# OpenAI API Key for LLM and embeddings
+# Get this from: https://platform.openai.com/api-keys
+OPENAI_API_KEY=sk-...
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Memory Space Configuration
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Default memory space for the demo
+MEMORY_SPACE_ID=quickstart-demo
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Optional: Fact Extraction (SDK v0.18.0+)
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Enable automatic LLM-powered fact extraction
+CORTEX_FACT_EXTRACTION=true
+
+# Model for fact extraction (default: gpt-4o-mini)
+CORTEX_FACT_EXTRACTION_MODEL=gpt-4o-mini
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Optional: Graph Database (SDK v0.19.0+)
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Enable automatic graph sync
+# CORTEX_GRAPH_SYNC=true
+
+# Neo4j connection (choose one)
+# NEO4J_URI=bolt://localhost:7687
+# NEO4J_USERNAME=neo4j
+# NEO4J_PASSWORD=your-password
+
+# Or Memgraph connection
+# MEMGRAPH_URI=bolt://localhost:7687
+# MEMGRAPH_USERNAME=
+# MEMGRAPH_PASSWORD=

package/templates/vercel-ai-quickstart/README.md

@@ -0,0 +1,280 @@
+# Cortex Memory + Vercel AI SDK Quickstart
+
+This is the official quickstart demo for **Cortex Memory** with the **Vercel AI SDK**. It provides an interactive visualization of how data flows through the Cortex memory orchestration system in real-time.
+
+> **SDK v0.24.0**: Now with **Belief Revision**! When users change their preferences (e.g., "I now prefer purple" after saying "I like blue"), Cortex intelligently updates or supersedes existing facts instead of creating duplicates.
+
+## Features
+
+- 🧠 **Real-time Memory Visualization** - Watch data flow through all Cortex layers (Memory Space → User → Agent → Conversation → Vector → Facts → Graph)
+- 💬 **Interactive Chat** - Send messages and see them processed with automatic memory storage
+- 📊 **Layer Flow Diagram** - Animated visualization showing latency and data at each layer
+- 🔀 **Memory Space Switching** - Demonstrate multi-tenant isolation by switching between memory spaces
+- ⚡ **Streaming Support** - Full streaming with progressive fact extraction
+- 🧹 **Belief Revision** - Intelligent fact updates when information changes (v0.24.0)
+- 🔄 **Smart Fact Deduplication** - Semantic matching prevents duplicate facts across sessions (v0.22.0)
+
+## Prerequisites
+
+- Node.js 18+
+- A Convex deployment ([get started](https://www.convex.dev/))
+- An OpenAI API key ([get one](https://platform.openai.com/api-keys))
+
+## Quick Start
+
+### Local Development (within monorepo)
+
+1. **Install dependencies**
+
+```bash
+cd packages/vercel-ai-provider/quickstart
+npm install
+```
+
+> **Note**: The `package.json` uses `file:` references to link to the local SDK and provider packages. This allows you to test changes to the provider immediately.
+
+### Using Published Packages
+
+If you want to use the published npm packages instead, update `package.json`:
+
+```json
+{
+  "dependencies": {
+    "@cortexmemory/sdk": "^0.24.0",
+    "@cortexmemory/vercel-ai-provider": "^1.0.0"
+    // ... other deps
+  }
+}
+```
+
+2. **Set up environment variables**
+
+```bash
+cp .env.local.example .env.local
+```
+
+Edit `.env.local` and add your credentials:
+
+```env
+CONVEX_URL=https://your-project.convex.cloud
+NEXT_PUBLIC_CONVEX_URL=https://your-project.convex.cloud
+OPENAI_API_KEY=sk-...
+```
+
+3. **Deploy Convex schema**
+
+```bash
+npm run convex:dev
+```
+
+4. **Start the development server**
+
+```bash
+npm run dev
+```
+
+5. **Open the demo**
+
+Visit [http://localhost:3000](http://localhost:3000) to see the demo in action.
+
+## What This Demo Shows
+
+### Memory Layer Orchestration
+
+When you send a message, you'll see it flow through these layers:
+
+| Layer            | Description                                     |
+| ---------------- | ----------------------------------------------- |
+| **Memory Space** | Isolated namespace for multi-tenancy            |
+| **User**         | User profile and identity                       |
+| **Agent**        | AI agent participant (required in SDK v0.17.0+) |
+| **Conversation** | Message storage with threading                  |
+| **Vector**       | Semantic embeddings for similarity search       |
+| **Facts**        | Extracted structured information                |
+| **Graph**        | Entity relationships (optional)                 |
+
+### Key Features Demonstrated
+
+1. **Belief Revision** - SDK v0.24.0 intelligently updates/supersedes facts when information changes
+2. **Unified Retrieval (recall)** - SDK v0.23.0 retrieves from vector + facts + graph in one call
+3. **agentId Requirement** - SDK v0.17.0+ requires `agentId` for all user-agent conversations
+4. **Automatic Fact Extraction** - LLM-powered extraction of preferences, identity, relationships
+5. **Semantic Fact Deduplication** - SDK v0.22.0 automatically prevents duplicate facts using embedding similarity
+6. **Multi-tenant Isolation** - Switch memory spaces to see complete isolation
+7. **Streaming with Memory** - Full streaming support with progressive storage
+
+## Configuration
+
+The chat API route at `/app/api/chat/route.ts` shows how to configure the Cortex Memory provider:
+
+```typescript
+import { createCortexMemory } from "@cortexmemory/vercel-ai-provider";
+import { openai, createOpenAI } from "@ai-sdk/openai";
+import { streamText, embed } from "ai";
+
+const openaiClient = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+const cortexMemory = createCortexMemory({
+  convexUrl: process.env.CONVEX_URL!,
+  memorySpaceId: "quickstart-demo",
+
+  // User identification
+  userId: "demo-user",
+  userName: "Demo User",
+
+  // Agent identification (REQUIRED in SDK v0.17.0+)
+  agentId: "quickstart-assistant",
+  agentName: "Cortex Demo Assistant",
+
+  // Optional features
+  enableGraphMemory: process.env.CORTEX_GRAPH_SYNC === "true",
+  enableFactExtraction: process.env.CORTEX_FACT_EXTRACTION === "true",
+
+  // Belief Revision (v0.24.0+)
+  // Automatically handles fact updates when user changes their mind
+  // e.g., "I like blue" → "I prefer purple" will UPDATE/SUPERSEDE the old fact
+  beliefRevision: {
+    enabled: true,
+    slotMatching: true, // Fast slot-based conflict detection
+    llmResolution: true, // LLM-based resolution for nuanced conflicts
+  },
+
+  // Embedding provider (required for semantic matching)
+  embeddingProvider: {
+    generate: async (text) => {
+      const result = await embed({
+        model: openaiClient.embedding("text-embedding-3-small"),
+        value: text,
+      });
+      return result.embedding;
+    },
+  },
+});
+
+const result = await streamText({
+  model: cortexMemory(openai("gpt-4o-mini")),
+  messages,
+});
+```
+
+## Architecture
+
+```
+quickstart/
+├── app/
+│   ├── api/
+│   │   ├── chat/route.ts      # Main chat endpoint with Cortex
+│   │   ├── memories/route.ts  # Memory inspection endpoint
+│   │   └── facts/route.ts     # Facts inspection endpoint
+│   ├── layout.tsx
+│   ├── page.tsx               # Main demo page
+│   └── globals.css
+├── components/
+│   ├── ChatInterface.tsx      # Chat UI component
+│   ├── LayerFlowDiagram.tsx   # Hero visualization component
+│   ├── LayerCard.tsx          # Individual layer status card
+│   ├── DataPreview.tsx        # Expandable data viewer
+│   └── MemorySpaceSwitcher.tsx
+├── lib/
+│   ├── layer-tracking.ts      # Layer status management
+│   └── animations.ts          # Framer Motion variants
+└── convex/
+    ├── schema.ts              # Convex schema
+    ├── conversations.ts       # Conversation queries
+    ├── memories.ts            # Memory queries
+    ├── facts.ts               # Facts queries
+    └── users.ts               # User queries
+```
+
+## Learn More
+
+- [Cortex Memory Documentation](https://cortexmemory.dev/docs)
+- [Vercel AI SDK Documentation](https://sdk.vercel.ai/docs)
+- [API Reference](/Documentation/03-api-reference/02-memory-operations.md)
+
+## Troubleshooting
+
+### "agentId is required"
+
+Since SDK v0.17.0, all user-agent conversations require an `agentId`. Add it to your configuration:
+
+```typescript
+const cortexMemory = createCortexMemory({
+  // ... other config
+  agentId: "my-assistant", // Required!
+});
+```
+
+### Memories not appearing
+
+1. Check that your Convex deployment is running
+2. Verify `CONVEX_URL` is set correctly
+3. Ensure the memory space ID matches between frontend and backend
+
+### Fact extraction not working
+
+Enable fact extraction via environment variable:
+
+```env
+CORTEX_FACT_EXTRACTION=true
+```
+
+### Duplicate facts being created
+
+Ensure you have `embeddingProvider` configured for optimal semantic deduplication:
+
+```typescript
+const cortexMemory = createCortexMemory({
+  // ... other config
+  embeddingProvider: {
+    generate: async (text) => {
+      const result = await embed({
+        model: openaiClient.embedding("text-embedding-3-small"),
+        value: text,
+      });
+      return result.embedding;
+    },
+  },
+});
+```
+
+Without `embeddingProvider`, deduplication falls back to `structural` matching (subject + predicate + object), which is less accurate for semantically similar facts.
+
+To disable deduplication entirely (not recommended):
+
+```typescript
+const cortexMemory = createCortexMemory({
+  // ... other config
+  factDeduplication: false, // Uses pre-v0.22.0 behavior
+});
+```
+
+### Facts not being updated when user changes preferences
+
+If you say "I like blue" then later say "I prefer purple" and both facts remain, enable **Belief Revision** (v0.24.0+):
+
+```typescript
+const cortexMemory = createCortexMemory({
+  // ... other config
+  beliefRevision: {
+    enabled: true,
+    slotMatching: true, // Fast detection via subject-predicate matching
+    llmResolution: true, // LLM resolves nuanced conflicts
+  },
+});
+```
+
+**Revision actions explained:**
+
+| Action      | Description                                        | Example                               |
+| ----------- | -------------------------------------------------- | ------------------------------------- |
+| `CREATE`    | New fact with no conflicts                         | First time mentioning favorite color  |
+| `UPDATE`    | Existing fact refined with new details             | "I like blue" → "I love dark blue"    |
+| `SUPERSEDE` | Old fact replaced by contradicting new information | "I like blue" → "I prefer purple now" |
+| `NONE`      | Duplicate or irrelevant, no storage needed         | Saying "I like blue" twice            |
+
+The demo visualization shows these actions with colored badges on the Facts layer.
+
+## License
+
+FSL-1.1-Apache-2.0 - See LICENSE.md in the root of the repository.

package/templates/vercel-ai-quickstart/app/api/chat/route.ts

@@ -0,0 +1,196 @@
+import { createCortexMemoryAsync } from "@cortexmemory/vercel-ai-provider";
+import type {
+  LayerObserver,
+  CortexMemoryConfig,
+} from "@cortexmemory/vercel-ai-provider";
+import { openai, createOpenAI } from "@ai-sdk/openai";
+import {
+  streamText,
+  embed,
+  convertToModelMessages,
+  createUIMessageStream,
+  createUIMessageStreamResponse,
+} from "ai";
+
+// Create OpenAI client for embeddings
+const openaiClient = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+// System prompt for the assistant
+const SYSTEM_PROMPT = `You are a helpful AI assistant with long-term memory powered by Cortex.
+
+Your capabilities:
+- You remember everything users tell you across conversations
+- You can recall facts, preferences, and context from past interactions
+- You naturally reference what you've learned about the user
+
+Behavior guidelines:
+- When you remember something from a previous conversation, mention it naturally
+- If asked about something you learned, reference it specifically
+- Be conversational and friendly
+- Help demonstrate the memory system by showing what you remember
+
+Example interactions:
+- User: "My name is Alex" → Remember and use their name
+- User: "I work at Acme Corp" → Remember their employer
+- User: "My favorite color is blue" → Remember their preference
+- User: "What do you know about me?" → List everything you remember`;
+
+// Create Cortex Memory config factory
+// Uses createCortexMemoryAsync for graph support when CORTEX_GRAPH_SYNC=true
+function getCortexMemoryConfig(
+  memorySpaceId: string,
+  userId: string,
+  layerObserver?: LayerObserver,
+): CortexMemoryConfig {
+  return {
+    convexUrl: process.env.CONVEX_URL!,
+    memorySpaceId,
+
+    // User identification
+    userId,
+    userName: "Demo User",
+
+    // Agent identification (required for user-agent conversations in SDK v0.17.0+)
+    agentId: "quickstart-assistant",
+    agentName: "Cortex Demo Assistant",
+
+    // Enable graph memory sync (auto-configured via env vars)
+    // When true, uses CypherGraphAdapter to sync to Neo4j/Memgraph
+    enableGraphMemory: process.env.CORTEX_GRAPH_SYNC === "true",
+
+    // Enable fact extraction (auto-configured via env vars)
+    enableFactExtraction: process.env.CORTEX_FACT_EXTRACTION === "true",
+
+    // Belief Revision (v0.24.0+)
+    // Automatically handles fact updates, supersessions, and deduplication
+    // When a user changes their preference (e.g., "I now prefer purple"),
+    // the system intelligently updates or supersedes the old fact.
+    beliefRevision: {
+      enabled: true, // Enable the belief revision pipeline
+      slotMatching: true, // Fast slot-based conflict detection (subject-predicate matching)
+      llmResolution: true, // LLM-based resolution for nuanced conflicts
+    },
+
+    // Embedding provider for semantic matching (required for semantic dedup & belief revision)
+    embeddingProvider: {
+      generate: async (text: string) => {
+        const result = await embed({
+          model: openaiClient.embedding("text-embedding-3-small"),
+          value: text,
+        });
+        return result.embedding;
+      },
+    },
+
+    // Streaming enhancements
+    streamingOptions: {
+      storePartialResponse: true,
+      progressiveFactExtraction: true,
+      enableAdaptiveProcessing: true,
+    },
+
+    // Memory recall configuration (v0.23.0 - unified retrieval across all layers)
+    memorySearchLimit: 20, // Results from combined vector + facts + graph search
+
+    // Real-time layer tracking (v0.24.0+)
+    // Events are emitted as each layer processes, enabling live UI updates
+    layerObserver,
+
+    // Debug in development
+    debug: process.env.NODE_ENV === "development",
+  };
+}
+
+export async function POST(req: Request) {
+  try {
+    const body = await req.json();
+    const { messages, memorySpaceId, userId } = body;
+
+    // Convert UIMessage[] from useChat to ModelMessage[] for streamText
+    // Note: In AI SDK v6+, convertToModelMessages may return a Promise
+    const modelMessagesResult = convertToModelMessages(messages);
+    const modelMessages =
+      modelMessagesResult instanceof Promise
+        ? await modelMessagesResult
+        : modelMessagesResult;
+
+    // Use createUIMessageStream to send both LLM text and layer events
+    return createUIMessageStreamResponse({
+      stream: createUIMessageStream({
+        execute: async ({ writer }) => {
+          // Create observer that writes layer events to the stream
+          // These events are transient (not persisted in message history)
+          const layerObserver: LayerObserver = {
+            onOrchestrationStart: (orchestrationId) => {
+              writer.write({
+                type: "data-orchestration-start",
+                data: { orchestrationId },
+                transient: true,
+              });
+            },
+            onLayerUpdate: (event) => {
+              writer.write({
+                type: "data-layer-update",
+                data: {
+                  layer: event.layer,
+                  status: event.status,
+                  timestamp: event.timestamp,
+                  latencyMs: event.latencyMs,
+                  data: event.data,
+                  error: event.error,
+                  revisionAction: event.revisionAction,
+                  supersededFacts: event.supersededFacts,
+                },
+                transient: true,
+              });
+            },
+            onOrchestrationComplete: (summary) => {
+              writer.write({
+                type: "data-orchestration-complete",
+                data: {
+                  orchestrationId: summary.orchestrationId,
+                  totalLatencyMs: summary.totalLatencyMs,
+                  createdIds: summary.createdIds,
+                },
+                transient: true,
+              });
+            },
+          };
+
+          // Build config with the observer
+          const config = getCortexMemoryConfig(
+            memorySpaceId || "quickstart-demo",
+            userId || "demo-user",
+            layerObserver,
+          );
+
+          // Create memory-augmented model with async initialization (enables graph support)
+          // This connects to Neo4j/Memgraph if CORTEX_GRAPH_SYNC=true
+          const cortexMemory = await createCortexMemoryAsync(config);
+
+          // Stream response with automatic memory integration
+          const result = streamText({
+            model: cortexMemory(openai("gpt-4o-mini")),
+            messages: modelMessages,
+            system: SYSTEM_PROMPT,
+          });
+
+          // Merge LLM stream into the UI message stream
+          writer.merge(result.toUIMessageStream());
+        },
+      }),
+    });
+  } catch (error) {
+    console.error("[Chat API Error]", error);
+
+    return new Response(
+      JSON.stringify({
+        error: error instanceof Error ? error.message : "Unknown error",
+      }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json" },
+      },
+    );
+  }
+}

package/templates/vercel-ai-quickstart/app/api/facts/route.ts

@@ -0,0 +1,39 @@
+import { Cortex } from "@cortexmemory/sdk";
+
+export const dynamic = "force-dynamic";
+
+function getCortex() {
+  return new Cortex({ convexUrl: process.env.CONVEX_URL! });
+}
+
+export async function GET(req: Request) {
+  try {
+    const { searchParams } = new URL(req.url);
+    const memorySpaceId =
+      searchParams.get("memorySpaceId") || "quickstart-demo";
+    const userId = searchParams.get("userId");
+    const limit = parseInt(searchParams.get("limit") || "50");
+
+    const cortex = getCortex();
+
+    // Fetch facts for the user/memory space
+    const facts = await cortex.facts.list({
+      memorySpaceId,
+      ...(userId ? { userId } : {}),
+      limit,
+    });
+
+    return Response.json({
+      facts,
+      count: facts.length,
+      memorySpaceId,
+    });
+  } catch (error) {
+    console.error("[Facts API Error]", error);
+
+    return Response.json(
+      { error: error instanceof Error ? error.message : "Unknown error" },
+      { status: 500 },
+    );
+  }
+}