@utaba/deep-memory 0.2.0 → 0.3.0

package/dist/{traversal-9JdiqjZ9.d.ts → traversal-B4SUysM-.d.ts}

@@ -1,20 +1,46 @@
-import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief } from './portability-DdjsCB07.js';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-1KBMVBGJ.js';
 
 /**
- * A structured traversal specification that can be compiled to
+ * An entity as returned inside a TraversalResult — the projected entity plus
+ * an optional relationship summary when includeRelationshipSummary is set.
+ */
+type TraversalEntity = (Entity | EntitySummary | EntityBrief) & {
+    relationshipSummary?: RelationshipSummary;
+};
+/**
+ * A structured graph query specification that can be compiled to
  * Gremlin, Cypher, or executed via application-level BFS.
  *
  * Designed to be expressible by AI agents without raw query
- * language knowledge, while covering the common multi-hop
- * traversal patterns needed for knowledge graph exploration.
+ * language knowledge. Covers both vertex-only queries (property
+ * aggregation, distinct values, filtered lookups) and multi-hop
+ * relationship traversals.
+ *
+ * When steps is empty or omitted, the query operates on the
+ * starting entities directly — no relationship hops needed.
  */
 interface TraversalSpec {
-    /** Starting point for the traversal. */
+    /** Starting point — which entities to query or start traversing from. */
     start: TraversalStart;
-    /** Ordered sequence of traversal steps. */
-    steps: TraversalStep[];
-    /** What to return from the traversal. */
+    /**
+     * Ordered sequence of traversal steps (relationship hops).
+     * When empty or omitted, the query operates on the starting entities
+     * directly — useful for property aggregation, distinct value queries,
+     * and filtered entity lookups without relationship hops.
+     */
+    steps?: TraversalStep[];
+    /** What to return from the query. */
     returnMode: TraversalReturnMode;
+    /**
+     * Property projection — extract and aggregate property values from
+     * result entities. When present, returns projected values in the
+     * `aggregations` array. By default, the `entities` array is suppressed
+     * (projection replaces full entity output). Set `includeEntities: true`
+     * to return both.
+     *
+     * Works with both vertex-only queries and traversals.
+     */
+    projection?: TraversalProjection;
     /**
      * Maximum number of results to return.
      * Default: 50. Max: 200.
@@ -30,6 +56,54 @@ interface TraversalSpec {
     detailLevel?: DetailLevel;
     /** Whether to deduplicate entities in the result set. Default: true. */
     dedup?: boolean;
+    /**
+     * Whether to include a relationship summary (outbound/inbound counts by type)
+     * on each entity in the result. Default: false.
+     *
+     * Native GraphTraversalProviders (Gremlin, Cypher) can return this in a single
+     * query. The fallback executor fetches all relationship data in one batch call
+     * and computes summaries locally. Check GraphTraversalCapabilities.supportsRelationshipSummary
+     * to know whether the active provider handles this natively.
+     */
+    includeRelationshipSummary?: boolean;
+    /**
+     * Whether to include provenance data on entities. Default: false.
+     * Only has effect when detailLevel is 'full'.
+     */
+    includeProvenance?: boolean;
+}
+/**
+ * Property projection — extract and optionally aggregate property values
+ * from result entities. Like SQL SELECT or Gremlin valueMap(), projection
+ * returns the projected values, not the full objects.
+ *
+ * By default, when projection is present the entities array is suppressed
+ * (only aggregations are returned). Set includeEntities to also get the
+ * full entity objects back.
+ */
+interface TraversalProjection {
+    /**
+     * Property names to extract from result entities.
+     */
+    properties: string[];
+    /**
+     * Return only distinct combinations of the projected properties.
+     * Default: false.
+     */
+    distinct?: boolean;
+    /**
+     * Aggregation mode for the projected properties.
+     * - 'values': return the raw property values (default)
+     * - 'count': count entities per distinct value combination
+     */
+    mode?: 'count' | 'values';
+    /**
+     * When true, also return the full entities array alongside the
+     * projected aggregations. By default, projection suppresses entities
+     * to keep responses lightweight.
+     * Default: false.
+     */
+    includeEntities?: boolean;
 }
 /** Where the traversal begins. */
 interface TraversalStart {
@@ -99,7 +173,7 @@ type TraversalReturnMode =
  */
 interface TraversalResult {
     /** Entities in the result set, projected to the requested detail level. */
-    entities: Array<Entity | EntitySummary | EntityBrief>;
+    entities: TraversalEntity[];
     /**
      * Relationships in the result set.
      * Present when returnMode is 'path' or 'all'.
@@ -110,6 +184,12 @@ interface TraversalResult {
      * Present only when returnMode is 'path'.
      */
     paths?: TraversalPath[];
+    /**
+     * Aggregated property values.
+     * Present when select is specified in the query.
+     * Each entry is a distinct value combination with an optional count.
+     */
+    aggregations?: TraversalAggregation[];
     /** Total number of results matching the traversal (before limit/offset). */
     total: number;
     /** Number of results returned in this response. */
@@ -119,6 +199,13 @@ interface TraversalResult {
     /** Query execution metadata. */
     queryMetadata: QueryMetadata;
 }
+/** A single aggregation row — a distinct property value combination with optional count. */
+interface TraversalAggregation {
+    /** Property values for this combination. */
+    values: Record<string, unknown>;
+    /** Number of entities with this value combination. Present when mode is 'count'. */
+    count?: number;
+}
 interface TraversalRelationship {
     id: string;
     type: string;
@@ -131,7 +218,7 @@ interface TraversalPath {
     /** Number of hops in this path. */
     length: number;
     /** Ordered sequence of entities from start to end. */
-    entities: Array<Entity | EntitySummary | EntityBrief>;
+    entities: TraversalEntity[];
     /** Ordered sequence of relationships connecting the entities. */
     relationships: TraversalRelationship[];
 }
@@ -174,4 +261,4 @@ interface QueryMetadata {
     truncationReason?: 'result_limit' | 'timeout' | 'cost_limit' | 'depth_limit';
 }
 
-export type { QueryMetadata as Q, TraversalSpec as T, TraversalResult as a, TraversalPath as b, TraversalRelationship as c, TraversalReturnMode as d, TraversalStart as e, TraversalStep as f };
+export type { QueryMetadata as Q, TraversalSpec as T, TraversalResult as a, TraversalAggregation as b, TraversalPath as c, TraversalProjection as d, TraversalRelationship as e, TraversalReturnMode as f, TraversalStart as g, TraversalStep as h };

package/dist/{traversal-BB_yERbf.d.cts → traversal-DQynd-to.d.cts}

@@ -1,20 +1,46 @@
-import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief } from './portability-DdjsCB07.cjs';
+import { P as PropertyFilter, D as DetailLevel, E as Entity, a as EntitySummary, b as EntityBrief, R as RelationshipSummary } from './portability-1KBMVBGJ.cjs';
 
 /**
- * A structured traversal specification that can be compiled to
+ * An entity as returned inside a TraversalResult — the projected entity plus
+ * an optional relationship summary when includeRelationshipSummary is set.
+ */
+type TraversalEntity = (Entity | EntitySummary | EntityBrief) & {
+    relationshipSummary?: RelationshipSummary;
+};
+/**
+ * A structured graph query specification that can be compiled to
  * Gremlin, Cypher, or executed via application-level BFS.
  *
  * Designed to be expressible by AI agents without raw query
- * language knowledge, while covering the common multi-hop
- * traversal patterns needed for knowledge graph exploration.
+ * language knowledge. Covers both vertex-only queries (property
+ * aggregation, distinct values, filtered lookups) and multi-hop
+ * relationship traversals.
+ *
+ * When steps is empty or omitted, the query operates on the
+ * starting entities directly — no relationship hops needed.
  */
 interface TraversalSpec {
-    /** Starting point for the traversal. */
+    /** Starting point — which entities to query or start traversing from. */
     start: TraversalStart;
-    /** Ordered sequence of traversal steps. */
-    steps: TraversalStep[];
-    /** What to return from the traversal. */
+    /**
+     * Ordered sequence of traversal steps (relationship hops).
+     * When empty or omitted, the query operates on the starting entities
+     * directly — useful for property aggregation, distinct value queries,
+     * and filtered entity lookups without relationship hops.
+     */
+    steps?: TraversalStep[];
+    /** What to return from the query. */
     returnMode: TraversalReturnMode;
+    /**
+     * Property projection — extract and aggregate property values from
+     * result entities. When present, returns projected values in the
+     * `aggregations` array. By default, the `entities` array is suppressed
+     * (projection replaces full entity output). Set `includeEntities: true`
+     * to return both.
+     *
+     * Works with both vertex-only queries and traversals.
+     */
+    projection?: TraversalProjection;
     /**
      * Maximum number of results to return.
      * Default: 50. Max: 200.
@@ -30,6 +56,54 @@ interface TraversalSpec {
     detailLevel?: DetailLevel;
     /** Whether to deduplicate entities in the result set. Default: true. */
     dedup?: boolean;
+    /**
+     * Whether to include a relationship summary (outbound/inbound counts by type)
+     * on each entity in the result. Default: false.
+     *
+     * Native GraphTraversalProviders (Gremlin, Cypher) can return this in a single
+     * query. The fallback executor fetches all relationship data in one batch call
+     * and computes summaries locally. Check GraphTraversalCapabilities.supportsRelationshipSummary
+     * to know whether the active provider handles this natively.
+     */
+    includeRelationshipSummary?: boolean;
+    /**
+     * Whether to include provenance data on entities. Default: false.
+     * Only has effect when detailLevel is 'full'.
+     */
+    includeProvenance?: boolean;
+}
+/**
+ * Property projection — extract and optionally aggregate property values
+ * from result entities. Like SQL SELECT or Gremlin valueMap(), projection
+ * returns the projected values, not the full objects.
+ *
+ * By default, when projection is present the entities array is suppressed
+ * (only aggregations are returned). Set includeEntities to also get the
+ * full entity objects back.
+ */
+interface TraversalProjection {
+    /**
+     * Property names to extract from result entities.
+     */
+    properties: string[];
+    /**
+     * Return only distinct combinations of the projected properties.
+     * Default: false.
+     */
+    distinct?: boolean;
+    /**
+     * Aggregation mode for the projected properties.
+     * - 'values': return the raw property values (default)
+     * - 'count': count entities per distinct value combination
+     */
+    mode?: 'count' | 'values';
+    /**
+     * When true, also return the full entities array alongside the
+     * projected aggregations. By default, projection suppresses entities
+     * to keep responses lightweight.
+     * Default: false.
+     */
+    includeEntities?: boolean;
 }
 /** Where the traversal begins. */
 interface TraversalStart {
@@ -99,7 +173,7 @@ type TraversalReturnMode =
  */
 interface TraversalResult {
     /** Entities in the result set, projected to the requested detail level. */
-    entities: Array<Entity | EntitySummary | EntityBrief>;
+    entities: TraversalEntity[];
     /**
      * Relationships in the result set.
      * Present when returnMode is 'path' or 'all'.
@@ -110,6 +184,12 @@ interface TraversalResult {
      * Present only when returnMode is 'path'.
      */
     paths?: TraversalPath[];
+    /**
+     * Aggregated property values.
+     * Present when select is specified in the query.
+     * Each entry is a distinct value combination with an optional count.
+     */
+    aggregations?: TraversalAggregation[];
     /** Total number of results matching the traversal (before limit/offset). */
     total: number;
     /** Number of results returned in this response. */
@@ -119,6 +199,13 @@ interface TraversalResult {
     /** Query execution metadata. */
     queryMetadata: QueryMetadata;
 }
+/** A single aggregation row — a distinct property value combination with optional count. */
+interface TraversalAggregation {
+    /** Property values for this combination. */
+    values: Record<string, unknown>;
+    /** Number of entities with this value combination. Present when mode is 'count'. */
+    count?: number;
+}
 interface TraversalRelationship {
     id: string;
     type: string;
@@ -131,7 +218,7 @@ interface TraversalPath {
     /** Number of hops in this path. */
     length: number;
     /** Ordered sequence of entities from start to end. */
-    entities: Array<Entity | EntitySummary | EntityBrief>;
+    entities: TraversalEntity[];
     /** Ordered sequence of relationships connecting the entities. */
     relationships: TraversalRelationship[];
 }
@@ -174,4 +261,4 @@ interface QueryMetadata {
     truncationReason?: 'result_limit' | 'timeout' | 'cost_limit' | 'depth_limit';
 }
 
-export type { QueryMetadata as Q, TraversalSpec as T, TraversalResult as a, TraversalPath as b, TraversalRelationship as c, TraversalReturnMode as d, TraversalStart as e, TraversalStep as f };
+export type { QueryMetadata as Q, TraversalSpec as T, TraversalResult as a, TraversalAggregation as b, TraversalPath as c, TraversalProjection as d, TraversalRelationship as e, TraversalReturnMode as f, TraversalStart as g, TraversalStep as h };

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} from './entities.js';\n\nexport type {\n  RelationshipDirection,\n  Relationship,\n  EnrichedRelationship,\n  CreateRelationshipInput,\n  StoredRelationship,\n  RelationshipQueryOptions,\n  RelationshipSummary,\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  NeighbourhoodCentre,\n  NeighbourhoodGroup,\n  NeighbourhoodLayer,\n  Neighbourhood,\n  Path,\n  PathResult,\n  ScoredEntity,\n  TimelineEntityRef,\n  TimelineRelationshipDetail,\n  TimelineEvent,\n  TimelineResult,\n  GraphResult,\n  EntityMap,\n  StorageNeighbourhoodGroup,\n  StorageNeighbourhoodLayer,\n  StorageNeighbourhood,\n  StoragePath,\n  StoragePathResult,\n  StorageTimelineEvent,\n  StorageTimelineResult,\n  SearchHit,\n  BulkImportResult,\n  ReembedResult,\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  TraversalReturnMode,\n  TraversalResult,\n  TraversalRelationship,\n  TraversalPath,\n  QueryMetadata,\n} from './traversal.js';\n\nexport type {\n  ExportManifest,\n  ExportLegalMetadata,\n  ExportPipelineMetadata,\n  ExportOptions,\n  ExportArchive,\n  ExportChunk,\n  ExportStreamItem,\n  ImportOptions,\n  ImportChunk,\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} from './entities.js';\n\nexport type {\n  RelationshipDirection,\n  Relationship,\n  EnrichedRelationship,\n  CreateRelationshipInput,\n  StoredRelationship,\n  RelationshipQueryOptions,\n  RelationshipSummary,\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  NeighbourhoodCentre,\n  NeighbourhoodGroup,\n  NeighbourhoodLayer,\n  Neighbourhood,\n  Path,\n  PathResult,\n  ScoredEntity,\n  TimelineEntityRef,\n  TimelineRelationshipDetail,\n  TimelineEvent,\n  TimelineResult,\n  GraphResult,\n  EntityMap,\n  StorageNeighbourhoodGroup,\n  StorageNeighbourhoodLayer,\n  StorageNeighbourhood,\n  StoragePath,\n  StoragePathResult,\n  StorageTimelineEvent,\n  StorageTimelineResult,\n  SearchHit,\n  BulkImportResult,\n  ReembedResult,\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  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":[]}

package/dist/types/index.d.cts

@@ -1,9 +1,9 @@
-import { z as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, v as CreateRelationshipInput, J as Relationship, V as VocabularyChangeRecord } from '../portability-DdjsCB07.cjs';
-export { B as BulkImportResult, W as ConceptSearchOptions, D as DetailLevel, a8 as EnrichedRelationship, b as EntityBrief, a9 as EntityMap, a as EntitySummary, w as EntityTypeDefinition, aa as EntityTypeInput, N as ExploreOptions, a1 as ExportArchive, t as ExportChunk, ab as ExportLegalMetadata, ac as ExportManifest, a0 as ExportOptions, ad as ExportPipelineMetadata, a4 as ExportStreamItem, F as FindEntitiesQuery, ae as GetEntitiesOptions, af as GetEntityOptions, G as GovernanceConfig, ag as GovernanceMode, L as GraphResult, I as ImportChunk, a2 as ImportOptions, a3 as ImportResult, a5 as ImportStreamHeader, ah as ImportWarning, M as MemoryVocabulary, O as Neighbourhood, ai as NeighbourhoodCentre, aj as NeighbourhoodGroup, ak as NeighbourhoodLayer, d as PaginatedResult, h as PaginationOptions, al as Path, Q as PathOptions, T as PathResult, P as PropertyFilter, am as PropertySchema, an as PropertyType, A as Provenance, ao as ProvenanceFilter, H as ReembedResult, ap as RelationshipDirection, m as RelationshipQueryOptions, K as RelationshipSummary, aq as RelationshipTypeDefinition, ar as RelationshipTypeInput, _ as RepositoryConfig, R as RepositoryFilter, as as RepositoryMetadata, g as RepositoryStats, $ as RepositorySummary, f as RepositoryUpdate, u as ResolvedVocabulary, X as ScoredEntity, a7 as SearchHit, a6 as SearchOptions, n as StorageExploreOptions, k as StorageFindQuery, o as StorageNeighbourhood, at as StorageNeighbourhoodGroup, au as StorageNeighbourhoodLayer, av as StoragePath, p as StoragePathOptions, q as StoragePathResult, S as StorageRepositoryConfig, aw as StorageTimelineEvent, r as StorageTimelineOptions, s as StorageTimelineResult, i as StoredEntity, j as StoredEntityUpdate, l as StoredRelationship, c as StoredRepository, e as StoredRepositorySummary, ax as TimelineEntityRef, ay as TimelineEvent, Y as TimelineOptions, az as TimelineRelationshipDetail, Z as TimelineResult, aA as VocabularyInput, x as VocabularyProposal, y as VocabularyProposalResult } from '../portability-DdjsCB07.cjs';
-export { Q as QueryMetadata, b as TraversalPath, c as TraversalRelationship, a as TraversalResult, d as TraversalReturnMode, T as TraversalSpec, e as TraversalStart, f as TraversalStep } from '../traversal-BB_yERbf.cjs';
+import { H as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, y as CreateRelationshipInput, N as Relationship, V as VocabularyChangeRecord } from '../portability-1KBMVBGJ.cjs';
+export { B as BulkImportOptions, w as BulkImportResult, Y as ConceptSearchOptions, h as DeleteProgressCallback, D as DetailLevel, aa as EnrichedRelationship, b as EntityBrief, ab as EntityMap, a as EntitySummary, z as EntityTypeDefinition, ac as EntityTypeInput, Q as ExploreOptions, a3 as ExportArchive, v as ExportChunk, ad as ExportLegalMetadata, ae as ExportManifest, a2 as ExportOptions, af as ExportPipelineMetadata, a6 as ExportStreamItem, K as FindEntitiesQuery, ag as GetEntitiesOptions, ah as GetEntityOptions, G as GovernanceConfig, ai as GovernanceMode, O as GraphResult, I as ImportChunk, a4 as ImportOptions, a5 as ImportResult, a7 as ImportStreamHeader, aj as ImportWarning, M as MemoryVocabulary, T as Neighbourhood, ak as NeighbourhoodCentre, al as NeighbourhoodGroup, am as NeighbourhoodLayer, e as PaginatedResult, j as PaginationOptions, an as Path, W as PathOptions, X as PathResult, P as PropertyFilter, ao as PropertySchema, ap as PropertyType, J as Provenance, aq as ProvenanceFilter, L as ReembedResult, ar as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, as as RelationshipTypeDefinition, at as RelationshipTypeInput, a0 as RepositoryConfig, d as RepositoryFilter, au as RepositoryMetadata, i as RepositoryStats, a1 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, Z as ScoredEntity, a9 as SearchHit, a8 as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighbourhood, av as StorageNeighbourhoodGroup, aw as StorageNeighbourhoodLayer, ax as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, ay as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, az as TimelineEntityRef, aA as TimelineEvent, _ as TimelineOptions, aB as TimelineRelationshipDetail, $ as TimelineResult, aC as VocabularyInput, A as VocabularyProposal, F as VocabularyProposalResult } from '../portability-1KBMVBGJ.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-DQynd-to.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';
+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';
 /** Type-safe event payload mapping */
 type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created' ? {
     repositoryId: string;
@@ -76,10 +76,16 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
     error: string;
 } : T extends 'export:started' ? {
     repositoryId: string;
+    totalEntities: number;
+    totalRelationships: number;
 } : T extends 'export:progress' ? {
     repositoryId: string;
     entitiesExported: number;
+    relationshipsExported: number;
     totalEntities: number;
+    totalRelationships: number;
+    chunksCompleted: number;
+    totalChunks: number;
 } : T extends 'export:completed' ? {
     repositoryId: string;
     entityCount: number;
@@ -89,7 +95,11 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
 } : T extends 'import:progress' ? {
     repositoryId: string;
     entitiesImported: number;
+    relationshipsImported: number;
     totalEntities: number;
+    totalRelationships: number;
+    chunksCompleted: number;
+    totalChunks: number;
 } : T extends 'import:completed' ? {
     repositoryId: string;
     entitiesImported: number;
@@ -97,6 +107,20 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
 } : T extends 'import:failed' ? {
     repositoryId: string;
     error: string;
+} : T extends 'delete:started' ? {
+    repositoryId: string;
+    totalEntities: number;
+    totalRelationships: number;
+} : T extends 'delete:progress' ? {
+    repositoryId: string;
+    entitiesDeleted: number;
+    relationshipsDeleted: number;
+    totalEntities: number;
+    totalRelationships: number;
+} : T extends 'delete:completed' ? {
+    repositoryId: string;
+    entitiesDeleted: number;
+    relationshipsDeleted: number;
 } : Record<string, unknown>;
 /** A typed event emitted by the engine */
 interface DeepMemoryEvent<T extends DeepMemoryEventType> {

package/dist/types/index.d.ts

@@ -1,9 +1,9 @@
-import { z as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, v as CreateRelationshipInput, J as Relationship, V as VocabularyChangeRecord } from '../portability-DdjsCB07.js';
-export { B as BulkImportResult, W as ConceptSearchOptions, D as DetailLevel, a8 as EnrichedRelationship, b as EntityBrief, a9 as EntityMap, a as EntitySummary, w as EntityTypeDefinition, aa as EntityTypeInput, N as ExploreOptions, a1 as ExportArchive, t as ExportChunk, ab as ExportLegalMetadata, ac as ExportManifest, a0 as ExportOptions, ad as ExportPipelineMetadata, a4 as ExportStreamItem, F as FindEntitiesQuery, ae as GetEntitiesOptions, af as GetEntityOptions, G as GovernanceConfig, ag as GovernanceMode, L as GraphResult, I as ImportChunk, a2 as ImportOptions, a3 as ImportResult, a5 as ImportStreamHeader, ah as ImportWarning, M as MemoryVocabulary, O as Neighbourhood, ai as NeighbourhoodCentre, aj as NeighbourhoodGroup, ak as NeighbourhoodLayer, d as PaginatedResult, h as PaginationOptions, al as Path, Q as PathOptions, T as PathResult, P as PropertyFilter, am as PropertySchema, an as PropertyType, A as Provenance, ao as ProvenanceFilter, H as ReembedResult, ap as RelationshipDirection, m as RelationshipQueryOptions, K as RelationshipSummary, aq as RelationshipTypeDefinition, ar as RelationshipTypeInput, _ as RepositoryConfig, R as RepositoryFilter, as as RepositoryMetadata, g as RepositoryStats, $ as RepositorySummary, f as RepositoryUpdate, u as ResolvedVocabulary, X as ScoredEntity, a7 as SearchHit, a6 as SearchOptions, n as StorageExploreOptions, k as StorageFindQuery, o as StorageNeighbourhood, at as StorageNeighbourhoodGroup, au as StorageNeighbourhoodLayer, av as StoragePath, p as StoragePathOptions, q as StoragePathResult, S as StorageRepositoryConfig, aw as StorageTimelineEvent, r as StorageTimelineOptions, s as StorageTimelineResult, i as StoredEntity, j as StoredEntityUpdate, l as StoredRelationship, c as StoredRepository, e as StoredRepositorySummary, ax as TimelineEntityRef, ay as TimelineEvent, Y as TimelineOptions, az as TimelineRelationshipDetail, Z as TimelineResult, aA as VocabularyInput, x as VocabularyProposal, y as VocabularyProposalResult } from '../portability-DdjsCB07.js';
-export { Q as QueryMetadata, b as TraversalPath, c as TraversalRelationship, a as TraversalResult, d as TraversalReturnMode, T as TraversalSpec, e as TraversalStart, f as TraversalStep } from '../traversal-9JdiqjZ9.js';
+import { H as ProvenanceContext, C as CreateEntityInput, E as Entity, U as UpdateEntityInput, y as CreateRelationshipInput, N as Relationship, V as VocabularyChangeRecord } from '../portability-1KBMVBGJ.js';
+export { B as BulkImportOptions, w as BulkImportResult, Y as ConceptSearchOptions, h as DeleteProgressCallback, D as DetailLevel, aa as EnrichedRelationship, b as EntityBrief, ab as EntityMap, a as EntitySummary, z as EntityTypeDefinition, ac as EntityTypeInput, Q as ExploreOptions, a3 as ExportArchive, v as ExportChunk, ad as ExportLegalMetadata, ae as ExportManifest, a2 as ExportOptions, af as ExportPipelineMetadata, a6 as ExportStreamItem, K as FindEntitiesQuery, ag as GetEntitiesOptions, ah as GetEntityOptions, G as GovernanceConfig, ai as GovernanceMode, O as GraphResult, I as ImportChunk, a4 as ImportOptions, a5 as ImportResult, a7 as ImportStreamHeader, aj as ImportWarning, M as MemoryVocabulary, T as Neighbourhood, ak as NeighbourhoodCentre, al as NeighbourhoodGroup, am as NeighbourhoodLayer, e as PaginatedResult, j as PaginationOptions, an as Path, W as PathOptions, X as PathResult, P as PropertyFilter, ao as PropertySchema, ap as PropertyType, J as Provenance, aq as ProvenanceFilter, L as ReembedResult, ar as RelationshipDirection, o as RelationshipQueryOptions, R as RelationshipSummary, as as RelationshipTypeDefinition, at as RelationshipTypeInput, a0 as RepositoryConfig, d as RepositoryFilter, au as RepositoryMetadata, i as RepositoryStats, a1 as RepositorySummary, g as RepositoryUpdate, x as ResolvedVocabulary, Z as ScoredEntity, a9 as SearchHit, a8 as SearchOptions, p as StorageExploreOptions, m as StorageFindQuery, q as StorageNeighbourhood, av as StorageNeighbourhoodGroup, aw as StorageNeighbourhoodLayer, ax as StoragePath, r as StoragePathOptions, s as StoragePathResult, S as StorageRepositoryConfig, ay as StorageTimelineEvent, t as StorageTimelineOptions, u as StorageTimelineResult, k as StoredEntity, l as StoredEntityUpdate, n as StoredRelationship, c as StoredRepository, f as StoredRepositorySummary, az as TimelineEntityRef, aA as TimelineEvent, _ as TimelineOptions, aB as TimelineRelationshipDetail, $ as TimelineResult, aC as VocabularyInput, A as VocabularyProposal, F as VocabularyProposalResult } from '../portability-1KBMVBGJ.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-B4SUysM-.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';
+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';
 /** Type-safe event payload mapping */
 type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created' ? {
     repositoryId: string;
@@ -76,10 +76,16 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
     error: string;
 } : T extends 'export:started' ? {
     repositoryId: string;
+    totalEntities: number;
+    totalRelationships: number;
 } : T extends 'export:progress' ? {
     repositoryId: string;
     entitiesExported: number;
+    relationshipsExported: number;
     totalEntities: number;
+    totalRelationships: number;
+    chunksCompleted: number;
+    totalChunks: number;
 } : T extends 'export:completed' ? {
     repositoryId: string;
     entityCount: number;
@@ -89,7 +95,11 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
 } : T extends 'import:progress' ? {
     repositoryId: string;
     entitiesImported: number;
+    relationshipsImported: number;
     totalEntities: number;
+    totalRelationships: number;
+    chunksCompleted: number;
+    totalChunks: number;
 } : T extends 'import:completed' ? {
     repositoryId: string;
     entitiesImported: number;
@@ -97,6 +107,20 @@ type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created
 } : T extends 'import:failed' ? {
     repositoryId: string;
     error: string;
+} : T extends 'delete:started' ? {
+    repositoryId: string;
+    totalEntities: number;
+    totalRelationships: number;
+} : T extends 'delete:progress' ? {
+    repositoryId: string;
+    entitiesDeleted: number;
+    relationshipsDeleted: number;
+    totalEntities: number;
+    totalRelationships: number;
+} : T extends 'delete:completed' ? {
+    repositoryId: string;
+    entitiesDeleted: number;
+    relationshipsDeleted: number;
 } : Record<string, unknown>;
 /** A typed event emitted by the engine */
 interface DeepMemoryEvent<T extends DeepMemoryEventType> {

package/package.json

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