@utaba/deep-memory 0.12.1 → 0.15.0

package/dist/{portability-BrUmvSaH.d.cts → portability-P1hL-bOa.d.cts}

@@ -1027,6 +1027,17 @@ interface ImportOptions {
      * cannot be overridden here.
      */
     bulk?: Omit<BulkImportOptions, 'skipExistenceCheck'>;
+    /**
+     * Caller-supplied abort signal. Honoured at chunk boundaries — the chunk
+     * currently in flight completes before the abort is observed, and any
+     * entities/relationships already written are left in place. The repository
+     * row and vocabulary (in `create` mode) are also left in place; the caller
+     * is expected to delete the partial repository if it is no longer wanted.
+     *
+     * On abort, `import:failed` is emitted on the global event bus and
+     * `OperationAbortedError` is thrown from the import call.
+     */
+    signal?: AbortSignal;
 }
 /** A chunk of data for bulk import */
 interface ImportChunk {
@@ -1094,6 +1105,14 @@ interface AdaptiveConcurrencyOptions {
      * is observed. Default: 1000.
      */
     cooldownMs?: number;
+    /**
+     * Minimum time (ms) that must elapse after a throttle before concurrency can
+     * be incremented again. The dispatch cooldown (`cooldownMs`) only pauses new
+     * task dispatch; this separately freezes the ramp-up streak so the controller
+     * does not immediately climb back to a level that just proved unsustainable.
+     * Default: 5000.
+     */
+    rampUpCooldownMs?: number;
     /**
      * Circuit breaker — abort the import after this many consecutive throttled
      * tasks while the controller is already at `min` concurrency. The streak is

package/dist/{portability-BrUmvSaH.d.ts → portability-P1hL-bOa.d.ts}

@@ -1027,6 +1027,17 @@ interface ImportOptions {
      * cannot be overridden here.
      */
     bulk?: Omit<BulkImportOptions, 'skipExistenceCheck'>;
+    /**
+     * Caller-supplied abort signal. Honoured at chunk boundaries — the chunk
+     * currently in flight completes before the abort is observed, and any
+     * entities/relationships already written are left in place. The repository
+     * row and vocabulary (in `create` mode) are also left in place; the caller
+     * is expected to delete the partial repository if it is no longer wanted.
+     *
+     * On abort, `import:failed` is emitted on the global event bus and
+     * `OperationAbortedError` is thrown from the import call.
+     */
+    signal?: AbortSignal;
 }
 /** A chunk of data for bulk import */
 interface ImportChunk {
@@ -1094,6 +1105,14 @@ interface AdaptiveConcurrencyOptions {
      * is observed. Default: 1000.
      */
     cooldownMs?: number;
+    /**
+     * Minimum time (ms) that must elapse after a throttle before concurrency can
+     * be incremented again. The dispatch cooldown (`cooldownMs`) only pauses new
+     * task dispatch; this separately freezes the ramp-up streak so the controller
+     * does not immediately climb back to a level that just proved unsustainable.
+     * Default: 5000.
+     */
+    rampUpCooldownMs?: number;
     /**
      * Circuit breaker — abort the import after this many consecutive throttled
      * tasks while the controller is already at `min` concurrency. The streak is

package/dist/providers/index.d.cts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-CrMaJuZ3.cjs';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-BrUmvSaH.cjs';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-qKh6sE-g.cjs';
+export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-BGtKZZt4.cjs';
+import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-P1hL-bOa.cjs';
+import { T as TraversalSpec, a as TraversalResult } from '../traversal-CBE5h5ob.cjs';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.
@@ -117,7 +117,7 @@ interface GraphTraversalProvider {
      * For agent-facing graph queries use {@link traverse}, which takes a
      * structured TraversalSpec and lets the provider enforce repository scoping.
      */
-    executeNativeQuery(repositoryId: string, query: string, params?: Record<string, unknown>): Promise<TraversalResult>;
+    executeNativeQuery(repositoryId: string, query: string, params?: Record<string, unknown>): Promise<unknown[]>;
     /**
      * Report provider capabilities so the library can adapt
      * DSL compilation and validate traversal specs accordingly.

package/dist/providers/index.d.ts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-B5U72e5S.js';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-BrUmvSaH.js';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-BmCyenfC.js';
+export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-D_o2Hksf.js';
+import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-P1hL-bOa.js';
+import { T as TraversalSpec, a as TraversalResult } from '../traversal-B_84kGaO.js';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.
@@ -117,7 +117,7 @@ interface GraphTraversalProvider {
      * For agent-facing graph queries use {@link traverse}, which takes a
      * structured TraversalSpec and lets the provider enforce repository scoping.
      */
-    executeNativeQuery(repositoryId: string, query: string, params?: Record<string, unknown>): Promise<TraversalResult>;
+    executeNativeQuery(repositoryId: string, query: string, params?: Record<string, unknown>): Promise<unknown[]>;
     /**
      * Report provider capabilities so the library can adapt
      * DSL compilation and validate traversal specs accordingly.

package/dist/testing/conformance.d.cts

@@ -1,5 +1,5 @@
-import { S as StorageProvider } from '../StorageProvider-CrMaJuZ3.cjs';
-import '../portability-BrUmvSaH.cjs';
+import { S as StorageProvider } from '../StorageProvider-BGtKZZt4.cjs';
+import '../portability-P1hL-bOa.cjs';
 
 /**
  * Run the full StorageProvider conformance test suite.

package/dist/testing/conformance.d.ts

@@ -1,5 +1,5 @@
-import { S as StorageProvider } from '../StorageProvider-B5U72e5S.js';
-import '../portability-BrUmvSaH.js';
+import { S as StorageProvider } from '../StorageProvider-D_o2Hksf.js';
+import '../portability-P1hL-bOa.js';
 
 /**
  * Run the full StorageProvider conformance test suite.

package/dist/{traversal-BmCyenfC.d.ts → traversal-B_84kGaO.d.ts}

@@ -1,4 +1,4 @@
-import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-BrUmvSaH.js';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-P1hL-bOa.js';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus

package/dist/{traversal-qKh6sE-g.d.cts → traversal-CBE5h5ob.d.cts}

@@ -1,4 +1,4 @@
-import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-BrUmvSaH.cjs';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-P1hL-bOa.cjs';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus

package/dist/types/index.d.cts

@@ -1,6 +1,6 @@
-import { J as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, z as CreateRelationshipInput, Q as Relationship, V as VocabularyChangeRecord } from '../portability-BrUmvSaH.cjs';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, al as EnrichedRelationship, b as EntityBrief, am as EntityMap, a as EntitySummary, A as EntityTypeDefinition, an as EntityTypeInput, ao as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ap as ExportLegalMetadata, aq as ExportManifest, a9 as ExportOptions, ar as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, as as GetEntitiesOptions, at as GetEntityOptions, G as GovernanceConfig, au as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, av as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, az as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, aA as PropertySchema, aB as PropertyType, K as Provenance, aC as ProvenanceFilter, O as ReembedResult, aD as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aH as RepositoryMetadata, i as RepositoryStats, a8 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, a0 as ScoredEntity, ag as SearchHit, af as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighborhood, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aL as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aM as TimelineEntityRef, aN as TimelineEvent, a1 as TimelineOptions, aO as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aP as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-BrUmvSaH.cjs';
-export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, a as TraversalResult, f as TraversalReturnMode, T as TraversalSpec, g as TraversalStart, h as TraversalStep } from '../traversal-qKh6sE-g.cjs';
+import { J as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, z as CreateRelationshipInput, Q as Relationship, V as VocabularyChangeRecord } from '../portability-P1hL-bOa.cjs';
+export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, al as EnrichedRelationship, b as EntityBrief, am as EntityMap, a as EntitySummary, A as EntityTypeDefinition, an as EntityTypeInput, ao as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ap as ExportLegalMetadata, aq as ExportManifest, a9 as ExportOptions, ar as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, as as GetEntitiesOptions, at as GetEntityOptions, G as GovernanceConfig, au as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, av as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, az as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, aA as PropertySchema, aB as PropertyType, K as Provenance, aC as ProvenanceFilter, O as ReembedResult, aD as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aH as RepositoryMetadata, i as RepositoryStats, a8 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, a0 as ScoredEntity, ag as SearchHit, af as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighborhood, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aL as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aM as TimelineEntityRef, aN as TimelineEvent, a1 as TimelineOptions, aO as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aP as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-P1hL-bOa.cjs';
+export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, a as TraversalResult, f as TraversalReturnMode, T as TraversalSpec, g as TraversalStart, h as TraversalStep } from '../traversal-CBE5h5ob.cjs';
 
 /** All event types emitted by the Deep Memory engine */
 type DeepMemoryEventType = 'repository:created' | 'repository:opened' | 'repository:updated' | 'repository:deleted' | 'entity:creating' | 'entity:created' | 'entity:updating' | 'entity:updated' | 'entity:deleting' | 'entity:deleted' | 'relationship:creating' | 'relationship:created' | 'relationship:removing' | 'relationship:removed' | 'vocabulary:proposal' | 'vocabulary:approved' | 'vocabulary:rejected' | 'vocabulary:pending' | 'vocabulary:changed' | 'validation:failed' | 'search:executed' | 'reembed:started' | 'reembed:progress' | 'reembed:completed' | 'reembed:failed' | 'export:started' | 'export:progress' | 'export:completed' | 'import:started' | 'import:progress' | 'import:completed' | 'import:failed' | 'delete:started' | 'delete:progress' | 'delete:completed';

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
-import { J as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, z as CreateRelationshipInput, Q as Relationship, V as VocabularyChangeRecord } from '../portability-BrUmvSaH.js';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, al as EnrichedRelationship, b as EntityBrief, am as EntityMap, a as EntitySummary, A as EntityTypeDefinition, an as EntityTypeInput, ao as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ap as ExportLegalMetadata, aq as ExportManifest, a9 as ExportOptions, ar as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, as as GetEntitiesOptions, at as GetEntityOptions, G as GovernanceConfig, au as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, av as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, az as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, aA as PropertySchema, aB as PropertyType, K as Provenance, aC as ProvenanceFilter, O as ReembedResult, aD as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aH as RepositoryMetadata, i as RepositoryStats, a8 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, a0 as ScoredEntity, ag as SearchHit, af as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighborhood, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aL as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aM as TimelineEntityRef, aN as TimelineEvent, a1 as TimelineOptions, aO as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aP as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-BrUmvSaH.js';
-export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, a as TraversalResult, f as TraversalReturnMode, T as TraversalSpec, g as TraversalStart, h as TraversalStep } from '../traversal-BmCyenfC.js';
+import { J as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, z as CreateRelationshipInput, Q as Relationship, V as VocabularyChangeRecord } from '../portability-P1hL-bOa.js';
+export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyHandle, ak as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, al as EnrichedRelationship, b as EntityBrief, am as EntityMap, a as EntitySummary, A as EntityTypeDefinition, an as EntityTypeInput, ao as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ap as ExportLegalMetadata, aq as ExportManifest, a9 as ExportOptions, ar as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, as as GetEntitiesOptions, at as GetEntityOptions, G as GovernanceConfig, au as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, av as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, aw as NeighborhoodCenter, ax as NeighborhoodGroup, ay as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, az as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, aA as PropertySchema, aB as PropertyType, K as Provenance, aC as ProvenanceFilter, O as ReembedResult, aD as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aE as RelationshipTypeDefinition, aF as RelationshipTypeInput, aG as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aH as RepositoryMetadata, i as RepositoryStats, a8 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, a0 as ScoredEntity, ag as SearchHit, af as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighborhood, aI as StorageNeighborhoodGroup, aJ as StorageNeighborhoodLayer, aK as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aL as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aM as TimelineEntityRef, aN as TimelineEvent, a1 as TimelineOptions, aO as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aP as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-P1hL-bOa.js';
+export { Q as QueryMetadata, b as TraversalAggregation, c as TraversalPath, d as TraversalProjection, e as TraversalRelationship, a as TraversalResult, f as TraversalReturnMode, T as TraversalSpec, g as TraversalStart, h as TraversalStep } from '../traversal-B_84kGaO.js';
 
 /** All event types emitted by the Deep Memory engine */
 type DeepMemoryEventType = 'repository:created' | 'repository:opened' | 'repository:updated' | 'repository:deleted' | 'entity:creating' | 'entity:created' | 'entity:updating' | 'entity:updated' | 'entity:deleting' | 'entity:deleted' | 'relationship:creating' | 'relationship:created' | 'relationship:removing' | 'relationship:removed' | 'vocabulary:proposal' | 'vocabulary:approved' | 'vocabulary:rejected' | 'vocabulary:pending' | 'vocabulary:changed' | 'validation:failed' | 'search:executed' | 'reembed:started' | 'reembed:progress' | 'reembed:completed' | 'reembed:failed' | 'export:started' | 'export:progress' | 'export:completed' | 'import:started' | 'import:progress' | 'import:completed' | 'import:failed' | 'delete:started' | 'delete:progress' | 'delete:completed';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/deep-memory",
-  "version": "0.12.1",
+  "version": "0.15.0",
   "description": "Vocabulary-driven graph memory for AI agents",
   "type": "module",
   "main": "./dist/index.cjs",