@etzelm/openclaw-memory-hindsight 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.6.0 (2026-11-11)
+
+### Upgrade notes
+
+- Needs an OpenClaw build with openclaw/openclaw#197274 (merged 2026-11-11) for `hindsight_*`
+  tools on claude-cli sessions. That host change passes the turn's memory audience when it lists
+  claude-cli MCP tools, so the tools list through the normal audience route. On an older
+  2026.11.x host, claude-cli sessions keep auto-recall but lose the `hindsight_*` tools; stay on
+  0.5.0 there.
+- `listToolsWithoutAudience` is deprecated and ignored. The key still validates, so an existing
+  config keeps loading; remove it. A later major release rejects it.
+
+### Removed
+
+- The `listToolsWithoutAudience` workaround from 0.5.0: a tool context without a memory audience
+  gets no `hindsight_*` tools again, whatever the config says.
+
 ## 0.5.0 (2026-11-10)
 
 ### Upgrade notes

package/README.md

@@ -129,7 +129,6 @@ tool conflict.
 | `recallCacheTtlMs`          | `0` (off)            | Auto-recall cache per session and bank, 0 to 3600000 ms; a repeated query skips the API call          |
 | `recallFollowupMaxWords`    | `0` (off)            | At most N words, no URL or path: skip after a recent recall with hits, else add the prior user turn   |
 | `knowledgeReadTools`        | `false`              | Offer the read-only knowledge-base tools (see below); turning it on needs a gateway restart           |
-| `listToolsWithoutAudience`  | `false`              | List the `hindsight_*` tools when the host builds the tool list without an audience (see below)       |
 
 Session patterns: `*` matches any run of characters except `:`, `**` matches anything including
 `:`, everything else is literal. Patterns match the trimmed session key. `ignoreSessionPatterns`
@@ -149,14 +148,10 @@ prompt, so the cached prefix stays stable). Knowledge-base tool caps: a response
 the tree shows 500 entries, then `(truncated, N more entries)`; search shows at most 50 hits
 with snippets cut at 500 characters and names and ids at 200.
 
-`listToolsWithoutAudience`: the claude-cli runtime on OpenClaw 2026.11.x builds a turn's MCP tool
-list before it attaches the turn's memory audience, so every tool factory sees no audience, returns
-null, and `hindsight_*` never reach claude-cli sessions (auto-recall still works; it reads the
-audience from the hook context). With this key on, an agent session with a session key gets the
-tools listed anyway. The host then builds the callable copy with the audience from the run's grant,
-and that copy alone reaches Hindsight; a call that still has no audience fails with an error before
-any request. The session filters (`memoryMode`, incognito, `excludeProviders`,
-`skipOperationalSessions`) apply as before, and an audience for another agent is still refused.
+`hindsight_*` tools on claude-cli sessions need an OpenClaw build that passes the turn's memory
+audience when it lists MCP tools (openclaw/openclaw#197274). On older 2026.11.x builds those
+sessions get auto-recall but no `hindsight_*` tools. `listToolsWithoutAudience` (0.5.0) is
+deprecated and ignored since 0.6.0; remove it from your config.
 
 Config changes apply without a restart: the plugin re-reads its entry from the host's current
 config snapshot (`api.runtime.config.current()`), falling back to the register-time

package/dist/config.js

@@ -40,6 +40,7 @@ const CONFIG_KEYS = [
     "retainQueueMaxItems",
     "retainQueueMaxAgeMs",
     "knowledgeReadTools",
+    // Deprecated in 0.6.0 and ignored: accepted so a config that still sets it keeps validating.
     "listToolsWithoutAudience",
     "recallCacheTtlMs",
     "recallFollowupMaxWords",
@@ -227,7 +228,6 @@ export const hindsightConfigSchema = {
             retainQueueMaxItems: readPositiveInt(value, "retainQueueMaxItems", DEFAULT_RETAIN_QUEUE_MAX_ITEMS, MAX_RETAIN_QUEUE_MAX_ITEMS),
             retainQueueMaxAgeMs: readPositiveInt(value, "retainQueueMaxAgeMs", DEFAULT_RETAIN_QUEUE_MAX_AGE_MS),
             knowledgeReadTools: readBool(value, "knowledgeReadTools", false),
-            listToolsWithoutAudience: readBool(value, "listToolsWithoutAudience", false),
             recallCacheTtlMs: readNonNegativeInt(value, "recallCacheTtlMs", 0, MAX_RECALL_CACHE_TTL_MS),
             recallFollowupMaxWords: readNonNegativeInt(value, "recallFollowupMaxWords", 0, MAX_RECALL_FOLLOWUP_WORDS),
         };

package/dist/tools.js

@@ -24,19 +24,6 @@ function requiredString(params, name) {
     }
     return value.trim();
 }
-export const NO_AUDIENCE_AT_CALL = "This session has no host memory audience for this call, so Hindsight memory is unavailable.";
-/**
- * A tool listed for a session whose tool list the host built without a memory audience. Reading
- * `bankId` throws, so `execute` fails before any request; the host builds the callable tool again
- * with the session's audience, and that copy gets a real bank.
- */
-function deferredBank() {
-    return {
-        get bankId() {
-            throw new Error(NO_AUDIENCE_AT_CALL);
-        },
-    };
-}
 /**
  * Resolves the bank for one tool context, or null when the session must not get the tool.
  * The bank comes only from the host-minted audience; the model never names a bank.
@@ -52,15 +39,6 @@ function resolveToolBank(service, ctx, purpose) {
         })) {
         return null;
     }
-    // Some hosts list a session's tools before they attach its audience (claude-cli MCP tool
-    // projection on OpenClaw 2026.11.x). Opt-in: list the tool for an agent session with a key, and
-    // let only the audience-bearing copy built for the call reach Hindsight.
-    if (config.listToolsWithoutAudience &&
-        !ctx.memoryAudience &&
-        ctx.agentId?.trim() &&
-        ctx.sessionKey?.trim()) {
-        return deferredBank();
-    }
     const route = routeAudience(ctx.agentId, ctx.memoryAudience, config.agentBankMap);
     return route.ok ? { bankId: route.bankId } : null;
 }

package/openclaw.plugin.json

@@ -96,11 +96,6 @@
       "label": "Knowledge Base Read Tools",
       "help": "Offer hindsight_get_knowledge_base_tree, hindsight_search_knowledge_base and hindsight_get_knowledge_page on the same bank as hindsight_recall",
       "advanced": true
-    },
-    "listToolsWithoutAudience": {
-      "label": "List Tools Without Audience",
-      "help": "List the hindsight_* tools when the host builds a session's tool list before it attaches the memory audience (claude-cli sessions on OpenClaw 2026.11.x). Calls still need the audience",
-      "advanced": true
     }
   },
   "configSchema": {
@@ -223,7 +218,7 @@
       "listToolsWithoutAudience": {
         "type": "boolean",
         "default": false,
-        "description": "List the hindsight_* tools for an agent session whose tool list the host builds without its memory audience (claude-cli MCP tool projection on OpenClaw 2026.11.x). The bank still comes only from the audience: a call without one fails before any request"
+        "description": "Deprecated since 0.6.0 and ignored. The host now passes the memory audience when it lists claude-cli tools (openclaw/openclaw#197274). Remove this key; a later major release rejects it"
       },
       "agentBankMap": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@etzelm/openclaw-memory-hindsight",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Native Hindsight memory engine for OpenClaw: memory slot provider runtime, auto-recall, auto-retain, pre-compaction flush and hindsight_* agent tools.",
   "keywords": [
     "hindsight",
@@ -37,7 +37,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "lint": "oxlint src",
+    "lint": "oxlint --deny-warnings src",
     "format": "oxfmt --write .",
     "format:check": "oxfmt --check .",
     "prepack": "npm run build"