@utaba/deep-memory 0.6.1 → 0.8.0

package/dist/{portability-B-8J4nQQ.d.cts → portability-dhIuWJbJ.d.cts}

@@ -34,6 +34,8 @@ interface PropertySchema {
     /** Valid values when type === "enum" */
     enumValues?: string[];
     defaultValue?: unknown;
+    /** When true, this property's value is appended to the entity's embedding text. Only valid for string properties. Omitted when false or not applicable — never serialized as false. */
+    embeddable?: true;
 }
 /** Definition of an entity type within a vocabulary */
 interface EntityTypeDefinition {
@@ -255,12 +257,24 @@ interface CreateEntityInput {
 }
 /** Input for updating an existing entity */
 interface UpdateEntityInput {
+    /**
+     * Change the entity's type. Must exist in the vocabulary. The slug is
+     * regenerated with the new type prefix, and any provided `properties` are
+     * validated against the new type's schema.
+     */
+    entityType?: string;
     label?: string;
-    summary?: string;
-    /** Merged with existing properties */
+    /** `undefined` preserves the existing value; `null` clears it. */
+    summary?: string | null;
+    /**
+     * Merged with existing properties. A property value of `null` deletes that
+     * key from the entity's properties (RFC 7396 JSON Merge Patch semantics).
+     */
     properties?: Record<string, unknown>;
-    data?: string;
-    dataFormat?: string;
+    /** `undefined` preserves the existing value; `null` clears it. */
+    data?: string | null;
+    /** `undefined` preserves the existing value; `null` clears it. */
+    dataFormat?: string | null;
     /** Force regeneration of the embedding vector (e.g. after switching embedding models) */
     reembed?: boolean;
 }
@@ -275,17 +289,26 @@ interface StoredEntity {
     data?: string;
     dataFormat?: string;
     provenance: Provenance;
-    /** Vector embedding of the entity (label + summary + properties) */
+    /** Vector embedding of the entity (label + summary + embeddable string properties) */
     embedding?: number[];
 }
-/** Internal update representation for the storage provider */
+/**
+ * Internal update representation for the storage provider.
+ *
+ * For optional string fields (`summary`, `data`, `dataFormat`), the tri-state
+ * applies: `undefined` preserves the existing value, `null` clears it, and a
+ * string sets the new value. For `properties`, storage receives the fully
+ * merged map that the caller wants persisted — key deletions are already
+ * applied upstream, so storage can replace the stored map wholesale.
+ */
 interface StoredEntityUpdate {
+    entityType?: string;
     label?: string;
     slug?: string;
-    summary?: string;
+    summary?: string | null;
     properties?: Record<string, unknown>;
-    data?: string;
-    dataFormat?: string;
+    data?: string | null;
+    dataFormat?: string | null;
     provenance: Provenance;
     embedding?: number[];
 }
@@ -298,6 +321,14 @@ interface GetEntitiesOptions {
     /** Only "brief" or "summary" for batch retrieval */
     detailLevel?: 'brief' | 'summary';
 }
+/** Result of a bulk entity deletion */
+interface DeleteEntitiesResult {
+    deleted: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
 
 /** Pagination options used across all paginated queries */
 interface PaginationOptions {
@@ -496,6 +527,14 @@ interface RelationshipSummary {
     outbound: Record<string, number>;
     inbound: Record<string, number>;
 }
+/** Result of a bulk relationship removal */
+interface RemoveRelationshipsResult {
+    removed: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
 /** Options for querying relationships of an entity */
 interface RelationshipQueryOptions {
     /** Filter by relationship type(s) */
@@ -617,6 +656,18 @@ interface StorageRepositoryConfig {
     createdBy: string;
 }
 
+/** A single validation error with optional suggestion */
+interface ValidationError {
+    field: string;
+    message: string;
+    suggestion?: string;
+}
+/** Result of a validation check */
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+
 /** Paginated result wrapper */
 interface PaginatedResult<T> {
     items: T[];
@@ -782,6 +833,68 @@ interface ReembedResult {
     modelId: string;
     dimensions: number;
 }
+/** A single entity that failed vocabulary validation */
+interface EntityValidationIssue {
+    entityId: string;
+    slug: string;
+    entityType: string;
+    label: string;
+    errors: ValidationError[];
+}
+/** A single relationship that failed vocabulary validation */
+interface RelationshipValidationIssue {
+    relationshipId: string;
+    relationshipType: string;
+    sourceEntityId: string;
+    targetEntityId: string;
+    /** Label of the source entity if it exists (aids human/AI diagnosis) */
+    sourceLabel?: string;
+    /** Label of the target entity if it exists */
+    targetLabel?: string;
+    /** Type of the source entity if it exists (for context on type-mismatch errors) */
+    sourceEntityType?: string;
+    /** Type of the target entity if it exists */
+    targetEntityType?: string;
+    errors: ValidationError[];
+}
+/** One page of entity validation results from RepositoryValidator.validateEntities() */
+interface EntityValidationPage {
+    issues: EntityValidationIssue[];
+    /** Number of entities inspected in this call (for diagnostics; not bounded by take) */
+    scanned: number;
+    /** Issue-offset to pass on the next call; equal to the input offset + issues.length */
+    nextOffset: number;
+    /** True when the export stream ended before take was hit (no further issues beyond this page) */
+    done: boolean;
+}
+/** One page of relationship validation results from RepositoryValidator.validateRelationships() */
+interface RelationshipValidationPage {
+    issues: RelationshipValidationIssue[];
+    /** Number of relationships inspected in this call (for diagnostics; not bounded by take) */
+    scanned: number;
+    /** Issue-offset to pass on the next call; equal to the input offset + issues.length */
+    nextOffset: number;
+    /** True when the export stream ended before take was hit (no further issues beyond this page) */
+    done: boolean;
+    /** Number of entities loaded into the resolution map (for diagnostics) */
+    entitiesInMap: number;
+}
+interface ValidateEntitiesOptions {
+    /** Number of issues to skip before returning (not entities); default 0 */
+    offset?: number;
+    /** Maximum number of issues to return in this call; default 200 */
+    take?: number;
+    /** Milliseconds to pause between export chunks (for manual rate limiting); default 0 */
+    delayBetweenChunksMs?: number;
+}
+interface ValidateRelationshipsOptions {
+    /** Number of issues to skip before returning (not relationships); default 0 */
+    offset?: number;
+    /** Maximum number of issues to return in this call; default 200 */
+    take?: number;
+    /** Milliseconds to pause between export chunks (for manual rate limiting); default 0 */
+    delayBetweenChunksMs?: number;
+}
 
 /** Manifest describing an exported repository archive */
 interface ExportManifest {
@@ -955,4 +1068,4 @@ interface ImportResult {
     warnings: ImportWarning[];
 }
 
-export type { TimelineResult as $, VocabularyProposal as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposalResult as F, GovernanceConfig as G, ProvenanceContext as H, ImportChunk as I, Provenance as J, FindEntitiesQuery as K, ReembedResult as L, MemoryVocabulary as M, Relationship as N, GraphResult as O, PropertyFilter as P, ExploreOptions as Q, RelationshipSummary as R, StorageRepositoryConfig as S, Neighborhood as T, UpdateEntityInput as U, VocabularyChangeRecord as V, PathOptions as W, PathResult as X, ConceptSearchOptions as Y, ScoredEntity as Z, TimelineOptions as _, EntitySummary as a, RepositoryConfig as a0, RepositorySummary as a1, ExportOptions as a2, ExportArchive as a3, ImportOptions as a4, ImportResult as a5, ExportStreamItem as a6, ImportStreamHeader as a7, SearchOptions as a8, SearchHit as a9, TimelineEvent as aA, TimelineRelationshipDetail as aB, VocabularyInput as aC, EnrichedRelationship as aa, EntityMap as ab, EntityTypeInput as ac, ExportLegalMetadata as ad, ExportManifest as ae, ExportPipelineMetadata as af, GetEntitiesOptions as ag, GetEntityOptions as ah, GovernanceMode as ai, ImportWarning as aj, NeighborhoodCenter as ak, NeighborhoodGroup as al, NeighborhoodLayer as am, Path as an, PropertySchema as ao, PropertyType as ap, ProvenanceFilter as aq, RelationshipDirection as ar, RelationshipTypeDefinition as as, RelationshipTypeInput as at, RepositoryMetadata as au, StorageNeighborhoodGroup as av, StorageNeighborhoodLayer as aw, StoragePath as ax, StorageTimelineEvent as ay, TimelineEntityRef 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, CreateRelationshipInput as y, EntityTypeDefinition 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, 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 };

package/dist/{portability-B-8J4nQQ.d.ts → portability-dhIuWJbJ.d.ts}

@@ -34,6 +34,8 @@ interface PropertySchema {
     /** Valid values when type === "enum" */
     enumValues?: string[];
     defaultValue?: unknown;
+    /** When true, this property's value is appended to the entity's embedding text. Only valid for string properties. Omitted when false or not applicable — never serialized as false. */
+    embeddable?: true;
 }
 /** Definition of an entity type within a vocabulary */
 interface EntityTypeDefinition {
@@ -255,12 +257,24 @@ interface CreateEntityInput {
 }
 /** Input for updating an existing entity */
 interface UpdateEntityInput {
+    /**
+     * Change the entity's type. Must exist in the vocabulary. The slug is
+     * regenerated with the new type prefix, and any provided `properties` are
+     * validated against the new type's schema.
+     */
+    entityType?: string;
     label?: string;
-    summary?: string;
-    /** Merged with existing properties */
+    /** `undefined` preserves the existing value; `null` clears it. */
+    summary?: string | null;
+    /**
+     * Merged with existing properties. A property value of `null` deletes that
+     * key from the entity's properties (RFC 7396 JSON Merge Patch semantics).
+     */
     properties?: Record<string, unknown>;
-    data?: string;
-    dataFormat?: string;
+    /** `undefined` preserves the existing value; `null` clears it. */
+    data?: string | null;
+    /** `undefined` preserves the existing value; `null` clears it. */
+    dataFormat?: string | null;
     /** Force regeneration of the embedding vector (e.g. after switching embedding models) */
     reembed?: boolean;
 }
@@ -275,17 +289,26 @@ interface StoredEntity {
     data?: string;
     dataFormat?: string;
     provenance: Provenance;
-    /** Vector embedding of the entity (label + summary + properties) */
+    /** Vector embedding of the entity (label + summary + embeddable string properties) */
     embedding?: number[];
 }
-/** Internal update representation for the storage provider */
+/**
+ * Internal update representation for the storage provider.
+ *
+ * For optional string fields (`summary`, `data`, `dataFormat`), the tri-state
+ * applies: `undefined` preserves the existing value, `null` clears it, and a
+ * string sets the new value. For `properties`, storage receives the fully
+ * merged map that the caller wants persisted — key deletions are already
+ * applied upstream, so storage can replace the stored map wholesale.
+ */
 interface StoredEntityUpdate {
+    entityType?: string;
     label?: string;
     slug?: string;
-    summary?: string;
+    summary?: string | null;
     properties?: Record<string, unknown>;
-    data?: string;
-    dataFormat?: string;
+    data?: string | null;
+    dataFormat?: string | null;
     provenance: Provenance;
     embedding?: number[];
 }
@@ -298,6 +321,14 @@ interface GetEntitiesOptions {
     /** Only "brief" or "summary" for batch retrieval */
     detailLevel?: 'brief' | 'summary';
 }
+/** Result of a bulk entity deletion */
+interface DeleteEntitiesResult {
+    deleted: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
 
 /** Pagination options used across all paginated queries */
 interface PaginationOptions {
@@ -496,6 +527,14 @@ interface RelationshipSummary {
     outbound: Record<string, number>;
     inbound: Record<string, number>;
 }
+/** Result of a bulk relationship removal */
+interface RemoveRelationshipsResult {
+    removed: string[];
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
 /** Options for querying relationships of an entity */
 interface RelationshipQueryOptions {
     /** Filter by relationship type(s) */
@@ -617,6 +656,18 @@ interface StorageRepositoryConfig {
     createdBy: string;
 }
 
+/** A single validation error with optional suggestion */
+interface ValidationError {
+    field: string;
+    message: string;
+    suggestion?: string;
+}
+/** Result of a validation check */
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+
 /** Paginated result wrapper */
 interface PaginatedResult<T> {
     items: T[];
@@ -782,6 +833,68 @@ interface ReembedResult {
     modelId: string;
     dimensions: number;
 }
+/** A single entity that failed vocabulary validation */
+interface EntityValidationIssue {
+    entityId: string;
+    slug: string;
+    entityType: string;
+    label: string;
+    errors: ValidationError[];
+}
+/** A single relationship that failed vocabulary validation */
+interface RelationshipValidationIssue {
+    relationshipId: string;
+    relationshipType: string;
+    sourceEntityId: string;
+    targetEntityId: string;
+    /** Label of the source entity if it exists (aids human/AI diagnosis) */
+    sourceLabel?: string;
+    /** Label of the target entity if it exists */
+    targetLabel?: string;
+    /** Type of the source entity if it exists (for context on type-mismatch errors) */
+    sourceEntityType?: string;
+    /** Type of the target entity if it exists */
+    targetEntityType?: string;
+    errors: ValidationError[];
+}
+/** One page of entity validation results from RepositoryValidator.validateEntities() */
+interface EntityValidationPage {
+    issues: EntityValidationIssue[];
+    /** Number of entities inspected in this call (for diagnostics; not bounded by take) */
+    scanned: number;
+    /** Issue-offset to pass on the next call; equal to the input offset + issues.length */
+    nextOffset: number;
+    /** True when the export stream ended before take was hit (no further issues beyond this page) */
+    done: boolean;
+}
+/** One page of relationship validation results from RepositoryValidator.validateRelationships() */
+interface RelationshipValidationPage {
+    issues: RelationshipValidationIssue[];
+    /** Number of relationships inspected in this call (for diagnostics; not bounded by take) */
+    scanned: number;
+    /** Issue-offset to pass on the next call; equal to the input offset + issues.length */
+    nextOffset: number;
+    /** True when the export stream ended before take was hit (no further issues beyond this page) */
+    done: boolean;
+    /** Number of entities loaded into the resolution map (for diagnostics) */
+    entitiesInMap: number;
+}
+interface ValidateEntitiesOptions {
+    /** Number of issues to skip before returning (not entities); default 0 */
+    offset?: number;
+    /** Maximum number of issues to return in this call; default 200 */
+    take?: number;
+    /** Milliseconds to pause between export chunks (for manual rate limiting); default 0 */
+    delayBetweenChunksMs?: number;
+}
+interface ValidateRelationshipsOptions {
+    /** Number of issues to skip before returning (not relationships); default 0 */
+    offset?: number;
+    /** Maximum number of issues to return in this call; default 200 */
+    take?: number;
+    /** Milliseconds to pause between export chunks (for manual rate limiting); default 0 */
+    delayBetweenChunksMs?: number;
+}
 
 /** Manifest describing an exported repository archive */
 interface ExportManifest {
@@ -955,4 +1068,4 @@ interface ImportResult {
     warnings: ImportWarning[];
 }
 
-export type { TimelineResult as $, VocabularyProposal as A, BulkImportOptions as B, CreateEntityInput as C, DetailLevel as D, Entity as E, VocabularyProposalResult as F, GovernanceConfig as G, ProvenanceContext as H, ImportChunk as I, Provenance as J, FindEntitiesQuery as K, ReembedResult as L, MemoryVocabulary as M, Relationship as N, GraphResult as O, PropertyFilter as P, ExploreOptions as Q, RelationshipSummary as R, StorageRepositoryConfig as S, Neighborhood as T, UpdateEntityInput as U, VocabularyChangeRecord as V, PathOptions as W, PathResult as X, ConceptSearchOptions as Y, ScoredEntity as Z, TimelineOptions as _, EntitySummary as a, RepositoryConfig as a0, RepositorySummary as a1, ExportOptions as a2, ExportArchive as a3, ImportOptions as a4, ImportResult as a5, ExportStreamItem as a6, ImportStreamHeader as a7, SearchOptions as a8, SearchHit as a9, TimelineEvent as aA, TimelineRelationshipDetail as aB, VocabularyInput as aC, EnrichedRelationship as aa, EntityMap as ab, EntityTypeInput as ac, ExportLegalMetadata as ad, ExportManifest as ae, ExportPipelineMetadata as af, GetEntitiesOptions as ag, GetEntityOptions as ah, GovernanceMode as ai, ImportWarning as aj, NeighborhoodCenter as ak, NeighborhoodGroup as al, NeighborhoodLayer as am, Path as an, PropertySchema as ao, PropertyType as ap, ProvenanceFilter as aq, RelationshipDirection as ar, RelationshipTypeDefinition as as, RelationshipTypeInput as at, RepositoryMetadata as au, StorageNeighborhoodGroup as av, StorageNeighborhoodLayer as aw, StoragePath as ax, StorageTimelineEvent as ay, TimelineEntityRef 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, CreateRelationshipInput as y, EntityTypeDefinition 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, 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 };

package/dist/providers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/index.ts"],"sourcesContent":["// Provider interface re-exports — @utaba/deep-memory/providers\n\nexport type { StorageProvider, EnsureSchemaResult } from './StorageProvider.js';\nexport type { EmbeddingProvider } from './EmbeddingProvider.js';\nexport type {\n  SearchProvider,\n  SearchableEntity,\n} from './SearchProvider.js';\nexport type {\n  LockProvider,\n  LockOptions,\n  LockHandle,\n} from './LockProvider.js';\nexport type {\n  GraphTraversalProvider,\n  GraphTraversalCapabilities,\n} from './GraphTraversalProvider.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/providers/index.ts"],"sourcesContent":["// Provider interface re-exports — @utaba/deep-memory/providers\n\nexport type { StorageProvider, EnsureSchemaResult } from './StorageProvider.js';\nexport type { EmbeddingProvider, EmbeddingProviderFactory } from './EmbeddingProvider.js';\nexport type {\n  SearchProvider,\n  SearchableEntity,\n} from './SearchProvider.js';\nexport type {\n  LockProvider,\n  LockOptions,\n  LockHandle,\n} from './LockProvider.js';\nexport type {\n  GraphTraversalProvider,\n  GraphTraversalCapabilities,\n} from './GraphTraversalProvider.js';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/providers/index.d.cts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-CBhwqavV.cjs';
-import { a8 as SearchOptions, e as PaginatedResult, a9 as SearchHit } from '../portability-B-8J4nQQ.cjs';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-Llalk03r.cjs';
+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';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.
@@ -25,6 +25,19 @@ interface EmbeddingProvider {
      */
     similarity?(a: number[], b: number[]): number;
 }
+/**
+ * Factory that produces an EmbeddingProvider configured for a specific model + dimensionality.
+ *
+ * DeepMemory calls this once per repository when the repo is opened or created,
+ * using the repo's stored embedding metadata. Infrastructure concerns (base URL,
+ * API key) are captured in the factory closure; model + dimensions come from the
+ * repository itself, so different repositories can use different embedding
+ * configurations without any global state.
+ */
+type EmbeddingProviderFactory = (config: {
+    model: string;
+    dimensions: number;
+}) => EmbeddingProvider;
 
 /** Entity data indexed for full-text search */
 interface SearchableEntity {
@@ -139,4 +152,4 @@ interface GraphTraversalCapabilities {
     supportsRelationshipSummary: boolean;
 }
 
-export type { EmbeddingProvider, GraphTraversalCapabilities, GraphTraversalProvider, LockHandle, LockOptions, LockProvider, SearchProvider, SearchableEntity };
+export type { EmbeddingProvider, EmbeddingProviderFactory, GraphTraversalCapabilities, GraphTraversalProvider, LockHandle, LockOptions, LockProvider, SearchProvider, SearchableEntity };

package/dist/providers/index.d.ts

@@ -1,6 +1,6 @@
-export { E as EnsureSchemaResult, S as StorageProvider } from '../StorageProvider-ynfpc5wz.js';
-import { a8 as SearchOptions, e as PaginatedResult, a9 as SearchHit } from '../portability-B-8J4nQQ.js';
-import { T as TraversalSpec, a as TraversalResult } from '../traversal-BdmDLMxV.js';
+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';
 
 /**
  * EmbeddingProvider — enables semantic search and vocabulary deduplication.
@@ -25,6 +25,19 @@ interface EmbeddingProvider {
      */
     similarity?(a: number[], b: number[]): number;
 }
+/**
+ * Factory that produces an EmbeddingProvider configured for a specific model + dimensionality.
+ *
+ * DeepMemory calls this once per repository when the repo is opened or created,
+ * using the repo's stored embedding metadata. Infrastructure concerns (base URL,
+ * API key) are captured in the factory closure; model + dimensions come from the
+ * repository itself, so different repositories can use different embedding
+ * configurations without any global state.
+ */
+type EmbeddingProviderFactory = (config: {
+    model: string;
+    dimensions: number;
+}) => EmbeddingProvider;
 
 /** Entity data indexed for full-text search */
 interface SearchableEntity {
@@ -139,4 +152,4 @@ interface GraphTraversalCapabilities {
     supportsRelationshipSummary: boolean;
 }
 
-export type { EmbeddingProvider, GraphTraversalCapabilities, GraphTraversalProvider, LockHandle, LockOptions, LockProvider, SearchProvider, SearchableEntity };
+export type { EmbeddingProvider, EmbeddingProviderFactory, GraphTraversalCapabilities, GraphTraversalProvider, LockHandle, LockOptions, LockProvider, SearchProvider, SearchableEntity };

package/dist/testing/conformance.cjs

@@ -174,6 +174,42 @@ function runStorageProviderConformanceTests(factory) {
         const fetched = await provider.getEntity(repoId, "e1");
         (0, import_vitest.expect)(fetched.label).toBe("Updated Label");
       });
+      (0, import_vitest.it)("clears summary/data/dataFormat when null is passed", async () => {
+        const entity = {
+          ...makeEntity("e1"),
+          summary: "starting summary",
+          data: "raw content",
+          dataFormat: "text/plain"
+        };
+        await provider.createEntity(repoId, entity);
+        await provider.updateEntity(repoId, "e1", {
+          summary: null,
+          data: null,
+          dataFormat: null,
+          provenance: makeProvenance()
+        });
+        const fetched = await provider.getEntity(repoId, "e1");
+        (0, import_vitest.expect)(fetched.summary).toBeUndefined();
+        (0, import_vitest.expect)(fetched.data).toBeUndefined();
+        (0, import_vitest.expect)(fetched.dataFormat).toBeUndefined();
+      });
+      (0, import_vitest.it)("preserves summary/data/dataFormat when undefined is passed", async () => {
+        const entity = {
+          ...makeEntity("e1"),
+          summary: "keep me",
+          data: "keep me too",
+          dataFormat: "text/plain"
+        };
+        await provider.createEntity(repoId, entity);
+        await provider.updateEntity(repoId, "e1", {
+          label: "Renamed",
+          provenance: makeProvenance()
+        });
+        const fetched = await provider.getEntity(repoId, "e1");
+        (0, import_vitest.expect)(fetched.summary).toBe("keep me");
+        (0, import_vitest.expect)(fetched.data).toBe("keep me too");
+        (0, import_vitest.expect)(fetched.dataFormat).toBe("text/plain");
+      });
       (0, import_vitest.it)("deletes an entity", async () => {
         await provider.createEntity(repoId, makeEntity("e1"));
         await provider.deleteEntity(repoId, "e1");