clawvault 3.3.0 → 3.4.1

package/dist/index.js

@@ -6,6 +6,9 @@ import {
   rebuildCommand,
   registerRebuildCommand
 } from "./chunk-QFWERBDP.js";
+import {
+  recallCommand
+} from "./chunk-YTRZNA64.js";
 import {
   registerReplayCommand,
   replayCommand
@@ -45,9 +48,32 @@ import {
   graphCommand,
   graphSummary
 } from "./chunk-S7N7HI5E.js";
+import {
+  LiveCaptureService,
+  createMemorySlot,
+  createMemorySlotPlugin,
+  evaluateCandidateQuality,
+  extractHeuristicMemories,
+  extractMemoriesFromAssistantResponse,
+  extractTaggedMemoryNotes,
+  isLikelyJunkMemory,
+  openclaw_plugin_default,
+  plausibilityScore,
+  registerMemorySlot
+} from "./chunk-PLNK37JD.js";
+import {
+  buildRecallResult,
+  classifyRecallQuery
+} from "./chunk-RL2L6I6K.js";
+import {
+  ensureEntityProfiles,
+  readEntityProfile,
+  readEntityProfiles,
+  synthesizeEntityProfiles
+} from "./chunk-NSXYM6EZ.js";
 import {
   registerCliCommands
-} from "./chunk-YCUVAOFC.js";
+} from "./chunk-DCF4KMFD.js";
 import {
   registerTailscaleCommands,
   registerTailscaleDiscoverCommand,
@@ -99,7 +125,7 @@ import {
 import {
   maintainCommand,
   registerMaintainCommand
-} from "./chunk-TDWFBDAQ.js";
+} from "./chunk-D5U3Q4N5.js";
 import {
   SessionWatcher,
   observeCommand,
@@ -156,6 +182,16 @@ import {
   registerContextCommand,
   resolveContextProfile
 } from "./chunk-GFCHWMGD.js";
+import {
+  embedCommand,
+  registerEmbedCommand
+} from "./chunk-T7E764W3.js";
+import {
+  inboxAddCommand,
+  registerInboxCommand
+} from "./chunk-HEHO7SMV.js";
+import "./chunk-2PKBIKDH.js";
+import "./chunk-35JCYSRR.js";
 import {
   FactStore,
   extractFactsLlm,
@@ -174,10 +210,6 @@ import {
   MEMORY_TYPES,
   TYPE_TO_CATEGORY
 } from "./chunk-2CDEETQN.js";
-import {
-  embedCommand,
-  registerEmbedCommand
-} from "./chunk-T7E764W3.js";
 import {
   loadVaultQmdConfig,
   removeQmdCollection
@@ -196,11 +228,6 @@ import {
   qmdUpdate
 } from "./chunk-PTWPPVC7.js";
 import "./chunk-H3JZIB5O.js";
-import {
-  inboxAddCommand,
-  registerInboxCommand
-} from "./chunk-HEHO7SMV.js";
-import "./chunk-2PKBIKDH.js";
 import {
   archiveCommand,
   registerArchiveCommand
@@ -666,6 +693,7 @@ export {
   DEFAULT_SERVE_PORT,
   EmbeddingCache,
   FactStore,
+  LiveCaptureService,
   MEMORY_GRAPH_SCHEMA_VERSION,
   MEMORY_TYPES,
   Observer,
@@ -689,11 +717,13 @@ export {
   buildInjectionResult,
   buildKanbanLanes,
   buildOrUpdateMemoryGraphIndex,
+  buildRecallResult,
   buildSessionRecap,
   buildTemplateVariables,
   buildTransitionEvent,
   checkOpenClawCompatibility,
   checkPeerClawVault,
+  classifyRecallQuery,
   compareManifests,
   compareObservationText,
   compatCommand,
@@ -707,6 +737,8 @@ export {
   createFactExtractionAdapter,
   createGeminiFlashAdapter,
   createLlmFunction,
+  createMemorySlot,
+  createMemorySlotPlugin,
   createProject,
   createVault,
   deterministicInjectMatches,
@@ -715,10 +747,15 @@ export {
   embed,
   embedBatch,
   embedCommand,
+  ensureEntityProfiles,
+  evaluateCandidateQuality,
   extractCardSlug,
   extractFactsLlm,
   extractFactsRuleBased,
+  extractHeuristicMemories,
   extractKeywordSetFromTranscript,
+  extractMemoriesFromAssistantResponse,
+  extractTaggedMemoryNotes,
   extractTags,
   extractWikiLinks,
   factId,
@@ -756,6 +793,7 @@ export {
   indexInjectableItems,
   inferContextProfile,
   injectCommand,
+  isLikelyJunkMemory,
   isRegression,
   kanbanCommand,
   listConfig,
@@ -776,16 +814,21 @@ export {
   normalizeEntity,
   observeActiveSessions,
   observeCommand,
+  openclaw_plugin_default as openclawHookPlugin,
   parseKanbanMarkdown,
   parseSessionFile,
   parseSessionSourceLabel,
+  plausibilityScore,
   pushFileToRemote,
   qmdEmbed,
   qmdUpdate,
   queryTransitions,
   readAllTransitions,
+  readEntityProfile,
+  readEntityProfiles,
   readProject,
   rebuildCommand,
+  recallCommand,
   reciprocalRankFusion,
   reflectCommand,
   registerArchiveCommand,
@@ -797,6 +840,7 @@ export {
   registerInboxCommand,
   registerInjectCommand,
   registerMaintainCommand,
+  registerMemorySlot,
   registerMigrateCommand,
   registerMigrateObservationsCommand,
   registerObserveCommand,
@@ -832,6 +876,7 @@ export {
   syncBdCommand,
   syncKanbanBoard,
   syncWithPeer,
+  synthesizeEntityProfiles,
   tailscaleDiscoverCommand,
   tailscaleServeCommand,
   tailscaleStatusCommand,

package/dist/openclaw-plugin--gqA2BZw.d.ts

@@ -0,0 +1,267 @@
+import { D as Document, a as SearchOptions, b as SearchResult } from './types-DslKvCaj.js';
+import { PluginConfig } from './lib/config.js';
+import { b as RecallOptions } from './types-CbL-wIKi.js';
+
+type CapturedMemoryType = 'fact' | 'preference' | 'decision' | 'lesson' | 'entity' | 'episode' | 'relationship';
+interface CaptureMessage {
+    role: string;
+    content: string;
+    timestamp?: string;
+}
+interface CaptureCandidate {
+    content: string;
+    type: CapturedMemoryType;
+    confidence: number;
+    title?: string;
+    tags?: string[];
+    entities?: string[];
+    source: 'memory_note' | 'heuristic';
+    metadata?: Record<string, unknown>;
+}
+interface CaptureOptions {
+    vaultPath?: string;
+    agentId?: string;
+    pluginConfig?: PluginConfig;
+    minConfidence?: number;
+    dedupThreshold?: number;
+    maxPerTurn?: number;
+    sourceSessionId?: string;
+}
+interface CaptureRejection {
+    candidate: CaptureCandidate;
+    reason: string;
+}
+interface CaptureStoreResult {
+    stored: number;
+    rejected: number;
+    storedDocuments: string[];
+    acceptedCandidates: CaptureCandidate[];
+    rejectedCandidates: CaptureRejection[];
+}
+
+interface MemorySlotInitOptions {
+    vaultPath?: string;
+    agentId?: string;
+    pluginConfig?: PluginConfig;
+}
+interface MemoryStoreMetadata {
+    title?: string;
+    category?: string;
+    type?: CapturedMemoryType;
+    tags?: string[];
+    frontmatter?: Record<string, unknown>;
+}
+interface MemorySlotRecallOptions extends Omit<RecallOptions, 'vaultPath' | 'pluginConfig' | 'agentId'> {
+    vaultPath?: string;
+    pluginConfig?: PluginConfig;
+    agentId?: string;
+}
+interface MemorySlotSearchOptions extends SearchOptions {
+    vaultPath?: string;
+    pluginConfig?: PluginConfig;
+    agentId?: string;
+}
+interface MemorySlotStoreOptions extends MemoryStoreMetadata {
+    vaultPath?: string;
+    pluginConfig?: PluginConfig;
+    agentId?: string;
+}
+interface MemorySlot {
+    recall(query: string, options?: MemorySlotRecallOptions): Promise<string>;
+    capture(messages: unknown[], options?: CaptureOptions): Promise<CaptureStoreResult>;
+    store(content: string, metadata?: MemorySlotStoreOptions): Promise<Document>;
+    search(query: string, options?: MemorySlotSearchOptions): Promise<SearchResult[]>;
+}
+declare function createMemorySlot(defaults?: MemorySlotInitOptions): MemorySlot;
+declare function createMemorySlotPlugin(defaults?: MemorySlotInitOptions): {
+    plugins: {
+        slots: {
+            memory: MemorySlot;
+        };
+    };
+};
+declare function registerMemorySlot(registry: Record<string, any>, defaults?: MemorySlotInitOptions): void;
+
+type ClawVaultContextProfile = "default" | "planning" | "incident" | "handoff" | "auto";
+interface ClawVaultPluginConfig {
+    vaultPath?: string;
+    agentVaults?: Record<string, string>;
+    allowClawvaultExec?: boolean;
+    clawvaultBinaryPath?: string;
+    clawvaultBinarySha256?: string;
+    allowEnvAccess?: boolean;
+    enableStartupRecovery?: boolean;
+    enableSessionContextInjection?: boolean;
+    enableAutoCheckpoint?: boolean;
+    enableObserveOnNew?: boolean;
+    enableHeartbeatObservation?: boolean;
+    enableCompactionObservation?: boolean;
+    enableWeeklyReflection?: boolean;
+    enableFactExtraction?: boolean;
+    autoCheckpoint?: boolean;
+    observeOnHeartbeat?: boolean;
+    weeklyReflection?: boolean;
+    contextProfile?: ClawVaultContextProfile;
+    maxContextResults?: number;
+    enableBeforePromptRecall?: boolean;
+    enforceCommunicationProtocol?: boolean;
+    enableMessageSendingFilter?: boolean;
+    minQuestionRecallScore?: number;
+}
+
+type MemorySource = "memory" | "sessions";
+type MemorySearchResult = {
+    path: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+    source: MemorySource;
+    citation?: string;
+};
+type MemoryEmbeddingProbeResult = {
+    ok: boolean;
+    error?: string;
+};
+type MemorySyncProgressUpdate = {
+    completed: number;
+    total: number;
+    label?: string;
+};
+type MemoryProviderStatus = {
+    backend: "builtin" | "qmd";
+    provider: string;
+    model?: string;
+    requestedProvider?: string;
+    files?: number;
+    chunks?: number;
+    dirty?: boolean;
+    workspaceDir?: string;
+    dbPath?: string;
+    extraPaths?: string[];
+    sources?: MemorySource[];
+    sourceCounts?: Array<{
+        source: MemorySource;
+        files: number;
+        chunks: number;
+    }>;
+    cache?: {
+        enabled: boolean;
+        entries?: number;
+        maxEntries?: number;
+    };
+    fts?: {
+        enabled: boolean;
+        available: boolean;
+        error?: string;
+    };
+    fallback?: {
+        from: string;
+        reason?: string;
+    };
+    vector?: {
+        enabled: boolean;
+        available?: boolean;
+        extensionPath?: string;
+        loadError?: string;
+        dims?: number;
+    };
+    batch?: {
+        enabled: boolean;
+        failures: number;
+        limit: number;
+        wait: boolean;
+        concurrency: number;
+        pollIntervalMs: number;
+        timeoutMs: number;
+        lastError?: string;
+        lastProvider?: string;
+    };
+    custom?: Record<string, unknown>;
+};
+interface MemorySearchManager {
+    search(query: string, opts?: {
+        maxResults?: number;
+        minScore?: number;
+        sessionKey?: string;
+    }): Promise<MemorySearchResult[]>;
+    readFile(params: {
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }): Promise<{
+        text: string;
+        path: string;
+    }>;
+    status(): MemoryProviderStatus;
+    sync?(params?: {
+        reason?: string;
+        force?: boolean;
+        progress?: (update: MemorySyncProgressUpdate) => void;
+    }): Promise<void>;
+    probeEmbeddingAvailability(): Promise<MemoryEmbeddingProbeResult>;
+    probeVectorAvailability(): Promise<boolean>;
+    close?(): Promise<void>;
+}
+
+interface ClawVaultMemoryManagerOptions {
+    pluginConfig: ClawVaultPluginConfig;
+    workspaceDir?: string;
+    defaultAgentId?: string;
+    logger?: {
+        debug?: (message: string) => void;
+        warn: (message: string) => void;
+    };
+}
+declare class ClawVaultMemoryManager implements MemorySearchManager {
+    private readonly options;
+    constructor(options: ClawVaultMemoryManagerOptions);
+    search(query: string, opts?: {
+        maxResults?: number;
+        minScore?: number;
+        sessionKey?: string;
+    }): Promise<MemorySearchResult[]>;
+    readFile(params: {
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }): Promise<{
+        text: string;
+        path: string;
+    }>;
+    status(): MemoryProviderStatus;
+    sync(params?: {
+        reason?: string;
+        force?: boolean;
+        progress?: (update: {
+            completed: number;
+            total: number;
+            label?: string;
+        }) => void;
+    }): Promise<void>;
+    probeEmbeddingAvailability(): Promise<MemoryEmbeddingProbeResult>;
+    probeVectorAvailability(): Promise<boolean>;
+    close(): Promise<void>;
+}
+
+declare const clawvaultPlugin: {
+    id: string;
+    name: string;
+    kind: "memory";
+    description: string;
+    register(apiOrRuntime?: unknown): Promise<{
+        plugins: {
+            slots: {
+                memory: MemorySlot;
+            };
+        };
+    } | {
+        plugins: {
+            slots: {
+                memory: ClawVaultMemoryManager;
+            };
+        };
+    }>;
+};
+
+export { type CaptureOptions as C, type MemorySlot as M, type CaptureStoreResult as a, type CaptureCandidate as b, type CaptureMessage as c, type CaptureRejection as d, type CapturedMemoryType as e, type MemorySlotInitOptions as f, type MemorySlotRecallOptions as g, type MemorySlotSearchOptions as h, type MemorySlotStoreOptions as i, type MemoryStoreMetadata as j, createMemorySlot as k, createMemorySlotPlugin as l, clawvaultPlugin as m, registerMemorySlot as r };

package/dist/openclaw-plugin.d.ts

@@ -1,8 +1,4 @@
-declare const clawvaultPlugin: {
-    id: string;
-    name: string;
-    description: string;
-    register(): void;
-};
-
-export { clawvaultPlugin as default };
+export { l as createMemorySlotPlugin, m as default } from './openclaw-plugin--gqA2BZw.js';
+import './types-DslKvCaj.js';
+import './lib/config.js';
+import './types-CbL-wIKi.js';

package/dist/openclaw-plugin.js

@@ -1,14 +1,20 @@
+import {
+  createMemorySlotPlugin,
+  openclaw_plugin_default
+} from "./chunk-PLNK37JD.js";
+import "./chunk-RL2L6I6K.js";
+import "./chunk-NSXYM6EZ.js";
+import "./chunk-35JCYSRR.js";
+import "./chunk-BSJ6RIT7.js";
+import "./chunk-ECGJYWNA.js";
+import "./chunk-2CDEETQN.js";
+import "./chunk-FZ5I2NF7.js";
+import "./chunk-PTWPPVC7.js";
+import "./chunk-H3JZIB5O.js";
+import "./chunk-GJO3CFUN.js";
+import "./chunk-33DOSHTA.js";
 import "./chunk-2ZDO52B4.js";
-
-// src/openclaw-plugin.ts
-var clawvaultPlugin = {
-  id: "clawvault",
-  name: "ClawVault",
-  description: "Structured memory system for AI agents with context death resilience",
-  register() {
-  }
-};
-var openclaw_plugin_default = clawvaultPlugin;
 export {
+  createMemorySlotPlugin,
   openclaw_plugin_default as default
 };

package/dist/types-CbL-wIKi.d.ts

@@ -0,0 +1,36 @@
+import { a as SearchOptions, b as SearchResult } from './types-DslKvCaj.js';
+import { PluginConfig } from './lib/config.js';
+
+type RecallStrategy = 'quick' | 'entity' | 'temporal' | 'verification' | 'relationship';
+interface RecallQueryClassification {
+    strategy: RecallStrategy;
+    entityName?: string;
+    temporalDays?: number;
+}
+interface RecallOptions {
+    limit?: number;
+    strategy?: RecallStrategy;
+    includeSources?: boolean;
+    vaultPath?: string;
+    agentId?: string;
+    pluginConfig?: PluginConfig;
+    searchOptions?: SearchOptions;
+}
+interface RecallSource {
+    title: string;
+    path: string;
+    category: string;
+    score: number;
+    snippet: string;
+    modified: string;
+}
+interface RecallResult {
+    query: string;
+    strategy: RecallStrategy;
+    entityName?: string;
+    context: string;
+    sources: RecallSource[];
+    rawResults: SearchResult[];
+}
+
+export type { RecallStrategy as R, RecallQueryClassification as a, RecallOptions as b, RecallResult as c, RecallSource as d };

package/openclaw.plugin.json

@@ -2,6 +2,7 @@
   "id": "clawvault",
   "name": "ClawVault",
   "version": "2.7.0",
+  "kind": "memory",
   "description": "Structured memory system for AI agents with context death resilience",
   "configSchema": {
     "type": "object",
@@ -103,6 +104,28 @@
         "maximum": 20,
         "description": "Maximum number of context results to inject on session start",
         "default": 4
+      },
+      "enableBeforePromptRecall": {
+        "type": "boolean",
+        "description": "Enable before_prompt_build memory recall directives and vault context injection.",
+        "default": true
+      },
+      "enableMessageSendingFilter": {
+        "type": "boolean",
+        "description": "Enable outbound message filtering via message_sending hook.",
+        "default": true
+      },
+      "enforceCommunicationProtocol": {
+        "type": "boolean",
+        "description": "Append communication protocol rules to system context and enforce rewrites.",
+        "default": true
+      },
+      "minQuestionRecallScore": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "description": "Minimum memory_search score used when checking outbound questions for existing answers.",
+        "default": 0.35
       }
     },
     "additionalProperties": false
@@ -177,6 +200,22 @@
       "label": "Max Context Results",
       "description": "Number of vault memories to inject"
     },
+    "enableBeforePromptRecall": {
+      "label": "Enable Before Prompt Recall",
+      "description": "Use before_prompt_build to force memory recall and inject vault context."
+    },
+    "enableMessageSendingFilter": {
+      "label": "Enable Message Sending Filter",
+      "description": "Use message_sending to rewrite or block protocol violations."
+    },
+    "enforceCommunicationProtocol": {
+      "label": "Enforce Communication Protocol",
+      "description": "Append protocol rules to system context and enforce banned-pattern rewrites."
+    },
+    "minQuestionRecallScore": {
+      "label": "Min Question Recall Score",
+      "description": "Score threshold when deciding if outbound questions are already answered by memory."
+    },
     "observeOnHeartbeat": {
       "label": "Observe on Heartbeat (Legacy Alias)",
       "description": "Deprecated alias for enableHeartbeatObservation."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clawvault",
-  "version": "3.3.0",
-  "description": "Structured memory system for AI agents \u2014 typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. \ud83d\udc18",
+  "version": "3.4.1",
+  "description": "Structured memory system for AI agents — typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. 🐘",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -34,7 +34,7 @@
     ]
   },
   "scripts": {
-    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/benchmark.ts src/commands/blocked.ts src/commands/canvas.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inbox.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/maintain.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/rebuild.ts src/commands/rebuild-embeddings.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/sync-bd.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/openclaw-plugin.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts --format esm --dts --clean",
+    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/benchmark.ts src/commands/blocked.ts src/commands/canvas.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inbox.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/maintain.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/recall.ts src/commands/rebuild.ts src/commands/rebuild-embeddings.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/sync-bd.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/openclaw-plugin.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
@@ -98,4 +98,4 @@
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
   }
-}
+}