@raviolelabs/engram-mcp 0.2.0

package/dist/server/api/graph.d.ts

@@ -0,0 +1,26 @@
+import { Router } from 'express';
+import type { MemoryStore } from '../../memory/core/store.js';
+export interface GraphNode {
+    id: string;
+    type: string;
+    title: string;
+    snippet: string;
+    createdAt: number;
+    tags: string[];
+}
+export interface GraphEdge {
+    source: string;
+    target: string;
+    label: 'wikilink' | 'semantic';
+    weight: number;
+}
+export interface GraphData {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+/**
+ * @param store Optional — when provided, enables private semantic-edge augmentation
+ *              if `store.algorithms.graphSemanticEdges` is loaded.
+ */
+export declare function graphApi(store?: MemoryStore): Router;
+//# sourceMappingURL=graph.d.ts.map

package/dist/server/api/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/server/api/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CA8FpD"}

package/dist/server/api/graph.js

@@ -0,0 +1,80 @@
+// src/server/api/graph.ts
+import { Router } from 'express';
+import { getDb } from '../../db/index.js';
+import { createLogger } from '../../logger.js';
+const log = createLogger('api:graph');
+/**
+ * @param store Optional — when provided, enables private semantic-edge augmentation
+ *              if `store.algorithms.graphSemanticEdges` is loaded.
+ */
+export function graphApi(store) {
+    const r = Router();
+    r.get('/', async (req, res) => {
+        try {
+            const typeFilter = typeof req.query.type === 'string' ? req.query.type : null;
+            const limit = Math.min(Number(req.query.limit) || 300, 500);
+            const db = getDb();
+            // 1. Fetch memories
+            const rows = (typeFilter
+                ? db
+                    .prepare(`SELECT id, type, content, properties_json, wikilinks_json, created_at
+                 FROM memories WHERE type = ? ORDER BY created_at DESC LIMIT ?`)
+                    .all(typeFilter, limit)
+                : db
+                    .prepare(`SELECT id, type, content, properties_json, wikilinks_json, created_at
+                 FROM memories ORDER BY created_at DESC LIMIT ?`)
+                    .all(limit));
+            const idSet = new Set(rows.map((r) => r.id));
+            // 2. Build nodes
+            const nodes = rows.map((row) => {
+                const props = JSON.parse(row.properties_json || '{}');
+                const snippet = row.content.slice(0, 180).replace(/\n/g, ' ');
+                return {
+                    id: row.id,
+                    type: row.type,
+                    title: props.title ?? snippet.slice(0, 60),
+                    snippet,
+                    createdAt: row.created_at,
+                    tags: props.tags ?? [],
+                };
+            });
+            // 3. Wikilink edges (OSS basic)
+            const edges = [];
+            for (const row of rows) {
+                let wikilinks = [];
+                try {
+                    wikilinks = JSON.parse(row.wikilinks_json || '[]');
+                }
+                catch {
+                    // malformed — skip
+                }
+                for (const targetId of wikilinks) {
+                    if (idSet.has(targetId) && targetId !== row.id) {
+                        edges.push({ source: row.id, target: targetId, label: 'wikilink', weight: 1 });
+                    }
+                }
+            }
+            // 4. Semantic edges — private smart version if loaded
+            // OSS basic: wikilinks only (see comment above).
+            // Private: computes pairwise cosine similarity for up to 50 nodes, adds edges with cosine > 0.7.
+            if (store?.algorithms.graphSemanticEdges) {
+                try {
+                    const nodeIds = nodes.slice(0, 50).map((n) => n.id);
+                    const semanticEdges = await store.algorithms.graphSemanticEdges(store, nodeIds);
+                    edges.push(...semanticEdges);
+                }
+                catch (e) {
+                    log.warn(`graphSemanticEdges failed: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            const data = { nodes, edges };
+            res.json(data);
+        }
+        catch (e) {
+            log.error(`GET /api/graph error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+    return r;
+}
+//# sourceMappingURL=graph.js.map

package/dist/server/api/graph.js.map

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

package/dist/server/api/integrations.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import type { EngramConfig } from '../../config/schema.js';
+export declare function integrationsApi(getConfig: () => EngramConfig): Router;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/server/api/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/server/api/integrations.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AASjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAuF3D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,YAAY,GAAG,MAAM,CAmIrE"}

package/dist/server/api/integrations.js

@@ -0,0 +1,228 @@
+// src/server/api/integrations.ts
+//
+// REST endpoints for Drive/Notion integration setup.
+// Keys are written to ~/.engram/config.json — the cloud never sees them.
+//
+// Routes:
+//   GET  /api/integrations/status
+//   PATCH /api/integrations/drive
+//   PATCH /api/integrations/notion
+//   DELETE /api/integrations/drive
+//   DELETE /api/integrations/notion
+//   POST /api/integrations/drive/connect
+//   POST /api/integrations/notion/connect
+import { Router } from 'express';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { z } from 'zod';
+import { createLogger } from '../../logger.js';
+import { isDriveConnected, startDriveOAuthFlow } from '../../memory/modules/drive/oauth.js';
+import { isNotionConnected, startNotionOAuthFlow } from '../../memory/modules/notion/oauth.js';
+const log = createLogger('api:integrations');
+// ---------------------------------------------------------------------------
+// Config path helpers
+// ---------------------------------------------------------------------------
+function getConfigDir() {
+    const raw = process.env.ENGRAM_CONFIG_DIR ?? path.join(os.homedir(), '.engram');
+    if (raw.startsWith('~'))
+        return path.join(os.homedir(), raw.slice(1));
+    return raw;
+}
+function getConfigPath() {
+    return path.join(getConfigDir(), 'config.json');
+}
+function readRawConfig() {
+    const p = getConfigPath();
+    if (!fs.existsSync(p))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Atomically write config: tmp file → rename.
+ * Sets permissions to 0o600 (owner read/write only — contains secrets).
+ */
+function writeConfig(updated) {
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+    }
+    const configPath = getConfigPath();
+    const tmpPath = configPath + '.tmp.' + process.pid;
+    const serialized = JSON.stringify(updated, null, 2);
+    fs.writeFileSync(tmpPath, serialized, { encoding: 'utf-8', mode: 0o600 });
+    fs.renameSync(tmpPath, configPath);
+    // Ensure 600 even if file already existed with different perms
+    try {
+        fs.chmodSync(configPath, 0o600);
+    }
+    catch {
+        // non-fatal on systems where chmod isn't supported
+    }
+    log.info('config.json updated');
+}
+// ---------------------------------------------------------------------------
+// Status helper
+// ---------------------------------------------------------------------------
+function getStatus(config) {
+    const driveConf = config.drive;
+    const notionConf = config.notion;
+    return {
+        drive: {
+            configured: !!(driveConf?.clientId && driveConf?.clientSecret),
+            connected: isDriveConnected(),
+        },
+        notion: {
+            configured: !!(notionConf?.clientId && notionConf?.clientSecret),
+            connected: isNotionConnected(),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Validation schemas
+// ---------------------------------------------------------------------------
+const CredentialsSchema = z.object({
+    clientId: z.string().min(1, 'clientId required'),
+    clientSecret: z.string().min(1, 'clientSecret required'),
+    redirectPort: z.number().int().positive().default(7777),
+});
+// ---------------------------------------------------------------------------
+// Router
+// ---------------------------------------------------------------------------
+export function integrationsApi(getConfig) {
+    const r = Router();
+    // GET /api/integrations/status
+    r.get('/status', (_req, res) => {
+        try {
+            const raw = readRawConfig();
+            res.json(getStatus(raw));
+        }
+        catch (e) {
+            log.error(`GET /status error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // PATCH /api/integrations/drive
+    r.patch('/drive', (req, res) => {
+        try {
+            const parsed = CredentialsSchema.safeParse(req.body);
+            if (!parsed.success) {
+                res.status(400).json({ error: parsed.error.flatten() });
+                return;
+            }
+            const raw = readRawConfig();
+            raw.drive = {
+                clientId: parsed.data.clientId,
+                clientSecret: parsed.data.clientSecret,
+                redirectPort: parsed.data.redirectPort,
+            };
+            writeConfig(raw);
+            res.json(getStatus(raw));
+        }
+        catch (e) {
+            log.error(`PATCH /drive error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // PATCH /api/integrations/notion
+    r.patch('/notion', (req, res) => {
+        try {
+            const parsed = CredentialsSchema.safeParse(req.body);
+            if (!parsed.success) {
+                res.status(400).json({ error: parsed.error.flatten() });
+                return;
+            }
+            const raw = readRawConfig();
+            raw.notion = {
+                clientId: parsed.data.clientId,
+                clientSecret: parsed.data.clientSecret,
+                redirectPort: parsed.data.redirectPort,
+            };
+            writeConfig(raw);
+            res.json(getStatus(raw));
+        }
+        catch (e) {
+            log.error(`PATCH /notion error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // DELETE /api/integrations/drive
+    r.delete('/drive', (_req, res) => {
+        try {
+            const raw = readRawConfig();
+            delete raw.drive;
+            writeConfig(raw);
+            res.json(getStatus(raw));
+        }
+        catch (e) {
+            log.error(`DELETE /drive error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // DELETE /api/integrations/notion
+    r.delete('/notion', (_req, res) => {
+        try {
+            const raw = readRawConfig();
+            delete raw.notion;
+            writeConfig(raw);
+            res.json(getStatus(raw));
+        }
+        catch (e) {
+            log.error(`DELETE /notion error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // POST /api/integrations/drive/connect
+    r.post('/drive/connect', async (_req, res) => {
+        try {
+            const config = getConfig();
+            if (!config.drive) {
+                res.status(400).json({ error: 'Drive credentials not configured. PATCH /api/integrations/drive first.' });
+                return;
+            }
+            const flow = await startDriveOAuthFlow(config);
+            // Don't await the callback here — just return the URL so the browser can open it
+            res.json({
+                auth_url: flow.authUrl,
+                instructions: 'Open the auth_url in your browser and authorize access. Poll GET /api/integrations/status until drive.connected becomes true.',
+            });
+            // Background: resolve and discard (tokens saved to DB by oauth.ts)
+            flow.waitForCallback.catch((e) => {
+                log.warn(`Drive OAuth callback error: ${e instanceof Error ? e.message : String(e)}`);
+            });
+        }
+        catch (e) {
+            log.error(`POST /drive/connect error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    // POST /api/integrations/notion/connect
+    r.post('/notion/connect', async (_req, res) => {
+        try {
+            const config = getConfig();
+            if (!config.notion) {
+                res.status(400).json({ error: 'Notion credentials not configured. PATCH /api/integrations/notion first.' });
+                return;
+            }
+            const flow = await startNotionOAuthFlow(config);
+            res.json({
+                auth_url: flow.authUrl,
+                instructions: 'Open the auth_url in your browser and authorize access. Poll GET /api/integrations/status until notion.connected becomes true.',
+            });
+            flow.waitForCallback.catch((e) => {
+                log.warn(`Notion OAuth callback error: ${e instanceof Error ? e.message : String(e)}`);
+            });
+        }
+        catch (e) {
+            log.error(`POST /notion/connect error: ${e instanceof Error ? e.message : String(e)}`);
+            res.status(500).json({ error: String(e) });
+        }
+    });
+    return r;
+}
+//# sourceMappingURL=integrations.js.map

package/dist/server/api/integrations.js.map

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

package/dist/server/api/memories.d.ts

@@ -0,0 +1,4 @@
+import type { Router } from 'express';
+import type { MemoryStore } from '../../memory/core/store.js';
+export declare function memoriesApi(store: MemoryStore): Router;
+//# sourceMappingURL=memories.d.ts.map

package/dist/server/api/memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../../src/server/api/memories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAUzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA8D9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAiOtD"}

package/dist/server/api/memories.js

@@ -0,0 +1,267 @@
+import { Router as router } from 'express';
+import multer from 'multer';
+import { createHash } from 'crypto';
+import { ulid } from 'ulid';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import { z } from 'zod';
+import { getDb } from '../../db/index.js';
+import { extractWikilinks } from '../../memory/core/wikilinks.js';
+import { loadConfig } from '../../config/index.js';
+import { transcribeAudio } from '../../memory/modules/audio/transcriber.js';
+import { buildAudioItem } from '../../memory/modules/audio/ingest.js';
+// ---------------------------------------------------------------------------
+// Validation schemas
+// ---------------------------------------------------------------------------
+const CreateMemorySchema = z.object({
+    type: z.string().min(1),
+    title: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    content: z.string(),
+    properties: z.record(z.unknown()).optional(),
+});
+const PatchMemorySchema = z.object({
+    title: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    sentiment: z.enum(['positive', 'neutral', 'negative']).optional(),
+    action_required: z.boolean().optional(),
+    custom: z.record(z.unknown()).optional(),
+}).strict();
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+function buildMemoryItem(type, content, title, tags, extraProperties = {}, embeddingModel) {
+    const now = new Date().toISOString();
+    return {
+        id: ulid(),
+        type,
+        source_id: 'manual',
+        content,
+        content_hash: createHash('sha256').update(content).digest('hex'),
+        properties: {
+            title,
+            tags,
+            created_at: now,
+            ingested_at: now,
+            ...extraProperties,
+        },
+        wikilinks: extractWikilinks(content),
+        related_ids: [],
+        embedding_model: embeddingModel,
+    };
+}
+// ---------------------------------------------------------------------------
+// Route factory
+// ---------------------------------------------------------------------------
+export function memoriesApi(store) {
+    const r = router();
+    // Multer: temp-dir storage, 50 MB limit
+    const upload = multer({
+        dest: path.join(os.tmpdir(), 'engram-uploads'),
+        limits: { fileSize: 50 * 1024 * 1024 },
+    });
+    // -------------------------------------------------------------------------
+    // GET /api/memories
+    // -------------------------------------------------------------------------
+    r.get('/', (req, res) => {
+        const limit = Math.min(200, Number(req.query.limit ?? 50));
+        const type = req.query.type;
+        const rows = type
+            ? getDb()
+                .prepare(`SELECT id, type, source_id, content, properties_json, created_at
+             FROM memories WHERE type = ? ORDER BY created_at DESC LIMIT ?`)
+                .all(type, limit)
+            : getDb()
+                .prepare(`SELECT id, type, source_id, content, properties_json, created_at
+             FROM memories ORDER BY created_at DESC LIMIT ?`)
+                .all(limit);
+        res.json(rows.map((row) => ({
+            id: row.id,
+            type: row.type,
+            source_id: row.source_id,
+            content_preview: row.content.slice(0, 300),
+            properties: JSON.parse(row.properties_json),
+            created_at: row.created_at,
+        })));
+    });
+    // -------------------------------------------------------------------------
+    // GET /api/memories/search
+    // -------------------------------------------------------------------------
+    r.get('/search', async (req, res) => {
+        const q = req.query.q ?? '';
+        const type = req.query.type;
+        const limit = Math.min(50, Number(req.query.limit ?? 10));
+        if (!q) {
+            res.json([]);
+            return;
+        }
+        try {
+            let hits;
+            if (type) {
+                hits = await store.search(type, q, limit);
+            }
+            else {
+                const types = store.listTypes();
+                const all = await Promise.all(types.map((t) => store.search(t, q, limit).catch(() => [])));
+                hits = all.flat().sort((a, b) => b.score - a.score).slice(0, limit);
+            }
+            res.json(hits.map((h) => ({
+                id: h.memory.id,
+                type: h.memory.type,
+                score: h.score,
+                snippet: h.snippet,
+                title: h.memory.properties.title,
+            })));
+        }
+        catch (e) {
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+    // -------------------------------------------------------------------------
+    // POST /api/memories — create a memory directly
+    // -------------------------------------------------------------------------
+    r.post('/', async (req, res) => {
+        const parsed = CreateMemorySchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json({ error: 'validation_error', issues: parsed.error.issues });
+            return;
+        }
+        const { type, title, tags, content, properties: extraProps } = parsed.data;
+        const config = loadConfig();
+        const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+        const item = buildMemoryItem(type, content, title, tags, extraProps, embeddingModel);
+        try {
+            await store.insert(item);
+            res.status(201).json(item);
+        }
+        catch (e) {
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+    // -------------------------------------------------------------------------
+    // POST /api/memories/upload — file upload (md/txt/pdf/audio/images)
+    // -------------------------------------------------------------------------
+    r.post('/upload', upload.single('file'), async (req, res) => {
+        if (!req.file) {
+            res.status(400).json({ error: 'no_file' });
+            return;
+        }
+        const config = loadConfig();
+        const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+        const { originalname, path: tmpPath, mimetype } = req.file;
+        const ext = path.extname(originalname).toLowerCase();
+        try {
+            // ---- text/markdown ----
+            if (ext === '.md' || ext === '.txt') {
+                const content = fs.readFileSync(tmpPath, 'utf-8');
+                const item = buildMemoryItem('notes', content, originalname, [], {}, embeddingModel);
+                await store.insert(item);
+                res.status(201).json({ id: item.id, type: 'notes', filename: originalname });
+                return;
+            }
+            // ---- PDF ----
+            if (ext === '.pdf') {
+                const content = `[uploaded PDF: ${originalname}] — full text extraction pending`;
+                const item = buildMemoryItem('notes', content, originalname, ['pdf'], { source_url: `file://${originalname}` }, embeddingModel);
+                await store.insert(item);
+                res.status(201).json({ id: item.id, type: 'notes', filename: originalname });
+                return;
+            }
+            // ---- audio ----
+            if (['.mp3', '.wav', '.m4a'].includes(ext)) {
+                // Move temp file to a stable location so whisper can find it
+                const audioDir = path.join(os.homedir(), '.engram', 'audio-uploads');
+                fs.mkdirSync(audioDir, { recursive: true });
+                const stablePath = path.join(audioDir, `${ulid()}-${originalname}`);
+                fs.renameSync(tmpPath, stablePath);
+                const transcript = await transcribeAudio(stablePath, config.whisper);
+                const item = buildAudioItem({ audioPath: stablePath, transcript, embeddingModel });
+                await store.insert(item);
+                res.status(201).json({ id: item.id, type: 'audio', filename: originalname, duration: transcript.duration });
+                return;
+            }
+            // ---- images ----
+            if (['.png', '.jpg', '.jpeg'].includes(ext)) {
+                const content = `[uploaded image: ${originalname}]`;
+                const item = buildMemoryItem('images', content, originalname, ['image'], { source_url: `file://${originalname}`, mime_type: mimetype }, embeddingModel);
+                await store.insert(item);
+                res.status(201).json({ id: item.id, type: 'images', filename: originalname });
+                return;
+            }
+            res.status(400).json({ error: 'unsupported_file_type', ext });
+        }
+        catch (e) {
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+        finally {
+            // Clean up temp file if still present
+            try {
+                if (fs.existsSync(tmpPath))
+                    fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+        }
+    });
+    // -------------------------------------------------------------------------
+    // GET /api/memories/:id
+    // -------------------------------------------------------------------------
+    r.get('/:id', (req, res) => {
+        const id = String(req.params.id);
+        const item = store.getById(id);
+        if (!item) {
+            res.status(404).json({ error: 'not_found' });
+            return;
+        }
+        res.json(item);
+    });
+    // -------------------------------------------------------------------------
+    // GET /api/memories/:id/related
+    // -------------------------------------------------------------------------
+    r.get('/:id/related', async (req, res) => {
+        const id = String(req.params.id);
+        const limit = Math.min(50, Number(req.query.limit ?? 10));
+        try {
+            const results = await store.findRelated(id, limit);
+            res.json(results);
+        }
+        catch (e) {
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
+    // -------------------------------------------------------------------------
+    // PATCH /api/memories/:id
+    // -------------------------------------------------------------------------
+    r.patch('/:id', (req, res) => {
+        const id = String(req.params.id);
+        const parsed = PatchMemorySchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json({ error: 'validation_error', issues: parsed.error.issues });
+            return;
+        }
+        // Strip undefined keys
+        const patch = Object.fromEntries(Object.entries(parsed.data).filter(([, v]) => v !== undefined));
+        const ok = store.setProperties(id, patch);
+        if (!ok) {
+            res.status(404).json({ error: 'not_found' });
+            return;
+        }
+        const updated = store.getById(id);
+        res.status(200).json(updated);
+    });
+    // -------------------------------------------------------------------------
+    // DELETE /api/memories/:id
+    // -------------------------------------------------------------------------
+    r.delete('/:id', async (req, res) => {
+        const id = String(req.params.id);
+        const item = store.getById(id);
+        if (!item) {
+            res.status(404).json({ error: 'not_found' });
+            return;
+        }
+        await store.delete(id);
+        res.status(204).send();
+    });
+    return r;
+}
+//# sourceMappingURL=memories.js.map