@utaba/deep-memory 0.10.0 → 0.11.0

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

@@ -1018,6 +1018,15 @@ interface ImportOptions {
     entityConflict?: 'skip' | 'overwrite' | 'rename';
     /** Whether to re-generate embeddings using the current EmbeddingProvider */
     reEmbed?: boolean;
+    /**
+     * Storage-provider bulk options forwarded to `StorageProvider.importBulk()`
+     * for every chunk. Use this to tune adaptive concurrency or wire an
+     * `onAdjust` callback for operator-visible logging.
+     *
+     * Note: `skipExistenceCheck` is set automatically based on import mode and
+     * cannot be overridden here.
+     */
+    bulk?: Omit<BulkImportOptions, 'skipExistenceCheck'>;
 }
 /** A chunk of data for bulk import */
 interface ImportChunk {
@@ -1034,6 +1043,67 @@ interface BulkImportOptions {
      * Default: false (upsert behavior — check existence, then create or update).
      */
     skipExistenceCheck?: boolean;
+    /**
+     * Adaptive concurrency configuration for providers that throttle under load
+     * (e.g. CosmosDB on autoscale tiers). Providers that do not throttle may
+     * ignore this. The runner starts at `start` parallel writes, halves on any
+     * observed throttle, and ramps back up after `increaseAfter` consecutive
+     * throttle-free completions. All fields are optional with provider-specific
+     * defaults.
+     */
+    adaptiveConcurrency?: AdaptiveConcurrencyOptions;
+}
+/** 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. */
+    min?: number;
+    /** Initial concurrency at the start of the import. Default: 5. */
+    start?: number;
+    /** Ceiling concurrency. Default: 32. */
+    max?: number;
+    /**
+     * Number of consecutive throttle-free task completions required before
+     * concurrency is incremented by 1. Default: 50.
+     */
+    increaseAfter?: number;
+    /**
+     * Cooldown delay (ms) before any further task is dispatched after a throttle
+     * is observed. Default: 1000.
+     */
+    cooldownMs?: number;
+    /**
+     * Circuit breaker — abort the import after this many consecutive throttled
+     * tasks while the controller is already at `min` concurrency. The streak is
+     * reset by any throttle-free task completion. Set to a very large number to
+     * disable. Default: 10.
+     *
+     * Rationale: at min concurrency the runner has already done everything it
+     * can to relieve pressure. If the cluster is still throttling every task at
+     * that level, more attempts will not help and the operator should be told
+     * loudly rather than letting the import grind on for hours.
+     */
+    maxConsecutiveThrottlesAtMin?: number;
+    /**
+     * Called whenever the runner changes its concurrency level. Use this for
+     * operator-visible logging. The callback is fire-and-forget; throwing has no
+     * effect on the import.
+     */
+    onAdjust?: (event: AdaptiveConcurrencyAdjustEvent) => void;
+}
+/** Event payload for {@link AdaptiveConcurrencyOptions.onAdjust}. */
+interface AdaptiveConcurrencyAdjustEvent {
+    /** New concurrency level in effect after this adjustment. */
+    concurrency: number;
+    /** Concurrency level immediately before this adjustment. */
+    previousConcurrency: number;
+    /** Why the change was made. */
+    reason: AdaptiveConcurrencyAdjustReason;
+    /** Total tasks completed (success or throttle) at the time of adjustment. */
+    tasksCompleted: number;
+    /** Total tasks observed to have been throttled at least once. */
+    throttledCount: number;
 }
 /** Progress callback for delete operations */
 type DeleteProgressCallback = (progress: {
@@ -1068,4 +1138,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, RelationshipTypeDefinition as aA, RelationshipTypeInput as aB, RelationshipValidationIssue as aC, RepositoryMetadata as aD, StorageNeighborhoodGroup as aE, StorageNeighborhoodLayer as aF, StoragePath as aG, StorageTimelineEvent as aH, TimelineEntityRef as aI, TimelineEvent as aJ, TimelineRelationshipDetail as aK, VocabularyInput as aL, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, EnrichedRelationship as ah, EntityMap as ai, EntityTypeInput as aj, EntityValidationIssue as ak, ExportLegalMetadata as al, ExportManifest as am, ExportPipelineMetadata as an, GetEntitiesOptions as ao, GetEntityOptions as ap, GovernanceMode as aq, ImportWarning as ar, NeighborhoodCenter as as, NeighborhoodGroup as at, NeighborhoodLayer as au, Path as av, PropertySchema as aw, PropertyType as ax, ProvenanceFilter as ay, RelationshipDirection 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, 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 };

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

@@ -1018,6 +1018,15 @@ interface ImportOptions {
     entityConflict?: 'skip' | 'overwrite' | 'rename';
     /** Whether to re-generate embeddings using the current EmbeddingProvider */
     reEmbed?: boolean;
+    /**
+     * Storage-provider bulk options forwarded to `StorageProvider.importBulk()`
+     * for every chunk. Use this to tune adaptive concurrency or wire an
+     * `onAdjust` callback for operator-visible logging.
+     *
+     * Note: `skipExistenceCheck` is set automatically based on import mode and
+     * cannot be overridden here.
+     */
+    bulk?: Omit<BulkImportOptions, 'skipExistenceCheck'>;
 }
 /** A chunk of data for bulk import */
 interface ImportChunk {
@@ -1034,6 +1043,67 @@ interface BulkImportOptions {
      * Default: false (upsert behavior — check existence, then create or update).
      */
     skipExistenceCheck?: boolean;
+    /**
+     * Adaptive concurrency configuration for providers that throttle under load
+     * (e.g. CosmosDB on autoscale tiers). Providers that do not throttle may
+     * ignore this. The runner starts at `start` parallel writes, halves on any
+     * observed throttle, and ramps back up after `increaseAfter` consecutive
+     * throttle-free completions. All fields are optional with provider-specific
+     * defaults.
+     */
+    adaptiveConcurrency?: AdaptiveConcurrencyOptions;
+}
+/** 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. */
+    min?: number;
+    /** Initial concurrency at the start of the import. Default: 5. */
+    start?: number;
+    /** Ceiling concurrency. Default: 32. */
+    max?: number;
+    /**
+     * Number of consecutive throttle-free task completions required before
+     * concurrency is incremented by 1. Default: 50.
+     */
+    increaseAfter?: number;
+    /**
+     * Cooldown delay (ms) before any further task is dispatched after a throttle
+     * is observed. Default: 1000.
+     */
+    cooldownMs?: number;
+    /**
+     * Circuit breaker — abort the import after this many consecutive throttled
+     * tasks while the controller is already at `min` concurrency. The streak is
+     * reset by any throttle-free task completion. Set to a very large number to
+     * disable. Default: 10.
+     *
+     * Rationale: at min concurrency the runner has already done everything it
+     * can to relieve pressure. If the cluster is still throttling every task at
+     * that level, more attempts will not help and the operator should be told
+     * loudly rather than letting the import grind on for hours.
+     */
+    maxConsecutiveThrottlesAtMin?: number;
+    /**
+     * Called whenever the runner changes its concurrency level. Use this for
+     * operator-visible logging. The callback is fire-and-forget; throwing has no
+     * effect on the import.
+     */
+    onAdjust?: (event: AdaptiveConcurrencyAdjustEvent) => void;
+}
+/** Event payload for {@link AdaptiveConcurrencyOptions.onAdjust}. */
+interface AdaptiveConcurrencyAdjustEvent {
+    /** New concurrency level in effect after this adjustment. */
+    concurrency: number;
+    /** Concurrency level immediately before this adjustment. */
+    previousConcurrency: number;
+    /** Why the change was made. */
+    reason: AdaptiveConcurrencyAdjustReason;
+    /** Total tasks completed (success or throttle) at the time of adjustment. */
+    tasksCompleted: number;
+    /** Total tasks observed to have been throttled at least once. */
+    throttledCount: number;
 }
 /** Progress callback for delete operations */
 type DeleteProgressCallback = (progress: {
@@ -1068,4 +1138,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, RelationshipTypeDefinition as aA, RelationshipTypeInput as aB, RelationshipValidationIssue as aC, RepositoryMetadata as aD, StorageNeighborhoodGroup as aE, StorageNeighborhoodLayer as aF, StoragePath as aG, StorageTimelineEvent as aH, TimelineEntityRef as aI, TimelineEvent as aJ, TimelineRelationshipDetail as aK, VocabularyInput as aL, ExportArchive as aa, ImportOptions as ab, ImportResult as ac, ExportStreamItem as ad, ImportStreamHeader as ae, SearchOptions as af, SearchHit as ag, EnrichedRelationship as ah, EntityMap as ai, EntityTypeInput as aj, EntityValidationIssue as ak, ExportLegalMetadata as al, ExportManifest as am, ExportPipelineMetadata as an, GetEntitiesOptions as ao, GetEntityOptions as ap, GovernanceMode as aq, ImportWarning as ar, NeighborhoodCenter as as, NeighborhoodGroup as at, NeighborhoodLayer as au, Path as av, PropertySchema as aw, PropertyType as ax, ProvenanceFilter as ay, RelationshipDirection 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, 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 };

package/dist/providers/index.d.cts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-DmKddrEg.cjs';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-dhIuWJbJ.cjs';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-Bmv4we_g.cjs';
+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';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.

package/dist/providers/index.d.ts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-CRenWERy.js';
-import { af as SearchOptions, e as PaginatedResult, ag as SearchHit } from '../portability-dhIuWJbJ.js';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-D8SGKq0z.js';
+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';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.

package/dist/testing/conformance.d.cts

@@ -1,5 +1,5 @@
-import { S as StorageProvider } from '../StorageProvider-DmKddrEg.cjs';
-import '../portability-dhIuWJbJ.cjs';
+import { S as StorageProvider } from '../StorageProvider-Cn2YxHc3.cjs';
+import '../portability-Ceb9P_VW.cjs';
 
 /**
  * Run the full StorageProvider conformance test suite.

package/dist/testing/conformance.d.ts

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

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

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