jasper-recall 0.4.2 → 0.5.0

package/cli/jasper-recall.js

@@ -199,6 +199,10 @@ function setup() {
   console.log('  2. recall "query"    # Search your memory');
   console.log('  3. digest-sessions   # Process session logs');
   console.log('');
+  console.log('🔄 To set up automatic indexing cron jobs:');
+  console.log('   Run /jasper-recall setup in your OpenClaw chat');
+  console.log('   Then ask your agent to create the cron jobs for you');
+  console.log('');
   
   // Check for sandboxed agents
   const sandboxedWorkspaces = findSandboxedWorkspaces();

package/extensions/openclaw-plugin/index.ts

@@ -81,13 +81,26 @@ export default function register(api: PluginApi) {
   // ============================================================================
   
   if (autoRecall) {
-    api.on('before_agent_start', async (event: { prompt?: string; senderId?: string; source?: string }) => {
+    api.on('before_agent_start', async (event: { 
+      prompt?: string; 
+      senderId?: string; 
+      source?: string;
+      isNewSession?: boolean;
+      messageCount?: number;
+      context?: { messages?: any[] };
+    }) => {
       // Skip if no prompt or too short
       if (!event.prompt || event.prompt.length < 10) {
         return;
       }
 
       const prompt = event.prompt;
+      
+      // Detect fresh session (after /new or first message)
+      const isFreshSession = event.isNewSession || 
+                             event.messageCount === 0 || 
+                             event.messageCount === 1 ||
+                             (event.context?.messages?.length ?? 0) <= 1;
 
       // Skip heartbeats and system prompts
       if (prompt.startsWith('HEARTBEAT') || 
@@ -116,6 +129,22 @@ export default function register(api: PluginApi) {
       }
 
       try {
+        let prependParts: string[] = [];
+        
+        // If fresh session, remind agent to read identity files
+        if (isFreshSession) {
+          api.logger.info('[jasper-recall] Fresh session detected - adding identity reminder');
+          prependParts.push(`<session-init>
+🔄 **Fresh session detected.** Before responding, read your identity files:
+\`\`\`bash
+cat ~/.openclaw/workspace/IDENTITY.md
+cat ~/.openclaw/workspace/SOUL.md  
+cat ~/.openclaw/workspace/USER.md
+\`\`\`
+This ensures you maintain your persona and context after session reset.
+</session-init>`);
+        }
+        
         const results = runRecall(event.prompt, {
           limit: 3,
           json: true,
@@ -127,23 +156,43 @@ export default function register(api: PluginApi) {
         // Filter by minimum score
         const relevant = parsed.filter((r: any) => r.score >= minScore);
 
-        if (relevant.length === 0) {
-          api.logger.debug?.('[jasper-recall] No relevant memories found for auto-recall');
-          return;
-        }
+        if (relevant.length > 0) {
+          // Format memories for context injection
+          const memoryContext = relevant
+            .map((r: any) => `- [${r.source || 'memory'}] ${r.content.slice(0, 500)}${r.content.length > 500 ? '...' : ''}`)
+            .join('\n');
 
-        // Format memories for context injection
-        const memoryContext = relevant
-          .map((r: any) => `- [${r.source || 'memory'}] ${r.content.slice(0, 500)}${r.content.length > 500 ? '...' : ''}`)
-          .join('\n');
+          api.logger.info(`[jasper-recall] Auto-injecting ${relevant.length} memories into context`);
 
-        api.logger.info(`[jasper-recall] Auto-injecting ${relevant.length} memories into context`);
+          prependParts.push(`<relevant-memories>
+The following memories may be relevant to this conversation:
+${memoryContext}
+</relevant-memories>`);
+        } else {
+          api.logger.debug?.('[jasper-recall] No relevant memories found for auto-recall');
+        }
 
-        return {
-          prependContext: `<relevant-memories>\nThe following memories may be relevant to this conversation:\n${memoryContext}\n</relevant-memories>`,
-        };
+        if (prependParts.length > 0) {
+          return {
+            prependContext: prependParts.join('\n\n'),
+          };
+        }
       } catch (err: any) {
         api.logger.warn(`[jasper-recall] Auto-recall failed: ${err.message}`);
+        
+        // Still inject identity reminder on fresh session even if recall fails
+        if (isFreshSession) {
+          return {
+            prependContext: `<session-init>
+🔄 **Fresh session detected.** Before responding, read your identity files:
+\`\`\`bash
+cat ~/.openclaw/workspace/IDENTITY.md
+cat ~/.openclaw/workspace/SOUL.md
+cat ~/.openclaw/workspace/USER.md
+\`\`\`
+</session-init>`,
+          };
+        }
       }
     });
   }
@@ -246,6 +295,99 @@ export default function register(api: PluginApi) {
     },
   });
 
+  // ============================================================================
+  // Command: /jasper-recall setup
+  // ============================================================================
+
+  api.registerCommand({
+    name: 'jasper-recall',
+    description: 'Jasper Recall setup and status',
+    acceptsArgs: true,
+    requireAuth: true,
+    handler: async (ctx: { args?: string }) => {
+      const subcommand = ctx.args?.trim().toLowerCase();
+      
+      if (subcommand === 'setup') {
+        return {
+          text: `🧠 **Jasper Recall Setup**
+
+To complete setup, ask me to create these cron jobs:
+
+**1. Index memories every 6 hours:**
+\`\`\`
+Create a cron job that runs every 6 hours to index memory files.
+Schedule: "0 */6 * * *"
+Payload: Run index-digests to update the ChromaDB index
+\`\`\`
+
+**2. Digest sessions daily at 4am:**
+\`\`\`
+Create a cron job that runs daily at 4am to digest session logs.
+Schedule: "0 4 * * *"  
+Payload: Run digest-sessions to extract summaries from recent sessions
+\`\`\`
+
+Or just say: **"Set up jasper-recall cron jobs for me"**
+
+---
+
+**Current status:**
+- Auto-recall: ${autoRecall ? '✅ Enabled' : '❌ Disabled'}
+- Public-only mode: ${publicOnly ? '✅ Yes' : '❌ No (full access)'}
+- Default limit: ${defaultLimit} results
+- Min score: ${minScore}`,
+        };
+      }
+      
+      if (subcommand === 'status') {
+        try {
+          // Check if ChromaDB is accessible
+          const testResult = runRecall('test query', { limit: 1, json: true, publicOnly });
+          const parsed = JSON.parse(testResult);
+          
+          return {
+            text: `🧠 **Jasper Recall Status**
+
+**Plugin:** ✅ Active
+**Auto-recall:** ${autoRecall ? '✅ Enabled' : '❌ Disabled'}
+**ChromaDB:** ✅ Connected
+**Index size:** ${parsed.length > 0 ? 'Has data' : 'Empty or minimal'}
+
+**Config:**
+- Public-only: ${publicOnly}
+- Default limit: ${defaultLimit}
+- Min score: ${minScore}`,
+          };
+        } catch (err: any) {
+          return {
+            text: `🧠 **Jasper Recall Status**
+
+**Plugin:** ✅ Active
+**Auto-recall:** ${autoRecall ? '✅ Enabled' : '❌ Disabled'}
+**ChromaDB:** ❌ Error - ${err.message}
+
+Run \`npx jasper-recall setup\` to install dependencies.`,
+          };
+        }
+      }
+      
+      // Default: show help
+      return {
+        text: `🧠 **Jasper Recall**
+
+**Commands:**
+- \`/jasper-recall setup\` — Setup instructions & cron jobs
+- \`/jasper-recall status\` — Check plugin status
+- \`/recall <query>\` — Search memory
+- \`/index\` — Re-index memory files
+
+**CLI:**
+- \`npx jasper-recall setup\` — Install Python dependencies
+- \`npx jasper-recall doctor\` — Health check`,
+      };
+    },
+  });
+
   // ============================================================================
   // RPC Methods
   // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jasper-recall",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Local RAG system for AI agent memory using ChromaDB and sentence-transformers",
   "main": "src/index.js",
   "bin": {