velixar-mcp-server 0.2.4 → 1.2.0

package/dist/types.d.ts

@@ -0,0 +1,234 @@
+export type ResponseStatus = 'ok' | 'partial' | 'stale' | 'error';
+export interface ResponseMeta {
+    workspace_id: string;
+    confidence: number;
+    staleness: 'fresh' | 'recent' | 'stale';
+    contradictions_present: boolean;
+    data_absent: boolean;
+    absence_reason?: AbsenceReason;
+    partial_context: boolean;
+    request_ms: number;
+    cached?: boolean;
+    sufficient_answer?: boolean;
+}
+export interface VelixarResponse<T> {
+    status: ResponseStatus;
+    data: T;
+    meta: ResponseMeta;
+}
+export interface VelixarError {
+    status: 'error';
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        details?: Record<string, unknown>;
+    };
+}
+export type MemoryType = 'episodic' | 'semantic';
+export type SourceType = 'user' | 'distill' | 'inferred' | 'imported';
+export type AuthorType = 'user' | 'agent' | 'pipeline' | 'distill';
+export interface Author {
+    type: AuthorType;
+    agent_id?: string;
+    session_id?: string;
+}
+export interface Provenance {
+    created_at: string;
+    updated_at: string;
+    derived_from?: string[];
+    last_touched: string;
+}
+export interface MemoryItem {
+    id: string;
+    workspace_id: string;
+    content: string;
+    summary?: string;
+    tags: string[];
+    memory_type: MemoryType;
+    source_type: SourceType;
+    author: Author;
+    relevance?: number;
+    confidence?: number;
+    provenance: Provenance;
+    contradiction_flags?: string[];
+}
+export interface GraphEntity {
+    id: string;
+    entity_type: string;
+    label: string;
+    properties?: Record<string, unknown>;
+    relevance?: number;
+    confidence?: number;
+}
+export interface GraphRelation {
+    source: string;
+    target: string;
+    relationship: string;
+    direction: 'outbound' | 'inbound' | 'bidirectional';
+    relevance?: number;
+    confidence?: number;
+}
+export interface GraphTraversalResult {
+    root: GraphEntity;
+    relations: GraphRelation[];
+    connected_entities: GraphEntity[];
+    depth_reached: number;
+}
+export interface IdentityProfile {
+    preferences: Record<string, string | string[]>;
+    expertise: string[];
+    communication_style?: string;
+    recurring_goals: string[];
+    stable_constraints: string[];
+    shifts: IdentityShift[];
+    contradictions: IdentityContradiction[];
+    snapshot_count: number;
+}
+export interface IdentityShift {
+    field: string;
+    from: string;
+    to: string;
+    timestamp?: string;
+}
+export interface IdentityContradiction {
+    existing: string;
+    new: string;
+    severity?: string;
+}
+export interface ContradictionResult {
+    id: string;
+    statement_a: string;
+    statement_b: string;
+    memory_id_a?: string;
+    memory_id_b?: string;
+    severity: 'low' | 'medium' | 'high';
+    confidence: number;
+    explanation?: string;
+    workspace_id: string;
+    detected_at: string;
+}
+export interface TimelineEntry {
+    id: string;
+    content: string;
+    summary?: string;
+    timestamp: string;
+    memory_type: MemoryType;
+    chain_position: number;
+    tags: string[];
+}
+export interface PatternResult {
+    name: string;
+    problem_signature: string;
+    prior_solution: string;
+    confidence: number;
+    supporting_memories: string[];
+    occurrence_count: number;
+}
+export type EvidenceClass = 'direct' | 'aggregated' | 'relational' | 'temporal' | 'contradictory' | 'weak';
+export type ClaimType = 'retrieved_fact' | 'synthesized_summary' | 'pattern_inference' | 'relational_inference' | 'temporal_inference' | 'hypothesis';
+export type ConfidenceLevel = 'high' | 'medium' | 'low' | 'unstable' | 'conflicting';
+export type PresentationMode = 'assertive' | 'confident_summary' | 'tentative_synthesis' | 'cautious' | 'exploratory' | 'do_not_assert';
+export interface EvidenceItem {
+    id: string;
+    source_type: string;
+    evidence_class: EvidenceClass;
+    relevance: number;
+    freshness: 'recent' | 'aging' | 'stale';
+    workspace_id: string;
+}
+export interface ConfidenceProfile {
+    level: ConfidenceLevel;
+    score: number;
+    evidence_strength: number;
+    evidence_consistency: number;
+    evidence_freshness: number;
+    derivation_distance: number;
+    contradiction_pressure: number;
+    pattern_stability?: number;
+    reason: string;
+}
+export interface JustificationResult {
+    claim: string;
+    claim_type: ClaimType;
+    workspace_scope: 'workspace_local' | 'user_global' | 'session_local';
+    support: {
+        evidence_count: number;
+        evidence_types: EvidenceClass[];
+        items: EvidenceItem[];
+    };
+    confidence: ConfidenceProfile;
+    uncertainty_flags: string[];
+    contradiction_flags: string[];
+    derived_from: string[];
+    presentation_mode: PresentationMode;
+}
+export interface DistillationCandidate {
+    content: string;
+    rationale: string;
+    tags: string[];
+    confidence: number;
+    memory_type: MemoryType;
+    source_type: SourceType;
+    duplicate_detected: boolean;
+    contradiction_detected: boolean;
+    stored_id?: string;
+}
+export interface DistillationResult {
+    candidates: DistillationCandidate[];
+    stored_count: number;
+    skipped_count: number;
+    contradictions_found: string[];
+}
+export interface HealthResult {
+    connected: boolean;
+    workspace_id: string;
+    backend_reachable: boolean;
+    latency_ms: number;
+    version: string;
+}
+export interface DebugResult {
+    workspace_id: string;
+    workspace_source: 'env' | 'git' | 'config' | 'none';
+    memory_count?: number;
+    cache_state: Record<string, {
+        cached: boolean;
+        age_ms?: number;
+    }>;
+    last_api_timings: Record<string, number>;
+    retry_count: number;
+    fallback_count: number;
+}
+export interface CapabilitiesResult {
+    tools: string[];
+    resources: string[];
+    prompts: string[];
+    features: {
+        workspace_isolation: boolean;
+        identity: boolean;
+        graph: boolean;
+        contradictions: boolean;
+        timeline: boolean;
+        patterns: boolean;
+        distill: boolean;
+        justification: boolean;
+    };
+    security_mode?: string;
+}
+export type AbsenceReason = 'no_data' | 'low_confidence' | 'partial' | 'conflict' | 'stale' | 'backend_error';
+export interface ApiConfig {
+    apiKey: string;
+    apiBase: string;
+    userId: string;
+    workspaceId: string;
+    workspaceSource: 'env' | 'git' | 'config' | 'none';
+    timeoutMs: number;
+    debug: boolean;
+}
+export interface ApiTiming {
+    endpoint: string;
+    duration_ms: number;
+    timestamp: number;
+    cached: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// ── Velixar MCP Server — Core Types ──
+// Governs all tool inputs, outputs, and internal contracts.
+// See ~/MCP-SERVER-STRATEGY.md for design rationale.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4DAA4D;AAC5D,qDAAqD"}

package/dist/validate.d.ts

@@ -0,0 +1,79 @@
+export declare class SchemaError extends Error {
+    endpoint: string;
+    field: string;
+    expected: string;
+    got: unknown;
+    constructor(endpoint: string, field: string, expected: string, got: unknown);
+}
+export interface ValidatedRawMemory {
+    id: string;
+    content: string;
+    score?: number;
+    tier?: number;
+    type?: string | null;
+    tags?: string[];
+    salience?: number;
+    created_at?: string;
+    updated_at?: string;
+    previous_memory_id?: string | null;
+}
+export interface ValidatedStoreResult {
+    id: string;
+}
+export interface ValidatedSearchResult {
+    memories: ValidatedRawMemory[];
+    count?: number;
+}
+export interface ValidatedListResult {
+    memories: ValidatedRawMemory[];
+    count?: number;
+    cursor?: string;
+}
+export interface ValidatedGraphResult {
+    nodes: Array<{
+        id: string;
+        label: string;
+        entity_type?: string;
+        properties?: Record<string, unknown>;
+        relevance?: number;
+    }>;
+    edges: Array<{
+        source: string;
+        target: string;
+        relationship?: string;
+        direction?: string;
+        relevance?: number;
+    }>;
+    hops?: number;
+}
+export interface ValidatedIdentityResult {
+    identity?: Record<string, unknown>;
+    shifts?: Array<{
+        field: string;
+        from: string;
+        to: string;
+        timestamp?: string;
+    }>;
+    contradictions?: Array<{
+        existing: string;
+        new: string;
+        severity?: string;
+    }>;
+    snapshot_count?: number;
+}
+export interface ValidatedOverviewResult {
+    total_memories?: number;
+    cortex_nodes?: number;
+    temporal_chains?: number;
+    system_mode?: string;
+}
+export declare function validateStoreResponse(raw: unknown, endpoint: string): ValidatedStoreResult;
+export declare function validateSearchResponse(raw: unknown, endpoint: string): ValidatedSearchResult;
+export declare function validateListResponse(raw: unknown, endpoint: string): ValidatedListResult;
+export declare function validateGraphResponse(raw: unknown, endpoint: string): ValidatedGraphResult;
+export declare function validateIdentityResponse(raw: unknown, endpoint: string): ValidatedIdentityResult;
+export declare function validateOverviewResponse(raw: unknown, endpoint: string): ValidatedOverviewResult;
+export declare function validateMutationResponse(raw: unknown, endpoint: string): {
+    error?: string;
+};
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

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

package/dist/validate.js

@@ -0,0 +1,174 @@
+// ── Runtime Schema Validation ──
+// Lightweight validators for backend API responses.
+// No external deps — just shape checks that return typed data or throw.
+// NOTE: Must not import from api.ts to avoid circular dependency.
+function warnSchema(endpoint, reason, got) {
+    console.error(`[velixar] warn: schema_skip_memory ${JSON.stringify({ endpoint, reason, got })}`);
+}
+export class SchemaError extends Error {
+    endpoint;
+    field;
+    expected;
+    got;
+    constructor(endpoint, field, expected, got) {
+        super(`Schema mismatch on ${endpoint}: ${field} expected ${expected}, got ${typeof got} (${String(got).slice(0, 50)})`);
+        this.endpoint = endpoint;
+        this.field = field;
+        this.expected = expected;
+        this.got = got;
+        this.name = 'SchemaError';
+    }
+}
+// ── Helpers ──
+function has(obj, key) {
+    return obj !== null && typeof obj === 'object' && key in obj;
+}
+function str(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function num(v) {
+    return typeof v === 'number' ? v : undefined;
+}
+function arr(v) {
+    return Array.isArray(v) ? v : undefined;
+}
+// ── Validators ──
+function validateRawMemory(m, endpoint) {
+    if (!m || typeof m !== 'object')
+        return null;
+    const o = m;
+    const id = str(o.id);
+    const content = str(o.content);
+    if (!id || !content) {
+        warnSchema(endpoint, 'missing id or content', JSON.stringify(o).slice(0, 100));
+        return null;
+    }
+    return {
+        id,
+        content,
+        score: num(o.score),
+        tier: num(o.tier),
+        type: str(o.type) ?? null,
+        tags: arr(o.tags)?.filter((t) => typeof t === 'string'),
+        salience: num(o.salience),
+        created_at: str(o.created_at),
+        updated_at: str(o.updated_at),
+        previous_memory_id: str(o.previous_memory_id) ?? null,
+    };
+}
+export function validateStoreResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const id = str(o.id);
+    if (!id)
+        throw new SchemaError(endpoint, 'id', 'string', o.id);
+    return { id };
+}
+export function validateSearchResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawMems = arr(o.memories) || [];
+    const memories = rawMems.map(m => validateRawMemory(m, endpoint)).filter((m) => m !== null);
+    return { memories, count: num(o.count) };
+}
+export function validateListResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawMems = arr(o.memories) || [];
+    const memories = rawMems.map(m => validateRawMemory(m, endpoint)).filter((m) => m !== null);
+    return { memories, count: num(o.count), cursor: str(o.cursor) };
+}
+export function validateGraphResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawNodes = arr(o.nodes) || [];
+    const nodes = rawNodes.map(n => {
+        if (!n || typeof n !== 'object')
+            return null;
+        const node = n;
+        const id = str(node.id);
+        const label = str(node.label) || str(node.name) || str(node.id) || '';
+        if (!id)
+            return null;
+        return {
+            id,
+            label,
+            entity_type: str(node.entity_type) || str(node.type),
+            properties: (typeof node.properties === 'object' && node.properties !== null) ? node.properties : undefined,
+            relevance: num(node.relevance),
+        };
+    }).filter((n) => n !== null);
+    const rawEdges = arr(o.edges) || [];
+    const edges = rawEdges.map(e => {
+        if (!e || typeof e !== 'object')
+            return null;
+        const edge = e;
+        const source = str(edge.source) || str(edge.from);
+        const target = str(edge.target) || str(edge.to);
+        if (!source || !target)
+            return null;
+        return {
+            source,
+            target,
+            relationship: str(edge.relationship) || str(edge.relation_type) || str(edge.label),
+            direction: str(edge.direction),
+            relevance: num(edge.relevance),
+        };
+    }).filter((e) => e !== null);
+    return { nodes, edges, hops: num(o.hops) };
+}
+export function validateIdentityResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const identity = (typeof o.identity === 'object' && o.identity !== null) ? o.identity : {};
+    const rawShifts = arr(o.shifts) || [];
+    const shifts = rawShifts.map(s => {
+        if (!s || typeof s !== 'object')
+            return null;
+        const shift = s;
+        return { field: str(shift.field) || '', from: str(shift.from) || '', to: str(shift.to) || '', timestamp: str(shift.timestamp) };
+    }).filter((s) => s !== null);
+    const rawContradictions = arr(o.contradictions) || [];
+    const contradictions = rawContradictions.map(c => {
+        if (!c || typeof c !== 'object')
+            return null;
+        const con = c;
+        return { existing: str(con.existing) || '', new: str(con.new) || '', severity: str(con.severity) };
+    }).filter((c) => c !== null);
+    return { identity, shifts, contradictions, snapshot_count: num(o.snapshot_count) };
+}
+export function validateOverviewResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    return {
+        total_memories: num(o.total_memories),
+        cortex_nodes: num(o.cortex_nodes),
+        temporal_chains: num(o.temporal_chains),
+        system_mode: str(o.system_mode),
+    };
+}
+export function validateMutationResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new SchemaError(endpoint, 'response', 'object', raw);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    return {};
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/validate_retrieval.d.ts

@@ -0,0 +1,33 @@
+import type { ValidatedRawMemory } from './validate.js';
+export interface ValidatedMultiSearchResult {
+    results: Array<{
+        query: string;
+        memories: ValidatedRawMemory[];
+        count: number;
+        error?: string;
+    }>;
+    total_queries: number;
+}
+export declare function validateMultiSearchResponse(raw: unknown, endpoint: string): ValidatedMultiSearchResult;
+export interface ValidatedCoverageResult {
+    topic: string;
+    total_relevant: number;
+    retrieved_count: number;
+    coverage_ratio: number;
+    gaps: Array<{
+        id: string;
+        preview: string;
+        relevance: number;
+    }>;
+    uncovered_entities: string[];
+    suggested_queries: string[];
+}
+export declare function validateCoverageResponse(raw: unknown, endpoint: string): ValidatedCoverageResult;
+export interface ValidatedNeighborhoodResult {
+    anchor_id: string;
+    anchor_embedding: 'stored' | 'generated';
+    neighbors: ValidatedRawMemory[];
+    isolation_signal: boolean;
+}
+export declare function validateNeighborhoodResponse(raw: unknown, endpoint: string): ValidatedNeighborhoodResult;
+//# sourceMappingURL=validate_retrieval.d.ts.map

package/dist/validate_retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_retrieval.d.ts","sourceRoot":"","sources":["../src/validate_retrieval.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAiCxD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,kBAAkB,EAAE,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAoBtG;AAID,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,KAAK,CAAC;QACV,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CA2BhG;AAID,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,QAAQ,GAAG,WAAW,CAAC;IACzC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,2BAA2B,CAcxG"}

package/dist/validate_retrieval.js

@@ -0,0 +1,97 @@
+// ── Retrieval Response Validators ──
+// Validators for new retrieval endpoints: multi_search, search_by_vector, coverage.
+// Same pattern as validate.ts — no api.ts imports (avoid circular deps).
+// ── Helpers (duplicated from validate.ts to avoid coupling) ──
+function str(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function num(v) {
+    return typeof v === 'number' ? v : undefined;
+}
+function arr(v) {
+    return Array.isArray(v) ? v : undefined;
+}
+function validateRawMemory(m, endpoint) {
+    if (!m || typeof m !== 'object')
+        return null;
+    const o = m;
+    const id = str(o.id);
+    const content = str(o.content);
+    if (!id || !content)
+        return null;
+    return {
+        id, content,
+        score: num(o.score), tier: num(o.tier), type: str(o.type) ?? null,
+        tags: arr(o.tags)?.filter((t) => typeof t === 'string'),
+        salience: num(o.salience), created_at: str(o.created_at), updated_at: str(o.updated_at),
+        previous_memory_id: str(o.previous_memory_id) ?? null,
+    };
+}
+export function validateMultiSearchResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new Error(`Schema mismatch on ${endpoint}: expected object`);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawResults = arr(o.results) || [];
+    const results = rawResults.map(r => {
+        if (!r || typeof r !== 'object')
+            return { query: '', memories: [], count: 0 };
+        const item = r;
+        const rawMems = arr(item.memories) || [];
+        const memories = rawMems.map(m => validateRawMemory(m, endpoint)).filter((m) => m !== null);
+        return {
+            query: str(item.query) || '',
+            memories,
+            count: memories.length,
+            error: str(item.error),
+        };
+    });
+    return { results, total_queries: results.length };
+}
+export function validateCoverageResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new Error(`Schema mismatch on ${endpoint}: expected object`);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawGaps = arr(o.gaps) || [];
+    const gaps = rawGaps.map(g => {
+        if (!g || typeof g !== 'object')
+            return null;
+        const gap = g;
+        const id = str(gap.id);
+        if (!id)
+            return null;
+        return {
+            id,
+            preview: str(gap.preview) || str(gap.content)?.slice(0, 200) || '',
+            relevance: num(gap.relevance) ?? 0,
+        };
+    }).filter((g) => g !== null);
+    return {
+        topic: str(o.topic) || '',
+        total_relevant: num(o.total_relevant) ?? 0,
+        retrieved_count: num(o.retrieved_count) ?? 0,
+        coverage_ratio: num(o.coverage_ratio) ?? 0,
+        gaps,
+        uncovered_entities: (arr(o.uncovered_entities) || []).filter((e) => typeof e === 'string'),
+        suggested_queries: (arr(o.suggested_queries) || []).filter((q) => typeof q === 'string'),
+    };
+}
+export function validateNeighborhoodResponse(raw, endpoint) {
+    if (!raw || typeof raw !== 'object')
+        throw new Error(`Schema mismatch on ${endpoint}: expected object`);
+    const o = raw;
+    if (o.error)
+        throw new Error(String(o.error));
+    const rawNeighbors = arr(o.neighbors) || arr(o.memories) || [];
+    const neighbors = rawNeighbors.map(m => validateRawMemory(m, endpoint)).filter((m) => m !== null);
+    return {
+        anchor_id: str(o.anchor_id) || str(o.memory_id) || '',
+        anchor_embedding: str(o.anchor_embedding) === 'generated' ? 'generated' : 'stored',
+        neighbors,
+        isolation_signal: neighbors.length === 0,
+    };
+}
+//# sourceMappingURL=validate_retrieval.js.map