@engram-mem/supabase 0.1.0

package/dist/digests.js

@@ -0,0 +1,154 @@
+import { generateId } from '@engram-mem/core';
+import { sanitizeIlike } from './search.js';
+export class SupabaseDigestStorage {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async insert(digest) {
+        const id = generateId();
+        // Insert into memories table first (FK requirement)
+        const { error: memErr } = await this.client
+            .from('memories')
+            .insert({ id, type: 'digest' });
+        if (memErr)
+            throw new Error(`Digest memory insert failed: ${memErr.message}`);
+        const { data, error } = await this.client
+            .from('memory_digests')
+            .insert({
+            id,
+            session_id: digest.sessionId,
+            summary: digest.summary,
+            key_topics: digest.keyTopics,
+            source_episode_ids: digest.sourceEpisodeIds,
+            source_digest_ids: digest.sourceDigestIds,
+            level: digest.level,
+            embedding: digest.embedding ?? null,
+            metadata: digest.metadata,
+        })
+            .select()
+            .single();
+        if (error)
+            throw new Error(`Digest insert failed: ${error.message}`);
+        return rowToDigest(data);
+    }
+    async search(query, opts) {
+        const limit = opts?.limit ?? 10;
+        const embedding = opts?.embedding;
+        if (embedding) {
+            // Prefer hybrid RRF search when query text is also available
+            if (query) {
+                const { data, error } = await this.client.rpc('engram_hybrid_recall', {
+                    p_query_text: query,
+                    p_query_embedding: JSON.stringify(embedding),
+                    p_match_count: limit,
+                    p_include_episodes: false,
+                    p_include_digests: true,
+                    p_include_semantic: false,
+                    p_include_procedural: false,
+                });
+                if (error)
+                    throw new Error(`Digest search (hybrid) failed: ${error.message}`);
+                const rows = (data ?? []);
+                const RRF_MAX = 2.0 / 61.0;
+                return rows.map((r) => ({
+                    item: recallRowToDigest(r),
+                    similarity: Math.min(1.0, (r.similarity || 0) / RRF_MAX),
+                }));
+            }
+            // Embedding only — fall back to pure vector search
+            const { data, error } = await this.client.rpc('engram_recall', {
+                p_query_embedding: embedding,
+                p_session_id: null,
+                p_match_count: limit,
+                p_min_similarity: opts?.minScore ?? 0.15,
+                p_include_episodes: false,
+                p_include_digests: true,
+                p_include_semantic: false,
+                p_include_procedural: false,
+            });
+            if (error)
+                throw new Error(`Digest search (vector) failed: ${error.message}`);
+            const rows = (data ?? []);
+            return rows.map((r) => ({
+                item: recallRowToDigest(r),
+                similarity: r.similarity,
+            }));
+        }
+        // Text fallback
+        const { data, error } = await this.client
+            .from('memory_digests')
+            .select('*')
+            .ilike('summary', `%${sanitizeIlike(query)}%`)
+            .limit(limit);
+        if (error)
+            throw new Error(`Digest search (text) failed: ${error.message}`);
+        return (data ?? []).map((r) => ({
+            item: rowToDigest(r),
+            similarity: 0.5,
+        }));
+    }
+    async getBySession(sessionId) {
+        const { data, error } = await this.client
+            .from('memory_digests')
+            .select('*')
+            .eq('session_id', sessionId)
+            .order('created_at', { ascending: true });
+        if (error)
+            throw new Error(`Digest getBySession failed: ${error.message}`);
+        return (data ?? []).map(rowToDigest);
+    }
+    async getRecent(days) {
+        const since = new Date(Date.now() - days * 86400000).toISOString();
+        const { data, error } = await this.client
+            .from('memory_digests')
+            .select('*')
+            .gte('created_at', since)
+            .order('created_at', { ascending: false });
+        if (error)
+            throw new Error(`Digest getRecent failed: ${error.message}`);
+        return (data ?? []).map(rowToDigest);
+    }
+    async getCountBySession() {
+        const { data, error } = await this.client
+            .from('memory_digests')
+            .select('session_id');
+        if (error)
+            throw new Error(`Digest getCountBySession failed: ${error.message}`);
+        const rows = (data ?? []);
+        const counts = {};
+        for (const row of rows) {
+            counts[row.session_id] = (counts[row.session_id] ?? 0) + 1;
+        }
+        return counts;
+    }
+}
+function rowToDigest(row) {
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        summary: row.summary,
+        keyTopics: row.key_topics ?? [],
+        sourceEpisodeIds: row.source_episode_ids ?? [],
+        sourceDigestIds: row.source_digest_ids ?? [],
+        level: row.level,
+        embedding: row.embedding ?? null,
+        metadata: row.metadata ?? {},
+        createdAt: new Date(row.created_at),
+    };
+}
+function recallRowToDigest(row) {
+    return {
+        id: row.id,
+        sessionId: '',
+        summary: row.content,
+        keyTopics: row.entities ?? [],
+        sourceEpisodeIds: [],
+        sourceDigestIds: [],
+        level: 0,
+        embedding: null,
+        metadata: {},
+        createdAt: new Date(row.created_at),
+    };
+}
+//# sourceMappingURL=digests.js.map

package/dist/digests.js.map

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

package/dist/episodes.d.ts

@@ -0,0 +1,25 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+import type { Episode, SearchOptions, SearchResult } from '@engram-mem/core';
+import type { EpisodeStorage } from '@engram-mem/core';
+export declare class SupabaseEpisodeStorage implements EpisodeStorage {
+    private readonly client;
+    private readonly legacyMode;
+    /**
+     * @param legacyMode When true, skip the memories pool table insert and
+     *   omit columns that don't exist in the legacy schema (salience, entities,
+     *   access_count, etc.). Legacy mode is detected automatically by the adapter
+     *   and used until migrations 004-007 are applied.
+     */
+    constructor(client: SupabaseClient, legacyMode?: boolean);
+    insert(episode: Omit<Episode, 'id' | 'createdAt'>): Promise<Episode>;
+    search(query: string, opts?: SearchOptions): Promise<SearchResult<Episode>[]>;
+    getByIds(ids: string[]): Promise<Episode[]>;
+    getBySession(sessionId: string, opts?: {
+        since?: Date;
+    }): Promise<Episode[]>;
+    getUnconsolidated(sessionId: string): Promise<Episode[]>;
+    getUnconsolidatedSessions(): Promise<string[]>;
+    markConsolidated(ids: string[]): Promise<void>;
+    recordAccess(id: string): Promise<void>;
+}
+//# sourceMappingURL=episodes.d.ts.map

package/dist/episodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodes.d.ts","sourceRoot":"","sources":["../src/episodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD,qBAAa,sBAAuB,YAAW,cAAc;IAQzD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B;;;;;OAKG;gBAEgB,MAAM,EAAE,cAAc,EACtB,UAAU,GAAE,OAAe;IAGxC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA4CpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IAyF7E,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAU3C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB5E,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgBxD,yBAAyB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAW9C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ9C"}

package/dist/episodes.js

@@ -0,0 +1,260 @@
+import { generateId } from '@engram-mem/core';
+import { sanitizeIlike } from './search.js';
+export class SupabaseEpisodeStorage {
+    client;
+    legacyMode;
+    /**
+     * @param legacyMode When true, skip the memories pool table insert and
+     *   omit columns that don't exist in the legacy schema (salience, entities,
+     *   access_count, etc.). Legacy mode is detected automatically by the adapter
+     *   and used until migrations 004-007 are applied.
+     */
+    constructor(client, legacyMode = false) {
+        this.client = client;
+        this.legacyMode = legacyMode;
+    }
+    async insert(episode) {
+        const id = generateId();
+        if (!this.legacyMode) {
+            // Insert into memories table first (FK requirement — full schema only)
+            const { error: memErr } = await this.client
+                .from('memories')
+                .insert({ id, type: 'episode' });
+            if (memErr)
+                throw new Error(`Episode memory insert failed: ${memErr.message}`);
+        }
+        // Build the row — legacy schema only has: id, session_id, role, content,
+        // embedding, metadata, created_at. Full schema adds salience, access_count,
+        // last_accessed, consolidated_at, entities, searchable_content.
+        const searchableContent = episode.metadata?.searchableContent ?? null;
+        const row = {
+            id,
+            session_id: episode.sessionId,
+            role: episode.role,
+            content: episode.content,
+            embedding: episode.embedding ?? null,
+            metadata: episode.metadata,
+        };
+        if (!this.legacyMode) {
+            row.salience = episode.salience;
+            row.access_count = episode.accessCount;
+            row.last_accessed = episode.lastAccessed?.toISOString() ?? null;
+            row.consolidated_at = episode.consolidatedAt?.toISOString() ?? null;
+            row.entities = episode.entities;
+            row.searchable_content = searchableContent;
+        }
+        const { data, error } = await this.client
+            .from('memory_episodes')
+            .insert(row)
+            .select()
+            .single();
+        if (error)
+            throw new Error(`Episode insert failed: ${error.message}`);
+        return rowToEpisode(data, this.legacyMode);
+    }
+    async search(query, opts) {
+        const limit = opts?.limit ?? 10;
+        const embedding = opts?.embedding;
+        if (embedding) {
+            if (this.legacyMode) {
+                // Legacy schema: use the old match_episodes RPC
+                // Format embedding as '[x,y,z]' string (legacy RPC accepts text)
+                const embStr = `[${embedding.join(',')}]`;
+                const { data, error } = await this.client.rpc('match_episodes', {
+                    query_embedding: embStr,
+                    filter_session_id: opts?.sessionId ?? null,
+                    match_count: limit,
+                    min_similarity: opts?.minScore ?? 0.15,
+                });
+                if (error)
+                    throw new Error(`Episode search (legacy vector) failed: ${error.message}`);
+                const rows = (data ?? []);
+                return rows.map((r) => ({
+                    item: legacyRowToEpisode(r),
+                    similarity: r.similarity,
+                }));
+            }
+            // Full schema: prefer hybrid RRF search when query text is also available
+            if (query) {
+                const { data, error } = await this.client.rpc('engram_hybrid_recall', {
+                    p_query_text: query,
+                    p_query_embedding: JSON.stringify(embedding),
+                    p_match_count: limit,
+                    p_session_id: opts?.sessionId ?? null,
+                    p_include_episodes: true,
+                    p_include_digests: false,
+                    p_include_semantic: false,
+                    p_include_procedural: false,
+                });
+                if (error)
+                    throw new Error(`Episode search (hybrid) failed: ${error.message}`);
+                const rows = (data ?? []);
+                // RRF scores are in ~0.001-0.033 range (1/(k+rank) * weight).
+                // Normalize to 0-1 by dividing by theoretical max (both searches rank #1).
+                // With k=60, max = 1/61 * 1.0 + 1/61 * 1.0 ≈ 0.0328
+                const RRF_MAX = 2.0 / 61.0;
+                return rows.map((r) => ({
+                    item: recallRowToEpisode(r),
+                    similarity: Math.min(1.0, (r.similarity || 0) / RRF_MAX),
+                }));
+            }
+            // Embedding only — fall back to pure vector search
+            const { data, error } = await this.client.rpc('engram_recall', {
+                p_query_embedding: embedding,
+                p_session_id: opts?.sessionId ?? null,
+                p_match_count: limit,
+                p_min_similarity: opts?.minScore ?? 0.15,
+                p_include_episodes: true,
+                p_include_digests: false,
+                p_include_semantic: false,
+                p_include_procedural: false,
+            });
+            if (error)
+                throw new Error(`Episode search (vector) failed: ${error.message}`);
+            const rows = (data ?? []);
+            return rows.map((r) => ({
+                item: recallRowToEpisode(r),
+                similarity: r.similarity,
+            }));
+        }
+        // Text fallback via ilike — works on both legacy and full schema
+        let queryBuilder = this.client
+            .from('memory_episodes')
+            .select('*')
+            .ilike('content', `%${sanitizeIlike(query)}%`)
+            .limit(limit);
+        if (opts?.sessionId) {
+            queryBuilder = queryBuilder.eq('session_id', opts.sessionId);
+        }
+        const { data, error } = await queryBuilder;
+        if (error)
+            throw new Error(`Episode search (text) failed: ${error.message}`);
+        const rows = (data ?? []);
+        return rows.map((r) => ({
+            item: rowToEpisode(r, this.legacyMode),
+            similarity: 0.5,
+        }));
+    }
+    async getByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const { data, error } = await this.client
+            .from('memory_episodes')
+            .select('*')
+            .in('id', ids);
+        if (error)
+            throw new Error(`Episode getByIds failed: ${error.message}`);
+        return (data ?? []).map((r) => rowToEpisode(r, this.legacyMode));
+    }
+    async getBySession(sessionId, opts) {
+        let queryBuilder = this.client
+            .from('memory_episodes')
+            .select('*')
+            .eq('session_id', sessionId)
+            .order('created_at', { ascending: true });
+        if (opts?.since) {
+            queryBuilder = queryBuilder.gte('created_at', opts.since.toISOString());
+        }
+        const { data, error } = await queryBuilder;
+        if (error)
+            throw new Error(`Episode getBySession failed: ${error.message}`);
+        return (data ?? []).map((r) => rowToEpisode(r, this.legacyMode));
+    }
+    async getUnconsolidated(sessionId) {
+        if (this.legacyMode) {
+            // Legacy schema lacks consolidated_at and salience — return all unprocessed
+            // episodes for the session (consolidation is a no-op in legacy mode)
+            return [];
+        }
+        const { data, error } = await this.client
+            .from('memory_episodes')
+            .select('*')
+            .eq('session_id', sessionId)
+            .is('consolidated_at', null)
+            .order('salience', { ascending: false });
+        if (error)
+            throw new Error(`Episode getUnconsolidated failed: ${error.message}`);
+        return (data ?? []).map((r) => rowToEpisode(r, false));
+    }
+    async getUnconsolidatedSessions() {
+        if (this.legacyMode)
+            return [];
+        const { data, error } = await this.client
+            .from('memory_episodes')
+            .select('session_id')
+            .is('consolidated_at', null);
+        if (error)
+            throw new Error(`Episode getUnconsolidatedSessions failed: ${error.message}`);
+        const rows = (data ?? []);
+        return [...new Set(rows.map((r) => r.session_id))];
+    }
+    async markConsolidated(ids) {
+        if (ids.length === 0 || this.legacyMode)
+            return;
+        const { error } = await this.client
+            .from('memory_episodes')
+            .update({ consolidated_at: new Date().toISOString() })
+            .in('id', ids);
+        if (error)
+            throw new Error(`Episode markConsolidated failed: ${error.message}`);
+    }
+    async recordAccess(id) {
+        if (this.legacyMode)
+            return; // no access tracking in legacy schema
+        const { error } = await this.client.rpc('engram_record_access', {
+            p_id: id,
+            p_memory_type: 'episode',
+        });
+        if (error)
+            throw new Error(`Episode recordAccess failed: ${error.message}`);
+    }
+}
+function rowToEpisode(row, legacyMode = false) {
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        role: row.role,
+        content: row.content,
+        salience: legacyMode ? 0.3 : (row.salience ?? 0.3),
+        accessCount: legacyMode ? 0 : (row.access_count ?? 0),
+        lastAccessed: legacyMode ? null : (row.last_accessed ? new Date(row.last_accessed) : null),
+        consolidatedAt: legacyMode ? null : (row.consolidated_at ? new Date(row.consolidated_at) : null),
+        embedding: row.embedding ?? null,
+        entities: legacyMode ? [] : (row.entities ?? []),
+        metadata: row.metadata ?? {},
+        createdAt: new Date(row.created_at),
+    };
+}
+function legacyRowToEpisode(row) {
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        role: row.role,
+        content: row.content,
+        salience: 0.3,
+        accessCount: 0,
+        lastAccessed: null,
+        consolidatedAt: null,
+        embedding: null,
+        entities: [],
+        metadata: row.metadata ?? {},
+        createdAt: new Date(row.created_at),
+    };
+}
+function recallRowToEpisode(row) {
+    return {
+        id: row.id,
+        sessionId: '',
+        role: 'user',
+        content: row.content,
+        salience: row.salience,
+        accessCount: row.access_count,
+        lastAccessed: null,
+        consolidatedAt: null,
+        embedding: null,
+        entities: row.entities ?? [],
+        metadata: {},
+        createdAt: new Date(row.created_at),
+    };
+}
+//# sourceMappingURL=episodes.js.map

package/dist/episodes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { SupabaseStorageAdapter } from './adapter.js';
+export type { SupabaseAdapterOptions } from './adapter.js';
+export { getMigrationSQL, MIGRATION_004, MIGRATION_005, MIGRATION_006, MIGRATION_007 } from './migrations.js';
+import { SupabaseStorageAdapter } from './adapter.js';
+export declare function supabaseAdapter(opts: {
+    url: string;
+    key: string;
+    embeddingDimensions?: number;
+}): SupabaseStorageAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE7G,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,0BAE/F"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SupabaseStorageAdapter } from './adapter.js';
+export { getMigrationSQL, MIGRATION_004, MIGRATION_005, MIGRATION_006, MIGRATION_007 } from './migrations.js';
+import { SupabaseStorageAdapter } from './adapter.js';
+export function supabaseAdapter(opts) {
+    return new SupabaseStorageAdapter(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE7G,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,UAAU,eAAe,CAAC,IAAgE;IAC9F,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAA;AACzC,CAAC"}

package/dist/migrations.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Migration 004: Add Engram columns to existing tables and rename memory_knowledge.
+ * Applies on top of the legacy 001–003 migrations (initial schema, search functions,
+ * enable RLS).
+ */
+export declare const MIGRATION_004 = "\n-- Migration 004: Engram v1 \u2014 extend existing tables\n-- Run this after 001_initial_schema, 002_search_functions, 003_enable_rls\n\n-- Add missing columns to memory_episodes\nALTER TABLE memory_episodes\n  ADD COLUMN IF NOT EXISTS salience       real         NOT NULL DEFAULT 0.3\n    CHECK (salience >= 0.0 AND salience <= 1.0),\n  ADD COLUMN IF NOT EXISTS access_count   integer      NOT NULL DEFAULT 0,\n  ADD COLUMN IF NOT EXISTS last_accessed  timestamptz,\n  ADD COLUMN IF NOT EXISTS consolidated_at timestamptz,\n  ADD COLUMN IF NOT EXISTS entities       text[]       NOT NULL DEFAULT '{}';\n\n-- Add missing columns to memory_digests\nALTER TABLE memory_digests\n  ADD COLUMN IF NOT EXISTS source_digest_ids uuid[]   NOT NULL DEFAULT '{}',\n  ADD COLUMN IF NOT EXISTS level             integer  NOT NULL DEFAULT 0\n    CHECK (level >= 0 AND level <= 10);\n\n-- Rename memory_knowledge -> memory_semantic (catalog-only, instantaneous)\n-- Skip if already renamed\nDO $$\nBEGIN\n  IF EXISTS (\n    SELECT 1 FROM information_schema.tables\n    WHERE table_schema = 'public' AND table_name = 'memory_knowledge'\n  ) AND NOT EXISTS (\n    SELECT 1 FROM information_schema.tables\n    WHERE table_schema = 'public' AND table_name = 'memory_semantic'\n  ) THEN\n    ALTER TABLE memory_knowledge RENAME TO memory_semantic;\n  END IF;\nEND $$;\n\n-- Add missing columns to memory_semantic\nALTER TABLE memory_semantic\n  ADD COLUMN IF NOT EXISTS source_episode_ids uuid[]      NOT NULL DEFAULT '{}',\n  ADD COLUMN IF NOT EXISTS decay_rate         real        NOT NULL DEFAULT 0.02\n    CHECK (decay_rate > 0.0 AND decay_rate <= 1.0),\n  ADD COLUMN IF NOT EXISTS supersedes         uuid        REFERENCES memories(id),\n  ADD COLUMN IF NOT EXISTS superseded_by      uuid        REFERENCES memories(id),\n  ADD COLUMN IF NOT EXISTS updated_at         timestamptz NOT NULL DEFAULT now();\n\n-- Record migration\nINSERT INTO schema_migrations (version, checksum)\nVALUES ('004_engram_v1', md5('004'))\nON CONFLICT DO NOTHING;\n";
+/**
+ * Migration 005: Create new tables — memories pool, memory_procedural,
+ * memory_associations, consolidation_runs, sensory_snapshots.
+ */
+export declare const MIGRATION_005 = "\n-- Migration 005: New Engram tables\n\n-- Enable required extensions\nCREATE EXTENSION IF NOT EXISTS vector;\nCREATE EXTENSION IF NOT EXISTS pg_trgm;\n\n-- Memory ID Pool (base table for FK integrity across all memory types)\nCREATE TABLE IF NOT EXISTS memories (\n  id          uuid  PRIMARY KEY DEFAULT gen_random_uuid(),\n  type        text  NOT NULL\n              CHECK (type IN ('episode', 'digest', 'semantic', 'procedural')),\n  created_at  timestamptz NOT NULL DEFAULT now()\n);\n\n-- Episodic Memory (full schema \u2014 idempotent)\nCREATE TABLE IF NOT EXISTS memory_episodes (\n  id               uuid        PRIMARY KEY REFERENCES memories(id),\n  session_id       text        NOT NULL,\n  role             text        NOT NULL\n                   CHECK (role IN ('user', 'assistant', 'system')),\n  content          text        NOT NULL,\n  salience         real        NOT NULL DEFAULT 0.3\n                   CHECK (salience >= 0.0 AND salience <= 1.0),\n  access_count     integer     NOT NULL DEFAULT 0,\n  last_accessed    timestamptz,\n  consolidated_at  timestamptz,\n  embedding        vector(1536),\n  entities         text[]      NOT NULL DEFAULT '{}',\n  metadata         jsonb       NOT NULL DEFAULT '{}',\n  created_at       timestamptz NOT NULL DEFAULT now()\n);\n\nCREATE INDEX IF NOT EXISTS idx_episodes_session\n  ON memory_episodes(session_id);\nCREATE INDEX IF NOT EXISTS idx_episodes_unconsolidated\n  ON memory_episodes(session_id, salience DESC)\n  WHERE consolidated_at IS NULL;\nCREATE INDEX IF NOT EXISTS idx_episodes_created\n  ON memory_episodes(created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_episodes_last_accessed\n  ON memory_episodes(last_accessed)\n  WHERE last_accessed IS NOT NULL;\nCREATE INDEX IF NOT EXISTS idx_episodes_entities\n  ON memory_episodes USING GIN(entities);\nCREATE INDEX IF NOT EXISTS idx_episodes_content_trgm\n  ON memory_episodes USING GIN(content gin_trgm_ops);\n\n-- Digest Layer\nCREATE TABLE IF NOT EXISTS memory_digests (\n  id                   uuid        PRIMARY KEY REFERENCES memories(id),\n  session_id           text        NOT NULL,\n  summary              text        NOT NULL,\n  key_topics           text[]      NOT NULL DEFAULT '{}',\n  source_episode_ids   uuid[]      NOT NULL DEFAULT '{}',\n  source_digest_ids    uuid[]      NOT NULL DEFAULT '{}',\n  level                integer     NOT NULL DEFAULT 0\n                       CHECK (level >= 0 AND level <= 10),\n  embedding            vector(1536),\n  metadata             jsonb       NOT NULL DEFAULT '{}',\n  created_at           timestamptz NOT NULL DEFAULT now()\n);\n\nCREATE INDEX IF NOT EXISTS idx_digests_session\n  ON memory_digests(session_id);\nCREATE INDEX IF NOT EXISTS idx_digests_created\n  ON memory_digests(created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_digests_topics\n  ON memory_digests USING GIN(key_topics);\nCREATE INDEX IF NOT EXISTS idx_digests_source_episodes\n  ON memory_digests USING GIN(source_episode_ids);\n\n-- Semantic Memory\nCREATE TABLE IF NOT EXISTS memory_semantic (\n  id                  uuid        PRIMARY KEY REFERENCES memories(id),\n  topic               text        NOT NULL,\n  content             text        NOT NULL,\n  confidence          real        NOT NULL DEFAULT 0.5\n                      CHECK (confidence >= 0.0 AND confidence <= 1.0),\n  source_digest_ids   uuid[]      NOT NULL DEFAULT '{}',\n  source_episode_ids  uuid[]      NOT NULL DEFAULT '{}',\n  access_count        integer     NOT NULL DEFAULT 0,\n  last_accessed       timestamptz,\n  decay_rate          real        NOT NULL DEFAULT 0.02\n                      CHECK (decay_rate > 0.0 AND decay_rate <= 1.0),\n  supersedes          uuid        REFERENCES memories(id),\n  superseded_by       uuid        REFERENCES memories(id),\n  embedding           vector(1536),\n  metadata            jsonb       NOT NULL DEFAULT '{}',\n  created_at          timestamptz NOT NULL DEFAULT now(),\n  updated_at          timestamptz NOT NULL DEFAULT now()\n);\n\nCREATE INDEX IF NOT EXISTS idx_semantic_topic\n  ON memory_semantic(topic);\nCREATE INDEX IF NOT EXISTS idx_semantic_confidence\n  ON memory_semantic(confidence DESC)\n  WHERE superseded_by IS NULL;\nCREATE INDEX IF NOT EXISTS idx_semantic_last_accessed\n  ON memory_semantic(last_accessed);\nCREATE INDEX IF NOT EXISTS idx_semantic_created\n  ON memory_semantic(created_at DESC);\n\nCREATE OR REPLACE FUNCTION update_updated_at_column()\nRETURNS TRIGGER LANGUAGE plpgsql AS $$\nBEGIN\n  NEW.updated_at = now();\n  RETURN NEW;\nEND;\n$$;\n\nDO $$\nBEGIN\n  IF NOT EXISTS (\n    SELECT 1 FROM pg_trigger WHERE tgname = 'semantic_updated_at'\n  ) THEN\n    CREATE TRIGGER semantic_updated_at\n    BEFORE UPDATE ON memory_semantic\n    FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();\n  END IF;\nEND $$;\n\n-- Procedural Memory\nCREATE TABLE IF NOT EXISTS memory_procedural (\n  id                  uuid        PRIMARY KEY REFERENCES memories(id),\n  category            text        NOT NULL\n                      CHECK (category IN ('workflow', 'preference', 'habit', 'pattern', 'convention')),\n  trigger_text        text        NOT NULL,\n  procedure           text        NOT NULL,\n  confidence          real        NOT NULL DEFAULT 0.5\n                      CHECK (confidence >= 0.0 AND confidence <= 1.0),\n  observation_count   integer     NOT NULL DEFAULT 1,\n  last_observed       timestamptz NOT NULL DEFAULT now(),\n  first_observed      timestamptz NOT NULL DEFAULT now(),\n  access_count        integer     NOT NULL DEFAULT 0,\n  last_accessed       timestamptz,\n  decay_rate          real        NOT NULL DEFAULT 0.01\n                      CHECK (decay_rate > 0.0 AND decay_rate <= 1.0),\n  source_episode_ids  uuid[]      NOT NULL DEFAULT '{}',\n  embedding           vector(1536),\n  metadata            jsonb       NOT NULL DEFAULT '{}',\n  created_at          timestamptz NOT NULL DEFAULT now(),\n  updated_at          timestamptz NOT NULL DEFAULT now()\n);\n\nCREATE INDEX IF NOT EXISTS idx_procedural_category\n  ON memory_procedural(category);\nCREATE INDEX IF NOT EXISTS idx_procedural_confidence\n  ON memory_procedural(confidence DESC);\nCREATE INDEX IF NOT EXISTS idx_procedural_last_accessed\n  ON memory_procedural(last_accessed);\nCREATE INDEX IF NOT EXISTS idx_procedural_created\n  ON memory_procedural(created_at DESC);\n\nDO $$\nBEGIN\n  IF NOT EXISTS (\n    SELECT 1 FROM pg_trigger WHERE tgname = 'procedural_updated_at'\n  ) THEN\n    CREATE TRIGGER procedural_updated_at\n    BEFORE UPDATE ON memory_procedural\n    FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();\n  END IF;\nEND $$;\n\n-- Associative Network\nCREATE TABLE IF NOT EXISTS memory_associations (\n  id              uuid        PRIMARY KEY DEFAULT gen_random_uuid(),\n  source_id       uuid        NOT NULL REFERENCES memories(id),\n  source_type     text        NOT NULL\n                  CHECK (source_type IN ('episode', 'digest', 'semantic', 'procedural')),\n  target_id       uuid        NOT NULL REFERENCES memories(id),\n  target_type     text        NOT NULL\n                  CHECK (target_type IN ('episode', 'digest', 'semantic', 'procedural')),\n  edge_type       text        NOT NULL\n                  CHECK (edge_type IN ('temporal', 'causal', 'topical', 'supports',\n                                       'contradicts', 'elaborates', 'derives_from', 'co_recalled')),\n  strength        real        NOT NULL DEFAULT 0.3\n                  CHECK (strength >= 0.0 AND strength <= 1.0),\n  last_activated  timestamptz,\n  metadata        jsonb       NOT NULL DEFAULT '{}',\n  created_at      timestamptz NOT NULL DEFAULT now(),\n\n  CONSTRAINT uq_association_pair UNIQUE (source_id, target_id, edge_type)\n);\n\nCREATE INDEX IF NOT EXISTS idx_assoc_source_strength\n  ON memory_associations(source_id, strength DESC);\nCREATE INDEX IF NOT EXISTS idx_assoc_target_strength\n  ON memory_associations(target_id, strength DESC);\nCREATE INDEX IF NOT EXISTS idx_assoc_source_type_strength\n  ON memory_associations(source_id, edge_type, strength DESC);\nCREATE INDEX IF NOT EXISTS idx_assoc_prune\n  ON memory_associations(strength, last_activated)\n  WHERE strength < 0.1;\n\n-- Consolidation Run Tracking\nCREATE TABLE IF NOT EXISTS consolidation_runs (\n  id           uuid        PRIMARY KEY DEFAULT gen_random_uuid(),\n  cycle        text        NOT NULL\n               CHECK (cycle IN ('light', 'deep', 'dream', 'decay')),\n  started_at   timestamptz NOT NULL DEFAULT now(),\n  completed_at timestamptz,\n  status       text        NOT NULL DEFAULT 'running'\n               CHECK (status IN ('running', 'completed', 'failed')),\n  metadata     jsonb       NOT NULL DEFAULT '{}'\n);\n\nCREATE INDEX IF NOT EXISTS idx_consolidation_runs_status\n  ON consolidation_runs(status, started_at DESC);\n\n-- Sensory Buffer Persistence\nCREATE TABLE IF NOT EXISTS sensory_snapshots (\n  session_id  text        PRIMARY KEY,\n  snapshot    jsonb       NOT NULL DEFAULT '{}',\n  saved_at    timestamptz NOT NULL DEFAULT now()\n);\n\n-- Schema migrations tracking\nCREATE TABLE IF NOT EXISTS schema_migrations (\n  version     text        PRIMARY KEY,\n  applied_at  timestamptz NOT NULL DEFAULT now(),\n  checksum    text        NOT NULL\n);\n\nINSERT INTO schema_migrations (version, checksum) VALUES\n  ('005_engram_tables', md5('005'))\nON CONFLICT DO NOTHING;\n";
+/**
+ * Migration 006: RPC functions — engram_recall, engram_association_walk,
+ * engram_record_access, engram_upsert_co_recalled, engram_decay_pass,
+ * engram_dream_cycle.
+ */
+export declare const MIGRATION_006 = "\n-- Migration 006: RPC Functions\n\n-- Unified recall across all memory types\nCREATE OR REPLACE FUNCTION engram_recall(\n  p_query_embedding   vector,\n  p_session_id        text        DEFAULT NULL,\n  p_match_count       int         DEFAULT 10,\n  p_min_similarity    float       DEFAULT 0.3,\n  p_include_episodes  bool        DEFAULT true,\n  p_include_digests   bool        DEFAULT true,\n  p_include_semantic  bool        DEFAULT true,\n  p_include_procedural bool       DEFAULT true\n)\nRETURNS TABLE (\n  id           uuid,\n  memory_type  text,\n  content      text,\n  salience     float,\n  access_count int,\n  created_at   timestamptz,\n  similarity   float,\n  entities     text[]\n)\nLANGUAGE sql STABLE PARALLEL SAFE\nSECURITY DEFINER\nSET search_path = public\nAS $$\n  SELECT id, 'episode'::text, content, salience::float, access_count,\n         created_at, (1-(embedding<=>p_query_embedding))::float, entities\n  FROM memory_episodes\n  WHERE p_include_episodes AND embedding IS NOT NULL\n    AND (p_session_id IS NULL OR session_id = p_session_id)\n    AND (1-(embedding<=>p_query_embedding)) >= p_min_similarity\n  ORDER BY embedding<=>p_query_embedding\n  LIMIT p_match_count\n  UNION ALL\n  SELECT id, 'digest'::text, summary, 0.5::float, 0,\n         created_at, (1-(embedding<=>p_query_embedding))::float, key_topics\n  FROM memory_digests\n  WHERE p_include_digests AND embedding IS NOT NULL\n    AND (1-(embedding<=>p_query_embedding)) >= p_min_similarity\n  ORDER BY embedding<=>p_query_embedding\n  LIMIT p_match_count\n  UNION ALL\n  SELECT id, 'semantic'::text, content, confidence::float, access_count,\n         created_at, (1-(embedding<=>p_query_embedding))::float, ARRAY[]::text[]\n  FROM memory_semantic\n  WHERE p_include_semantic AND embedding IS NOT NULL\n    AND superseded_by IS NULL\n    AND (1-(embedding<=>p_query_embedding)) >= p_min_similarity\n  ORDER BY embedding<=>p_query_embedding\n  LIMIT p_match_count\n  UNION ALL\n  SELECT id, 'procedural'::text, procedure, confidence::float, access_count,\n         created_at, (1-(embedding<=>p_query_embedding))::float, ARRAY[]::text[]\n  FROM memory_procedural\n  WHERE p_include_procedural AND embedding IS NOT NULL\n    AND (1-(embedding<=>p_query_embedding)) >= p_min_similarity\n  ORDER BY embedding<=>p_query_embedding\n  LIMIT p_match_count\n$$;\n\n-- Association walk (single SQL call, replaces N+1 queries)\nCREATE OR REPLACE FUNCTION engram_association_walk(\n  p_seed_ids    uuid[],\n  p_max_hops    int   DEFAULT 2,\n  p_min_strength float DEFAULT 0.2,\n  p_limit       int   DEFAULT 20\n)\nRETURNS TABLE (\n  memory_id    uuid,\n  memory_type  text,\n  depth        int,\n  path_strength float\n)\nLANGUAGE sql STABLE\nSECURITY DEFINER\nSET search_path = public\nAS $$\n  WITH RECURSIVE walk AS (\n    SELECT\n      s.id          AS memory_id,\n      NULL::text    AS memory_type,\n      0             AS depth,\n      ARRAY[s.id]   AS visited_ids,\n      1.0::float    AS path_strength\n    FROM unnest(p_seed_ids) AS s(id)\n\n    UNION ALL\n\n    SELECT\n      CASE WHEN a.source_id = w.memory_id THEN a.target_id ELSE a.source_id END,\n      CASE WHEN a.source_id = w.memory_id THEN a.target_type ELSE a.source_type END,\n      w.depth + 1,\n      w.visited_ids ||\n        (CASE WHEN a.source_id = w.memory_id THEN a.target_id ELSE a.source_id END),\n      (w.path_strength * a.strength)::float\n    FROM walk w\n    JOIN memory_associations a ON\n      (a.source_id = w.memory_id OR a.target_id = w.memory_id)\n    WHERE\n      w.depth < p_max_hops\n      AND a.strength >= p_min_strength\n      AND NOT (\n        CASE WHEN a.source_id = w.memory_id THEN a.target_id\n             ELSE a.source_id END\n      ) = ANY(w.visited_ids)\n  )\n  SELECT DISTINCT ON (memory_id)\n    memory_id,\n    memory_type,\n    depth,\n    path_strength\n  FROM walk\n  WHERE depth > 0\n  ORDER BY memory_id, path_strength DESC, depth ASC\n  LIMIT p_limit;\n$$;\n\n-- Atomic reconsolidation update\nCREATE OR REPLACE FUNCTION engram_record_access(\n  p_id          uuid,\n  p_memory_type text,\n  p_conf_boost  float DEFAULT 0.0\n)\nRETURNS void\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path = public\nAS $$\nBEGIN\n  IF p_memory_type = 'episode' THEN\n    UPDATE memory_episodes\n    SET access_count = access_count + 1,\n        last_accessed = now()\n    WHERE id = p_id;\n\n  ELSIF p_memory_type = 'semantic' THEN\n    UPDATE memory_semantic\n    SET access_count = access_count + 1,\n        last_accessed = now(),\n        confidence = LEAST(1.0, confidence + p_conf_boost),\n        updated_at = now()\n    WHERE id = p_id;\n\n  ELSIF p_memory_type = 'procedural' THEN\n    UPDATE memory_procedural\n    SET access_count = access_count + 1,\n        last_accessed = now(),\n        confidence = LEAST(1.0, confidence + p_conf_boost),\n        updated_at = now()\n    WHERE id = p_id;\n  END IF;\nEND;\n$$;\n\n-- Upsert co_recalled association\nCREATE OR REPLACE FUNCTION engram_upsert_co_recalled(\n  p_source_id    uuid,\n  p_source_type  text,\n  p_target_id    uuid,\n  p_target_type  text\n)\nRETURNS void\nLANGUAGE sql\nSECURITY DEFINER\nSET search_path = public\nAS $$\n  INSERT INTO memory_associations\n    (source_id, source_type, target_id, target_type, edge_type, strength, last_activated)\n  VALUES\n    (p_source_id, p_source_type, p_target_id, p_target_type, 'co_recalled', 0.2, now())\n  ON CONFLICT (source_id, target_id, edge_type) DO UPDATE SET\n    strength = LEAST(1.0, memory_associations.strength + 0.1),\n    last_activated = now();\n$$;\n\n-- Batch decay pass\nCREATE OR REPLACE FUNCTION engram_decay_pass(\n  p_semantic_decay_rate   float DEFAULT 0.02,\n  p_procedural_decay_rate float DEFAULT 0.01,\n  p_semantic_days         int   DEFAULT 30,\n  p_procedural_days       int   DEFAULT 60,\n  p_edge_prune_strength   float DEFAULT 0.05,\n  p_edge_prune_days       int   DEFAULT 90\n)\nRETURNS TABLE (\n  semantic_decayed   int,\n  procedural_decayed int,\n  edges_pruned       int\n)\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path = public\nAS $$\nDECLARE\n  v_semantic_decayed   int;\n  v_procedural_decayed int;\n  v_edges_pruned       int;\nBEGIN\n  UPDATE memory_semantic\n  SET confidence = GREATEST(0.05, confidence - p_semantic_decay_rate),\n      updated_at = now()\n  WHERE confidence > 0.05\n    AND (last_accessed IS NULL OR last_accessed < now() - (p_semantic_days || ' days')::interval);\n  GET DIAGNOSTICS v_semantic_decayed = ROW_COUNT;\n\n  UPDATE memory_procedural\n  SET confidence = GREATEST(0.05, confidence - p_procedural_decay_rate),\n      updated_at = now()\n  WHERE confidence > 0.05\n    AND (last_accessed IS NULL OR last_accessed < now() - (p_procedural_days || ' days')::interval);\n  GET DIAGNOSTICS v_procedural_decayed = ROW_COUNT;\n\n  DELETE FROM memory_associations\n  WHERE strength < p_edge_prune_strength\n    AND (last_activated IS NULL OR\n         last_activated < now() - (p_edge_prune_days || ' days')::interval);\n  GET DIAGNOSTICS v_edges_pruned = ROW_COUNT;\n\n  RETURN QUERY SELECT v_semantic_decayed, v_procedural_decayed, v_edges_pruned;\nEND;\n$$;\n\n-- Dream cycle: SQL-side entity co-occurrence\nCREATE OR REPLACE FUNCTION engram_dream_cycle(\n  p_days_lookback        int DEFAULT 30,\n  p_max_new_associations int DEFAULT 50\n)\nRETURNS TABLE (\n  source_id     uuid,\n  source_type   text,\n  target_id     uuid,\n  target_type   text,\n  shared_entity text,\n  entity_count  int\n)\nLANGUAGE sql\nSECURITY DEFINER\nSET search_path = public\nAS $$\n  WITH entity_memories AS (\n    SELECT e.id AS memory_id, 'episode'::text AS memory_type,\n           LOWER(unnest(e.entities)) AS entity\n    FROM memory_episodes e\n    WHERE e.created_at >= now() - (p_days_lookback || ' days')::interval\n      AND array_length(e.entities, 1) > 0\n\n    UNION ALL\n\n    SELECT s.id, 'semantic'::text, LOWER(s.topic)\n    FROM memory_semantic s\n    WHERE s.created_at >= now() - (p_days_lookback || ' days')::interval\n  ),\n  pairs AS (\n    SELECT\n      em1.memory_id   AS source_id,\n      em1.memory_type AS source_type,\n      em2.memory_id   AS target_id,\n      em2.memory_type AS target_type,\n      em1.entity      AS shared_entity,\n      COUNT(*)        AS entity_count\n    FROM entity_memories em1\n    JOIN entity_memories em2\n      ON em1.entity = em2.entity\n      AND em1.memory_id < em2.memory_id\n    WHERE NOT EXISTS (\n      SELECT 1 FROM memory_associations a\n      WHERE (a.source_id = em1.memory_id AND a.target_id = em2.memory_id)\n         OR (a.source_id = em2.memory_id AND a.target_id = em1.memory_id)\n    )\n    GROUP BY em1.memory_id, em1.memory_type, em2.memory_id, em2.memory_type, em1.entity\n  )\n  SELECT source_id, source_type, target_id, target_type, shared_entity, entity_count::int\n  FROM pairs\n  ORDER BY entity_count DESC, source_id, target_id\n  LIMIT p_max_new_associations;\n$$;\n\nINSERT INTO schema_migrations (version, checksum)\nVALUES ('006_rpc_functions', md5('006'))\nON CONFLICT DO NOTHING;\n";
+/**
+ * Migration 007: Row Level Security policies and GRANT statements.
+ */
+export declare const MIGRATION_007 = "\n-- Migration 007: RLS policies\n\nALTER TABLE memories              ENABLE ROW LEVEL SECURITY;\nALTER TABLE memory_episodes       ENABLE ROW LEVEL SECURITY;\nALTER TABLE memory_digests        ENABLE ROW LEVEL SECURITY;\nALTER TABLE memory_semantic       ENABLE ROW LEVEL SECURITY;\nALTER TABLE memory_procedural     ENABLE ROW LEVEL SECURITY;\nALTER TABLE memory_associations   ENABLE ROW LEVEL SECURITY;\nALTER TABLE consolidation_runs    ENABLE ROW LEVEL SECURITY;\nALTER TABLE sensory_snapshots     ENABLE ROW LEVEL SECURITY;\n\n-- Option A: Supabase Auth (user-specific memory isolation)\nCREATE POLICY episodes_auth_policy ON memory_episodes\n  FOR ALL USING (\n    session_id LIKE ('agent:' || auth.uid()::text || ':%')\n    OR auth.role() = 'service_role'\n  );\n\nCREATE POLICY digests_auth_policy ON memory_digests\n  FOR ALL USING (\n    session_id LIKE ('agent:' || auth.uid()::text || ':%')\n    OR auth.role() = 'service_role'\n  );\n\n-- Semantic, procedural, associations: cross-session, service role only\nCREATE POLICY semantic_auth_policy ON memory_semantic\n  FOR ALL USING (auth.role() = 'service_role');\n\nCREATE POLICY procedural_auth_policy ON memory_procedural\n  FOR ALL USING (auth.role() = 'service_role');\n\nCREATE POLICY associations_auth_policy ON memory_associations\n  FOR ALL USING (auth.role() = 'service_role');\n\nCREATE POLICY consolidation_runs_policy ON consolidation_runs\n  FOR ALL USING (auth.role() = 'service_role');\n\nCREATE POLICY sensory_snapshots_policy ON sensory_snapshots\n  FOR ALL USING (\n    session_id LIKE ('agent:' || auth.uid()::text || ':%')\n    OR auth.role() = 'service_role'\n  );\n\nCREATE POLICY memories_policy ON memories\n  FOR ALL USING (auth.role() = 'service_role');\n\n-- Grant execute on RPC functions\nGRANT EXECUTE ON FUNCTION engram_recall TO authenticated, service_role;\nGRANT EXECUTE ON FUNCTION engram_association_walk TO authenticated, service_role;\nGRANT EXECUTE ON FUNCTION engram_record_access TO authenticated, service_role;\nGRANT EXECUTE ON FUNCTION engram_upsert_co_recalled TO authenticated, service_role;\nGRANT EXECUTE ON FUNCTION engram_decay_pass TO service_role;\nGRANT EXECUTE ON FUNCTION engram_dream_cycle TO service_role;\nGRANT EXECUTE ON FUNCTION update_updated_at_column TO service_role;\n\nINSERT INTO schema_migrations (version, checksum)\nVALUES ('007_rls_policies', md5('007'))\nON CONFLICT DO NOTHING;\n";
+/**
+ * Returns all migration SQL concatenated in order.
+ * Apply this to a fresh Supabase project or run each migration individually.
+ */
+export declare function getMigrationSQL(): string;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,aAAa,k/DA+CzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,wsSAoOzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,+0RA2RzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,q3EA2DzB,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}