dsh-mnemon-source-memory-spaces 0.5.16 → 0.5.17

package/lib/client.js

@@ -4476,7 +4476,10 @@ window.__ModuleLoader__.load({
 					limit,
 					view
 				})),
-				search: (request) => client.read("search", input(request)),
+				search: (request) => client.read("search", input({
+					...request,
+					inspect: true
+				})),
 				related: (id, memoryBodyId) => client.read("related", input({
 					id,
 					memoryBodyId

package/lib/contracts.d.ts

@@ -272,6 +272,13 @@ interface SearchRequest {
   source?: Source;
   intent?: Intent;
   memoryBodyIds?: string[];
+  /**
+   * A look at the memory rather than a use of it, such as the Memory System's
+   * own searches. Providers that record reads, as access counts or a query
+   * log, leave it out, and may answer from a snapshot that lags a write still
+   * in flight; a check that must see a write leaves the flag unset.
+   */
+  inspect?: boolean;
 }
 interface RememberRequest {
   content: string;

package/lib/{definitions-BcYzE092.d.ts → definitions-CtjNSwBS.d.ts}

@@ -92,6 +92,12 @@ interface MemoryProviderAdapter {
   entityIndex?(body: MemorySpace, signal?: AbortSignal): Promise<ProviderEntityIndex>;
   /** Persist an ordered host-authorized batch and return one receipt per request. */
   rememberMany?(body: MemorySpace, requests: readonly RememberRequest[], signal?: AbortSignal): Promise<JsonValue[]>;
+  /**
+   * Optional exact read: the memory this space holds under `id`, or undefined
+   * when it holds none. With it an action can name a memory by id that the
+   * current View has not returned, such as an Agent forgetting what it wrote.
+   */
+  get?(body: MemorySpace, id: string, signal?: AbortSignal): Promise<Insight | undefined>;
   related?(body: MemorySpace, id: string, depth: number, edge?: EdgeType, signal?: AbortSignal): Promise<Insight[]>;
   link?(body: MemorySpace, sourceId: string, targetId: string, type: EdgeType, weight: number, reason?: string, signal?: AbortSignal): Promise<JsonValue>;
   forget?(body: MemorySpace, id: string, signal?: AbortSignal): Promise<JsonValue>;

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 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, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingProtocol, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest, normalizeEntityKey } from "./contracts.js";
-import { i as MemorySpaceProviderEntry } from "./definitions-BcYzE092.js";
+import { i as MemorySpaceProviderEntry } from "./definitions-CtjNSwBS.js";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts

package/lib/index.js

@@ -45,8 +45,11 @@ function modelStatus(status) {
 	const unhealthy = active.filter((body) => !body.healthy);
 	const relevantProviders = status.providerServices?.filter((provider) => provider.enabled || provider.configured || provider.memoryBodyCount > 0 || provider.status === "unhealthy") ?? [];
 	const providers = relevantProviders.slice(0, 16);
+	const providerReady = status.commandFound === true || (status.providerServices ?? []).some((provider) => provider.enabled && provider.configured);
+	const notice = status.memoryBodies.length > 0 ? void 0 : providerReady ? "No Memory Space exists yet, so durable memory has nowhere to go and a full MEMORY.md archives to a local file. Create and activate a Memory Space to keep durable memory." : "No Memory Space exists, and none can be created until a memory Provider is ready, so durable memory has nowhere to go and a full MEMORY.md archives to a local file. Install the Mnemon CLI for Mnemon Native, or connect another Provider on the dsh-mnemon page under Plugins, then create and activate a Memory Space.";
 	return {
 		healthy: status.healthy && unhealthy.length === 0,
+		...notice === void 0 ? {} : { notice },
 		...status.error === void 0 ? {} : { error: boundedToolText(status.error, 1e3) },
 		...status.version === void 0 ? {} : { version: boundedToolText(status.version, 120) },
 		commandFound: status.commandFound,
@@ -1633,7 +1636,8 @@ var MemorySpacesService = class {
 		const all = this.memorySpaces.list();
 		const serviceItems = this.memorySpaces.providerServices().items;
 		const enabled = new Set(serviceItems.filter((service) => service.enabled).map((service) => service.providerId));
-		const active = all.filter((body) => body.active && (this.isNativeSpace(body) || enabled.has(body.provider.id))).sort((left, right) => left.id.localeCompare(right.id));
+		const commandFound = this.runner.commandFound;
+		const active = all.filter((body) => body.active && (this.isNativeSpace(body) ? commandFound : enabled.has(body.provider.id))).sort((left, right) => left.id.localeCompare(right.id));
 		const spaces = [...all].sort((left, right) => left.id.localeCompare(right.id)).map((body) => ({
 			id: body.id,
 			name: body.name,
@@ -1648,13 +1652,16 @@ var MemorySpacesService = class {
 			enabled: service.enabled,
 			configured: service.configured
 		})).sort((left, right) => left.providerId.localeCompare(right.providerId));
+		const revision = createHash("sha256").update(JSON.stringify({
+			bodies: spaces,
+			services,
+			...commandFound ? {} : { nativeUnavailable: true }
+		})).digest("hex");
 		return {
 			all,
 			active,
-			revision: createHash("sha256").update(JSON.stringify({
-				bodies: spaces,
-				services
-			})).digest("hex")
+			providerReady: this.memorySpaces.defaultProviderId() !== void 0,
+			revision
 		};
 	}
 	/** Return a usable system snapshot without waiting for any Provider I/O. */
@@ -1842,7 +1849,8 @@ var MemorySpacesService = class {
 			limit: preparedPolicy.candidateLimit,
 			...category === void 0 ? {} : { category },
 			...source === void 0 ? {} : { source },
-			...intent === void 0 ? {} : { intent }
+			...intent === void 0 ? {} : { intent },
+			...request.inspect === true ? { inspect: true } : {}
 		};
 		let batches = await Promise.all(spaces.map(async (body) => {
 			if (!body.provider.capabilities.search) return {
@@ -1906,7 +1914,8 @@ var MemorySpacesService = class {
 					const recovered = await this.providerFor(batch.body).search(batch.body, {
 						query: recoveryPlan.query,
 						mode: "keyword",
-						limit: Math.min(limit, preparedPolicy.candidateLimit)
+						limit: Math.min(limit, preparedPolicy.candidateLimit),
+						...request.inspect === true ? { inspect: true } : {}
 					}, signal);
 					const admitted = recovered.results.some((insight) => recoveryMatchCount(insight.content, recoveryPlan) >= recoveryPlan.requiredMatches);
 					const results = mergeRecoveryResults(batch.result.results, recovered.results, recoveryPlan, preparedPolicy.candidateLimit);
@@ -2197,7 +2206,8 @@ var MemorySpacesService = class {
 				query: selected,
 				intent: "ENTITY",
 				limit: memoryInputInteger(limit, 20, 1, 50),
-				memoryBodyIds: readableIds
+				memoryBodyIds: readableIds,
+				inspect: true
 			}, combined, { exclude: carrying });
 			combined?.throwIfAborted();
 			return {
@@ -2394,6 +2404,24 @@ var MemorySpacesService = class {
 		}
 		return results;
 	}
+	/**
+	* The memories held under an exact id among the given spaces that can be
+	* read now, asked of the Providers that can look ids up.
+	*/
+	async locate(id, memoryBodyIds, signal) {
+		const exact = required(id, "id", 2e3);
+		const readable = new Map(this.memorySpaces.active().filter((body) => this.isNativeSpace(body) || this.memorySpaces.providerServiceEnabled(body.provider.id)).map((body) => [body.id, body]));
+		const found = [];
+		for (const memoryBodyId of new Set(memoryBodyIds)) {
+			const body = readable.get(memoryBodyId);
+			if (body === void 0) continue;
+			const provider = this.providerFor(body);
+			if (provider.get === void 0) continue;
+			const insight = await provider.get(body, exact, signal);
+			if (insight !== void 0 && insight.id === exact) found.push(this.annotate(insight, body));
+		}
+		return found;
+	}
 	async related(id, depth = 2, edge, signal, memoryBodyId) {
 		const body = this.readSpace(memoryBodyId);
 		const selectedEdge = allowed(edge, EDGE_TYPES, "edge");
@@ -2700,7 +2728,9 @@ const EMBEDDING_ENVIRONMENT_KEYS = /* @__PURE__ */ new Set([
 function processFailureMessage(error, args) {
 	const detail = error instanceof Error ? error.message : String(error);
 	const reason = error instanceof ProcessError ? error.reason : "launch";
-	if (reason === "output-limit") return `mnemon ${args.find((arg) => !arg.startsWith("-")) ?? "command"} stopped: ${detail.replace(/^mnemon /u, "")}`;
+	const command = args.find((arg) => !arg.startsWith("-"));
+	if (reason === "output-limit") return `mnemon ${command ?? "command"} stopped: ${detail.replace(/^mnemon /u, "")}`;
+	if (reason === "timeout" && command !== void 0) return detail.replace(/^mnemon /u, `mnemon ${command} `);
 	if (reason !== "launch") return detail;
 	return `${detail}. ${process.platform === "win32" ? "Install the official Mnemon Windows release, ensure mnemon.exe is on PATH or under %LOCALAPPDATA%\\Programs\\mnemon, or set MNEMON_CLI_PATH or mnemon.cliPath to its absolute path." : "Install Mnemon and ensure \"mnemon\" is on PATH, or set MNEMON_CLI_PATH or mnemon.cliPath."}`;
 }
@@ -3075,7 +3105,8 @@ async function manageMemorySpaces(service, request) {
 			...memoryInputText(input.category, "category", 30, false) === void 0 ? {} : { category: memoryInputText(input.category, "category", 30, false) },
 			...memoryInputText(input.source, "source", 30, false) === void 0 ? {} : { source: memoryInputText(input.source, "source", 30, false) },
 			...memoryInputText(input.intent, "intent", 30, false) === void 0 ? {} : { intent: memoryInputText(input.intent, "intent", 30, false) },
-			...memoryInputStringArray(input.memoryBodyIds, "memoryBodyIds", 1e4) === void 0 ? {} : { memoryBodyIds: memoryInputStringArray(input.memoryBodyIds, "memoryBodyIds", 1e4) }
+			...memoryInputStringArray(input.memoryBodyIds, "memoryBodyIds", 1e4) === void 0 ? {} : { memoryBodyIds: memoryInputStringArray(input.memoryBodyIds, "memoryBodyIds", 1e4) },
+			...input.inspect === true ? { inspect: true } : {}
 		}, request.signal));
 		case "related": return managementResult(service, await service.related(memoryInputText(input.id, "id", 2e3), memoryInputInteger(input.depth, 2, 1, 5), memoryInputText(input.edge, "edge", 30, false), request.signal, memoryInputText(input.memoryBodyId, "memoryBodyId", 300, false)));
 		case "body-reconnect": return managementResult(service, await service.reconnectSpace(memoryInputText(input.memoryBodyId, "memoryBodyId", 300), request.signal));
@@ -3353,6 +3384,34 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 				admittedByView.set(viewId, current);
 				while (admittedByView.size > 128) admittedByView.delete(admittedByView.keys().next().value);
 			};
+			/**
+			* The Memory Space an exact id belongs to, for an action or traversal that
+			* names a memory by id. Evidence this View returned decides first, as
+			* before. Otherwise the Providers that can look an id up are asked among
+			* the spaces in `scope`, and a found memory is admitted to this View. An
+			* Agent can so forget what it just wrote, and a delegated worker can act on
+			* an id from its parent's turn (#337). A Provider that cannot look ids up
+			* keeps to evidence: its own call may reach beyond the space named.
+			*/
+			const ownerOf = async (viewId, id, requestedSpace, scope, signal) => {
+				const entries = admittedByView.get(viewId);
+				if (requestedSpace !== void 0) {
+					if (entries?.has(requestedSpace + "/" + id) === true) return requestedSpace;
+				} else {
+					const owners = [...entries?.entries() ?? []].filter(([reference]) => reference.endsWith("/" + id)).map(([, owner]) => owner);
+					if (owners.length > 0) return owners.length === 1 ? owners[0] : void 0;
+				}
+				const candidates = requestedSpace === void 0 ? scope : scope.includes(requestedSpace) ? [requestedSpace] : [];
+				if (candidates.length === 0) return void 0;
+				const found = await service.locate(id, candidates, signal);
+				const owners = [...new Set(found.flatMap((item) => item.memoryBodyId === void 0 ? [] : [item.memoryBodyId]))];
+				if (owners.length !== 1) return void 0;
+				admit(viewId, [{
+					id,
+					memoryBodyId: owners[0]
+				}]);
+				return owners[0];
+			};
 			const evidence = (request, items, unavailable) => {
 				const catalog = request.route.sourceRouteId === "inspect";
 				let remaining = request.route.maxCharacters ?? 16e3;
@@ -3410,15 +3469,15 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 			};
 			return {
 				facts(request) {
-					const { active, revision } = sourceState(request.scope);
+					const { active, providerReady, revision } = sourceState(request.scope);
 					const routeIds = [
 						"inspect",
 						...active.some((body) => body.provider.capabilities.search) ? ["recall"] : [],
 						...active.some((body) => body.provider.capabilities.related) ? ["related"] : []
 					];
 					const actionIds = service.config.writeEnabled ? [
-						"manage-spaces",
-						...canRemember ? ["remember"] : [],
+						...providerReady ? ["manage-spaces"] : [],
+						...canRemember && providerReady ? ["remember"] : [],
 						...active.some((body) => body.provider.capabilities.link) ? ["link"] : [],
 						...active.some((body) => body.provider.capabilities.forget) ? ["forget"] : []
 					] : [];
@@ -3439,7 +3498,8 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 						actionIds,
 						hints: {
 							activeCount: active.length,
-							providerCount: new Set(active.map((body) => body.provider.id)).size
+							providerCount: new Set(active.map((body) => body.provider.id)).size,
+							archivableCount: active.filter((body) => body.provider.capabilities.remember && body.provider.capabilities.forget && body.provider.capabilities.writeMode === "exact").length
 						}
 					};
 				},
@@ -3523,10 +3583,8 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 					if (request.route.sourceRouteId === "related") {
 						const id = memoryInputText(input.id, "id", 2e3);
 						const requestedSpace = memoryInputText(input.memoryBodyId, "memoryBodyId", 300, false);
-						const admitted = admittedByView.get(request.view.id);
-						const owners = [...admitted?.entries() ?? []].filter(([reference]) => reference.endsWith("/" + id)).map(([, bodyId]) => bodyId);
-						const owner = requestedSpace === void 0 ? owners.length === 1 ? owners[0] : void 0 : admitted?.get(requestedSpace + "/" + id);
-						if (owner === void 0) throw new Error("related-memory traversal requires evidence already admitted by this View");
+						const owner = await ownerOf(request.view.id, id, requestedSpace, allowedBodies, request.signal);
+						if (owner === void 0) throw new Error("related-memory traversal requires evidence already admitted by this View, or an id found in a Memory Space it can read");
 						if (!allowedBodies.includes(owner)) throw new Error("related-memory owner is outside this View ReadGrant");
 						const edge = memoryInputText(input.edge, "edge", 30, false);
 						if (edge !== void 0 && !EDGES.has(edge)) throw new Error(`unsupported edge: ${edge}`);
@@ -3543,13 +3601,7 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 					const allowedBodies = grantIds(grant);
 					const created = createdByView.get(request.view.id) ?? /* @__PURE__ */ new Set();
 					const writableBodies = writeBodies(request.view.id, grant);
-					const admittedOwner = (id) => {
-						const requestedSpace = memoryInputText(input.memoryBodyId, "memoryBodyId", 300, false);
-						const entries = admittedByView.get(request.view.id);
-						if (requestedSpace !== void 0) return entries?.get(requestedSpace + "/" + id);
-						const owners = [...entries?.entries() ?? []].filter(([reference]) => reference.endsWith("/" + id)).map(([, owner]) => owner);
-						return owners.length === 1 ? owners[0] : void 0;
-					};
+					const admittedOwner = (id) => ownerOf(request.view.id, id, memoryInputText(input.memoryBodyId, "memoryBodyId", 300, false), allowedBodies, request.signal);
 					let result;
 					let bodyId;
 					if (request.offer.sourceActionId === "manage-spaces") {
@@ -3616,9 +3668,9 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 					} else if (request.offer.sourceActionId === "link") {
 						const sourceId = memoryInputText(input.sourceId, "sourceId", 2e3);
 						const targetId = memoryInputText(input.targetId, "targetId", 2e3);
-						const sourceSpace = admittedOwner(sourceId);
-						const targetSpace = admittedOwner(targetId);
-						if (sourceSpace === void 0 || targetSpace === void 0 || sourceSpace !== targetSpace || !allowedBodies.includes(sourceSpace)) throw new Error("link requires two evidence items admitted by this View from the same Memory Space");
+						const sourceSpace = await admittedOwner(sourceId);
+						const targetSpace = await admittedOwner(targetId);
+						if (sourceSpace === void 0 || targetSpace === void 0 || sourceSpace !== targetSpace || !allowedBodies.includes(sourceSpace)) throw new Error("link requires two evidence items admitted by this View from the same Memory Space, or two ids found in one Memory Space it can read");
 						bodyId = sourceSpace;
 						const edge = memoryInputText(input.type, "type", 30, false);
 						if (edge !== void 0 && !EDGES.has(edge)) throw new Error(`unsupported edge: ${edge}`);
@@ -3626,8 +3678,8 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 						result = await service.link(sourceId, targetId, edge, weight, memoryInputText(input.reason, "reason", 1e3, false), request.signal, bodyId);
 					} else if (request.offer.sourceActionId === "forget") {
 						const id = memoryInputText(input.id, "id", 2e3);
-						bodyId = admittedOwner(id);
-						if (bodyId === void 0 || !allowedBodies.includes(bodyId)) throw new Error("forget requires evidence already admitted by this View");
+						bodyId = await admittedOwner(id);
+						if (bodyId === void 0 || !allowedBodies.includes(bodyId)) throw new Error("forget requires evidence already admitted by this View, or an id found in one Memory Space it can read; name the space (memoryBodyId) when several hold it");
 						result = await service.forget(id, request.signal, bodyId);
 					} else throw new Error(`unsupported Memory Spaces action: ${request.offer.sourceActionId}`);
 					return createMemoryMutationReceipt(request.view.id, request.offer.id, context.sourceInstanceKey, service.memoryRevision(), {

package/lib/provider-sdk.d.ts

@@ -1,5 +1,5 @@
 import { CATEGORIES, Category, EDGE_TYPES, EdgeType, INTENTS, Insight, Intent, JsonValue, MemoryBody, MemoryBodyProvider, MemoryBodyStats, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemorySpace, MemorySpaceProvider, MemorySpaceStats, OpenVikingBodyConnection, OpenVikingSpaceConnection, RememberRequest, SOURCES, SearchRequest, Source } from "./contracts.js";
-import { C as ProviderSearchResult, S as ProviderScoreSemantics, _ as MemorySpaceNativeRunner, a as MemorySpaceProviderHost, b as ProviderEntityIndex, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunOptions, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as NORMALIZED_RELEVANCE_SCORE, w as ProviderSpaceStatus, x as ProviderMemorySpace, y as ProviderBodyStatus } from "./definitions-BcYzE092.js";
+import { C as ProviderSearchResult, S as ProviderScoreSemantics, _ as MemorySpaceNativeRunner, a as MemorySpaceProviderHost, b as ProviderEntityIndex, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunOptions, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as NORMALIZED_RELEVANCE_SCORE, w as ProviderSpaceStatus, x as ProviderMemorySpace, y as ProviderBodyStatus } from "./definitions-CtjNSwBS.js";
 //#region src/providers/http.d.ts
 interface HttpProviderOptions {
   label?: string;

package/lib/testing.d.ts

@@ -1,5 +1,5 @@
 import { MemoryProviderConnection, MemoryProviderDescriptor, MemorySpace } from "./contracts.js";
-import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-BcYzE092.js";
+import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-CtjNSwBS.js";
 //#region src/testing.d.ts
 interface MemorySpaceProviderTest {
   readonly registered: boolean;

package/lib/types/contracts.d.ts

@@ -278,6 +278,13 @@ export interface SearchRequest {
     source?: Source;
     intent?: Intent;
     memoryBodyIds?: string[];
+    /**
+     * A look at the memory rather than a use of it, such as the Memory System's
+     * own searches. Providers that record reads, as access counts or a query
+     * log, leave it out, and may answer from a snapshot that lags a write still
+     * in flight; a check that must see a write leaves the flag unset.
+     */
+    inspect?: boolean;
 }
 export interface RememberRequest {
     content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-memory-spaces",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -65,13 +65,13 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.24",
+    "dsh-mnemon": "^0.5.25",
     "dsh-mnemon-provider-byterover": "^0.5.5",
     "dsh-mnemon-provider-hindsight": "^0.5.5",
     "dsh-mnemon-provider-holographic": "^0.5.6",
     "dsh-mnemon-provider-honcho": "^0.5.5",
     "dsh-mnemon-provider-mem0": "^0.5.5",
-    "dsh-mnemon-provider-mnemon-native": "^0.5.8",
+    "dsh-mnemon-provider-mnemon-native": "^0.5.9",
     "dsh-mnemon-provider-openviking": "^0.5.7",
     "dsh-mnemon-provider-retaindb": "^0.5.5",
     "dsh-mnemon-provider-supermemory": "^0.5.5",