@cognee/cognee-openclaw 2026.3.0 → 2026.3.1

package/dist/src/scope.js

@@ -0,0 +1,122 @@
+// ---------------------------------------------------------------------------
+// Glob matching — uses picomatch-style algorithm (*, **, ?)
+//
+// Fix #3: Proper glob support instead of naive regex. Handles:
+//   *  — any non-separator chars in one segment
+//   ** — any depth of segments
+//   ?  — single non-separator char
+//   [abc] — character class
+// ---------------------------------------------------------------------------
+/**
+ * Convert a glob pattern to a RegExp. Supports *, **, ?, and [charclass].
+ */
+function globToRegex(pattern) {
+    let i = 0;
+    let regex = "^";
+    while (i < pattern.length) {
+        const c = pattern[i];
+        if (c === "*") {
+            if (pattern[i + 1] === "*") {
+                // ** — match any depth
+                // Consume optional trailing slash
+                if (pattern[i + 2] === "/") {
+                    regex += "(?:.+/)?";
+                    i += 3;
+                }
+                else {
+                    regex += ".*";
+                    i += 2;
+                }
+            }
+            else {
+                // * — match within one segment
+                regex += "[^/]*";
+                i++;
+            }
+        }
+        else if (c === "?") {
+            regex += "[^/]";
+            i++;
+        }
+        else if (c === "[") {
+            // Character class — pass through until ]
+            const start = i;
+            i++; // skip [
+            if (i < pattern.length && pattern[i] === "!") {
+                regex += "[^";
+                i++;
+            }
+            else {
+                regex += "[";
+            }
+            while (i < pattern.length && pattern[i] !== "]") {
+                regex += escapeRegexChar(pattern[i]);
+                i++;
+            }
+            regex += "]";
+            i++; // skip ]
+        }
+        else if (".+^${}()|\\".includes(c)) {
+            regex += "\\" + c;
+            i++;
+        }
+        else {
+            regex += c;
+            i++;
+        }
+    }
+    regex += "$";
+    return new RegExp(regex);
+}
+function escapeRegexChar(c) {
+    if ("-]\\^".includes(c))
+        return "\\" + c;
+    return c;
+}
+/**
+ * Match a file path against a glob pattern.
+ * Paths are normalized to forward slashes.
+ */
+export function matchGlob(pattern, filePath) {
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    const normalizedPattern = pattern.replace(/\\/g, "/");
+    return globToRegex(normalizedPattern).test(normalizedPath);
+}
+/**
+ * Route a file to its memory scope based on scopeRouting rules.
+ * First matching rule wins; falls back to defaultScope.
+ */
+export function routeFileToScope(filePath, routes, defaultScope) {
+    const normalized = filePath.replace(/\\/g, "/");
+    for (const route of routes) {
+        if (matchGlob(route.pattern, normalized)) {
+            return route.scope;
+        }
+    }
+    return defaultScope;
+}
+/**
+ * Determine whether multi-scope mode is active.
+ * Active when at least one scope-specific dataset prefix/name is configured.
+ */
+export function isMultiScopeEnabled(cfg) {
+    return !!(cfg.companyDataset || cfg.userDatasetPrefix || cfg.agentDatasetPrefix);
+}
+/**
+ * Resolve the Cognee dataset name for a given memory scope.
+ */
+export function datasetNameForScope(scope, cfg) {
+    switch (scope) {
+        case "company":
+            return cfg.companyDataset || `${cfg.datasetName}-company`;
+        case "user":
+            return cfg.userDatasetPrefix
+                ? `${cfg.userDatasetPrefix}-${cfg.userId || "default"}`
+                : `${cfg.datasetName}-user-${cfg.userId || "default"}`;
+        case "agent":
+            return cfg.agentDatasetPrefix
+                ? `${cfg.agentDatasetPrefix}-${cfg.agentId || "default"}`
+                : `${cfg.datasetName}-agent-${cfg.agentId || "default"}`;
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/src/scope.js.map

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

package/dist/src/sync.d.ts

@@ -0,0 +1,18 @@
+import type { CogneeHttpClient } from "./client.js";
+import type { CogneePluginConfig, MemoryFile, MemoryScope, ScopedSyncIndexes, SyncIndex, SyncResult } from "./types.js";
+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 & {
+    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;
+}): Promise<SyncResult & {
+    datasetIds: Record<MemoryScope, string | undefined>;
+}>;
+/** Exported so tests can override */
+export declare let COGNIFY_POLL_INTERVAL_MS: number;
+/** Allow tests to adjust the poll interval */
+export declare function _setPollInterval(ms: number): void;

package/dist/src/sync.js

@@ -0,0 +1,219 @@
+import { loadDatasetState, saveDatasetState, saveScopedSyncIndexes, saveSyncIndex } from "./persistence.js";
+import { datasetNameForScope, routeFileToScope } from "./scope.js";
+// ---------------------------------------------------------------------------
+// Single-scope sync
+// ---------------------------------------------------------------------------
+export async function syncFiles(client, changedFiles, fullFiles, syncIndex, cfg, logger, overrideDatasetName) {
+    const result = { added: 0, updated: 0, skipped: 0, errors: 0, deleted: 0 };
+    const dsName = overrideDatasetName || cfg.datasetName;
+    let datasetId = syncIndex.datasetId;
+    let needsCognify = false;
+    for (const file of changedFiles) {
+        const existing = syncIndex.entries[file.path];
+        if (existing && existing.hash === file.hash) {
+            result.skipped++;
+            continue;
+        }
+        const dataWithMetadata = `# ${file.path}\n\n${file.content}\n\n---\nMetadata: ${JSON.stringify({ path: file.path, source: "memory" })}`;
+        try {
+            if (existing?.dataId && datasetId) {
+                try {
+                    const updateResponse = await client.update({
+                        dataId: existing.dataId,
+                        datasetId,
+                        data: dataWithMetadata,
+                    });
+                    const newDataId = updateResponse.dataId;
+                    if (!newDataId) {
+                        logger.warn?.(`cognee-openclaw: update for ${file.path} succeeded but could not resolve new data_id`);
+                    }
+                    syncIndex.entries[file.path] = { hash: file.hash, dataId: newDataId };
+                    syncIndex.datasetId = datasetId;
+                    syncIndex.datasetName = dsName;
+                    result.updated++;
+                    logger.info?.(`cognee-openclaw: updated ${file.path}`);
+                    continue;
+                }
+                catch (updateError) {
+                    const errorMsg = updateError instanceof Error ? updateError.message : String(updateError);
+                    if (errorMsg.includes("404") || errorMsg.includes("409") || errorMsg.includes("not found")) {
+                        logger.info?.(`cognee-openclaw: update failed for ${file.path}, falling back to add`);
+                        delete existing.dataId;
+                    }
+                    else {
+                        throw updateError;
+                    }
+                }
+            }
+            const response = await client.add({ data: dataWithMetadata, datasetName: dsName, datasetId });
+            if (response.datasetId && response.datasetId !== datasetId) {
+                datasetId = response.datasetId;
+                const state = await loadDatasetState();
+                state[dsName] = response.datasetId;
+                await saveDatasetState(state);
+            }
+            syncIndex.entries[file.path] = { hash: file.hash, dataId: response.dataId };
+            syncIndex.datasetId = datasetId;
+            syncIndex.datasetName = dsName;
+            needsCognify = true;
+            result.added++;
+            logger.info?.(`cognee-openclaw: added ${file.path}`);
+        }
+        catch (error) {
+            result.errors++;
+            logger.warn?.(`cognee-openclaw: failed to sync ${file.path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Handle deletions
+    const currentPaths = new Set(fullFiles.map(f => f.path));
+    for (const [path, entry] of Object.entries(syncIndex.entries)) {
+        if (!currentPaths.has(path) && entry.dataId && datasetId) {
+            const deleteResult = await client.delete({ dataId: entry.dataId, datasetId, mode: cfg.deleteMode });
+            if (deleteResult.deleted) {
+                result.deleted++;
+                delete syncIndex.entries[path];
+                logger.info?.(`cognee-openclaw: deleted ${path}`);
+            }
+            else {
+                const isNotFound = deleteResult.error && (deleteResult.error.includes("404") || deleteResult.error.includes("409") || deleteResult.error.includes("not found"));
+                if (isNotFound) {
+                    result.deleted++;
+                    delete syncIndex.entries[path];
+                    logger.info?.(`cognee-openclaw: deleted ${path} (already removed from Cognee)`);
+                }
+                else {
+                    result.errors++;
+                    logger.warn?.(`cognee-openclaw: failed to delete ${path}${deleteResult.error ? `: ${deleteResult.error}` : ""}`);
+                }
+            }
+        }
+    }
+    // Fix #9: Only trigger memify AFTER polling cognify to completion
+    if (needsCognify && cfg.autoCognify && datasetId) {
+        try {
+            await client.cognify({ datasetIds: [datasetId] });
+            logger.info?.("cognee-openclaw: cognify dispatched");
+            if (cfg.autoMemify) {
+                // Poll for cognify completion before triggering memify
+                const memifyDatasetId = datasetId;
+                await waitForCognifyThenMemify(client, memifyDatasetId, logger);
+            }
+        }
+        catch (error) {
+            logger.warn?.(`cognee-openclaw: cognify failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    await saveSyncIndex(syncIndex);
+    return { ...result, datasetId };
+}
+// ---------------------------------------------------------------------------
+// Multi-scope sync
+// ---------------------------------------------------------------------------
+export async function syncFilesScoped(client, changedFiles, fullFiles, scopedIndexes, cfg, logger) {
+    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
+    const changedByScope = new Map();
+    for (const file of changedFiles) {
+        const scope = routeFileToScope(file.path, cfg.scopeRouting, cfg.defaultWriteScope);
+        const list = changedByScope.get(scope) ?? [];
+        list.push(file);
+        changedByScope.set(scope, list);
+    }
+    // Group all files by scope
+    const fullByScope = new Map();
+    for (const file of fullFiles) {
+        const scope = routeFileToScope(file.path, cfg.scopeRouting, cfg.defaultWriteScope);
+        const list = fullByScope.get(scope) ?? [];
+        list.push(file);
+        fullByScope.set(scope, list);
+    }
+    // Determine which scopes need processing
+    const allScopes = new Set([
+        ...changedByScope.keys(),
+        ...Object.keys(scopedIndexes),
+    ]);
+    for (const scope of allScopes) {
+        const dsName = datasetNameForScope(scope, cfg);
+        const scopeChanged = changedByScope.get(scope) ?? [];
+        const scopeFull = fullByScope.get(scope) ?? [];
+        if (!scopedIndexes[scope]) {
+            scopedIndexes[scope] = { entries: {} };
+        }
+        const scopeIndex = scopedIndexes[scope];
+        const currentPaths = new Set(scopeFull.map(f => f.path));
+        const hasDeletedFiles = Object.keys(scopeIndex.entries).some(p => !currentPaths.has(p));
+        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);
+        totalResult.added += result.added;
+        totalResult.updated += result.updated;
+        totalResult.skipped += result.skipped;
+        totalResult.errors += result.errors;
+        totalResult.deleted += result.deleted;
+        datasetIds[scope] = result.datasetId;
+    }
+    await saveScopedSyncIndexes(scopedIndexes);
+    return { ...totalResult, datasetIds };
+}
+// ---------------------------------------------------------------------------
+// Fix #9: Poll cognify status before triggering memify
+// ---------------------------------------------------------------------------
+/** Exported so tests can override */
+export let COGNIFY_POLL_INTERVAL_MS = 5_000;
+const COGNIFY_POLL_MAX_ATTEMPTS = 60; // 5 min max
+/** Allow tests to adjust the poll interval */
+export function _setPollInterval(ms) { COGNIFY_POLL_INTERVAL_MS = ms; }
+async function waitForCognifyThenMemify(client, datasetId, logger) {
+    for (let attempt = 0; attempt < COGNIFY_POLL_MAX_ATTEMPTS; attempt++) {
+        // Wait before polling (skip on first attempt to check immediately)
+        if (attempt > 0) {
+            await new Promise(r => setTimeout(r, COGNIFY_POLL_INTERVAL_MS));
+        }
+        try {
+            const status = await client.datasetStatus(datasetId);
+            if (status === "completed" || status === "COMPLETED") {
+                try {
+                    await client.memify({ datasetIds: [datasetId] });
+                    logger.info?.("cognee-openclaw: memify dispatched after cognify completed");
+                }
+                catch (error) {
+                    logger.warn?.(`cognee-openclaw: memify failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                return;
+            }
+            if (status === "failed" || status === "FAILED" || status === "error") {
+                logger.warn?.(`cognee-openclaw: cognify failed (status: ${status}), skipping memify`);
+                return;
+            }
+            if (status === "unknown") {
+                // Endpoint exists but doesn't track this operation — fall back to optimistic memify
+                logger.warn?.("cognee-openclaw: could not poll cognify status, running memify optimistically");
+                try {
+                    await client.memify({ datasetIds: [datasetId] });
+                    logger.info?.("cognee-openclaw: memify dispatched (optimistic)");
+                }
+                catch (error) {
+                    logger.warn?.(`cognee-openclaw: memify failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                return;
+            }
+            // Still running, continue polling
+        }
+        catch {
+            // Status endpoint may not exist or may fail — fall back to fire-and-forget
+            logger.warn?.("cognee-openclaw: could not poll cognify status, running memify optimistically");
+            try {
+                await client.memify({ datasetIds: [datasetId] });
+                logger.info?.("cognee-openclaw: memify dispatched (optimistic)");
+            }
+            catch (error) {
+                logger.warn?.(`cognee-openclaw: memify failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return;
+        }
+    }
+    logger.warn?.("cognee-openclaw: cognify polling timed out, skipping memify");
+}
+//# sourceMappingURL=sync.js.map

package/dist/src/sync.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,80 @@
+export type CogneeSearchType = "GRAPH_COMPLETION" | "GRAPH_COMPLETION_COT" | "GRAPH_COMPLETION_CONTEXT_EXTENSION" | "GRAPH_SUMMARY_COMPLETION" | "RAG_COMPLETION" | "TRIPLET_COMPLETION" | "CHUNKS" | "CHUNKS_LEXICAL" | "SUMMARIES" | "CYPHER" | "NATURAL_LANGUAGE" | "TEMPORAL" | "CODING_RULES" | "FEELING_LUCKY";
+export type CogneeDeleteMode = "soft" | "hard";
+export type MemoryScope = "company" | "user" | "agent";
+export declare const MEMORY_SCOPES: readonly MemoryScope[];
+export type ScopeRoute = {
+    /** Glob-style pattern matched against the file's relative path */
+    pattern: string;
+    /** Target memory scope */
+    scope: MemoryScope;
+};
+export type CogneePluginConfig = {
+    baseUrl?: string;
+    apiKey?: string;
+    username?: string;
+    password?: string;
+    datasetName?: string;
+    companyDataset?: string;
+    userDatasetPrefix?: string;
+    agentDatasetPrefix?: string;
+    userId?: string;
+    agentId?: string;
+    recallScopes?: MemoryScope[];
+    defaultWriteScope?: MemoryScope;
+    scopeRouting?: ScopeRoute[];
+    enableSessions?: boolean;
+    persistSessionsAfterEnd?: boolean;
+    searchType?: CogneeSearchType;
+    searchPrompt?: string;
+    deleteMode?: CogneeDeleteMode;
+    maxResults?: number;
+    minScore?: number;
+    maxTokens?: number;
+    autoRecall?: boolean;
+    autoIndex?: boolean;
+    autoCognify?: boolean;
+    autoMemify?: boolean;
+    requestTimeoutMs?: number;
+    ingestionTimeoutMs?: number;
+};
+export type CogneeAddResponse = {
+    dataset_id: string;
+    dataset_name: string;
+    message: string;
+    data_id?: unknown;
+    data_ingestion_info?: unknown;
+};
+export type CogneeSearchResult = {
+    id: string;
+    text: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+};
+export type DatasetState = Record<string, string>;
+export type SyncIndex = {
+    datasetId?: string;
+    datasetName?: string;
+    entries: Record<string, {
+        hash: string;
+        dataId?: string;
+    }>;
+};
+/** Per-scope sync indexes, keyed by MemoryScope */
+export type ScopedSyncIndexes = Partial<Record<MemoryScope, SyncIndex>>;
+export type MemoryFile = {
+    /** Relative path from workspace root (e.g. "MEMORY.md", "memory/tools.md") */
+    path: string;
+    /** Absolute path on disk */
+    absPath: string;
+    /** File content */
+    content: string;
+    /** SHA-256 hex hash of content */
+    hash: string;
+};
+export type SyncResult = {
+    added: number;
+    updated: number;
+    skipped: number;
+    errors: number;
+    deleted: number;
+};

package/dist/src/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Shared types for the Cognee OpenClaw memory plugin
+// ---------------------------------------------------------------------------
+export const MEMORY_SCOPES = ["company", "user", "agent"];
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAsB9E,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}

package/openclaw.plugin.json

@@ -24,28 +24,89 @@
       },
       "datasetName": {
         "type": "string",
-        "description": "Cognee dataset name to store memories in"
+        "description": "Cognee dataset name for single-scope mode (default: openclaw). Ignored when multi-scope is enabled."
+      },
+      "companyDataset": {
+        "type": "string",
+        "description": "Dataset name for company-wide shared memory. Setting this enables multi-scope mode."
+      },
+      "userDatasetPrefix": {
+        "type": "string",
+        "description": "Prefix for user-scoped datasets (becomes '{prefix}-{userId}'). Setting this enables multi-scope mode."
+      },
+      "agentDatasetPrefix": {
+        "type": "string",
+        "description": "Prefix for agent-scoped datasets (becomes '{prefix}-{agentId}'). Setting this enables multi-scope mode."
+      },
+      "userId": {
+        "type": "string",
+        "description": "User identifier for user-scoped memory (or set OPENCLAW_USER_ID env var)"
+      },
+      "agentId": {
+        "type": "string",
+        "description": "Agent identifier for agent-scoped memory (or set OPENCLAW_AGENT_ID env var, default: 'default')"
+      },
+      "recallScopes": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": ["company", "user", "agent"]
+        },
+        "description": "Memory scopes to search during recall, in priority order (default: ['agent', 'user', 'company'])"
+      },
+      "defaultWriteScope": {
+        "type": "string",
+        "enum": ["company", "user", "agent"],
+        "description": "Default scope for files that don't match any scopeRouting pattern (default: 'agent')"
+      },
+      "scopeRouting": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "pattern": { "type": "string", "description": "Glob pattern to match file paths (e.g. 'memory/company/**')" },
+            "scope": { "type": "string", "enum": ["company", "user", "agent"] }
+          },
+          "required": ["pattern", "scope"]
+        },
+        "description": "Rules to route memory files to scopes based on path patterns. First match wins."
+      },
+      "enableSessions": {
+        "type": "boolean",
+        "description": "Enable session-based conversation tracking for multi-turn recall (default: true)"
+      },
+      "persistSessionsAfterEnd": {
+        "type": "boolean",
+        "description": "Persist session Q&A pairs into the knowledge graph after agent ends (default: true)"
       },
       "searchType": {
         "type": "string",
         "enum": [
           "GRAPH_COMPLETION",
+          "GRAPH_COMPLETION_COT",
+          "GRAPH_COMPLETION_CONTEXT_EXTENSION",
+          "GRAPH_SUMMARY_COMPLETION",
+          "RAG_COMPLETION",
+          "TRIPLET_COMPLETION",
           "CHUNKS",
-          "SUMMARIES"
+          "CHUNKS_LEXICAL",
+          "SUMMARIES",
+          "CYPHER",
+          "NATURAL_LANGUAGE",
+          "TEMPORAL",
+          "CODING_RULES",
+          "FEELING_LUCKY"
         ],
-        "description": "Cognee search mode"
+        "description": "Cognee search mode (default: FEELING_LUCKY — auto-selects best strategy per query)"
       },
       "deleteMode": {
         "type": "string",
-        "enum": [
-          "soft",
-          "hard"
-        ],
+        "enum": ["soft", "hard"],
         "description": "Cognee delete mode: 'soft' removes raw data only, 'hard' also removes degree-one graph nodes (default: soft)"
       },
       "maxResults": {
         "type": "number",
-        "description": "Max recall results to inject (default: 6)"
+        "description": "Max recall results to inject per scope (default: 6)"
       },
       "minScore": {
         "type": "number",
@@ -53,7 +114,7 @@
       },
       "maxTokens": {
         "type": "number",
-        "description": "Token cap for recall (default: 512)"
+        "description": "Token cap for recall per scope (default: 512)"
       },
       "autoRecall": {
         "type": "boolean",
@@ -67,13 +128,17 @@
         "type": "boolean",
         "description": "Run cognify after new memories are added (default: true)"
       },
+      "autoMemify": {
+        "type": "boolean",
+        "description": "Run memify (graph enrichment) after cognify completes (default: false)"
+      },
       "requestTimeoutMs": {
         "type": "number",
         "description": "HTTP timeout in milliseconds for Cognee requests (default: 60000)"
       },
       "ingestionTimeoutMs": {
         "type": "number",
-        "description": "HTTP timeout in milliseconds for add/update (ingestion) requests, which are typically slower (default: 300000 = 5 min)"
+        "description": "HTTP timeout in milliseconds for add/update (ingestion) requests (default: 300000 = 5 min)"
       },
       "searchPrompt": {
         "type": "string",
@@ -101,12 +166,45 @@
       "placeholder": "default_password"
     },
     "datasetName": {
-      "label": "Dataset Name",
+      "label": "Dataset Name (single-scope)",
       "placeholder": "openclaw"
     },
+    "companyDataset": {
+      "label": "Company Dataset",
+      "placeholder": "my-company"
+    },
+    "userDatasetPrefix": {
+      "label": "User Dataset Prefix",
+      "placeholder": "my-project-user"
+    },
+    "agentDatasetPrefix": {
+      "label": "Agent Dataset Prefix",
+      "placeholder": "my-project-agent"
+    },
+    "userId": {
+      "label": "User ID",
+      "placeholder": "${OPENCLAW_USER_ID}"
+    },
+    "agentId": {
+      "label": "Agent ID",
+      "placeholder": "default"
+    },
+    "recallScopes": {
+      "label": "Recall Scopes"
+    },
+    "defaultWriteScope": {
+      "label": "Default Write Scope",
+      "placeholder": "agent"
+    },
+    "enableSessions": {
+      "label": "Enable Sessions"
+    },
+    "persistSessionsAfterEnd": {
+      "label": "Persist Sessions"
+    },
     "searchType": {
       "label": "Search Type",
-      "placeholder": "GRAPH_COMPLETION"
+      "placeholder": "FEELING_LUCKY"
     },
     "deleteMode": {
       "label": "Delete Mode",
@@ -133,6 +231,9 @@
     "autoCognify": {
       "label": "Auto-Cognify"
     },
+    "autoMemify": {
+      "label": "Auto-Memify"
+    },
     "requestTimeoutMs": {
       "label": "Request Timeout (ms)",
       "placeholder": "60000"
@@ -142,4 +243,4 @@
       "placeholder": "300000"
     }
   }
-}
+}