@psiclawops/hypermem 0.8.0 → 0.8.2

package/README.md

@@ -32,6 +32,8 @@ The difference isn't intelligence. It's what was in the prompt. Two failure mode
 
 **Compaction crunch.** Long sessions fill the context window. The runtime summarizes to make room. Specifics (tool output, exact decisions, file paths) are lost in the summary. The agent keeps running, but degraded.
 
+**Bloated context.** 128k tokens doesn't mean 128k of useful prompt. Without active curation, agents fill the window with stale history, redundant instructions, and memory that isn't relevant to this turn. A bigger context window just means more room to waste. The information is in the prompt somewhere, buried under content irrelevant to this turn.
+
 ---
 
 ## What OpenClaw provides today
@@ -104,10 +106,10 @@ What's in storage, not in this prompt:
   Change the topic, and the next turn pulls different content from the same storage.
 ```
 
-### Standard context engine vs. hypercompositor
+### OpenClaw default vs. hypercompositor
 
 ```
-Standard                                hypercompositor
+OpenClaw default                        hypercompositor
 ────────────────────────────────        ────────────────────────────────
 message → append to transcript          message → detect active topic
 transcript full → trim oldest           query 4 storage layers in parallel
@@ -125,7 +127,7 @@ When it fills:                          When budget is exceeded:
   no recovery path                        change topic back → retrieved again
 ```
 
-| | Standard | hypercompositor |
+| | OpenClaw default | hypercompositor |
 |---|---|---|
 | Context source | Growing transcript only | Transcript + 3 additional storage layers |
 | When context fills | Trim + summarize (lossy) | Budget allocation (lossless storage) |
@@ -164,9 +166,9 @@ Different models have different default behaviors. GPT-5.4 tends toward 2x verbo
 
 Adaptation entries are stored in the `model_output_directives` table and matched by model ID using exact match, then glob pattern (longest wins), then wildcard fallback. Each entry contains:
 
-- **Calibration** — known model tendencies and specific adjustments (e.g., "2x verbosity: cut first drafts in half")
-- **Corrections** — hard/medium/soft severity rules applied in order (e.g., "No preamble before the answer")
-- **Task overrides** — per-task-type adjustments
+- **Calibration:** known model tendencies and specific adjustments (e.g., "2x verbosity: cut first drafts in half")
+- **Corrections:** hard/medium/soft severity rules applied in order (e.g., "No preamble before the answer")
+- **Task overrides:** per-task-type adjustments
 
 Model adaptation is only active at the `full` tier. At `light` and `standard`, model-specific corrections are suppressed.
 
@@ -196,7 +198,7 @@ Would you like me to go deeper on any of these?
 WITH outputProfile: "light":
 For a 128k window: reserve 14k for identity/system, target 46k for history, 10k for recent
 tool context, and leave ~30k as allocator reserve. hypermem handles slot competition
-automatically — set `reserveFraction` to your preferred floor and let the compositor fill.
+automatically. Set `reserveFraction` to your preferred floor and let the compositor fill.
 ```
 
 **Confabulation resistance** checks output against stored facts before claims are recorded. No LLM call. Pattern matching against the fact corpus, with confidence scoring and contradiction detection. Unsupported claims are flagged, contradictions surface in diagnostics, and a confabulation risk score is attached to the stored episode.
@@ -241,16 +243,7 @@ SQL queries that interpolate datetime values are fully parameterized. FTS5 trigg
 
 ## Pressure management
 
-hypermem composes context fresh on every turn, but a long-running session still accumulates history in its JSONL transcript. When that grows large enough, incoming tool results have nowhere to land and get silently stripped. Four automatic paths handle this:
-
-| Path | Trigger | Action |
-|---|---|---|
-| **Pressure-tiered tool-loop trim** | Any tool-loop turn | Measures projected occupancy before results land; trims large results at 80%+ and truncates the messages[] array for the current turn |
-| **AfterTurn trim** | Every turn at >80% | Pre-emptive headroom cut after the assistant replies, before the next turn arrives |
-| **Deep compaction** | compact() at >85% | Cuts in-memory cache to 25% budget and truncates JSONL to ~20% depth. Bypasses the normal reshape guard |
-| **Reshape guard** | Structured tool history on downshift | `canPersistReshapedHistory()` blocks a lower-context snapshot from overwriting the full JSONL history |
-
-**The one thing these paths cannot fix:** a session whose JSONL transcript on disk is already at 98% when the gateway restarts. The JSONL loads into runtime context before any compaction runs. Check `session_status` on startup. If you're above 85%, start a fresh session.
+hypermem manages context pressure automatically through four escalating paths. Most sessions never need manual intervention. For trigger thresholds and path details, see [Pressure management](#pressure-management-1) below.
 
 ---
 
@@ -332,7 +325,7 @@ FTS5 queries use compound indexes on `agentId + sort key` and prefix optimizatio
 | Knowledge | Domain/key/value structured data with full-text search |
 | Episodes | Significant events with impact scores and participant tracking |
 | Topics | Cross-session thread tracking and synthesized wiki pages |
-| Preferences | operator behavioral patterns |
+| Preferences | Operator behavioral patterns |
 | Fleet Registry | Agent registry with tier, org, and capability metadata |
 | System Registry | Service state and lifecycle |
 | Work Items | Work queue with status transitions and FTS5 |
@@ -383,7 +376,7 @@ Slot-level budget allocation is shown in the [hypercompositor diagram](#what-the
 
 ## Requirements
 
-**Current release: hypermem 0.8.0.** Changelog: [CHANGELOG.md](./CHANGELOG.md)
+**Current release: hypermem 0.8.1.** Changelog: [CHANGELOG.md](./CHANGELOG.md)
 
 | Requirement | Version | Notes |
 |---|---|---|
@@ -396,7 +389,7 @@ SQLite is a library, not a service. All four layers run in-process with no exter
 **Runtime version constants** (importable from the package):
 ```typescript
 import {
-  ENGINE_VERSION,        // '0.8.0'
+  ENGINE_VERSION,        // '0.8.1'
   MIN_NODE_VERSION,      // '22.0.0'
   SQLITE_VEC_VERSION,    // '0.1.9'
   MAIN_SCHEMA_VERSION,   // 10 (messages.db)
@@ -410,29 +403,95 @@ Schema versions are stamped into each database on startup and checked on open. A
 
 ## Installation
 
+**Requirements:** Node.js 22+, OpenClaw with context engine plugin support. No standalone SQLite install needed (uses Node 22 built-in `node:sqlite`). Embedding provider is optional for first install.
+
+hypermem works two ways:
+- **As a library** — import directly into your own Node.js code. No OpenClaw required.
+- **As an OpenClaw plugin** — replaces the default context engine. Requires a running OpenClaw gateway.
+
+### Library usage (no OpenClaw required)
+
 ```bash
-git clone https://github.com/PsiClawOps/hypermem.git ~/.openclaw/workspace/repo/hypermem
-cd ~/.openclaw/workspace/repo/hypermem
+npm install @psiclawops/hypermem
+```
+
+```typescript
+import { HyperMem } from '@psiclawops/hypermem';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const hm = await HyperMem.create({
+  dataDir: join(homedir(), '.openclaw', 'hypermem'),
+  embedding: { provider: 'none' },
+});
+
+await hm.recordUserMessage('my-agent', 'session-1', 'Hello');
+const composed = await hm.compose({
+  agentId: 'my-agent',
+  sessionKey: 'session-1',
+  prompt: 'Hello',
+  tokenBudget: 4000,
+  provider: 'anthropic',
+});
+```
+
+That's it. No gateway, no plugins, no config files. See [API](#api) for the full interface.
+
+### OpenClaw plugin install (from source)
+
+```bash
+git clone https://github.com/PsiClawOps/hypermem.git
+cd hypermem
 npm install && npm run build
 npm --prefix plugin install && npm --prefix plugin run build
 npm --prefix memory-plugin install && npm --prefix memory-plugin run build
+npm run install:runtime
+```
+
+`install:runtime` stages the runtime payload into `~/.openclaw/plugins/hypermem` and prints the exact config commands to wire the plugins. Before running them, create the data directory and config:
+
+```bash
+mkdir -p ~/.openclaw/hypermem
+cat > ~/.openclaw/hypermem/config.json <<'JSON'
+{
+  "embedding": {
+    "provider": "none"
+  }
+}
+JSON
+```
+
+This sets lightweight mode (FTS5 keyword search, no embedding provider needed). Add an embedding provider later for semantic search without losing stored data. See [INSTALL.md](./INSTALL.md#embedding-providers) for options.
+
+Wire the plugins into OpenClaw:
 
+```bash
+openclaw config set plugins.load.paths "[\"$HOME/.openclaw/plugins/hypermem/plugin\",\"$HOME/.openclaw/plugins/hypermem/memory-plugin\"]" --strict-json
 openclaw config set plugins.slots.contextEngine hypercompositor
 openclaw config set plugins.slots.memory hypermem
-openclaw config set plugins.load.paths '["~/.openclaw/workspace/repo/hypermem/plugin","~/.openclaw/workspace/repo/hypermem/memory-plugin"]' --strict-json
 openclaw config set plugins.allow '["hypercompositor","hypermem"]' --strict-json
 openclaw gateway restart
 ```
 
-Or use the one-line installer:
+Verify (run from the repo clone directory):
+
+```bash
+openclaw plugins list                    # hypercompositor and hypermem should show as loaded
+node bin/hypermem-status.mjs --health    # confirms database initialization
+openclaw logs --limit 50 | grep hypermem # should show "hypermem initialized"
+```
+
+If you see `falling back to default engine "legacy"` in the logs, the install is not active. Check [INSTALL.md troubleshooting](./INSTALL.md#troubleshooting-clean-installs).
+
+### One-line installer
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/PsiClawOps/hypermem/main/install.sh | bash
 ```
 
-**Requirements:** Node.js 22+, OpenClaw with context engine plugin support, and either Ollama (local) or an OpenRouter API key (hosted) for embeddings. No standalone SQLite install is required for the documented repo install: hypermem uses the SQLite bundled with Node 22 via `node:sqlite`, and `sqlite-vec` provides the platform-specific extension through npm dependencies.
+Interactive: detects hardware, selects embedding tier, writes config, registers plugins.
 
-Full guide with deployment-specific options: **[INSTALL.md](./INSTALL.md)**
+Full guide with embedding tiers, reranker setup, fleet config, and tuning: **[INSTALL.md](./INSTALL.md)**
 
 ### Agent-assisted install
 
@@ -440,7 +499,7 @@ If you prefer, hand the install to your OpenClaw agent:
 
 > "Install hypermem following INSTALL.md. I'm running a [solo / multi-agent] setup."
 
-### operator guides
+### Operator guides
 
 - **[docs/MEMORY_MD_AUTHORING.md](./docs/MEMORY_MD_AUTHORING.md)**, how to keep `MEMORY.md` compact, durable, and reviewable
 - **[docs/TUNING.md](./docs/TUNING.md)**, context assembly and output shaping profiles
@@ -448,7 +507,7 @@ If you prefer, hand the install to your OpenClaw agent:
 
 ### Tuning
 
-Two independent surfaces: **context assembly** (what fills the context window) and **output shaping** (how the model writes). Pick a profile first — most deployments adjust one or two settings on top.
+Two independent surfaces: **context assembly** (what fills the context window) and **output shaping** (how the model writes). Pick a profile first. Most deployments adjust one or two settings on top.
 
 | Profile | Target window | Best for |
 |---|---|---|
@@ -499,13 +558,15 @@ Full reference: **[docs/TUNING.md](./docs/TUNING.md)**
 
 ## API
 
-> **Note:** The examples below use placeholder agent names (`my-agent`, `alice`, etc.). Replace these with your actual agent IDs from your OpenClaw config. Single-agent installs typically use `main`. Multi-agent fleets use whatever IDs you've configured. See [INSTALL.md § "Configure your fleet"](./INSTALL.md#step-5--configure-your-fleet-multi-agent-only) for details.
+> **Note:** The examples below use placeholder agent names (`my-agent`, `agent1`, etc.). Replace these with your actual agent IDs from your OpenClaw config. Single-agent installs typically use `main`. Multi-agent fleets use whatever IDs you've configured. See [INSTALL.md § "Configure your fleet"](./INSTALL.md#step-5--configure-your-fleet-multi-agent-only) for details.
 
 ```typescript
 import { HyperMem } from '@psiclawops/hypermem';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 
 const hm = await HyperMem.create({
-  dataDir: '~/.openclaw/hypermem',
+  dataDir: join(homedir(), '.openclaw', 'hypermem'),
   cache: { maxEntries: 10000 },
   // Local (Ollama):
   embedding: { ollamaUrl: 'http://localhost:11434', model: 'nomic-embed-text' },
@@ -554,6 +615,29 @@ node bin/hypermem-status.mjs --json          # machine-readable output
 node bin/hypermem-status.mjs --health        # health checks only (exit 1 on failure)
 ```
 
+By default, `hypermem-status` looks for data in `~/.openclaw/hypermem`. If your data directory is elsewhere (e.g. testing in an isolated environment), set:
+
+```bash
+HYPERMEM_DATA_DIR=/path/to/data node bin/hypermem-status.mjs --health
+```
+
+> **Fresh install note:** If no agent has run a session yet, `--health` will report "no sessions ingested" rather than a database error. This is expected. Send a test message to any agent, then re-run the health check.
+
+---
+
+## Pressure management
+
+hypermem composes context fresh on every turn, but a long-running session still accumulates history in its JSONL transcript. When that grows large enough, incoming tool results have nowhere to land and get silently stripped. Four automatic paths handle this:
+
+| Path | Trigger | Action |
+|---|---|---|
+| **Pressure-tiered tool-loop trim** | Any tool-loop turn | Measures projected occupancy before results land; trims large results at 80%+ and truncates the messages[] array for the current turn |
+| **AfterTurn trim** | Every turn at >80% | Pre-emptive headroom cut after the assistant replies, before the next turn arrives |
+| **Deep compaction** | compact() at >85% | Cuts in-memory cache to 25% budget and truncates JSONL to ~20% depth. Bypasses the normal reshape guard |
+| **Reshape guard** | Structured tool history on downshift | `canPersistReshapedHistory()` blocks a lower-context snapshot from overwriting the full JSONL history |
+
+**The one thing these paths cannot fix:** a session whose JSONL transcript on disk is already at 98% when the gateway restarts. The JSONL loads into runtime context before any compaction runs. Check `session_status` on startup. If you're above 85%, start a fresh session.
+
 ---
 
 ## Data directory
@@ -570,6 +654,22 @@ node bin/hypermem-status.mjs --health        # health checks only (exit 1 on fai
 
 ---
 
+## Common issues
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| `falling back to default engine "legacy"` in logs | Plugin not loaded or slot misconfigured | Check `openclaw config get plugins.slots.contextEngine` is `hypercompositor`, paths are correct, and both plugins are in `plugins.allow` |
+| `openclaw gateway restart` says disabled/not configured | OpenClaw not fully onboarded | Complete OpenClaw setup first. `gateway restart` requires a running gateway. |
+| `openclaw logs` fails with auth/token error | Gateway auth not set up for CLI | Run `openclaw gateway status` to confirm the gateway is accessible |
+| `facts=0 semantic=0` every turn | Fresh install, no data yet | Expected. Facts accumulate over real conversations. |
+| Health check says "no sessions ingested" | No agent has run a session yet | Send a test message, then re-run |
+| JS code creates `./~/.openclaw/` directory | Used literal `~` in JS instead of `homedir()` | Use `join(homedir(), '.openclaw', 'hypermem')` from `node:path` and `node:os` |
+| `INSTALL.md` not found in npm package | Older published version | Update to latest or read INSTALL.md on [GitHub](https://github.com/PsiClawOps/hypermem/blob/main/INSTALL.md) |
+
+Full troubleshooting: **[INSTALL.md § Troubleshooting](./INSTALL.md#troubleshooting)**
+
+---
+
 ## Migration
 
 hypermem doesn't touch your existing memory data. Install it, switch the context engine, and migrate historical data on your own timeline.
@@ -578,7 +678,7 @@ The migration guide includes worked examples showing how to bring data from Open
 
 All examples default to dry-run. Nothing is written until you add `--apply`.
 
-operator guide: **[docs/MIGRATION_GUIDE.md](./docs/MIGRATION_GUIDE.md)**
+Operator guide: **[docs/MIGRATION_GUIDE.md](./docs/MIGRATION_GUIDE.md)**
 
 
 ---

package/bin/hypermem-status.mjs

@@ -4,7 +4,7 @@
  *
  * Usage:
  *   node bin/hypermem-status.mjs              # full dashboard
- *   node bin/hypermem-status.mjs --agent carol # scoped to one agent
+ *   node bin/hypermem-status.mjs --agent forge # scoped to one agent
  *   node bin/hypermem-status.mjs --json        # machine-readable output
  *   node bin/hypermem-status.mjs --health      # health checks only (exit 1 on failure)
  *
@@ -104,6 +104,16 @@ if (flags.agent) {
 }
 
 if (!mainDbPath || !existsSync(mainDbPath)) {
+  if (args.includes('--health') || args.includes('--json')) {
+    const result = { status: 'no_sessions', message: 'Installed but no agent sessions ingested yet. Send a message to any agent, then re-run.' };
+    if (args.includes('--json')) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log('Status: installed, no sessions ingested yet.');
+      console.log('Send a message to any agent, then re-run this health check.');
+    }
+    process.exit(0);
+  }
   console.error('Error: no agent messages.db found. Has HyperMem ingested any sessions?');
   process.exit(1);
 }

package/dist/background-indexer.js

@@ -37,27 +37,27 @@ import { isSafeForSharedVisibility } from './secret-scanner.js';
 // returns results. New agents default to 'general'.
 //
 // ── EXAMPLE DATA ──────────────────────────────────────────────────
-// The agent names below (alice, director1, etc.) are PLACEHOLDERS.
+// The agent names below (agent1, director1, etc.) are PLACEHOLDERS.
 // Replace them with your own agent IDs and domain labels to match
 // your fleet. Single-agent installs don't need to edit this:
 // unknown agents fall through to 'general' automatically.
 // See INSTALL.md § "Configure your fleet" for details.
 // ─────────────────────────────────────────────────────────────────
 const AGENT_DOMAIN_MAP = {
-    alice: 'infrastructure',
+    agent1: 'infrastructure',
     director2: 'infrastructure',
     director1: 'infrastructure',
     director3: 'infrastructure',
-    bob: 'product',
+    agent2: 'product',
     director4: 'product',
     director5: 'product',
     director6: 'product',
-    dave: 'security',
+    agent3: 'security',
     director7: 'security',
     director8: 'security',
     agent4: 'ux',
-    carol: 'governance',
-    oscar: 'strategy',
+    agent6: 'governance',
+    agent5: 'strategy',
     specialist1: 'development',
     specialist2: 'communications',
     main: 'general',
@@ -94,7 +94,7 @@ function extractFactCandidates(content) {
     // Preference patterns — medium confidence (0.60)
     const preferencePatterns = [
         /(?:prefer|always use|never use|don't use|avoid) (.{10,150})/gi,
-        /(?:operator) (?:wants|prefers|likes|hates|dislikes) (.{10,150})/gi,
+        /(?:operator|operator) (?:wants|prefers|likes|hates|dislikes) (.{10,150})/gi,
     ];
     // Operational patterns: deployments, incidents, fixes — high confidence (0.70)
     const operationalPatterns = [
@@ -148,7 +148,7 @@ const OPERATIONAL_BOILERPLATE = [
     /still\s*waiting/i,
     /will\s*pick\s*(it\s*)?up\s*(on\s*(next|the))?/i,
     /message\s*is\s*in\s*(his|her|their|the)\s*queue/i,
-    /sent\s+to\s+(carol|bob|agent4|dave|oscar|alice)/i,
+    /sent\s+to\s+(agent6|agent2|agent4|agent3|agent5|agent1)/i,
     /dispatched\s+(it\s+)?to/i,
     /timed\s*out\s*after/i,
     /\bNO_REPLY\b/,
@@ -393,7 +393,7 @@ function detectTopic(content) {
     if (!content || content.length < 50)
         return null;
     // Product/project name detection
-    const productMatch = content.match(/\b(HyperMem|ClawText|dashboard|canvas|council|automation|OpenClaw|dispatch)\b/i);
+    const productMatch = content.match(/\b(HyperMem|ClawText|ClawDash|ClawCanvas|ClawCouncil|ClawTomation|OpenClaw|ClawDispatch)\b/i);
     if (productMatch)
         return productMatch[1];
     // Infrastructure topic detection

package/dist/cross-agent.d.ts

@@ -27,7 +27,7 @@ export interface OrgRegistry {
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is

package/dist/cross-agent.js

@@ -21,7 +21,7 @@ import { FleetStore } from './fleet-store.js';
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is
@@ -34,27 +34,27 @@ import { FleetStore } from './fleet-store.js';
  */
 export function defaultOrgRegistry() {
     const agents = {
-        alice: { agentId: 'alice', tier: 'council' },
-        bob: { agentId: 'bob', tier: 'council' },
+        agent1: { agentId: 'agent1', tier: 'council' },
+        agent2: { agentId: 'agent2', tier: 'council' },
         agent4: { agentId: 'agent4', tier: 'council' },
-        dave: { agentId: 'dave', tier: 'council' },
-        carol: { agentId: 'carol', tier: 'council' },
-        oscar: { agentId: 'oscar', tier: 'council' },
-        director1: { agentId: 'director1', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director2: { agentId: 'director2', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director3: { agentId: 'director3', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director4: { agentId: 'director4', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director5: { agentId: 'director5', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director6: { agentId: 'director6', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director7: { agentId: 'director7', tier: 'director', org: 'dave-org', councilLead: 'dave' },
-        director8: { agentId: 'director8', tier: 'director', org: 'dave-org', councilLead: 'dave' },
+        agent3: { agentId: 'agent3', tier: 'council' },
+        agent6: { agentId: 'agent6', tier: 'council' },
+        agent5: { agentId: 'agent5', tier: 'council' },
+        director1: { agentId: 'director1', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director2: { agentId: 'director2', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director3: { agentId: 'director3', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director4: { agentId: 'director4', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director5: { agentId: 'director5', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director6: { agentId: 'director6', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director7: { agentId: 'director7', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
+        director8: { agentId: 'director8', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
         specialist1: { agentId: 'specialist1', tier: 'specialist' },
         specialist2: { agentId: 'specialist2', tier: 'specialist' },
     };
     const orgs = {
-        'alice-org': ['alice', 'director1', 'director2', 'director3'],
-        'bob-org': ['bob', 'director4', 'director5', 'director6'],
-        'dave-org': ['dave', 'director7', 'director8'],
+        'agent1-org': ['agent1', 'director1', 'director2', 'director3'],
+        'agent2-org': ['agent2', 'director4', 'director5', 'director6'],
+        'agent3-org': ['agent3', 'director7', 'director8'],
     };
     return { orgs, agents };
 }

package/dist/dreaming-promoter.d.ts

@@ -67,7 +67,7 @@ export interface DreamerResult {
 }
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace/{agentId}/
+ * Council agents live at ~/.openclaw/workspace-council/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export declare function resolveAgentWorkspacePath(agentId: string): Promise<string | null>;

package/dist/dreaming-promoter.js

@@ -31,12 +31,12 @@ export const DEFAULT_DREAMER_CONFIG = {
 // ─── Workspace path resolution ───────────────────────────────────────────────
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace/{agentId}/
+ * Council agents live at ~/.openclaw/workspace-council/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export async function resolveAgentWorkspacePath(agentId) {
     const home = os.homedir();
-    const councilPath = path.join(home, '.openclaw', 'workspace', agentId);
+    const councilPath = path.join(home, '.openclaw', 'workspace-council', agentId);
     const workspacePath = path.join(home, '.openclaw', 'workspace', agentId);
     try {
         await fs.access(councilPath);

package/dist/index.d.ts

@@ -126,8 +126,8 @@ export interface StartupFleetSeedResult {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
+ *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
  */
 export declare class HyperMem {
     readonly dbManager: DatabaseManager;
@@ -185,7 +185,7 @@ export declare class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * operator-safe enumeration path. This is the approved archived-context
+     * Operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId: string, opts?: {

package/dist/index.js

@@ -97,7 +97,7 @@ const DEFAULT_CONFIG = {
     cache: {
         keyPrefix: 'hm:',
         sessionTTL: 14400, // 4 hours — system/identity/meta slots
-        historyTTL: 604800, // 7 days — extended for canvas display
+        historyTTL: 604800, // 7 days — extended for ClawCanvas display
     },
     compositor: {
         // TUNE-010 (2026-04-02): Raised from 65000 → 90000.
@@ -217,7 +217,7 @@ function mergeStartupCandidate(target, partial) {
 function discoverStartupFleetCandidates(dbManager, opts = {}) {
     const homeDir = process.env.HOME || os.homedir();
     const workspaceRoots = opts.workspaceRoots ?? [
-        path.join(homeDir, '.openclaw', 'workspace'),
+        path.join(homeDir, '.openclaw', 'workspace-council'),
         path.join(homeDir, '.openclaw', 'workspace'),
     ];
     const candidates = new Map();
@@ -331,8 +331,8 @@ function discoverStartupFleetCandidates(dbManager, opts = {}) {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
+ *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
  */
 export class HyperMem {
     dbManager;
@@ -531,7 +531,7 @@ export class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * operator-safe enumeration path. This is the approved archived-context
+     * Operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId, opts) {

package/dist/open-domain.js

@@ -61,7 +61,7 @@ export function buildOpenDomainFtsQuery(query) {
         .split(/\s+/)
         .filter(w => w.length >= 3 && !STOP_WORDS.has(w))
         .slice(0, 6)
-        .map(w => `${w}*`);
+        .map(w => `"${w}"*`);
     if (terms.length === 0)
         return null;
     return terms.join(' OR ');

package/dist/seed.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/seed.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

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. "alice")
- * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1: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. "alice")
- * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1: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:alice:webchat:main',
+ *     parentSessionKey: 'agent:agent1: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:alice:webchat:main',
+ *     parentSessionKey: 'agent:agent1:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/temporal-store.js

@@ -59,11 +59,11 @@ export class TemporalStore {
         const limit = opts.limit ?? 20;
         const order = opts.order ?? 'DESC';
         const minConf = opts.minConfidence ?? 0;
-        const params = [];
+        const params = [minConf];
         const conditions = [
             'f.superseded_by IS NULL',
             'f.decay_score < 0.8',
-            `t.confidence >= ${minConf}`,
+            't.confidence >= ?',
         ];
         if (opts.agentId) {
             conditions.push('t.agent_id = ?');

package/dist/topic-store.js

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