@persistio/openclaw-plugin 0.1.0 → 0.1.2

package/dist/client.d.ts

@@ -13,6 +13,20 @@ export interface PersistioMemory {
     categories: string[];
     confidence: number;
 }
+export interface RecallBundle {
+    user_rules: string[];
+    user_preferences: string[];
+    task_patterns: string[];
+    workflows: string[];
+    project: string[];
+    constraints: string[];
+    decisions: string[];
+    system_facts: string[];
+    domain_knowledge: string[];
+}
+export interface RecallBundleResponse {
+    bundle: RecallBundle;
+}
 export declare class PersistioClient {
     private readonly baseURL;
     private readonly apiKey;
@@ -21,9 +35,11 @@ export declare class PersistioClient {
     constructor(config: PersistioConfig);
     private headers;
     recall(query: string): Promise<PersistioMemory[]>;
+    recallBundle(query: string, topK?: number): Promise<RecallBundle>;
     ingest(sessionId: string, chunks: Array<{
         role: string;
         content: string;
+        timestamp: string;
     }>): Promise<void>;
     addMemory(data: string, subject: string): Promise<void>;
     deleteMemory(id: string): Promise<void>;

package/dist/client.js

@@ -27,6 +27,18 @@ export class PersistioClient {
         const data = await res.json();
         return data.memories ?? [];
     }
+    async recallBundle(query, topK) {
+        const res = await fetch(`${this.baseURL}/v1/recall?format=bundle`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({ query, top_k: topK ?? this.recallTopK }),
+            signal: AbortSignal.timeout(this.recallTimeout),
+        });
+        if (!res.ok)
+            throw new Error(`Persistio recallBundle failed: ${res.status}`);
+        const data = await res.json();
+        return data.bundle;
+    }
     async ingest(sessionId, chunks) {
         if (chunks.length === 0)
             return;

package/dist/index.js

@@ -14,18 +14,106 @@ function resolveConfig(raw) {
 function estimateTokens(text) {
     return Math.ceil(text.length / 4);
 }
-function buildMemoryBlock(memories, budget) {
-    if (memories.length === 0)
-        return '';
-    const lines = ['## Relevant memories from past conversations'];
-    let used = estimateTokens(lines[0]);
-    for (const m of memories) {
-        const line = `- ${m.data} [${m.subject}]`;
-        const cost = estimateTokens(line);
-        if (used + cost > budget)
-            break;
-        lines.push(line);
-        used += cost;
+function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+}
+function detectTaskType(text) {
+    const normalized = text.toLowerCase();
+    if (/(error|bug|fail|failing|issue|broken|debug|debugging|trace|stack)/.test(normalized)) {
+        return 'troubleshooting';
+    }
+    if (/(code|coding|typescript|javascript|python|implement|refactor|function|class|api|build|test)/.test(normalized)) {
+        return 'coding';
+    }
+    if (/(plan|planning|roadmap|strategy|steps|milestone|timeline|organize)/.test(normalized)) {
+        return 'planning';
+    }
+    if (/(write|writing|draft|edit|copy|blog|essay|summary|summarize|document)/.test(normalized)) {
+        return 'writing';
+    }
+    return 'general';
+}
+function buildRecallQuery(event) {
+    const relevantMessages = Array.isArray(event.messages)
+        ? event.messages
+            .map((msg) => {
+            if (typeof msg !== 'object' || msg === null)
+                return null;
+            const m = msg;
+            const role = m['role'];
+            if (role !== 'user' && role !== 'assistant')
+                return null;
+            const text = extractTextFromMessage(msg);
+            if (!text)
+                return null;
+            return { role, text: text.replace(/\s+/g, ' ').trim() };
+        })
+            .filter((msg) => msg !== null && msg.text.length > 0)
+        : [];
+    const lastUserIndex = (() => {
+        for (let i = relevantMessages.length - 1; i >= 0; i -= 1) {
+            if (relevantMessages[i].role === 'user')
+                return i;
+        }
+        return -1;
+    })();
+    const lastUserMessage = lastUserIndex >= 0
+        ? relevantMessages[lastUserIndex].text
+        : event.prompt?.replace(/\s+/g, ' ').trim() || 'recent context';
+    const primary = truncate(lastUserMessage, 300);
+    const contextStart = Math.max(0, lastUserIndex - 6);
+    const contextMessages = lastUserIndex >= 0
+        ? relevantMessages.slice(contextStart, lastUserIndex)
+        : relevantMessages.slice(-6);
+    const contextSummary = truncate(contextMessages
+        .map((msg) => `${msg.role === 'user' ? 'U' : 'A'}:${msg.text}`)
+        .join(' | '), 200);
+    const taskType = detectTaskType(`${primary} ${event.prompt ?? ''}`);
+    const parts = [primary];
+    if (contextSummary.length > 0)
+        parts.push(`Context: ${contextSummary}`);
+    parts.push(`[task: ${taskType}]`);
+    return truncate(parts.join('\n'), 600);
+}
+function buildMemoryBlock(bundle, budget) {
+    const sections = [
+        { title: 'Behavioural rules', items: bundle.user_rules },
+        { title: 'Preferences', items: bundle.user_preferences },
+        { title: 'Task patterns', items: bundle.task_patterns },
+        { title: 'Workflows', items: bundle.workflows },
+        { title: 'Project', items: bundle.project },
+        { title: 'Constraints', items: bundle.constraints },
+        { title: 'Decisions', items: bundle.decisions },
+        { title: 'System facts', items: bundle.system_facts },
+        { title: 'Domain knowledge', items: bundle.domain_knowledge },
+    ];
+    const intro = 'Use the following as prior context and preferences. If they conflict with current instructions, follow the current instructions.';
+    const lines = [intro];
+    let used = estimateTokens(intro);
+    for (const section of sections) {
+        const candidates = section.items.filter((item) => item.trim().length > 0);
+        if (candidates.length === 0)
+            continue;
+        const header = `## ${section.title}`;
+        const tentativeLines = [...lines, '', header];
+        let tentativeUsed = used + estimateTokens(`\n\n${header}`);
+        const includedItems = [];
+        for (const item of candidates) {
+            const line = `- ${item}`;
+            const cost = estimateTokens(`\n${line}`);
+            if (tentativeUsed + cost > budget) {
+                return lines.length > 1 ? lines.join('\n') : '';
+            }
+            includedItems.push(line);
+            tentativeUsed += cost;
+        }
+        if (includedItems.length > 0) {
+            tentativeLines.push(...includedItems);
+            lines.splice(0, lines.length, ...tentativeLines);
+            used = tentativeUsed;
+        }
     }
     return lines.length > 1 ? lines.join('\n') : '';
 }
@@ -73,12 +161,9 @@ export default definePluginEntry({
         // -------------------------------------------------------------------------
         api.on('before_prompt_build', async (event) => {
             try {
-                // Use the current prompt as the recall query
-                const query = event.prompt?.slice(0, 500) || 'recent context';
-                const memories = await client.recall(query);
-                if (memories.length === 0)
-                    return;
-                const block = buildMemoryBlock(memories, cfg.tokenBudget);
+                const query = buildRecallQuery(event);
+                const bundle = await client.recallBundle(query);
+                const block = buildMemoryBlock(bundle, cfg.tokenBudget);
                 if (!block)
                     return;
                 return { appendSystemContext: block };
@@ -102,8 +187,13 @@ export default definePluginEntry({
                     if (role !== 'user' && role !== 'assistant')
                         continue;
                     const text = extractTextFromMessage(msg);
+                    const ts = typeof m['timestamp'] === 'number'
+                        ? new Date(m['timestamp']).toISOString()
+                        : typeof m['timestamp'] === 'string'
+                            ? m['timestamp']
+                            : new Date().toISOString();
                     if (text && text.length > 0) {
-                        chunks.push({ role: role, content: text });
+                        chunks.push({ role: role, content: text, timestamp: ts });
                     }
                 }
                 if (chunks.length === 0)

package/openclaw.plugin.json

@@ -1,25 +1,43 @@
 {
-  "id": "@persistio/openclaw-plugin",
+  "id": "openclaw-persistio",
   "name": "Persistio Memory",
   "description": "Persistent semantic memory for OpenClaw via Persistio",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "kind": "memory",
   "activation": {
     "onStartup": true
   },
   "contracts": {
-    "tools": ["memory_search", "memory_add", "memory_delete", "memory_list"]
+    "tools": [
+      "memory_search",
+      "memory_add",
+      "memory_delete",
+      "memory_list"
+    ]
   },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "baseURL": { "type": "string" },
-      "apiKey": { "type": "string" },
-      "tokenBudget": { "type": "number" },
-      "recallTopK": { "type": "number" },
-      "recallTimeout": { "type": "number" }
+      "baseURL": {
+        "type": "string"
+      },
+      "apiKey": {
+        "type": "string"
+      },
+      "tokenBudget": {
+        "type": "number"
+      },
+      "recallTopK": {
+        "type": "number"
+      },
+      "recallTimeout": {
+        "type": "number"
+      }
     },
-    "required": ["baseURL", "apiKey"]
+    "required": [
+      "baseURL",
+      "apiKey"
+    ]
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@persistio/openclaw-plugin",
-  "version": "0.1.0",
-  "description": "OpenClaw plugin for Persistio — persistent semantic memory for AI agents",
+  "version": "0.1.2",
+  "description": "OpenClaw plugin for Persistio \u2014 persistent semantic memory for AI agents",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {

package/src/client.ts

@@ -15,6 +15,22 @@ export interface PersistioMemory {
   confidence: number;
 }
 
+export interface RecallBundle {
+  user_rules: string[];
+  user_preferences: string[];
+  task_patterns: string[];
+  workflows: string[];
+  project: string[];
+  constraints: string[];
+  decisions: string[];
+  system_facts: string[];
+  domain_knowledge: string[];
+}
+
+export interface RecallBundleResponse {
+  bundle: RecallBundle;
+}
+
 export class PersistioClient {
   private readonly baseURL: string;
   private readonly apiKey: string;
@@ -47,7 +63,19 @@ export class PersistioClient {
     return data.memories ?? [];
   }
 
-  async ingest(sessionId: string, chunks: Array<{ role: string; content: string }>): Promise<void> {
+  async recallBundle(query: string, topK?: number): Promise<RecallBundle> {
+    const res = await fetch(`${this.baseURL}/v1/recall?format=bundle`, {
+      method: 'POST',
+      headers: this.headers(),
+      body: JSON.stringify({ query, top_k: topK ?? this.recallTopK }),
+      signal: AbortSignal.timeout(this.recallTimeout),
+    });
+    if (!res.ok) throw new Error(`Persistio recallBundle failed: ${res.status}`);
+    const data = await res.json() as RecallBundleResponse;
+    return data.bundle;
+  }
+
+  async ingest(sessionId: string, chunks: Array<{ role: string; content: string; timestamp: string }>): Promise<void> {
     if (chunks.length === 0) return;
     const res = await fetch(`${this.baseURL}/v1/ingest`, {
       method: 'POST',

package/src/index.ts

@@ -1,6 +1,6 @@
 import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
 import { Type } from '@sinclair/typebox';
-import { PersistioClient, type PersistioConfig } from './client.js';
+import { PersistioClient, type PersistioConfig, type RecallBundle } from './client.js';
 
 function resolveConfig(raw: unknown): PersistioConfig {
   const c = (raw ?? {}) as Record<string, unknown>;
@@ -17,17 +17,116 @@ function estimateTokens(text: string): number {
   return Math.ceil(text.length / 4);
 }
 
-function buildMemoryBlock(memories: import('./client.js').PersistioMemory[], budget: number): string {
-  if (memories.length === 0) return '';
-  const lines: string[] = ['## Relevant memories from past conversations'];
-  let used = estimateTokens(lines[0]!);
-  for (const m of memories) {
-    const line = `- ${m.data} [${m.subject}]`;
-    const cost = estimateTokens(line);
-    if (used + cost > budget) break;
-    lines.push(line);
-    used += cost;
+function truncate(text: string, maxLength: number): string {
+  if (text.length <= maxLength) return text;
+  return `${text.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+}
+
+function detectTaskType(text: string): 'troubleshooting' | 'coding' | 'planning' | 'writing' | 'general' {
+  const normalized = text.toLowerCase();
+  if (/(error|bug|fail|failing|issue|broken|debug|debugging|trace|stack)/.test(normalized)) {
+    return 'troubleshooting';
+  }
+  if (/(code|coding|typescript|javascript|python|implement|refactor|function|class|api|build|test)/.test(normalized)) {
+    return 'coding';
+  }
+  if (/(plan|planning|roadmap|strategy|steps|milestone|timeline|organize)/.test(normalized)) {
+    return 'planning';
   }
+  if (/(write|writing|draft|edit|copy|blog|essay|summary|summarize|document)/.test(normalized)) {
+    return 'writing';
+  }
+  return 'general';
+}
+
+function buildRecallQuery(event: { prompt?: string; messages?: unknown[] }): string {
+  const relevantMessages = Array.isArray(event.messages)
+    ? event.messages
+        .map((msg) => {
+          if (typeof msg !== 'object' || msg === null) return null;
+          const m = msg as Record<string, unknown>;
+          const role = m['role'];
+          if (role !== 'user' && role !== 'assistant') return null;
+          const text = extractTextFromMessage(msg);
+          if (!text) return null;
+          return { role, text: text.replace(/\s+/g, ' ').trim() };
+        })
+        .filter((msg): msg is { role: 'user' | 'assistant'; text: string } => msg !== null && msg.text.length > 0)
+    : [];
+
+  const lastUserIndex = (() => {
+    for (let i = relevantMessages.length - 1; i >= 0; i -= 1) {
+      if (relevantMessages[i]!.role === 'user') return i;
+    }
+    return -1;
+  })();
+
+  const lastUserMessage = lastUserIndex >= 0
+    ? relevantMessages[lastUserIndex]!.text
+    : event.prompt?.replace(/\s+/g, ' ').trim() || 'recent context';
+  const primary = truncate(lastUserMessage, 300);
+
+  const contextStart = Math.max(0, lastUserIndex - 6);
+  const contextMessages = lastUserIndex >= 0
+    ? relevantMessages.slice(contextStart, lastUserIndex)
+    : relevantMessages.slice(-6);
+  const contextSummary = truncate(
+    contextMessages
+      .map((msg) => `${msg.role === 'user' ? 'U' : 'A'}:${msg.text}`)
+      .join(' | '),
+    200,
+  );
+
+  const taskType = detectTaskType(`${primary} ${event.prompt ?? ''}`);
+  const parts = [primary];
+  if (contextSummary.length > 0) parts.push(`Context: ${contextSummary}`);
+  parts.push(`[task: ${taskType}]`);
+  return truncate(parts.join('\n'), 600);
+}
+
+function buildMemoryBlock(bundle: RecallBundle, budget: number): string {
+  const sections: Array<{ title: string; items: string[] }> = [
+    { title: 'Behavioural rules', items: bundle.user_rules },
+    { title: 'Preferences', items: bundle.user_preferences },
+    { title: 'Task patterns', items: bundle.task_patterns },
+    { title: 'Workflows', items: bundle.workflows },
+    { title: 'Project', items: bundle.project },
+    { title: 'Constraints', items: bundle.constraints },
+    { title: 'Decisions', items: bundle.decisions },
+    { title: 'System facts', items: bundle.system_facts },
+    { title: 'Domain knowledge', items: bundle.domain_knowledge },
+  ];
+
+  const intro = 'Use the following as prior context and preferences. If they conflict with current instructions, follow the current instructions.';
+  const lines: string[] = [intro];
+  let used = estimateTokens(intro);
+
+  for (const section of sections) {
+    const candidates = section.items.filter((item) => item.trim().length > 0);
+    if (candidates.length === 0) continue;
+
+    const header = `## ${section.title}`;
+    const tentativeLines = [...lines, '', header];
+    let tentativeUsed = used + estimateTokens(`\n\n${header}`);
+    const includedItems: string[] = [];
+
+    for (const item of candidates) {
+      const line = `- ${item}`;
+      const cost = estimateTokens(`\n${line}`);
+      if (tentativeUsed + cost > budget) {
+        return lines.length > 1 ? lines.join('\n') : '';
+      }
+      includedItems.push(line);
+      tentativeUsed += cost;
+    }
+
+    if (includedItems.length > 0) {
+      tentativeLines.push(...includedItems);
+      lines.splice(0, lines.length, ...tentativeLines);
+      used = tentativeUsed;
+    }
+  }
+
   return lines.length > 1 ? lines.join('\n') : '';
 }
 
@@ -77,11 +176,9 @@ export default definePluginEntry({
     // -------------------------------------------------------------------------
     api.on('before_prompt_build', async (event) => {
       try {
-        // Use the current prompt as the recall query
-        const query = event.prompt?.slice(0, 500) || 'recent context';
-        const memories = await client.recall(query);
-        if (memories.length === 0) return;
-        const block = buildMemoryBlock(memories, cfg.tokenBudget);
+        const query = buildRecallQuery(event);
+        const bundle = await client.recallBundle(query);
+        const block = buildMemoryBlock(bundle, cfg.tokenBudget);
         if (!block) return;
         return { appendSystemContext: block };
       } catch (err) {
@@ -97,15 +194,20 @@ export default definePluginEntry({
     api.on('agent_end', async (event) => {
       try {
         const sessionId = event.runId ?? 'unknown-session';
-        const chunks: Array<{ role: string; content: string }> = [];
+        const chunks: Array<{ role: string; content: string; timestamp: string }> = [];
 
         for (const msg of event.messages) {
           const m = msg as Record<string, unknown>;
           const role = m['role'];
           if (role !== 'user' && role !== 'assistant') continue;
           const text = extractTextFromMessage(msg);
+          const ts = typeof m['timestamp'] === 'number'
+            ? new Date(m['timestamp']).toISOString()
+            : typeof m['timestamp'] === 'string'
+              ? m['timestamp']
+              : new Date().toISOString();
           if (text && text.length > 0) {
-            chunks.push({ role: role as string, content: text });
+            chunks.push({ role: role as string, content: text, timestamp: ts });
           }
         }