velixar-mcp-server 0.2.4 → 1.2.0

package/dist/tools/memory.js

@@ -0,0 +1,275 @@
+// ── Memory CRUD Tools ──
+// store, search, list, update, delete
+// Phase 0: Added tags, before, after, tier filters (backend-side via Qdrant).
+// H1.5: _warnings array when backend may not support filter params.
+import { normalizeMemory, wrapResponse } from '../api.js';
+import { validateStoreResponse, validateSearchResponse, validateListResponse, validateMutationResponse } from '../validate.js';
+// H1.5: Track warned params to avoid cluttering every response
+const _warnedParams = new Set();
+// H6.1/Chain 9: _baseFilter — single source of truth for building search/list query params
+// All retrieval handlers must use this instead of constructing URLSearchParams directly.
+export function _baseFilter(config, args) {
+    const params = new URLSearchParams({ user_id: config.userId });
+    if (args.limit)
+        params.set('limit', String(args.limit));
+    if (args.tags)
+        params.set('tags', args.tags.join(','));
+    if (args.before)
+        params.set('before', args.before);
+    if (args.after)
+        params.set('after', args.after);
+    if (args.tier !== undefined)
+        params.set('tier', String(args.tier));
+    if (args.sort)
+        params.set('sort', args.sort);
+    return params;
+}
+export const memoryTools = [
+    {
+        name: 'velixar_store',
+        description: 'Store a memory for later retrieval. Use for important facts, decisions, user preferences, project context, or anything worth remembering long-term. ' +
+            'Memories are workspace-scoped and persist across sessions. ' +
+            'Use check_duplicate: true when storing content that may overlap with existing memories.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'The memory content to store' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags for categorization' },
+                tier: { type: 'number', description: 'Memory tier: 0=pinned, 1=session, 2=semantic (default), 3=org' },
+                quarantine_zone: { type: 'string', description: 'Optional quarantine zone ID. Memory will only be visible to zone members.' },
+                check_duplicate: { type: 'boolean', description: 'Check for near-duplicate before storing (default: false). Still stores regardless — warning is advisory.' },
+                dedup_threshold: { type: 'number', description: 'Similarity threshold for duplicate detection (default: 0.95). Only used when check_duplicate is true.' },
+                source: { type: 'string', description: 'Provenance label (e.g., "user-stated", "derived-from-analysis")' },
+                source_ids: { type: 'array', items: { type: 'string' }, description: 'Parent memory IDs for provenance linking' },
+                atomic: { type: 'boolean', description: 'Store as a single unit — never split into chunks. Use for poems, quotes, structured data that must stay whole.' },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'velixar_search',
+        description: 'Search stored memories by semantic similarity. Returns ranked results with relevance scores. ' +
+            'Supports filtering by tags, date range, tier, and memory type.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query' },
+                limit: { type: 'number', description: 'Max results (default 5)' },
+                memory_type: { type: 'string', enum: ['episodic', 'semantic'], description: 'Filter by memory type' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags (AND logic — memory must have all specified tags)' },
+                before: { type: 'string', description: 'ISO timestamp — only return memories created before this time' },
+                after: { type: 'string', description: 'ISO timestamp — only return memories created after this time' },
+                tier: { type: 'number', description: 'Filter by memory tier (0=pinned, 1=session, 2=semantic, 3=org)' },
+                full_content: { type: 'boolean', description: 'Reassemble chunked memories into full content (default: false). Use for poems, essays, or content that must be returned whole.' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'velixar_list',
+        description: 'List recent memories with pagination. Returns full metadata including IDs, tags, and timestamps. ' +
+            'Supports filtering by tags, date range, tier, and memory type.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max results (default 10)' },
+                cursor: { type: 'string', description: 'Pagination cursor from previous response' },
+                memory_type: { type: 'string', enum: ['episodic', 'semantic'], description: 'Filter by memory type' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags (AND logic)' },
+                before: { type: 'string', description: 'ISO timestamp — only return memories created before this time' },
+                after: { type: 'string', description: 'ISO timestamp — only return memories created after this time' },
+                tier: { type: 'number', description: 'Filter by memory tier (0=pinned, 1=session, 2=semantic, 3=org)' },
+                sort: { type: 'string', enum: ['recent', 'oldest', 'tier'], description: 'Sort order (default: recent)' },
+                count_only: { type: 'boolean', description: 'Return only the total count, no memory content' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'velixar_update',
+        description: "Update an existing memory's content or tags.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                memory_id: { type: 'string', description: 'Memory ID to update' },
+                id: { type: 'string', description: 'Alias for memory_id (backward compat)' },
+                content: { type: 'string', description: 'New content' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'New tags' },
+            },
+        },
+    },
+    {
+        name: 'velixar_delete',
+        description: 'Delete or archive memories. Use archive: true for soft-delete (recoverable).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                memory_id: { type: 'string', description: 'Memory ID to delete (single)' },
+                id: { type: 'string', description: 'Alias for memory_id (backward compat)' },
+                ids: { type: 'array', items: { type: 'string' }, description: 'Memory IDs to delete (bulk)' },
+                archive: { type: 'boolean', description: 'Soft-delete: set archived=true instead of hard-deleting (default: false)' },
+            },
+        },
+    },
+];
+export async function handleMemoryTool(name, args, api, config) {
+    if (name === 'velixar_store') {
+        // Build 1.1: Opt-in dedup check
+        let similar_existing = null;
+        if (args.check_duplicate) {
+            const threshold = args.dedup_threshold ?? 0.95;
+            try {
+                const content = args.content;
+                // Skip dedup for very long content (embedding token limit)
+                if (content.length < 25000) {
+                    const searchParams = new URLSearchParams({ q: content.slice(0, 500), user_id: config.userId, limit: '1' });
+                    const searchRaw = await api.get(`/memory/search?${searchParams}`, false);
+                    const searchResult = validateSearchResponse(searchRaw, '/memory/search');
+                    if (searchResult.memories.length > 0) {
+                        const top = searchResult.memories[0];
+                        const score = top.score ?? 0;
+                        if (score >= threshold) {
+                            similar_existing = {
+                                id: top.id,
+                                content_preview: (top.content || '').slice(0, 200),
+                                similarity: Math.round(score * 1000) / 1000,
+                                threshold_used: threshold,
+                            };
+                        }
+                    }
+                }
+            }
+            catch {
+                // Dedup check failed — store anyway (H2.7: graceful fallback)
+            }
+        }
+        // Build 1.2: Provenance params
+        const storeBody = {
+            content: args.content,
+            user_id: config.userId,
+            tier: args.tier ?? 2,
+            tags: args.tags || [],
+            author: { type: 'agent', agent_id: config.userId },
+            source_type: args.source || 'mcp_store',
+            quarantine_zone: args.quarantine_zone || null,
+            no_chunk: args.atomic === true,
+        };
+        if (args.source_ids)
+            storeBody.previous_memory_id = args.source_ids[0] || null;
+        const raw = await api.post('/memory', storeBody);
+        const result = validateStoreResponse(raw, '/memory');
+        const responseData = { id: result.id, action: 'stored' };
+        if (similar_existing)
+            responseData.similar_existing = similar_existing;
+        return { text: JSON.stringify(wrapResponse(responseData, config)) };
+    }
+    if (name === 'velixar_search') {
+        const params = _baseFilter(config, args);
+        params.set('q', args.query);
+        if (args.full_content)
+            params.set('reassemble', 'true');
+        const raw = await api.get(`/memory/search?${params}`, true);
+        const result = validateSearchResponse(raw, '/memory/search');
+        let items = result.memories.map(m => {
+            const mem = normalizeMemory(m);
+            mem.workspace_id = config.workspaceId;
+            return mem;
+        });
+        if (args.memory_type)
+            items = items.filter(m => m.memory_type === args.memory_type);
+        // H1.5: Verify backend actually applied filters — warn if results don't match
+        const _warnings = [];
+        if (args.tags && items.length > 0) {
+            const requiredTags = args.tags;
+            const unfiltered = items.filter(m => !requiredTags.every(t => m.tags.includes(t)));
+            if (unfiltered.length > 0) {
+                items = items.filter(m => requiredTags.every(t => m.tags.includes(t)));
+                if (!_warnedParams.has('search:tags')) {
+                    _warnings.push('tags filter may not be fully supported by backend — applied client-side fallback');
+                    _warnedParams.add('search:tags');
+                }
+            }
+        }
+        return {
+            text: JSON.stringify(wrapResponse({ items, count: items.length, ...(_warnings.length ? { _warnings } : {}) }, config, { data_absent: items.length === 0 })),
+        };
+    }
+    if (name === 'velixar_list') {
+        const params = _baseFilter(config, args);
+        if (args.cursor)
+            params.set('cursor', args.cursor);
+        const raw = await api.get(`/memory/list?${params}`, true);
+        const result = validateListResponse(raw, '/memory/list');
+        let items = result.memories.map(m => {
+            const mem = normalizeMemory(m);
+            mem.workspace_id = config.workspaceId;
+            return mem;
+        });
+        if (args.memory_type)
+            items = items.filter(m => m.memory_type === args.memory_type);
+        if (args.count_only) {
+            return { text: JSON.stringify(wrapResponse({ count: items.length }, config)) };
+        }
+        return {
+            text: JSON.stringify(wrapResponse({ items, count: items.length, cursor: result.cursor }, config, { data_absent: items.length === 0 })),
+        };
+    }
+    if (name === 'velixar_update') {
+        const memoryId = (args.memory_id || args.id);
+        if (!memoryId)
+            throw new Error('memory_id or id required');
+        const body = { user_id: config.userId };
+        if (args.content)
+            body.content = args.content;
+        if (args.tags)
+            body.tags = args.tags;
+        const raw = await api.patch(`/memory/${memoryId}`, body);
+        validateMutationResponse(raw, `/memory/${memoryId}`);
+        return { text: JSON.stringify(wrapResponse({ id: memoryId, action: 'updated' }, config)) };
+    }
+    if (name === 'velixar_delete') {
+        const archive = args.archive;
+        const targetIds = args.ids
+            ? args.ids
+            : (args.memory_id || args.id) ? [(args.memory_id || args.id)] : [];
+        if (targetIds.length === 0)
+            throw new Error('id or ids required');
+        if (archive) {
+            // Build 1.5: Soft-delete via archive — bulk all-or-nothing (H6.6)
+            // Archive = update with archived: true
+            const results = [];
+            for (const mid of targetIds) {
+                try {
+                    const body = { user_id: config.userId, archived: true };
+                    await api.patch(`/memory/${mid}`, body);
+                    results.push({ id: mid, status: 'archived' });
+                }
+                catch {
+                    // H6.6: If any fails, report but continue (best-effort for archive)
+                    results.push({ id: mid, status: 'error' });
+                }
+            }
+            return { text: JSON.stringify(wrapResponse({ results, action: 'archived', count: results.filter(r => r.status === 'archived').length }, config)) };
+        }
+        // Hard delete
+        if (targetIds.length === 1) {
+            const raw = await api.delete(`/memory/${targetIds[0]}`);
+            validateMutationResponse(raw, `/memory/${targetIds[0]}`);
+            return { text: JSON.stringify(wrapResponse({ id: targetIds[0], action: 'deleted' }, config)) };
+        }
+        // Bulk hard delete
+        const results = [];
+        for (const mid of targetIds) {
+            try {
+                await api.delete(`/memory/${mid}`);
+                results.push({ id: mid, status: 'deleted' });
+            }
+            catch {
+                results.push({ id: mid, status: 'error' });
+            }
+        }
+        return { text: JSON.stringify(wrapResponse({ results, action: 'deleted', count: results.filter(r => r.status === 'deleted').length }, config)) };
+    }
+    throw new Error(`Unknown memory tool: ${name}`);
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/tools/recall.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ApiClient } from '../api.js';
+import type { ApiConfig } from '../types.js';
+export declare const recallTools: Tool[];
+export declare function handleRecallTool(name: string, args: Record<string, unknown>, api: ApiClient, config: ApiConfig): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=recall.d.ts.map

package/dist/tools/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/tools/recall.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAKzD,eAAO,MAAM,WAAW,EAAE,IAAI,EA0B7B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8L9C"}

package/dist/tools/recall.js

@@ -0,0 +1,206 @@
+// ── Recall Tools ──
+// velixar_context — synthesized workspace brief (flagship)
+// velixar_inspect — deep single-memory inspection
+import { normalizeMemory, wrapResponse } from '../api.js';
+import { justify } from '../justify.js';
+import { validateSearchResponse, validateListResponse, validateOverviewResponse } from '../validate.js';
+import { temporalMerge, mergeMultiQueryResults } from '../temporal_merge.js';
+export const recallTools = [
+    {
+        name: 'velixar_context',
+        description: 'Synthesize the best working brief for the current workspace. Recommended first tool for any new task. ' +
+            'Returns summary, relevant facts, open issues, contradiction flags, and pattern hints.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                topic: { type: 'string', description: 'Optional topic to focus the brief on' },
+                compact: { type: 'boolean', description: 'Compact mode (default true) — shorter summary' },
+            },
+        },
+    },
+    {
+        name: 'velixar_inspect',
+        description: 'Deep inspection of a specific memory — raw content, provenance, relations, chain links.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                memory_id: { type: 'string', description: 'Memory ID to inspect' },
+            },
+            required: ['memory_id'],
+        },
+    },
+];
+export async function handleRecallTool(name, args, api, config) {
+    if (name === 'velixar_context') {
+        const topic = args.topic || '';
+        const compact = args.compact !== false;
+        const multiAngle = process.env.VELIXAR_CONTEXT_MULTI_ANGLE === 'true';
+        const listParams = new URLSearchParams({ user_id: config.userId, limit: '5' });
+        const startMs = Date.now();
+        // Build search queries — single or multi-angle based on feature flag
+        let searchPromises;
+        if (multiAngle && topic) {
+            const angles = [topic, `decisions about ${topic}`, `problems or issues with ${topic}`];
+            const perAngleLimit = compact ? '3' : '5';
+            searchPromises = angles.map(q => {
+                const p = new URLSearchParams({ q, user_id: config.userId, limit: perAngleLimit });
+                return api.get(`/memory/search?${p}`, true);
+            });
+        }
+        else if (multiAngle && !topic) {
+            const angles = ['important recent context', 'open decisions', 'unresolved issues'];
+            searchPromises = angles.map(q => {
+                const p = new URLSearchParams({ q, user_id: config.userId, limit: compact ? '3' : '5' });
+                return api.get(`/memory/search?${p}`, true);
+            });
+        }
+        else {
+            const searchQ = topic || 'important recent context';
+            const params = new URLSearchParams({ q: searchQ, user_id: config.userId, limit: compact ? '5' : '10' });
+            searchPromises = [api.get(`/memory/search?${params}`, true)];
+        }
+        const [searchResults, listRes, overviewRes, contradictionsRes] = await Promise.allSettled([
+            Promise.allSettled(searchPromises),
+            api.get(`/memory/list?${listParams}`, true),
+            api.get('/exocortex/overview', true),
+            api.get('/exocortex/contradictions?status=open', true),
+        ]);
+        // Merge search results — multi-angle dedup or single pass
+        let relevantFacts = [];
+        const searchAnglesUsed = searchPromises.length;
+        if (searchResults.status === 'fulfilled') {
+            const subResults = searchResults.value;
+            if (multiAngle && subResults.length > 1) {
+                // Multi-angle: merge + dedup via temporal_merge
+                const perQuery = subResults.map((r, i) => {
+                    if (r.status !== 'fulfilled')
+                        return { query: `angle-${i}`, memories: [] };
+                    try {
+                        const validated = validateSearchResponse(r.value, '/memory/search');
+                        return {
+                            query: `angle-${i}`,
+                            memories: validated.memories.map(m => { const mem = normalizeMemory(m); mem.workspace_id = config.workspaceId; return mem; }),
+                        };
+                    }
+                    catch {
+                        return { query: `angle-${i}`, memories: [] };
+                    }
+                });
+                const { merged } = mergeMultiQueryResults(perQuery, 'weighted', compact ? 8 : 15);
+                const temporal = temporalMerge(merged);
+                relevantFacts = temporal.current;
+            }
+            else {
+                // Single angle
+                const r = subResults[0];
+                if (r && r.status === 'fulfilled') {
+                    try {
+                        const validated = validateSearchResponse(r.value, '/memory/search');
+                        relevantFacts = validated.memories.map(m => { const mem = normalizeMemory(m); mem.workspace_id = config.workspaceId; return mem; });
+                    }
+                    catch { /* empty */ }
+                }
+            }
+        }
+        // Sort: semantic first, then by relevance
+        relevantFacts.sort((a, b) => {
+            if (a.memory_type === 'semantic' && b.memory_type !== 'semantic')
+                return -1;
+            if (a.memory_type !== 'semantic' && b.memory_type === 'semantic')
+                return 1;
+            return (b.relevance ?? 0) - (a.relevance ?? 0);
+        });
+        const list = listRes.status === 'fulfilled' ? validateListResponse(listRes.value, '/memory/list') : null;
+        const overview = overviewRes.status === 'fulfilled' ? validateOverviewResponse(overviewRes.value, '/exocortex/overview') : null;
+        const contradictionsRaw = contradictionsRes.status === 'fulfilled'
+            ? ((contradictionsRes.value && typeof contradictionsRes.value === 'object') ? contradictionsRes.value : {})
+            : null;
+        // Recent activity from list
+        const recentItems = (list?.memories || []).map(m => {
+            const mem = normalizeMemory(m);
+            mem.workspace_id = config.workspaceId;
+            return mem;
+        });
+        // Contradiction flags
+        const rawCArr = contradictionsRaw ? (Array.isArray(contradictionsRaw.contradictions) ? contradictionsRaw.contradictions : []) : [];
+        const openContradictions = rawCArr.map((c) => ({
+            id: c.id,
+            statement_a: c.statement_a || c.memory_a_content,
+            statement_b: c.statement_b || c.memory_b_content,
+            severity: c.severity || 'medium',
+        }));
+        // Build brief
+        const brief = {
+            summary: overview
+                ? `Workspace has ${overview.total_memories || 0} memories, ${overview.cortex_nodes || 0} entities, ${overview.temporal_chains || 0} chains. Mode: ${overview.system_mode || 'unknown'}.`
+                : `${relevantFacts.length} relevant facts found${topic ? ` for "${topic}"` : ''}.`,
+            relevant_facts: relevantFacts,
+            recent_activity: compact ? recentItems.slice(0, 3) : recentItems,
+            open_issues: openContradictions,
+            contradiction_count: openContradictions.length,
+            pattern_hints: [],
+            // Phase 4: Multi-angle search metadata
+            ...(multiAngle ? { search_angles_used: searchAnglesUsed } : {}),
+            section_freshness: {
+                relevant_facts: { source: multiAngle ? 'multi_angle_search' : 'search', fetched_at: new Date().toISOString() },
+                recent_activity: { source: 'list', fetched_at: new Date().toISOString() },
+                overview: overviewRes.status === 'fulfilled' ? { source: 'overview', fetched_at: new Date().toISOString() } : { source: 'overview', status: 'unavailable' },
+                contradictions: contradictionsRes.status === 'fulfilled' ? { source: 'contradictions', fetched_at: new Date().toISOString() } : { source: 'contradictions', status: 'unavailable' },
+            },
+            justification: justify(overview
+                ? `Workspace context synthesis from ${overview.total_memories || 0} memories`
+                : `Context synthesis from ${relevantFacts.length} relevant facts`, 'synthesized_summary', relevantFacts, config.workspaceId, { contradictionCount: openContradictions.length }),
+        };
+        const partial = [searchResults, listRes, overviewRes, contradictionsRes].some(r => r.status === 'rejected');
+        const contextMs = Date.now() - startMs;
+        return {
+            text: JSON.stringify(wrapResponse(brief, config, {
+                data_absent: relevantFacts.length === 0 && recentItems.length === 0,
+                partial_context: partial,
+                contradictions_present: openContradictions.length > 0,
+                request_ms: contextMs,
+            })),
+        };
+    }
+    if (name === 'velixar_inspect') {
+        const id = args.memory_id;
+        const raw = await api.get(`/memory/${id}`, true);
+        if (!raw || typeof raw !== 'object')
+            throw new Error(`Memory ${id} not found`);
+        const result = raw;
+        if (result.error)
+            throw new Error(String(result.error));
+        if (!result.memory || typeof result.memory !== 'object')
+            throw new Error(`Memory ${id} not found`);
+        const rawMem = result.memory;
+        const mem = normalizeMemory({
+            id: String(rawMem.id || ''),
+            content: String(rawMem.content || ''),
+            score: typeof rawMem.score === 'number' ? rawMem.score : undefined,
+            tier: typeof rawMem.tier === 'number' ? rawMem.tier : undefined,
+            type: typeof rawMem.type === 'string' ? rawMem.type : null,
+            tags: Array.isArray(rawMem.tags) ? rawMem.tags.filter((t) => typeof t === 'string') : [],
+            salience: typeof rawMem.salience === 'number' ? rawMem.salience : undefined,
+            created_at: typeof rawMem.created_at === 'string' ? rawMem.created_at : undefined,
+            updated_at: typeof rawMem.updated_at === 'string' ? rawMem.updated_at : undefined,
+            previous_memory_id: typeof rawMem.previous_memory_id === 'string' ? rawMem.previous_memory_id : null,
+        });
+        mem.workspace_id = config.workspaceId;
+        // H17: Validate provenance — check derived_from IDs exist
+        let provenanceStatus;
+        if (mem.provenance.derived_from?.length) {
+            const checks = await Promise.allSettled(mem.provenance.derived_from.map(refId => api.get(`/memory/${refId}`, true)));
+            provenanceStatus = mem.provenance.derived_from.map((refId, i) => {
+                if (checks[i].status !== 'fulfilled')
+                    return { id: refId, status: 'deleted' };
+                const val = checks[i].status === 'fulfilled' ? checks[i].value : null;
+                const hasMemory = val && typeof val === 'object' && 'memory' in val && val.memory;
+                return { id: refId, status: hasMemory ? 'exists' : 'deleted' };
+            });
+        }
+        const justification = justify(`Inspection of memory ${id}`, 'retrieved_fact', [mem], config.workspaceId);
+        return { text: JSON.stringify(wrapResponse({ memory: mem, justification, ...(provenanceStatus ? { provenance_validation: provenanceStatus } : {}) }, config)) };
+    }
+    throw new Error(`Unknown recall tool: ${name}`);
+}
+//# sourceMappingURL=recall.js.map

package/dist/tools/recall.js.map

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

package/dist/tools/retrieval.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ApiClient } from '../api.js';
+import type { ApiConfig } from '../types.js';
+export declare const retrievalTools: Tool[];
+export declare function handleRetrievalTool(name: string, args: Record<string, unknown>, api: ApiClient, config: ApiConfig): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/tools/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/tools/retrieval.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAKzD,eAAO,MAAM,cAAc,EAAE,IAAI,EAmDhC,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA6S9C"}