clawvault 3.2.1 → 3.4.0

package/dist/lib/config.js

@@ -3,8 +3,8 @@ import {
   getVaultPath,
   resolveAgentVaultPath,
   resolveVaultPath
-} from "../chunk-GNJL4YGR.js";
-import "../chunk-U67V476Y.js";
+} from "../chunk-GJO3CFUN.js";
+import "../chunk-2ZDO52B4.js";
 export {
   findNearestVaultPath,
   getVaultPath,

package/dist/lib/entity-index.js

@@ -2,7 +2,7 @@ import {
   buildEntityIndex,
   getSortedAliases
 } from "../chunk-J7ZWCI2C.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   buildEntityIndex,
   getSortedAliases

package/dist/lib/project-utils.js

@@ -6,11 +6,11 @@ import {
   listProjects,
   readProject,
   updateProject
-} from "../chunk-AZYOKJYC.js";
+} from "../chunk-4PY655YM.js";
 import "../chunk-QWQ3TIKS.js";
 import "../chunk-MFAWT5O5.js";
 import "../chunk-7766SIJP.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   archiveProject,
   createProject,

package/dist/lib/session-repair.js

@@ -6,7 +6,7 @@ import {
   parseTranscript,
   repairSession
 } from "../chunk-L53L5FCL.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   analyzeSession,
   computeParentRelinks,

package/dist/lib/session-utils.js

@@ -11,7 +11,7 @@ import {
   listSessions,
   loadSessionsStore
 } from "../chunk-HRLWZGMA.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   backupSession,
   findMainSession,

package/dist/lib/tailscale.js

@@ -23,7 +23,7 @@ import {
   syncWithPeer
 } from "../chunk-TIGW564L.js";
 import "../chunk-IVRIKYFE.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   CLAWVAULT_SERVE_PATH,
   DEFAULT_SERVE_PORT,

package/dist/lib/task-utils.js

@@ -26,7 +26,7 @@ import {
 } from "../chunk-QWQ3TIKS.js";
 import "../chunk-MFAWT5O5.js";
 import "../chunk-7766SIJP.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   completeTask,
   createBacklogItem,

package/dist/lib/template-engine.js

@@ -2,7 +2,7 @@ import {
   buildTemplateVariables,
   renderTemplate
 } from "../chunk-7766SIJP.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   buildTemplateVariables,
   renderTemplate

package/dist/lib/webdav.js

@@ -15,7 +15,7 @@ import {
   isPathSafe,
   resolveWebDAVPath
 } from "../chunk-IVRIKYFE.js";
-import "../chunk-U67V476Y.js";
+import "../chunk-2ZDO52B4.js";
 export {
   WEBDAV_PREFIX,
   checkAuth,

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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,20 @@
+import {
+  createMemorySlotPlugin,
+  openclaw_plugin_default
+} from "./chunk-QYQAGBTM.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";
+export {
+  createMemorySlotPlugin,
+  openclaw_plugin_default as default
+};