@utaba/deep-memory 0.17.0 → 0.19.0

package/dist/{traversal-OkXViSTI.d.ts → traversal-BK_3Cqj3.d.cts}

@@ -1,4 +1,4 @@
-import { Y as PropertyFilter, h as DetailLevel, i as Entity, l as EntitySummary, j as EntityBrief, a6 as RelationshipSummary } from './portability-Dbm6vCdD.js';
+import { Y as PropertyFilter, h as DetailLevel, i as Entity, l as EntitySummary, j as EntityBrief, a6 as RelationshipSummary } from './portability-BHyXmv5-.cjs';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus
@@ -57,7 +57,7 @@ interface TraversalSpec {
     /** Whether to deduplicate entities in the result set. Default: true. */
     dedup?: boolean;
     /**
-     * Whether to include a relationship summary (outbound/inbound counts by type)
+     * Whether to include a relationship summary (out/in counts by type)
      * on each entity in the result. Default: false.
      *
      * Native GraphTraversalProviders (Gremlin, Cypher) can return this in a single
@@ -118,7 +118,12 @@ interface TraversalStart {
  * A single step in the traversal — one hop along a relationship edge.
  */
 interface TraversalStep {
-    /** Direction to traverse. */
+    /**
+     * Direction to traverse, relative to the entity at the start of the hop:
+     * - `'out'`  — follow edges where the current entity is the source
+     * - `'in'`   — follow edges where the current entity is the target
+     * - `'both'` — follow edges in either direction
+     */
     direction: 'out' | 'in' | 'both';
     /**
      * Relationship types to follow in this step.
@@ -221,18 +226,18 @@ interface TraversalRelationship {
     /**
      * Walk direction at the last hop, with mode-specific semantics:
      *
-     * - **`'path'` mode** — `'outbound'` when the walk crossed the edge from
-     *   `sourceEntityId` to `targetEntityId`, `'inbound'` when it crossed in
+     * - **`'path'` mode** — `'out'` when the walk crossed the edge from
+     *   `sourceEntityId` to `targetEntityId`, `'in'` when it crossed in
      *   the opposite direction. Computed relative to the entity at the
      *   start of the hop within each `TraversalPath`.
-     * - **`'all'` mode** — always `'outbound'`. Reflects the stored edge
+     * - **`'all'` mode** — always `'out'`. Reflects the stored edge
      *   topology (`sourceEntityId` → `targetEntityId`), not any particular
      *   walk; the deduped union has no walk context. Callers can derive
      *   walk-direction relative to any anchor using `sourceEntityId` /
      *   `targetEntityId`.
      * - **`'terminal'` mode** — relationships are not returned.
      */
-    direction: 'outbound' | 'inbound';
+    direction: 'out' | 'in';
     properties: Record<string, unknown>;
 }
 interface TraversalPath {

package/dist/{traversal-1f35drOx.d.cts → traversal-CIGJcdCb.d.ts}

@@ -1,4 +1,4 @@
-import { Y as PropertyFilter, h as DetailLevel, i as Entity, l as EntitySummary, j as EntityBrief, a6 as RelationshipSummary } from './portability-Dbm6vCdD.cjs';
+import { Y as PropertyFilter, h as DetailLevel, i as Entity, l as EntitySummary, j as EntityBrief, a6 as RelationshipSummary } from './portability-BHyXmv5-.js';
 
 /**
  * An entity as returned inside a TraversalResult — the projected entity plus
@@ -57,7 +57,7 @@ interface TraversalSpec {
     /** Whether to deduplicate entities in the result set. Default: true. */
     dedup?: boolean;
     /**
-     * Whether to include a relationship summary (outbound/inbound counts by type)
+     * Whether to include a relationship summary (out/in counts by type)
      * on each entity in the result. Default: false.
      *
      * Native GraphTraversalProviders (Gremlin, Cypher) can return this in a single
@@ -118,7 +118,12 @@ interface TraversalStart {
  * A single step in the traversal — one hop along a relationship edge.
  */
 interface TraversalStep {
-    /** Direction to traverse. */
+    /**
+     * Direction to traverse, relative to the entity at the start of the hop:
+     * - `'out'`  — follow edges where the current entity is the source
+     * - `'in'`   — follow edges where the current entity is the target
+     * - `'both'` — follow edges in either direction
+     */
     direction: 'out' | 'in' | 'both';
     /**
      * Relationship types to follow in this step.
@@ -221,18 +226,18 @@ interface TraversalRelationship {
     /**
      * Walk direction at the last hop, with mode-specific semantics:
      *
-     * - **`'path'` mode** — `'outbound'` when the walk crossed the edge from
-     *   `sourceEntityId` to `targetEntityId`, `'inbound'` when it crossed in
+     * - **`'path'` mode** — `'out'` when the walk crossed the edge from
+     *   `sourceEntityId` to `targetEntityId`, `'in'` when it crossed in
      *   the opposite direction. Computed relative to the entity at the
      *   start of the hop within each `TraversalPath`.
-     * - **`'all'` mode** — always `'outbound'`. Reflects the stored edge
+     * - **`'all'` mode** — always `'out'`. Reflects the stored edge
      *   topology (`sourceEntityId` → `targetEntityId`), not any particular
      *   walk; the deduped union has no walk context. Callers can derive
      *   walk-direction relative to any anchor using `sourceEntityId` /
      *   `targetEntityId`.
      * - **`'terminal'` mode** — relationships are not returned.
      */
-    direction: 'outbound' | 'inbound';
+    direction: 'out' | 'in';
     properties: Record<string, unknown>;
 }
 interface TraversalPath {

package/dist/types/index.d.cts

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

package/dist/types/index.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/deep-memory",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Vocabulary-driven graph memory for AI agents",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -79,7 +79,7 @@
     "vocabulary"
   ],
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^22.0.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"