@utaba/deep-memory 0.12.1 → 0.15.0

package/dist/index.d.cts

@@ -1,15 +1,15 @@
-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-BrUmvSaH.cjs';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, al as EnrichedRelationship, am as EntityMap, an as EntityTypeInput, ao as EntityValidationIssue, ap as ExportLegalMetadata, aq as ExportManifest, ar as ExportPipelineMetadata, as as GetEntitiesOptions, at as GetEntityOptions, au as GovernanceMode, av as ImportWarning, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, az as Path, aA as PropertySchema, aB as PropertyType, aC as ProvenanceFilter, aD as RelationshipDirection, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, aH as RepositoryMetadata, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, aL as StorageTimelineEvent, aM as TimelineEntityRef, aN as TimelineEvent, aO as TimelineRelationshipDetail, aP as VocabularyInput } from './portability-BrUmvSaH.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-P1hL-bOa.cjs';
+export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, al as EnrichedRelationship, am as EntityMap, an as EntityTypeInput, ao as EntityValidationIssue, ap as ExportLegalMetadata, aq as ExportManifest, ar as ExportPipelineMetadata, as as GetEntitiesOptions, at as GetEntityOptions, au as GovernanceMode, av as ImportWarning, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, az as Path, aA as PropertySchema, aB as PropertyType, aC as ProvenanceFilter, aD as RelationshipDirection, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, aH as RepositoryMetadata, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, aL as StorageTimelineEvent, aM as TimelineEntityRef, aN as TimelineEvent, aO as TimelineRelationshipDetail, aP as VocabularyInput } from './portability-P1hL-bOa.cjs';
 import { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload, UsageSink } from './types/index.cjs';
 export { OperationUsage } from './types/index.cjs';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-qKh6sE-g.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-qKh6sE-g.cjs';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-CrMaJuZ3.cjs';
+import { T as TraversalSpec, a as TraversalResult } from './traversal-CBE5h5ob.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-CBE5h5ob.cjs';
+import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-BGtKZZt4.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' | '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';
+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' | 'OPERATION_ABORTED' | '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;
@@ -89,6 +89,15 @@ declare class OperationCancelledError extends DeepMemoryError {
     readonly reason: string;
     constructor(operation: string, reason: string);
 }
+/**
+ * A long-running operation was aborted by a caller-supplied AbortSignal.
+ * Cooperative — the in-flight batch/chunk completes before the abort is honoured,
+ * and any state written before the abort is left in place.
+ */
+declare class OperationAbortedError extends DeepMemoryError {
+    readonly operation: string;
+    constructor(operation: string);
+}
 /** Semantic search was attempted without an embedding provider */
 declare class EmbeddingProviderRequiredError extends DeepMemoryError {
     constructor();
@@ -284,7 +293,13 @@ declare class MemoryRepository {
      * 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.
+     * Processes in batches with optional rate limiting.
+     *
+     * Progress is delivered via the optional `onProgress` callback. Most callers
+     * should use {@link DeepMemory.reembedAll} instead, which wires this callback
+     * to the global event bus so `reembed:*` events are reachable via
+     * `DeepMemory.on()`.
+     *
      * Updates repository metadata with the new model ID and dimensions on completion.
      */
     reembedAll(options?: {
@@ -299,6 +314,20 @@ declare class MemoryRepository {
         errorThresholdToAbort?: number;
         /** Milliseconds to wait between batches for rate limiting (default 0) */
         delayBetweenBatchesMs?: number;
+        /**
+         * Called after each batch completes. Internal plumbing — the {@link DeepMemory}
+         * facade wires this to `globalEventBus.emit('reembed:progress', ...)`.
+         */
+        onProgress?: (progress: {
+            processed: number;
+            totalEntities: number;
+            failed: number;
+        }) => void | Promise<void>;
+        /**
+         * Caller-supplied abort signal. Honoured at batch boundaries.
+         * Any vectors already written by completed batches are left in place.
+         */
+        signal?: AbortSignal;
     }): Promise<ReembedResult>;
     createRelationships(inputs: CreateRelationshipInput[]): Promise<Relationship[]>;
     removeRelationships(ids: string[]): Promise<RemoveRelationshipsResult>;
@@ -320,7 +349,7 @@ declare class MemoryRepository {
     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>;
+    executeNativeQuery(query: string, params?: Record<string, unknown>): Promise<unknown[]>;
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
@@ -434,6 +463,27 @@ declare class DeepMemory {
      * Use for large repositories to avoid loading everything into memory.
      */
     importRepositoryStream(header: ImportStreamHeader, chunks: AsyncIterable<ImportChunk>, options: ImportOptions): Promise<ImportResult>;
+    /**
+     * Re-embed all entities in a repository, emitting `reembed:*` events on the
+     * global event bus (reachable via {@link DeepMemory.on}).
+     *
+     * Mirrors the lifecycle of {@link importRepositoryStream}: emits
+     * `reembed:started` up front, `reembed:progress` after every batch,
+     * and either `reembed:completed` or `reembed:failed` at the end.
+     *
+     * `options.signal` is honoured at batch boundaries — any vectors already
+     * written by completed batches are retained, and `reembed:failed` is emitted
+     * with the abort error message.
+     */
+    reembedAll(repositoryId: string, options?: {
+        model?: string;
+        dimensions?: number;
+        batchSize?: number;
+        maxRetries?: number;
+        errorThresholdToAbort?: number;
+        delayBetweenBatchesMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ReembedResult>;
     /** Subscribe to global events */
     on<E extends DeepMemoryEventType>(event: E, handler: EventHandler<E>): Unsubscribe;
     /** Update the provenance context (e.g., new conversation) */
@@ -563,4 +613,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, 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, ImportThrottleAbortError, 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, UsageSink, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, createSafeSink, 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, ImportThrottleAbortError, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationAbortedError, 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, UsageSink, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, createSafeSink, generateId, isValidUuid, matchesPropertyFilters, projectEntity };

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-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-BrUmvSaH.js';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, al as EnrichedRelationship, am as EntityMap, an as EntityTypeInput, ao as EntityValidationIssue, ap as ExportLegalMetadata, aq as ExportManifest, ar as ExportPipelineMetadata, as as GetEntitiesOptions, at as GetEntityOptions, au as GovernanceMode, av as ImportWarning, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, az as Path, aA as PropertySchema, aB as PropertyType, aC as ProvenanceFilter, aD as RelationshipDirection, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, aH as RepositoryMetadata, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, aL as StorageTimelineEvent, aM as TimelineEntityRef, aN as TimelineEvent, aO as TimelineRelationshipDetail, aP as VocabularyInput } from './portability-BrUmvSaH.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-P1hL-bOa.js';
+export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, al as EnrichedRelationship, am as EntityMap, an as EntityTypeInput, ao as EntityValidationIssue, ap as ExportLegalMetadata, aq as ExportManifest, ar as ExportPipelineMetadata, as as GetEntitiesOptions, at as GetEntityOptions, au as GovernanceMode, av as ImportWarning, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, az as Path, aA as PropertySchema, aB as PropertyType, aC as ProvenanceFilter, aD as RelationshipDirection, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, aH as RepositoryMetadata, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, aL as StorageTimelineEvent, aM as TimelineEntityRef, aN as TimelineEvent, aO as TimelineRelationshipDetail, aP as VocabularyInput } from './portability-P1hL-bOa.js';
 import { DeepMemoryEventType, EventHandler, Unsubscribe, DeepMemoryEvent, HookResult, EventPayload, UsageSink } from './types/index.js';
 export { OperationUsage } from './types/index.js';
-import { T as TraversalSpec, a as TraversalResult } from './traversal-BmCyenfC.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-BmCyenfC.js';
-import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-B5U72e5S.js';
+import { T as TraversalSpec, a as TraversalResult } from './traversal-B_84kGaO.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-B_84kGaO.js';
+import { S as StorageProvider, E as EnsureSchemaResult } from './StorageProvider-D_o2Hksf.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' | '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';
+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' | 'OPERATION_ABORTED' | '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;
@@ -89,6 +89,15 @@ declare class OperationCancelledError extends DeepMemoryError {
     readonly reason: string;
     constructor(operation: string, reason: string);
 }
+/**
+ * A long-running operation was aborted by a caller-supplied AbortSignal.
+ * Cooperative — the in-flight batch/chunk completes before the abort is honoured,
+ * and any state written before the abort is left in place.
+ */
+declare class OperationAbortedError extends DeepMemoryError {
+    readonly operation: string;
+    constructor(operation: string);
+}
 /** Semantic search was attempted without an embedding provider */
 declare class EmbeddingProviderRequiredError extends DeepMemoryError {
     constructor();
@@ -284,7 +293,13 @@ declare class MemoryRepository {
      * 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.
+     * Processes in batches with optional rate limiting.
+     *
+     * Progress is delivered via the optional `onProgress` callback. Most callers
+     * should use {@link DeepMemory.reembedAll} instead, which wires this callback
+     * to the global event bus so `reembed:*` events are reachable via
+     * `DeepMemory.on()`.
+     *
      * Updates repository metadata with the new model ID and dimensions on completion.
      */
     reembedAll(options?: {
@@ -299,6 +314,20 @@ declare class MemoryRepository {
         errorThresholdToAbort?: number;
         /** Milliseconds to wait between batches for rate limiting (default 0) */
         delayBetweenBatchesMs?: number;
+        /**
+         * Called after each batch completes. Internal plumbing — the {@link DeepMemory}
+         * facade wires this to `globalEventBus.emit('reembed:progress', ...)`.
+         */
+        onProgress?: (progress: {
+            processed: number;
+            totalEntities: number;
+            failed: number;
+        }) => void | Promise<void>;
+        /**
+         * Caller-supplied abort signal. Honoured at batch boundaries.
+         * Any vectors already written by completed batches are left in place.
+         */
+        signal?: AbortSignal;
     }): Promise<ReembedResult>;
     createRelationships(inputs: CreateRelationshipInput[]): Promise<Relationship[]>;
     removeRelationships(ids: string[]): Promise<RemoveRelationshipsResult>;
@@ -320,7 +349,7 @@ declare class MemoryRepository {
     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>;
+    executeNativeQuery(query: string, params?: Record<string, unknown>): Promise<unknown[]>;
     searchByConcept(query: string, options?: ConceptSearchOptions): Promise<PaginatedResult<ScoredEntity>>;
     getTimeline(entityId: string, options?: TimelineOptions): Promise<TimelineResult>;
     getStats(): Promise<RepositoryStats>;
@@ -434,6 +463,27 @@ declare class DeepMemory {
      * Use for large repositories to avoid loading everything into memory.
      */
     importRepositoryStream(header: ImportStreamHeader, chunks: AsyncIterable<ImportChunk>, options: ImportOptions): Promise<ImportResult>;
+    /**
+     * Re-embed all entities in a repository, emitting `reembed:*` events on the
+     * global event bus (reachable via {@link DeepMemory.on}).
+     *
+     * Mirrors the lifecycle of {@link importRepositoryStream}: emits
+     * `reembed:started` up front, `reembed:progress` after every batch,
+     * and either `reembed:completed` or `reembed:failed` at the end.
+     *
+     * `options.signal` is honoured at batch boundaries — any vectors already
+     * written by completed batches are retained, and `reembed:failed` is emitted
+     * with the abort error message.
+     */
+    reembedAll(repositoryId: string, options?: {
+        model?: string;
+        dimensions?: number;
+        batchSize?: number;
+        maxRetries?: number;
+        errorThresholdToAbort?: number;
+        delayBetweenBatchesMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ReembedResult>;
     /** Subscribe to global events */
     on<E extends DeepMemoryEventType>(event: E, handler: EventHandler<E>): Unsubscribe;
     /** Update the provenance context (e.g., new conversation) */
@@ -563,4 +613,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, 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, ImportThrottleAbortError, 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, UsageSink, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, createSafeSink, 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, ImportThrottleAbortError, InMemorySearchProvider, InMemoryStorageProvider, InvalidInputError, LockProvider, MemoryRepository, MemoryVocabulary, Neighborhood, NoOpEmbeddingProvider, OperationAbortedError, 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, UsageSink, ValidateEntitiesOptions, ValidateRelationshipsOptions, VocabularyChangeRecord, VocabularyProposal, VocabularyProposalResult, VocabularyValidationError, createSafeSink, generateId, isValidUuid, matchesPropertyFilters, projectEntity };

package/dist/index.js

@@ -165,6 +165,18 @@ var OperationCancelledError = class extends DeepMemoryError {
     this.reason = reason;
   }
 };
+var OperationAbortedError = class extends DeepMemoryError {
+  operation;
+  constructor(operation) {
+    super(
+      "OPERATION_ABORTED",
+      `${operation} aborted by caller`,
+      `The caller's AbortSignal was triggered. Partial state from completed batches has been retained.`
+    );
+    this.name = "OperationAbortedError";
+    this.operation = operation;
+  }
+};
 var EmbeddingProviderRequiredError = class extends DeepMemoryError {
   constructor() {
     super(
@@ -872,6 +884,7 @@ var EntityManager = class {
     }
     const batchSize = options?.batchSize ?? 50;
     const errorThreshold = options?.errorThresholdToAbort;
+    const signal = options?.signal;
     const firstPage = await this.storage.findEntities(this.repositoryId, { limit: 1, offset: 0 });
     const total = firstPage.total;
     let totalProcessed = 0;
@@ -879,6 +892,9 @@ var EntityManager = class {
     const allErrors = [];
     let offset = 0;
     while (offset < total) {
+      if (signal?.aborted) {
+        throw new OperationAbortedError("reembedAll");
+      }
       const page = await this.storage.findEntities(this.repositoryId, {
         limit: batchSize,
         offset
@@ -891,12 +907,15 @@ var EntityManager = class {
       totalProcessed += result.processed;
       totalFailed += result.failed;
       allErrors.push(...result.errors);
-      options?.onProgress?.(totalProcessed, total, totalFailed);
+      await options?.onProgress?.(totalProcessed, total, totalFailed);
       if (errorThreshold !== void 0 && totalFailed >= errorThreshold) {
         allErrors.push({ entityId: "", error: `Aborted: error threshold of ${errorThreshold} reached (${totalFailed} failures)` });
         break;
       }
       offset += page.items.length;
+      if (signal?.aborted) {
+        throw new OperationAbortedError("reembedAll");
+      }
       const delayMs = options?.delayBetweenBatchesMs ?? 0;
       if (delayMs > 0 && offset < total) {
         await new Promise((resolve) => {
@@ -2263,7 +2282,13 @@ var MemoryRepository = class {
    * 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.
+   * Processes in batches with optional rate limiting.
+   *
+   * Progress is delivered via the optional `onProgress` callback. Most callers
+   * should use {@link DeepMemory.reembedAll} instead, which wires this callback
+   * to the global event bus so `reembed:*` events are reachable via
+   * `DeepMemory.on()`.
+   *
    * Updates repository metadata with the new model ID and dimensions on completion.
    */
   async reembedAll(options) {
@@ -2298,46 +2323,23 @@ var MemoryRepository = class {
         }
       });
     }
-    const stats = await this.getStats();
-    await this.eventBus.emit("reembed:started", {
-      repositoryId: this.repositoryId,
-      totalEntities: stats.entityCount
+    const result = await this.entityManager.reembedAll({
+      batchSize: options?.batchSize,
+      maxRetries: options?.maxRetries,
+      errorThresholdToAbort: options?.errorThresholdToAbort,
+      delayBetweenBatchesMs: options?.delayBetweenBatchesMs,
+      signal: options?.signal,
+      onProgress: async (processed, total, failed) => {
+        await options?.onProgress?.({ processed, totalEntities: total, failed });
+      }
     });
-    try {
-      const result = await this.entityManager.reembedAll({
-        batchSize: options?.batchSize,
-        maxRetries: options?.maxRetries,
-        errorThresholdToAbort: options?.errorThresholdToAbort,
-        delayBetweenBatchesMs: options?.delayBetweenBatchesMs,
-        onProgress: async (processed, total, failed) => {
-          await this.eventBus.emit("reembed:progress", {
-            repositoryId: this.repositoryId,
-            processed,
-            totalEntities: total,
-            failed
-          });
-        }
-      });
-      await this.storage.updateRepository(this.repositoryId, {
-        metadata: {
-          embeddingModelId: result.modelId,
-          embeddingDimensions: result.dimensions
-        }
-      });
-      await this.eventBus.emit("reembed:completed", {
-        repositoryId: this.repositoryId,
-        processed: result.processed,
-        failed: result.failed,
-        modelId: result.modelId
-      });
-      return result;
-    } catch (err) {
-      await this.eventBus.emit("reembed:failed", {
-        repositoryId: this.repositoryId,
-        error: err instanceof Error ? err.message : String(err)
-      });
-      throw err;
-    }
+    await this.storage.updateRepository(this.repositoryId, {
+      metadata: {
+        embeddingModelId: result.modelId,
+        embeddingDimensions: result.dimensions
+      }
+    });
+    return result;
   }
   // ─── Relationships ─────────────────────────────────────────────────
   async createRelationships(inputs) {
@@ -3451,7 +3453,7 @@ var EventBus = class {
 };
 
 // src/portability/RepositoryExporter.ts
-var LIBRARY_VERSION = true ? "0.12.1" : "0.1.0";
+var LIBRARY_VERSION = true ? "0.15.0" : "0.1.0";
 var RepositoryExporter = class {
   storage;
   provenance;
@@ -3805,11 +3807,18 @@ var RepositoryImporter = class {
   storage;
   actorId;
   onProgress;
+  signal;
   migrationEngine = new MigrationEngine();
   constructor(config) {
     this.storage = config.storage;
     this.actorId = config.actorId;
     this.onProgress = config.onProgress;
+    this.signal = config.signal;
+  }
+  throwIfAborted() {
+    if (this.signal?.aborted) {
+      throw new OperationAbortedError("import");
+    }
   }
   /**
    * Import an export archive according to the provided options.
@@ -3885,6 +3894,7 @@ var RepositoryImporter = class {
     let chunksCompleted = 0;
     const adaptiveConcurrencyHandle = options.bulk?.adaptiveConcurrencyHandle ?? {};
     for await (const chunk of chunks) {
+      this.throwIfAborted();
       const bulkResult = await this.storage.importBulk(target.repositoryId, [chunk], {
         ...options.bulk,
         skipExistenceCheck: true,
@@ -3966,6 +3976,7 @@ var RepositoryImporter = class {
     let relationshipsSkipped = 0;
     let chunksCompleted = 0;
     for await (const chunk of chunks) {
+      this.throwIfAborted();
       if (chunk.entities) {
         for (const entity of chunk.entities) {
           let existing = await this.storage.getEntity(repositoryId, entity.id);
@@ -4384,22 +4395,31 @@ var DeepMemory = class {
     const importer = new RepositoryImporter({
       storage: this.storage,
       actorId: this.provenance.getContext().actorId,
-      onProgress: (progress) => this.globalEventBus.emit("import:progress", progress)
+      onProgress: (progress) => this.globalEventBus.emit("import:progress", progress),
+      signal: options.signal
     });
-    const result = await importer.import(archive, options);
-    if (result.success) {
-      await this.globalEventBus.emit("import:completed", {
-        repositoryId: result.repositoryId,
-        entitiesImported: result.statistics.entitiesImported,
-        relationshipsImported: result.statistics.relationshipsImported
-      });
-    } else {
+    try {
+      const result = await importer.import(archive, options);
+      if (result.success) {
+        await this.globalEventBus.emit("import:completed", {
+          repositoryId: result.repositoryId,
+          entitiesImported: result.statistics.entitiesImported,
+          relationshipsImported: result.statistics.relationshipsImported
+        });
+      } else {
+        await this.globalEventBus.emit("import:failed", {
+          repositoryId: result.repositoryId,
+          error: result.warnings.map((w) => w.message).join("; ")
+        });
+      }
+      return result;
+    } catch (err) {
       await this.globalEventBus.emit("import:failed", {
-        repositoryId: result.repositoryId,
-        error: result.warnings.map((w) => w.message).join("; ")
+        repositoryId: options.target.repositoryId,
+        error: err instanceof Error ? err.message : String(err)
       });
+      throw err;
     }
-    return result;
   }
   /**
    * Stream a repository export as an async generator.
@@ -4468,23 +4488,77 @@ var DeepMemory = class {
     const importer = new RepositoryImporter({
       storage: this.storage,
       actorId: this.provenance.getContext().actorId,
-      onProgress: (progress) => this.globalEventBus.emit("import:progress", progress)
+      onProgress: (progress) => this.globalEventBus.emit("import:progress", progress),
+      signal: options.signal
     });
     await this.globalEventBus.emit("import:started", { repositoryId: options.target.repositoryId });
-    const result = await importer.importStream(header, chunks, options);
-    if (result.success) {
-      await this.globalEventBus.emit("import:completed", {
-        repositoryId: result.repositoryId,
-        entitiesImported: result.statistics.entitiesImported,
-        relationshipsImported: result.statistics.relationshipsImported
-      });
-    } else {
+    try {
+      const result = await importer.importStream(header, chunks, options);
+      if (result.success) {
+        await this.globalEventBus.emit("import:completed", {
+          repositoryId: result.repositoryId,
+          entitiesImported: result.statistics.entitiesImported,
+          relationshipsImported: result.statistics.relationshipsImported
+        });
+      } else {
+        await this.globalEventBus.emit("import:failed", {
+          repositoryId: result.repositoryId,
+          error: result.warnings.map((w) => w.message).join("; ")
+        });
+      }
+      return result;
+    } catch (err) {
       await this.globalEventBus.emit("import:failed", {
-        repositoryId: result.repositoryId,
-        error: result.warnings.map((w) => w.message).join("; ")
+        repositoryId: options.target.repositoryId,
+        error: err instanceof Error ? err.message : String(err)
       });
+      throw err;
+    }
+  }
+  /**
+   * Re-embed all entities in a repository, emitting `reembed:*` events on the
+   * global event bus (reachable via {@link DeepMemory.on}).
+   *
+   * Mirrors the lifecycle of {@link importRepositoryStream}: emits
+   * `reembed:started` up front, `reembed:progress` after every batch,
+   * and either `reembed:completed` or `reembed:failed` at the end.
+   *
+   * `options.signal` is honoured at batch boundaries — any vectors already
+   * written by completed batches are retained, and `reembed:failed` is emitted
+   * with the abort error message.
+   */
+  async reembedAll(repositoryId, options) {
+    await this.ensureInitialized();
+    const repo = await this.openRepository(repositoryId);
+    const stats = await repo.getStats();
+    await this.globalEventBus.emit("reembed:started", {
+      repositoryId,
+      totalEntities: stats.entityCount
+    });
+    try {
+      const result = await repo.reembedAll({
+        ...options,
+        onProgress: (progress) => this.globalEventBus.emit("reembed:progress", {
+          repositoryId,
+          processed: progress.processed,
+          totalEntities: progress.totalEntities,
+          failed: progress.failed
+        })
+      });
+      await this.globalEventBus.emit("reembed:completed", {
+        repositoryId,
+        processed: result.processed,
+        failed: result.failed,
+        modelId: result.modelId
+      });
+      return result;
+    } catch (err) {
+      await this.globalEventBus.emit("reembed:failed", {
+        repositoryId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      throw err;
     }
-    return result;
   }
   /** Subscribe to global events */
   on(event, handler) {
@@ -5585,6 +5659,7 @@ export {
   InvalidInputError,
   MemoryRepository,
   NoOpEmbeddingProvider,
+  OperationAbortedError,
   OperationCancelledError,
   ProviderError,
   RelationshipConstraintError,