@cognee/cognee-openclaw 2026.5.21 → 2026.7.9

package/dist/src/server.js

@@ -0,0 +1,416 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/sandbox";
+const COGNEE_PLUGIN_BASE = join(homedir(), ".cognee-plugin");
+const API_KEY_CACHE_PATH = join(COGNEE_PLUGIN_BASE, "api_key.json");
+// Combined install-and-boot script written to ~/.cognee-plugin/ensure_and_boot.py on first use.
+// Handles: (1) creating the venv + installing cognee if absent, (2) booting uvicorn.
+// Self-daemonizes so runPluginCommandWithTimeout returns in < 1 s regardless of install time.
+// Inlining avoids import.meta.url path resolution issues in ts-jest.
+const ENSURE_SCRIPT_PATH = join(COGNEE_PLUGIN_BASE, "ensure_and_boot.py");
+const ENSURE_SCRIPT_CONTENT = [
+    "import subprocess, sys, os, json, time",
+    "",
+    "BASE = os.path.join(os.path.expanduser('~'), '.cognee-plugin')",
+    "VENV_DIR = os.path.join(BASE, 'venv')",
+    "_bin = 'Scripts' if os.name == 'nt' else 'bin'",
+    "_ext = '.exe' if os.name == 'nt' else ''",
+    "VENV_PYTHON = os.path.join(VENV_DIR, _bin, 'python' + _ext)",
+    "PIP = os.path.join(VENV_DIR, _bin, 'pip' + _ext)",
+    "UV_DIR = os.path.join(BASE, 'uv')",
+    "UV_BIN = os.path.join(UV_DIR, 'uv' + _ext)",
+    "READY_MARKER = os.path.join(BASE, '.venv-ready.json')",
+    "INSTALL_LOCK = os.path.join(BASE, 'venv-install.lock')",
+    "COGNEE_VERSION = '1.2.2.dev3'",
+    "",
+    "# Self-daemonize so the caller returns immediately.",
+    "if '--daemon' not in sys.argv:",
+    "    port_arg = sys.argv[1] if len(sys.argv) > 1 else '8011'",
+    "    p = subprocess.Popen(",
+    "        [sys.executable, __file__, port_arg, '--daemon'],",
+    "        start_new_session=True, close_fds=True,",
+    "        stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,",
+    "    )",
+    "    print(p.pid)",
+    "    sys.exit(0)",
+    "",
+    "PORT = next((a for a in sys.argv[1:] if a != '--daemon'), '8011')",
+    "",
+    "def pid_alive(pid):",
+    "    if pid <= 1: return False",
+    "    try: os.kill(pid, 0); return True",
+    "    except ProcessLookupError: return False",
+    "    except PermissionError: return True",
+    "    except Exception: return False",
+    "",
+    "def acquire_lock(path, stale_secs=720):",
+    "    os.makedirs(os.path.dirname(path) or '.', exist_ok=True)",
+    "    now = time.time()",
+    "    if os.path.exists(path):",
+    "        try:",
+    "            d = json.loads(open(path).read())",
+    "            pid = int(d.get('pid', 0) or 0)",
+    "            created = float(d.get('created_at', 0) or 0)",
+    "            if pid_alive(pid) and now - created < stale_secs: return False",
+    "            os.unlink(path)",
+    "        except Exception: pass",
+    "    try:",
+    "        fd = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY)",
+    "        with os.fdopen(fd, 'w') as f: json.dump({'pid': os.getpid(), 'created_at': now}, f)",
+    "        return True",
+    "    except FileExistsError: return False",
+    "",
+    "def release_lock(path):",
+    "    try: os.unlink(path)",
+    "    except Exception: pass",
+    "",
+    "def install_cognee():",
+    "    os.makedirs(BASE, exist_ok=True)",
+    "    if not acquire_lock(INSTALL_LOCK):",
+    "        deadline = time.monotonic() + 720",
+    "        while time.monotonic() < deadline:",
+    "            if os.path.exists(VENV_PYTHON): return True",
+    "            time.sleep(0.5)",
+    "        return os.path.exists(VENV_PYTHON)",
+    "    try:",
+    "        import shutil",
+    "        uv = UV_BIN if os.path.exists(UV_BIN) else (shutil.which('uv') or '')",
+    "        if uv:",
+    "            uv_env = os.environ.copy()",
+    "            if not os.path.exists(VENV_PYTHON):",
+    "                subprocess.run(",
+    "                    [uv, 'venv', VENV_DIR, '--python', '3.12'],",
+    "                    env=uv_env, check=True, capture_output=True, timeout=300,",
+    "                )",
+    "            subprocess.run(",
+    "                [uv, 'pip', 'install', '--upgrade', '--python', VENV_PYTHON,",
+    "                 f'cognee=={COGNEE_VERSION}'],",
+    "                env=uv_env, check=True, capture_output=True, timeout=600,",
+    "            )",
+    "        elif not os.path.exists(VENV_PYTHON):",
+    "            subprocess.run(",
+    "                [sys.executable, '-m', 'venv', VENV_DIR],",
+    "                check=True, capture_output=True, timeout=120,",
+    "            )",
+    "            subprocess.run(",
+    "                [PIP, 'install', '--upgrade', f'cognee=={COGNEE_VERSION}'],",
+    "                check=True, capture_output=True, timeout=600,",
+    "            )",
+    "        tmp = READY_MARKER + '.tmp'",
+    "        with open(tmp, 'w') as f:",
+    "            json.dump({'cognee_version': COGNEE_VERSION, 'python': VENV_PYTHON,",
+    "                       'updated_at': time.time()}, f)",
+    "        os.replace(tmp, READY_MARKER)",
+    "        return True",
+    "    except Exception: return False",
+    "    finally: release_lock(INSTALL_LOCK)",
+    "",
+    "def boot_server():",
+    "    if not os.path.exists(VENV_PYTHON): return",
+    "    home = os.path.expanduser('~')",
+    "    env = dict(os.environ)",
+    "    env['COGNEE_AGENT_MODE'] = 'true'",
+    "    env['AUTO_FEEDBACK'] = 'true'",
+    "    env['CACHING'] = 'true'",
+    "    env['SYSTEM_ROOT_DIRECTORY'] = os.path.join(home, '.cognee', 'system')",
+    "    env['DATA_ROOT_DIRECTORY'] = os.path.join(home, '.cognee', 'data')",
+    "    env['CACHE_ROOT_DIRECTORY'] = os.path.join(home, '.cognee', 'cache')",
+    "    subprocess.Popen(",
+    "        [VENV_PYTHON, '-m', 'uvicorn', 'cognee.api.client:app', '--port', PORT],",
+    "        env=env, start_new_session=True, close_fds=True,",
+    "        stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,",
+    "    )",
+    "",
+    "def needs_install():",
+    "    if not os.path.exists(VENV_PYTHON): return True",
+    "    if os.path.exists(READY_MARKER):",
+    "        try:",
+    "            d = json.loads(open(READY_MARKER).read())",
+    "            if d.get('cognee_version') == COGNEE_VERSION: return False",
+    "        except Exception: pass",
+    "    return True",
+    "",
+    "if needs_install():",
+    "    install_cognee()",
+    "boot_server()",
+].join("\n");
+// System Python candidates for running ensure_and_boot.py on a cold machine
+// (before the plugin venv exists). Only stdlib is needed so any Python 3 works.
+const SYSTEM_PYTHON_CANDIDATES = [
+    "/usr/bin/python3", // macOS Xcode CLT + most Linux
+    "/usr/local/bin/python3", // some Linux, older Homebrew
+    "/opt/homebrew/bin/python3", // Homebrew on Apple Silicon
+];
+function findSystemPython() {
+    for (const p of SYSTEM_PYTHON_CANDIDATES) {
+        if (existsSync(p))
+            return p;
+    }
+    return "python3"; // PATH fallback
+}
+async function saveApiKeyCache(baseUrl, key) {
+    try {
+        await mkdir(COGNEE_PLUGIN_BASE, { recursive: true });
+        await writeFile(API_KEY_CACHE_PATH, JSON.stringify({ base_url: baseUrl, api_key: key, updated_at: new Date().toISOString() }), "utf-8");
+    }
+    catch { /* best-effort */ }
+}
+/**
+ * Resolve a permanent Cognee API key for this deployment, using the same
+ * strategy as the claude-code and codex integrations:
+ *   1. COGNEE_API_KEY env
+ *   2. Cached key in ~/.cognee-plugin/api_key.json
+ *   3. Existing key returned by GET /api/v1/auth/api-keys
+ *   4. Mint a new one via POST /api/v1/auth/api-keys and cache it
+ *
+ * The client's ensureAuth() has already run before this is called, so
+ * the HTTP calls go out authenticated. Returns "" if every path fails
+ * (e.g. older Cognee that doesn't expose the api-keys endpoints).
+ */
+export async function resolveOrMintApiKey(client, logger) {
+    const envKey = (process.env["COGNEE_API_KEY"] ?? "").trim();
+    if (envKey)
+        return envKey;
+    try {
+        const cache = JSON.parse(await readFile(API_KEY_CACHE_PATH, "utf-8"));
+        const key = typeof cache.api_key === "string" ? cache.api_key.trim() : "";
+        if (key)
+            return key;
+    }
+    catch { /* cache miss */ }
+    try {
+        const keys = await client.listApiKeys();
+        const key = Array.isArray(keys) ? (keys[0]?.key ?? "").trim() : "";
+        if (key) {
+            await saveApiKeyCache(client.baseUrl, key);
+            return key;
+        }
+    }
+    catch (e) {
+        logger.warn?.(`cognee-openclaw: list API keys failed: ${String(e)}`);
+    }
+    try {
+        const { key } = await client.createApiKey("openclaw-bootstrap");
+        const trimmed = (key ?? "").trim();
+        if (trimmed) {
+            await saveApiKeyCache(client.baseUrl, trimmed);
+            logger.info?.("cognee-openclaw: minted new API key");
+            return trimmed;
+        }
+    }
+    catch (e) {
+        logger.warn?.(`cognee-openclaw: create API key failed: ${String(e)}`);
+    }
+    return "";
+}
+export function isLocalUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return ["localhost", "127.0.0.1", "0.0.0.0", "::1"].includes(parsed.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write ensure_and_boot.py and run it via the plugin sandbox.
+ * The script self-daemonizes, so this returns in < 1 s regardless of whether
+ * cognee needs to be installed from scratch.
+ */
+export async function bootServerIfNeeded(baseUrl, logger) {
+    if (!isLocalUrl(baseUrl))
+        return;
+    let port = 8011;
+    try {
+        const parsed = new URL(baseUrl);
+        if (parsed.port) {
+            const p = parseInt(parsed.port, 10);
+            if (Number.isFinite(p) && p > 0)
+                port = p;
+        }
+    }
+    catch { /* keep default */ }
+    const python = findSystemPython();
+    await mkdir(COGNEE_PLUGIN_BASE, { recursive: true });
+    await writeFile(ENSURE_SCRIPT_PATH, ENSURE_SCRIPT_CONTENT, "utf-8");
+    const result = await runPluginCommandWithTimeout({
+        argv: [python, ENSURE_SCRIPT_PATH, String(port)],
+        timeoutMs: 5_000,
+    });
+    if (result.code !== 0) {
+        logger.warn?.(`cognee-openclaw: boot script exited ${result.code}: ${result.stderr}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Exit-watcher: detached Python process that deregisters an agent session
+// when the OpenClaw gateway process dies (by any means: Ctrl+C, SIGKILL,
+// crash, clean exit). One watcher per registration, all watching the same
+// gateway PID. State lives in ~/.openclaw/cognee/ separate from the shared
+// Cognee venv infrastructure in ~/.cognee-plugin/.
+// ---------------------------------------------------------------------------
+const OPENCLAW_STATE_DIR = join(homedir(), ".openclaw", "cognee");
+const EXIT_WATCHER_SCRIPT_PATH = join(OPENCLAW_STATE_DIR, "exit-watcher.py");
+const EXIT_WATCHERS_DIR = join(OPENCLAW_STATE_DIR, "exit-watchers");
+const EXIT_WATCHER_CONTENT = [
+    "import json, os, sys, time, urllib.request",
+    "",
+    "POLL = 2.0",
+    "LOG_PATH = os.path.join(os.path.expanduser('~'), '.openclaw', 'cognee', 'exit-watcher.log')",
+    "",
+    "def log(msg):",
+    "    try:",
+    "        with open(LOG_PATH, 'a') as f:",
+    "            f.write(time.strftime('%Y-%m-%dT%H:%M:%S') + ' ' + str(msg) + '\\n')",
+    "    except Exception: pass",
+    "",
+    "def pid_alive(pid):",
+    "    if pid <= 1: return False",
+    "    try: os.kill(pid, 0); return True",
+    "    except ProcessLookupError: return False",
+    "    except PermissionError: return True",
+    "    except Exception: return False",
+    "",
+    "def owns_pidfile(path):",
+    "    try: return int(open(path).read().strip()) == os.getpid()",
+    "    except Exception: return False",
+    "",
+    "def post_json(base_url, path, payload, api_key, timeout):",
+    "    url = base_url.rstrip('/') + path",
+    "    data = json.dumps(payload).encode()",
+    "    req = urllib.request.Request(url, data=data, method='POST',",
+    "          headers={'Content-Type': 'application/json'})",
+    "    # X-Api-Key only: an API key is not a JWT, and a bogus Bearer can be",
+    "    # rejected by JWT-validating servers before the key is considered.",
+    "    if api_key:",
+    "        req.add_header('X-Api-Key', api_key)",
+    "    with urllib.request.urlopen(req, timeout=timeout) as r:",
+    "        return r.read()",
+    "",
+    "def bridge_session(base_url, dataset_name, session_id, api_key):",
+    "    # Bridge the server-side session cache into the permanent graph BEFORE",
+    "    # unregistering: unregister may drop activeAgents to 0, and in",
+    "    # COGNEE_AGENT_MODE the server then shuts down mid-pipeline.",
+    "    # run_in_background=false so the call returns only when the bridge is done.",
+    "    try:",
+    "        body = post_json(base_url, '/api/v1/improve',",
+    "            {'dataset_name': dataset_name, 'session_ids': [session_id],",
+    "             'run_in_background': False}, api_key, 120)",
+    "        log(f'improve ok session={session_id} body={body.decode()[:200]}')",
+    "    except Exception as e:",
+    "        log(f'improve error session={session_id} type={type(e).__name__} err={e}')",
+    "",
+    "def deregister(base_url, name, api_key):",
+    "    try:",
+    "        body = post_json(base_url, '/api/v1/agents/unregister',",
+    "            {'agent_session_name': name}, api_key, 10)",
+    "        log(f'deregister ok name={name} body={body.decode()[:200]}')",
+    "    except Exception as e:",
+    "        log(f'deregister error name={name} type={type(e).__name__} err={e}')",
+    "",
+    "if '--daemon' not in sys.argv:",
+    "    import subprocess",
+    "    subprocess.Popen([sys.executable, __file__, sys.argv[1], '--daemon'],",
+    "        start_new_session=True, close_fds=True,",
+    "        stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)",
+    "    sys.exit(0)",
+    "",
+    "try: a = json.loads(next(x for x in sys.argv[1:] if x != '--daemon'))",
+    "except Exception as e: log(f'arg parse error: {e}'); sys.exit(0)",
+    "",
+    "gw_pid = int(a.get('gateway_pid', 0))",
+    "name = str(a.get('agent_session_name', ''))",
+    "base_url = str(a.get('base_url', 'http://localhost:8011'))",
+    "api_key = str(a.get('api_key', '') or '')",
+    "pidfile = str(a.get('pidfile', ''))",
+    "dataset_name = str(a.get('dataset_name', '') or '')",
+    "cognee_session_id = str(a.get('cognee_session_id', '') or '')",
+    "",
+    "if not gw_pid or not name or not pidfile:",
+    "    log(f'bad args gw_pid={gw_pid} name={name} pidfile={pidfile}'); sys.exit(0)",
+    "",
+    "try:",
+    "    os.makedirs(os.path.dirname(pidfile) or '.', exist_ok=True)",
+    "    open(pidfile, 'w').write(str(os.getpid()))",
+    "except Exception as e:",
+    "    log(f'pidfile write error: {e}'); sys.exit(0)",
+    "",
+    "log(f'started pid={os.getpid()} gw_pid={gw_pid} name={name}')",
+    "",
+    "while owns_pidfile(pidfile) and pid_alive(gw_pid):",
+    "    time.sleep(POLL)",
+    "",
+    "if owns_pidfile(pidfile):",
+    "    log(f'gateway dead, deregistering name={name}')",
+    "    if dataset_name and cognee_session_id:",
+    "        bridge_session(base_url, dataset_name, cognee_session_id, api_key)",
+    "    deregister(base_url, name, api_key)",
+    "    try: os.unlink(pidfile)",
+    "    except Exception: pass",
+    "else:",
+    "    log(f'pidfile gone (clean exit) name={name}')",
+].join("\n");
+/** Returns the pidfile path for an exit-watcher tracking the given session name. */
+export function exitWatcherPidfilePath(agentSessionName) {
+    const safe = agentSessionName.replace(/[^a-zA-Z0-9_-]/g, "-").slice(0, 200);
+    return join(EXIT_WATCHERS_DIR, `${safe}.pid`);
+}
+/**
+ * Spawn a detached exit-watcher that fires when the gateway process
+ * (gatewayPid) exits for any reason. If datasetName + cogneeSessionId are
+ * given, it first bridges that session's cache into the graph via
+ * /api/v1/improve, then calls /api/v1/agents/unregister for agentSessionName.
+ * Returns immediately — the actual watcher runs as a separate OS process.
+ * Signal clean deregistration by deleting the pidfile (exitWatcherPidfilePath);
+ * the watcher detects the missing pidfile and self-exits without making an HTTP call.
+ */
+export async function spawnExitWatcher(params) {
+    try {
+        await mkdir(EXIT_WATCHERS_DIR, { recursive: true });
+        await writeFile(EXIT_WATCHER_SCRIPT_PATH, EXIT_WATCHER_CONTENT, "utf-8");
+        const args = JSON.stringify({
+            gateway_pid: params.gatewayPid,
+            agent_session_name: params.agentSessionName,
+            base_url: params.baseUrl,
+            api_key: params.apiKey ?? "",
+            pidfile: params.pidfilePath,
+            dataset_name: params.datasetName ?? "",
+            cognee_session_id: params.cogneeSessionId ?? "",
+        });
+        const python = findSystemPython();
+        const result = await runPluginCommandWithTimeout({
+            argv: [python, EXIT_WATCHER_SCRIPT_PATH, args],
+            timeoutMs: 5_000,
+        });
+        if (result.code !== 0) {
+            params.logger.warn?.(`cognee-openclaw: exit-watcher spawn failed (exit ${result.code}): ${result.stderr}`);
+        }
+    }
+    catch (e) {
+        params.logger.warn?.(`cognee-openclaw: exit-watcher spawn error: ${String(e)}`);
+    }
+}
+/**
+ * Poll the Cognee /health endpoint until it returns 200 or the timeout elapses.
+ * Returns a Promise so callers can chain deferred work without blocking.
+ * Rejects with an Error on timeout.
+ */
+export async function waitForServerHealth(baseUrl, timeoutMs = 600_000) {
+    const healthUrl = `${baseUrl.replace(/\/$/, "")}/health`;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, 2_000));
+        try {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), 2_000);
+            const resp = await fetch(healthUrl, { signal: ctrl.signal });
+            clearTimeout(t);
+            if (resp.ok)
+                return;
+        }
+        catch { /* not ready yet */ }
+    }
+    throw new Error(`Cognee server not healthy after ${Math.round(timeoutMs / 1000)}s`);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/sync.d.ts

@@ -3,13 +3,25 @@ import type { CogneePluginConfig, MemoryFile, MemoryScope, ScopedSyncIndexes, Sy
 export declare function syncFiles(client: CogneeHttpClient, changedFiles: MemoryFile[], fullFiles: MemoryFile[], syncIndex: SyncIndex, cfg: Required<CogneePluginConfig>, logger: {
     info?: (msg: string) => void;
     warn?: (msg: string) => void;
-}, overrideDatasetName?: string): Promise<SyncResult & {
+}, overrideDatasetName?: string, 
+/**
+ * Persist the mutated syncIndex to the legacy single-scope file. Callers that
+ * own their own persistence (scoped sync, per-agent sync) pass false so they
+ * don't clobber sync-index.json. Defaults to true for legacy single-scope use.
+ */
+persistIndex?: boolean): Promise<SyncResult & {
     datasetId?: string;
 }>;
 export declare function syncFilesScoped(client: CogneeHttpClient, changedFiles: MemoryFile[], fullFiles: MemoryFile[], scopedIndexes: ScopedSyncIndexes, cfg: Required<CogneePluginConfig>, logger: {
     info?: (msg: string) => void;
     warn?: (msg: string) => void;
-}, runtimeAgentId?: string): Promise<SyncResult & {
+}, runtimeAgentId?: string, 
+/**
+ * Restrict processing to these scopes. Used to sync only the shared scopes
+ * (`company`/`user`) from the default workspace when per-agent memory owns
+ * the `agent` scope. When omitted, all scopes are processed (legacy behavior).
+ */
+onlyScopes?: MemoryScope[]): Promise<SyncResult & {
     datasetIds: Record<MemoryScope, string | undefined>;
 }>;
 export declare let COGNIFY_POLL_INTERVAL_MS: number;

package/dist/src/sync.js

@@ -10,10 +10,37 @@ import { datasetNameForScope, routeFileToScope } from "./scope.js";
 // counterpart, and the existing 1.0.3 update endpoint already triggers a
 // follow-up cognify internally, so the fan-out is the same).
 // ---------------------------------------------------------------------------
-export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg, logger, overrideDatasetName) {
+export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg, logger, overrideDatasetName, 
+/**
+ * Persist the mutated syncIndex to the legacy single-scope file. Callers that
+ * own their own persistence (scoped sync, per-agent sync) pass false so they
+ * don't clobber sync-index.json. Defaults to true for legacy single-scope use.
+ */
+persistIndex = true) {
     const result = { added: 0, updated: 0, skipped: 0, errors: 0, deleted: 0 };
     const dsName = overrideDatasetName || cfg.datasetName;
     let datasetId = syncIndex.datasetId;
+    if (datasetId && syncIndex.datasetName && syncIndex.datasetName !== dsName) {
+        logger.info?.(`cognee-openclaw: cached datasetId belongs to "${syncIndex.datasetName}" but current dataset is "${dsName}" — ignoring stale datasetId`);
+        datasetId = undefined;
+        syncIndex.datasetId = undefined;
+    }
+    function isDatasetAccessError(message) {
+        const msg = message.toLowerCase();
+        return (msg.includes("(401)") ||
+            msg.includes("(403)") ||
+            msg.includes("(404)") ||
+            msg.includes("unauthorizeddataaccesserror") ||
+            msg.includes("not accessible") ||
+            msg.includes("permission denied"));
+    }
+    function isUpdateFallbackError(message) {
+        const msg = message.toLowerCase();
+        return (msg.includes("404") ||
+            msg.includes("409") ||
+            msg.includes("not found") ||
+            isDatasetAccessError(message));
+    }
     // Partition changed files into "needs add" vs "needs update".
     // We process updates per-file (PATCH /update) and batch all adds into a
     // single /remember call at the end of the loop.
@@ -47,7 +74,11 @@ export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg,
             }
             catch (updateError) {
                 const errorMsg = updateError instanceof Error ? updateError.message : String(updateError);
-                if (errorMsg.includes("404") || errorMsg.includes("409") || errorMsg.includes("not found")) {
+                if (isUpdateFallbackError(errorMsg)) {
+                    if (isDatasetAccessError(errorMsg)) {
+                        datasetId = undefined;
+                        syncIndex.datasetId = undefined;
+                    }
                     logger.info?.(`cognee-openclaw: update failed for ${file.path}, falling back to remember`);
                     // fall through to add path
                 }
@@ -61,11 +92,11 @@ export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg,
         toAdd.push(file);
     }
     if (toAdd.length > 0) {
-        try {
+        const rememberBatch = async (resolvedDatasetId) => {
             const rememberResponse = await client.remember({
                 files: toAdd.map((f) => ({ filePath: f.path, data: wrapWithMetadata(f) })),
                 datasetName: dsName,
-                datasetId,
+                datasetId: resolvedDatasetId,
             });
             if (rememberResponse.datasetId && rememberResponse.datasetId !== datasetId) {
                 datasetId = rememberResponse.datasetId;
@@ -85,13 +116,32 @@ export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg,
             }
             syncIndex.datasetId = datasetId;
             syncIndex.datasetName = dsName;
+        };
+        try {
+            await rememberBatch(datasetId);
         }
         catch (error) {
-            // One failed batch fails every queued file — surface them all so the
-            // caller's error count reflects the actual workload, not just one entry.
-            for (const file of toAdd) {
-                result.errors++;
-                logger.warn?.(`cognee-openclaw: failed to sync ${file.path}: ${error instanceof Error ? error.message : String(error)}`);
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            if (isDatasetAccessError(errorMsg)) {
+                datasetId = undefined;
+                syncIndex.datasetId = undefined;
+                try {
+                    await rememberBatch(undefined);
+                }
+                catch (retryError) {
+                    for (const file of toAdd) {
+                        result.errors++;
+                        logger.warn?.(`cognee-openclaw: failed to sync ${file.path}: ${retryError instanceof Error ? retryError.message : String(retryError)}`);
+                    }
+                }
+            }
+            else {
+                // One failed batch fails every queued file — surface them all so the
+                // caller's error count reflects the actual workload, not just one entry.
+                for (const file of toAdd) {
+                    result.errors++;
+                    logger.warn?.(`cognee-openclaw: failed to sync ${file.path}: ${error instanceof Error ? error.message : String(error)}`);
+                }
             }
         }
     }
@@ -124,13 +174,20 @@ export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg,
             }
         }
     }
-    await saveSyncIndex(syncIndex);
+    if (persistIndex)
+        await saveSyncIndex(syncIndex);
     return { ...result, datasetId };
 }
 // ---------------------------------------------------------------------------
 // Multi-scope sync
 // ---------------------------------------------------------------------------
-export async function syncFilesScoped(client, changedFiles, fullFiles, scopedIndexes, cfg, logger, runtimeAgentId) {
+export async function syncFilesScoped(client, changedFiles, fullFiles, scopedIndexes, cfg, logger, runtimeAgentId, 
+/**
+ * Restrict processing to these scopes. Used to sync only the shared scopes
+ * (`company`/`user`) from the default workspace when per-agent memory owns
+ * the `agent` scope. When omitted, all scopes are processed (legacy behavior).
+ */
+onlyScopes) {
     const totalResult = { added: 0, updated: 0, skipped: 0, errors: 0, deleted: 0 };
     const datasetIds = { company: undefined, user: undefined, agent: undefined };
     // Group changed files by scope
@@ -150,11 +207,14 @@ export async function syncFilesScoped(client, changedFiles, fullFiles, scopedInd
         fullByScope.set(scope, list);
     }
     // Determine which scopes need processing
+    const scopeFilter = onlyScopes ? new Set(onlyScopes) : null;
     const allScopes = new Set([
         ...changedByScope.keys(),
         ...Object.keys(scopedIndexes),
     ]);
     for (const scope of allScopes) {
+        if (scopeFilter && !scopeFilter.has(scope))
+            continue;
         const dsName = datasetNameForScope(scope, cfg, runtimeAgentId);
         const scopeChanged = changedByScope.get(scope) ?? [];
         const scopeFull = fullByScope.get(scope) ?? [];
@@ -167,7 +227,7 @@ export async function syncFilesScoped(client, changedFiles, fullFiles, scopedInd
         if (scopeChanged.length === 0 && !hasDeletedFiles)
             continue;
         logger.info?.(`cognee-openclaw: [${scope}] syncing ${scopeChanged.length} changed file(s) to dataset "${dsName}"${hasDeletedFiles ? " + deletions" : ""}`);
-        const result = await syncFiles(client, scopeChanged, scopeFull, scopeIndex, cfg, logger, dsName);
+        const result = await syncFiles(client, scopeChanged, scopeFull, scopeIndex, cfg, logger, dsName, false);
         totalResult.added += result.added;
         totalResult.updated += result.updated;
         totalResult.skipped += result.skipped;