@psiclawops/hypermem 0.8.4 → 0.8.5

package/dist/session-flusher.d.ts

@@ -33,8 +33,8 @@ export interface FlushSessionResult {
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "agent1")
- * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "alice")
+ * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export declare function flushSession(cache: CacheLayer, agentId: string, sessionKey: string, opts?: FlushSessionOptions): Promise<FlushSessionResult>;

package/dist/session-flusher.js

@@ -18,8 +18,8 @@
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "agent1")
- * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "alice")
+ * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export async function flushSession(cache, agentId, sessionKey, opts = {}) {

package/dist/spawn-context.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:agent1:webchat:main',
+ *     parentSessionKey: 'agent:alice:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/spawn-context.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:agent1:webchat:main',
+ *     parentSessionKey: 'agent:alice:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/topic-store.js

@@ -12,12 +12,12 @@
 const KNOWN_NAMES = {
     hypermem: 'HyperMem',
     hyperbuilder: 'HyperBuilder',
-    clawcanvas: 'ClawCanvas',
-    clawdash: 'ClawDash',
-    clawdispatch: 'ClawDispatch',
+    canvas: 'canvas',
+    dashboard: 'dashboard',
+    dispatch: 'dispatch',
     clawtext: 'ClawText',
-    clawtomation: 'ClawTomation',
-    clawcouncil: 'ClawCouncil',
+    automation: 'automation',
+    council: 'council',
     openclaw: 'OpenClaw',
     clawhub: 'ClawHub',
 };

package/dist/topic-synthesizer.js

@@ -35,7 +35,7 @@ function keystoneScore(msg) {
     const backtickMatches = text.match(/`[^`]+`/g) || [];
     score += backtickMatches.length * 0.2;
     // Agent mentions (known patterns)
-    const agentMentions = text.match(/\b(agent1|agent2|agent4|agent3|agent5|agent6|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
+    const agentMentions = text.match(/\b(alice|bob|agent4|dave|oscar|carol|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
     score += agentMentions.length * 0.25;
     // Quoted content
     const quotedMatches = text.match(/"[^"]{10,}"/g) || [];

package/dist/trigger-registry.d.ts

@@ -39,7 +39,7 @@ export interface CollectionTrigger {
 export declare const TRIGGER_REGISTRY_VERSION = "1.0.0";
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from agent6's spec.
+ * Covers the core ACA offload use case from carol's spec.
  */
 export declare const TRIGGER_REGISTRY: CollectionTrigger[];
 /** Backward-compat alias — same reference as TRIGGER_REGISTRY */

package/dist/trigger-registry.js

@@ -13,7 +13,7 @@ import { createHash } from 'node:crypto';
 export const TRIGGER_REGISTRY_VERSION = '1.0.0';
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from agent6's spec.
+ * Covers the core ACA offload use case from carol's spec.
  */
 export const TRIGGER_REGISTRY = [
     {
@@ -61,7 +61,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 800,
         maxChunks: 2,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'operations',
         description: 'Agent operational procedures: boot sequence, heartbeat, work queue, session startup',
     },
@@ -98,7 +98,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1500,
         maxChunks: 4,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'memory',
         description: 'Decision history: past choices, previously agreed approaches, recalled context',
     },
@@ -124,7 +124,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1200,
         maxChunks: 3,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'operations',
         description: 'Agent tooling reference: CLI commands, config paths, deployment procedures, quick reference',
     },

package/dist/types.d.ts

@@ -70,7 +70,7 @@ export type FactScope = 'agent' | 'session' | 'user';
 /**
  * Memory visibility levels:
  * - private:  Only the owning agent can read. Identity, SOUL, personal reflections.
- * - org:      Agents in the same org (e.g., agent1's directors: Pylon, Vigil, Plane).
+ * - org:      Agents in the same org (e.g., alice's directors: Hank, Jack, Irene).
  * - council:  All council seats can read.
  * - fleet:    Any agent in the fleet can read.
  */
@@ -400,7 +400,7 @@ export interface ProviderMessage {
  * to identify high-signal unprocessed messages.
  *
  * Stored in Redis (hm:{a}:s:{s}:cursor) with dual-write to SQLite for
- * durability across Redis eviction (agent2 Gate 2).
+ * durability across Redis eviction (bob Gate 2).
  */
 export interface SessionCursor {
     /** StoredMessage.id of the newest message included in the last window */

package/docs/TUNING.md

@@ -1,6 +1,6 @@
 # hypermem Tuning Guide
 
-Configuration reference for operators and agents. All settings are optional, but the installer now writes a fully-expanded `config.json` so operators can see every default in one place.
+Configuration reference for operators and agents. All settings are optional. The recommended install path writes a starter `config.json` with an explicit lightweight embedding choice and a declarative baseline compositor profile. Tune from that verified baseline, not from guesswork.
 
 Config lives in `~/.openclaw/hypermem/config.json` (takes effect on gateway restart) or is passed programmatically via `HyperMem.create()`:
 
@@ -23,6 +23,16 @@ Resolution order is:
 2. `~/.openclaw/hypermem/config.json`
 3. code defaults
 
+## Before you tune
+
+Do not tune an install that is only staged. Verify these first:
+
+1. `openclaw plugins list` shows `hypercompositor` and `hypermem` loaded
+2. `openclaw logs --limit 50 | grep hypermem` shows `hypermem initialized`
+3. after a real agent message, logs show `[hypermem:compose]`
+
+If any of those are missing, go back to `INSTALL.md`. That is an install-path problem, not a tuning problem.
+
 ---
 
 ## Token Cost Philosophy

package/install.sh

@@ -323,31 +323,31 @@ write_config() {
   "warmCacheReplayThresholdMs": 120000,
   "subagentWarming": "light",
   "compositor": {
-    "budgetFraction": 0.703,
+    "budgetFraction": 0.55,
     "reserveFraction": 0.25,
     "historyFraction": 0.4,
     "memoryFraction": 0.4,
     "defaultTokenBudget": 90000,
     "maxHistoryMessages": 500,
-    "maxFacts": 30,
+    "maxFacts": 25,
     "maxExpertisePatterns": 6,
     "maxCrossSessionContext": 4000,
     "maxTotalTriggerTokens": 4000,
     "maxRecentToolPairs": 3,
     "maxProseToolPairs": 10,
-    "warmHistoryBudgetFraction": 0.4,
+    "warmHistoryBudgetFraction": 0.27,
     "contextWindowReserve": 0.25,
     "dynamicReserveTurnHorizon": 5,
     "dynamicReserveMax": 0.5,
     "dynamicReserveEnabled": true,
-    "keystoneHistoryFraction": 0.2,
-    "keystoneMaxMessages": 15,
+    "keystoneHistoryFraction": 0.15,
+    "keystoneMaxMessages": 12,
     "keystoneMinSignificance": 0.5,
-    "targetBudgetFraction": 0.65,
+    "targetBudgetFraction": 0.50,
     "enableFOS": true,
     "enableMOD": true,
     "hyperformProfile": "standard",
-    "wikiTokenCap": 600,
+    "wikiTokenCap": 500,
     "zigzagOrdering": true
   },
   "eviction": {

package/memory-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@psiclawops/hypermem-memory",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "HyperMem memory plugin for OpenClaw — bridges HyperMem retrieval into the memory slot",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@psiclawops/hypermem",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Agent-centric memory and context composition engine for OpenClaw",
   "type": "module",
   "main": "dist/index.js",

package/plugin/dist/index.d.ts

@@ -136,6 +136,32 @@ export declare function resolveEffectiveBudget(args: {
     budget: number;
     source: string;
 };
+export interface ModelIdentity {
+    rawModel: string | null;
+    modelKey: string | null;
+    provider: string | null;
+    modelId: string | null;
+}
+export declare function resolveModelIdentity(model?: string): ModelIdentity;
+export declare function diffModelState(previous: {
+    model?: string;
+    modelKey?: string | null;
+    provider?: string | null;
+    modelId?: string | null;
+    tokenBudget?: number;
+} | null | undefined, current: {
+    model?: string;
+    tokenBudget?: number;
+}): {
+    previousIdentity: ModelIdentity;
+    currentIdentity: ModelIdentity;
+    modelChanged: boolean;
+    providerChanged: boolean;
+    modelIdChanged: boolean;
+    budgetChanged: boolean;
+    budgetDownshift: boolean;
+    budgetUplift: boolean;
+};
 /**
  * Bust the assembly cache for a specific agent+session.
  * Call this after writing to identity files (SOUL.md, IDENTITY.md, TOOLS.md,

package/plugin/dist/index.d.ts.map

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

package/plugin/dist/index.js

@@ -400,6 +400,48 @@ export function resolveEffectiveBudget(args) {
         source: 'fallback contextWindowSize',
     };
 }
+export function resolveModelIdentity(model) {
+    const modelKey = normalizeModelKey(model);
+    if (!modelKey) {
+        return {
+            rawModel: model ?? null,
+            modelKey: null,
+            provider: null,
+            modelId: null,
+        };
+    }
+    const slash = modelKey.indexOf('/');
+    return {
+        rawModel: model ?? null,
+        modelKey,
+        provider: slash > 0 ? modelKey.slice(0, slash) : null,
+        modelId: slash > 0 && slash < modelKey.length - 1 ? modelKey.slice(slash + 1) : modelKey,
+    };
+}
+export function diffModelState(previous, current) {
+    const previousIdentity = previous?.modelKey || previous?.provider || previous?.modelId
+        ? {
+            rawModel: previous.model ?? null,
+            modelKey: previous.modelKey ?? normalizeModelKey(previous.model),
+            provider: previous.provider ?? resolveModelIdentity(previous.model).provider,
+            modelId: previous.modelId ?? resolveModelIdentity(previous.model).modelId,
+        }
+        : resolveModelIdentity(previous?.model);
+    const currentIdentity = resolveModelIdentity(current.model);
+    const previousBudget = previous?.tokenBudget;
+    const currentBudget = current.tokenBudget;
+    const budgetChanged = previousBudget != null && currentBudget != null && previousBudget !== currentBudget;
+    return {
+        previousIdentity,
+        currentIdentity,
+        modelChanged: previousIdentity.modelKey !== currentIdentity.modelKey,
+        providerChanged: previousIdentity.provider !== currentIdentity.provider,
+        modelIdChanged: previousIdentity.modelId !== currentIdentity.modelId,
+        budgetChanged,
+        budgetDownshift: previousBudget != null && currentBudget != null && currentBudget < previousBudget,
+        budgetUplift: previousBudget != null && currentBudget != null && currentBudget > previousBudget,
+    };
+}
 function normalizeModelKey(model) {
     if (!model)
         return null;
@@ -1316,10 +1358,10 @@ function createHyperMemEngine() {
                 // Non-fatal: missing files are silently skipped.
                 let identityBlock;
                 try {
-                    // Council agents live at workspace-council/<agentId>/
+                    // Council agents live at workspace/<agentId>/
                     // Other agents at workspace/<agentId>/ — try council path first
                     const homedir = os.homedir();
-                    const councilPath = path.join(homedir, '.openclaw', 'workspace-council', agentId);
+                    const councilPath = path.join(homedir, '.openclaw', 'workspace', agentId);
                     const workspacePath = path.join(homedir, '.openclaw', 'workspace', agentId);
                     let wsPath = councilPath;
                     try {
@@ -1351,7 +1393,7 @@ function createHyperMemEngine() {
                 let _wsPathForSeed;
                 try {
                     const homedir2 = os.homedir();
-                    const councilPath2 = path.join(homedir2, '.openclaw', 'workspace-council', agentId);
+                    const councilPath2 = path.join(homedir2, '.openclaw', 'workspace', agentId);
                     const workspacePath2 = path.join(homedir2, '.openclaw', 'workspace', agentId);
                     try {
                         await fs.access(councilPath2);
@@ -1386,7 +1428,7 @@ function createHyperMemEngine() {
                 // Post-warm pressure check: if messages.db had accumulated history,
                 // warm() may have loaded the session straight to 80%+. Pre-trim now
                 // so the first turn has headroom instead of starting saturated.
-                // This is the "restart at 98%" failure mode reported by Helm 2026-04-05:
+                // This is the "restart at 98%" failure mode reported by Eve 2026-04-05:
                 // JSONL truncation + Redis flush isn't enough if messages.db is still full
                 // and warm() reloads it. Trim here closes the loop.
                 try {
@@ -2088,23 +2130,32 @@ function createHyperMemEngine() {
                         console.warn('[hypermem-plugin] assemble: Redis trim failed (non-fatal):', trimErr.message);
                     }
                     // ── Budget downshift: proactive reshape pass ───────────────────────────────────────
-                    // If this session previously composed at a higher token budget (e.g. gpt-5.4
-                    // → claude-sonnet model switch), the Redis window is still sized for the old
-                    // budget. trimHistoryToTokenBudget above trims by count but skips tool
-                    // gradient logic. A downshift >10% triggers a full reshape: apply tool
-                    // gradient at the new budget + trim, then write back before compose runs.
-                    // This prevents several turns of compaction churn after a model switch.
-                    //
-                    // Bug fix: previously read from getWindow() which is always null here
-                    // (afterTurn invalidates it every turn). Also fixed: was doing setWindow()
-                    // then invalidateWindow() which is a write-then-delete no-op. Now reads
-                    // from history list and writes back via replaceHistory().
+                    // Detect provider/model identity changes as well as raw budget changes.
+                    // Provider routing matters operationally because the same model family can
+                    // land on a different effective context window, for example Copilot Sonnet
+                    // vs direct Anthropic Sonnet. Only budget downshifts trigger the demoted
+                    // reshape guard, but verbose logs now show provider/model swaps even when
+                    // the effective budget stays flat or increases.
                     let lastState = null;
                     try {
                         lastState = await hm.cache.getModelState(agentId, sk);
                         const DOWNSHIFT_THRESHOLD = 0.10;
-                        const isDownshift = lastState &&
-                            (lastState.tokenBudget - effectiveBudget) / lastState.tokenBudget > DOWNSHIFT_THRESHOLD;
+                        const modelDelta = diffModelState(lastState, {
+                            model,
+                            tokenBudget: effectiveBudget,
+                        });
+                        const downshiftFraction = lastState?.tokenBudget
+                            ? (lastState.tokenBudget - effectiveBudget) / lastState.tokenBudget
+                            : 0;
+                        const isDownshift = modelDelta.budgetDownshift && downshiftFraction > DOWNSHIFT_THRESHOLD;
+                        if (lastState && (modelDelta.modelChanged || modelDelta.budgetChanged)) {
+                            verboseLog(`[hypermem-plugin] model state change: ` +
+                                `prev=${modelDelta.previousIdentity.modelKey ?? 'unknown'} ` +
+                                `next=${modelDelta.currentIdentity.modelKey ?? 'unknown'} ` +
+                                `providerChanged=${modelDelta.providerChanged} ` +
+                                `modelIdChanged=${modelDelta.modelIdChanged} ` +
+                                `budget=${lastState.tokenBudget}->${effectiveBudget}`);
+                        }
                         if (isDownshift && !_deferToolPruning) {
                             // Sprint 2.2a: demote reshape to guard telemetry.
                             //
@@ -2269,8 +2320,12 @@ ${replayRecovery.emittedText}`
                     await persistReplayRecoveryState(hm, agentId, sk, replayRecovery.nextState);
                     // Update model state for downshift detection on next turn
                     try {
+                        const modelIdentity = resolveModelIdentity(model);
                         await hm.cache.setModelState(agentId, sk, {
                             model: model ?? 'unknown',
+                            modelKey: modelIdentity.modelKey ?? undefined,
+                            provider: modelIdentity.provider ?? undefined,
+                            modelId: modelIdentity.modelId ?? undefined,
                             tokenBudget: effectiveBudget,
                             composedAt: new Date().toISOString(),
                             historyDepth,
@@ -2610,7 +2665,7 @@ ${replayRecovery.emittedText}`
                 // gradient-compressed window to budget before writing to Redis. Without
                 // this, afterTurn writes up to 250 messages regardless of budget, causing
                 // trimHistoryToTokenBudget to fire and trim ~200 messages on every
-                // subsequent assemble() — the churn loop seen in Helm's logs.
+                // subsequent assemble() — the churn loop seen in Eve's logs.
                 if (hm.cache.isConnected) {
                     try {
                         const modelState = await hm.cache.getModelState(agentId, sk);
@@ -2634,7 +2689,7 @@ ${replayRecovery.emittedText}`
                 // If a session just finished a turn at >80% pressure, the NEXT turn's
                 // incoming tool results (parallel web searches, large exec output, etc.)
                 // will hit a window with no headroom — the ingestion wave failure mode
-                // (reported by Helm, 2026-04-05). Pre-trim here so the tool-loop
+                // (reported by Eve, 2026-04-05). Pre-trim here so the tool-loop
                 // assemble() path starts the next turn with meaningful space.
                 //
                 // Uses modelState.tokenBudget if cached; skips if unavailable (non-fatal).