@unblocklabs/unblock-memory 0.3.12 → 0.3.14

package/dist/src/whisperer-context.js

@@ -0,0 +1,35 @@
+/** Only visible user/assistant text; never system, tool, image, or thinking blocks. */
+export function messageText(message) {
+    if (!message || typeof message !== "object" || !("role" in message) || !("content" in message) ||
+        (message.role !== "user" && message.role !== "assistant"))
+        return undefined;
+    const text = typeof message.content === "string" ? message.content.trim() :
+        Array.isArray(message.content) ? message.content.flatMap((part) => {
+            return part && typeof part === "object" && "type" in part && part.type === "text" &&
+                "text" in part && typeof part.text === "string" ? [part.text] : [];
+        }).join("\n").trim() : "";
+    return text ? { role: message.role, text } : undefined;
+}
+export function memoryConversation(prompt, messages) {
+    const currentRequest = prompt.trim().slice(-16_000);
+    let remaining = 16_000 - currentRequest.length;
+    let truncated = currentRequest.length < prompt.trim().length;
+    const history = [];
+    const available = messages.flatMap(message => {
+        const parsed = messageText(message);
+        return parsed ? [parsed] : [];
+    });
+    // Hosts may include the current user message in messages as well as prompt.
+    if (available.at(-1)?.role === "user" && available.at(-1)?.text === prompt.trim())
+        available.pop();
+    for (const message of available.reverse()) {
+        if (message.text.length > remaining)
+            truncated = true;
+        if (remaining <= 0)
+            continue;
+        const content = message.text.slice(-remaining);
+        history.unshift({ role: message.role, content });
+        remaining -= content.length;
+    }
+    return { currentRequest, history, truncated };
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "unblock-memory",
   "name": "Unblock Memory",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Indexes, retrieves, and analyzes configured workspace memory with existing QMD vectors.",
   "kind": "memory",
   "activation": { "onStartup": true },
@@ -15,6 +15,7 @@
       "memory_recluster",
       "memory_list_clusters",
       "memory_fetch_cluster",
+      "memory_audit_quality",
       "memory_list_maintenance_tasks",
       "memory_update_maintenance_task",
       "memory_people_inspect",
@@ -28,6 +29,7 @@
     "memory_recluster": { "sideEffecting": true },
     "memory_list_clusters": { "replaySafe": true },
     "memory_fetch_cluster": { "replaySafe": true },
+    "memory_audit_quality": { "sideEffecting": true },
     "memory_list_maintenance_tasks": { "replaySafe": true },
     "memory_update_maintenance_task": { "sideEffecting": true },
     "memory_people_inspect": { "replaySafe": true },
@@ -35,6 +37,23 @@
     "memory_people_sync": { "sideEffecting": true, "optional": true }
   },
   "uiHints": {
+    "qualityAudit.enabled": {
+      "label": "Memory Quality Audit",
+      "help": "Enable an on-demand TypeSafe audit. Records review indicators only; never edits or suppresses data."
+    },
+    "qualityAudit.corpora": {
+      "label": "Approved Audit Corpora",
+      "help": "Explicit non-skill corpora approved for external TypeSafe processing and maintenance results visible to every audience using this agent. Sessions means ALL indexed sessions, not only the current conversation."
+    },
+    "typesafe.enabled": {
+      "label": "TypeSafe Ranking",
+      "help": "Enabled by default when credentials exist. Sends bounded conversation context and skill descriptions or approved memory excerpts to TypeSafe for enabled whisperers."
+    },
+    "typesafe.apiKey": { "label": "TypeSafe API Key", "sensitive": true },
+    "typesafe.apiKeyFile": {
+      "label": "TypeSafe Key File",
+      "help": "Absolute path to a plaintext API key or a dotenv file containing TYPESAFE_API_KEY. Prefer this over storing a key in config."
+    },
     "keepEmbeddingModelWarm": {
       "label": "Keep Embedding Model Warm",
       "help": "Keep the QMD embedding model resident after first use. Disable to unload it after five minutes without model activity."
@@ -47,6 +66,14 @@
       "label": "Skill Whisperer",
       "help": "Suggest at most one semantically relevant configured skill before a user turn. Requires hook conversation access."
     },
+    "memoryWhisperer.enabled": {
+      "label": "Memory Whisperer",
+      "help": "Inject up to two TypeSafe-approved historical excerpts before user turns. Requires explicit corpora, a TypeSafe key, and hook conversation access. Disabled by default."
+    },
+    "memoryWhisperer.corpora": {
+      "label": "Approved Hint Corpora",
+      "help": "Explicit non-skill corpus allowlist. Approve file corpora for all audiences using this agent and for transmission to TypeSafe. Session hits are restricted to the exact current session."
+    },
     "people.enabled": {
       "label": "PeopleSQL",
       "help": "Maintain an agent-local people store. Disabled by default."
@@ -64,6 +91,16 @@
     "type": "object",
     "additionalProperties": false,
     "properties": {
+      "qualityAudit": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean", "default": false },
+          "corpora": { "type": "array", "items": { "type": "string", "pattern": "\\S" }, "default": [] },
+          "minNoise": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.8 }
+        },
+        "default": { "enabled": false, "corpora": [], "minNoise": 0.8 }
+      },
       "keepEmbeddingModelWarm": {
         "type": "boolean",
         "default": true
@@ -175,6 +212,35 @@
           "todos": { "maxOpen": 1000 }
         }
       },
+      "typesafe": {
+        "type": "object",
+        "additionalProperties": false,
+        "not": { "required": ["apiKey", "apiKeyFile"] },
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "apiKey": { "type": "string", "pattern": "\\S" },
+          "apiKeyFile": { "type": "string", "pattern": "\\S" },
+          "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1500 }
+        },
+        "default": { "enabled": true, "timeoutMs": 1500 }
+      },
+      "memoryWhisperer": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean", "default": false },
+          "corpora": { "type": "array", "items": { "type": "string", "pattern": "\\S" }, "default": [] },
+          "historyMessages": { "type": "integer", "minimum": 0, "maximum": 50, "default": 5 },
+          "minUsefulness": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.9 },
+          "maxHints": { "type": "integer", "minimum": 1, "maximum": 2, "default": 2 },
+          "cooldownTurns": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 10 },
+          "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 3000 }
+        },
+        "default": {
+          "enabled": false, "corpora": [], "historyMessages": 5, "minUsefulness": 0.9,
+          "maxHints": 2, "cooldownTurns": 10, "timeoutMs": 3000
+        }
+      },
       "skillWhisperer": {
         "type": "object",
         "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unblocklabs/unblock-memory",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Workspace-native memory for OpenClaw, powered by QMD",
   "type": "module",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "preflight": "npm run knip && npm run build && npm run typecheck && npm test && npm run plugin:inspect && npm run plugin:inspect:runtime && npm pack --dry-run"
   },
   "dependencies": {
-    "@unblocklabs/qmd": "https://github.com/unblocklabs-ai/qmd/releases/download/v2.9.4/unblocklabs-qmd-2.9.4.tgz",
+    "@unblocklabs/qmd": "https://github.com/unblocklabs-ai/qmd/releases/download/v2.9.5/unblocklabs-qmd-2.9.5.tgz",
     "chokidar": "5.0.0",
     "picomatch": "^4.0.5",
     "typebox": "1.3.6"

package/skills/memory-curator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: memory-curator
-description: Investigate Unblock Memory clusters and maintain supported, agent-specific knowledge that would otherwise be difficult to reconstruct.
+description: Investigate Unblock Memory clusters, audit ingestion quality, and maintain supported, agent-specific knowledge that would otherwise be difficult to reconstruct.
 ---
 
 # Memory Curator
@@ -82,6 +82,31 @@ rigid document template.
 
 ## Finish the cycle
 
+### When auditing ingestion quality
+
+Use `memory_audit_quality` for a bounded page of explicitly approved indexed
+chunks. Continue with its `next` cursor until `done`, within the requested work
+budget. On `partial`, retry from the returned cursor; stop and report repeated
+provider failures. Restart without a cursor for a cached rescan after changes.
+It does not inspect unindexed content; oversized chunks are reported as skipped.
+
+Treat findings as indicators, not deletion decisions. High noise and high evidence
+can mean useful content trapped in a wrapper. JSON, code, logs, terse facts and
+historical records are not inherently junk. Grouped examples suggest a possible
+shared ingestion cause, not proof that every file has the same defect.
+
+Inspect the source via `memory_get` and the ingestion path. Prefer correcting an
+extractor or corpus inclusion rule over individually cleaning many symptoms.
+Moving or editing source files still requires the applicable authorization;
+never manually repair generated session projections. Preserve original evidence.
+Use the existing maintenance tools to dismiss legitimate content as `irrelevant`
+or defer uncertain cases. A dismissal sticks to that chunk's content version.
+Only resolve after verifying the resulting source and indexed content, recording
+what was checked in the required resolution note. Neither the audit nor marking
+a task resolved modifies or suppresses source data.
+
+### General maintenance
+
 - Do not rewrite raw memory or session projections.
 - Review a small page from `memory_list_maintenance_tasks`. For ambiguous dates,
   investigate supporting evidence and use `memory_update_maintenance_task` to