dsh-mnemon-source-memory-spaces 0.5.6 → 0.5.7

package/README.md

@@ -19,6 +19,8 @@ config:
 
 The host must already provide `ctx.mnemonMemory`; a Strategy decides how this Source enters the LLM View. For programmatic composition, import `installMemorySpaces` and pass explicit typed child modules. It returns `Promise<void>`; no private Host or Snapshot escapes. Omitting the child list is an error, not automatic dependency discovery. The default `dsh-mnemon` bundle supplies the existing nine Providers and existing storage settings separately.
 
+Host archive workflows can read `body-directory` with `{ writeScope: { viewId, grant } }`, using `MemorySpaceWriteScopeRequest` from `./contracts`. The optional catalog `writeScope` returns the View id, exact Source instance and authorized `memoryBodyIds`; it shares `remember` authority for known namespaces and spaces created by that View. Empty scopes remain empty. The Host must bind the input to its initiating View and Source, validate the response identity, and recheck live capabilities before writing. Older Sources that omit the response require a conservative pinned-namespace fallback; read grants must never be interpreted as unlimited authority.
+
 Run `pnpm install && pnpm verify` in this directory. Its own tests mount real Cordis Fibers and exercise Source isolation, scoped management, View actions/routes, persistence and failed-child cleanup. Provider authors use `mountMemorySpaceProvider(module, { instanceId, config })` from the public `/testing` entry to test actual child registration and obtain frozen metadata plus `createAdapter`/`dispose`. `createMemorySpaceProviderFixture` supplies scoped authority and validated connection data for driver tests. Dispose the mounted fixture to release its adapters and Fiber. Neither fixture exposes the private Host, Registry or Snapshot; test the full Source separately for View integration.
 
 ## Configuration ownership

package/lib/contracts.d.ts

@@ -1,4 +1,4 @@
-import { MemoryJsonValue as JsonValue } from "dsh-mnemon/contracts";
+import { MemoryJsonValue as JsonValue, MemoryReadGrant } from "dsh-mnemon/contracts";
 //#region src/contracts.d.ts
 type MemoryProviderId = string;
 type MemoryProviderConnectionValue = string | number | boolean;
@@ -298,6 +298,17 @@ interface MemorySpaceView extends MemorySpace {
   error?: string;
   stats?: MemorySpaceStats;
 }
+/** Optional Host-only body-directory input; the Host binds the grant to its initiating View and exact Source. */
+interface MemorySpaceWriteScopeRequest {
+  viewId: string;
+  grant: MemoryReadGrant;
+}
+/** Source-owned write authority, distinct from the active namespaces pinned for recall. */
+interface MemorySpaceWriteScope {
+  viewId: string;
+  sourceInstanceKey: string;
+  memoryBodyIds: string[];
+}
 interface MemorySpaceCatalog {
   items: MemorySpaceView[];
   providers: MemoryProviderDescriptor[];
@@ -307,6 +318,8 @@ interface MemorySpaceCatalog {
   activeCount: number;
   directory: string;
   generatedAt: string;
+  /** Present only when body-directory receives a supported writeScope request. Older Sources omit it. */
+  writeScope?: MemorySpaceWriteScope;
 }
 interface MemoryGraphNode extends Insight {
   color: string;
@@ -517,4 +530,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, 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, MemorySpaceStats, MemorySpaceView, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingProtocol, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest };
+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, 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, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingProtocol, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest };

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, 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, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingProtocol, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest } 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, 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 } from "./contracts.js";
 import { i as MemorySpaceProviderEntry } from "./definitions-C5y84OE6.js";
 import z from "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 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 MemorySpaceStats, type MemorySpaceView, type MemorySpacesStatus, type MnemonEmbeddingConfig, type MnemonEmbeddingProtocol, 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, 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 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 MemorySpaceStats, type MemorySpaceView, type MemorySpaceWriteScope, type MemorySpaceWriteScopeRequest, type MemorySpacesStatus, type MnemonEmbeddingConfig, type MnemonEmbeddingProtocol, 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, resolveEmbedding, resolveMemorySpaceProviderEntries, resolvePersistenceStrategy, resolveRecallQuality };

package/lib/index.js

@@ -3042,6 +3042,11 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 			};
 			const admittedByView = /* @__PURE__ */ new Map();
 			const createdByView = /* @__PURE__ */ new Map();
+			const writeBodies = (viewId, grant) => {
+				if (grant.sourceInstanceKey !== context.sourceInstanceKey || grant.schema !== "dsh-mnemon.memory-spaces/v1") throw new Error("Memory Spaces write scope grant does not belong to this Source");
+				const known = memoryInputStringArray(memoryInputRecord(grant.value, "Memory Spaces scope").knownMemoryBodyIds, "knownMemoryBodyIds", 1e4) ?? grantIds(grant);
+				return [.../* @__PURE__ */ new Set([...known, ...createdByView.get(viewId) ?? []])];
+			};
 			const admit = (viewId, entries) => {
 				const current = admittedByView.get(viewId) ?? /* @__PURE__ */ new Map();
 				for (const entry of entries) if (entry.memoryBodyId !== void 0) current.set(entry.memoryBodyId + "/" + entry.id, entry.memoryBodyId);
@@ -3237,9 +3242,8 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 					const grant = request.grant;
 					if (grant === void 0) throw new Error("Memory Spaces action has no View ReadGrant");
 					const allowedBodies = grantIds(grant);
-					const knownBodies = memoryInputStringArray(memoryInputRecord(grant.value, "Memory Spaces scope").knownMemoryBodyIds, "knownMemoryBodyIds", 1e4) ?? allowedBodies;
 					const created = createdByView.get(request.view.id) ?? /* @__PURE__ */ new Set();
-					const writeBodies = [.../* @__PURE__ */ new Set([...knownBodies, ...created])];
+					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);
@@ -3269,7 +3273,7 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 							};
 						} else if (input.operation === "update") {
 							bodyId = memoryInputText(input.memoryBodyId, "memoryBodyId", 300);
-							if (!writeBodies.includes(bodyId)) throw new Error("Memory Space update is outside this View scope");
+							if (!writableBodies.includes(bodyId)) throw new Error("Memory Space update is outside this View scope");
 							const body = service.updateSpace(bodyId, {
 								...input.name === void 0 ? {} : { name: memoryInputText(input.name, "name", 100) },
 								...input.description === void 0 ? {} : { description: memoryInputText(input.description, "description", 1e3) },
@@ -3285,7 +3289,7 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 						} else if (input.operation === "merge") {
 							const target = memoryInputText(input.targetMemoryBodyId, "targetMemoryBodyId", 300);
 							const sources = memoryInputStringArray(input.sourceMemoryBodyIds, "sourceMemoryBodyIds", 20) ?? [];
-							if ([target, ...sources].some((id) => !writeBodies.includes(id))) throw new Error("Memory Space merge is outside this View scope");
+							if ([target, ...sources].some((id) => !writableBodies.includes(id))) throw new Error("Memory Space merge is outside this View scope");
 							bodyId = target;
 							result = await service.mergeSpaces(target, sources, input.deactivateSources !== false, request.signal);
 						} else throw new Error("unsupported Memory Space management action");
@@ -3296,7 +3300,7 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 							if (defaults.length !== 1) throw new Error("remember requires an explicit Memory Space in this View scope");
 							bodyId = defaults[0];
 						}
-						if (!writeBodies.includes(bodyId)) throw new Error("remember destination is outside this View scope");
+						if (!writableBodies.includes(bodyId)) throw new Error("remember destination is outside this View scope");
 						const category = memoryInputText(input.category, "category", 30, false);
 						const source = memoryInputText(input.source, "source", 30, false);
 						if (category !== void 0 && !CATEGORIES.has(category)) throw new Error(`unsupported category: ${category}`);
@@ -3333,6 +3337,23 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 					}, mutationResultCompletion(result));
 				},
 				manage(request) {
+					if (request.mode === "read" && request.operation === "body-directory" && request.input !== null) {
+						const input = memoryInputRecord(request.input, "Memory Spaces body-directory");
+						if (input.writeScope !== void 0) {
+							if (!service.config.writeEnabled) throw new Error("Memory Spaces is configured read-only");
+							const scope = memoryInputRecord(input.writeScope, "Memory Spaces write scope");
+							const viewId = memoryInputText(scope.viewId, "write scope viewId", 300);
+							const grant = memoryInputRecord(scope.grant ?? null, "Memory Spaces write scope grant");
+							return managementResult(service, {
+								...service.spaceDirectory(),
+								writeScope: {
+									viewId,
+									sourceInstanceKey: context.sourceInstanceKey,
+									memoryBodyIds: writeBodies(viewId, grant)
+								}
+							});
+						}
+					}
 					return manageMemorySpaces(service, request);
 				},
 				async dispose() {

package/lib/types/contracts.d.ts

@@ -5,6 +5,7 @@
  * and persisted Document/Pack lineage; they all refer to memory spaces.
  */
 export type { MemoryJsonValue as JsonValue } from 'dsh-mnemon/contracts';
+import type { MemoryReadGrant } from 'dsh-mnemon/contracts';
 export type MemoryProviderId = string;
 export type MemoryProviderConnectionValue = string | number | boolean;
 export type MemoryProviderConnection = Record<string, MemoryProviderConnectionValue>;
@@ -303,6 +304,17 @@ export interface MemorySpaceView extends MemorySpace {
     error?: string;
     stats?: MemorySpaceStats;
 }
+/** Optional Host-only body-directory input; the Host binds the grant to its initiating View and exact Source. */
+export interface MemorySpaceWriteScopeRequest {
+    viewId: string;
+    grant: MemoryReadGrant;
+}
+/** Source-owned write authority, distinct from the active namespaces pinned for recall. */
+export interface MemorySpaceWriteScope {
+    viewId: string;
+    sourceInstanceKey: string;
+    memoryBodyIds: string[];
+}
 export interface MemorySpaceCatalog {
     items: MemorySpaceView[];
     providers: MemoryProviderDescriptor[];
@@ -312,6 +324,8 @@ export interface MemorySpaceCatalog {
     activeCount: number;
     directory: string;
     generatedAt: string;
+    /** Present only when body-directory receives a supported writeScope request. Older Sources omit it. */
+    writeScope?: MemorySpaceWriteScope;
 }
 export interface MemoryGraphNode extends Insight {
     color: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-memory-spaces",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -62,7 +62,7 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.7",
+    "dsh-mnemon": "^0.5.9",
     "dsh-mnemon-provider-byterover": "^0.5.4",
     "dsh-mnemon-provider-hindsight": "^0.5.4",
     "dsh-mnemon-provider-holographic": "^0.5.4",