@unblocklabs/unblock-memory 0.3.1 → 0.3.3

package/README.md

@@ -127,7 +127,9 @@ The `skills` corpus shares the existing QMD store and warm embedding model but
 is private to Skill Whisperer: it is excluded from ordinary `memory_search`
 (including `corpora: ["all"]`), `memory_get`, clustering, and memory-maintenance
 tasks. Paths are explicit by design; the plugin does not reconstruct
-OpenClaw's effective skill inventory from `openclaw.json`.
+OpenClaw's effective skill inventory from `openclaw.json`. Configured skill
+globs follow symlinked directories, including OpenClaw's `plugin-skills`
+directory.
 
 Use `sessionFilter` to restrict session results by metadata while leaving file
 corpora searchable. Supported fields are `startedFrom` and `startedTo`

package/dist/src/contracts.d.ts

@@ -1,4 +1,5 @@
 import type { MemoryPluginCapability } from "openclaw/plugin-sdk/memory-host-core";
+import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/plugin-entry";
 import type { SessionMetadata } from "./session-projector.js";
 import type { ChatType } from "./config.js";
 export type MemoryPluginRuntimeContract = NonNullable<MemoryPluginCapability["runtime"]>;
@@ -18,9 +19,11 @@ export type SessionSearchFilter = {
     accountId?: string;
     conversationId?: string;
 };
+export type MemoryRequestContext = Pick<OpenClawPluginToolContext, "sessionKey" | "sessionId" | "messageChannel" | "agentAccountId" | "nativeChannelId" | "deliveryContext">;
 export type CorpusSearchOptions = NonNullable<Parameters<MemorySearchManagerContract["search"]>[1]> & {
     corpora?: readonly string[];
     sessionFilter?: SessionSearchFilter;
+    requestContext?: MemoryRequestContext;
 };
 export type MemoryEmbeddingProbeResult = Awaited<ReturnType<MemorySearchManagerContract["probeEmbeddingAvailability"]>>;
 export type MemorySyncParams = Parameters<NonNullable<MemorySearchManagerContract["sync"]>>[0];

package/dist/src/manager.d.ts

@@ -1,6 +1,6 @@
 import type { QMDStore } from "@unblocklabs/qmd";
 import { type AnalysisRunner, type MemoryAnalysisSummary, type MemoryClusterDetail, type MemoryClusterList, type MemoryClusterSort, type MemoryReclusterOptions } from "./analysis.js";
-import type { CorpusMemorySearchResult, CorpusSearchOptions, MemoryEmbeddingProbeResult, MemoryProviderStatus, MemoryReadResult, MemorySearchManagerContract, MemorySyncParams } from "./contracts.js";
+import type { CorpusMemorySearchResult, CorpusSearchOptions, MemoryEmbeddingProbeResult, MemoryProviderStatus, MemoryReadResult, MemoryRequestContext, MemorySearchManagerContract, MemorySyncParams } from "./contracts.js";
 import type { ChatType } from "./config.js";
 import { type MaintenanceStatus, type TemporalBasis } from "./curation.js";
 import { type SessionSyncResult } from "./session-sync.js";
@@ -75,6 +75,7 @@ export declare class QmdMemoryManager implements MemorySearchManagerContract {
         relPath: string;
         from?: number;
         lines?: number;
+        requestContext?: MemoryRequestContext;
     }): Promise<MemoryReadResult>;
     status(): MemoryProviderStatus;
     probeEmbeddingAvailability(): Promise<MemoryEmbeddingProbeResult>;

package/dist/src/manager.js

@@ -1,7 +1,8 @@
-import { realpathSync } from "node:fs";
+import { readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { mkdir, stat } from "node:fs/promises";
-import { basename, dirname, resolve } from "node:path";
+import { basename, dirname, relative, resolve, sep } from "node:path";
 import chokidar from "chokidar";
+import picomatch from "picomatch";
 import { ensureMemoryAnalysisSchema, latestAnalysisCollections, latestAnalysisRunId, markMemoryAnalysisStale, readAnalysisSummary, readCluster, readClusters, runAnalysisWorker, } from "./analysis.js";
 import { CurationStore, chunkFingerprint, } from "./curation.js";
 import { readSessionManifest, sessionMetadataByPath, syncSessionProjections, } from "./session-sync.js";
@@ -10,6 +11,50 @@ const DEFAULT_READ_LINES = 120;
 const MAX_READ_CHARS = 12_000;
 const WATCH_DEBOUNCE_MS = 250;
 const qmdModule = import("@unblocklabs/qmd");
+function readSkillDocuments(source) {
+    const documents = [];
+    const visitedDirectories = new Set();
+    const visit = (directory) => {
+        let canonicalDirectory;
+        try {
+            canonicalDirectory = realpathSync(directory);
+        }
+        catch {
+            return;
+        }
+        if (visitedDirectories.has(canonicalDirectory))
+            return;
+        visitedDirectories.add(canonicalDirectory);
+        for (const entry of readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) {
+            const path = resolve(directory, entry.name);
+            let kind = entry.isDirectory()
+                ? "directory"
+                : entry.isFile()
+                    ? "file"
+                    : undefined;
+            if (entry.isSymbolicLink()) {
+                try {
+                    const target = statSync(path);
+                    kind = target.isDirectory() ? "directory" : target.isFile() ? "file" : undefined;
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (kind === "directory") {
+                visit(path);
+                continue;
+            }
+            const relativePath = relative(source.root, path).split(sep).join("/");
+            if (kind !== "file" || basename(path).toLowerCase() !== "skill.md" ||
+                !picomatch.isMatch(relativePath, source.pattern, { dot: true }))
+                continue;
+            documents.push({ path, body: readFileSync(path, "utf8") });
+        }
+    };
+    visit(source.root);
+    return documents;
+}
 function frontmatterValue(body, key) {
     const frontmatter = /^---\s*\n([\s\S]*?)\n---(?:\n|$)/u.exec(body)?.[1];
     const raw = frontmatter?.split("\n")
@@ -264,9 +309,11 @@ export class QmdMemoryManager {
         this.#watcher.on("error", (error) => {
             this.#watchError = error instanceof Error ? error.message : String(error);
         });
-        this.#watcher.on("all", () => {
+        this.#watcher.on("all", (_event, path) => {
             if (this.#closed)
                 return;
+            if (basename(path).toLowerCase() === "skill.md")
+                this.#skillIndex = undefined;
             this.#dirty = true;
             if (this.#watchTimer)
                 clearTimeout(this.#watchTimer);
@@ -690,31 +737,24 @@ export class QmdMemoryManager {
             throw new Error("Skill Whisperer requires the QMD embedding model");
         const llm = store.internal.llm;
         this.#skillIndex ??= (async () => {
-            const placeholders = collections.map(() => "?").join(", ");
-            const rows = store.internal.db.prepare(`
-        SELECT document.collection, document.path, content.doc AS body
-        FROM documents document
-        JOIN content ON content.hash = document.hash
-        WHERE document.active = 1 AND document.collection IN (${placeholders})
-        ORDER BY document.collection, document.path
-      `).all(...collections);
             const sourceOrder = new Map([...this.#sources.keys()].map((collection, index) => [collection, index]));
             const metadata = new Map();
-            for (const row of rows) {
-                const file = `qmd://${row.collection}/${row.path}`;
-                const safe = parseSafeVirtualPath(file, this.#sources);
-                if (!safe || safe.source.kind !== "skills")
+            for (const source of this.#sources.values()) {
+                if (source.kind !== "skills")
                     continue;
-                const path = realpathSync(resolve(safe.source.root, safe.relativePath));
-                if (basename(path).toLowerCase() !== "skill.md")
-                    continue;
-                const name = frontmatterValue(row.body, "name") || basename(dirname(path));
-                const description = frontmatterValue(row.body, "description") ?? "";
-                const key = name.toLowerCase();
-                const order = sourceOrder.get(row.collection) ?? Number.MAX_SAFE_INTEGER;
-                const current = metadata.get(key);
-                if (!current || order < current.sourceOrder) {
-                    metadata.set(key, { candidate: { name, path }, description, sourceOrder: order });
+                for (const document of readSkillDocuments(source)) {
+                    const name = frontmatterValue(document.body, "name") || basename(dirname(document.path));
+                    const description = frontmatterValue(document.body, "description") ?? "";
+                    const key = name.toLowerCase();
+                    const order = sourceOrder.get(source.collection) ?? Number.MAX_SAFE_INTEGER;
+                    const current = metadata.get(key);
+                    if (!current || order < current.sourceOrder) {
+                        metadata.set(key, {
+                            candidate: { name, path: document.path },
+                            description,
+                            sourceOrder: order,
+                        });
+                    }
                 }
             }
             const skills = [...metadata.values()];

package/dist/src/plugin.js

@@ -8,7 +8,18 @@ function getContext(ctx) {
     const cfg = ctx.getRuntimeConfig?.() ?? ctx.runtimeConfig ?? ctx.config;
     if (!cfg || !ctx.agentId)
         return undefined;
-    return { cfg, agentId: ctx.agentId };
+    return {
+        cfg,
+        agentId: ctx.agentId,
+        requestContext: {
+            sessionKey: ctx.sessionKey,
+            sessionId: ctx.sessionId,
+            messageChannel: ctx.messageChannel,
+            agentAccountId: ctx.agentAccountId,
+            nativeChannelId: ctx.nativeChannelId,
+            deliveryContext: ctx.deliveryContext,
+        },
+    };
 }
 const searchParameters = Type.Object({
     query: Type.String({ pattern: "\\S" }),
@@ -58,6 +69,7 @@ function createSearchTool(runtime, ctx) {
                 maxResults,
                 minScore,
                 signal,
+                requestContext: active.requestContext,
             });
             return jsonResult({
                 results: results.map((result) => result.session
@@ -93,6 +105,7 @@ function createGetTool(runtime, ctx) {
                 relPath: path,
                 from,
                 lines,
+                requestContext: active.requestContext,
             }));
         },
     };

package/dist/src/sources.js

@@ -113,16 +113,10 @@ export function resolveConfiguredSkillPath(workspaceDir, inputPath, sources) {
     for (const source of sources) {
         if (source.kind !== "skills")
             continue;
-        let canonicalRoot;
-        try {
-            canonicalRoot = realpathSync(source.root);
-        }
-        catch {
+        const relativePath = relative(source.root, target);
+        if (relativePath === ".." || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath))
             continue;
-        }
-        const relativePath = relative(canonicalRoot, canonicalTarget);
-        const safe = parseSafeVirtualPath(`qmd://${source.collection}/${relativePath.split(sep).join("/")}`, new Map([[source.collection, source]]));
-        if (safe)
+        if (picomatch.isMatch(relativePath.split(sep).join("/"), source.pattern, { dot: true }))
             return canonicalTarget;
     }
     return undefined;

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "unblock-memory",
   "name": "Unblock Memory",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Indexes, retrieves, and analyzes configured workspace memory with existing QMD vectors.",
   "kind": "memory",
   "activation": { "onStartup": false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unblocklabs/unblock-memory",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Workspace-native memory for OpenClaw, powered by QMD",
   "type": "module",
   "license": "MIT",