agent-working-memory 0.7.17 → 0.8.5

package/dist/adapters/http.js

@@ -9,28 +9,28 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { AWM_INSTRUCTION_CONTENT, upsertAwmSection } from './common.js';
-const HTTP_ADDENDUM = `
-### HTTP API (for tools without MCP support)
-
-If your tool doesn't support MCP, use the HTTP API directly:
-
-**Base URL:** \`http://127.0.0.1:8400\`
-
-| Method | Endpoint | Purpose |
-|--------|----------|---------|
-| GET | /memory/restore/:agentId | Restore context from prior sessions |
-| POST | /memory/activate | Cognitive recall (use \`context\` field) |
-| POST | /memory/write | Write a memory |
-| POST | /memory/feedback | Report if memory was useful |
-| POST | /memory/retract | Invalidate a wrong memory |
-| POST | /memory/checkpoint | Save execution state |
-| POST | /task/create | Create a task |
-| POST | /task/update | Update task status |
-| GET | /task/list/:agentId | List tasks |
-| GET | /task/next/:agentId | Get next actionable task |
-| GET | /health | Health check |
-
-Start the server with: \`awm serve\`
+const HTTP_ADDENDUM = `
+### HTTP API (for tools without MCP support)
+
+If your tool doesn't support MCP, use the HTTP API directly:
+
+**Base URL:** \`http://127.0.0.1:8400\`
+
+| Method | Endpoint | Purpose |
+|--------|----------|---------|
+| GET | /memory/restore/:agentId | Restore context from prior sessions |
+| POST | /memory/activate | Cognitive recall (use \`context\` field) |
+| POST | /memory/write | Write a memory |
+| POST | /memory/feedback | Report if memory was useful |
+| POST | /memory/retract | Invalidate a wrong memory |
+| POST | /memory/checkpoint | Save execution state |
+| POST | /task/create | Create a task |
+| POST | /task/update | Update task status |
+| GET | /task/list/:agentId | List tasks |
+| GET | /task/next/:agentId | Get next actionable task |
+| GET | /health | Health check |
+
+Start the server with: \`awm serve\`
 `;
 const adapter = {
     id: 'http',

package/dist/api/routes.d.ts

@@ -31,7 +31,7 @@
  *   GET  /health             — health check
  */
 import type { FastifyInstance } from 'fastify';
-import type { EngramStore } from '../storage/sqlite.js';
+import type { IEngramStore as EngramStore } from '../storage/store.js';
 import type { ActivationEngine } from '../engine/activation.js';
 import type { ConnectionEngine } from '../engine/connections.js';
 import type { EvictionEngine } from '../engine/eviction.js';

package/dist/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AASnF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA0oB3E"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AASnF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA04B3E"}

package/dist/api/routes.js

@@ -62,7 +62,21 @@ export function registerRoutes(app, deps) {
             metaTags.push(`sid=${body.sessionId}`);
         if (body.intent)
             metaTags.push(`intent=${body.intent}`);
-        const result = performWrite({ store, connectionEngine }, {
+        // Resolve references (0.8 Cluster D): if matchConcept is given without
+        // matchEngramId, look up the most recent active engram with that concept
+        // (+ optional matchTags) and store both. Stable link survives concept
+        // edits. No match found → store just matchConcept so the intent
+        // (link-to-future or link-to-deleted) is preserved.
+        const resolvedRefs = await Promise.all((body.references ?? []).map(async (ref) => {
+            if (!ref.matchEngramId && ref.matchConcept) {
+                const matched = await store.findActiveMatchByConcept(body.agentId, ref.matchConcept, ref.matchTags);
+                if (matched) {
+                    return { type: ref.type, matchEngramId: matched.id, matchConcept: ref.matchConcept };
+                }
+            }
+            return { type: ref.type, matchEngramId: ref.matchEngramId, matchConcept: ref.matchConcept };
+        }));
+        const result = await performWrite({ store, connectionEngine }, {
             agentId: body.agentId,
             concept: body.concept,
             content: body.content,
@@ -74,10 +88,13 @@ export function registerRoutes(app, deps) {
             causalDepth: body.causalDepth,
             resolutionEffort: body.resolutionEffort,
             confidence: body.confidence,
+            sequence: body.sequence,
+            embed: body.embed,
+            references: resolvedRefs.length > 0 ? resolvedRefs : undefined,
         });
         // Auto-checkpoint always (covers create, reinforce, and supersede).
         try {
-            store.updateAutoCheckpointWrite(body.agentId, result.engram.id);
+            await store.updateAutoCheckpointWrite(body.agentId, result.engram.id);
         }
         catch { /* non-fatal */ }
         if (result.action === 'reinforce') {
@@ -91,29 +108,40 @@ export function registerRoutes(app, deps) {
             });
         }
         // create / supersede paths follow legacy temporal-edge + episode logic.
-        try {
-            const prev = store.getLatestEngram(body.agentId, result.engram.id);
-            if (prev) {
-                store.upsertAssociation(prev.id, result.engram.id, 0.3, 'temporal', 0.8);
-            }
-        }
-        catch { /* Temporal edge creation is non-fatal */ }
-        if (result.salience
-            && (result.salience.disposition === 'active' || result.salience.disposition === 'discard')) {
+        // Structural-class writes (0.8 Cluster A) skip these: they're system-written
+        // event-log records, not conversational beats, so keeping them out of the
+        // temporal graph + episode index keeps cognitive retrieval clean.
+        const isStructural = body.memory_class === 'structural';
+        if (!isStructural) {
             try {
-                let episode = store.getActiveEpisode(body.agentId, 3600_000);
-                if (!episode) {
-                    episode = store.createEpisode({ agentId: body.agentId, label: body.concept });
+                const prev = await store.getLatestEngram(body.agentId, result.engram.id);
+                if (prev) {
+                    await store.upsertAssociation(prev.id, result.engram.id, 0.3, 'temporal', 0.8);
+                }
+            }
+            catch { /* Temporal edge creation is non-fatal */ }
+            if (result.salience
+                && (result.salience.disposition === 'active' || result.salience.disposition === 'discard')) {
+                try {
+                    let episode = await store.getActiveEpisode(body.agentId, 3600_000);
+                    if (!episode) {
+                        episode = await store.createEpisode({ agentId: body.agentId, label: body.concept });
+                    }
+                    await store.addEngramToEpisode(result.engram.id, episode.id);
                 }
-                store.addEngramToEpisode(result.engram.id, episode.id);
+                catch { /* Episode assignment is non-fatal */ }
             }
-            catch { /* Episode assignment is non-fatal */ }
         }
         const isLowSalience = result.salience?.disposition === 'discard';
         return reply.code(201).send({
             stored: true,
             action: result.action,
+            // disposition: legacy field — 'low-salience' is returned for discard so
+            // callers know the engram was kept but marked low-value. The raw inner
+            // salience decision is exposed as `salienceDisposition` for callers
+            // (and tests) that want the unmapped value.
             disposition: isLowSalience ? 'low-salience' : (result.salience?.disposition ?? 'active'),
+            salienceDisposition: result.salience?.disposition ?? null,
             salience: result.salience?.score ?? 0,
             reasonCodes: result.salience?.reasonCodes ?? [],
             engram: result.engram,
@@ -137,7 +165,7 @@ export function registerRoutes(app, deps) {
             const memTags = [...(mem.tags ?? [])];
             if (sid)
                 memTags.push(`sid=${sid}`);
-            const engram = store.createEngram({
+            const engram = await store.createEngram({
                 agentId: body.agentId,
                 concept: mem.concept,
                 content: mem.content,
@@ -148,9 +176,9 @@ export function registerRoutes(app, deps) {
             });
             // Handle supersession inline — archive superseded memory to remove from active pool
             if (mem.supersedes) {
-                store.supersedeEngram(mem.supersedes, engram.id);
-                store.updateConfidence(mem.supersedes, 0.1);
-                store.updateStage(mem.supersedes, 'archived'); // Remove from active search pool
+                await store.supersedeEngram(mem.supersedes, engram.id);
+                await store.updateConfidence(mem.supersedes, 0.1);
+                await store.updateStage(mem.supersedes, 'archived'); // Remove from active search pool
             }
             results.push({ id: engram.id, concept: mem.concept, disposition: 'active' });
         }
@@ -160,13 +188,13 @@ export function registerRoutes(app, deps) {
             const vecs = await embedBatch(texts);
             for (let i = 0; i < vecs.length; i++) {
                 if (results[i]) {
-                    store.updateEmbedding(results[i].id, vecs[i]);
+                    await store.updateEmbedding(results[i].id, vecs[i]);
                 }
             }
         }
         catch { /* Embedding failure is non-fatal */ }
         try {
-            store.updateAutoCheckpointWrite(body.agentId, results[results.length - 1]?.id ?? '');
+            await store.updateAutoCheckpointWrite(body.agentId, results[results.length - 1]?.id ?? '');
         }
         catch { }
         return reply.code(201).send({
@@ -185,33 +213,39 @@ export function registerRoutes(app, deps) {
             useReranker: body.useReranker,
             useExpansion: body.useExpansion,
             abstentionThreshold: body.abstentionThreshold,
+            requireConfidence: body.requireConfidence,
             workspace: body.workspace,
             bm25Only: body.bm25Only,
+            granularity: body.granularity,
         });
         // Auto-checkpoint: track recall for consolidation scheduling
         try {
             const ids = results.map(r => r.engram.id);
-            store.updateAutoCheckpointRecall(body.agentId, body.context, ids);
+            await store.updateAutoCheckpointRecall(body.agentId, body.context, ids);
         }
         catch { /* non-fatal */ }
-        return reply.send({ results });
+        // Surface recall confidence as a top-level field too — same value is on
+        // every result, but it describes the recall as a whole, so exposing it
+        // once is easier for consumers (and lets them inspect 0-result recalls).
+        const confidence = results[0]?.confidence ?? 0;
+        return reply.send({ results, confidence });
     });
     app.post('/memory/feedback', async (req, reply) => {
         const body = req.body;
-        store.logRetrievalFeedback(body.activationEventId ?? null, body.engramId, body.useful, body.context ?? '');
+        await store.logRetrievalFeedback(body.activationEventId ?? null, body.engramId, body.useful, body.context ?? '');
         // Update engram confidence based on feedback
-        const engram = store.getEngram(body.engramId);
+        const engram = await store.getEngram(body.engramId);
         if (engram) {
             const config = DEFAULT_AGENT_CONFIG;
             const delta = body.useful
                 ? config.feedbackPositiveBoost
                 : -config.feedbackNegativePenalty;
-            store.updateConfidence(engram.id, engram.confidence + delta);
+            await store.updateConfidence(engram.id, engram.confidence + delta);
         }
         // Touch activity for consolidation scheduling
         if (engram) {
             try {
-                store.touchActivity(engram.agentId);
+                await store.touchActivity(engram.agentId);
             }
             catch { /* non-fatal */ }
         }
@@ -219,7 +253,7 @@ export function registerRoutes(app, deps) {
     });
     app.post('/memory/retract', async (req, reply) => {
         const body = req.body;
-        const result = retractionEngine.retract({
+        const result = await retractionEngine.retract({
             agentId: body.agentId,
             targetEngramId: body.targetEngramId,
             reason: body.reason,
@@ -227,33 +261,83 @@ export function registerRoutes(app, deps) {
         });
         // Touch activity for consolidation scheduling
         try {
-            store.touchActivity(body.agentId);
+            await store.touchActivity(body.agentId);
         }
         catch { /* non-fatal */ }
         return reply.send(result);
     });
     app.post('/memory/supersede', async (req, reply) => {
         const body = req.body;
-        const oldEngram = store.getEngram(body.oldEngramId);
-        const newEngram = store.getEngram(body.newEngramId);
-        if (!oldEngram)
-            return reply.code(404).send({ error: `Old engram ${body.oldEngramId} not found` });
-        if (!newEngram)
-            return reply.code(404).send({ error: `New engram ${body.newEngramId} not found` });
-        // Create causal association (new → old)
-        store.upsertAssociation(body.newEngramId, body.oldEngramId, 0.8, 'causal', 1.0);
-        // Reduce old engram confidence to 20% (keep for historical reference)
-        store.updateConfidence(body.oldEngramId, oldEngram.confidence * 0.2);
-        // Mark supersession via store method
-        store.supersedeEngram(body.oldEngramId, body.newEngramId);
+        const isFormA = !!(body.oldEngramId && body.newEngramId);
+        const isFormB = !!(body.matchConcept && body.newEngram && body.agentId);
+        if (isFormA && isFormB) {
+            return reply.code(400).send({
+                error: 'Pass either {oldEngramId, newEngramId} (Form A) OR ' +
+                    '{agentId, matchConcept, newEngram} (Form B), not both.',
+            });
+        }
+        if (!isFormA && !isFormB) {
+            return reply.code(400).send({
+                error: 'Missing required fields. Form A: {oldEngramId, newEngramId}. ' +
+                    'Form B: {agentId, matchConcept, newEngram}.',
+            });
+        }
+        // ── Form A — by IDs ──
+        if (isFormA) {
+            const oldEngram = await store.getEngram(body.oldEngramId);
+            const newEngram = await store.getEngram(body.newEngramId);
+            if (!oldEngram)
+                return reply.code(404).send({ error: `Old engram ${body.oldEngramId} not found` });
+            if (!newEngram)
+                return reply.code(404).send({ error: `New engram ${body.newEngramId} not found` });
+            await store.upsertAssociation(body.newEngramId, body.oldEngramId, 0.8, 'causal', 1.0);
+            await store.updateConfidence(body.oldEngramId, oldEngram.confidence * 0.2);
+            await store.supersedeEngram(body.oldEngramId, body.newEngramId);
+            try {
+                await store.touchActivity(oldEngram.agentId);
+            }
+            catch { /* non-fatal */ }
+            return reply.send({
+                superseded: body.oldEngramId,
+                supersededBy: body.newEngramId,
+                reason: body.reason ?? 'outdated',
+            });
+        }
+        // ── Form B — atomic write-and-supersede by concept match ──
+        // Find old (most recent active match by concept + optional tags), write
+        // new engram via performWrite, link them — all in one SQL transaction.
+        // If no match: write new anyway, return { superseded: null }.
+        // AWM 0.8.x P4b follow-up: Form B atomicity via withTransaction.
+        // Holds the SQLite/PGlite lock across the async write + supersede pair
+        // so callers never observe a half-completed state.
+        const result = await store.withTransaction(async () => {
+            const matched = await store.findActiveMatchByConcept(body.agentId, body.matchConcept, body.matchTags);
+            const writeRes = await performWrite({ store, connectionEngine }, {
+                agentId: body.agentId,
+                concept: body.newEngram.concept,
+                content: body.newEngram.content,
+                tags: body.newEngram.tags ?? [],
+                memoryClass: body.newEngram.memory_class,
+                sequence: body.newEngram.sequence,
+                eventType: body.newEngram.eventType,
+                enableReinforcement: false,
+            });
+            if (matched) {
+                await store.upsertAssociation(writeRes.engram.id, matched.id, 0.8, 'causal', 1.0);
+                await store.updateConfidence(matched.id, matched.confidence * 0.2);
+                await store.supersedeEngram(matched.id, writeRes.engram.id);
+            }
+            return { writeRes, matched };
+        });
         try {
-            store.touchActivity(oldEngram.agentId);
+            await store.touchActivity(body.agentId);
         }
         catch { /* non-fatal */ }
-        return reply.send({
-            superseded: body.oldEngramId,
-            supersededBy: body.newEngramId,
-            reason: body.reason ?? 'outdated',
+        return reply.code(201).send({
+            newEngram: result.writeRes.engram,
+            superseded: result.matched ? result.matched.id : null,
+            supersededBy: result.writeRes.engram.id,
+            reason: body.reason ?? 'resolved by concept match',
         });
     });
     // ============================================================
@@ -261,32 +345,122 @@ export function registerRoutes(app, deps) {
     // ============================================================
     app.post('/memory/search', async (req, reply) => {
         const body = req.body;
-        const results = store.search({
+        const results = await store.search({
             agentId: body.agentId,
             text: body.text,
             concept: body.concept,
             tags: body.tags,
+            tagsAll: body.tagsAll,
+            tagsAny: body.tagsAny,
+            tagsNone: body.tagsNone,
             stage: body.stage,
             retracted: body.retracted,
             limit: body.limit,
             offset: body.offset,
+            sortBy: body.sortBy,
+            sortOrder: body.sortOrder,
+        });
+        return reply.send({ results, count: results.length });
+    });
+    // ============================================================
+    // 0.8 Cluster C — materialized-view + atomic-counter endpoints
+    // ============================================================
+    /**
+     * For each distinct value of `tagKey`, return the most recent active
+     * engram. Used by NovelForge for "latest emotional state per character",
+     * "latest motif phase per motif", etc.
+     */
+    app.post('/memory/latest-by-tag', async (req, reply) => {
+        const body = req.body;
+        if (!body.agentId || !body.tagKey) {
+            return reply.code(400).send({ error: 'agentId and tagKey are required' });
+        }
+        const results = await store.getLatestByTag({
+            agentId: body.agentId,
+            tagKeyPrefix: body.tagKey,
+            scopeTagsAll: body.scopeTagsAll,
+            retracted: body.retracted ?? false,
+            sortBy: body.sortBy,
+            limit: body.limit,
         });
         return reply.send({ results, count: results.length });
     });
+    /**
+     * Filter by tag-set operators, sort by numeric value extracted from a
+     * tag prefix, return top N. Used by NovelForge for "top N active
+     * promises by weight".
+     */
+    app.post('/memory/top-by', async (req, reply) => {
+        const body = req.body;
+        if (!body.agentId || !body.sortField) {
+            return reply.code(400).send({ error: 'agentId and sortField are required' });
+        }
+        const results = await store.getTopBy({
+            agentId: body.agentId,
+            sortField: body.sortField,
+            order: body.order ?? 'desc',
+            filterTagsAll: body.filterTagsAll,
+            filterTagsAny: body.filterTagsAny,
+            filterTagsNone: body.filterTagsNone,
+            retracted: body.retracted ?? false,
+            limit: body.limit,
+        });
+        return reply.send({ results, count: results.length });
+    });
+    /**
+     * Compute effective state of an engram from referenced events. Two
+     * targeting modes: by ID, or by concept match (same semantics as Form B's
+     * findActiveMatchByConcept).
+     */
+    app.post('/memory/resolve', async (req, reply) => {
+        const body = req.body;
+        if (!body.agentId) {
+            return reply.code(400).send({ error: 'agentId is required' });
+        }
+        let targetId = body.targetEngramId;
+        if (!targetId && body.matchConcept) {
+            const matched = await store.findActiveMatchByConcept(body.agentId, body.matchConcept, body.matchTags);
+            if (!matched) {
+                return reply.code(404).send({
+                    error: `No active engram matches concept "${body.matchConcept}"`,
+                });
+            }
+            targetId = matched.id;
+        }
+        if (!targetId) {
+            return reply.code(400).send({
+                error: 'Provide either targetEngramId or matchConcept',
+            });
+        }
+        const result = await store.resolveEffectiveState(targetId);
+        if (!result)
+            return reply.code(404).send({ error: `Engram ${targetId} not found` });
+        return reply.send(result);
+    });
+    /**
+     * Race-free next-sequence allocator. Caller writes the engram with the
+     * returned value in `sequence`. Doesn't reserve — concurrent allocations
+     * always serialize via BEGIN IMMEDIATE.
+     */
+    app.get('/memory/sequence/:agentId/next', async (req, reply) => {
+        const { agentId } = req.params;
+        const next = await store.allocateNextSequence(agentId);
+        return reply.send({ agentId, next });
+    });
     app.get('/memory/:id', async (req, reply) => {
         const { id } = req.params;
-        const engram = store.getEngram(id);
+        const engram = await store.getEngram(id);
         if (!engram)
             return reply.code(404).send({ error: 'Not found' });
-        const associations = store.getAssociationsFor(id);
+        const associations = await store.getAssociationsFor(id);
         return reply.send({ engram, associations });
     });
     app.get('/agent/:id/stats', async (req, reply) => {
         const { id } = req.params;
-        const active = store.getEngramsByAgent(id, 'active');
-        const staging = store.getEngramsByAgent(id, 'staging');
-        const retracted = store.getEngramsByAgent(id, undefined, true).filter(e => e.retracted);
-        const associations = store.getAllAssociations(id);
+        const active = await store.getEngramsByAgent(id, 'active');
+        const staging = await store.getEngramsByAgent(id, 'staging');
+        const retracted = (await store.getEngramsByAgent(id, undefined, true)).filter(e => e.retracted);
+        const associations = await store.getAllAssociations(id);
         return reply.send({
             agentId: id,
             engrams: {
@@ -304,7 +478,7 @@ export function registerRoutes(app, deps) {
     app.get('/agent/:id/metrics', async (req, reply) => {
         const { id } = req.params;
         const windowHours = parseInt(req.query.window ?? '24', 10);
-        const metrics = evalEngine.computeMetrics(id, windowHours);
+        const metrics = await evalEngine.computeMetrics(id, windowHours);
         return reply.send({ metrics });
     });
     app.post('/agent/register', async (req, reply) => {
@@ -321,12 +495,12 @@ export function registerRoutes(app, deps) {
     // ============================================================
     app.post('/system/evict', async (req, reply) => {
         const body = req.body;
-        const result = evictionEngine.enforceCapacity(body.agentId, DEFAULT_AGENT_CONFIG);
+        const result = await evictionEngine.enforceCapacity(body.agentId, DEFAULT_AGENT_CONFIG);
         return reply.send(result);
     });
     app.post('/system/decay', async (req, reply) => {
         const body = req.body;
-        const decayed = evictionEngine.decayEdges(body.agentId, body.halfLifeDays);
+        const decayed = await evictionEngine.decayEdges(body.agentId, body.halfLifeDays);
         return reply.send({ edgesDecayed: decayed });
     });
     app.post('/system/consolidate', async (req, reply) => {
@@ -353,7 +527,7 @@ export function registerRoutes(app, deps) {
     });
     app.get('/memory/restore/:agentId', async (req, reply) => {
         const { agentId } = req.params;
-        const checkpoint = store.getCheckpoint(agentId);
+        const checkpoint = await store.getCheckpoint(agentId);
         const now = Date.now();
         const idleMs = checkpoint
             ? now - checkpoint.auto.lastActivityAt.getTime()
@@ -361,7 +535,7 @@ export function registerRoutes(app, deps) {
         // Get last written engram for context
         let lastWrite = null;
         if (checkpoint?.auto.lastWriteId) {
-            const engram = store.getEngram(checkpoint.auto.lastWriteId);
+            const engram = await store.getEngram(checkpoint.auto.lastWriteId);
             if (engram) {
                 lastWrite = { id: engram.id, concept: engram.concept, content: engram.content };
             }
@@ -411,7 +585,7 @@ export function registerRoutes(app, deps) {
     // ============================================================
     app.post('/task/create', async (req, reply) => {
         const body = req.body;
-        const engram = store.createEngram({
+        const engram = await store.createEngram({
             agentId: body.agentId,
             concept: body.concept,
             content: body.content,
@@ -428,32 +602,32 @@ export function registerRoutes(app, deps) {
             blockedBy: body.blockedBy,
         });
         connectionEngine.enqueue(engram.id);
-        embed(`${body.concept} ${body.content}`).then(vec => {
-            store.updateEmbedding(engram.id, vec);
+        embed(`${body.concept} ${body.content}`).then(async (vec) => {
+            await store.updateEmbedding(engram.id, vec);
         }).catch(() => { });
         return reply.send(engram);
     });
     app.post('/task/update', async (req, reply) => {
         const body = req.body;
-        const engram = store.getEngram(body.taskId);
+        const engram = await store.getEngram(body.taskId);
         if (!engram || !engram.taskStatus) {
             return reply.code(404).send({ error: 'Task not found' });
         }
         if (body.blockedBy !== undefined) {
-            store.updateBlockedBy(body.taskId, body.blockedBy);
+            await store.updateBlockedBy(body.taskId, body.blockedBy);
         }
         if (body.status) {
-            store.updateTaskStatus(body.taskId, body.status);
+            await store.updateTaskStatus(body.taskId, body.status);
         }
         if (body.priority) {
-            store.updateTaskPriority(body.taskId, body.priority);
+            await store.updateTaskPriority(body.taskId, body.priority);
         }
-        return reply.send(store.getEngram(body.taskId));
+        return reply.send(await store.getEngram(body.taskId));
     });
     app.get('/task/list/:agentId', async (req, reply) => {
         const { agentId } = req.params;
         const { status, includeDone } = req.query;
-        let tasks = store.getTasks(agentId, status);
+        let tasks = await store.getTasks(agentId, status);
         if (includeDone !== 'true' && !status) {
             tasks = tasks.filter(t => t.taskStatus !== 'done');
         }
@@ -461,24 +635,29 @@ export function registerRoutes(app, deps) {
     });
     app.get('/task/next/:agentId', async (req, reply) => {
         const { agentId } = req.params;
-        const next = store.getNextTask(agentId);
+        const next = await store.getNextTask(agentId);
         return reply.send(next ? { task: next } : { task: null, message: 'No actionable tasks' });
     });
     // Time warp — shift all timestamps backward by N days (for testing)
     app.post('/system/time-warp', async (req, reply) => {
         const body = req.body;
         const ms = body.days * 24 * 60 * 60 * 1000;
-        const shifted = store.timeWarp(body.agentId, ms);
+        const shifted = await store.timeWarp(body.agentId, ms);
         return reply.send({ shifted, days: body.days });
     });
     // ─── Export ─────────────────────────────────────────────────────────────
     app.get('/memory/export', async (req, reply) => {
         const { agentId, all } = req.query;
         const includeAll = all === 'true';
+        // /memory/export uses raw SQL — SQLite-only. On PGlite, callers should use
+        // the awm CLI export/merge tools instead.
+        if (typeof store.getDb !== 'function') {
+            return reply.code(501).send({ error: 'export endpoint requires the SQLite backend' });
+        }
         const db = store.getDb();
-        let engramSql = `SELECT id, agent_id, concept, content, confidence, salience, access_count,
-      last_accessed, created_at, salience_features, reason_codes, stage, ttl,
-      retracted, retracted_by, retracted_at, tags
+        let engramSql = `SELECT id, agent_id, concept, content, confidence, salience, access_count,
+      last_accessed, created_at, salience_features, reason_codes, stage, ttl,
+      retracted, retracted_by, retracted_at, tags
       FROM engrams`;
         const conditions = [];
         const params = [];
@@ -496,7 +675,7 @@ export function registerRoutes(app, deps) {
         engramSql += ' ORDER BY created_at ASC';
         const engrams = db.prepare(engramSql).all(...params);
         const engramIds = new Set(engrams.map(e => e.id));
-        const allAssocs = db.prepare(`SELECT id, from_engram_id, to_engram_id, weight, confidence, type, activation_count, created_at, last_activated
+        const allAssocs = db.prepare(`SELECT id, from_engram_id, to_engram_id, weight, confidence, type, activation_count, created_at, last_activated
        FROM associations`).all();
         const associations = allAssocs.filter(a => engramIds.has(a.from_engram_id) && engramIds.has(a.to_engram_id));
         return reply.send({
@@ -515,15 +694,15 @@ export function registerRoutes(app, deps) {
         const base = {
             status: 'ok',
             timestamp: new Date().toISOString(),
-            version: '0.7.17',
+            version: '0.8.5',
             coordination: coordEnabled,
         };
-        if (coordEnabled) {
+        if (coordEnabled && typeof deps.store.getDb === 'function') {
             try {
                 const db = deps.store.getDb();
-                const stats = db.prepare(`SELECT
-          (SELECT COUNT(*) FROM coord_agents WHERE status != 'dead') AS agents_alive,
-          (SELECT COUNT(*) FROM coord_assignments WHERE status = 'pending') AS pending_tasks,
+                const stats = db.prepare(`SELECT
+          (SELECT COUNT(*) FROM coord_agents WHERE status != 'dead') AS agents_alive,
+          (SELECT COUNT(*) FROM coord_assignments WHERE status = 'pending') AS pending_tasks,
           (SELECT COUNT(*) FROM coord_locks) AS active_locks`).get();
                 Object.assign(base, stats);
             }