@susu-eng/gralkor 26.0.19 → 27.0.1

package/dist/tools.js

@@ -11,7 +11,10 @@ export function formatFacts(facts) {
     if (facts.length === 0)
         return "No graph facts found.";
     const lines = facts.map(formatFact).join("\n");
-    return `Facts (knowledge graph):\n${lines}`;
+    return `Memories:\n${lines}`;
+}
+export function formatNode(n) {
+    return `- ${n.name}: ${n.summary ?? "(no summary)"}`;
 }
 export function createMemoryStoreTool(client, config, opts = {}) {
     const { getGroupId, serverReady } = opts;
@@ -53,6 +56,43 @@ export function createMemoryStoreTool(client, config, opts = {}) {
         },
     };
 }
+export function createMemorySearchTool(client, config, opts = {}) {
+    const { getGroupId, serverReady } = opts;
+    return {
+        name: "memory_search",
+        description: "Search memory for relevant context. Use specific, focused queries.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string" },
+                limit: { type: "number" },
+            },
+            required: ["query"],
+        },
+        async execute(_toolCallId, args) {
+            if (serverReady && !serverReady.isReady()) {
+                throw new Error("[gralkor] memory_search failed: server is not ready");
+            }
+            const groupId = getGroupId?.() ?? "default";
+            const limit = args.limit ?? 10;
+            const results = await client.search(args.query, [groupId], limit, "slow");
+            const factCount = results.facts.length;
+            const nodeCount = results.nodes.length;
+            console.log(`[gralkor] memory_search result — graph: ${factCount} facts ${nodeCount} nodes — groupId:${groupId}`);
+            if (factCount === 0 && nodeCount === 0)
+                return "No memories found.";
+            const nodeSection = nodeCount > 0
+                ? "\n\nEntities:\n" + results.nodes.map(formatNode).join("\n")
+                : "";
+            const output = formatFacts(results.facts) + nodeSection + "\n\n" + INTERPRETATION_INSTRUCTION;
+            if (config.test) {
+                console.log(`[gralkor] [test] memory_search query: ${args.query}`);
+                console.log(`[gralkor] [test] memory_search result:\n${output}`);
+            }
+            return output;
+        },
+    };
+}
 export function createBuildIndicesTool(client, opts = {}) {
     const { serverReady } = opts;
     return {

package/dist/tools.js.map

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

package/openclaw.plugin.json

@@ -98,7 +98,6 @@
   },
   "tools": [
     "memory_search",
-    "memory_get",
     "memory_add"
   ],
   "uiHints": {
@@ -139,5 +138,5 @@
       "label": "Groq API key"
     }
   },
-  "version": "26.0.19"
+  "version": "27.0.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@susu-eng/gralkor",
-  "version": "26.0.19",
+  "version": "27.0.1",
   "description": "OpenClaw memory plugin powered by Graphiti knowledge graphs and FalkorDB",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,10 +47,11 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "openclaw": ">= 2026.1.26"
+    "openclaw": ">= 2026.4.2"
   },
   "devDependencies": {
     "@types/node": "^25.0.0",
+    "memfs": "^4.57.1",
     "typescript": "^5.7.0",
     "vitest": "^4.1.2"
   },
@@ -61,6 +62,10 @@
     "test": "pnpm run typecheck && pnpm run test:plugin && pnpm run test:integration && pnpm run test:server",
     "test:plugin": "vitest run",
     "test:integration": "vitest run --config test/integration/vitest.config.ts",
+    "test:functional": "bash test/harness/functional-env.sh test",
+    "test:functional:up": "bash test/harness/functional-env.sh up",
+    "test:functional:run": "bash test/harness/functional-env.sh run",
+    "test:functional:down": "bash test/harness/functional-env.sh down",
     "test:server": "cd server && uv run pytest tests/",
     "test:server:changed": "cd server && files=$(git diff --name-only --diff-filter=d HEAD -- 'tests/*.py') && [ -n \"$files\" ] && uv run pytest $files || echo 'No changed server test files'",
     "test:mutate": "stryker run",
@@ -70,10 +75,6 @@
     "docker:up": "pnpm run docker:build && docker compose up -d",
     "docker:down": "docker compose down",
     "docker:logs": "docker compose logs graphiti",
-    "harness": "bash test/harness/build.sh",
-    "harness:npm": "bash test/harness/build.sh --npm",
-    "harness:run": "docker run --rm -it --platform linux/amd64 gralkor-harness:latest",
-    "harness:shell": "docker run --rm -it --platform linux/amd64 gralkor-harness:latest bash",
     "publish:npm": "bash scripts/publish.sh"
   }
 }

package/server/main.py

@@ -7,6 +7,7 @@ import logging
 import os
 import time
 from contextlib import asynccontextmanager
+from copy import deepcopy
 from dataclasses import dataclass, field
 from datetime import datetime, timezone
 from typing import Any, Literal
@@ -23,6 +24,7 @@ from graphiti_core.driver.falkordb_driver import FalkorDriver
 from graphiti_core.edges import EntityEdge
 from graphiti_core.nodes import EpisodicNode, EpisodeType
 from graphiti_core.llm_client import LLMConfig
+from graphiti_core.search.search_config_recipes import COMBINED_HYBRID_SEARCH_CROSS_ENCODER
 
 
 # ── Config ────────────────────────────────────────────────────
@@ -386,6 +388,7 @@ class SearchRequest(BaseModel):
     query: str
     group_ids: list[str]
     num_results: int = 10
+    mode: Literal["fast", "slow"] = "fast"
 
 
 class GroupIdRequest(BaseModel):
@@ -399,6 +402,15 @@ def _ts(dt: datetime | None) -> str | None:
     return dt.isoformat() if dt else None
 
 
+def _serialize_node(node) -> dict[str, Any]:
+    return {
+        "uuid": node.uuid,
+        "name": node.name,
+        "summary": node.summary,
+        "group_id": node.group_id,
+    }
+
+
 def _serialize_fact(edge: EntityEdge) -> dict[str, Any]:
     return {
         "uuid": edge.uuid,
@@ -698,8 +710,8 @@ def _prioritize_facts(
 
 @app.post("/search")
 async def search(req: SearchRequest):
-    logger.info("[gralkor] search — query:%d chars group_ids:%s num_results:%d",
-                len(req.query), req.group_ids, req.num_results)
+    logger.info("[gralkor] search — mode:%s query:%d chars group_ids:%s num_results:%d",
+                req.mode, len(req.query), req.group_ids, req.num_results)
     # graphiti.add_episode() clones the driver to target the correct FalkorDB
     # named graph (database=group_id), but graphiti.search() does not — it just
     # uses whatever graph the driver currently points at. Before the first
@@ -710,23 +722,40 @@ async def search(req: SearchRequest):
     # Over-fetch to compensate for expired facts that will be deprioritized.
     fetch_limit = req.num_results * 2
     try:
-        edges = await graphiti.search(
-            query=_sanitize_query(req.query),
-            group_ids=req.group_ids,
-            num_results=fetch_limit,
-        )
+        if req.mode == "slow":
+            # Cross-encoder + BFS: higher quality, also returns entity node summaries.
+            # deepcopy required — COMBINED_HYBRID_SEARCH_CROSS_ENCODER is a module-level
+            # constant; mutating .limit directly would corrupt it across requests.
+            config = deepcopy(COMBINED_HYBRID_SEARCH_CROSS_ENCODER)
+            config.limit = fetch_limit
+            search_result = await graphiti.search_(
+                query=_sanitize_query(req.query),
+                group_ids=req.group_ids,
+                config=config,
+            )
+            edges = search_result.edges
+            nodes = search_result.nodes
+        else:
+            edges = await graphiti.search(
+                query=_sanitize_query(req.query),
+                group_ids=req.group_ids,
+                num_results=fetch_limit,
+            )
+            nodes = []
     except Exception as e:
         duration_ms = (time.monotonic() - t0) * 1000
-        logger.error("[gralkor] search failed — %.0fms: %s", duration_ms, e)
+        logger.error("[gralkor] search failed — mode:%s %.0fms: %s", req.mode, duration_ms, e)
         raise
     duration_ms = (time.monotonic() - t0) * 1000
     prioritized = _prioritize_facts(edges, req.num_results)
     valid_count = sum(1 for e in prioritized if e.invalid_at is None)
     result = [_serialize_fact(e) for e in prioritized]
-    logger.info("[gralkor] search result — %d facts (%d valid, %d non-valid) from %d fetched %.0fms",
-                len(prioritized), valid_count, len(prioritized) - valid_count, len(edges), duration_ms)
+    serialized_nodes = [_serialize_node(n) for n in nodes]
+    logger.info("[gralkor] search result — mode:%s %d facts (%d valid, %d non-valid) %d nodes from %d fetched %.0fms",
+                req.mode, len(prioritized), valid_count, len(prioritized) - valid_count,
+                len(serialized_nodes), len(edges), duration_ms)
     logger.debug("[gralkor] search facts: %s", result)
-    return {"facts": result}
+    return {"facts": result, "nodes": serialized_nodes}