@utaba/deep-memory 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { G as GovernanceConfig, M as MemoryVocabulary, u as ResolvedVocabulary, C as CreateEntityInput, U as UpdateEntityInput, v as CreateRelationshipInput, w as EntityTypeDefinition, x as VocabularyProposal, y as VocabularyProposalResult, z as ProvenanceContext, A as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, F as FindEntitiesQuery, d as PaginatedResult, H as ReembedResult, J as Relationship, P as PropertyFilter, K as RelationshipSummary, L as GraphResult, N as ExploreOptions, O as Neighbourhood, Q as PathOptions, T as PathResult, W as ConceptSearchOptions, X as ScoredEntity, Y as TimelineOptions, Z as TimelineResult, g as RepositoryStats, _ as RepositoryConfig, R as RepositoryFilter, $ as RepositorySummary, f as RepositoryUpdate, c as StoredRepository, a0 as ExportOptions, a1 as ExportArchive, a2 as ImportOptions, a3 as ImportResult, a4 as ExportStreamItem, a5 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, e as StoredRepositorySummary, h as PaginationOptions, V as VocabularyChangeRecord, i as StoredEntity, j as StoredEntityUpdate, k as StorageFindQuery, l as StoredRelationship, m as RelationshipQueryOptions, n as StorageExploreOptions, o as StorageNeighbourhood, p as StoragePathOptions, q as StoragePathResult, r as StorageTimelineOptions, s as StorageTimelineResult, t as ExportChunk, B as BulkImportResult, a6 as SearchOptions, a7 as SearchHit } from './portability-DdjsCB07.cjs';
-export { a8 as EnrichedRelationship, a9 as EntityMap, aa as EntityTypeInput, ab as ExportLegalMetadata, ac as ExportManifest, ad as ExportPipelineMetadata, ae as GetEntitiesOptions, af as GetEntityOptions, ag as GovernanceMode, ah as ImportWarning, ai as NeighbourhoodCentre, aj as NeighbourhoodGroup, ak as NeighbourhoodLayer, al as Path, am as PropertySchema, an as PropertyType, ao as ProvenanceFilter, ap as RelationshipDirection, aq as RelationshipTypeDefinition, ar as RelationshipTypeInput, as as RepositoryMetadata, at as StorageNeighbourhoodGroup, au as StorageNeighbourhoodLayer, av as StoragePath, aw as StorageTimelineEvent, ax as TimelineEntityRef, ay as TimelineEvent, az as TimelineRelationshipDetail, aA as VocabularyInput } from './portability-DdjsCB07.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-BB_yERbf.cjs';
-export { Q as QueryMetadata, b as TraversalPath, c as TraversalRelationship, d as TraversalReturnMode, e as TraversalStart, f as TraversalStep } from './traversal-BB_yERbf.cjs';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-C3tKhfuw.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,13 +292,23 @@ 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>;
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
+    /** Delete all entities and relationships in this repository, preserving the repository and vocabulary */
+    deleteAllContents(): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
+    /**
+     * Returns a static markdown guide describing the recommended query strategy
+     * for AI agents and other consumers of the repository.
+     */
+    getQueryGuide(): string;
     on<E extends DeepMemoryEventType>(event: E, handler: EventHandler<E>): Unsubscribe;
     onHook<E extends Extract<DeepMemoryEventType, 'entity:creating' | 'entity:updating' | 'entity:deleting' | 'relationship:creating' | 'relationship:removing'>>(event: E, handler: HookHandler<E>): Unsubscribe;
 }
@@ -331,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;
@@ -348,6 +358,11 @@ declare class DeepMemory {
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
     /** Delete a repository */
     deleteRepository(repositoryId: string): Promise<void>;
+    /** Delete all entities and relationships in a repository, preserving the repository and vocabulary */
+    deleteAllContents(repositoryId: string): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     /** Export a repository to a portable archive */
     exportRepository(repositoryId: string, options?: ExportOptions): Promise<ExportArchive>;
     /** Import a repository from a portable archive */
@@ -405,13 +420,17 @@ 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>;
     listRepositories(filter?: RepositoryFilter): Promise<PaginatedResult<StoredRepositorySummary>>;
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
-    deleteRepository(repositoryId: string): Promise<void>;
+    deleteRepository(repositoryId: string, _onProgress?: DeleteProgressCallback): Promise<void>;
+    deleteAllContents(repositoryId: string, _onProgress?: DeleteProgressCallback): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     getRepositoryStats(repositoryId: string): Promise<RepositoryStats>;
     getVocabulary(repositoryId: string): Promise<MemoryVocabulary>;
     saveVocabulary(repositoryId: string, vocabulary: MemoryVocabulary): Promise<void>;
@@ -434,11 +453,11 @@ 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>;
-    importBulk(repositoryId: string, data: ImportChunk[]): Promise<BulkImportResult>;
+    importBulk(repositoryId: string, data: ImportChunk[], _options?: BulkImportOptions): Promise<BulkImportResult>;
 }
 
 declare class InMemorySearchProvider implements SearchProvider {
@@ -457,4 +476,4 @@ declare class NoOpEmbeddingProvider implements EmbeddingProvider {
     modelId(): string;
 }
 
-export { BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, 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, u as ResolvedVocabulary, C as CreateEntityInput, U as UpdateEntityInput, v as CreateRelationshipInput, w as EntityTypeDefinition, x as VocabularyProposal, y as VocabularyProposalResult, z as ProvenanceContext, A as Provenance, E as Entity, D as DetailLevel, a as EntitySummary, b as EntityBrief, F as FindEntitiesQuery, d as PaginatedResult, H as ReembedResult, J as Relationship, P as PropertyFilter, K as RelationshipSummary, L as GraphResult, N as ExploreOptions, O as Neighbourhood, Q as PathOptions, T as PathResult, W as ConceptSearchOptions, X as ScoredEntity, Y as TimelineOptions, Z as TimelineResult, g as RepositoryStats, _ as RepositoryConfig, R as RepositoryFilter, $ as RepositorySummary, f as RepositoryUpdate, c as StoredRepository, a0 as ExportOptions, a1 as ExportArchive, a2 as ImportOptions, a3 as ImportResult, a4 as ExportStreamItem, a5 as ImportStreamHeader, I as ImportChunk, S as StorageRepositoryConfig, e as StoredRepositorySummary, h as PaginationOptions, V as VocabularyChangeRecord, i as StoredEntity, j as StoredEntityUpdate, k as StorageFindQuery, l as StoredRelationship, m as RelationshipQueryOptions, n as StorageExploreOptions, o as StorageNeighbourhood, p as StoragePathOptions, q as StoragePathResult, r as StorageTimelineOptions, s as StorageTimelineResult, t as ExportChunk, B as BulkImportResult, a6 as SearchOptions, a7 as SearchHit } from './portability-DdjsCB07.js';
-export { a8 as EnrichedRelationship, a9 as EntityMap, aa as EntityTypeInput, ab as ExportLegalMetadata, ac as ExportManifest, ad as ExportPipelineMetadata, ae as GetEntitiesOptions, af as GetEntityOptions, ag as GovernanceMode, ah as ImportWarning, ai as NeighbourhoodCentre, aj as NeighbourhoodGroup, ak as NeighbourhoodLayer, al as Path, am as PropertySchema, an as PropertyType, ao as ProvenanceFilter, ap as RelationshipDirection, aq as RelationshipTypeDefinition, ar as RelationshipTypeInput, as as RepositoryMetadata, at as StorageNeighbourhoodGroup, au as StorageNeighbourhoodLayer, av as StoragePath, aw as StorageTimelineEvent, ax as TimelineEntityRef, ay as TimelineEvent, az as TimelineRelationshipDetail, aA as VocabularyInput } from './portability-DdjsCB07.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-9JdiqjZ9.js';
-export { Q as QueryMetadata, b as TraversalPath, c as TraversalRelationship, d as TraversalReturnMode, e as TraversalStart, f as TraversalStep } from './traversal-9JdiqjZ9.js';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-DR9HLYHJ.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,13 +292,23 @@ 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>;
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
+    /** Delete all entities and relationships in this repository, preserving the repository and vocabulary */
+    deleteAllContents(): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
+    /**
+     * Returns a static markdown guide describing the recommended query strategy
+     * for AI agents and other consumers of the repository.
+     */
+    getQueryGuide(): string;
     on<E extends DeepMemoryEventType>(event: E, handler: EventHandler<E>): Unsubscribe;
     onHook<E extends Extract<DeepMemoryEventType, 'entity:creating' | 'entity:updating' | 'entity:deleting' | 'relationship:creating' | 'relationship:removing'>>(event: E, handler: HookHandler<E>): Unsubscribe;
 }
@@ -331,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;
@@ -348,6 +358,11 @@ declare class DeepMemory {
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
     /** Delete a repository */
     deleteRepository(repositoryId: string): Promise<void>;
+    /** Delete all entities and relationships in a repository, preserving the repository and vocabulary */
+    deleteAllContents(repositoryId: string): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     /** Export a repository to a portable archive */
     exportRepository(repositoryId: string, options?: ExportOptions): Promise<ExportArchive>;
     /** Import a repository from a portable archive */
@@ -405,13 +420,17 @@ 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>;
     listRepositories(filter?: RepositoryFilter): Promise<PaginatedResult<StoredRepositorySummary>>;
     updateRepository(repositoryId: string, updates: RepositoryUpdate): Promise<StoredRepository>;
-    deleteRepository(repositoryId: string): Promise<void>;
+    deleteRepository(repositoryId: string, _onProgress?: DeleteProgressCallback): Promise<void>;
+    deleteAllContents(repositoryId: string, _onProgress?: DeleteProgressCallback): Promise<{
+        deletedEntities: number;
+        deletedRelationships: number;
+    }>;
     getRepositoryStats(repositoryId: string): Promise<RepositoryStats>;
     getVocabulary(repositoryId: string): Promise<MemoryVocabulary>;
     saveVocabulary(repositoryId: string, vocabulary: MemoryVocabulary): Promise<void>;
@@ -434,11 +453,11 @@ 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>;
-    importBulk(repositoryId: string, data: ImportChunk[]): Promise<BulkImportResult>;
+    importBulk(repositoryId: string, data: ImportChunk[], _options?: BulkImportOptions): Promise<BulkImportResult>;
 }
 
 declare class InMemorySearchProvider implements SearchProvider {
@@ -457,4 +476,4 @@ declare class NoOpEmbeddingProvider implements EmbeddingProvider {
     modelId(): string;
 }
 
-export { BulkImportResult, type CompiledQuery, ConceptSearchOptions, CreateEntityInput, CreateRelationshipInput, CypherCompiler, DeepMemory, type DeepMemoryConfig, DeepMemoryError, type DeepMemoryErrorCode, DeepMemoryEvent, DeepMemoryEventType, 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 };