@utaba/deep-memory 0.6.1 → 0.7.0

package/dist/index.d.cts

@@ -1,14 +1,14 @@
-import { G as GovernanceConfig, M as MemoryVocabulary, x as ResolvedVocabulary, C as CreateEntityInput, U as UpdateEntityInput, y as CreateRelationshipInput, z as EntityTypeDefinition, A as VocabularyProposal, F as VocabularyProposalResult, H as ProvenanceContext, J as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, K as FindEntitiesQuery, e as PaginatedResult, L as ReembedResult, N as Relationship, P as PropertyFilter, R as RelationshipSummary, O as GraphResult, Q as ExploreOptions, T as Neighborhood, W as PathOptions, X as PathResult, Y as ConceptSearchOptions, Z as ScoredEntity, _ as TimelineOptions, $ as TimelineResult, i as RepositoryStats, a0 as RepositoryConfig, c as StoredRepository, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, k as StoredEntity, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighborhood, r as StoragePathOptions, s as StoragePathResult, t as StorageTimelineOptions, u as StorageTimelineResult, v as ExportChunk, B as BulkImportOptions, w as BulkImportResult, a8 as SearchOptions, a9 as SearchHit } from './portability-B-8J4nQQ.cjs';
-export { aa as EnrichedRelationship, ab as EntityMap, ac as EntityTypeInput, ad as ExportLegalMetadata, ae as ExportManifest, af as ExportPipelineMetadata, ag as GetEntitiesOptions, ah as GetEntityOptions, ai as GovernanceMode, aj as ImportWarning, ak as NeighborhoodCenter, al as NeighborhoodGroup, am as NeighborhoodLayer, an as Path, ao as PropertySchema, ap as PropertyType, aq as ProvenanceFilter, ar as RelationshipDirection, as as RelationshipTypeDefinition, at as RelationshipTypeInput, au as RepositoryMetadata, av as StorageNeighborhoodGroup, aw as StorageNeighborhoodLayer, ax as StoragePath, ay as StorageTimelineEvent, az as TimelineEntityRef, aA as TimelineEvent, aB as TimelineRelationshipDetail, aC as VocabularyInput } from './portability-B-8J4nQQ.cjs';
+import { G as GovernanceConfig, M as MemoryVocabulary, x as ResolvedVocabulary, C as CreateEntityInput, y as ValidationResult, U as UpdateEntityInput, z as CreateRelationshipInput, A as EntityTypeDefinition, F as VocabularyProposal, H as VocabularyProposalResult, J as ProvenanceContext, K as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, L as FindEntitiesQuery, e as PaginatedResult, N as DeleteEntitiesResult, O as ReembedResult, Q as Relationship, T as RemoveRelationshipsResult, P as PropertyFilter, R as RelationshipSummary, W as GraphResult, X as ExploreOptions, Y as Neighborhood, Z as PathOptions, _ as PathResult, $ as ConceptSearchOptions, a0 as ScoredEntity, a1 as TimelineOptions, a2 as TimelineResult, i as RepositoryStats, a3 as ValidateEntitiesOptions, a4 as EntityValidationPage, a5 as ValidateRelationshipsOptions, a6 as RelationshipValidationPage, a7 as RepositoryConfig, c as StoredRepository, d as RepositoryFilter, a8 as RepositorySummary, g as RepositoryUpdate, a9 as ExportOptions, aa as ExportArchive, ab as ImportOptions, ac as ImportResult, ad as ExportStreamItem, ae as ImportStreamHeader, I as ImportChunk, k as StoredEntity, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighborhood, r as StoragePathOptions, s as StoragePathResult, t as StorageTimelineOptions, u as StorageTimelineResult, v as ExportChunk, B as BulkImportOptions, w as BulkImportResult, af as SearchOptions, ag as SearchHit } from './portability-fa5sVgsP.cjs';
+export { ah as EnrichedRelationship, ai as EntityMap, aj as EntityTypeInput, ak as EntityValidationIssue, al as ExportLegalMetadata, am as ExportManifest, an as ExportPipelineMetadata, ao as GetEntitiesOptions, ap as GetEntityOptions, aq as GovernanceMode, ar as ImportWarning, as as NeighborhoodCenter, at as NeighborhoodGroup, au as NeighborhoodLayer, av as Path, aw as PropertySchema, ax as PropertyType, ay as ProvenanceFilter, az as RelationshipDirection, aA as RelationshipTypeDefinition, aB as RelationshipTypeInput, aC as RelationshipValidationIssue, aD as RepositoryMetadata, aE as StorageNeighborhoodGroup, aF as StorageNeighborhoodLayer, aG as StoragePath, aH as StorageTimelineEvent, aI as TimelineEntityRef, aJ as TimelineEvent, aK as TimelineRelationshipDetail, aL as VocabularyInput } from './portability-fa5sVgsP.cjs';
 import { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload } from './types/index.cjs';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-Llalk03r.cjs';
-export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, f as TraversalReturnMode, g as TraversalStart, h as TraversalStep } from './traversal-Llalk03r.cjs';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-CBhwqavV.cjs';
-import { EmbeddingProvider, SearchProvider, GraphTraversalProvider, LockProvider, SearchableEntity } from './providers/index.cjs';
+import { T as TraversalSpec, a as TraversalResult } from './traversal-CXqN780S.cjs';
+export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, f as TraversalReturnMode, g as TraversalStart, h as TraversalStep } from './traversal-CXqN780S.cjs';
+import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-CX4mKNph.cjs';
+import { EmbeddingProvider, SearchProvider, EmbeddingProviderFactory, GraphTraversalProvider, LockProvider, SearchableEntity } from './providers/index.cjs';
 export { GraphTraversalCapabilities, LockHandle, LockOptions } from './providers/index.cjs';
 
 /** Error codes for all Deep Memory errors */
-type DeepMemoryErrorCode = 'INVALID_INPUT' | 'ENTITY_NOT_FOUND' | 'ENTITY_ALREADY_EXISTS' | 'RELATIONSHIP_NOT_FOUND' | 'RELATIONSHIP_ALREADY_EXISTS' | 'REPOSITORY_NOT_FOUND' | 'REPOSITORY_ALREADY_EXISTS' | 'VOCABULARY_VALIDATION_FAILED' | 'RELATIONSHIP_CONSTRAINT_FAILED' | 'GOVERNANCE_DENIED' | 'OPERATION_CANCELLED' | 'EMBEDDING_PROVIDER_REQUIRED' | 'IMPORT_ERROR' | 'EXPORT_ERROR' | 'PROVIDER_ERROR' | 'GRAPH_TRAVERSAL_PROVIDER_REQUIRED' | 'TRAVERSAL_VALIDATION_FAILED' | 'TRAVERSAL_VOCABULARY_ERROR' | 'TRAVERSAL_TIMEOUT';
+type DeepMemoryErrorCode = 'INVALID_INPUT' | 'ENTITY_NOT_FOUND' | 'ENTITY_ALREADY_EXISTS' | 'RELATIONSHIP_NOT_FOUND' | 'RELATIONSHIP_ALREADY_EXISTS' | 'REPOSITORY_NOT_FOUND' | 'REPOSITORY_ALREADY_EXISTS' | 'VOCABULARY_VALIDATION_FAILED' | 'RELATIONSHIP_CONSTRAINT_FAILED' | 'SELF_REFERENTIAL_RELATIONSHIP' | 'GOVERNANCE_DENIED' | 'OPERATION_CANCELLED' | 'EMBEDDING_PROVIDER_REQUIRED' | 'IMPORT_ERROR' | 'EXPORT_ERROR' | 'PROVIDER_ERROR' | 'GRAPH_TRAVERSAL_PROVIDER_REQUIRED' | 'TRAVERSAL_VALIDATION_FAILED' | 'TRAVERSAL_VOCABULARY_ERROR' | 'TRAVERSAL_TIMEOUT';
 /** Base error class for all Deep Memory errors */
 declare class DeepMemoryError extends Error {
     readonly code: DeepMemoryErrorCode;
@@ -71,6 +71,12 @@ declare class RelationshipConstraintError extends DeepMemoryError {
     readonly targetType?: string;
     constructor(relationshipType: string, message: string, sourceType?: string, targetType?: string);
 }
+/** Relationship source and target entity are the same — self-references are not permitted */
+declare class SelfReferentialRelationshipError extends DeepMemoryError {
+    readonly entityId: string;
+    readonly relationshipType: string;
+    constructor(entityId: string, relationshipType: string);
+}
 /** Governance rules denied the operation */
 declare class GovernanceDeniedError extends DeepMemoryError {
     readonly governanceMode: string;
@@ -118,18 +124,6 @@ declare class TraversalTimeoutError extends DeepMemoryError {
     constructor(timeoutMs: number);
 }
 
-/** A single validation error with optional suggestion */
-interface ValidationError {
-    field: string;
-    message: string;
-    suggestion?: string;
-}
-/** Result of a validation check */
-interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-}
-
 interface VocabularyEngineConfig {
     repositoryId: string;
     storageProvider: StorageProvider;
@@ -230,7 +224,13 @@ interface MemoryRepositoryConfig {
     repositoryId: string;
     storage: StorageProvider;
     search?: SearchProvider;
+    /** Embedding provider configured for this repository's model + dimensions */
     embedding?: EmbeddingProvider;
+    /**
+     * Factory for producing embedding providers with different model/dimensions.
+     * Required only if reembedAll will be called with a new model or dimensions.
+     */
+    embeddingFactory?: EmbeddingProviderFactory;
     graphTraversal?: GraphTraversalProvider;
     vocabularyEngine: VocabularyEngine;
     provenanceTracker: ProvenanceTracker;
@@ -247,6 +247,8 @@ declare class MemoryRepository {
     private readonly relationshipManager;
     private readonly graphTraversal;
     private readonly searchOrchestrator;
+    private readonly embeddingFactory?;
+    private embedding?;
     constructor(config: MemoryRepositoryConfig);
     getVocabulary(): Promise<ResolvedVocabulary>;
     proposeVocabularyChange(proposal: VocabularyProposal): Promise<VocabularyProposalResult>;
@@ -258,15 +260,22 @@ declare class MemoryRepository {
     getBySlug(slug: string, detailLevel?: DetailLevel): Promise<Entity | EntitySummary | EntityBrief | null>;
     getEntities(entityIds: string[], detailLevel?: 'brief' | 'summary'): Promise<Map<string, EntitySummary | EntityBrief>>;
     findEntities(query: FindEntitiesQuery): Promise<PaginatedResult<Entity | EntitySummary | EntityBrief>>;
-    deleteEntity(entityId: string): Promise<void>;
+    deleteEntities(ids: string[]): Promise<DeleteEntitiesResult>;
     /** Re-embed specific entities using the current EmbeddingProvider */
     reembedEntities(entityIds: string[]): Promise<ReembedResult>;
     /**
-     * Re-embed all entities in the repository using the current EmbeddingProvider.
+     * Re-embed all entities in the repository. If `model` or `dimensions` is provided,
+     * the repository's embedding configuration is updated to the new values before
+     * re-embedding, so all subsequent entity writes use the new model/dimensionality.
+     *
      * Processes in batches with optional rate limiting. Emits reembed:* events for progress tracking.
      * Updates repository metadata with the new model ID and dimensions on completion.
      */
     reembedAll(options?: {
+        /** New embedding model to switch to. Requires an embeddingFactory on DeepMemory. */
+        model?: string;
+        /** New embedding dimensionality to switch to. Requires an embeddingFactory on DeepMemory. */
+        dimensions?: number;
         batchSize?: number;
         /** Max retries per batch on embedding failure (default 3) */
         maxRetries?: number;
@@ -276,7 +285,7 @@ declare class MemoryRepository {
         delayBetweenBatchesMs?: number;
     }): Promise<ReembedResult>;
     createRelationships(inputs: CreateRelationshipInput[]): Promise<Relationship[]>;
-    removeRelationship(relationshipId: string): Promise<void>;
+    removeRelationships(ids: string[]): Promise<RemoveRelationshipsResult>;
     getRelationships(entityId: string, options?: {
         relationshipTypes?: string[];
         direction?: 'outbound' | 'inbound' | 'both';
@@ -299,6 +308,19 @@ declare class MemoryRepository {
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
+    /**
+     * Audit a window of entities against the current vocabulary. Returns a single
+     * page; callers loop until `done` is true. Paging is over scanned entities,
+     * not issues. Does not mutate anything.
+     */
+    validateEntities(options?: ValidateEntitiesOptions): Promise<EntityValidationPage>;
+    /**
+     * Audit a window of relationships against the current vocabulary. Returns a
+     * single page; callers loop until `done` is true. The full entity set is
+     * loaded once per call to resolve orphan and type-mismatch checks, then
+     * offset/take is applied to the relationship stream. Does not mutate anything.
+     */
+    validateRelationships(options?: ValidateRelationshipsOptions): Promise<RelationshipValidationPage>;
     /** Delete all entities and relationships in this repository, preserving the repository and vocabulary */
     deleteAllContents(): Promise<{
         deletedEntities: number;
@@ -323,8 +345,17 @@ interface DeepMemoryConfig {
     storage: StorageProvider;
     /** Optional: search provider for full-text search */
     search?: SearchProvider;
-    /** Optional: embedding provider for semantic search */
-    embedding?: EmbeddingProvider;
+    /**
+     * Optional: factory that produces an EmbeddingProvider configured for a specific
+     * model + dimensionality. Called once per repository open/create using the repo's
+     * stored embedding metadata, so different repositories can use different models
+     * and embedding dimensions without any per-mutation lookups.
+     */
+    embeddingFactory?: EmbeddingProviderFactory;
+    /** Default embedding model for new repositories that don't specify one in metadata */
+    defaultEmbeddingModel?: string;
+    /** Default embedding dimensions for new repositories that don't specify one in metadata */
+    defaultEmbeddingDimensions?: number;
     /** Optional: lock provider for distributed locking */
     lock?: LockProvider;
     /** Optional: graph traversal provider for native multi-hop queries */
@@ -335,7 +366,9 @@ interface DeepMemoryConfig {
 declare class DeepMemory {
     private readonly storage;
     private readonly search?;
-    private readonly embedding?;
+    private readonly embeddingFactory?;
+    private readonly defaultEmbeddingModel?;
+    private readonly defaultEmbeddingDimensions?;
     /** Reserved for future distributed locking support */
     readonly lock?: LockProvider;
     private readonly graphTraversalProvider?;
@@ -343,6 +376,11 @@ declare class DeepMemory {
     private readonly globalEventBus;
     private initialized;
     constructor(config: DeepMemoryConfig);
+    /**
+     * Build an embedding provider for a repository given its stored model + dimensions.
+     * Returns undefined when no factory is configured or when model/dimensions are missing.
+     */
+    private buildEmbeddingForRepository;
     /** Initialize the storage provider and optional providers (call once before use) */
     private ensureInitialized;
     /** Create or migrate the storage schema. Call once at deployment / startup, not per-request. */
@@ -388,6 +426,15 @@ declare class DeepMemory {
     dispose(): Promise<void>;
 }
 
+declare class RepositoryValidator {
+    private readonly repositoryId;
+    private readonly storage;
+    private readonly vocabularyEngine;
+    constructor(repositoryId: string, storage: StorageProvider, vocabularyEngine: VocabularyEngine);
+    validateEntities(options?: ValidateEntitiesOptions): Promise<EntityValidationPage>;
+    validateRelationships(options?: ValidateRelationshipsOptions): Promise<RelationshipValidationPage>;
+}
+
 /**
  * Evaluate whether a set of properties matches all given filters.
  * All filters are AND'd — every filter must match for the result to be true.
@@ -454,7 +501,15 @@ declare class InMemoryStorageProvider implements StorageProvider {
     createRelationship(repositoryId: string, relationship: StoredRelationship): Promise<StoredRelationship>;
     getRelationship(repositoryId: string, relationshipId: string): Promise<StoredRelationship | null>;
     getEntityRelationships(repositoryId: string, entityId: string, options?: RelationshipQueryOptions): Promise<PaginatedResult<StoredRelationship>>;
+    deleteEntities(repositoryId: string, ids: string[]): Promise<{
+        deleted: string[];
+        notFound: string[];
+    }>;
     deleteRelationship(repositoryId: string, relationshipId: string): Promise<void>;
+    deleteRelationships(repositoryId: string, ids: string[]): Promise<{
+        deleted: string[];
+        notFound: string[];
+    }>;
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
@@ -481,4 +536,4 @@ declare class NoOpEmbeddingProvider implements EmbeddingProvider {
     modelId(): string;
 }
 
-export { BulkImportOptions, BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, DeleteProgressCallback, DetailLevel, DuplicateEntityError, DuplicateRelationshipError, DuplicateRepositoryError, EmbeddingProvider, EmbeddingProviderRequiredError, EnsureSchemaResult, Entity, EntityBrief, EntityNotFoundError, EntitySummary, EntityTypeDefinition, EventHandler, EventPayload, ExploreOptions, ExportArchive, ExportChunk, ExportError, ExportOptions, ExportStreamItem, FindEntitiesQuery, GovernanceConfig, GovernanceDeniedError, GraphResult, GraphTraversalProvider, GraphTraversalProviderRequiredError, GremlinCompiler, HookResult, ImportChunk, ImportError, ImportOptions, ImportResult, ImportStreamHeader, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationCancelledError, PaginatedResult, PaginationOptions, PathOptions, PathResult, PropertyFilter, Provenance, ProvenanceContext, ProviderError, ReembedResult, Relationship, RelationshipConstraintError, RelationshipNotFoundError, RelationshipQueryOptions, RelationshipSummary, RepositoryConfig, RepositoryFilter, RepositoryNotFoundError, RepositoryStats, RepositorySummary, RepositoryUpdate, ResolvedVocabulary, ScoredEntity, SearchHit, SearchOptions, SearchProvider, SearchableEntity, StorageExploreOptions, StorageFindQuery, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageProvider, StorageRepositoryConfig, StorageTimelineOptions, StorageTimelineResult, StoredEntity, StoredEntityUpdate, StoredRelationship, StoredRepository, StoredRepositorySummary, TimelineOptions, TimelineResult, type TraversalCompiler, TraversalResult, TraversalSpec, TraversalTimeoutError, TraversalValidationError, TraversalVocabularyError, Unsubscribe, UpdateEntityInput, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, generateId, isValidUuid, matchesPropertyFilters, projectEntity };
+export { BulkImportOptions, BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, DeleteEntitiesResult, DeleteProgressCallback, DetailLevel, DuplicateEntityError, DuplicateRelationshipError, DuplicateRepositoryError, EmbeddingProvider, EmbeddingProviderFactory, EmbeddingProviderRequiredError, EnsureSchemaResult, Entity, EntityBrief, EntityNotFoundError, EntitySummary, EntityTypeDefinition, EntityValidationPage, EventHandler, EventPayload, ExploreOptions, ExportArchive, ExportChunk, ExportError, ExportOptions, ExportStreamItem, FindEntitiesQuery, GovernanceConfig, GovernanceDeniedError, GraphResult, GraphTraversalProvider, GraphTraversalProviderRequiredError, GremlinCompiler, HookResult, ImportChunk, ImportError, ImportOptions, ImportResult, ImportStreamHeader, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationCancelledError, PaginatedResult, PaginationOptions, PathOptions, PathResult, PropertyFilter, Provenance, ProvenanceContext, ProviderError, ReembedResult, Relationship, RelationshipConstraintError, RelationshipNotFoundError, RelationshipQueryOptions, RelationshipSummary, RelationshipValidationPage, RemoveRelationshipsResult, RepositoryConfig, RepositoryFilter, RepositoryNotFoundError, RepositoryStats, RepositorySummary, RepositoryUpdate, RepositoryValidator, ResolvedVocabulary, ScoredEntity, SearchHit, SearchOptions, SearchProvider, SearchableEntity, SelfReferentialRelationshipError, StorageExploreOptions, StorageFindQuery, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageProvider, StorageRepositoryConfig, StorageTimelineOptions, StorageTimelineResult, StoredEntity, StoredEntityUpdate, StoredRelationship, StoredRepository, StoredRepositorySummary, TimelineOptions, TimelineResult, type TraversalCompiler, TraversalResult, TraversalSpec, TraversalTimeoutError, TraversalValidationError, TraversalVocabularyError, Unsubscribe, UpdateEntityInput, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, generateId, isValidUuid, matchesPropertyFilters, projectEntity };

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { G as GovernanceConfig, M as MemoryVocabulary, x as ResolvedVocabulary, C as CreateEntityInput, U as UpdateEntityInput, y as CreateRelationshipInput, z as EntityTypeDefinition, A as VocabularyProposal, F as VocabularyProposalResult, H as ProvenanceContext, J as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, K as FindEntitiesQuery, e as PaginatedResult, L as ReembedResult, N as Relationship, P as PropertyFilter, R as RelationshipSummary, O as GraphResult, Q as ExploreOptions, T as Neighborhood, W as PathOptions, X as PathResult, Y as ConceptSearchOptions, Z as ScoredEntity, _ as TimelineOptions, $ as TimelineResult, i as RepositoryStats, a0 as RepositoryConfig, c as StoredRepository, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, k as StoredEntity, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighborhood, r as StoragePathOptions, s as StoragePathResult, t as StorageTimelineOptions, u as StorageTimelineResult, v as ExportChunk, B as BulkImportOptions, w as BulkImportResult, a8 as SearchOptions, a9 as SearchHit } from './portability-B-8J4nQQ.js';
-export { aa as EnrichedRelationship, ab as EntityMap, ac as EntityTypeInput, ad as ExportLegalMetadata, ae as ExportManifest, af as ExportPipelineMetadata, ag as GetEntitiesOptions, ah as GetEntityOptions, ai as GovernanceMode, aj as ImportWarning, ak as NeighborhoodCenter, al as NeighborhoodGroup, am as NeighborhoodLayer, an as Path, ao as PropertySchema, ap as PropertyType, aq as ProvenanceFilter, ar as RelationshipDirection, as as RelationshipTypeDefinition, at as RelationshipTypeInput, au as RepositoryMetadata, av as StorageNeighborhoodGroup, aw as StorageNeighborhoodLayer, ax as StoragePath, ay as StorageTimelineEvent, az as TimelineEntityRef, aA as TimelineEvent, aB as TimelineRelationshipDetail, aC as VocabularyInput } from './portability-B-8J4nQQ.js';
+import { G as GovernanceConfig, M as MemoryVocabulary, x as ResolvedVocabulary, C as CreateEntityInput, y as ValidationResult, U as UpdateEntityInput, z as CreateRelationshipInput, A as EntityTypeDefinition, F as VocabularyProposal, H as VocabularyProposalResult, J as ProvenanceContext, K as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, L as FindEntitiesQuery, e as PaginatedResult, N as DeleteEntitiesResult, O as ReembedResult, Q as Relationship, T as RemoveRelationshipsResult, P as PropertyFilter, R as RelationshipSummary, W as GraphResult, X as ExploreOptions, Y as Neighborhood, Z as PathOptions, _ as PathResult, $ as ConceptSearchOptions, a0 as ScoredEntity, a1 as TimelineOptions, a2 as TimelineResult, i as RepositoryStats, a3 as ValidateEntitiesOptions, a4 as EntityValidationPage, a5 as ValidateRelationshipsOptions, a6 as RelationshipValidationPage, a7 as RepositoryConfig, c as StoredRepository, d as RepositoryFilter, a8 as RepositorySummary, g as RepositoryUpdate, a9 as ExportOptions, aa as ExportArchive, ab as ImportOptions, ac as ImportResult, ad as ExportStreamItem, ae as ImportStreamHeader, I as ImportChunk, k as StoredEntity, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighborhood, r as StoragePathOptions, s as StoragePathResult, t as StorageTimelineOptions, u as StorageTimelineResult, v as ExportChunk, B as BulkImportOptions, w as BulkImportResult, af as SearchOptions, ag as SearchHit } from './portability-fa5sVgsP.js';
+export { ah as EnrichedRelationship, ai as EntityMap, aj as EntityTypeInput, ak as EntityValidationIssue, al as ExportLegalMetadata, am as ExportManifest, an as ExportPipelineMetadata, ao as GetEntitiesOptions, ap as GetEntityOptions, aq as GovernanceMode, ar as ImportWarning, as as NeighborhoodCenter, at as NeighborhoodGroup, au as NeighborhoodLayer, av as Path, aw as PropertySchema, ax as PropertyType, ay as ProvenanceFilter, az as RelationshipDirection, aA as RelationshipTypeDefinition, aB as RelationshipTypeInput, aC as RelationshipValidationIssue, aD as RepositoryMetadata, aE as StorageNeighborhoodGroup, aF as StorageNeighborhoodLayer, aG as StoragePath, aH as StorageTimelineEvent, aI as TimelineEntityRef, aJ as TimelineEvent, aK as TimelineRelationshipDetail, aL as VocabularyInput } from './portability-fa5sVgsP.js';
 import { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload } from './types/index.js';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-BdmDLMxV.js';
-export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, f as TraversalReturnMode, g as TraversalStart, h as TraversalStep } from './traversal-BdmDLMxV.js';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-ynfpc5wz.js';
-import { EmbeddingProvider, SearchProvider, GraphTraversalProvider, LockProvider, SearchableEntity } from './providers/index.js';
+import { T as TraversalSpec, a as TraversalResult } from './traversal-DpSdLzxn.js';
+export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, f as TraversalReturnMode, g as TraversalStart, h as TraversalStep } from './traversal-DpSdLzxn.js';
+import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-CrIcN06Q.js';
+import { EmbeddingProvider, SearchProvider, EmbeddingProviderFactory, GraphTraversalProvider, LockProvider, SearchableEntity } from './providers/index.js';
 export { GraphTraversalCapabilities, LockHandle, LockOptions } from './providers/index.js';
 
 /** Error codes for all Deep Memory errors */
-type DeepMemoryErrorCode = 'INVALID_INPUT' | 'ENTITY_NOT_FOUND' | 'ENTITY_ALREADY_EXISTS' | 'RELATIONSHIP_NOT_FOUND' | 'RELATIONSHIP_ALREADY_EXISTS' | 'REPOSITORY_NOT_FOUND' | 'REPOSITORY_ALREADY_EXISTS' | 'VOCABULARY_VALIDATION_FAILED' | 'RELATIONSHIP_CONSTRAINT_FAILED' | 'GOVERNANCE_DENIED' | 'OPERATION_CANCELLED' | 'EMBEDDING_PROVIDER_REQUIRED' | 'IMPORT_ERROR' | 'EXPORT_ERROR' | 'PROVIDER_ERROR' | 'GRAPH_TRAVERSAL_PROVIDER_REQUIRED' | 'TRAVERSAL_VALIDATION_FAILED' | 'TRAVERSAL_VOCABULARY_ERROR' | 'TRAVERSAL_TIMEOUT';
+type DeepMemoryErrorCode = 'INVALID_INPUT' | 'ENTITY_NOT_FOUND' | 'ENTITY_ALREADY_EXISTS' | 'RELATIONSHIP_NOT_FOUND' | 'RELATIONSHIP_ALREADY_EXISTS' | 'REPOSITORY_NOT_FOUND' | 'REPOSITORY_ALREADY_EXISTS' | 'VOCABULARY_VALIDATION_FAILED' | 'RELATIONSHIP_CONSTRAINT_FAILED' | 'SELF_REFERENTIAL_RELATIONSHIP' | 'GOVERNANCE_DENIED' | 'OPERATION_CANCELLED' | 'EMBEDDING_PROVIDER_REQUIRED' | 'IMPORT_ERROR' | 'EXPORT_ERROR' | 'PROVIDER_ERROR' | 'GRAPH_TRAVERSAL_PROVIDER_REQUIRED' | 'TRAVERSAL_VALIDATION_FAILED' | 'TRAVERSAL_VOCABULARY_ERROR' | 'TRAVERSAL_TIMEOUT';
 /** Base error class for all Deep Memory errors */
 declare class DeepMemoryError extends Error {
     readonly code: DeepMemoryErrorCode;
@@ -71,6 +71,12 @@ declare class RelationshipConstraintError extends DeepMemoryError {
     readonly targetType?: string;
     constructor(relationshipType: string, message: string, sourceType?: string, targetType?: string);
 }
+/** Relationship source and target entity are the same — self-references are not permitted */
+declare class SelfReferentialRelationshipError extends DeepMemoryError {
+    readonly entityId: string;
+    readonly relationshipType: string;
+    constructor(entityId: string, relationshipType: string);
+}
 /** Governance rules denied the operation */
 declare class GovernanceDeniedError extends DeepMemoryError {
     readonly governanceMode: string;
@@ -118,18 +124,6 @@ declare class TraversalTimeoutError extends DeepMemoryError {
     constructor(timeoutMs: number);
 }
 
-/** A single validation error with optional suggestion */
-interface ValidationError {
-    field: string;
-    message: string;
-    suggestion?: string;
-}
-/** Result of a validation check */
-interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-}
-
 interface VocabularyEngineConfig {
     repositoryId: string;
     storageProvider: StorageProvider;
@@ -230,7 +224,13 @@ interface MemoryRepositoryConfig {
     repositoryId: string;
     storage: StorageProvider;
     search?: SearchProvider;
+    /** Embedding provider configured for this repository's model + dimensions */
     embedding?: EmbeddingProvider;
+    /**
+     * Factory for producing embedding providers with different model/dimensions.
+     * Required only if reembedAll will be called with a new model or dimensions.
+     */
+    embeddingFactory?: EmbeddingProviderFactory;
     graphTraversal?: GraphTraversalProvider;
     vocabularyEngine: VocabularyEngine;
     provenanceTracker: ProvenanceTracker;
@@ -247,6 +247,8 @@ declare class MemoryRepository {
     private readonly relationshipManager;
     private readonly graphTraversal;
     private readonly searchOrchestrator;
+    private readonly embeddingFactory?;
+    private embedding?;
     constructor(config: MemoryRepositoryConfig);
     getVocabulary(): Promise<ResolvedVocabulary>;
     proposeVocabularyChange(proposal: VocabularyProposal): Promise<VocabularyProposalResult>;
@@ -258,15 +260,22 @@ declare class MemoryRepository {
     getBySlug(slug: string, detailLevel?: DetailLevel): Promise<Entity | EntitySummary | EntityBrief | null>;
     getEntities(entityIds: string[], detailLevel?: 'brief' | 'summary'): Promise<Map<string, EntitySummary | EntityBrief>>;
     findEntities(query: FindEntitiesQuery): Promise<PaginatedResult<Entity | EntitySummary | EntityBrief>>;
-    deleteEntity(entityId: string): Promise<void>;
+    deleteEntities(ids: string[]): Promise<DeleteEntitiesResult>;
     /** Re-embed specific entities using the current EmbeddingProvider */
     reembedEntities(entityIds: string[]): Promise<ReembedResult>;
     /**
-     * Re-embed all entities in the repository using the current EmbeddingProvider.
+     * Re-embed all entities in the repository. If `model` or `dimensions` is provided,
+     * the repository's embedding configuration is updated to the new values before
+     * re-embedding, so all subsequent entity writes use the new model/dimensionality.
+     *
      * Processes in batches with optional rate limiting. Emits reembed:* events for progress tracking.
      * Updates repository metadata with the new model ID and dimensions on completion.
      */
     reembedAll(options?: {
+        /** New embedding model to switch to. Requires an embeddingFactory on DeepMemory. */
+        model?: string;
+        /** New embedding dimensionality to switch to. Requires an embeddingFactory on DeepMemory. */
+        dimensions?: number;
         batchSize?: number;
         /** Max retries per batch on embedding failure (default 3) */
         maxRetries?: number;
@@ -276,7 +285,7 @@ declare class MemoryRepository {
         delayBetweenBatchesMs?: number;
     }): Promise<ReembedResult>;
     createRelationships(inputs: CreateRelationshipInput[]): Promise<Relationship[]>;
-    removeRelationship(relationshipId: string): Promise<void>;
+    removeRelationships(ids: string[]): Promise<RemoveRelationshipsResult>;
     getRelationships(entityId: string, options?: {
         relationshipTypes?: string[];
         direction?: 'outbound' | 'inbound' | 'both';
@@ -299,6 +308,19 @@ declare class MemoryRepository {
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
+    /**
+     * Audit a window of entities against the current vocabulary. Returns a single
+     * page; callers loop until `done` is true. Paging is over scanned entities,
+     * not issues. Does not mutate anything.
+     */
+    validateEntities(options?: ValidateEntitiesOptions): Promise<EntityValidationPage>;
+    /**
+     * Audit a window of relationships against the current vocabulary. Returns a
+     * single page; callers loop until `done` is true. The full entity set is
+     * loaded once per call to resolve orphan and type-mismatch checks, then
+     * offset/take is applied to the relationship stream. Does not mutate anything.
+     */
+    validateRelationships(options?: ValidateRelationshipsOptions): Promise<RelationshipValidationPage>;
     /** Delete all entities and relationships in this repository, preserving the repository and vocabulary */
     deleteAllContents(): Promise<{
         deletedEntities: number;
@@ -323,8 +345,17 @@ interface DeepMemoryConfig {
     storage: StorageProvider;
     /** Optional: search provider for full-text search */
     search?: SearchProvider;
-    /** Optional: embedding provider for semantic search */
-    embedding?: EmbeddingProvider;
+    /**
+     * Optional: factory that produces an EmbeddingProvider configured for a specific
+     * model + dimensionality. Called once per repository open/create using the repo's
+     * stored embedding metadata, so different repositories can use different models
+     * and embedding dimensions without any per-mutation lookups.
+     */
+    embeddingFactory?: EmbeddingProviderFactory;
+    /** Default embedding model for new repositories that don't specify one in metadata */
+    defaultEmbeddingModel?: string;
+    /** Default embedding dimensions for new repositories that don't specify one in metadata */
+    defaultEmbeddingDimensions?: number;
     /** Optional: lock provider for distributed locking */
     lock?: LockProvider;
     /** Optional: graph traversal provider for native multi-hop queries */
@@ -335,7 +366,9 @@ interface DeepMemoryConfig {
 declare class DeepMemory {
     private readonly storage;
     private readonly search?;
-    private readonly embedding?;
+    private readonly embeddingFactory?;
+    private readonly defaultEmbeddingModel?;
+    private readonly defaultEmbeddingDimensions?;
     /** Reserved for future distributed locking support */
     readonly lock?: LockProvider;
     private readonly graphTraversalProvider?;
@@ -343,6 +376,11 @@ declare class DeepMemory {
     private readonly globalEventBus;
     private initialized;
     constructor(config: DeepMemoryConfig);
+    /**
+     * Build an embedding provider for a repository given its stored model + dimensions.
+     * Returns undefined when no factory is configured or when model/dimensions are missing.
+     */
+    private buildEmbeddingForRepository;
     /** Initialize the storage provider and optional providers (call once before use) */
     private ensureInitialized;
     /** Create or migrate the storage schema. Call once at deployment / startup, not per-request. */
@@ -388,6 +426,15 @@ declare class DeepMemory {
     dispose(): Promise<void>;
 }
 
+declare class RepositoryValidator {
+    private readonly repositoryId;
+    private readonly storage;
+    private readonly vocabularyEngine;
+    constructor(repositoryId: string, storage: StorageProvider, vocabularyEngine: VocabularyEngine);
+    validateEntities(options?: ValidateEntitiesOptions): Promise<EntityValidationPage>;
+    validateRelationships(options?: ValidateRelationshipsOptions): Promise<RelationshipValidationPage>;
+}
+
 /**
  * Evaluate whether a set of properties matches all given filters.
  * All filters are AND'd — every filter must match for the result to be true.
@@ -454,7 +501,15 @@ declare class InMemoryStorageProvider implements StorageProvider {
     createRelationship(repositoryId: string, relationship: StoredRelationship): Promise<StoredRelationship>;
     getRelationship(repositoryId: string, relationshipId: string): Promise<StoredRelationship | null>;
     getEntityRelationships(repositoryId: string, entityId: string, options?: RelationshipQueryOptions): Promise<PaginatedResult<StoredRelationship>>;
+    deleteEntities(repositoryId: string, ids: string[]): Promise<{
+        deleted: string[];
+        notFound: string[];
+    }>;
     deleteRelationship(repositoryId: string, relationshipId: string): Promise<void>;
+    deleteRelationships(repositoryId: string, ids: string[]): Promise<{
+        deleted: string[];
+        notFound: string[];
+    }>;
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
@@ -481,4 +536,4 @@ declare class NoOpEmbeddingProvider implements EmbeddingProvider {
     modelId(): string;
 }
 
-export { BulkImportOptions, BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, DeleteProgressCallback, DetailLevel, DuplicateEntityError, DuplicateRelationshipError, DuplicateRepositoryError, EmbeddingProvider, EmbeddingProviderRequiredError, EnsureSchemaResult, Entity, EntityBrief, EntityNotFoundError, EntitySummary, EntityTypeDefinition, EventHandler, EventPayload, ExploreOptions, ExportArchive, ExportChunk, ExportError, ExportOptions, ExportStreamItem, FindEntitiesQuery, GovernanceConfig, GovernanceDeniedError, GraphResult, GraphTraversalProvider, GraphTraversalProviderRequiredError, GremlinCompiler, HookResult, ImportChunk, ImportError, ImportOptions, ImportResult, ImportStreamHeader, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationCancelledError, PaginatedResult, PaginationOptions, PathOptions, PathResult, PropertyFilter, Provenance, ProvenanceContext, ProviderError, ReembedResult, Relationship, RelationshipConstraintError, RelationshipNotFoundError, RelationshipQueryOptions, RelationshipSummary, RepositoryConfig, RepositoryFilter, RepositoryNotFoundError, RepositoryStats, RepositorySummary, RepositoryUpdate, ResolvedVocabulary, ScoredEntity, SearchHit, SearchOptions, SearchProvider, SearchableEntity, StorageExploreOptions, StorageFindQuery, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageProvider, StorageRepositoryConfig, StorageTimelineOptions, StorageTimelineResult, StoredEntity, StoredEntityUpdate, StoredRelationship, StoredRepository, StoredRepositorySummary, TimelineOptions, TimelineResult, type TraversalCompiler, TraversalResult, TraversalSpec, TraversalTimeoutError, TraversalValidationError, TraversalVocabularyError, Unsubscribe, UpdateEntityInput, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, generateId, isValidUuid, matchesPropertyFilters, projectEntity };
+export { BulkImportOptions, BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, DeleteEntitiesResult, DeleteProgressCallback, DetailLevel, DuplicateEntityError, DuplicateRelationshipError, DuplicateRepositoryError, EmbeddingProvider, EmbeddingProviderFactory, EmbeddingProviderRequiredError, EnsureSchemaResult, Entity, EntityBrief, EntityNotFoundError, EntitySummary, EntityTypeDefinition, EntityValidationPage, EventHandler, EventPayload, ExploreOptions, ExportArchive, ExportChunk, ExportError, ExportOptions, ExportStreamItem, FindEntitiesQuery, GovernanceConfig, GovernanceDeniedError, GraphResult, GraphTraversalProvider, GraphTraversalProviderRequiredError, GremlinCompiler, HookResult, ImportChunk, ImportError, ImportOptions, ImportResult, ImportStreamHeader, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationCancelledError, PaginatedResult, PaginationOptions, PathOptions, PathResult, PropertyFilter, Provenance, ProvenanceContext, ProviderError, ReembedResult, Relationship, RelationshipConstraintError, RelationshipNotFoundError, RelationshipQueryOptions, RelationshipSummary, RelationshipValidationPage, RemoveRelationshipsResult, RepositoryConfig, RepositoryFilter, RepositoryNotFoundError, RepositoryStats, RepositorySummary, RepositoryUpdate, RepositoryValidator, ResolvedVocabulary, ScoredEntity, SearchHit, SearchOptions, SearchProvider, SearchableEntity, SelfReferentialRelationshipError, StorageExploreOptions, StorageFindQuery, StorageNeighborhood, StoragePathOptions, StoragePathResult, StorageProvider, StorageRepositoryConfig, StorageTimelineOptions, StorageTimelineResult, StoredEntity, StoredEntityUpdate, StoredRelationship, StoredRepository, StoredRepositorySummary, TimelineOptions, TimelineResult, type TraversalCompiler, TraversalResult, TraversalSpec, TraversalTimeoutError, TraversalValidationError, TraversalVocabularyError, Unsubscribe, UpdateEntityInput, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, generateId, isValidUuid, matchesPropertyFilters, projectEntity };