dsh-mnemon-source-memory-spaces 0.5.21 → 0.5.22

package/lib/contracts.d.ts

@@ -1,6 +1,17 @@
 import { MemoryJsonValue as JsonValue, MemoryReadGrant } from "dsh-mnemon/contracts";
 //#region src/contracts.d.ts
 type MemoryProviderId = string;
+/**
+ * The Mnemon Native Provider's id. Its package names its descriptor and driver
+ * with it, the Starter installs it under it, and a stored space that names no
+ * Provider belongs to it.
+ */
+declare const NATIVE_PROVIDER_ID = "mnemon-native";
+/** Whether a Provider is Mnemon Native: by its implementation type, else by its id. */
+declare function isNativeProvider(provider: {
+  readonly id: MemoryProviderId;
+  readonly typeId?: string | undefined;
+}): boolean;
 type MemoryProviderConnectionValue = string | number | boolean;
 type MemoryProviderConnection = Record<string, MemoryProviderConnectionValue>;
 interface MemoryProviderIcon {
@@ -38,7 +49,9 @@ interface MemoryProviderConfigField {
   discoveryDefaultFrom?: string;
   options?: MemoryProviderConfigOption[];
 }
-type MemoryPlacementCapability = 'graph' | 'entities' | 'related' | 'exact-write' | 'link' | 'forget';
+/** What a persistence strategy's rules can require of a Provider; the Starter's settings schema takes the same list. */
+declare const MEMORY_PLACEMENT_CAPABILITIES: readonly ["graph", "entities", "related", "exact-write", "link", "forget"];
+type MemoryPlacementCapability = (typeof MEMORY_PLACEMENT_CAPABILITIES)[number];
 type MemoryPlacementPreference = 'balanced' | 'local-first' | 'shared-first';
 interface MemoryPlacementRules {
   allowedProviderIds?: MemoryProviderId[];
@@ -567,6 +580,11 @@ interface MemorySpacesStatus {
   timeoutMs: number;
   defaultRecallLimit: number;
   recallQuality: ResolvedRecallQualityConfig;
+  /**
+   * Whether DSH manages Mnemon Native's embedding settings (`embedding.enabled`). While it does
+   * not, Mnemon keeps the Host environment and its own defaults. Memory Spaces 0.5.21 and earlier omit it.
+   */
+  embeddingManaged?: boolean;
   memoryBodyDirectory: string;
   memoryBodies: MemorySpaceView[];
   providerServices?: MemoryProviderRuntimeStatus[];
@@ -609,6 +627,64 @@ interface EntityRelatedView {
   items: Insight[];
   sources: MemoryReadSource[];
 }
+/** The directory under a storage root that holds Mnemon's stores, one per Native space, and their registry. */
+declare const MEMORY_SPACES_DIRECTORY = "data";
+/** The registry of Native spaces. The published v1 name and its `bodies` key stay for existing stores and Packs. */
+declare const MEMORY_SPACE_REGISTRY_FILE = ".dsh-memory-bodies.json";
+/** A Native space's Mnemon store, in the directory its space id names. */
+declare const MEMORY_SPACE_DATABASE_FILE = "mnemon.db";
+/** A space id, which also names its store's directory. */
+declare const MEMORY_SPACE_ID_PATTERN: RegExp;
+/** The most characters a space's name holds. */
+declare const MEMORY_SPACE_NAME_MAX_LENGTH = 100;
+/** The most characters a space's routing description holds. */
+declare const MEMORY_SPACE_DESCRIPTION_MAX_LENGTH = 1000;
+/** Mnemon's own record of its default store, one space id, at the storage root. */
+declare const MNEMON_ACTIVE_STORE_FILE = "active";
+/** Third-party Provider services and the spaces they serve, in the storage root's `state` directory. No Pack carries it. */
+declare const MEMORY_PROVIDER_REGISTRY_FILE = "memory-providers.json";
+/** One Native space as a copy of the registry, such as a Mnemon Pack, carries it. */
+interface MemorySpaceRegistryEntry {
+  id: string;
+  name: string;
+  description: string;
+  active: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+interface MemorySpaceRegistryFile {
+  version: 1;
+  bodies: MemorySpaceRegistryEntry[];
+}
+/**
+ * Read a registry as a copy of it carries it: each id unique and usable as a directory name,
+ * every name, description and time present, or the whole registry is refused. Only the fields of
+ * the entry above are kept, so a copy holds nothing else, and a registry written back from one
+ * no longer holds what else an entry recorded, such as a Native space's `placement` decision or
+ * `metadataSource`.
+ */
+declare function parseMemorySpaceRegistry(value: unknown): MemorySpaceRegistryFile;
+/** What a stored registry holds, counted without judging each space. */
+interface MemorySpaceRegistrySummary {
+  /** Whether it is the version 1 registry this Source writes; a legacy version 2 file, migrated when the Source next loads it, is not. */
+  valid: boolean;
+  /** Every listed space that is an object, whichever version lists it. */
+  spaces: number;
+  active: number;
+}
+/** Count the spaces of a parsed registry for a read-only inventory. It never throws. */
+declare function summarizeMemorySpaceRegistry(value: unknown): MemorySpaceRegistrySummary;
+/** What a stored Provider registry holds, counted without judging each entry. */
+interface MemoryProviderRegistrySummary {
+  /** Whether the file is an object at all. Without one, every count is 0. */
+  valid: boolean;
+  /** Provider services with saved settings, enabled or not. */
+  services: number;
+  /** Spaces a third-party Provider serves: every entry of the list, well-formed or not. */
+  connections: number;
+}
+/** Count a parsed Provider registry for a read-only inventory. It never throws. */
+declare function summarizeMemoryProviderRegistry(value: unknown): MemoryProviderRegistrySummary;
 /** @deprecated Use CreateMemorySpaceRequest. The wire shape is unchanged. */
 type CreateMemoryBodyRequest = CreateMemorySpaceRequest;
 /** @deprecated Use UpdateMemorySpaceRequest. The wire shape is unchanged. */
@@ -632,4 +708,4 @@ type MemoryBodyView = MemorySpaceView;
 /** @deprecated Use OpenVikingSpaceConnection. The wire shape is unchanged. */
 type OpenVikingBodyConnection = OpenVikingSpaceConnection;
 //#endregion
-export { AutomaticMemoryPlacementRequest, CATEGORIES, Category, CreateMemoryBodyRequest, CreateMemorySpaceRequest, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, EdgeType, EntityMemoriesView, EntityRelatedView, EntityView, INTENTS, Insight, Intent, type JsonValue, LlmMemoryPlacementSelection, MNEMON_EMBEDDING_PROTOCOLS, MemoryBody, MemoryBodyCatalog, MemoryBodyMetadataMaintenanceResult, MemoryBodyMetadataSample, MemoryBodyMetadataUpdate, MemoryBodyProvider, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryPersistenceStrategy, MemoryPlacementCandidate, MemoryPlacementCapability, MemoryPlacementDecision, MemoryPlacementPreference, MemoryPlacementRules, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemoryProviderRuntimeStatus, MemoryProviderServiceCatalog, MemoryProviderServiceView, MemoryReadMode, MemoryReadSource, MemoryReadStatus, MemorySpace, MemorySpaceCatalog, MemorySpaceMetadataMaintenanceResult, MemorySpaceMetadataSample, MemorySpaceMetadataUpdate, MemorySpaceProvider, MemorySpaceRediscovery, MemorySpaceRediscoveryResult, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingFill, MnemonEmbeddingProtocol, MnemonEmbeddingSpaceStatus, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest, normalizeEntityKey };
+export { AutomaticMemoryPlacementRequest, CATEGORIES, Category, CreateMemoryBodyRequest, CreateMemorySpaceRequest, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, EdgeType, EntityMemoriesView, EntityRelatedView, EntityView, INTENTS, Insight, Intent, type JsonValue, LlmMemoryPlacementSelection, MEMORY_PLACEMENT_CAPABILITIES, MEMORY_PROVIDER_REGISTRY_FILE, MEMORY_SPACES_DIRECTORY, MEMORY_SPACE_DATABASE_FILE, MEMORY_SPACE_DESCRIPTION_MAX_LENGTH, MEMORY_SPACE_ID_PATTERN, MEMORY_SPACE_NAME_MAX_LENGTH, MEMORY_SPACE_REGISTRY_FILE, MNEMON_ACTIVE_STORE_FILE, MNEMON_EMBEDDING_PROTOCOLS, MemoryBody, MemoryBodyCatalog, MemoryBodyMetadataMaintenanceResult, MemoryBodyMetadataSample, MemoryBodyMetadataUpdate, MemoryBodyProvider, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryPersistenceStrategy, MemoryPlacementCandidate, MemoryPlacementCapability, MemoryPlacementDecision, MemoryPlacementPreference, MemoryPlacementRules, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemoryProviderRegistrySummary, MemoryProviderRuntimeStatus, MemoryProviderServiceCatalog, MemoryProviderServiceView, MemoryReadMode, MemoryReadSource, MemoryReadStatus, MemorySpace, MemorySpaceCatalog, MemorySpaceMetadataMaintenanceResult, MemorySpaceMetadataSample, MemorySpaceMetadataUpdate, MemorySpaceProvider, MemorySpaceRediscovery, MemorySpaceRediscoveryResult, MemorySpaceRegistryEntry, MemorySpaceRegistryFile, MemorySpaceRegistrySummary, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingFill, MnemonEmbeddingProtocol, MnemonEmbeddingSpaceStatus, MnemonEmbeddingStatus, NATIVE_PROVIDER_ID, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest, isNativeProvider, normalizeEntityKey, parseMemorySpaceRegistry, summarizeMemoryProviderRegistry, summarizeMemorySpaceRegistry };

package/lib/contracts.js

@@ -1,4 +1,23 @@
 //#region src/contracts.ts
+/**
+* The Mnemon Native Provider's id. Its package names its descriptor and driver
+* with it, the Starter installs it under it, and a stored space that names no
+* Provider belongs to it.
+*/
+const NATIVE_PROVIDER_ID = "mnemon-native";
+/** Whether a Provider is Mnemon Native: by its implementation type, else by its id. */
+function isNativeProvider(provider) {
+	return (provider.typeId ?? provider.id) === NATIVE_PROVIDER_ID;
+}
+/** What a persistence strategy's rules can require of a Provider; the Starter's settings schema takes the same list. */
+const MEMORY_PLACEMENT_CAPABILITIES = [
+	"graph",
+	"entities",
+	"related",
+	"exact-write",
+	"link",
+	"forget"
+];
 const CATEGORIES = [
 	"preference",
 	"decision",
@@ -44,5 +63,76 @@ const MNEMON_EMBEDDING_PROTOCOLS = [
 	EMBEDDING_PROTOCOL_OLLAMA,
 	EMBEDDING_PROTOCOL_OPENAI
 ];
+/** The directory under a storage root that holds Mnemon's stores, one per Native space, and their registry. */
+const MEMORY_SPACES_DIRECTORY = "data";
+/** The registry of Native spaces. The published v1 name and its `bodies` key stay for existing stores and Packs. */
+const MEMORY_SPACE_REGISTRY_FILE = ".dsh-memory-bodies.json";
+/** A Native space's Mnemon store, in the directory its space id names. */
+const MEMORY_SPACE_DATABASE_FILE = "mnemon.db";
+/** A space id, which also names its store's directory. */
+const MEMORY_SPACE_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+/** The most characters a space's name holds. */
+const MEMORY_SPACE_NAME_MAX_LENGTH = 100;
+/** The most characters a space's routing description holds. */
+const MEMORY_SPACE_DESCRIPTION_MAX_LENGTH = 1e3;
+/** Mnemon's own record of its default store, one space id, at the storage root. */
+const MNEMON_ACTIVE_STORE_FILE = "active";
+/** Third-party Provider services and the spaces they serve, in the storage root's `state` directory. No Pack carries it. */
+const MEMORY_PROVIDER_REGISTRY_FILE = "memory-providers.json";
+function isObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Read a registry as a copy of it carries it: each id unique and usable as a directory name,
+* every name, description and time present, or the whole registry is refused. Only the fields of
+* the entry above are kept, so a copy holds nothing else, and a registry written back from one
+* no longer holds what else an entry recorded, such as a Native space's `placement` decision or
+* `metadataSource`.
+*/
+function parseMemorySpaceRegistry(value) {
+	const registry = isObject(value) ? value : void 0;
+	if (registry?.version !== 1 || !Array.isArray(registry.bodies)) throw new Error("Memory Space registry is invalid");
+	const ids = /* @__PURE__ */ new Set();
+	return {
+		version: 1,
+		bodies: registry.bodies.map((raw) => {
+			const body = isObject(raw) ? raw : void 0;
+			if (typeof body?.id !== "string" || !MEMORY_SPACE_ID_PATTERN.test(body.id) || ids.has(body.id)) throw new Error("Memory Space registry contains an invalid or duplicate id");
+			if (typeof body.name !== "string" || body.name.trim() === "" || body.name.length > 100 || typeof body.description !== "string" || body.description.length > 1e3) throw new Error("Memory Space registry contains invalid metadata");
+			if (typeof body.createdAt !== "string" || typeof body.updatedAt !== "string") throw new Error("Memory Space registry contains invalid timestamps");
+			ids.add(body.id);
+			return {
+				id: body.id,
+				name: body.name,
+				description: body.description,
+				active: body.active === true,
+				createdAt: body.createdAt,
+				updatedAt: body.updatedAt
+			};
+		})
+	};
+}
+/** Count the spaces of a parsed registry for a read-only inventory. It never throws. */
+function summarizeMemorySpaceRegistry(value) {
+	const registry = isObject(value) ? value : void 0;
+	const listed = registry?.bodies;
+	const spaces = Array.isArray(listed) ? listed.filter(isObject) : [];
+	return {
+		valid: registry?.version === 1 && Array.isArray(listed),
+		spaces: spaces.length,
+		active: spaces.filter((space) => space.active === true).length
+	};
+}
+/** Count a parsed Provider registry for a read-only inventory. It never throws. */
+function summarizeMemoryProviderRegistry(value) {
+	const registry = isObject(value) ? value : void 0;
+	const services = registry?.services;
+	const listed = registry?.bodies;
+	return {
+		valid: registry !== void 0,
+		services: isObject(services) ? Object.keys(services).length : 0,
+		connections: Array.isArray(listed) ? listed.length : 0
+	};
+}
 //#endregion
-export { CATEGORIES, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, INTENTS, MNEMON_EMBEDDING_PROTOCOLS, SOURCES, normalizeEntityKey };
+export { CATEGORIES, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, INTENTS, MEMORY_PLACEMENT_CAPABILITIES, MEMORY_PROVIDER_REGISTRY_FILE, MEMORY_SPACES_DIRECTORY, MEMORY_SPACE_DATABASE_FILE, MEMORY_SPACE_DESCRIPTION_MAX_LENGTH, MEMORY_SPACE_ID_PATTERN, MEMORY_SPACE_NAME_MAX_LENGTH, MEMORY_SPACE_REGISTRY_FILE, MNEMON_ACTIVE_STORE_FILE, MNEMON_EMBEDDING_PROTOCOLS, NATIVE_PROVIDER_ID, SOURCES, isNativeProvider, normalizeEntityKey, parseMemorySpaceRegistry, summarizeMemoryProviderRegistry, summarizeMemorySpaceRegistry };

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { AutomaticMemoryPlacementRequest, CATEGORIES, Category, CreateMemoryBodyRequest, CreateMemorySpaceRequest, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, EdgeType, EntityMemoriesView, EntityRelatedView, EntityView, INTENTS, Insight, Intent, JsonValue, LlmMemoryPlacementSelection, MNEMON_EMBEDDING_PROTOCOLS, MemoryBody, MemoryBodyCatalog, MemoryBodyMetadataMaintenanceResult, MemoryBodyMetadataSample, MemoryBodyMetadataUpdate, MemoryBodyProvider, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryPersistenceStrategy, MemoryPlacementCandidate, MemoryPlacementCapability, MemoryPlacementDecision, MemoryPlacementPreference, MemoryPlacementRules, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemoryProviderRuntimeStatus, MemoryProviderServiceCatalog, MemoryProviderServiceView, MemoryReadMode, MemoryReadSource, MemoryReadStatus, MemorySpace, MemorySpaceCatalog, MemorySpaceMetadataMaintenanceResult, MemorySpaceMetadataSample, MemorySpaceMetadataUpdate, MemorySpaceProvider, MemorySpaceRediscovery, MemorySpaceRediscoveryResult, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingFill, MnemonEmbeddingProtocol, MnemonEmbeddingSpaceStatus, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest, normalizeEntityKey } from "./contracts.js";
+import { AutomaticMemoryPlacementRequest, CATEGORIES, Category, CreateMemoryBodyRequest, CreateMemorySpaceRequest, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, EdgeType, EntityMemoriesView, EntityRelatedView, EntityView, INTENTS, Insight, Intent, JsonValue, LlmMemoryPlacementSelection, MEMORY_PLACEMENT_CAPABILITIES, MEMORY_PROVIDER_REGISTRY_FILE, MEMORY_SPACES_DIRECTORY, MEMORY_SPACE_DATABASE_FILE, MEMORY_SPACE_DESCRIPTION_MAX_LENGTH, MEMORY_SPACE_ID_PATTERN, MEMORY_SPACE_NAME_MAX_LENGTH, MEMORY_SPACE_REGISTRY_FILE, MNEMON_ACTIVE_STORE_FILE, MNEMON_EMBEDDING_PROTOCOLS, MemoryBody, MemoryBodyCatalog, MemoryBodyMetadataMaintenanceResult, MemoryBodyMetadataSample, MemoryBodyMetadataUpdate, MemoryBodyProvider, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryPersistenceStrategy, MemoryPlacementCandidate, MemoryPlacementCapability, MemoryPlacementDecision, MemoryPlacementPreference, MemoryPlacementRules, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemoryProviderRegistrySummary, MemoryProviderRuntimeStatus, MemoryProviderServiceCatalog, MemoryProviderServiceView, MemoryReadMode, MemoryReadSource, MemoryReadStatus, MemorySpace, MemorySpaceCatalog, MemorySpaceMetadataMaintenanceResult, MemorySpaceMetadataSample, MemorySpaceMetadataUpdate, MemorySpaceProvider, MemorySpaceRediscovery, MemorySpaceRediscoveryResult, MemorySpaceRegistryEntry, MemorySpaceRegistryFile, MemorySpaceRegistrySummary, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingFill, MnemonEmbeddingProtocol, MnemonEmbeddingSpaceStatus, MnemonEmbeddingStatus, NATIVE_PROVIDER_ID, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest, isNativeProvider, normalizeEntityKey, parseMemorySpaceRegistry, summarizeMemoryProviderRegistry, summarizeMemorySpaceRegistry } from "./contracts.js";
 import { i as MemorySpaceProviderEntry } from "./definitions-CtjNSwBS.js";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
@@ -59,4 +59,4 @@ declare function resolveMemorySpaceProviderEntries(ctx: Context, declarations: r
 declare function installMemorySpaces(ctx: Context, entries: readonly MemorySpaceProviderEntry[], options?: InstallMemorySpacesOptions): Promise<void>;
 declare function apply(ctx: Context, config?: Config): Promise<void>;
 //#endregion
-export { type AutomaticMemoryPlacementRequest, type CATEGORIES, type Category, Config, type CreateMemoryBodyRequest, type CreateMemorySpaceRequest, type DEFAULT_EMBEDDING_ENDPOINT, type DEFAULT_EMBEDDING_MODEL, type DEFAULT_EMBEDDING_PROTOCOL, type EDGE_TYPES, type EMBEDDING_PROTOCOL_AUTO, type EMBEDDING_PROTOCOL_OLLAMA, type EMBEDDING_PROTOCOL_OPENAI, type EdgeType, type EntityMemoriesView, type EntityRelatedView, type EntityView, type INTENTS, type Insight, InstallMemorySpacesOptions, type Intent, type JsonValue, type LlmMemoryPlacementSelection, type MNEMON_EMBEDDING_PROTOCOLS, type MemoryBody, type MemoryBodyCatalog, type MemoryBodyMetadataMaintenanceResult, type MemoryBodyMetadataSample, type MemoryBodyMetadataUpdate, type MemoryBodyProvider, type MemoryBodyStats, type MemoryBodyView, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MemoryPersistenceStrategy, type MemoryPlacementCandidate, type MemoryPlacementCapability, type MemoryPlacementDecision, type MemoryPlacementPreference, type MemoryPlacementRules, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, type MemoryProviderRuntimeStatus, type MemoryProviderServiceCatalog, type MemoryProviderServiceView, type MemoryReadMode, type MemoryReadSource, type MemoryReadStatus, type MemorySpace, type MemorySpaceCatalog, type MemorySpaceMetadataMaintenanceResult, type MemorySpaceMetadataSample, type MemorySpaceMetadataUpdate, type MemorySpaceProvider, MemorySpaceProviderDeclaration, MemorySpaceProviderDeclarationSchema, type MemorySpaceRediscovery, type MemorySpaceRediscoveryResult, type MemorySpaceStats, type MemorySpaceView, type MemorySpaceWriteScope, type MemorySpaceWriteScopeRequest, type MemorySpacesStatus, type MnemonEmbeddingConfig, type MnemonEmbeddingFill, type MnemonEmbeddingProtocol, type MnemonEmbeddingSpaceStatus, type MnemonEmbeddingStatus, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, type PreparedMemoryPlacement, type RecallQualityConfig, type RecallQualityStats, type RecallRelevanceTier, type RememberRequest, type ResolvedMemoryPersistenceStrategy, type ResolvedMnemonEmbeddingConfig, type ResolvedRecallQualityConfig, type SOURCES, type SearchRequest, type Source, type UpdateMemoryBodyRequest, type UpdateMemoryProviderServiceRequest, type UpdateMemorySpaceRequest, apply, inject, installMemorySpaces, memoryPlugin, name, type normalizeEntityKey, resolveEmbedding, resolveMemorySpaceProviderEntries, resolvePersistenceStrategy, resolveRecallQuality };
+export { type AutomaticMemoryPlacementRequest, type CATEGORIES, type Category, Config, type CreateMemoryBodyRequest, type CreateMemorySpaceRequest, type DEFAULT_EMBEDDING_ENDPOINT, type DEFAULT_EMBEDDING_MODEL, type DEFAULT_EMBEDDING_PROTOCOL, type EDGE_TYPES, type EMBEDDING_PROTOCOL_AUTO, type EMBEDDING_PROTOCOL_OLLAMA, type EMBEDDING_PROTOCOL_OPENAI, type EdgeType, type EntityMemoriesView, type EntityRelatedView, type EntityView, type INTENTS, type Insight, InstallMemorySpacesOptions, type Intent, type JsonValue, type LlmMemoryPlacementSelection, type MEMORY_PLACEMENT_CAPABILITIES, type MEMORY_PROVIDER_REGISTRY_FILE, type MEMORY_SPACES_DIRECTORY, type MEMORY_SPACE_DATABASE_FILE, type MEMORY_SPACE_DESCRIPTION_MAX_LENGTH, type MEMORY_SPACE_ID_PATTERN, type MEMORY_SPACE_NAME_MAX_LENGTH, type MEMORY_SPACE_REGISTRY_FILE, type MNEMON_ACTIVE_STORE_FILE, type MNEMON_EMBEDDING_PROTOCOLS, type MemoryBody, type MemoryBodyCatalog, type MemoryBodyMetadataMaintenanceResult, type MemoryBodyMetadataSample, type MemoryBodyMetadataUpdate, type MemoryBodyProvider, type MemoryBodyStats, type MemoryBodyView, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MemoryPersistenceStrategy, type MemoryPlacementCandidate, type MemoryPlacementCapability, type MemoryPlacementDecision, type MemoryPlacementPreference, type MemoryPlacementRules, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, type MemoryProviderRegistrySummary, type MemoryProviderRuntimeStatus, type MemoryProviderServiceCatalog, type MemoryProviderServiceView, type MemoryReadMode, type MemoryReadSource, type MemoryReadStatus, type MemorySpace, type MemorySpaceCatalog, type MemorySpaceMetadataMaintenanceResult, type MemorySpaceMetadataSample, type MemorySpaceMetadataUpdate, type MemorySpaceProvider, MemorySpaceProviderDeclaration, MemorySpaceProviderDeclarationSchema, type MemorySpaceRediscovery, type MemorySpaceRediscoveryResult, type MemorySpaceRegistryEntry, type MemorySpaceRegistryFile, type MemorySpaceRegistrySummary, type MemorySpaceStats, type MemorySpaceView, type MemorySpaceWriteScope, type MemorySpaceWriteScopeRequest, type MemorySpacesStatus, type MnemonEmbeddingConfig, type MnemonEmbeddingFill, type MnemonEmbeddingProtocol, type MnemonEmbeddingSpaceStatus, type MnemonEmbeddingStatus, type NATIVE_PROVIDER_ID, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, type PreparedMemoryPlacement, type RecallQualityConfig, type RecallQualityStats, type RecallRelevanceTier, type RememberRequest, type ResolvedMemoryPersistenceStrategy, type ResolvedMnemonEmbeddingConfig, type ResolvedRecallQualityConfig, type SOURCES, type SearchRequest, type Source, type UpdateMemoryBodyRequest, type UpdateMemoryProviderServiceRequest, type UpdateMemorySpaceRequest, apply, inject, installMemorySpaces, type isNativeProvider, memoryPlugin, name, type normalizeEntityKey, type parseMemorySpaceRegistry, resolveEmbedding, resolveMemorySpaceProviderEntries, resolvePersistenceStrategy, resolveRecallQuality, type summarizeMemoryProviderRegistry, type summarizeMemorySpaceRegistry };