@plusplusoneplusplus/coc 1.0.0

package/dist/server/logs-routes.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Logs Routes
+ *
+ * Registers the /api/logs/* REST and SSE endpoints.
+ *
+ * GET /api/logs/stream   — SSE: live log streaming (text/event-stream)
+ * GET /api/logs/history  — JSON array of buffered log entries, newest-first
+ * GET /api/logs/sources  — JSON: configured log sources + status
+ *
+ * Live streaming uses the in-process EventEmitter from server-log-capture.ts.
+ * No log files are required for live streaming; file-based history is optional.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogsRoutes = registerLogsRoutes;
+const url = __importStar(require("url"));
+const router_1 = require("./router");
+const server_log_capture_1 = require("./server-log-capture");
+// ============================================================================
+// Helpers
+// ============================================================================
+function sendSseEvent(res, event, data) {
+    res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+}
+function parseLevel(raw) {
+    const VALID = new Set(['trace', 'debug', 'info', 'warn', 'error', 'fatal']);
+    return typeof raw === 'string' && VALID.has(raw) ? raw : undefined;
+}
+// ============================================================================
+// Registration
+// ============================================================================
+/**
+ * Register all /api/logs/* routes on the given route table.
+ * Mutates the `routes` array in-place.
+ *
+ * @param routes  - Shared route table
+ * @param logDir  - Optional log file directory (enables "files configured" in /sources)
+ */
+function registerLogsRoutes(routes, logDir) {
+    // ── GET /api/logs/stream ─────────────────────────────────────────────────
+    routes.push({
+        method: 'GET',
+        pattern: '/api/logs/stream',
+        handler: async (req, res) => {
+            const parsedUrl = url.parse(req.url ?? '', true);
+            const minLevel = parseLevel(parsedUrl.query.level);
+            // Set SSE headers
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                'X-Accel-Buffering': 'no',
+            });
+            res.flushHeaders();
+            // Send buffered history as initial batch (newest-last order for stream)
+            const historyOpts = { limit: 200 };
+            if (minLevel)
+                historyOpts.level = minLevel;
+            const history = (0, server_log_capture_1.getLogHistory)(historyOpts).reverse(); // oldest-first for initial replay
+            if (history.length > 0) {
+                sendSseEvent(res, 'history', history);
+            }
+            // Subscribe to live entries
+            let closed = false;
+            const logEmitter = (0, server_log_capture_1.getLogEmitter)();
+            const onEntry = (entry) => {
+                if (closed)
+                    return;
+                // Level filter
+                if (minLevel) {
+                    const e = entry;
+                    const LEVEL_NUM = {
+                        trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60,
+                    };
+                    const VALID_LEVEL_NUM = {
+                        trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60,
+                    };
+                    if ((LEVEL_NUM[e.level] ?? 0) < VALID_LEVEL_NUM[minLevel])
+                        return;
+                }
+                sendSseEvent(res, 'log-entry', entry);
+            };
+            logEmitter.on('log-entry', onEntry);
+            // Heartbeat every 15 s
+            const heartbeat = setInterval(() => {
+                if (!closed)
+                    sendSseEvent(res, 'heartbeat', {});
+            }, 15000);
+            const cleanup = () => {
+                if (closed)
+                    return;
+                closed = true;
+                clearInterval(heartbeat);
+                logEmitter.removeListener('log-entry', onEntry);
+            };
+            req.on('close', cleanup);
+            req.on('error', cleanup);
+        },
+    });
+    // ── GET /api/logs/history ────────────────────────────────────────────────
+    routes.push({
+        method: 'GET',
+        pattern: '/api/logs/history',
+        handler: async (req, res) => {
+            const parsedUrl = url.parse(req.url ?? '', true);
+            const opts = {};
+            const level = parseLevel(parsedUrl.query.level);
+            if (level)
+                opts.level = level;
+            if (typeof parsedUrl.query.component === 'string' && parsedUrl.query.component) {
+                opts.component = parsedUrl.query.component;
+            }
+            if (parsedUrl.query.limit) {
+                const n = parseInt(String(parsedUrl.query.limit), 10);
+                if (!isNaN(n) && n > 0)
+                    opts.limit = Math.min(n, 1000);
+            }
+            if (typeof parsedUrl.query.before === 'string' && parsedUrl.query.before) {
+                opts.before = parsedUrl.query.before;
+            }
+            if (typeof parsedUrl.query.search === 'string' && parsedUrl.query.search) {
+                opts.search = parsedUrl.query.search;
+            }
+            const entries = (0, server_log_capture_1.getLogHistory)(opts);
+            (0, router_1.sendJson)(res, { entries, total: entries.length });
+        },
+    });
+    // ── GET /api/logs/sources ────────────────────────────────────────────────
+    routes.push({
+        method: 'GET',
+        pattern: '/api/logs/sources',
+        handler: async (_req, res) => {
+            const sources = [
+                {
+                    id: 'in-process',
+                    label: 'In-process (live)',
+                    description: 'Real-time log stream from the running server process',
+                    active: true,
+                    fileConfigured: false,
+                },
+            ];
+            if (logDir) {
+                sources.push({
+                    id: 'coc-service',
+                    label: 'coc-service',
+                    description: 'coc-service log file',
+                    active: true,
+                    fileConfigured: true,
+                });
+                sources.push({
+                    id: 'ai-service',
+                    label: 'ai-service',
+                    description: 'ai-service log file',
+                    active: true,
+                    fileConfigured: true,
+                });
+            }
+            (0, router_1.sendJson)(res, { sources, logDir: logDir ?? null });
+        },
+    });
+}
+//# sourceMappingURL=logs-routes.js.map

package/dist/server/logs-routes.js.map

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

package/dist/server/memory/conversation-recorder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Conversation Recorder
+ *
+ * Records user messages as memory notes so they appear in the repo memory feed.
+ * Uses the same FileMemoryStore + repo-scoped path as manual notes.
+ */
+/**
+ * Persist a user message as a repo-scoped memory note with source 'conversation'.
+ * Silently no-ops when recording is disabled or on any storage error.
+ */
+export declare function recordUserMessage(dataDir: string, workspaceId: string, content: string): void;
+//# sourceMappingURL=conversation-recorder.d.ts.map

package/dist/server/memory/conversation-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-recorder.d.ts","sourceRoot":"","sources":["../../../src/server/memory/conversation-recorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAChB,IAAI,CAON"}

package/dist/server/memory/conversation-recorder.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Conversation Recorder
+ *
+ * Records user messages as memory notes so they appear in the repo memory feed.
+ * Uses the same FileMemoryStore + repo-scoped path as manual notes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordUserMessage = recordUserMessage;
+const memory_config_handler_1 = require("./memory-config-handler");
+const memory_store_1 = require("./memory-store");
+const paths_1 = require("../paths");
+/**
+ * Persist a user message as a repo-scoped memory note with source 'conversation'.
+ * Silently no-ops when recording is disabled or on any storage error.
+ */
+function recordUserMessage(dataDir, workspaceId, content) {
+    const config = (0, memory_config_handler_1.readMemoryConfig)(dataDir);
+    if (!config.recording.enabled)
+        return;
+    const noteDir = (0, paths_1.getRepoDataPath)(dataDir, workspaceId, 'memory');
+    const store = new memory_store_1.FileMemoryStore(noteDir);
+    store.create({ content, source: 'conversation', tags: [] });
+}
+//# sourceMappingURL=conversation-recorder.js.map

package/dist/server/memory/conversation-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-recorder.js","sourceRoot":"","sources":["../../../src/server/memory/conversation-recorder.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAUH,8CAWC;AAnBD,mEAA2D;AAC3D,iDAAiD;AACjD,oCAA2C;AAE3C;;;GAGG;AACH,SAAgB,iBAAiB,CAC7B,OAAe,EACf,WAAmB,EACnB,OAAe;IAEf,MAAM,MAAM,GAAG,IAAA,wCAAgB,EAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO;IAEtC,MAAM,OAAO,GAAG,IAAA,uBAAe,EAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,8BAAe,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/memory/memory-config-handler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Memory Config Handler
+ *
+ * REST API handlers for reading/writing the memory storage configuration.
+ * Config is persisted to <dataDir>/memory-config.json using atomic write-then-rename.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import * as http from 'http';
+export type MemoryBackend = 'file' | 'sqlite' | 'vector';
+export interface MemoryRecordingConfig {
+    /** When true, user messages in conversations are saved to repo memory. */
+    enabled: boolean;
+}
+export interface MemoryConfig {
+    /** Directory where memory entries are stored. Defaults to ~/.coc/memory/ */
+    storageDir: string;
+    /** Storage backend type. */
+    backend: MemoryBackend;
+    /** Maximum number of entries to retain (oldest deleted first). */
+    maxEntries: number;
+    /** Time-to-live in days; entries older than this are pruned. 0 = no TTL. */
+    ttlDays: number;
+    /** Automatically inject relevant memories as context into AI prompts. */
+    autoInject: boolean;
+    /** Conversation recording settings. */
+    recording: MemoryRecordingConfig;
+}
+export declare const MEMORY_CONFIG_FILE_NAME = "memory-config.json";
+export declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;
+/**
+ * Read memory config from disk.
+ * Falls back to defaults when the file doesn't exist or is invalid.
+ */
+export declare function readMemoryConfig(dataDir: string): MemoryConfig;
+/**
+ * Write memory config to disk atomically (write-then-rename pattern).
+ * Creates the data directory if it doesn't exist.
+ */
+export declare function writeMemoryConfig(dataDir: string, config: MemoryConfig): void;
+/**
+ * Validate and sanitize a raw config object. Falls back to defaults for missing/invalid fields.
+ */
+export declare function validateMemoryConfig(raw: unknown): MemoryConfig;
+/**
+ * Handle GET /api/memory/config — return current memory configuration.
+ */
+export declare function handleGetMemoryConfig(_req: http.IncomingMessage, res: http.ServerResponse, dataDir: string): void;
+/**
+ * Handle PUT /api/memory/config — replace memory configuration.
+ */
+export declare function handlePutMemoryConfig(req: http.IncomingMessage, res: http.ServerResponse, dataDir: string): Promise<void>;
+//# sourceMappingURL=memory-config-handler.d.ts.map

package/dist/server/memory/memory-config-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-config-handler.d.ts","sourceRoot":"","sources":["../../../src/server/memory/memory-config-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IAClC,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,qBAAqB,CAAC;CACpC;AAMD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,YAOnC,CAAC;AAMF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAY9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAM7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAqC/D;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,IAAI,CAAC,eAAe,EAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,EAAE,MAAM,GAChB,IAAI,CAON;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/server/memory/memory-config-handler.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * Memory Config Handler
+ *
+ * REST API handlers for reading/writing the memory storage configuration.
+ * Config is persisted to <dataDir>/memory-config.json using atomic write-then-rename.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEMORY_CONFIG = exports.MEMORY_CONFIG_FILE_NAME = void 0;
+exports.readMemoryConfig = readMemoryConfig;
+exports.writeMemoryConfig = writeMemoryConfig;
+exports.validateMemoryConfig = validateMemoryConfig;
+exports.handleGetMemoryConfig = handleGetMemoryConfig;
+exports.handlePutMemoryConfig = handlePutMemoryConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const router_1 = require("../router");
+// ============================================================================
+// Constants
+// ============================================================================
+exports.MEMORY_CONFIG_FILE_NAME = 'memory-config.json';
+exports.DEFAULT_MEMORY_CONFIG = {
+    storageDir: path.join(os.homedir(), '.coc', 'memory'),
+    backend: 'file',
+    maxEntries: 10000,
+    ttlDays: 90,
+    autoInject: false,
+    recording: { enabled: false },
+};
+// ============================================================================
+// Persistence Helpers
+// ============================================================================
+/**
+ * Read memory config from disk.
+ * Falls back to defaults when the file doesn't exist or is invalid.
+ */
+function readMemoryConfig(dataDir) {
+    const filePath = path.join(dataDir, exports.MEMORY_CONFIG_FILE_NAME);
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { ...exports.DEFAULT_MEMORY_CONFIG };
+        }
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return validateMemoryConfig(parsed);
+    }
+    catch {
+        return { ...exports.DEFAULT_MEMORY_CONFIG };
+    }
+}
+/**
+ * Write memory config to disk atomically (write-then-rename pattern).
+ * Creates the data directory if it doesn't exist.
+ */
+function writeMemoryConfig(dataDir, config) {
+    fs.mkdirSync(dataDir, { recursive: true });
+    const filePath = path.join(dataDir, exports.MEMORY_CONFIG_FILE_NAME);
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2), 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Validate and sanitize a raw config object. Falls back to defaults for missing/invalid fields.
+ */
+function validateMemoryConfig(raw) {
+    const defaults = exports.DEFAULT_MEMORY_CONFIG;
+    if (typeof raw !== 'object' || raw === null) {
+        return { ...defaults };
+    }
+    const obj = raw;
+    const result = { ...defaults };
+    if (typeof obj.storageDir === 'string' && obj.storageDir.length > 0) {
+        // Expand ~ to home directory
+        result.storageDir = obj.storageDir.startsWith('~')
+            ? path.join(os.homedir(), obj.storageDir.slice(1))
+            : obj.storageDir;
+    }
+    if (obj.backend === 'file' || obj.backend === 'sqlite' || obj.backend === 'vector') {
+        result.backend = obj.backend;
+    }
+    if (typeof obj.maxEntries === 'number' && obj.maxEntries > 0) {
+        result.maxEntries = Math.floor(obj.maxEntries);
+    }
+    if (typeof obj.ttlDays === 'number' && obj.ttlDays >= 0) {
+        result.ttlDays = Math.floor(obj.ttlDays);
+    }
+    if (typeof obj.autoInject === 'boolean') {
+        result.autoInject = obj.autoInject;
+    }
+    // recording sub-config
+    const rawRec = obj.recording;
+    if (typeof rawRec === 'object' && rawRec !== null) {
+        const rec = rawRec;
+        if (typeof rec.enabled === 'boolean') {
+            result.recording = { enabled: rec.enabled };
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Route Handlers
+// ============================================================================
+/**
+ * Handle GET /api/memory/config — return current memory configuration.
+ */
+function handleGetMemoryConfig(_req, res, dataDir) {
+    try {
+        const config = readMemoryConfig(dataDir);
+        (0, router_1.sendJson)(res, config);
+    }
+    catch (err) {
+        (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * Handle PUT /api/memory/config — replace memory configuration.
+ */
+async function handlePutMemoryConfig(req, res, dataDir) {
+    try {
+        const body = await (0, router_1.readJsonBody)(req);
+        // Strict validation: reject explicitly invalid numeric fields
+        if (typeof body.maxEntries === 'number' && body.maxEntries <= 0) {
+            (0, router_1.send400)(res, 'Invalid config: maxEntries must be a positive number');
+            return;
+        }
+        if (typeof body.ttlDays === 'number' && body.ttlDays < 0) {
+            (0, router_1.send400)(res, 'Invalid config: ttlDays must be 0 or a positive number');
+            return;
+        }
+        const config = validateMemoryConfig(body);
+        writeMemoryConfig(dataDir, config);
+        (0, router_1.sendJson)(res, config);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('Invalid JSON')) {
+            (0, router_1.send400)(res, 'Invalid JSON');
+        }
+        else {
+            (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+//# sourceMappingURL=memory-config-handler.js.map

package/dist/server/memory/memory-config-handler.js.map

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

package/dist/server/memory/memory-routes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Memory Routes
+ *
+ * Registers all /api/memory/* REST endpoints.
+ *
+ * GET  /api/memory/config          — read config
+ * PUT  /api/memory/config          — write config
+ * GET  /api/memory/entries         — list/search entries
+ * POST /api/memory/entries         — create entry
+ * GET  /api/memory/entries/:id     — get single entry
+ * PATCH /api/memory/entries/:id    — update tags/content
+ * DELETE /api/memory/entries/:id   — delete entry
+ * GET  /api/memory/observations/levels    — overview of all 3 memory levels
+ * GET  /api/memory/observations           — list files at a level
+ * GET  /api/memory/observations/:filename — read a single observation file
+ * GET  /api/memory/explore-cache/levels              — overview of all explore-cache levels
+ * GET  /api/memory/explore-cache/raw                 — list raw Q&A files at a level
+ * GET  /api/memory/explore-cache/raw/:filename       — read a single raw Q&A entry
+ * GET  /api/memory/explore-cache/consolidated        — list consolidated index entries at a level
+ * GET  /api/memory/explore-cache/consolidated/:id    — read a consolidated entry with its answer
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { AIInvoker } from '@plusplusoneplusplus/forge';
+import type { Route } from '../types';
+export interface MemoryRouteOptions {
+    /**
+     * AI invoker for the POST /api/memory/aggregate-tool-calls endpoint.
+     * When absent the endpoint returns 503 Service Unavailable.
+     */
+    aggregateToolCallsAIInvoker?: AIInvoker;
+    /**
+     * Optional working directory for scoping the explore cache.
+     * When provided, the cache resolves to git-remote or repo level;
+     * when absent, behavior remains system-level.
+     */
+    workingDirectory?: string;
+}
+/**
+ * Register all memory API routes on the given route table.
+ * Mutates the `routes` array in-place.
+ *
+ * @param routes  - Shared route table
+ * @param dataDir - CoC data directory (e.g. ~/.coc)
+ * @param options - Optional configuration (e.g. AI invoker for aggregation)
+ */
+export declare function registerMemoryRoutes(routes: Route[], dataDir: string, options?: MemoryRouteOptions): void;
+//# sourceMappingURL=memory-routes.d.ts.map

package/dist/server/memory/memory-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-routes.d.ts","sourceRoot":"","sources":["../../../src/server/memory/memory-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAQ5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAUtC,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,2BAA2B,CAAC,EAAE,SAAS,CAAC;IACxC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAwfzG"}