@cognee/cognee-openclaw 2026.2.4 → 2026.3.1

package/dist/src/persistence.d.ts

@@ -0,0 +1,17 @@
+import type { DatasetState, MemoryScope, ScopedSyncIndexes, SyncIndex } from "./types.js";
+export declare const STATE_DIR: string;
+export declare const STATE_PATH: string;
+export declare const SYNC_INDEX_PATH: string;
+export declare const SCOPED_SYNC_INDEX_PATH: string;
+export declare function loadDatasetState(): Promise<DatasetState>;
+export declare function saveDatasetState(state: DatasetState): Promise<void>;
+export declare function loadSyncIndex(): Promise<SyncIndex>;
+export declare function saveSyncIndex(state: SyncIndex): Promise<void>;
+export declare function loadScopedSyncIndexes(): Promise<ScopedSyncIndexes>;
+export declare function saveScopedSyncIndexes(indexes: ScopedSyncIndexes): Promise<void>;
+/**
+ * Fix #7: Migrate legacy single-scope sync index into multi-scope indexes.
+ * Moves all entries from the old sync-index.json into the specified default scope.
+ * After migration, the legacy file is left in place (harmless) but no longer read.
+ */
+export declare function migrateLegacyIndex(defaultScope: MemoryScope): Promise<ScopedSyncIndexes | null>;

package/dist/src/persistence.js

@@ -0,0 +1,107 @@
+import { promises as fs } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+// ---------------------------------------------------------------------------
+// State file paths
+// ---------------------------------------------------------------------------
+export const STATE_DIR = join(homedir(), ".openclaw", "memory", "cognee");
+export const STATE_PATH = join(STATE_DIR, "datasets.json");
+export const SYNC_INDEX_PATH = join(STATE_DIR, "sync-index.json");
+export const SCOPED_SYNC_INDEX_PATH = join(STATE_DIR, "scoped-sync-indexes.json");
+// ---------------------------------------------------------------------------
+// Dataset state (maps dataset name -> dataset ID)
+// ---------------------------------------------------------------------------
+export async function loadDatasetState() {
+    try {
+        const raw = await fs.readFile(STATE_PATH, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+}
+export async function saveDatasetState(state) {
+    await fs.mkdir(dirname(STATE_PATH), { recursive: true });
+    await fs.writeFile(STATE_PATH, JSON.stringify(state, null, 2), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Sync index (legacy single-scope)
+// ---------------------------------------------------------------------------
+export async function loadSyncIndex() {
+    try {
+        const raw = await fs.readFile(SYNC_INDEX_PATH, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return { entries: {} };
+        const record = parsed;
+        record.entries ??= {};
+        return record;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { entries: {} };
+        throw error;
+    }
+}
+export async function saveSyncIndex(state) {
+    await fs.mkdir(dirname(SYNC_INDEX_PATH), { recursive: true });
+    await fs.writeFile(SYNC_INDEX_PATH, JSON.stringify(state, null, 2), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Scoped sync indexes (multi-scope)
+//
+// Fix #6: On load, we validate that keys are valid MemoryScope values
+// and discard any garbage entries (e.g. typos like "compnay").
+//
+// Fix #7: Migration support — when switching from single to multi-scope,
+// we migrate the legacy sync index into the appropriate scope.
+// ---------------------------------------------------------------------------
+const VALID_SCOPES = new Set(["company", "user", "agent"]);
+export async function loadScopedSyncIndexes() {
+    try {
+        const raw = await fs.readFile(SCOPED_SYNC_INDEX_PATH, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        // Validate keys are valid scopes
+        const result = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (VALID_SCOPES.has(key) && value && typeof value === "object") {
+                const idx = value;
+                idx.entries ??= {};
+                result[key] = idx;
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+}
+export async function saveScopedSyncIndexes(indexes) {
+    await fs.mkdir(dirname(SCOPED_SYNC_INDEX_PATH), { recursive: true });
+    await fs.writeFile(SCOPED_SYNC_INDEX_PATH, JSON.stringify(indexes, null, 2), "utf-8");
+}
+/**
+ * Fix #7: Migrate legacy single-scope sync index into multi-scope indexes.
+ * Moves all entries from the old sync-index.json into the specified default scope.
+ * After migration, the legacy file is left in place (harmless) but no longer read.
+ */
+export async function migrateLegacyIndex(defaultScope) {
+    const legacy = await loadSyncIndex();
+    if (Object.keys(legacy.entries).length === 0)
+        return null;
+    const scoped = {
+        [defaultScope]: { ...legacy },
+    };
+    await saveScopedSyncIndexes(scoped);
+    return scoped;
+}
+//# sourceMappingURL=persistence.js.map

package/dist/src/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/persistence.ts"],"names":[],"mappings":"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"}

package/dist/src/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const memoryCogneePlugin: {
+    id: string;
+    name: string;
+    description: string;
+    kind: "memory";
+    register(api: OpenClawPluginApi): void;
+};
+export default memoryCogneePlugin;

package/dist/src/plugin.js

@@ -0,0 +1,510 @@
+import { randomUUID } from "node:crypto";
+import { MEMORY_SCOPES } from "./types.js";
+import { CogneeHttpClient } from "./client.js";
+import { resolveConfig } from "./config.js";
+import { collectMemoryFiles } from "./files.js";
+import { loadDatasetState, loadScopedSyncIndexes, loadSyncIndex, migrateLegacyIndex, SYNC_INDEX_PATH, } from "./persistence.js";
+import { datasetNameForScope, isMultiScopeEnabled, routeFileToScope } from "./scope.js";
+import { syncFiles, syncFilesScoped } from "./sync.js";
+// ---------------------------------------------------------------------------
+// Plugin registration
+// ---------------------------------------------------------------------------
+const memoryCogneePlugin = {
+    id: "cognee-openclaw",
+    name: "Memory (Cognee)",
+    description: "Cognee-backed memory with multi-scope support (company/user/agent), session tracking, and auto-recall",
+    kind: "memory",
+    register(api) {
+        const cfg = resolveConfig(api.pluginConfig);
+        const client = new CogneeHttpClient(cfg.baseUrl, cfg.apiKey, cfg.username, cfg.password, cfg.requestTimeoutMs, cfg.ingestionTimeoutMs);
+        const multiScope = isMultiScopeEnabled(cfg);
+        // Legacy single-scope state
+        let datasetId;
+        let syncIndex = { entries: {} };
+        // Multi-scope state
+        let scopedIndexes = {};
+        // Session state
+        let sessionId;
+        let resolvedWorkspaceDir;
+        // Load persisted state on startup
+        const stateReady = Promise.all([
+            loadDatasetState()
+                .then((state) => {
+                if (!multiScope) {
+                    datasetId = state[cfg.datasetName];
+                }
+            })
+                .catch((error) => {
+                api.logger.warn?.(`cognee-openclaw: failed to load dataset state: ${String(error)}`);
+            }),
+            multiScope
+                ? loadScopedSyncIndexes()
+                    .then(async (indexes) => {
+                    // Fix #7: Migrate legacy index if scoped indexes are empty
+                    if (Object.keys(indexes).length === 0) {
+                        const migrated = await migrateLegacyIndex(cfg.defaultWriteScope);
+                        if (migrated) {
+                            scopedIndexes = migrated;
+                            api.logger.info?.(`cognee-openclaw: migrated legacy sync index to scope "${cfg.defaultWriteScope}"`);
+                            return;
+                        }
+                    }
+                    scopedIndexes = indexes;
+                })
+                    .catch((error) => {
+                    api.logger.warn?.(`cognee-openclaw: failed to load scoped sync indexes: ${String(error)}`);
+                })
+                : loadSyncIndex()
+                    .then((state) => {
+                    syncIndex = state;
+                    if (!datasetId && state.datasetId && state.datasetName === cfg.datasetName) {
+                        datasetId = state.datasetId;
+                    }
+                })
+                    .catch((error) => {
+                    api.logger.warn?.(`cognee-openclaw: failed to load sync index: ${String(error)}`);
+                }),
+        ]);
+        // Fix #8: Log when scopes have no dataset ID during recall
+        async function getRecallDatasetIds() {
+            const state = await loadDatasetState();
+            const ids = [];
+            const missingScopes = [];
+            if (multiScope) {
+                for (const scope of cfg.recallScopes) {
+                    const dsName = datasetNameForScope(scope, cfg);
+                    const dsId = state[dsName] ?? scopedIndexes[scope]?.datasetId;
+                    if (dsId) {
+                        ids.push(dsId);
+                    }
+                    else {
+                        missingScopes.push(scope);
+                    }
+                }
+            }
+            else {
+                if (datasetId)
+                    ids.push(datasetId);
+            }
+            return { ids, missingScopes };
+        }
+        // Helper: run sync
+        async function runSync(workspaceDir, logger) {
+            await stateReady;
+            const files = await collectMemoryFiles(workspaceDir);
+            if (files.length === 0) {
+                logger.info?.("cognee-openclaw: no memory files found");
+                return { added: 0, updated: 0, skipped: 0, errors: 0, deleted: 0 };
+            }
+            logger.info?.(`cognee-openclaw: found ${files.length} memory file(s), syncing...`);
+            if (multiScope) {
+                return syncFilesScoped(client, files, files, scopedIndexes, cfg, logger);
+            }
+            else {
+                const result = await syncFiles(client, files, files, syncIndex, cfg, logger);
+                if (result.datasetId)
+                    datasetId = result.datasetId;
+                return result;
+            }
+        }
+        // ------------------------------------------------------------------
+        // CLI commands
+        // ------------------------------------------------------------------
+        api.registerCli((ctx) => {
+            const cognee = ctx.program.command("cognee").description("Cognee memory management");
+            const cliWorkspaceDir = ctx.workspaceDir || process.cwd();
+            cognee
+                .command("index")
+                .description("Sync memory files to Cognee (add new, update changed, skip unchanged)")
+                .action(async () => {
+                const result = await runSync(cliWorkspaceDir, ctx.logger);
+                const summary = `Sync complete: ${result.added} added, ${result.updated} updated, ${result.deleted} deleted, ${result.skipped} unchanged, ${result.errors} errors`;
+                ctx.logger.info?.(summary);
+                console.log(summary);
+                process.exit(0);
+            });
+            cognee
+                .command("status")
+                .description("Show Cognee sync state")
+                .action(async () => {
+                await stateReady;
+                const files = await collectMemoryFiles(cliWorkspaceDir);
+                if (multiScope) {
+                    const state = await loadDatasetState();
+                    for (const scope of MEMORY_SCOPES) {
+                        const dsName = datasetNameForScope(scope, cfg);
+                        const scopeIndex = scopedIndexes[scope] ?? { entries: {} };
+                        const entryCount = Object.keys(scopeIndex.entries).length;
+                        const scopeFiles = files.filter(f => routeFileToScope(f.path, cfg.scopeRouting, cfg.defaultWriteScope) === scope);
+                        let dirty = 0, newCount = 0;
+                        for (const file of scopeFiles) {
+                            const existing = scopeIndex.entries[file.path];
+                            if (!existing)
+                                newCount++;
+                            else if (existing.hash !== file.hash)
+                                dirty++;
+                        }
+                        console.log(`\n[${scope.toUpperCase()}] Dataset: ${dsName}`);
+                        console.log(`  Dataset ID: ${state[dsName] ?? scopeIndex.datasetId ?? "(not set)"}`);
+                        console.log(`  Indexed files: ${entryCount}`);
+                        console.log(`  Workspace files: ${scopeFiles.length}`);
+                        console.log(`  New (unindexed): ${newCount}`);
+                        console.log(`  Changed (dirty): ${dirty}`);
+                    }
+                }
+                else {
+                    const entryCount = Object.keys(syncIndex.entries).length;
+                    const entriesWithDataId = Object.values(syncIndex.entries).filter((e) => e.dataId).length;
+                    let dirty = 0, newCount = 0;
+                    for (const file of files) {
+                        const existing = syncIndex.entries[file.path];
+                        if (!existing)
+                            newCount++;
+                        else if (existing.hash !== file.hash)
+                            dirty++;
+                    }
+                    console.log([
+                        `Dataset: ${syncIndex.datasetName ?? cfg.datasetName}`,
+                        `Dataset ID: ${datasetId ?? syncIndex.datasetId ?? "(not set)"}`,
+                        `Indexed files: ${entryCount} (${entriesWithDataId} with data ID)`,
+                        `Workspace files: ${files.length}`,
+                        `New (unindexed): ${newCount}`,
+                        `Changed (dirty): ${dirty}`,
+                        `Sync index: ${SYNC_INDEX_PATH}`,
+                    ].join("\n"));
+                }
+                process.exit(0);
+            });
+            cognee
+                .command("health")
+                .description("Check Cognee API connectivity")
+                .action(async () => {
+                try {
+                    const result = await client.health();
+                    console.log(`Cognee API: OK (${cfg.baseUrl})`);
+                    if (result.status)
+                        console.log(`Status: ${result.status}`);
+                }
+                catch (error) {
+                    console.log(`Cognee API: UNREACHABLE (${cfg.baseUrl})`);
+                    console.log(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                    process.exit(1);
+                }
+                process.exit(0);
+            });
+            cognee
+                .command("setup")
+                .description("Configure OpenClaw to use Cognee for memory (default: replaces built-in, --hybrid: alongside built-in)")
+                .option("--hybrid", "Keep built-in memory providers enabled alongside Cognee")
+                .action(async (opts) => {
+                const { loadConfig, writeConfigFile } = api.runtime.config;
+                const config = loadConfig();
+                // Set Cognee as the memory slot
+                config.plugins ??= {};
+                config.plugins.slots ??= {};
+                config.plugins.slots.memory = "cognee-openclaw";
+                config.plugins.entries ??= {};
+                const entries = config.plugins.entries;
+                if (opts.hybrid) {
+                    // Hybrid mode: keep built-in memory enabled
+                    entries["memory-core"] ??= { enabled: true };
+                    entries["memory-core"].enabled = true;
+                }
+                else {
+                    // Exclusive mode: disable built-in memory providers
+                    entries["memory-core"] = { enabled: false };
+                    entries["memory-lancedb"] = { enabled: false };
+                }
+                // Ensure cognee-openclaw is enabled
+                entries["cognee-openclaw"] ??= { enabled: true };
+                entries["cognee-openclaw"].enabled = true;
+                await writeConfigFile(config);
+                if (opts.hybrid) {
+                    console.log("Cognee memory setup complete (hybrid mode):");
+                    console.log("  - Memory slot set to cognee-openclaw");
+                    console.log("  - memory-core enabled (built-in memory active)");
+                    console.log("\nBoth Cognee recall and built-in memory search are active.");
+                }
+                else {
+                    console.log("Cognee memory setup complete:");
+                    console.log("  - Memory slot set to cognee-openclaw");
+                    console.log("  - memory-core disabled");
+                    console.log("  - memory-lancedb disabled");
+                }
+                console.log("\nRun 'openclaw cognee health' to verify Cognee connectivity.");
+                process.exit(0);
+            });
+            cognee
+                .command("scopes")
+                .description("Show memory scope routing for current workspace files")
+                .action(async () => {
+                const files = await collectMemoryFiles(cliWorkspaceDir);
+                if (files.length === 0) {
+                    console.log("No memory files found.");
+                    process.exit(0);
+                }
+                if (!multiScope) {
+                    console.log(`Multi-scope mode is OFF. All files go to dataset "${cfg.datasetName}".`);
+                    console.log(`Set companyDataset, userDatasetPrefix, or agentDatasetPrefix to enable.`);
+                    process.exit(0);
+                }
+                const grouped = { company: [], user: [], agent: [] };
+                for (const file of files) {
+                    const scope = routeFileToScope(file.path, cfg.scopeRouting, cfg.defaultWriteScope);
+                    grouped[scope].push(file.path);
+                }
+                for (const scope of MEMORY_SCOPES) {
+                    const dsName = datasetNameForScope(scope, cfg);
+                    console.log(`\n[${scope.toUpperCase()}] -> dataset "${dsName}"`);
+                    if (grouped[scope].length === 0)
+                        console.log("  (no files)");
+                    else
+                        for (const p of grouped[scope])
+                            console.log(`  ${p}`);
+                }
+                process.exit(0);
+            });
+        }, { commands: ["cognee"] });
+        // ------------------------------------------------------------------
+        // Auto-sync on startup (with health check)
+        // ------------------------------------------------------------------
+        if (cfg.autoIndex) {
+            api.registerService({
+                id: "cognee-auto-sync",
+                async start(ctx) {
+                    resolvedWorkspaceDir = ctx.workspaceDir || process.cwd();
+                    try {
+                        await client.health();
+                    }
+                    catch (error) {
+                        ctx.logger.warn?.(`cognee-openclaw: Cognee API unreachable at ${cfg.baseUrl} — auto-sync disabled for this session. Error: ${String(error)}`);
+                        return;
+                    }
+                    if (cfg.enableSessions) {
+                        sessionId = `openclaw-${randomUUID()}`;
+                        ctx.logger.info?.(`cognee-openclaw: session ${sessionId}`);
+                    }
+                    try {
+                        const result = await runSync(resolvedWorkspaceDir, ctx.logger);
+                        ctx.logger.info?.(`cognee-openclaw: auto-sync complete: ${result.added} added, ${result.updated} updated, ${result.deleted} deleted, ${result.skipped} unchanged`);
+                    }
+                    catch (error) {
+                        ctx.logger.warn?.(`cognee-openclaw: auto-sync failed: ${String(error)}`);
+                    }
+                },
+            });
+        }
+        // ------------------------------------------------------------------
+        // Auto-recall: inject memories before each agent run
+        // ------------------------------------------------------------------
+        if (cfg.autoRecall) {
+            api.on("before_agent_start", async (event, ctx) => {
+                await stateReady;
+                if (!event.prompt || event.prompt.length < 5) {
+                    api.logger.debug?.("cognee-openclaw: skipping recall (prompt too short)");
+                    return;
+                }
+                const { ids: recallDatasetIds, missingScopes } = await getRecallDatasetIds();
+                // Fix #8: Log missing scopes so users know what's not being searched
+                if (missingScopes.length > 0) {
+                    api.logger.info?.(`cognee-openclaw: scope(s) not yet indexed (no data): ${missingScopes.join(", ")}`);
+                }
+                if (recallDatasetIds.length === 0) {
+                    api.logger.debug?.("cognee-openclaw: skipping recall (no datasetIds)");
+                    return;
+                }
+                try {
+                    if (multiScope) {
+                        // Fix #10: Use Promise.allSettled for resilience
+                        const state = await loadDatasetState();
+                        const searchPromises = cfg.recallScopes.map(async (scope) => {
+                            const dsName = datasetNameForScope(scope, cfg);
+                            const dsId = state[dsName] ?? scopedIndexes[scope]?.datasetId;
+                            if (!dsId)
+                                return null;
+                            const results = await client.search({
+                                queryText: event.prompt,
+                                searchType: cfg.searchType,
+                                datasetIds: [dsId],
+                                searchPrompt: cfg.searchPrompt,
+                                maxTokens: cfg.maxTokens,
+                                sessionId,
+                            });
+                            const filtered = results
+                                .filter((r) => r.score >= cfg.minScore)
+                                .slice(0, cfg.maxResults);
+                            return filtered.length > 0 ? { scope, results: filtered } : null;
+                        });
+                        // Fix #10: allSettled — inject whatever succeeds, log failures
+                        const settled = await Promise.allSettled(searchPromises);
+                        const scopeResults = {};
+                        for (let i = 0; i < settled.length; i++) {
+                            const outcome = settled[i];
+                            const scope = cfg.recallScopes[i];
+                            if (outcome.status === "fulfilled" && outcome.value) {
+                                scopeResults[outcome.value.scope] = outcome.value.results;
+                            }
+                            else if (outcome.status === "rejected") {
+                                api.logger.warn?.(`cognee-openclaw: recall failed for scope ${scope}: ${String(outcome.reason)}`);
+                            }
+                        }
+                        if (Object.keys(scopeResults).length === 0) {
+                            api.logger.debug?.("cognee-openclaw: search returned no results above minScore");
+                            return;
+                        }
+                        const sections = [];
+                        for (const scope of cfg.recallScopes) {
+                            const results = scopeResults[scope];
+                            if (!results || results.length === 0)
+                                continue;
+                            const payload = JSON.stringify(results.map((r) => ({ id: r.id, score: r.score, text: r.text, metadata: r.metadata })), null, 2);
+                            sections.push(`<${scope}_memory>\n${payload}\n</${scope}_memory>`);
+                        }
+                        const totalResults = Object.values(scopeResults).reduce((sum, arr) => sum + arr.length, 0);
+                        api.logger.info?.(`cognee-openclaw: injecting ${totalResults} memories across ${Object.keys(scopeResults).length} scope(s)`);
+                        return { prependContext: `<cognee_memories>\n${sections.join("\n")}\n</cognee_memories>` };
+                    }
+                    else {
+                        // Legacy single-scope
+                        const results = await client.search({
+                            queryText: event.prompt,
+                            searchType: cfg.searchType,
+                            datasetIds: recallDatasetIds,
+                            searchPrompt: cfg.searchPrompt,
+                            maxTokens: cfg.maxTokens,
+                            sessionId,
+                        });
+                        const filtered = results
+                            .filter((r) => r.score >= cfg.minScore)
+                            .slice(0, cfg.maxResults);
+                        if (filtered.length === 0) {
+                            api.logger.debug?.("cognee-openclaw: search returned no results above minScore");
+                            return;
+                        }
+                        const payload = JSON.stringify(filtered.map((r) => ({ id: r.id, score: r.score, text: r.text, metadata: r.metadata })), null, 2);
+                        api.logger.info?.(`cognee-openclaw: injecting ${filtered.length} memories`);
+                        return { prependContext: `<cognee_memories>\nRelevant memories:\n${payload}\n</cognee_memories>` };
+                    }
+                }
+                catch (error) {
+                    api.logger.warn?.(`cognee-openclaw: recall failed: ${String(error)}`);
+                }
+            });
+        }
+        // ------------------------------------------------------------------
+        // Post-agent sync + session persistence
+        // ------------------------------------------------------------------
+        if (cfg.autoIndex) {
+            api.on("agent_end", async (event, ctx) => {
+                if (!event.success)
+                    return;
+                await stateReady;
+                const workspaceDir = resolvedWorkspaceDir || process.cwd();
+                // Fix #4: Actually persist the session into the knowledge graph
+                if (cfg.enableSessions && cfg.persistSessionsAfterEnd && sessionId) {
+                    try {
+                        // Determine target dataset for session persistence
+                        const targetDatasetIds = [];
+                        if (multiScope) {
+                            const state = await loadDatasetState();
+                            const agentDsName = datasetNameForScope("agent", cfg);
+                            const agentDsId = state[agentDsName] ?? scopedIndexes.agent?.datasetId;
+                            if (agentDsId)
+                                targetDatasetIds.push(agentDsId);
+                        }
+                        else if (datasetId) {
+                            targetDatasetIds.push(datasetId);
+                        }
+                        if (targetDatasetIds.length > 0) {
+                            // Call Cognee's session persistence endpoint via the generic fetchJson
+                            await client.fetchJson("/api/v1/sessions/persist", {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({
+                                    session_ids: [sessionId],
+                                    dataset_ids: targetDatasetIds,
+                                }),
+                            }).catch(() => {
+                                // Session persistence endpoint may not exist on all Cognee versions.
+                                // Fail silently — this is an enhancement, not critical path.
+                                api.logger.debug?.("cognee-openclaw: session persistence endpoint not available");
+                            });
+                        }
+                    }
+                    catch (error) {
+                        api.logger.warn?.(`cognee-openclaw: session persistence failed: ${String(error)}`);
+                    }
+                }
+                // Sync file changes
+                try {
+                    if (multiScope) {
+                        try {
+                            const freshIndexes = await loadScopedSyncIndexes();
+                            scopedIndexes = freshIndexes;
+                        }
+                        catch { /* fall through */ }
+                        const files = await collectMemoryFiles(workspaceDir);
+                        let hasChanges = false;
+                        for (const file of files) {
+                            const scope = routeFileToScope(file.path, cfg.scopeRouting, cfg.defaultWriteScope);
+                            const scopeIndex = scopedIndexes[scope];
+                            if (!scopeIndex) {
+                                hasChanges = true;
+                                break;
+                            }
+                            const existing = scopeIndex.entries[file.path];
+                            if (!existing || existing.hash !== file.hash) {
+                                hasChanges = true;
+                                break;
+                            }
+                        }
+                        if (!hasChanges) {
+                            const currentPaths = new Set(files.map(f => f.path));
+                            for (const scopeIndex of Object.values(scopedIndexes)) {
+                                if (scopeIndex && Object.keys(scopeIndex.entries).some(p => !currentPaths.has(p))) {
+                                    hasChanges = true;
+                                    break;
+                                }
+                            }
+                        }
+                        if (!hasChanges)
+                            return;
+                        api.logger.info?.("cognee-openclaw: detected changes, syncing across scopes...");
+                        const result = await syncFilesScoped(client, files, files, scopedIndexes, cfg, api.logger);
+                        api.logger.info?.(`cognee-openclaw: post-agent sync: ${result.added} added, ${result.updated} updated, ${result.deleted} deleted`);
+                    }
+                    else {
+                        try {
+                            const freshIndex = await loadSyncIndex();
+                            syncIndex.entries = freshIndex.entries;
+                            if (freshIndex.datasetId)
+                                syncIndex.datasetId = freshIndex.datasetId;
+                            if (freshIndex.datasetName)
+                                syncIndex.datasetName = freshIndex.datasetName;
+                        }
+                        catch { /* fall through */ }
+                        const files = await collectMemoryFiles(workspaceDir);
+                        const changedFiles = files.filter((f) => {
+                            const existing = syncIndex.entries[f.path];
+                            return !existing || existing.hash !== f.hash;
+                        });
+                        const currentPaths = new Set(files.map(f => f.path));
+                        const hasDeletedFiles = Object.keys(syncIndex.entries).some(p => !currentPaths.has(p));
+                        if (changedFiles.length === 0 && !hasDeletedFiles)
+                            return;
+                        api.logger.info?.(`cognee-openclaw: detected ${changedFiles.length} changed file(s)${hasDeletedFiles ? " + deletions" : ""}, syncing...`);
+                        const result = await syncFiles(client, changedFiles, files, syncIndex, cfg, api.logger);
+                        if (result.datasetId)
+                            datasetId = result.datasetId;
+                        api.logger.info?.(`cognee-openclaw: post-agent sync: ${result.added} added, ${result.updated} updated, ${result.deleted} deleted`);
+                    }
+                }
+                catch (error) {
+                    api.logger.warn?.(`cognee-openclaw: post-agent sync failed: ${String(error)}`);
+                }
+            });
+        }
+    },
+};
+export default memoryCogneePlugin;
+//# sourceMappingURL=plugin.js.map