@cortexmemory/cli 0.27.4 → 0.28.0

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

@@ -13,7 +13,8 @@ export async function GET(req: Request) {
     const { searchParams } = new URL(req.url);
     const conversationId = searchParams.get("conversationId");
     const userId = searchParams.get("userId");
-    const memorySpaceId = searchParams.get("memorySpaceId") || "quickstart-demo";
+    const memorySpaceId =
+      searchParams.get("memorySpaceId") || "quickstart-demo";
 
     const cortex = getCortex();
 
@@ -27,7 +28,7 @@ export async function GET(req: Request) {
       if (!conversation) {
         return Response.json(
           { error: "Conversation not found" },
-          { status: 404 }
+          { status: 404 },
         );
       }
 
@@ -42,7 +43,9 @@ export async function GET(req: Request) {
       return Response.json({
         conversation: {
           id: conversation.conversationId,
-          title: (conversation.metadata?.title as string) || getDefaultTitle(conversation),
+          title:
+            (conversation.metadata?.title as string) ||
+            getDefaultTitle(conversation),
           createdAt: conversation.createdAt,
           updatedAt: conversation.updatedAt,
           messageCount: conversation.messageCount || 0,
@@ -53,10 +56,7 @@ export async function GET(req: Request) {
 
     // List conversations for user (requires userId)
     if (!userId) {
-      return Response.json(
-        { error: "userId is required" },
-        { status: 400 }
-      );
+      return Response.json({ error: "userId is required" }, { status: 400 });
     }
 
     // Get conversations for the user
@@ -84,7 +84,7 @@ export async function GET(req: Request) {
 
     return Response.json(
       { error: "Failed to fetch conversations" },
-      { status: 500 }
+      { status: 500 },
     );
   }
 }
@@ -95,10 +95,7 @@ export async function POST(req: Request) {
     const { userId, memorySpaceId = "quickstart-demo", title } = body;
 
     if (!userId) {
-      return Response.json(
-        { error: "userId is required" },
-        { status: 400 }
-      );
+      return Response.json({ error: "userId is required" }, { status: 400 });
     }
 
     const cortex = getCortex();
@@ -134,7 +131,7 @@ export async function POST(req: Request) {
 
     return Response.json(
       { error: "Failed to create conversation" },
-      { status: 500 }
+      { status: 500 },
     );
   }
 }
@@ -147,7 +144,7 @@ export async function DELETE(req: Request) {
     if (!conversationId) {
       return Response.json(
         { error: "conversationId is required" },
-        { status: 400 }
+        { status: 400 },
       );
     }
 
@@ -161,7 +158,7 @@ export async function DELETE(req: Request) {
 
     return Response.json(
       { error: "Failed to delete conversation" },
-      { status: 500 }
+      { status: 500 },
     );
   }
 }
@@ -169,7 +166,10 @@ export async function DELETE(req: Request) {
 /**
  * Generate a default title from conversation data
  */
-function getDefaultTitle(conv: { createdAt: number; messageCount?: number }): string {
+function getDefaultTitle(conv: {
+  createdAt: number;
+  messageCount?: number;
+}): string {
   const date = new Date(conv.createdAt);
   const timeStr = date.toLocaleTimeString("en-US", {
     hour: "numeric",

package/templates/vercel-ai-quickstart/app/globals.css

@@ -129,7 +129,8 @@
 }
 
 @keyframes logo-pulse {
-  0%, 100% {
+  0%,
+  100% {
     transform: scale(1);
     box-shadow: 0 0 0 0 rgba(12, 140, 230, 0.4);
   }
@@ -182,12 +183,24 @@
 }
 
 /* Staggered animation for conversation list */
-.conversation-item:nth-child(1) { animation-delay: 0ms; }
-.conversation-item:nth-child(2) { animation-delay: 30ms; }
-.conversation-item:nth-child(3) { animation-delay: 60ms; }
-.conversation-item:nth-child(4) { animation-delay: 90ms; }
-.conversation-item:nth-child(5) { animation-delay: 120ms; }
-.conversation-item:nth-child(n+6) { animation-delay: 150ms; }
+.conversation-item:nth-child(1) {
+  animation-delay: 0ms;
+}
+.conversation-item:nth-child(2) {
+  animation-delay: 30ms;
+}
+.conversation-item:nth-child(3) {
+  animation-delay: 60ms;
+}
+.conversation-item:nth-child(4) {
+  animation-delay: 90ms;
+}
+.conversation-item:nth-child(5) {
+  animation-delay: 120ms;
+}
+.conversation-item:nth-child(n + 6) {
+  animation-delay: 150ms;
+}
 
 /* ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    Input Focus Animations
@@ -216,7 +229,9 @@ input:focus {
   background: rgba(255, 255, 255, 0.1);
   border-radius: 50%;
   transform: translate(-50%, -50%);
-  transition: width 0.4s ease, height 0.4s ease;
+  transition:
+    width 0.4s ease,
+    height 0.4s ease;
 }
 
 .btn-primary:hover::after {
@@ -265,7 +280,7 @@ input:focus {
     transform: translateX(-100%);
     transition: transform 0.3s ease;
   }
-  
+
   .sidebar-mobile-visible {
     transform: translateX(0);
     position: fixed;

package/templates/vercel-ai-quickstart/app/page.tsx

@@ -52,7 +52,9 @@ const ChatHistorySidebar = dynamic(
 function MainContent() {
   const { isLoading, isAdminSetup, isAuthenticated, user } = useAuth();
   const [memorySpaceId, setMemorySpaceId] = useState("quickstart-demo");
-  const [currentConversationId, setCurrentConversationId] = useState<string | null>(null);
+  const [currentConversationId, setCurrentConversationId] = useState<
+    string | null
+  >(null);
   const [versions, setVersions] = useState<VersionInfo | null>(null);
   const {
     layers,
@@ -74,18 +76,24 @@ function MainContent() {
   }, [resetLayers]);
 
   // Handle conversation selection
-  const handleSelectConversation = useCallback((conversationId: string) => {
-    setCurrentConversationId(conversationId);
-    resetLayers();
-  }, [resetLayers]);
+  const handleSelectConversation = useCallback(
+    (conversationId: string) => {
+      setCurrentConversationId(conversationId);
+      resetLayers();
+    },
+    [resetLayers],
+  );
 
   // Handle conversation update (e.g., title change after first message)
-  const handleConversationUpdate = useCallback((conversationId: string) => {
-    // Update current conversation ID if it was null (new chat created)
-    if (!currentConversationId) {
-      setCurrentConversationId(conversationId);
-    }
-  }, [currentConversationId]);
+  const handleConversationUpdate = useCallback(
+    (conversationId: string) => {
+      // Update current conversation ID if it was null (new chat created)
+      if (!currentConversationId) {
+        setCurrentConversationId(conversationId);
+      }
+    },
+    [currentConversationId],
+  );
 
   // Loading state
   if (isLoading) {
@@ -158,7 +166,9 @@ function MainContent() {
             memorySpaceId={memorySpaceId}
             userId={userId}
             conversationId={currentConversationId}
-            apiEndpoint={versions?.aiSdkMajor === 6 ? "/api/chat-v6" : "/api/chat"}
+            apiEndpoint={
+              versions?.aiSdkMajor === 6 ? "/api/chat-v6" : "/api/chat"
+            }
             onOrchestrationStart={startOrchestration}
             onLayerUpdate={updateLayer}
             onReset={resetLayers}
@@ -193,7 +203,9 @@ function MainContent() {
       <footer className="border-t border-white/10 px-6 py-3">
         <div className="flex items-center justify-between text-sm text-gray-500">
           <div className="flex items-center gap-4">
-            <span>Cortex SDK {versions ? `v${versions.cortexSdk}` : "..."}</span>
+            <span>
+              Cortex SDK {versions ? `v${versions.cortexSdk}` : "..."}
+            </span>
             <span>•</span>
             <span>Vercel AI SDK {versions?.aiSdk ?? "..."}</span>
             {versions?.aiSdkMajor === 6 && (

package/templates/vercel-ai-quickstart/components/AdminSetup.tsx

@@ -41,7 +41,9 @@ export function AdminSetup() {
             <span className="text-4xl">🧠</span>
           </div>
           <h1 className="text-3xl font-bold mb-2">Welcome to Cortex</h1>
-          <p className="text-gray-400">Set up your admin password to get started</p>
+          <p className="text-gray-400">
+            Set up your admin password to get started
+          </p>
         </div>
 
         {/* Setup Form */}

package/templates/vercel-ai-quickstart/components/AuthProvider.tsx

@@ -32,7 +32,7 @@ export interface AuthContextValue extends AuthState {
   register: (
     username: string,
     password: string,
-    displayName?: string
+    displayName?: string,
   ) => Promise<boolean>;
   logout: () => void;
   clearError: () => void;
@@ -164,7 +164,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
             JSON.stringify({
               user: data.user,
               sessionToken: data.sessionToken,
-            })
+            }),
           );
         }
 
@@ -184,7 +184,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
         return false;
       }
     },
-    []
+    [],
   );
 
   // Register
@@ -192,7 +192,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
     async (
       username: string,
       password: string,
-      displayName?: string
+      displayName?: string,
     ): Promise<boolean> => {
       setState((prev) => ({ ...prev, error: null }));
 
@@ -217,7 +217,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
             JSON.stringify({
               user: data.user,
               sessionToken: data.sessionToken,
-            })
+            }),
           );
         }
 
@@ -237,7 +237,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
         return false;
       }
     },
-    []
+    [],
   );
 
   // Logout

package/templates/vercel-ai-quickstart/components/ChatHistorySidebar.tsx

@@ -26,9 +26,15 @@ interface ChatHistorySidebarProps {
 // Helpers
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-function groupByDate(conversations: Conversation[]): Record<string, Conversation[]> {
+function groupByDate(
+  conversations: Conversation[],
+): Record<string, Conversation[]> {
   const now = new Date();
-  const today = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+  const today = new Date(
+    now.getFullYear(),
+    now.getMonth(),
+    now.getDate(),
+  ).getTime();
   const yesterday = today - 86400000;
   const weekAgo = today - 7 * 86400000;
 
@@ -44,7 +50,7 @@ function groupByDate(conversations: Conversation[]): Record<string, Conversation
     const convDay = new Date(
       convDate.getFullYear(),
       convDate.getMonth(),
-      convDate.getDate()
+      convDate.getDate(),
     ).getTime();
 
     if (convDay >= today) {
@@ -89,7 +95,7 @@ export function ChatHistorySidebar({
 
     try {
       const response = await fetch(
-        `/api/conversations?userId=${encodeURIComponent(user.id)}&memorySpaceId=${encodeURIComponent(memorySpaceId)}`
+        `/api/conversations?userId=${encodeURIComponent(user.id)}&memorySpaceId=${encodeURIComponent(memorySpaceId)}`,
       );
       const data = await response.json();
       if (data.conversations) {
@@ -121,13 +127,18 @@ export function ChatHistorySidebar({
     setDeletingId(conversationId);
 
     try {
-      const response = await fetch(`/api/conversations?conversationId=${encodeURIComponent(conversationId)}`, {
-        method: "DELETE",
-      });
+      const response = await fetch(
+        `/api/conversations?conversationId=${encodeURIComponent(conversationId)}`,
+        {
+          method: "DELETE",
+        },
+      );
 
       if (!response.ok) {
         const data = await response.json().catch(() => ({}));
-        throw new Error(data.error || `Delete failed with status ${response.status}`);
+        throw new Error(
+          data.error || `Delete failed with status ${response.status}`,
+        );
       }
 
       // Remove from local state only after successful deletion

package/templates/vercel-ai-quickstart/components/ChatInterface.tsx

@@ -69,6 +69,9 @@ export function ChatInterface({
     conversationIdRef.current = conversationId;
   }, [conversationId]);
 
+  // Track if we should skip history load (when we create a new conversation ourselves)
+  const skipHistoryLoadRef = useRef<string | null>(null);
+
   // Create transport with a function that reads from ref for conversationId
   // This ensures we always send the latest conversationId
   const transport = useMemo(
@@ -104,6 +107,8 @@ export function ChatInterface({
       // Handle conversation title update
       if (part.type === "data-conversation-update") {
         const update = part.data as { conversationId: string; title: string };
+        // Mark this conversation ID to skip history load - we just created it
+        skipHistoryLoadRef.current = update.conversationId;
         onConversationUpdate?.(update.conversationId, update.title);
       }
     },
@@ -122,20 +127,28 @@ export function ChatInterface({
 
   // Load messages when conversation changes
   useEffect(() => {
-    // Clear messages first
-    setMessages([]);
-
-    // If no conversation selected, nothing more to do
+    // If no conversation selected, just clear messages
     if (!conversationId) {
+      setMessages([]);
+      return;
+    }
+
+    // Skip loading if we just created this conversation ourselves
+    // (we already have the messages in state from the current chat session)
+    if (skipHistoryLoadRef.current === conversationId) {
+      skipHistoryLoadRef.current = null;
       return;
     }
 
+    // Clear messages before loading new conversation
+    setMessages([]);
+
     // Fetch conversation history
     const loadConversationHistory = async () => {
       setIsLoadingHistory(true);
       try {
         const response = await fetch(
-          `/api/conversations?conversationId=${encodeURIComponent(conversationId)}`
+          `/api/conversations?conversationId=${encodeURIComponent(conversationId)}`,
         );
 
         if (!response.ok) {
@@ -147,12 +160,19 @@ export function ChatInterface({
 
         if (data.messages && data.messages.length > 0) {
           // Transform to the format expected by useChat
-          const loadedMessages = data.messages.map((msg: { id: string; role: string; content: string; createdAt: string }) => ({
-            id: msg.id,
-            role: msg.role,
-            content: msg.content,
-            createdAt: new Date(msg.createdAt),
-          }));
+          const loadedMessages = data.messages.map(
+            (msg: {
+              id: string;
+              role: string;
+              content: string;
+              createdAt: string;
+            }) => ({
+              id: msg.id,
+              role: msg.role,
+              content: msg.content,
+              createdAt: new Date(msg.createdAt),
+            }),
+          );
           setMessages(loadedMessages);
         }
       } catch (error) {
@@ -193,7 +213,10 @@ export function ChatInterface({
   };
 
   // Extract text content from message parts (AI SDK v5 format)
-  const getMessageContent = (message: { content?: string; parts?: Array<{ type: string; text?: string }> }): string => {
+  const getMessageContent = (message: {
+    content?: string;
+    parts?: Array<{ type: string; text?: string }>;
+  }): string => {
     if (typeof message.content === "string") {
       return message.content;
     }
@@ -233,7 +256,9 @@ export function ChatInterface({
                   d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"
                 />
               </svg>
-              <span className="text-gray-400 text-sm">Loading conversation...</span>
+              <span className="text-gray-400 text-sm">
+                Loading conversation...
+              </span>
             </div>
           </div>
         )}
@@ -244,7 +269,9 @@ export function ChatInterface({
               <span className="text-3xl">🧠</span>
             </div>
             <h2 className="text-xl font-semibold mb-2">
-              {conversationId ? "Continue your conversation" : "Start a new conversation"}
+              {conversationId
+                ? "Continue your conversation"
+                : "Start a new conversation"}
             </h2>
             <p className="text-gray-400 max-w-md mx-auto mb-6">
               This demo shows how Cortex orchestrates memory across multiple

package/templates/vercel-ai-quickstart/components/LoginScreen.tsx

@@ -57,7 +57,9 @@ export function LoginScreen() {
             <span className="text-4xl">🧠</span>
           </div>
           <h1 className="text-3xl font-bold mb-2">Cortex Memory Demo</h1>
-          <p className="text-gray-400">Sign in to explore AI with long-term memory</p>
+          <p className="text-gray-400">
+            Sign in to explore AI with long-term memory
+          </p>
         </div>
 
         {/* Login/Register Card */}
@@ -114,8 +116,7 @@ export function LoginScreen() {
                   htmlFor="displayName"
                   className="block text-sm font-medium text-gray-300 mb-2"
                 >
-                  Display Name{" "}
-                  <span className="text-gray-500">(optional)</span>
+                  Display Name <span className="text-gray-500">(optional)</span>
                 </label>
                 <input
                   id="displayName"
@@ -144,7 +145,9 @@ export function LoginScreen() {
                 placeholder="Enter your password"
                 className="w-full px-4 py-3 bg-white/5 border border-white/10 rounded-xl focus:outline-none focus:border-cortex-500 transition-colors"
                 disabled={isLoading}
-                autoComplete={activeTab === "login" ? "current-password" : "new-password"}
+                autoComplete={
+                  activeTab === "login" ? "current-password" : "new-password"
+                }
               />
             </div>
 
@@ -181,7 +184,9 @@ export function LoginScreen() {
                       d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"
                     />
                   </svg>
-                  {activeTab === "login" ? "Signing in..." : "Creating account..."}
+                  {activeTab === "login"
+                    ? "Signing in..."
+                    : "Creating account..."}
                 </>
               ) : activeTab === "login" ? (
                 "Sign In"

package/templates/vercel-ai-quickstart/lib/agents/memory-agent.ts

@@ -99,10 +99,10 @@ export const memoryAgent = new ToolLoopAgent({
   // └─────────────────────────────────────────────────────────────────┘
   prepareCall: createMemoryPrepareCall({
     convexUrl: process.env.CONVEX_URL!,
-    maxMemories: 20,     // Max items to inject from recall
-    includeFacts: true,  // Include Layer 3 facts
+    maxMemories: 20, // Max items to inject from recall
+    includeFacts: true, // Include Layer 3 facts
     includeVector: true, // Include Layer 2 vector memories
-    includeGraph: true,  // Expand through graph relationships
+    includeGraph: true, // Expand through graph relationships
   }),
 
   // Default to 5 steps (sufficient for most chat interactions)

package/templates/vercel-ai-quickstart/lib/password.ts

@@ -28,7 +28,7 @@ export async function hashPassword(password: string): Promise<string> {
     passwordBuffer,
     "PBKDF2",
     false,
-    ["deriveBits"]
+    ["deriveBits"],
   );
 
   // Derive key using PBKDF2
@@ -40,7 +40,7 @@ export async function hashPassword(password: string): Promise<string> {
       hash: "SHA-256",
     },
     keyMaterial,
-    KEY_LENGTH
+    KEY_LENGTH,
   );
 
   // Convert to base64 strings
@@ -60,7 +60,7 @@ export async function hashPassword(password: string): Promise<string> {
  */
 export async function verifyPassword(
   password: string,
-  storedHash: string
+  storedHash: string,
 ): Promise<boolean> {
   try {
     const [saltB64, expectedHashB64] = storedHash.split(":");
@@ -84,7 +84,7 @@ export async function verifyPassword(
       passwordBuffer,
       "PBKDF2",
       false,
-      ["deriveBits"]
+      ["deriveBits"],
     );
 
     // Derive key using same parameters
@@ -96,7 +96,7 @@ export async function verifyPassword(
         hash: "SHA-256",
       },
       keyMaterial,
-      KEY_LENGTH
+      KEY_LENGTH,
     );
 
     // Compare hashes

package/templates/vercel-ai-quickstart/next.config.js

@@ -4,6 +4,11 @@ const path = require("path");
 const nextConfig = {
   transpilePackages: ["@cortexmemory/sdk", "@cortexmemory/vercel-ai-provider"],
   serverExternalPackages: ["convex"],
+  // Disable image optimization to avoid sharp dependency (LGPL licensed)
+  // This quickstart doesn't use image optimization features
+  images: {
+    unoptimized: true,
+  },
   experimental: {
     // Ensure linked packages resolve dependencies from this project's node_modules
     externalDir: true,
@@ -16,8 +21,11 @@ const nextConfig = {
   webpack: (config) => {
     config.resolve.alias = {
       ...config.resolve.alias,
-      "@anthropic-ai/sdk": path.resolve(__dirname, "node_modules/@anthropic-ai/sdk"),
-      "openai": path.resolve(__dirname, "node_modules/openai"),
+      "@anthropic-ai/sdk": path.resolve(
+        __dirname,
+        "node_modules/@anthropic-ai/sdk",
+      ),
+      openai: path.resolve(__dirname, "node_modules/openai"),
       "neo4j-driver": path.resolve(__dirname, "node_modules/neo4j-driver"),
     };
     return config;

package/templates/vercel-ai-quickstart/package.json

@@ -5,9 +5,9 @@
   "license": "UNLICENSED",
   "description": "Cortex Memory + Vercel AI SDK Quickstart Demo",
   "scripts": {
-    "dev": "next dev --webpack",
+    "dev": "next dev --webpack -H 0.0.0.0",
     "build": "next build --webpack",
-    "start": "next start",
+    "start": "next start -H 0.0.0.0",
     "lint": "next lint",
     "test": "jest --selectProjects unit integration",
     "test:unit": "jest --selectProjects unit",
@@ -19,32 +19,39 @@
     "convex:deploy": "convex deploy"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^3.0.1",
-    "@ai-sdk/react": "^3.0.3",
+    "@ai-sdk/openai": "^3.0.4",
+    "@ai-sdk/react": "^3.0.11",
     "@anthropic-ai/sdk": "^0.71.2",
     "@cortexmemory/sdk": "file:../../..",
     "@cortexmemory/vercel-ai-provider": "file:..",
-    "ai": "^6.0.3",
+    "ai": "^6.0.11",
     "convex": "^1.31.2",
-    "framer-motion": "^12.23.26",
+    "framer-motion": "^12.24.0",
     "neo4j-driver": "^6.0.1",
     "next": "^16.1.1",
     "openai": "^6.15.0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
-    "zod": "^4.2.1"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",
-    "@types/jest": "^29.5.14",
+    "@types/jest": "^30.0.0",
     "@types/node": "^25.0.3",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "autoprefixer": "^10.4.23",
-    "jest": "^29.7.0",
+    "jest": "^30.2.0",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.18",
-    "ts-jest": "^29.2.5",
+    "ts-jest": "^29.4.6",
     "typescript": "^5.9.3"
-  }
+  },
+  "main": "jest.config.js",
+  "directories": {
+    "lib": "lib",
+    "test": "tests"
+  },
+  "keywords": [],
+  "author": ""
 }