@utaba/deep-memory 0.12.0 → 0.14.0

package/dist/{portability-Ceb9P_VW.d.cts → portability-DWpZbxNn.d.cts}

@@ -1052,12 +1052,33 @@ interface BulkImportOptions {
      * defaults.
      */
     adaptiveConcurrency?: AdaptiveConcurrencyOptions;
+    /**
+     * Opaque container for cross-call adaptive-concurrency state. When the same
+     * handle object is passed to multiple `importBulk` calls during a single
+     * import operation, providers that support adaptive concurrency reuse their
+     * controller across calls — preserving the learned concurrency level,
+     * success streak, cooldown, and throttle history — instead of resetting on
+     * every chunk. RepositoryImporter creates a fresh handle per import and
+     * threads it through automatically; direct callers of `importBulk` only
+     * need to set this when they invoke the method multiple times for one
+     * logical import. Providers that do not throttle ignore the field.
+     */
+    adaptiveConcurrencyHandle?: AdaptiveConcurrencyHandle;
+}
+/**
+ * Opaque marker for cross-call adaptive-concurrency state. Storage providers
+ * that support adaptive concurrency attach their own private fields (e.g. the
+ * controller instance) to this object. Callers should treat it as opaque —
+ * construct a fresh empty `{}` per import and pass the same reference to every
+ * `importBulk` call belonging to that import.
+ */
+interface AdaptiveConcurrencyHandle {
 }
 /** Reason the adaptive runner adjusted its concurrency level. */
 type AdaptiveConcurrencyAdjustReason = 'start' | 'throttle' | 'ramp-up';
 /** Configuration for the adaptive concurrency runner used by bulk imports. */
 interface AdaptiveConcurrencyOptions {
-    /** Floor concurrency. Default: 2. */
+    /** Floor concurrency. Default: 1. */
     min?: number;
     /** Initial concurrency at the start of the import. Default: 5. */
     start?: number;
@@ -1073,6 +1094,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
@@ -1085,6 +1114,22 @@ interface AdaptiveConcurrencyOptions {
      * loudly rather than letting the import grind on for hours.
      */
     maxConsecutiveThrottlesAtMin?: number;
+    /**
+     * Multiplier applied to {@link increaseAfter} when ramping back up to a
+     * level that has been throttled before (the "soft ceiling"). The controller
+     * remembers the highest concurrency at which a throttle was observed and
+     * requires `increaseAfter * throttleCeilingMultiplier` consecutive successes
+     * to re-attain (or exceed) that level. Once the level has been held without
+     * further throttling, the constraint is dropped — a future throttle will
+     * establish a new ceiling. Default: 3.
+     *
+     * Rationale: the previous behaviour ramped back up to the throttled level
+     * with the same number of successes every cycle, producing a
+     * ramp-throttle-ramp-throttle oscillation on RU-constrained tiers. Making
+     * the re-approach cost more breaks the cycle without permanently capping
+     * concurrency below the cluster's real capacity.
+     */
+    throttleCeilingMultiplier?: number;
     /**
      * Called whenever the runner changes its concurrency level. Use this for
      * operator-visible logging. The callback is fire-and-forget; throwing has no
@@ -1138,4 +1183,4 @@ interface ImportResult {
     warnings: ImportWarning[];
 }
 
-export type { ConceptSearchOptions as $, EntityTypeDefinition as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposal as F, GovernanceConfig as G, VocabularyProposalResult as H, ImportChunk as I, ProvenanceContext as J, Provenance as K, FindEntitiesQuery as L, MemoryVocabulary as M, DeleteEntitiesResult as N, ReembedResult as O, PropertyFilter as P, Relationship as Q, RelationshipSummary as R, StorageRepositoryConfig as S, RemoveRelationshipsResult as T, UpdateEntityInput as U, VocabularyChangeRecord as V, GraphResult as W, ExploreOptions as X, Neighborhood as Y, PathOptions as Z, PathResult as _, EntitySummary as a, ScoredEntity as a0, TimelineOptions as a1, TimelineResult as a2, ValidateEntitiesOptions as a3, EntityValidationPage as a4, ValidateRelationshipsOptions as a5, RelationshipValidationPage as a6, RepositoryConfig as a7, RepositorySummary as a8, ExportOptions as a9, PropertyType as aA, ProvenanceFilter as aB, RelationshipDirection as aC, RelationshipTypeDefinition as aD, RelationshipTypeInput as aE, RelationshipValidationIssue as aF, RepositoryMetadata as aG, StorageNeighborhoodGroup as aH, StorageNeighborhoodLayer as aI, StoragePath as aJ, StorageTimelineEvent as aK, TimelineEntityRef as aL, TimelineEvent as aM, TimelineRelationshipDetail as aN, VocabularyInput as aO, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, AdaptiveConcurrencyAdjustEvent as ah, AdaptiveConcurrencyAdjustReason as ai, AdaptiveConcurrencyOptions as aj, EnrichedRelationship as ak, EntityMap as al, EntityTypeInput as am, EntityValidationIssue as an, ExportLegalMetadata as ao, ExportManifest as ap, ExportPipelineMetadata as aq, GetEntitiesOptions as ar, GetEntityOptions as as, GovernanceMode as at, ImportWarning as au, NeighborhoodCenter as av, NeighborhoodGroup as aw, NeighborhoodLayer as ax, Path as ay, PropertySchema as az, EntityBrief as b, StoredRepository as c, RepositoryFilter as d, PaginatedResult as e, StoredRepositorySummary as f, RepositoryUpdate as g, DeleteProgressCallback as h, RepositoryStats as i, PaginationOptions as j, StoredEntity as k, StoredEntityUpdate as l, StorageFindQuery as m, StoredRelationship as n, RelationshipQueryOptions as o, StorageExploreOptions as p, StorageNeighborhood as q, StoragePathOptions as r, StoragePathResult as s, StorageTimelineOptions as t, StorageTimelineResult as u, ExportChunk as v, BulkImportResult as w, ResolvedVocabulary as x, ValidationResult as y, CreateRelationshipInput as z };
+export type { ConceptSearchOptions as $, EntityTypeDefinition as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposal as F, GovernanceConfig as G, VocabularyProposalResult as H, ImportChunk as I, ProvenanceContext as J, Provenance as K, FindEntitiesQuery as L, MemoryVocabulary as M, DeleteEntitiesResult as N, ReembedResult as O, PropertyFilter as P, Relationship as Q, RelationshipSummary as R, StorageRepositoryConfig as S, RemoveRelationshipsResult as T, UpdateEntityInput as U, VocabularyChangeRecord as V, GraphResult as W, ExploreOptions as X, Neighborhood as Y, PathOptions as Z, PathResult as _, EntitySummary as a, ScoredEntity as a0, TimelineOptions as a1, TimelineResult as a2, ValidateEntitiesOptions as a3, EntityValidationPage as a4, ValidateRelationshipsOptions as a5, RelationshipValidationPage as a6, RepositoryConfig as a7, RepositorySummary as a8, ExportOptions as a9, PropertySchema as aA, PropertyType as aB, ProvenanceFilter as aC, RelationshipDirection as aD, RelationshipTypeDefinition as aE, RelationshipTypeInput as aF, RelationshipValidationIssue as aG, RepositoryMetadata as aH, StorageNeighborhoodGroup as aI, StorageNeighborhoodLayer as aJ, StoragePath as aK, StorageTimelineEvent as aL, TimelineEntityRef as aM, TimelineEvent as aN, TimelineRelationshipDetail as aO, VocabularyInput as aP, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, AdaptiveConcurrencyAdjustEvent as ah, AdaptiveConcurrencyAdjustReason as ai, AdaptiveConcurrencyHandle as aj, AdaptiveConcurrencyOptions as ak, EnrichedRelationship as al, EntityMap as am, EntityTypeInput as an, EntityValidationIssue as ao, ExportLegalMetadata as ap, ExportManifest as aq, ExportPipelineMetadata as ar, GetEntitiesOptions as as, GetEntityOptions as at, GovernanceMode as au, ImportWarning as av, NeighborhoodCenter as aw, NeighborhoodGroup as ax, NeighborhoodLayer as ay, Path as az, EntityBrief as b, StoredRepository as c, RepositoryFilter as d, PaginatedResult as e, StoredRepositorySummary as f, RepositoryUpdate as g, DeleteProgressCallback as h, RepositoryStats as i, PaginationOptions as j, StoredEntity as k, StoredEntityUpdate as l, StorageFindQuery as m, StoredRelationship as n, RelationshipQueryOptions as o, StorageExploreOptions as p, StorageNeighborhood as q, StoragePathOptions as r, StoragePathResult as s, StorageTimelineOptions as t, StorageTimelineResult as u, ExportChunk as v, BulkImportResult as w, ResolvedVocabulary as x, ValidationResult as y, CreateRelationshipInput as z };

package/dist/{portability-Ceb9P_VW.d.ts → portability-DWpZbxNn.d.ts}

@@ -1052,12 +1052,33 @@ interface BulkImportOptions {
      * defaults.
      */
     adaptiveConcurrency?: AdaptiveConcurrencyOptions;
+    /**
+     * Opaque container for cross-call adaptive-concurrency state. When the same
+     * handle object is passed to multiple `importBulk` calls during a single
+     * import operation, providers that support adaptive concurrency reuse their
+     * controller across calls — preserving the learned concurrency level,
+     * success streak, cooldown, and throttle history — instead of resetting on
+     * every chunk. RepositoryImporter creates a fresh handle per import and
+     * threads it through automatically; direct callers of `importBulk` only
+     * need to set this when they invoke the method multiple times for one
+     * logical import. Providers that do not throttle ignore the field.
+     */
+    adaptiveConcurrencyHandle?: AdaptiveConcurrencyHandle;
+}
+/**
+ * Opaque marker for cross-call adaptive-concurrency state. Storage providers
+ * that support adaptive concurrency attach their own private fields (e.g. the
+ * controller instance) to this object. Callers should treat it as opaque —
+ * construct a fresh empty `{}` per import and pass the same reference to every
+ * `importBulk` call belonging to that import.
+ */
+interface AdaptiveConcurrencyHandle {
 }
 /** Reason the adaptive runner adjusted its concurrency level. */
 type AdaptiveConcurrencyAdjustReason = 'start' | 'throttle' | 'ramp-up';
 /** Configuration for the adaptive concurrency runner used by bulk imports. */
 interface AdaptiveConcurrencyOptions {
-    /** Floor concurrency. Default: 2. */
+    /** Floor concurrency. Default: 1. */
     min?: number;
     /** Initial concurrency at the start of the import. Default: 5. */
     start?: number;
@@ -1073,6 +1094,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
@@ -1085,6 +1114,22 @@ interface AdaptiveConcurrencyOptions {
      * loudly rather than letting the import grind on for hours.
      */
     maxConsecutiveThrottlesAtMin?: number;
+    /**
+     * Multiplier applied to {@link increaseAfter} when ramping back up to a
+     * level that has been throttled before (the "soft ceiling"). The controller
+     * remembers the highest concurrency at which a throttle was observed and
+     * requires `increaseAfter * throttleCeilingMultiplier` consecutive successes
+     * to re-attain (or exceed) that level. Once the level has been held without
+     * further throttling, the constraint is dropped — a future throttle will
+     * establish a new ceiling. Default: 3.
+     *
+     * Rationale: the previous behaviour ramped back up to the throttled level
+     * with the same number of successes every cycle, producing a
+     * ramp-throttle-ramp-throttle oscillation on RU-constrained tiers. Making
+     * the re-approach cost more breaks the cycle without permanently capping
+     * concurrency below the cluster's real capacity.
+     */
+    throttleCeilingMultiplier?: number;
     /**
      * Called whenever the runner changes its concurrency level. Use this for
      * operator-visible logging. The callback is fire-and-forget; throwing has no
@@ -1138,4 +1183,4 @@ interface ImportResult {
     warnings: ImportWarning[];
 }
 
-export type { ConceptSearchOptions as $, EntityTypeDefinition as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposal as F, GovernanceConfig as G, VocabularyProposalResult as H, ImportChunk as I, ProvenanceContext as J, Provenance as K, FindEntitiesQuery as L, MemoryVocabulary as M, DeleteEntitiesResult as N, ReembedResult as O, PropertyFilter as P, Relationship as Q, RelationshipSummary as R, StorageRepositoryConfig as S, RemoveRelationshipsResult as T, UpdateEntityInput as U, VocabularyChangeRecord as V, GraphResult as W, ExploreOptions as X, Neighborhood as Y, PathOptions as Z, PathResult as _, EntitySummary as a, ScoredEntity as a0, TimelineOptions as a1, TimelineResult as a2, ValidateEntitiesOptions as a3, EntityValidationPage as a4, ValidateRelationshipsOptions as a5, RelationshipValidationPage as a6, RepositoryConfig as a7, RepositorySummary as a8, ExportOptions as a9, PropertyType as aA, ProvenanceFilter as aB, RelationshipDirection as aC, RelationshipTypeDefinition as aD, RelationshipTypeInput as aE, RelationshipValidationIssue as aF, RepositoryMetadata as aG, StorageNeighborhoodGroup as aH, StorageNeighborhoodLayer as aI, StoragePath as aJ, StorageTimelineEvent as aK, TimelineEntityRef as aL, TimelineEvent as aM, TimelineRelationshipDetail as aN, VocabularyInput as aO, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, AdaptiveConcurrencyAdjustEvent as ah, AdaptiveConcurrencyAdjustReason as ai, AdaptiveConcurrencyOptions as aj, EnrichedRelationship as ak, EntityMap as al, EntityTypeInput as am, EntityValidationIssue as an, ExportLegalMetadata as ao, ExportManifest as ap, ExportPipelineMetadata as aq, GetEntitiesOptions as ar, GetEntityOptions as as, GovernanceMode as at, ImportWarning as au, NeighborhoodCenter as av, NeighborhoodGroup as aw, NeighborhoodLayer as ax, Path as ay, PropertySchema as az, EntityBrief as b, StoredRepository as c, RepositoryFilter as d, PaginatedResult as e, StoredRepositorySummary as f, RepositoryUpdate as g, DeleteProgressCallback as h, RepositoryStats as i, PaginationOptions as j, StoredEntity as k, StoredEntityUpdate as l, StorageFindQuery as m, StoredRelationship as n, RelationshipQueryOptions as o, StorageExploreOptions as p, StorageNeighborhood as q, StoragePathOptions as r, StoragePathResult as s, StorageTimelineOptions as t, StorageTimelineResult as u, ExportChunk as v, BulkImportResult as w, ResolvedVocabulary as x, ValidationResult as y, CreateRelationshipInput as z };
+export type { ConceptSearchOptions as $, EntityTypeDefinition as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposal as F, GovernanceConfig as G, VocabularyProposalResult as H, ImportChunk as I, ProvenanceContext as J, Provenance as K, FindEntitiesQuery as L, MemoryVocabulary as M, DeleteEntitiesResult as N, ReembedResult as O, PropertyFilter as P, Relationship as Q, RelationshipSummary as R, StorageRepositoryConfig as S, RemoveRelationshipsResult as T, UpdateEntityInput as U, VocabularyChangeRecord as V, GraphResult as W, ExploreOptions as X, Neighborhood as Y, PathOptions as Z, PathResult as _, EntitySummary as a, ScoredEntity as a0, TimelineOptions as a1, TimelineResult as a2, ValidateEntitiesOptions as a3, EntityValidationPage as a4, ValidateRelationshipsOptions as a5, RelationshipValidationPage as a6, RepositoryConfig as a7, RepositorySummary as a8, ExportOptions as a9, PropertySchema as aA, PropertyType as aB, ProvenanceFilter as aC, RelationshipDirection as aD, RelationshipTypeDefinition as aE, RelationshipTypeInput as aF, RelationshipValidationIssue as aG, RepositoryMetadata as aH, StorageNeighborhoodGroup as aI, StorageNeighborhoodLayer as aJ, StoragePath as aK, StorageTimelineEvent as aL, TimelineEntityRef as aM, TimelineEvent as aN, TimelineRelationshipDetail as aO, VocabularyInput as aP, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, AdaptiveConcurrencyAdjustEvent as ah, AdaptiveConcurrencyAdjustReason as ai, AdaptiveConcurrencyHandle as aj, AdaptiveConcurrencyOptions as ak, EnrichedRelationship as al, EntityMap as am, EntityTypeInput as an, EntityValidationIssue as ao, ExportLegalMetadata as ap, ExportManifest as aq, ExportPipelineMetadata as ar, GetEntitiesOptions as as, GetEntityOptions as at, GovernanceMode as au, ImportWarning as av, NeighborhoodCenter as aw, NeighborhoodGroup as ax, NeighborhoodLayer as ay, Path as az, EntityBrief as b, StoredRepository as c, RepositoryFilter as d, PaginatedResult as e, StoredRepositorySummary as f, RepositoryUpdate as g, DeleteProgressCallback as h, RepositoryStats as i, PaginationOptions as j, StoredEntity as k, StoredEntityUpdate as l, StorageFindQuery as m, StoredRelationship as n, RelationshipQueryOptions as o, StorageExploreOptions as p, StorageNeighborhood as q, StoragePathOptions as r, StoragePathResult as s, StorageTimelineOptions as t, StorageTimelineResult as u, ExportChunk as v, BulkImportResult as w, ResolvedVocabulary as x, ValidationResult as y, CreateRelationshipInput as z };

package/dist/providers/index.d.cts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-Cn2YxHc3.cjs';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-Ceb9P_VW.cjs';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-DAccezmK.cjs';
+export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-BfdyQgiI.cjs';
+import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-DWpZbxNn.cjs';
+import { T as TraversalSpec, a as TraversalResult } from '../traversal-37JAiha-.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-BuhXaqFP.js';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-Ceb9P_VW.js';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-lpUylwSS.js';
+export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-jpzVIKXs.js';
+import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-DWpZbxNn.js';
+import { T as TraversalSpec, a as TraversalResult } from '../traversal-COr0AJBc.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-Cn2YxHc3.cjs';
-import '../portability-Ceb9P_VW.cjs';
+import { S as StorageProvider } from '../StorageProvider-BfdyQgiI.cjs';
+import '../portability-DWpZbxNn.cjs';
 
 /**
  * Run the full StorageProvider conformance test suite.

package/dist/testing/conformance.d.ts

@@ -1,5 +1,5 @@
-import { S as StorageProvider } from '../StorageProvider-BuhXaqFP.js';
-import '../portability-Ceb9P_VW.js';
+import { S as StorageProvider } from '../StorageProvider-jpzVIKXs.js';
+import '../portability-DWpZbxNn.js';
 
 /**
  * Run the full StorageProvider conformance test suite.

package/dist/{traversal-DAccezmK.d.cts → traversal-37JAiha-.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-Ceb9P_VW.cjs';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-DWpZbxNn.cjs';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus

package/dist/{traversal-lpUylwSS.d.ts → traversal-COr0AJBc.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-Ceb9P_VW.js';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-DWpZbxNn.js';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus

package/dist/types/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Type re-exports — @utaba/deep-memory/types\n\nexport type {\n  ProvenanceContext,\n  Provenance,\n} from './provenance.js';\n\nexport type {\n  PropertyType,\n  PropertySchema,\n  EntityTypeDefinition,\n  RelationshipTypeDefinition,\n  MemoryVocabulary,\n  GovernanceMode,\n  GovernanceConfig,\n  VocabularyProposal,\n  VocabularyProposalResult,\n  VocabularyChangeRecord,\n  ResolvedVocabulary,\n  EntityTypeInput,\n  RelationshipTypeInput,\n  VocabularyInput,\n} from './vocabulary.js';\n\nexport type {\n  DetailLevel,\n  Entity,\n  EntitySummary,\n  EntityBrief,\n  CreateEntityInput,\n  UpdateEntityInput,\n  StoredEntity,\n  StoredEntityUpdate,\n  GetEntityOptions,\n  GetEntitiesOptions,\n  DeleteEntitiesResult,\n} from './entities.js';\n\nexport type {\n  RelationshipDirection,\n  Relationship,\n  EnrichedRelationship,\n  CreateRelationshipInput,\n  StoredRelationship,\n  RelationshipQueryOptions,\n  RelationshipSummary,\n  RemoveRelationshipsResult,\n} from './relationships.js';\n\nexport type {\n  RepositoryConfig,\n  RepositoryMetadata,\n  RepositoryUpdate,\n  RepositorySummary,\n  RepositoryStats,\n  StoredRepository,\n  StoredRepositorySummary,\n  RepositoryFilter,\n  StorageRepositoryConfig,\n} from './repositories.js';\n\nexport type {\n  PaginationOptions,\n  FindEntitiesQuery,\n  ExploreOptions,\n  PathOptions,\n  ConceptSearchOptions,\n  TimelineOptions,\n  StorageFindQuery,\n  StorageExploreOptions,\n  StoragePathOptions,\n  StorageTimelineOptions,\n  SearchOptions,\n  PropertyFilter,\n  ProvenanceFilter,\n} from './queries.js';\n\nexport type {\n  PaginatedResult,\n  NeighborhoodCenter,\n  NeighborhoodGroup,\n  NeighborhoodLayer,\n  Neighborhood,\n  Path,\n  PathResult,\n  ScoredEntity,\n  TimelineEntityRef,\n  TimelineRelationshipDetail,\n  TimelineEvent,\n  TimelineResult,\n  GraphResult,\n  EntityMap,\n  StorageNeighborhoodGroup,\n  StorageNeighborhoodLayer,\n  StorageNeighborhood,\n  StoragePath,\n  StoragePathResult,\n  StorageTimelineEvent,\n  StorageTimelineResult,\n  SearchHit,\n  BulkImportResult,\n  ReembedResult,\n  EntityValidationIssue,\n  RelationshipValidationIssue,\n  EntityValidationPage,\n  RelationshipValidationPage,\n  ValidateEntitiesOptions,\n  ValidateRelationshipsOptions,\n} from './results.js';\n\nexport type {\n  DeepMemoryEventType,\n  EventPayload,\n  DeepMemoryEvent,\n  EventHandler,\n  Unsubscribe,\n  HookResult,\n} from './events.js';\n\nexport type {\n  TraversalSpec,\n  TraversalStart,\n  TraversalStep,\n  TraversalProjection,\n  TraversalReturnMode,\n  TraversalResult,\n  TraversalAggregation,\n  TraversalRelationship,\n  TraversalPath,\n  QueryMetadata,\n} from './traversal.js';\n\nexport type {\n  OperationUsage,\n  UsageSink,\n} from './usage.js';\n\nexport type {\n  ExportManifest,\n  ExportLegalMetadata,\n  ExportPipelineMetadata,\n  ExportOptions,\n  ExportArchive,\n  ExportChunk,\n  ExportStreamItem,\n  ImportOptions,\n  ImportChunk,\n  BulkImportOptions,\n  AdaptiveConcurrencyOptions,\n  AdaptiveConcurrencyAdjustEvent,\n  AdaptiveConcurrencyAdjustReason,\n  DeleteProgressCallback,\n  ImportStreamHeader,\n  ImportWarning,\n  ImportResult,\n} from './portability.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Type re-exports — @utaba/deep-memory/types\n\nexport type {\n  ProvenanceContext,\n  Provenance,\n} from './provenance.js';\n\nexport type {\n  PropertyType,\n  PropertySchema,\n  EntityTypeDefinition,\n  RelationshipTypeDefinition,\n  MemoryVocabulary,\n  GovernanceMode,\n  GovernanceConfig,\n  VocabularyProposal,\n  VocabularyProposalResult,\n  VocabularyChangeRecord,\n  ResolvedVocabulary,\n  EntityTypeInput,\n  RelationshipTypeInput,\n  VocabularyInput,\n} from './vocabulary.js';\n\nexport type {\n  DetailLevel,\n  Entity,\n  EntitySummary,\n  EntityBrief,\n  CreateEntityInput,\n  UpdateEntityInput,\n  StoredEntity,\n  StoredEntityUpdate,\n  GetEntityOptions,\n  GetEntitiesOptions,\n  DeleteEntitiesResult,\n} from './entities.js';\n\nexport type {\n  RelationshipDirection,\n  Relationship,\n  EnrichedRelationship,\n  CreateRelationshipInput,\n  StoredRelationship,\n  RelationshipQueryOptions,\n  RelationshipSummary,\n  RemoveRelationshipsResult,\n} from './relationships.js';\n\nexport type {\n  RepositoryConfig,\n  RepositoryMetadata,\n  RepositoryUpdate,\n  RepositorySummary,\n  RepositoryStats,\n  StoredRepository,\n  StoredRepositorySummary,\n  RepositoryFilter,\n  StorageRepositoryConfig,\n} from './repositories.js';\n\nexport type {\n  PaginationOptions,\n  FindEntitiesQuery,\n  ExploreOptions,\n  PathOptions,\n  ConceptSearchOptions,\n  TimelineOptions,\n  StorageFindQuery,\n  StorageExploreOptions,\n  StoragePathOptions,\n  StorageTimelineOptions,\n  SearchOptions,\n  PropertyFilter,\n  ProvenanceFilter,\n} from './queries.js';\n\nexport type {\n  PaginatedResult,\n  NeighborhoodCenter,\n  NeighborhoodGroup,\n  NeighborhoodLayer,\n  Neighborhood,\n  Path,\n  PathResult,\n  ScoredEntity,\n  TimelineEntityRef,\n  TimelineRelationshipDetail,\n  TimelineEvent,\n  TimelineResult,\n  GraphResult,\n  EntityMap,\n  StorageNeighborhoodGroup,\n  StorageNeighborhoodLayer,\n  StorageNeighborhood,\n  StoragePath,\n  StoragePathResult,\n  StorageTimelineEvent,\n  StorageTimelineResult,\n  SearchHit,\n  BulkImportResult,\n  ReembedResult,\n  EntityValidationIssue,\n  RelationshipValidationIssue,\n  EntityValidationPage,\n  RelationshipValidationPage,\n  ValidateEntitiesOptions,\n  ValidateRelationshipsOptions,\n} from './results.js';\n\nexport type {\n  DeepMemoryEventType,\n  EventPayload,\n  DeepMemoryEvent,\n  EventHandler,\n  Unsubscribe,\n  HookResult,\n} from './events.js';\n\nexport type {\n  TraversalSpec,\n  TraversalStart,\n  TraversalStep,\n  TraversalProjection,\n  TraversalReturnMode,\n  TraversalResult,\n  TraversalAggregation,\n  TraversalRelationship,\n  TraversalPath,\n  QueryMetadata,\n} from './traversal.js';\n\nexport type {\n  OperationUsage,\n  UsageSink,\n} from './usage.js';\n\nexport type {\n  ExportManifest,\n  ExportLegalMetadata,\n  ExportPipelineMetadata,\n  ExportOptions,\n  ExportArchive,\n  ExportChunk,\n  ExportStreamItem,\n  ImportOptions,\n  ImportChunk,\n  BulkImportOptions,\n  AdaptiveConcurrencyOptions,\n  AdaptiveConcurrencyAdjustEvent,\n  AdaptiveConcurrencyAdjustReason,\n  AdaptiveConcurrencyHandle,\n  DeleteProgressCallback,\n  ImportStreamHeader,\n  ImportWarning,\n  ImportResult,\n} from './portability.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

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-Ceb9P_VW.cjs';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, ak as EnrichedRelationship, b as EntityBrief, al as EntityMap, a as EntitySummary, A as EntityTypeDefinition, am as EntityTypeInput, an as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ao as ExportLegalMetadata, ap as ExportManifest, a9 as ExportOptions, aq as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, ar as GetEntitiesOptions, as as GetEntityOptions, G as GovernanceConfig, at as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, au as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, av as NeighborhoodCenter, aw as NeighborhoodGroup, ax as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, ay as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, az as PropertySchema, aA as PropertyType, K as Provenance, aB as ProvenanceFilter, O as ReembedResult, aC as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aD as RelationshipTypeDefinition, aE as RelationshipTypeInput, aF as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aG 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, aH as StorageNeighborhoodGroup, aI as StorageNeighborhoodLayer, aJ as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aK as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aL as TimelineEntityRef, aM as TimelineEvent, a1 as TimelineOptions, aN as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aO as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-Ceb9P_VW.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-DAccezmK.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-DWpZbxNn.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-DWpZbxNn.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-37JAiha-.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-Ceb9P_VW.js';
-export { ah as AdaptiveConcurrencyAdjustEvent, ai as AdaptiveConcurrencyAdjustReason, aj as AdaptiveConcurrencyOptions, B as BulkImportOptions, w as BulkImportResult, $ as ConceptSearchOptions, N as DeleteEntitiesResult, h as DeleteProgressCallback, D as DetailLevel, ak as EnrichedRelationship, b as EntityBrief, al as EntityMap, a as EntitySummary, A as EntityTypeDefinition, am as EntityTypeInput, an as EntityValidationIssue, a4 as EntityValidationPage, X as ExploreOptions, aa as ExportArchive, v as ExportChunk, ao as ExportLegalMetadata, ap as ExportManifest, a9 as ExportOptions, aq as ExportPipelineMetadata, ad as ExportStreamItem, L as FindEntitiesQuery, ar as GetEntitiesOptions, as as GetEntityOptions, G as GovernanceConfig, at as GovernanceMode, W as GraphResult, I as ImportChunk, ab as ImportOptions, ac as ImportResult, ae as ImportStreamHeader, au as ImportWarning, M as MemoryVocabulary, Y as Neighborhood, av as NeighborhoodCenter, aw as NeighborhoodGroup, ax as NeighborhoodLayer, e as PaginatedResult, j as PaginationOptions, ay as Path, Z as PathOptions, _ as PathResult, P as PropertyFilter, az as PropertySchema, aA as PropertyType, K as Provenance, aB as ProvenanceFilter, O as ReembedResult, aC as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, aD as RelationshipTypeDefinition, aE as RelationshipTypeInput, aF as RelationshipValidationIssue, a6 as RelationshipValidationPage, T as RemoveRelationshipsResult, a7 as RepositoryConfig, d as RepositoryFilter, aG 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, aH as StorageNeighborhoodGroup, aI as StorageNeighborhoodLayer, aJ as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, aK as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, aL as TimelineEntityRef, aM as TimelineEvent, a1 as TimelineOptions, aN as TimelineRelationshipDetail, a2 as TimelineResult, a3 as ValidateEntitiesOptions, a5 as ValidateRelationshipsOptions, aO as VocabularyInput, F as VocabularyProposal, H as VocabularyProposalResult } from '../portability-Ceb9P_VW.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-lpUylwSS.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-DWpZbxNn.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-DWpZbxNn.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-COr0AJBc.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.0",
+  "version": "0.14.0",
   "description": "Vocabulary-driven graph memory for AI agents",
   "type": "module",
   "main": "./dist/index.cjs",