agent-working-memory 0.8.7 → 0.9.0

package/dist/engine/connections.d.ts

@@ -66,5 +66,17 @@ export declare class ConnectionEngine {
      * Find and create connections for a given engram.
      */
     private findConnections;
+    /**
+     * R1 — form entity co-occurrence edges (default-off, `AWM_BROAD_EDGES=1`).
+     *
+     * Extract proper-noun entities from the engram, find other engrams that
+     * literally mention the same entity, and link them at a lower weight than
+     * the semantic edges above. The BM25 candidate is re-checked with a
+     * case-insensitive substring match so a coincidental capitalized word
+     * doesn't create a spurious edge (precision guard); edge weight scales with
+     * the number of shared entities but stays below the 0.7 semantic floor so
+     * semantic links still dominate the graph walk.
+     */
+    private formEntityEdges;
 }
 //# sourceMappingURL=connections.d.ts.map

package/dist/engine/connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../src/engine/connections.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,UAAU,CAAS;gBAGzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,MAAY;IAOzB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;YAM/C,mBAAmB;IAYjC;;;;;;;;OAQG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBnC,mEAAmE;IACnE,SAAS,IAAI,MAAM;IAInB;;OAEG;YACW,eAAe;CAoC9B"}
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../src/engine/connections.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiDxD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,UAAU,CAAS;gBAGzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,MAAY;IAOzB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;YAM/C,mBAAmB;IAYjC;;;;;;;;OAQG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBnC,mEAAmE;IACnE,SAAS,IAAI,MAAM;IAInB;;OAEG;YACW,eAAe;IA2C7B;;;;;;;;;;OAUG;YACW,eAAe;CAgC9B"}

package/dist/engine/connections.js

@@ -22,6 +22,50 @@
  * queued ID. AWM remains cheap to NOT use.
  */
 const COLD_START_THRESHOLD = Number(process.env.AWM_CONNECTION_COLD_START_THRESHOLD ?? 10);
+/**
+ * R1 — broaden edge FORMATION beyond high-cosine semantic links.
+ *
+ * The semantic `activate` path only links engrams at ≥0.7 cosine, so two facts
+ * that share an entity but are lexically/semantically distant ("my main project
+ * is Atlas" vs "Atlas's codename is Magpie") never get an edge — starving the
+ * graph walk / spreading activation of exactly the bridges multi-hop needs.
+ *
+ * When enabled, after the semantic pass we also form *entity co-occurrence*
+ * edges: extract proper-noun entities from the engram, find other engrams that
+ * literally mention the same entity (BM25 + substring re-check for precision),
+ * and link them at a LOWER weight than semantic edges. Recall-only by design —
+ * the edges feed candidate generation; the reranker still makes the final cut.
+ *
+ * Default-OFF (gate per docs/awm-improvement-register.md). Set
+ * `AWM_BROAD_EDGES=1` to enable.
+ */
+const BROAD_EDGES = process.env.AWM_BROAD_EDGES === '1';
+/** Max entity-co-occurrence edges formed per engram (on top of semantic). */
+const MAX_ENTITY_EDGES = Number(process.env.AWM_BROAD_EDGES_MAX ?? 6);
+/** Proper-noun entity extraction — mirrors auto-tagger's `entity:` pattern. */
+const ENTITY_RE = /\b([A-Z][a-z]{2,}(?:\s+[A-Z][a-z]+)*)\b/g;
+/** Common capitalized words that are not useful entity bridges. */
+const ENTITY_STOPWORDS = new Set([
+    'The', 'This', 'That', 'These', 'Those', 'There', 'Then', 'They', 'Them',
+    'And', 'But', 'For', 'With', 'From', 'Into', 'When', 'What', 'Where', 'Which',
+    'While', 'Who', 'Why', 'How', 'Also', 'After', 'Before', 'Because', 'Should',
+    'Would', 'Could', 'Will', 'Was', 'Were', 'Has', 'Have', 'Had', 'Not', 'Now',
+    'New', 'One', 'Two', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday',
+    'Saturday', 'Sunday', 'January', 'February', 'March', 'April', 'June', 'July',
+    'August', 'September', 'October', 'November', 'December',
+]);
+function extractEntities(text) {
+    const out = new Set();
+    for (const m of text.matchAll(ENTITY_RE)) {
+        const name = m[1].trim();
+        if (name.length < 3 || name.length > 40)
+            continue;
+        if (ENTITY_STOPWORDS.has(name))
+            continue;
+        out.add(name);
+    }
+    return [...out];
+}
 export class ConnectionEngine {
     store;
     engine;
@@ -118,6 +162,7 @@ export class ConnectionEngine {
             limit: 5,
             minScore: this.threshold,
             internal: true,
+            spread: false, // edge discovery must not recurse through R2 spreading
         });
         // Filter out self and already-connected engrams
         const existing = await this.store.getAssociationsFor(engram.id);
@@ -131,6 +176,56 @@ export class ConnectionEngine {
             await this.store.upsertAssociation(engram.id, result.engram.id, result.score, 'connection');
             // Bidirectional
             await this.store.upsertAssociation(result.engram.id, engram.id, result.score, 'connection');
+            existingIds.add(result.engram.id);
+        }
+        if (BROAD_EDGES) {
+            await this.formEntityEdges(engram, existingIds);
+        }
+    }
+    /**
+     * R1 — form entity co-occurrence edges (default-off, `AWM_BROAD_EDGES=1`).
+     *
+     * Extract proper-noun entities from the engram, find other engrams that
+     * literally mention the same entity, and link them at a lower weight than
+     * the semantic edges above. The BM25 candidate is re-checked with a
+     * case-insensitive substring match so a coincidental capitalized word
+     * doesn't create a spurious edge (precision guard); edge weight scales with
+     * the number of shared entities but stays below the 0.7 semantic floor so
+     * semantic links still dominate the graph walk.
+     */
+    async formEntityEdges(engram, existingIds) {
+        const entities = extractEntities(`${engram.concept} ${engram.content}`);
+        if (entities.length === 0)
+            return;
+        // Gather candidates that match any of the engram's entities (BM25 OR).
+        const query = entities.slice(0, 6).join(' ');
+        const candidates = await this.store.searchBM25(engram.agentId, query, 20);
+        const lowerEntities = entities.map(e => e.toLowerCase());
+        // Rank candidates by how many of our entities they literally contain.
+        const scored = [];
+        for (const cand of candidates) {
+            if (cand.id === engram.id)
+                continue;
+            if (existingIds.has(cand.id))
+                continue;
+            if (cand.stage !== 'active')
+                continue;
+            const candText = `${cand.concept} ${cand.content}`.toLowerCase();
+            let shared = 0;
+            for (const ent of lowerEntities) {
+                if (candText.includes(ent))
+                    shared++;
+            }
+            if (shared > 0)
+                scored.push({ id: cand.id, engram: cand, shared });
+        }
+        scored.sort((a, b) => b.shared - a.shared);
+        for (const { id, shared } of scored.slice(0, MAX_ENTITY_EDGES)) {
+            // Below the 0.7 semantic floor; more shared entities → stronger edge.
+            const weight = Math.min(0.6, 0.4 + 0.1 * shared);
+            await this.store.upsertAssociation(engram.id, id, weight, 'connection');
+            await this.store.upsertAssociation(id, engram.id, weight, 'connection');
+            existingIds.add(id);
         }
     }
 }

package/dist/engine/connections.js.map

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

package/dist/mcp.js

@@ -77,7 +77,7 @@ import { queryPeerDecisions, formatPeerDecisions } from './coordination/peer-dec
 const INCOGNITO = process.env.AWM_INCOGNITO === '1' || process.env.AWM_INCOGNITO === 'true';
 if (INCOGNITO) {
     console.error('AWM: incognito mode — all memory tools disabled, nothing will be recorded');
-    const server = new McpServer({ name: 'agent-working-memory', version: '0.8.7' });
+    const server = new McpServer({ name: 'agent-working-memory', version: '0.8.8' });
     const transport = new StdioServerTransport();
     server.connect(transport).catch(err => {
         console.error('MCP server failed:', err);
@@ -126,7 +126,7 @@ else {
     let coordDb = null;
     const server = new McpServer({
         name: 'agent-working-memory',
-        version: '0.8.7',
+        version: '0.8.8',
     });
     server.registerResource('awm-overview', 'awm://server/overview', {
         title: 'AWM Overview',

package/dist/storage/pglite-schema.js

@@ -18,148 +18,148 @@
  * PGlite's vector extension does this automatically when imported.
  */
 export const PGLITE_VECTOR_DIMENSIONS = parseInt(process.env.AWM_EMBED_DIMS ?? '384', 10);
-export const PGLITE_SCHEMA_DDL = `
-  CREATE EXTENSION IF NOT EXISTS vector;
-
-  CREATE TABLE IF NOT EXISTS engrams (
-    id                   TEXT PRIMARY KEY,
-    agent_id             TEXT NOT NULL,
-    concept              TEXT NOT NULL,
-    content              TEXT NOT NULL,
-    embedding            VECTOR(${PGLITE_VECTOR_DIMENSIONS}),
-    embedding_model      TEXT,
-    confidence           DOUBLE PRECISION NOT NULL DEFAULT 0.5,
-    salience             DOUBLE PRECISION NOT NULL DEFAULT 0.5,
-    access_count         INTEGER NOT NULL DEFAULT 0,
-    last_accessed        TEXT NOT NULL,
-    created_at           TEXT NOT NULL,
-    salience_features    TEXT NOT NULL DEFAULT '{}',
-    reason_codes         TEXT NOT NULL DEFAULT '[]',
-    stage                TEXT NOT NULL DEFAULT 'active',
-    ttl                  INTEGER,
-    retracted            BOOLEAN NOT NULL DEFAULT FALSE,
-    retracted_by         TEXT,
-    retracted_at         TEXT,
-    tags                 TEXT NOT NULL DEFAULT '[]',
-    memory_type          TEXT NOT NULL DEFAULT 'unclassified',
-    memory_class         TEXT NOT NULL DEFAULT 'working',
-    superseded_by        TEXT,
-    supersedes           TEXT,
-    episode_id           TEXT,
-    task_status          TEXT,
-    task_priority        TEXT,
-    blocked_by           TEXT,
-    sequence             INTEGER,
-    references_json      TEXT,
-    fts                  TSVECTOR
-  );
-
-  CREATE INDEX IF NOT EXISTS idx_engrams_agent           ON engrams(agent_id);
-  CREATE INDEX IF NOT EXISTS idx_engrams_stage           ON engrams(agent_id, stage);
-  CREATE INDEX IF NOT EXISTS idx_engrams_concept         ON engrams(concept);
-  CREATE INDEX IF NOT EXISTS idx_engrams_retracted       ON engrams(agent_id, retracted);
-  CREATE INDEX IF NOT EXISTS idx_engrams_task            ON engrams(agent_id, task_status);
-  CREATE INDEX IF NOT EXISTS idx_engrams_agent_sequence  ON engrams(agent_id, sequence) WHERE sequence IS NOT NULL;
-  CREATE INDEX IF NOT EXISTS idx_engrams_fts             ON engrams USING GIN(fts);
-
-  CREATE INDEX IF NOT EXISTS idx_engrams_embedding
-    ON engrams USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);
-
-  CREATE OR REPLACE FUNCTION engrams_fts_update() RETURNS TRIGGER AS $$
-  BEGIN
-    NEW.fts := to_tsvector('english',
-      COALESCE(NEW.concept, '') || ' ' ||
-      COALESCE(NEW.content, '') || ' ' ||
-      COALESCE(NEW.tags, ''));
-    RETURN NEW;
-  END;
-  $$ LANGUAGE plpgsql;
-
-  DROP TRIGGER IF EXISTS engrams_fts_trigger ON engrams;
-  CREATE TRIGGER engrams_fts_trigger
-    BEFORE INSERT OR UPDATE OF concept, content, tags ON engrams
-    FOR EACH ROW EXECUTE FUNCTION engrams_fts_update();
-
-  CREATE TABLE IF NOT EXISTS associations (
-    id                TEXT PRIMARY KEY,
-    from_engram_id    TEXT NOT NULL REFERENCES engrams(id) ON DELETE CASCADE,
-    to_engram_id      TEXT NOT NULL REFERENCES engrams(id) ON DELETE CASCADE,
-    weight            DOUBLE PRECISION NOT NULL DEFAULT 0.1,
-    confidence        DOUBLE PRECISION NOT NULL DEFAULT 0.5,
-    type              TEXT NOT NULL DEFAULT 'hebbian',
-    activation_count  INTEGER NOT NULL DEFAULT 0,
-    created_at        TEXT NOT NULL,
-    last_activated    TEXT NOT NULL
-  );
-
-  CREATE INDEX IF NOT EXISTS idx_assoc_from        ON associations(from_engram_id);
-  CREATE INDEX IF NOT EXISTS idx_assoc_to          ON associations(to_engram_id);
-  CREATE UNIQUE INDEX IF NOT EXISTS idx_assoc_pair ON associations(from_engram_id, to_engram_id);
-
-  CREATE TABLE IF NOT EXISTS agents (
-    id          TEXT PRIMARY KEY,
-    name        TEXT NOT NULL,
-    created_at  TEXT NOT NULL,
-    config      TEXT NOT NULL DEFAULT '{}'
-  );
-
-  CREATE TABLE IF NOT EXISTS activation_events (
-    id                 TEXT PRIMARY KEY,
-    agent_id           TEXT NOT NULL,
-    timestamp          TEXT NOT NULL,
-    context            TEXT NOT NULL,
-    results_returned   INTEGER NOT NULL,
-    top_score          DOUBLE PRECISION,
-    latency_ms         DOUBLE PRECISION NOT NULL,
-    engram_ids         TEXT NOT NULL DEFAULT '[]'
-  );
-
-  CREATE TABLE IF NOT EXISTS staging_events (
-    engram_id        TEXT NOT NULL,
-    agent_id         TEXT NOT NULL,
-    action           TEXT NOT NULL,
-    resonance_score  DOUBLE PRECISION,
-    timestamp        TEXT NOT NULL,
-    age_ms           INTEGER NOT NULL
-  );
-
-  CREATE TABLE IF NOT EXISTS retrieval_feedback (
-    id                   TEXT PRIMARY KEY,
-    activation_event_id  TEXT,
-    engram_id            TEXT NOT NULL,
-    useful               BOOLEAN NOT NULL,
-    context              TEXT,
-    timestamp            TEXT NOT NULL
-  );
-
-  CREATE TABLE IF NOT EXISTS episodes (
-    id             TEXT PRIMARY KEY,
-    agent_id       TEXT NOT NULL,
-    label          TEXT NOT NULL,
-    embedding      VECTOR(${PGLITE_VECTOR_DIMENSIONS}),
-    engram_count   INTEGER NOT NULL DEFAULT 0,
-    start_time     TEXT NOT NULL,
-    end_time       TEXT NOT NULL,
-    created_at     TEXT NOT NULL
-  );
-
-  CREATE INDEX IF NOT EXISTS idx_episodes_agent ON episodes(agent_id);
-  CREATE INDEX IF NOT EXISTS idx_episodes_time  ON episodes(agent_id, end_time);
-
-  CREATE TABLE IF NOT EXISTS conscious_state (
-    agent_id                            TEXT PRIMARY KEY,
-    last_write_id                       TEXT,
-    last_recall_context                 TEXT,
-    last_recall_ids                     TEXT NOT NULL DEFAULT '[]',
-    last_activity_at                    TEXT NOT NULL DEFAULT (to_char(now() AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')),
-    write_count_since_consolidation     INTEGER NOT NULL DEFAULT 0,
-    recall_count_since_consolidation    INTEGER NOT NULL DEFAULT 0,
-    execution_state                     TEXT,
-    checkpoint_at                       TEXT,
-    last_consolidation_at               TEXT,
-    last_mini_consolidation_at          TEXT,
-    consolidation_cycle_count           INTEGER NOT NULL DEFAULT 0,
-    updated_at                          TEXT NOT NULL DEFAULT (to_char(now() AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'))
-  );
+export const PGLITE_SCHEMA_DDL = `
+  CREATE EXTENSION IF NOT EXISTS vector;
+
+  CREATE TABLE IF NOT EXISTS engrams (
+    id                   TEXT PRIMARY KEY,
+    agent_id             TEXT NOT NULL,
+    concept              TEXT NOT NULL,
+    content              TEXT NOT NULL,
+    embedding            VECTOR(${PGLITE_VECTOR_DIMENSIONS}),
+    embedding_model      TEXT,
+    confidence           DOUBLE PRECISION NOT NULL DEFAULT 0.5,
+    salience             DOUBLE PRECISION NOT NULL DEFAULT 0.5,
+    access_count         INTEGER NOT NULL DEFAULT 0,
+    last_accessed        TEXT NOT NULL,
+    created_at           TEXT NOT NULL,
+    salience_features    TEXT NOT NULL DEFAULT '{}',
+    reason_codes         TEXT NOT NULL DEFAULT '[]',
+    stage                TEXT NOT NULL DEFAULT 'active',
+    ttl                  INTEGER,
+    retracted            BOOLEAN NOT NULL DEFAULT FALSE,
+    retracted_by         TEXT,
+    retracted_at         TEXT,
+    tags                 TEXT NOT NULL DEFAULT '[]',
+    memory_type          TEXT NOT NULL DEFAULT 'unclassified',
+    memory_class         TEXT NOT NULL DEFAULT 'working',
+    superseded_by        TEXT,
+    supersedes           TEXT,
+    episode_id           TEXT,
+    task_status          TEXT,
+    task_priority        TEXT,
+    blocked_by           TEXT,
+    sequence             INTEGER,
+    references_json      TEXT,
+    fts                  TSVECTOR
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_engrams_agent           ON engrams(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_engrams_stage           ON engrams(agent_id, stage);
+  CREATE INDEX IF NOT EXISTS idx_engrams_concept         ON engrams(concept);
+  CREATE INDEX IF NOT EXISTS idx_engrams_retracted       ON engrams(agent_id, retracted);
+  CREATE INDEX IF NOT EXISTS idx_engrams_task            ON engrams(agent_id, task_status);
+  CREATE INDEX IF NOT EXISTS idx_engrams_agent_sequence  ON engrams(agent_id, sequence) WHERE sequence IS NOT NULL;
+  CREATE INDEX IF NOT EXISTS idx_engrams_fts             ON engrams USING GIN(fts);
+
+  CREATE INDEX IF NOT EXISTS idx_engrams_embedding
+    ON engrams USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);
+
+  CREATE OR REPLACE FUNCTION engrams_fts_update() RETURNS TRIGGER AS $$
+  BEGIN
+    NEW.fts := to_tsvector('english',
+      COALESCE(NEW.concept, '') || ' ' ||
+      COALESCE(NEW.content, '') || ' ' ||
+      COALESCE(NEW.tags, ''));
+    RETURN NEW;
+  END;
+  $$ LANGUAGE plpgsql;
+
+  DROP TRIGGER IF EXISTS engrams_fts_trigger ON engrams;
+  CREATE TRIGGER engrams_fts_trigger
+    BEFORE INSERT OR UPDATE OF concept, content, tags ON engrams
+    FOR EACH ROW EXECUTE FUNCTION engrams_fts_update();
+
+  CREATE TABLE IF NOT EXISTS associations (
+    id                TEXT PRIMARY KEY,
+    from_engram_id    TEXT NOT NULL REFERENCES engrams(id) ON DELETE CASCADE,
+    to_engram_id      TEXT NOT NULL REFERENCES engrams(id) ON DELETE CASCADE,
+    weight            DOUBLE PRECISION NOT NULL DEFAULT 0.1,
+    confidence        DOUBLE PRECISION NOT NULL DEFAULT 0.5,
+    type              TEXT NOT NULL DEFAULT 'hebbian',
+    activation_count  INTEGER NOT NULL DEFAULT 0,
+    created_at        TEXT NOT NULL,
+    last_activated    TEXT NOT NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_assoc_from        ON associations(from_engram_id);
+  CREATE INDEX IF NOT EXISTS idx_assoc_to          ON associations(to_engram_id);
+  CREATE UNIQUE INDEX IF NOT EXISTS idx_assoc_pair ON associations(from_engram_id, to_engram_id);
+
+  CREATE TABLE IF NOT EXISTS agents (
+    id          TEXT PRIMARY KEY,
+    name        TEXT NOT NULL,
+    created_at  TEXT NOT NULL,
+    config      TEXT NOT NULL DEFAULT '{}'
+  );
+
+  CREATE TABLE IF NOT EXISTS activation_events (
+    id                 TEXT PRIMARY KEY,
+    agent_id           TEXT NOT NULL,
+    timestamp          TEXT NOT NULL,
+    context            TEXT NOT NULL,
+    results_returned   INTEGER NOT NULL,
+    top_score          DOUBLE PRECISION,
+    latency_ms         DOUBLE PRECISION NOT NULL,
+    engram_ids         TEXT NOT NULL DEFAULT '[]'
+  );
+
+  CREATE TABLE IF NOT EXISTS staging_events (
+    engram_id        TEXT NOT NULL,
+    agent_id         TEXT NOT NULL,
+    action           TEXT NOT NULL,
+    resonance_score  DOUBLE PRECISION,
+    timestamp        TEXT NOT NULL,
+    age_ms           INTEGER NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS retrieval_feedback (
+    id                   TEXT PRIMARY KEY,
+    activation_event_id  TEXT,
+    engram_id            TEXT NOT NULL,
+    useful               BOOLEAN NOT NULL,
+    context              TEXT,
+    timestamp            TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS episodes (
+    id             TEXT PRIMARY KEY,
+    agent_id       TEXT NOT NULL,
+    label          TEXT NOT NULL,
+    embedding      VECTOR(${PGLITE_VECTOR_DIMENSIONS}),
+    engram_count   INTEGER NOT NULL DEFAULT 0,
+    start_time     TEXT NOT NULL,
+    end_time       TEXT NOT NULL,
+    created_at     TEXT NOT NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_episodes_agent ON episodes(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_episodes_time  ON episodes(agent_id, end_time);
+
+  CREATE TABLE IF NOT EXISTS conscious_state (
+    agent_id                            TEXT PRIMARY KEY,
+    last_write_id                       TEXT,
+    last_recall_context                 TEXT,
+    last_recall_ids                     TEXT NOT NULL DEFAULT '[]',
+    last_activity_at                    TEXT NOT NULL DEFAULT (to_char(now() AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')),
+    write_count_since_consolidation     INTEGER NOT NULL DEFAULT 0,
+    recall_count_since_consolidation    INTEGER NOT NULL DEFAULT 0,
+    execution_state                     TEXT,
+    checkpoint_at                       TEXT,
+    last_consolidation_at               TEXT,
+    last_mini_consolidation_at          TEXT,
+    consolidation_cycle_count           INTEGER NOT NULL DEFAULT 0,
+    updated_at                          TEXT NOT NULL DEFAULT (to_char(now() AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'))
+  );
 `;
 //# sourceMappingURL=pglite-schema.js.map