velixar-mcp-server 0.2.4 → 1.2.0

package/dist/tools/graph.js

@@ -0,0 +1,263 @@
+// ── Graph Tools ──
+// velixar_graph_traverse, velixar_graph_search, velixar_graph_stats
+// Phase 3: KG expansion — search, stats, filtered traversal.
+// All responses pass through graph_sanitizer.ts (H4.6).
+import { wrapResponse } from '../api.js';
+import { validateGraphResponse } from '../validate.js';
+import { sanitizeGraph } from './graph_sanitizer.js';
+// M13: Graph traverse usage telemetry
+let _graphTraverseCount = 0;
+let _graphTraverseNoEntity = 0;
+export function getGraphTelemetry() {
+    return { total_calls: _graphTraverseCount, no_entity_calls: _graphTraverseNoEntity, listing_pct: _graphTraverseCount > 0 ? Math.round((_graphTraverseNoEntity / _graphTraverseCount) * 100) : 0 };
+}
+export const graphTools = [
+    {
+        name: 'velixar_graph_traverse',
+        description: 'Walk relationships from an entity — "what connects to X?" ' +
+            'Supports fuzzy entity matching, relationship and entity type filtering.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entity: { type: 'string', description: 'Entity name to traverse from' },
+                depth: { type: 'number', description: 'Max traversal depth / hops (default 2, max 10)' },
+                relationship_type: { type: 'string', description: 'Filter edges by relationship type' },
+                entity_type: { type: 'string', description: 'Filter target nodes by entity type' },
+            },
+            required: ['entity'],
+        },
+    },
+    {
+        name: 'velixar_graph_search',
+        description: 'Fuzzy entity search by name or type. Use to find entities without knowing exact names.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Entity name to search for (fuzzy)' },
+                entity_type: { type: 'string', description: 'Filter by entity type' },
+                limit: { type: 'number', description: 'Max results (default 10)' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'velixar_graph_stats',
+        description: 'KG overview — entity count, relationship count, top entity types. Workspace-scoped.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+export async function handleGraphTool(name, args, api, config) {
+    if (name === 'velixar_graph_traverse') {
+        _graphTraverseCount++;
+        if (!args.entity)
+            _graphTraverseNoEntity++;
+        const relationshipType = args.relationship_type;
+        const entityType = args.entity_type;
+        try {
+            const raw = await api.post('/graph/traverse', {
+                entity: args.entity,
+                max_hops: Math.min(args.depth || 2, 10),
+            });
+            const result = validateGraphResponse(raw, '/graph/traverse');
+            // H4.6: Sanitize through graph_sanitizer
+            const sanitized = sanitizeGraph(result.nodes.map(n => n), result.edges.map(e => e));
+            // Build 3.3: Apply relationship_type and entity_type filters
+            let filteredEdges = sanitized.edges;
+            if (relationshipType) {
+                filteredEdges = filteredEdges.filter(e => e.relationship === relationshipType);
+            }
+            let filteredNodes = sanitized.nodes;
+            if (entityType) {
+                const root = filteredNodes[0];
+                filteredNodes = filteredNodes.filter((n, i) => i === 0 || n.entity_type === entityType);
+            }
+            // If filtering edges, also filter nodes to only connected ones
+            if (relationshipType) {
+                const connectedIds = new Set();
+                connectedIds.add(String(args.entity));
+                for (const e of filteredEdges) {
+                    connectedIds.add(e.source);
+                    connectedIds.add(e.target);
+                }
+                filteredNodes = filteredNodes.filter(n => connectedIds.has(n.id) || connectedIds.has(n.label));
+            }
+            const root = filteredNodes[0] || { id: args.entity, entity_type: 'unknown', label: args.entity };
+            // H12: Cross-memory relationship inference
+            let implicitConnections = [];
+            if (filteredNodes.length > 1) {
+                const entityLabels = filteredNodes.slice(1, 4).map(n => n.label);
+                try {
+                    const crossSearch = await Promise.allSettled(entityLabels.map(label => {
+                        const p = new URLSearchParams({ q: `${args.entity} ${label}`, limit: '3' });
+                        return api.get(`/memory/search?${p}`, true);
+                    }));
+                    implicitConnections = crossSearch
+                        .map((r, i) => {
+                        if (r.status !== 'fulfilled')
+                            return { entity: entityLabels[i], memory_count: 0 };
+                        const rObj = (r.value && typeof r.value === 'object') ? r.value : {};
+                        const mems = Array.isArray(rObj.memories) ? rObj.memories : [];
+                        return { entity: entityLabels[i], memory_count: mems.length };
+                    })
+                        .filter(c => c.memory_count > 0);
+                }
+                catch { /* non-blocking */ }
+            }
+            return {
+                text: JSON.stringify(wrapResponse({
+                    root,
+                    relations: filteredEdges,
+                    connected_entities: filteredNodes.slice(1),
+                    depth_reached: result.hops ?? 0,
+                    ...(relationshipType ? { relationship_filter: relationshipType } : {}),
+                    ...(entityType ? { entity_type_filter: entityType } : {}),
+                    ...(implicitConnections.length ? { implicit_connections: implicitConnections } : {}),
+                }, config, {
+                    data_absent: filteredNodes.length === 0,
+                })),
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (msg.includes('404') || msg.includes('not found')) {
+                // Build 3.3: Fuzzy entity matching — search for closest match
+                try {
+                    const fuzzyRaw = await api.post('/graph/search', {
+                        query: args.entity, limit: 1,
+                    });
+                    const fObj = (fuzzyRaw && typeof fuzzyRaw === 'object') ? fuzzyRaw : {};
+                    const fEntities = Array.isArray(fObj.entities) ? fObj.entities : [];
+                    if (fEntities.length > 0) {
+                        const match = fEntities[0];
+                        const matchName = String(match.name || match.label || '');
+                        if (matchName) {
+                            // Retry traverse with fuzzy match
+                            const retryRaw = await api.post('/graph/traverse', {
+                                entity: matchName,
+                                max_hops: Math.min(args.depth || 2, 10),
+                            });
+                            const retryResult = validateGraphResponse(retryRaw, '/graph/traverse');
+                            const sanitized = sanitizeGraph(retryResult.nodes.map(n => n), retryResult.edges.map(e => e));
+                            const root = sanitized.nodes[0] || { id: matchName, entity_type: 'unknown', label: matchName };
+                            return {
+                                text: JSON.stringify(wrapResponse({
+                                    root,
+                                    relations: sanitized.edges,
+                                    connected_entities: sanitized.nodes.slice(1),
+                                    depth_reached: retryResult.hops ?? 0,
+                                    fuzzy_match: { requested: args.entity, matched: matchName },
+                                }, config)),
+                            };
+                        }
+                    }
+                }
+                catch { /* fuzzy search unavailable */ }
+                return {
+                    text: JSON.stringify(wrapResponse({ nodes: [], edges: [], hops: 0, entity: args.entity, message: 'Entity not found in knowledge graph' }, config, { data_absent: true })),
+                };
+            }
+            throw e;
+        }
+    }
+    // Build 3.1: velixar_graph_search
+    if (name === 'velixar_graph_search') {
+        const query = args.query;
+        const entityType = args.entity_type;
+        const limit = Math.min(args.limit || 10, 50);
+        try {
+            const raw = await api.post('/graph/search', {
+                query, entity_type: entityType, limit,
+            });
+            const rObj = (raw && typeof raw === 'object') ? raw : {};
+            const rawEntities = Array.isArray(rObj.entities) ? rObj.entities : [];
+            const entities = rawEntities.map((e) => {
+                if (!e || typeof e !== 'object')
+                    return null;
+                const ent = e;
+                return sanitizeGraph([ent], []).nodes[0];
+            }).filter((e) => e !== null).slice(0, limit);
+            return {
+                text: JSON.stringify(wrapResponse({
+                    entities,
+                    count: entities.length,
+                    query,
+                    ...(entityType ? { entity_type_filter: entityType } : {}),
+                }, config, {
+                    data_absent: entities.length === 0,
+                })),
+            };
+        }
+        catch (e) {
+            // Fallback: use traverse with depth 0 as a search proxy
+            try {
+                const raw = await api.post('/graph/traverse', { entity: query, max_hops: 1 });
+                const result = validateGraphResponse(raw, '/graph/traverse');
+                const sanitized = sanitizeGraph(result.nodes.map(n => n), result.edges.map(e => e));
+                return {
+                    text: JSON.stringify(wrapResponse({
+                        entities: sanitized.nodes,
+                        count: sanitized.nodes.length,
+                        query,
+                        _fallback: true,
+                    }, config, {
+                        data_absent: sanitized.nodes.length === 0,
+                    })),
+                };
+            }
+            catch {
+                return {
+                    text: JSON.stringify(wrapResponse({ entities: [], count: 0, query, message: 'No entities found' }, config, { data_absent: true })),
+                };
+            }
+        }
+    }
+    // Build 3.2: velixar_graph_stats
+    if (name === 'velixar_graph_stats') {
+        try {
+            const raw = await api.get('/graph/stats', true);
+            const rObj = (raw && typeof raw === 'object') ? raw : {};
+            return {
+                text: JSON.stringify(wrapResponse({
+                    entity_count: typeof rObj.entity_count === 'number' ? rObj.entity_count : 0,
+                    relationship_count: typeof rObj.relationship_count === 'number' ? rObj.relationship_count : 0,
+                    top_entity_types: Array.isArray(rObj.top_entity_types) ? rObj.top_entity_types : [],
+                    density: typeof rObj.density === 'number' ? rObj.density : undefined,
+                }, config)),
+            };
+        }
+        catch {
+            // Fallback: derive stats from a broad traverse
+            try {
+                const raw = await api.post('/graph/traverse', { entity: '*', max_hops: 1 });
+                const result = validateGraphResponse(raw, '/graph/traverse');
+                const typeCount = {};
+                for (const n of result.nodes) {
+                    const t = n.entity_type || 'unknown';
+                    typeCount[t] = (typeCount[t] || 0) + 1;
+                }
+                const topTypes = Object.entries(typeCount)
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 10)
+                    .map(([type, count]) => ({ type, count }));
+                return {
+                    text: JSON.stringify(wrapResponse({
+                        entity_count: result.nodes.length,
+                        relationship_count: result.edges.length,
+                        top_entity_types: topTypes,
+                        _fallback: true,
+                    }, config)),
+                };
+            }
+            catch {
+                return {
+                    text: JSON.stringify(wrapResponse({ entity_count: 0, relationship_count: 0, top_entity_types: [], message: 'Graph stats unavailable' }, config, { data_absent: true })),
+                };
+            }
+        }
+    }
+    throw new Error(`Unknown graph tool: ${name}`);
+}
+//# sourceMappingURL=graph.js.map

package/dist/tools/graph.js.map

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

package/dist/tools/graph_sanitizer.d.ts

@@ -0,0 +1,24 @@
+export type SanitizeMode = 'user' | 'debug';
+export interface SanitizedNode {
+    id: string;
+    label: string;
+    entity_type: string;
+    relevance?: number;
+    relationship_count?: number;
+    [key: string]: unknown;
+}
+export interface SanitizedEdge {
+    source: string;
+    target: string;
+    relationship: string;
+    relevance?: number;
+    [key: string]: unknown;
+}
+export declare function sanitizeNode(raw: Record<string, unknown>, mode?: SanitizeMode): SanitizedNode;
+export declare function sanitizeEdge(raw: Record<string, unknown>, mode?: SanitizeMode): SanitizedEdge;
+/** O(n) single-pass sanitization for graph responses */
+export declare function sanitizeGraph(nodes: Record<string, unknown>[], edges: Record<string, unknown>[], mode?: SanitizeMode): {
+    nodes: SanitizedNode[];
+    edges: SanitizedEdge[];
+};
+//# sourceMappingURL=graph_sanitizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph_sanitizer.d.ts","sourceRoot":"","sources":["../../src/tools/graph_sanitizer.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAoC5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,GAAE,YAAqB,GAAG,aAAa,CAcrG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,GAAE,YAAqB,GAAG,aAAa,CAerG;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,IAAI,GAAE,YAAqB,GAC1B;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAKpD"}

package/dist/tools/graph_sanitizer.js

@@ -0,0 +1,79 @@
+// ── Graph Sanitizer ──
+// H4.6: Single sanitization module for all KG responses.
+// O(n) single-pass. All KG tool responses pass through here.
+// H4.5: Abstract relationship type mapping (internal → user-facing).
+// H4.7: Field allowlists — new fields invisible by default.
+// H4.5: Relationship type mapping — preserves semantics where possible
+const RELATIONSHIP_MAP = {
+    relates_to: 'relates_to',
+    depends_on: 'depends_on',
+    contradicts: 'contradicts',
+    supports: 'supports',
+    derived_from: 'derived_from',
+    supersedes: 'supersedes',
+    alias: 'alias',
+    also_known_as: 'alias',
+    synonym: 'alias',
+    part_of: 'part_of',
+    contains: 'contains',
+    causes: 'causes',
+    blocks: 'blocks',
+    implements: 'implements',
+    references: 'references',
+    // Internal types → generic
+    derived_from_snowflake_table: 'derived_from',
+    derived_from_postgres: 'derived_from',
+    extracted_from_memory: 'derived_from',
+    co_occurrence: 'relates_to',
+    embedding_similarity: 'relates_to',
+};
+// H4.7: Field allowlists
+const USER_NODE_FIELDS = new Set(['id', 'label', 'entity_type', 'relevance', 'relationship_count']);
+const USER_EDGE_FIELDS = new Set(['source', 'target', 'relationship', 'relevance']);
+const DEBUG_NODE_FIELDS = new Set([...USER_NODE_FIELDS, 'properties', 'extraction_model', 'confidence', 'created_at']);
+const DEBUG_EDGE_FIELDS = new Set([...USER_EDGE_FIELDS, 'confidence', 'created_at', 'raw_type']);
+// Security-sensitive fields — never exposed in any mode
+const BLOCKED_FIELDS = new Set(['hmac_key', 'workspace_id', 'internal_id', 'embedding', 'vector']);
+export function sanitizeNode(raw, mode = 'user') {
+    const allowlist = mode === 'debug' ? DEBUG_NODE_FIELDS : USER_NODE_FIELDS;
+    const result = {};
+    for (const key of Object.keys(raw)) {
+        if (BLOCKED_FIELDS.has(key))
+            continue;
+        if (allowlist.has(key))
+            result[key] = raw[key];
+    }
+    return {
+        id: String(result.id || ''),
+        label: String(result.label || raw.name || raw.id || ''),
+        entity_type: String(result.entity_type || raw.type || 'unknown'),
+        relevance: typeof result.relevance === 'number' ? result.relevance : undefined,
+        ...result,
+    };
+}
+export function sanitizeEdge(raw, mode = 'user') {
+    const allowlist = mode === 'debug' ? DEBUG_EDGE_FIELDS : USER_EDGE_FIELDS;
+    const rawType = String(raw.relationship || raw.relation_type || raw.label || 'relates_to');
+    const result = {};
+    for (const key of Object.keys(raw)) {
+        if (BLOCKED_FIELDS.has(key))
+            continue;
+        if (allowlist.has(key))
+            result[key] = raw[key];
+    }
+    return {
+        source: String(result.source || raw.from || ''),
+        target: String(result.target || raw.to || ''),
+        relationship: RELATIONSHIP_MAP[rawType] || 'relates_to',
+        relevance: typeof result.relevance === 'number' ? result.relevance : undefined,
+        ...(mode === 'debug' ? { raw_type: rawType } : {}),
+    };
+}
+/** O(n) single-pass sanitization for graph responses */
+export function sanitizeGraph(nodes, edges, mode = 'user') {
+    return {
+        nodes: nodes.map(n => sanitizeNode(n, mode)),
+        edges: edges.map(e => sanitizeEdge(e, mode)),
+    };
+}
+//# sourceMappingURL=graph_sanitizer.js.map

package/dist/tools/graph_sanitizer.js.map

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

package/dist/tools/lifecycle.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 lifecycleTools: Tool[];
+export declare function handleLifecycleTool(name: string, args: Record<string, unknown>, api: ApiClient, config: ApiConfig): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAkDzD,eAAO,MAAM,cAAc,EAAE,IAAI,EAgMhC,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,CA05B9C"}