@utaba/deep-memory 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-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 Neighbourhood, W as PathOptions, X as PathResult, Y as ConceptSearchOptions, Z as ScoredEntity, _ as TimelineOptions, $ as TimelineResult, i as RepositoryStats, a0 as RepositoryConfig, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, c as StoredRepository, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, k as StoredEntity, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighbourhood, 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-1KBMVBGJ.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 NeighbourhoodCentre, al as NeighbourhoodGroup, am as NeighbourhoodLayer, 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 StorageNeighbourhoodGroup, aw as StorageNeighbourhoodLayer, ax as StoragePath, ay as StorageTimelineEvent, az as TimelineEntityRef, aA as TimelineEvent, aB as TimelineRelationshipDetail, aC as VocabularyInput } from './portability-1KBMVBGJ.cjs';
+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, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, c as StoredRepository, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, k as StoredEntity, 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 { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload } from './types/index.cjs';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-DQynd-to.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-DQynd-to.cjs';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-CSbaIY6X.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';
 export { GraphTraversalCapabilities, LockHandle, LockOptions } from './providers/index.cjs';
 
@@ -292,7 +292,7 @@ declare class MemoryRepository {
         offset?: number;
         detailLevel?: DetailLevel;
     }): Promise<GraphResult>;
-    exploreNeighbourhood(entityId: string, options?: ExploreOptions): Promise<Neighbourhood>;
+    exploreNeighborhood(entityId: string, options?: ExploreOptions): Promise<Neighborhood>;
     findPaths(sourceId: string, targetId: string, options?: PathOptions): Promise<PathResult>;
     traverse(spec: TraversalSpec): Promise<TraversalResult>;
     executeNativeQuery(query: string, params?: Record<string, unknown>): Promise<TraversalResult>;
@@ -341,10 +341,10 @@ declare class DeepMemory {
     private readonly graphTraversalProvider?;
     private readonly provenance;
     private readonly globalEventBus;
-    private initialised;
+    private initialized;
     constructor(config: DeepMemoryConfig);
-    /** Initialise the storage provider and optional providers (call once before use) */
-    private ensureInitialised;
+    /** 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. */
     ensureSchema(): Promise<EnsureSchemaResult>;
     private validateRepositoryId;
@@ -420,7 +420,7 @@ declare class CypherCompiler implements TraversalCompiler {
 declare class InMemoryStorageProvider implements StorageProvider {
     private stores;
     private getStore;
-    initialise(): Promise<void>;
+    initialize(): Promise<void>;
     dispose(): Promise<void>;
     createRepository(config: StorageRepositoryConfig): Promise<StoredRepository>;
     getRepository(repositoryId: string): Promise<StoredRepository | null>;
@@ -453,7 +453,7 @@ declare class InMemoryStorageProvider implements StorageProvider {
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
-    exploreNeighbourhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighbourhood>;
+    exploreNeighborhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighborhood>;
     findPaths(repositoryId: string, sourceId: string, targetId: string, options: StoragePathOptions): Promise<StoragePathResult>;
     getTimeline(repositoryId: string, entityId: string, options: StorageTimelineOptions): Promise<StorageTimelineResult>;
     exportAll(repositoryId: string): AsyncIterable<ExportChunk>;
@@ -476,4 +476,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, Neighbourhood, 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, StorageNeighbourhood, 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 };
+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 };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-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 Neighbourhood, W as PathOptions, X as PathResult, Y as ConceptSearchOptions, Z as ScoredEntity, _ as TimelineOptions, $ as TimelineResult, i as RepositoryStats, a0 as RepositoryConfig, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, c as StoredRepository, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, k as StoredEntity, l as StoredEntityUpdate, m as StorageFindQuery, n as StoredRelationship, o as RelationshipQueryOptions, p as StorageExploreOptions, q as StorageNeighbourhood, 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-1KBMVBGJ.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 NeighbourhoodCentre, al as NeighbourhoodGroup, am as NeighbourhoodLayer, 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 StorageNeighbourhoodGroup, aw as StorageNeighbourhoodLayer, ax as StoragePath, ay as StorageTimelineEvent, az as TimelineEntityRef, aA as TimelineEvent, aB as TimelineRelationshipDetail, aC as VocabularyInput } from './portability-1KBMVBGJ.js';
+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, d as RepositoryFilter, a1 as RepositorySummary, g as RepositoryUpdate, c as StoredRepository, a2 as ExportOptions, a3 as ExportArchive, a4 as ImportOptions, a5 as ImportResult, a6 as ExportStreamItem, a7 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, f as StoredRepositorySummary, h as DeleteProgressCallback, j as PaginationOptions, V as VocabularyChangeRecord, k as StoredEntity, 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 { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload } from './types/index.js';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-B4SUysM-.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-B4SUysM-.js';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-DqW-zpd0.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';
 export { GraphTraversalCapabilities, LockHandle, LockOptions } from './providers/index.js';
 
@@ -292,7 +292,7 @@ declare class MemoryRepository {
         offset?: number;
         detailLevel?: DetailLevel;
     }): Promise<GraphResult>;
-    exploreNeighbourhood(entityId: string, options?: ExploreOptions): Promise<Neighbourhood>;
+    exploreNeighborhood(entityId: string, options?: ExploreOptions): Promise<Neighborhood>;
     findPaths(sourceId: string, targetId: string, options?: PathOptions): Promise<PathResult>;
     traverse(spec: TraversalSpec): Promise<TraversalResult>;
     executeNativeQuery(query: string, params?: Record<string, unknown>): Promise<TraversalResult>;
@@ -341,10 +341,10 @@ declare class DeepMemory {
     private readonly graphTraversalProvider?;
     private readonly provenance;
     private readonly globalEventBus;
-    private initialised;
+    private initialized;
     constructor(config: DeepMemoryConfig);
-    /** Initialise the storage provider and optional providers (call once before use) */
-    private ensureInitialised;
+    /** 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. */
     ensureSchema(): Promise<EnsureSchemaResult>;
     private validateRepositoryId;
@@ -420,7 +420,7 @@ declare class CypherCompiler implements TraversalCompiler {
 declare class InMemoryStorageProvider implements StorageProvider {
     private stores;
     private getStore;
-    initialise(): Promise<void>;
+    initialize(): Promise<void>;
     dispose(): Promise<void>;
     createRepository(config: StorageRepositoryConfig): Promise<StoredRepository>;
     getRepository(repositoryId: string): Promise<StoredRepository | null>;
@@ -453,7 +453,7 @@ declare class InMemoryStorageProvider implements StorageProvider {
     deleteRelationshipsByType(repositoryId: string, relationshipType: string): Promise<{
         deletedRelationships: number;
     }>;
-    exploreNeighbourhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighbourhood>;
+    exploreNeighborhood(repositoryId: string, entityId: string, options: StorageExploreOptions): Promise<StorageNeighborhood>;
     findPaths(repositoryId: string, sourceId: string, targetId: string, options: StoragePathOptions): Promise<StoragePathResult>;
     getTimeline(repositoryId: string, entityId: string, options: StorageTimelineOptions): Promise<StorageTimelineResult>;
     exportAll(repositoryId: string): AsyncIterable<ExportChunk>;
@@ -476,4 +476,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, Neighbourhood, 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, StorageNeighbourhood, 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 };
+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 };

package/dist/index.js

@@ -277,6 +277,12 @@ var EntityManager = class {
     this.storage = storage;
     this.embedding = embedding;
   }
+  repositoryId;
+  vocabularyEngine;
+  provenanceTracker;
+  eventBus;
+  storage;
+  embedding;
   /** Create one or more entities with vocabulary validation, ID generation, provenance, and events */
   async create(inputs) {
     const results = [];
@@ -640,7 +646,7 @@ function jaroWinklerSimilarity(a, b, scalingFactor = 0.1) {
   }
   return jaro + commonPrefix * Math.min(scalingFactor, 0.25) * (1 - jaro);
 }
-function normaliseTypeName(name) {
+function normalizeTypeName(name) {
   return name.toLowerCase().trim().replace(/[-\s.]+/g, "_").replace(/[^a-z0-9_]/g, "");
 }
 function toScreamingSnakeCase(name) {
@@ -656,6 +662,11 @@ var RelationshipManager = class {
     this.eventBus = eventBus;
     this.storage = storage;
   }
+  repositoryId;
+  vocabularyEngine;
+  provenanceTracker;
+  eventBus;
+  storage;
   /** Create one or more relationships with vocabulary validation, provenance, and events */
   async create(inputs) {
     const results = [];
@@ -1590,8 +1601,12 @@ var GraphTraversal = class {
     this.graphTraversalProvider = graphTraversalProvider;
     this.vocabularyEngine = vocabularyEngine;
   }
-  /** BFS neighbourhood exploration from a centre entity */
-  async exploreNeighbourhood(entityId, options) {
+  repositoryId;
+  storage;
+  graphTraversalProvider;
+  vocabularyEngine;
+  /** BFS neighborhood exploration from a center entity */
+  async exploreNeighborhood(entityId, options) {
     const storageOptions = {
       depth: options?.depth ?? 1,
       relationshipTypes: options?.relationshipTypes,
@@ -1601,13 +1616,13 @@ var GraphTraversal = class {
       offsetPerType: options?.offsetPerType ?? 0,
       relationshipPropertyFilters: options?.relationshipPropertyFilters
     };
-    const storageResult = await this.storage.exploreNeighbourhood(
+    const storageResult = await this.storage.exploreNeighborhood(
       this.repositoryId,
       entityId,
       storageOptions
     );
-    const centreEntity = await this.storage.getEntity(this.repositoryId, entityId);
-    if (!centreEntity) {
+    const centerEntity = await this.storage.getEntity(this.repositoryId, entityId);
+    if (!centerEntity) {
       throw new EntityNotFoundError(entityId);
     }
     const detailLevel = options?.detailLevel ?? "summary";
@@ -1631,11 +1646,11 @@ var GraphTraversal = class {
       return layer;
     });
     return {
-      centre: {
-        id: centreEntity.id,
-        slug: centreEntity.slug,
-        entityType: centreEntity.entityType,
-        label: centreEntity.label
+      center: {
+        id: centerEntity.id,
+        slug: centerEntity.slug,
+        entityType: centerEntity.entityType,
+        label: centerEntity.label
       },
       layers,
       statistics: {
@@ -2189,8 +2204,8 @@ var MemoryRepository = class {
     };
   }
   // ─── Graph Traversal ───────────────────────────────────────────────
-  async exploreNeighbourhood(entityId, options) {
-    return this.graphTraversal.exploreNeighbourhood(entityId, options);
+  async exploreNeighborhood(entityId, options) {
+    return this.graphTraversal.exploreNeighborhood(entityId, options);
   }
   async findPaths(sourceId, targetId, options) {
     return this.graphTraversal.findPaths(sourceId, targetId, options);
@@ -2220,7 +2235,7 @@ var MemoryRepository = class {
       storageOptions
     );
     const entity = await this.storage.getEntity(this.repositoryId, entityId);
-    const centreRef = {
+    const centerRef = {
       id: entityId,
       slug: entity?.slug ?? entityId,
       label: entity?.label ?? entityId
@@ -2266,7 +2281,7 @@ var MemoryRepository = class {
           timestamp: e.timestamp,
           eventType: e.eventType,
           description: `${rel.type} relationship created ${direction} ${otherRef.label}`,
-          relatedEntities: [centreRef, otherRef],
+          relatedEntities: [centerRef, otherRef],
           relationship: relDetail
         };
       }
@@ -2274,13 +2289,13 @@ var MemoryRepository = class {
       return {
         timestamp: e.timestamp,
         eventType: e.eventType,
-        description: `${centreRef.label} ${action}`,
-        relatedEntities: [centreRef]
+        description: `${centerRef.label} ${action}`,
+        relatedEntities: [centerRef]
       };
     });
     return {
       id: entityId,
-      slug: centreRef.slug,
+      slug: centerRef.slug,
       totalEvents: storageResult.total,
       returned: events.length,
       events
@@ -2363,14 +2378,14 @@ var SemanticDeduplicator = class {
   /**
    * Check whether a proposed type name is a duplicate of an existing type.
    * Uses embedding similarity if an EmbeddingProvider is available, otherwise falls back
-   * to Jaro-Winkler string similarity on normalised type names.
+   * to Jaro-Winkler string similarity on normalized type names.
    */
   async checkDuplicate(proposedType, proposedDescription, existingTypes) {
     if (existingTypes.length === 0) {
       return { isDuplicate: false, matches: [] };
     }
-    const normProposed = normaliseTypeName(proposedType);
-    const exactMatch = existingTypes.find((t) => normaliseTypeName(t.type) === normProposed);
+    const normProposed = normalizeTypeName(proposedType);
+    const exactMatch = existingTypes.find((t) => normalizeTypeName(t.type) === normProposed);
     if (exactMatch) {
       return {
         isDuplicate: true,
@@ -2406,10 +2421,10 @@ var SemanticDeduplicator = class {
     };
   }
   checkWithStringSimilarity(proposedType, existingTypes) {
-    const normProposed = normaliseTypeName(proposedType);
+    const normProposed = normalizeTypeName(proposedType);
     const matches = [];
     for (const existing of existingTypes) {
-      const normExisting = normaliseTypeName(existing.type);
+      const normExisting = normalizeTypeName(existing.type);
       const similarity = jaroWinklerSimilarity(normProposed, normExisting);
       if (similarity >= this.threshold) {
         matches.push({
@@ -2570,7 +2585,7 @@ function canPropose(governanceConfig, _proposal) {
     case "locked":
       return {
         allowed: false,
-        reason: "Vocabulary is locked. Only organisation admins can modify the vocabulary via the admin API."
+        reason: "Vocabulary is locked. Only organization admins can modify the vocabulary via the admin API."
       };
     case "managed":
     case "open":
@@ -3010,9 +3025,9 @@ function validateEntityUpdate(input, entityTypeDef) {
   return ok();
 }
 function validateRelationship(input, vocabulary, sourceEntityType, targetEntityType) {
-  const normalisedType = toScreamingSnakeCase(input.relationshipType);
+  const normalizedType = toScreamingSnakeCase(input.relationshipType);
   const relTypeDef = vocabulary.relationshipTypes.find(
-    (rt) => rt.type === normalisedType
+    (rt) => rt.type === normalizedType
   );
   if (!relTypeDef) {
     const closest = findClosestType(input.relationshipType, vocabulary.relationshipTypes);
@@ -3337,7 +3352,7 @@ var EventBus = class {
 };
 
 // src/portability/RepositoryExporter.ts
-var LIBRARY_VERSION = true ? "0.3.0" : "0.1.0";
+var LIBRARY_VERSION = true ? "0.4.0" : "0.1.0";
 var RepositoryExporter = class {
   storage;
   provenance;
@@ -3553,7 +3568,7 @@ function diffArrays(from, to) {
 // src/portability/MigrationEngine.ts
 var MigrationEngine = class {
   /**
-   * Analyse and migrate vocabulary differences between source and target.
+   * Analyze and migrate vocabulary differences between source and target.
    *
    * @param sourceVocabulary - vocabulary from the export archive
    * @param targetVocabulary - vocabulary in the target repository
@@ -3993,7 +4008,7 @@ var DeepMemory = class {
   graphTraversalProvider;
   provenance;
   globalEventBus;
-  initialised = false;
+  initialized = false;
   constructor(config) {
     this.storage = config.storage;
     this.search = config.search;
@@ -4003,16 +4018,16 @@ var DeepMemory = class {
     this.provenance = new ProvenanceTracker(config.provenance);
     this.globalEventBus = new EventBus(config.provenance);
   }
-  /** Initialise the storage provider and optional providers (call once before use) */
-  async ensureInitialised() {
-    if (!this.initialised) {
-      if (this.storage.initialise) {
-        await this.storage.initialise();
+  /** Initialize the storage provider and optional providers (call once before use) */
+  async ensureInitialized() {
+    if (!this.initialized) {
+      if (this.storage.initialize) {
+        await this.storage.initialize();
       }
-      if (this.graphTraversalProvider?.initialise) {
-        await this.graphTraversalProvider.initialise();
+      if (this.graphTraversalProvider?.initialize) {
+        await this.graphTraversalProvider.initialize();
       }
-      this.initialised = true;
+      this.initialized = true;
     }
   }
   /** Create or migrate the storage schema. Call once at deployment / startup, not per-request. */
@@ -4024,15 +4039,15 @@ var DeepMemory = class {
       schemaVersion: 0
     };
     try {
-      await this.ensureInitialised();
+      await this.ensureInitialized();
     } catch {
     }
     let result = noOpResult;
     if (this.storage.ensureSchema) {
       result = await this.storage.ensureSchema();
     }
-    if (!this.initialised) {
-      await this.ensureInitialised();
+    if (!this.initialized) {
+      await this.ensureInitialized();
     }
     return result;
   }
@@ -4047,7 +4062,7 @@ var DeepMemory = class {
   }
   /** Create a new memory repository */
   async createRepository(config) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     const repositoryId = config.repositoryId ?? generateId();
     this.validateRepositoryId(repositoryId);
     const context = this.provenance.getContext();
@@ -4104,7 +4119,7 @@ var DeepMemory = class {
   }
   /** Open an existing repository */
   async openRepository(repositoryId) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     this.validateRepositoryId(repositoryId);
     const storedRepo = await this.storage.getRepository(repositoryId);
     if (!storedRepo) {
@@ -4133,7 +4148,7 @@ var DeepMemory = class {
   }
   /** List all repositories */
   async listRepositories(filter) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     const result = await this.storage.listRepositories(filter);
     return {
       items: result.items.map((stored) => ({
@@ -4151,7 +4166,7 @@ var DeepMemory = class {
   }
   /** Update repository metadata and settings */
   async updateRepository(repositoryId, updates) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     this.validateRepositoryId(repositoryId);
     const updated = await this.storage.updateRepository(repositoryId, updates);
     await this.globalEventBus.emit("repository:updated", { repositoryId });
@@ -4159,7 +4174,7 @@ var DeepMemory = class {
   }
   /** Delete a repository */
   async deleteRepository(repositoryId) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     this.validateRepositoryId(repositoryId);
     const stats = await this.storage.getRepositoryStats(repositoryId);
     await this.globalEventBus.emit("delete:started", {
@@ -4180,7 +4195,7 @@ var DeepMemory = class {
   }
   /** Delete all entities and relationships in a repository, preserving the repository and vocabulary */
   async deleteAllContents(repositoryId) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     this.validateRepositoryId(repositoryId);
     const stats = await this.storage.getRepositoryStats(repositoryId);
     await this.globalEventBus.emit("delete:started", {
@@ -4201,7 +4216,7 @@ var DeepMemory = class {
   }
   /** Export a repository to a portable archive */
   async exportRepository(repositoryId, options) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     const stats = await this.storage.getRepositoryStats(repositoryId);
     await this.globalEventBus.emit("export:started", {
       repositoryId,
@@ -4223,7 +4238,7 @@ var DeepMemory = class {
   }
   /** Import a repository from a portable archive */
   async importRepository(archive, options) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     await this.globalEventBus.emit("import:started", { repositoryId: options.target.repositoryId });
     const importer = new RepositoryImporter({
       storage: this.storage,
@@ -4251,7 +4266,7 @@ var DeepMemory = class {
    * Use for large repositories to avoid loading everything into memory.
    */
   async *exportRepositoryStream(repositoryId, options) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     const exporter = new RepositoryExporter({
       storage: this.storage,
       provenance: this.provenance.getContext(),
@@ -4308,7 +4323,7 @@ var DeepMemory = class {
    * Use for large repositories to avoid loading everything into memory.
    */
   async importRepositoryStream(header, chunks, options) {
-    await this.ensureInitialised();
+    await this.ensureInitialized();
     const importer = new RepositoryImporter({
       storage: this.storage,
       actorId: this.provenance.getContext().actorId,
@@ -4348,7 +4363,7 @@ var DeepMemory = class {
     if (this.storage.dispose) {
       await this.storage.dispose();
     }
-    this.initialised = false;
+    this.initialized = false;
   }
 };
 
@@ -4363,7 +4378,7 @@ var InMemoryStorageProvider = class {
     return store;
   }
   // ─── Lifecycle ─────────────────────────────────────────────────────
-  async initialise() {
+  async initialize() {
   }
   async dispose() {
     this.stores.clear();
@@ -4680,7 +4695,7 @@ var InMemoryStorageProvider = class {
     return { deletedRelationships };
   }
   // ─── Graph Traversal ───────────────────────────────────────────────
-  async exploreNeighbourhood(repositoryId, entityId, options) {
+  async exploreNeighborhood(repositoryId, entityId, options) {
     const store = this.getStore(repositoryId);
     if (!store.entities.has(entityId)) {
       throw new EntityNotFoundError(entityId);
@@ -4746,7 +4761,7 @@ var InMemoryStorageProvider = class {
       if (nextFrontier.size === 0) break;
     }
     return {
-      centreId: entityId,
+      centerId: entityId,
       layers
     };
   }