@utaba/deep-memory 0.18.0 → 0.20.0

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -3591,7 +3591,7 @@ var EventBus = class {
 };
 
 // src/portability/RepositoryExporter.ts
-var LIBRARY_VERSION = true ? "0.18.0" : "0.1.0";
+var LIBRARY_VERSION = true ? "0.20.0" : "0.1.0";
 var RepositoryExporter = class {
   storage;
   provenance;
@@ -3623,6 +3623,9 @@ var RepositoryExporter = class {
         type: repo.type,
         label: repo.label,
         description: repo.description,
+        legal: repo.legal,
+        owner: repo.owner,
+        metadata: repo.metadata,
         vocabularyVersion: vocabulary.version,
         governanceMode: repo.governanceConfig.mode
       },
@@ -4020,7 +4023,10 @@ var RepositoryImporter = class {
         type: target.config.type,
         label: target.config.label,
         description: target.config.description,
+        legal: target.config.legal,
+        owner: target.config.owner,
         governanceConfig: target.config.governance ?? { mode: "open" },
+        metadata: target.config.metadata,
         createdAt: now,
         createdBy: this.actorId
       });
@@ -4535,6 +4541,7 @@ var DeepMemory = class {
   /** Import a repository from a portable archive */
   async importRepository(archive, options) {
     await this.ensureInitialized();
+    this.validateRepositoryId(options.target.repositoryId);
     await this.globalEventBus.emit("import:started", { repositoryId: options.target.repositoryId });
     const importer = new RepositoryImporter({
       storage: this.storage,
@@ -4635,6 +4642,7 @@ var DeepMemory = class {
    */
   async importRepositoryStream(header, chunks, options) {
     await this.ensureInitialized();
+    this.validateRepositoryId(options.target.repositoryId);
     const importer = new RepositoryImporter({
       storage: this.storage,
       actorId: this.provenance.getContext().actorId,
@@ -4906,12 +4914,16 @@ var GremlinCompiler = class {
           }
         }
       }
-      if (returnMode === "terminal" && spec.dedup !== false) {
+      const emitProjection = spec.projection !== void 0 && returnMode === "terminal";
+      if (returnMode === "terminal" && !emitProjection && spec.dedup !== false) {
         parts.push(".dedup()");
       }
       if (returnMode === "path") {
         parts.push(".simplePath()");
       }
+      if (emitProjection) {
+        parts.push(emitProjectionTerminal(spec.projection));
+      }
       const limit = spec.limit ?? 50;
       const offset = spec.offset ?? 0;
       const pOffset = nextParam(offset);
@@ -4919,7 +4931,8 @@ var GremlinCompiler = class {
       parts.push(`.range(${pOffset}, ${pEnd})`);
       params["_limit"] = limit;
       params["_offset"] = offset;
-      if (returnMode === "terminal") {
+      if (emitProjection) {
+      } else if (returnMode === "terminal") {
         parts.push(`.${VERTEX_PROJECT_EXPR}`);
       } else {
         parts.push(`.path().by(${VERTEX_PROJECT_EXPR}).by(${EDGE_PROJECT_EXPR})`);
@@ -5015,6 +5028,31 @@ function compileRepeatStep(step, nextParam, useEdgeEmission) {
   }
   return parts.join("");
 }
+var SAFE_PROJECTION_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertSafeProjectionKey(key) {
+  if (!SAFE_PROJECTION_KEY_RE.test(key)) {
+    throw new Error(
+      `Unsafe projection property name: "${key}". Property names must match ${SAFE_PROJECTION_KEY_RE.source}.`
+    );
+  }
+}
+function emitProjectionTerminal(projection) {
+  const properties = projection.properties;
+  const mode = projection.mode ?? "values";
+  const distinct = projection.distinct ?? false;
+  for (const prop of properties) {
+    assertSafeProjectionKey(prop);
+  }
+  const singleProperty = properties.length === 1;
+  const keyExpr = singleProperty ? `values('${properties[0]}')` : `project(${properties.map((p) => `'${p}'`).join(",")})${properties.map((p) => `.by(values('${p}'))`).join("")}`;
+  if (mode === "count") {
+    return `.group().by(${keyExpr}).by(count()).unfold()`;
+  }
+  if (distinct) {
+    return `.${keyExpr}.dedup()`;
+  }
+  return `.${keyExpr}`;
+}
 function compilePropertyFilter(filter, nextParam) {
   const key = nextParam(filter.key);
   switch (filter.operator) {
@@ -5124,17 +5162,35 @@ var CypherCompiler = class {
       }
       lastNode = targetNode;
     }
-    const matchClause = `MATCH ${matchParts[0]}${matchParts.slice(1).join("")}`;
+    const bindPath = spec.returnMode === "path";
+    const pathBinding = bindPath ? "p = " : "";
+    const matchClause = `MATCH ${pathBinding}${matchParts[0]}${matchParts.slice(1).join("")}`;
     const whereClause = whereClauses.length > 0 ? `
 WHERE ${whereClauses.join(" AND ")}` : "";
     let returnClause;
-    if (spec.returnMode === "path") {
-      const allNodes = Array.from({ length: nodeIndex }, (_, i) => `n${i}`);
-      const allRels = steps.map((_, i) => `r${i}`);
-      returnClause = `RETURN ${[...allNodes, ...allRels].join(", ")}`;
+    const emitProjection = spec.projection !== void 0 && spec.returnMode !== "path" && spec.returnMode !== "all";
+    if (emitProjection) {
+      const projection = spec.projection;
+      const mode = projection.mode ?? "values";
+      const distinct = projection.distinct ?? false;
+      const projectionColumns = projection.properties.map((prop) => {
+        assertSafeProjectionKey2(prop);
+        return `${lastNode}.${prop} AS ${prop}`;
+      });
+      if (mode === "count") {
+        returnClause = `RETURN ${projectionColumns.join(", ")}, count(*) AS count`;
+      } else if (distinct) {
+        returnClause = `RETURN DISTINCT ${projectionColumns.join(", ")}`;
+      } else {
+        returnClause = `RETURN ${projectionColumns.join(", ")}`;
+      }
+    } else if (spec.returnMode === "path") {
+      returnClause = "RETURN nodes(p) AS pathNodes, relationships(p) AS pathRels, length(p) AS pathLength";
     } else if (spec.returnMode === "all") {
       const allNodes = Array.from({ length: nodeIndex }, (_, i) => `n${i}`);
-      returnClause = spec.dedup !== false ? `RETURN DISTINCT ${allNodes.join(", ")}` : `RETURN ${allNodes.join(", ")}`;
+      const allRels = steps.map((_, i) => `r${i}`);
+      const projection = [...allNodes, ...allRels].join(", ");
+      returnClause = spec.dedup !== false ? `RETURN DISTINCT ${projection}` : `RETURN ${projection}`;
     } else {
       returnClause = spec.dedup !== false ? `RETURN DISTINCT ${lastNode}` : `RETURN ${lastNode}`;
     }
@@ -5155,6 +5211,14 @@ ${returnClause}${skipClause}${limitClause}`;
     };
   }
 };
+var SAFE_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertSafeProjectionKey2(key) {
+  if (!SAFE_KEY_RE.test(key)) {
+    throw new Error(
+      `Unsafe projection property name: "${key}". Property names must match ${SAFE_KEY_RE.source}.`
+    );
+  }
+}
 function compilePropertyFilterCypher(nodeAlias, filter, nextParam) {
   const prop = `${nodeAlias}.${filter.key}`;
   switch (filter.operator) {
@@ -5559,6 +5623,7 @@ var InMemoryStorageProvider = class {
     for (let depth = 0; depth < options.depth; depth++) {
       const layer = {};
       const nextFrontier = /* @__PURE__ */ new Set();
+      const layerBucketSeen = /* @__PURE__ */ new Map();
       for (const frontierEntityId of currentFrontier) {
         for (const rel of store.relationships.values()) {
           const isSource = rel.sourceEntityId === frontierEntityId;
@@ -5596,6 +5661,13 @@ var InMemoryStorageProvider = class {
             continue;
           }
           const relType = rel.relationshipType;
+          let bucketSeen = layerBucketSeen.get(relType);
+          if (!bucketSeen) {
+            bucketSeen = /* @__PURE__ */ new Set();
+            layerBucketSeen.set(relType, bucketSeen);
+          }
+          if (bucketSeen.has(connectedEntityId)) continue;
+          bucketSeen.add(connectedEntityId);
           if (!layer[relType]) {
             layer[relType] = { total: 0, entities: [], relationships: [] };
           }