agentdb 3.2.0 → 3.3.0

package/dist/src/controllers/episode-hybrid.js

@@ -60,6 +60,29 @@ export class EpisodeLexicalIndex {
         this.count = count;
         this.maxId = maxId;
     }
+    /**
+     * Apply an in-place edit of one episode without a rebuild. `before` must be the row as it was indexed.
+     * A no-op when the index is not built yet (the next search builds it from current rows) or the episode
+     * is outside the indexed window.
+     */
+    update(before, after) {
+        if (!this.index)
+            return;
+        const doc = this.ids.indexOf(before.id);
+        if (doc < 0)
+            return;
+        this.index.replace(doc, EpisodeLexicalIndex.textOf(before), EpisodeLexicalIndex.textOf(after));
+    }
+    /**
+     * Force a full rebuild on the next search. Needed after an in-place edit: an UPDATE changes
+     * neither COUNT(*) nor MAX(id), so refresh() alone would keep serving the old text.
+     */
+    invalidate() {
+        this.index = null;
+        this.ids = [];
+        this.count = -1;
+        this.maxId = 0;
+    }
     /** Episode ids with a BM25 match, best first, at most `limit`. */
     search(query, limit) {
         this.refresh();

package/dist/src/controllers/episode-hybrid.js.map

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

package/dist/src/mcp/agentdb-mcp-server.js

@@ -22,7 +22,8 @@ import { EmbeddingService } from '../controllers/EmbeddingService.js';
 import { BatchOperations } from '../optimizations/BatchOperations.js';
 import { ReasoningBank } from '../controllers/ReasoningBank.js';
 import { MCPToolCaches } from '../optimizations/ToolCache.js';
-import { validateId, validateTimestamp, validateSessionId, validateTaskString, validateNumericRange, validateArrayLength, validateBoolean, validateEnum, ValidationError, handleSecurityError, } from '../security/input-validation.js';
+import { validateId, validateTimestamp, validateSessionId, validateTaskString, validateNumericRange, validateArrayLength, validateBoolean, validateEnum, ValidationError, handleSecurityError, sanitizeText, } from '../security/input-validation.js';
+import { assertMetadata, assertTags, inTransaction, toRecordId, CrudValidationError } from '../controllers/crud-helpers.js';
 import * as path from 'path';
 import * as fs from 'fs';
 import { fileURLToPath } from 'url';
@@ -408,6 +409,141 @@ const tools = [
     // ==========================================================================
     // FRONTIER MEMORY FEATURES (EXISTING)
     // ==========================================================================
+    {
+        name: 'agentdb_get',
+        description: 'Get one stored vector record (episode) by id. Returns null when it does not exist. The embedding is omitted unless include_embedding is true.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Record id returned by agentdb_insert' },
+                include_embedding: { type: 'boolean', description: 'Also return the stored embedding vector', default: false },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'agentdb_list',
+        description: 'Page through stored vector records (episodes), newest first. Returns items plus the total count.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: { type: 'string', description: 'Only records from this session' },
+                limit: { type: 'number', description: 'Page size (1-500)', default: 50 },
+                offset: { type: 'number', description: 'Records to skip', default: 0 },
+                order: { type: 'string', enum: ['newest', 'oldest'], default: 'newest' },
+            },
+        },
+    },
+    {
+        name: 'agentdb_update',
+        description: 'Update a stored vector record in place, keeping its id. Changing text re-embeds it and refreshes the keyword index; tag or metadata changes do not re-embed. Metadata is merged (null removes a key) unless replace_metadata is true.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Record id' },
+                text: { type: 'string', description: 'New text content (re-embedded)' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Replacement tag list' },
+                metadata: { type: 'object', description: 'Metadata patch (merged by default)' },
+                replace_metadata: { type: 'boolean', description: 'Replace metadata instead of merging', default: false },
+                reward: { type: 'number', description: 'New reward value' },
+                success: { type: 'boolean', description: 'New success flag' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'agentdb_pattern_get',
+        description: 'Get one reasoning pattern by id.',
+        inputSchema: {
+            type: 'object',
+            properties: { pattern_id: { type: 'number', description: 'Pattern id' } },
+            required: ['pattern_id'],
+        },
+    },
+    {
+        name: 'agentdb_pattern_list',
+        description: 'Page through reasoning patterns, newest first, optionally filtered by task type.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_type: { type: 'string', description: 'Only patterns of this task type' },
+                limit: { type: 'number', default: 50 },
+                offset: { type: 'number', default: 0 },
+            },
+        },
+    },
+    {
+        name: 'agentdb_pattern_update',
+        description: 'Update a reasoning pattern in place. Changing taskType or approach re-embeds it. Usage statistics are not writable here (use agentdb_pattern_feedback).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern_id: { type: 'number', description: 'Pattern id' },
+                taskType: { type: 'string' },
+                approach: { type: 'string' },
+                tags: { type: 'array', items: { type: 'string' } },
+                metadata: { type: 'object', description: 'Metadata patch (merged by default)' },
+                replace_metadata: { type: 'boolean', default: false },
+            },
+            required: ['pattern_id'],
+        },
+    },
+    {
+        name: 'agentdb_pattern_delete',
+        description: 'Delete a reasoning pattern, its embedding and its vector-index entry.',
+        inputSchema: {
+            type: 'object',
+            properties: { pattern_id: { type: 'number', description: 'Pattern id' } },
+            required: ['pattern_id'],
+        },
+    },
+    {
+        name: 'skill_get',
+        description: 'Get one skill by id.',
+        inputSchema: {
+            type: 'object',
+            properties: { skill_id: { type: 'number', description: 'Skill id' } },
+            required: ['skill_id'],
+        },
+    },
+    {
+        name: 'skill_list',
+        description: 'Page through skills, newest first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                min_success_rate: { type: 'number', description: 'Only skills at or above this success rate' },
+                limit: { type: 'number', default: 50 },
+                offset: { type: 'number', default: 0 },
+            },
+        },
+    },
+    {
+        name: 'skill_update',
+        description: 'Update a skill in place. Changing name, description or signature re-embeds it; renaming onto an existing name is rejected. Usage statistics are not writable here (use agentdb_skill_feedback).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_id: { type: 'number', description: 'Skill id' },
+                name: { type: 'string' },
+                description: { type: 'string' },
+                code: { type: 'string' },
+                signature: { type: 'object', description: '{ inputs: {...}, outputs: {...} }' },
+                metadata: { type: 'object', description: 'Metadata patch (merged by default)' },
+                replace_metadata: { type: 'boolean', default: false },
+            },
+            required: ['skill_id'],
+        },
+    },
+    {
+        name: 'skill_delete',
+        description: 'Delete a skill with its embedding, links and vector-index entry.',
+        inputSchema: {
+            type: 'object',
+            properties: { skill_id: { type: 'number', description: 'Skill id' } },
+            required: ['skill_id'],
+        },
+    },
     {
         name: 'reflexion_store',
         description: 'Store an episode with self-critique for reflexion-based learning',
@@ -974,6 +1110,157 @@ const tools = [
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return { tools: filterMcpTools(tools, toolPolicy) };
 });
+/** Bulk-delete episodes together with their embeddings (FK cascades are off by default). */
+function deleteEpisodesWhere(condition, value) {
+    const changes = inTransaction(db, () => {
+        db.prepare(`DELETE FROM episode_embeddings WHERE episode_id IN (SELECT id FROM episodes WHERE ${condition})`).run(value);
+        return db.prepare(`DELETE FROM episodes WHERE ${condition}`).run(value).changes;
+    });
+    if (changes > 0) {
+        reflexion.clearCache();
+        caches.stats.clear();
+    }
+    return changes;
+}
+/** Reject arguments a tool does not define, so a typo can never silently become a no-op update. */
+function rejectUnknownArgs(args, allowed, tool) {
+    for (const key of Object.keys(args)) {
+        if (!allowed.includes(key))
+            throw new CrudValidationError(`${tool} does not accept "${key}"`, key);
+    }
+}
+function optionalString(value, field, maxLength = 100_000) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new CrudValidationError(`${field} must be a string`, field);
+    if (value.length > maxLength)
+        throw new CrudValidationError(`${field} exceeds ${maxLength} characters`, field);
+    return value;
+}
+/** Dispatch for the ADR-017 CRUD tools. Returns a JSON-serialisable result. */
+async function handleCrudTool(name, args) {
+    switch (name) {
+        case 'agentdb_get': {
+            rejectUnknownArgs(args, ['id', 'include_embedding'], name);
+            const episode = reflexion.getEpisode(toRecordId(args.id), { includeEmbedding: args.include_embedding === true });
+            if (!episode)
+                return null;
+            const { embedding, ...rest } = episode;
+            return embedding ? { ...rest, embedding: Array.from(embedding) } : rest;
+        }
+        case 'agentdb_list': {
+            rejectUnknownArgs(args, ['session_id', 'limit', 'offset', 'order'], name);
+            const order = args.order === undefined ? 'newest' : validateEnum(args.order, 'order', ['newest', 'oldest']);
+            return reflexion.listEpisodes({
+                sessionId: args.session_id === undefined ? undefined : validateSessionId(args.session_id),
+                limit: args.limit,
+                offset: args.offset,
+                order,
+            });
+        }
+        case 'agentdb_update': {
+            rejectUnknownArgs(args, ['id', 'text', 'tags', 'metadata', 'replace_metadata', 'reward', 'success'], name);
+            // agentdb_insert stores the text as both task and input, so an update keeps them in step.
+            const text = args.text === undefined ? undefined : requireText(args.text, 'text');
+            const result = await reflexion.updateEpisode(toRecordId(args.id), {
+                task: text,
+                input: text,
+                tags: args.tags === undefined ? undefined : assertTags(args.tags),
+                metadata: args.metadata === undefined ? undefined : assertMetadata(args.metadata),
+                reward: args.reward === undefined ? undefined : validateNumericRange(args.reward, 'reward', -1e6, 1e6),
+                success: args.success === undefined ? undefined : validateBoolean(args.success, 'success'),
+            }, { replaceMetadata: args.replace_metadata === true });
+            if (result)
+                caches.stats.clear();
+            return result ? { updated: true, ...result } : { updated: false, reason: 'not found' };
+        }
+        case 'agentdb_pattern_get': {
+            rejectUnknownArgs(args, ['pattern_id'], name);
+            const pattern = reasoningBank.getPattern(toRecordId(args.pattern_id, 'pattern_id'));
+            if (!pattern)
+                return null;
+            const { embedding: _omit, ...rest } = pattern;
+            return rest;
+        }
+        case 'agentdb_pattern_list': {
+            rejectUnknownArgs(args, ['task_type', 'limit', 'offset'], name);
+            return reasoningBank.listPatterns({
+                taskType: optionalString(args.task_type, 'task_type', 1000),
+                limit: args.limit,
+                offset: args.offset,
+            });
+        }
+        case 'agentdb_pattern_update': {
+            rejectUnknownArgs(args, ['pattern_id', 'taskType', 'approach', 'tags', 'metadata', 'replace_metadata'], name);
+            const result = await reasoningBank.updatePattern(toRecordId(args.pattern_id, 'pattern_id'), {
+                taskType: args.taskType === undefined ? undefined : requireText(args.taskType, 'taskType'),
+                approach: args.approach === undefined ? undefined : requireText(args.approach, 'approach'),
+                tags: args.tags === undefined ? undefined : assertTags(args.tags),
+                metadata: args.metadata === undefined ? undefined : assertMetadata(args.metadata),
+            }, { replaceMetadata: args.replace_metadata === true });
+            if (result) {
+                caches.patterns.clear();
+                caches.stats.clear();
+            }
+            if (!result)
+                return { updated: false, reason: 'not found' };
+            const { embedding: _omit, ...pattern } = result.pattern;
+            return { updated: true, ...result, pattern };
+        }
+        case 'agentdb_pattern_delete': {
+            rejectUnknownArgs(args, ['pattern_id'], name);
+            const deleted = reasoningBank.deletePattern(toRecordId(args.pattern_id, 'pattern_id'));
+            if (deleted) {
+                caches.patterns.clear();
+                caches.stats.clear();
+            }
+            return { deleted };
+        }
+        case 'skill_get': {
+            rejectUnknownArgs(args, ['skill_id'], name);
+            return skills.getSkill(toRecordId(args.skill_id, 'skill_id'));
+        }
+        case 'skill_list': {
+            rejectUnknownArgs(args, ['min_success_rate', 'limit', 'offset'], name);
+            return skills.listSkills({
+                minSuccessRate: args.min_success_rate === undefined ? undefined : validateNumericRange(args.min_success_rate, 'min_success_rate', 0, 1),
+                limit: args.limit,
+                offset: args.offset,
+            });
+        }
+        case 'skill_update': {
+            rejectUnknownArgs(args, ['skill_id', 'name', 'description', 'code', 'signature', 'metadata', 'replace_metadata'], name);
+            const result = await skills.updateSkill(toRecordId(args.skill_id, 'skill_id'), {
+                name: args.name === undefined ? undefined : requireText(args.name, 'name'),
+                description: args.description === undefined ? undefined : requireText(args.description, 'description'),
+                code: optionalString(args.code, 'code'),
+                signature: args.signature === undefined ? undefined
+                    : assertMetadata(args.signature, 'signature'),
+                metadata: args.metadata === undefined ? undefined : assertMetadata(args.metadata),
+            }, { replaceMetadata: args.replace_metadata === true });
+            if (result)
+                caches.stats.clear();
+            return result ? { updated: true, ...result } : { updated: false, reason: 'not found' };
+        }
+        case 'skill_delete': {
+            rejectUnknownArgs(args, ['skill_id'], name);
+            const deleted = skills.deleteSkill(toRecordId(args.skill_id, 'skill_id'));
+            if (deleted)
+                caches.stats.clear();
+            return { deleted };
+        }
+        default:
+            throw new CrudValidationError(`unknown CRUD tool ${name}`, 'name');
+    }
+}
+/** Non-empty text up to `maxLength`, null bytes stripped. Deliberately no content heuristics: stored text may be code. */
+function requireText(value, field, maxLength = 100_000) {
+    const text = sanitizeText(value, maxLength, field);
+    if (!text.trim())
+        throw new CrudValidationError(`${field} cannot be empty`, field);
+    return text;
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
@@ -991,7 +1278,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
                 // Initialize schema
                 initializeSchema(db);
-                const stats = db.prepare('SELECT COUNT(*) as count FROM sqlite_master WHERE type="table"').get();
+                const stats = db.prepare("SELECT COUNT(*) as count FROM sqlite_master WHERE type = 'table'").get();
                 return {
                     content: [
                         {
@@ -1006,10 +1293,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'agentdb_insert': {
-                const text = args?.text;
-                const sessionId = args?.session_id || 'default';
-                const tags = args?.tags || [];
-                const metadata = args?.metadata || {};
+                const text = requireText(args?.text, 'text');
+                const sessionId = args?.session_id === undefined ? 'default' : validateSessionId(args.session_id);
+                const tags = args?.tags === undefined ? [] : assertTags(args.tags);
+                const metadata = args?.metadata === undefined ? {} : assertMetadata(args.metadata);
                 const episodeId = await reflexion.storeEpisode({
                     sessionId,
                     task: text,
@@ -1039,19 +1326,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case 'agentdb_insert_batch': {
                 const items = validateArrayLength(args?.items ?? [], 'items', 0, MAX_INSERT_BATCH_ITEMS);
                 const batchSize = args?.batch_size || 100;
-                const episodes = items.map((item) => ({
-                    sessionId: item.session_id || 'default',
-                    task: item.text,
-                    reward: 1.0,
-                    success: true,
-                    input: item.text,
-                    output: '',
-                    critique: '',
-                    latencyMs: 0,
-                    tokensUsed: 0,
-                    tags: item.tags || [],
-                    metadata: item.metadata || {},
-                }));
+                const episodes = items.map((item, i) => {
+                    if (!item || typeof item !== 'object')
+                        throw new ValidationError(`items[${i}] must be an object`, 'INVALID_TYPE', 'items');
+                    const text = requireText(item.text, `items[${i}].text`);
+                    return {
+                        sessionId: item.session_id === undefined ? 'default' : validateSessionId(item.session_id),
+                        task: text,
+                        reward: 1.0,
+                        success: true,
+                        input: text,
+                        output: '',
+                        critique: '',
+                        latencyMs: 0,
+                        tokensUsed: 0,
+                        tags: item.tags === undefined ? [] : assertTags(item.tags, `items[${i}].tags`),
+                        metadata: item.metadata === undefined ? {} : assertMetadata(item.metadata, `items[${i}].metadata`),
+                    };
+                });
                 const batchOpsConfig = new BatchOperations(db, embeddingService, {
                     batchSize,
                     parallelism: 4,
@@ -1117,10 +1409,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     if (id !== undefined) {
                         // Validate ID
                         const validatedId = validateId(id, 'id');
-                        // Delete single vector using parameterized query
-                        const stmt = db.prepare('DELETE FROM episodes WHERE id = ?');
-                        const result = stmt.run(validatedId);
-                        deleted = result.changes;
+                        // Through the controller so the embedding, vector index and caches go with the row
+                        deleted = (await reflexion.deleteEpisode(validatedId)) ? 1 : 0;
                     }
                     else if (filters) {
                         // Bulk delete with validated filters
@@ -1128,17 +1418,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             // Validate session_id
                             const validatedSessionId = validateSessionId(filters.session_id);
                             // Use parameterized query
-                            const stmt = db.prepare('DELETE FROM episodes WHERE session_id = ?');
-                            const result = stmt.run(validatedSessionId);
-                            deleted = result.changes;
+                            deleted = deleteEpisodesWhere('session_id = ?', validatedSessionId);
                         }
                         else if (filters.before_timestamp) {
                             // Validate timestamp
                             const validatedTimestamp = validateTimestamp(filters.before_timestamp, 'before_timestamp');
                             // Use parameterized query
-                            const stmt = db.prepare('DELETE FROM episodes WHERE ts < ?');
-                            const result = stmt.run(validatedTimestamp);
-                            deleted = result.changes;
+                            deleted = deleteEpisodesWhere('ts < ?', validatedTimestamp);
                         }
                         else {
                             throw new ValidationError('Invalid or missing filter criteria', 'INVALID_FILTER');
@@ -1172,6 +1458,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
             }
             // ======================================================================
+            // CRUD: get / list / update / delete (ADR-017)
+            // ======================================================================
+            case 'agentdb_get':
+            case 'agentdb_list':
+            case 'agentdb_update':
+            case 'agentdb_pattern_get':
+            case 'agentdb_pattern_list':
+            case 'agentdb_pattern_update':
+            case 'agentdb_pattern_delete':
+            case 'skill_get':
+            case 'skill_list':
+            case 'skill_update':
+            case 'skill_delete': {
+                try {
+                    const result = await handleCrudTool(name, (args ?? {}));
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                catch (error) {
+                    const message = error instanceof CrudValidationError ? error.message : handleSecurityError(error);
+                    return { content: [{ type: 'text', text: `❌ ${name} failed: ${message}` }], isError: true };
+                }
+            }
+            // ======================================================================
             // FRONTIER MEMORY FEATURES (EXISTING)
             // ======================================================================
             case 'reflexion_store': {
@@ -2277,30 +2586,40 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'agentdb_delete_batch': {
-                const ids = args?.ids || [];
+                const ids = validateArrayLength(args?.ids ?? [], 'ids', 0, MAX_INSERT_BATCH_ITEMS);
                 const requestedTable = args?.table || 'episodes';
-                const allowedTables = new Set(['episodes', 'reasoning_patterns']);
-                if (!allowedTables.has(requestedTable)) {
-                    throw new Error(`Invalid table: ${requestedTable}`);
+                // Each table with the embedding table that must be cleaned alongside it (FK cascades are off by default)
+                const embeddingTables = {
+                    episodes: ['episode_embeddings', 'episode_id'],
+                    reasoning_patterns: ['pattern_embeddings', 'pattern_id'],
+                };
+                if (!Object.prototype.hasOwnProperty.call(embeddingTables, requestedTable)) {
+                    throw new ValidationError(`Invalid table: ${requestedTable}`, 'INVALID_TABLE', 'table');
                 }
                 if (ids.length === 0) {
                     return { content: [{ type: 'text', text: '⚠️  No IDs supplied — nothing to delete.' }] };
                 }
-                // Validate each id is a positive integer (defense in depth)
-                const safeIds = ids.map((raw) => {
-                    const n = Number(raw);
-                    if (!Number.isInteger(n) || n <= 0)
-                        throw new Error(`Invalid id: ${raw}`);
-                    return n;
-                });
+                const safeIds = ids.map((raw, i) => toRecordId(raw, `ids[${i}]`));
                 const placeholders = safeIds.map(() => '?').join(',');
-                // requestedTable is whitelist-checked above; parameterising values via ?.
-                const stmt = db.prepare(`DELETE FROM ${requestedTable} WHERE id IN (${placeholders})`);
-                const result = stmt.run(...safeIds);
+                const [embTable, embColumn] = embeddingTables[requestedTable];
+                // Table names come from the fixed map above; values are bound parameters.
+                const changes = inTransaction(db, () => {
+                    db.prepare(`DELETE FROM ${embTable} WHERE ${embColumn} IN (${placeholders})`).run(...safeIds);
+                    return db.prepare(`DELETE FROM ${requestedTable} WHERE id IN (${placeholders})`).run(...safeIds).changes;
+                });
+                if (changes > 0) {
+                    if (requestedTable === 'episodes')
+                        reflexion.clearCache();
+                    else {
+                        reasoningBank.clearCache();
+                        caches.patterns.clear();
+                    }
+                    caches.stats.clear();
+                }
                 return {
                     content: [{
                             type: 'text',
-                            text: `🗑️  Batch delete from \`${requestedTable}\`: ${result.changes}/${safeIds.length} rows removed (atomic).`,
+                            text: `🗑️  Batch delete from \`${requestedTable}\`: ${changes}/${safeIds.length} rows removed (atomic).`,
                         }],
                 };
             }
@@ -2325,11 +2644,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
     }
     catch (error) {
+        if (!(error instanceof ValidationError))
+            console.error(`[agentdb-mcp] ${name} failed:`, error);
         return {
             content: [
                 {
                     type: 'text',
-                    text: `❌ Error: ${error.message}\n${error.stack || ''}`,
+                    // The stack trace stays in the server log; clients only see the message.
+                    text: `❌ Error: ${error?.message ?? String(error)}`,
                 },
             ],
             isError: true,