dsh-mnemon-strategy-default-three-tier 0.5.11 → 0.5.13

package/README.md

@@ -69,6 +69,19 @@ the same role, the original ambiguity check applies rather than silently
 choosing a Source. Projection limits are not token limits or delta injection;
 capture guidance is not a background worker or a guarantee of model behavior.
 
+## Sources with another role
+
+An installed Source whose role is not `working-context`, `narrative` or
+`durable-evidence` is not a failure and is not admitted either: the strategy
+keeps composing the three tiers and returns one `unsupported-source-role`
+entry per such Source in `ViewSpec.diagnostics`. The Host validates those
+entries and merges them into `view.diagnostics`, so the turn's
+`MNEMON VIEW AVAILABILITY` line and the View inspection name the Source and its
+role. A diagnostic is an explanation, never authority: the Source still gets no
+projection, Route or ActionOffer. Select the general Strategy to compose it;
+an explicit `selection` still rejects unsupported roles. An unavailable Source keeps
+the Host's own diagnostic instead.
+
 Its own directory is a standalone project: install its declared dependencies,
 then run `pnpm verify`. When developing against an unreleased Mnemon, install a
 packed `dsh-mnemon` artifact as the peer instead of linking its source tree.

package/lib/index.d.ts

@@ -1,9 +1,9 @@
-import { MemoryAvailableSource, MemoryViewRequest, MemoryViewSpec } from "dsh-mnemon/contracts";
+import * as projectionSDK from "dsh-mnemon/extension-sdk";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/strategy.d.ts
 /** Pure View composition; no dependency on any Source implementation. */
 declare const DEFAULT_THREE_TIER_VIEW_STRATEGY: {
-  createTurn: (view: import("dsh-mnemon/extension-sdk").ComposableMemoryView) => import("dsh-mnemon/extension-sdk").MemoryStrategyTurn;
+  createTurn: (view: projectionSDK.ComposableMemoryView) => projectionSDK.MemoryStrategyTurn;
   manifest: {
     apiVersion: "dsh-mnemon/v1";
     kind: "strategy";
@@ -17,7 +17,7 @@ declare const DEFAULT_THREE_TIER_VIEW_STRATEGY: {
     extensionSlots: string[];
     workflows: ("idle-review" | "runtime-capacity")[];
   };
-  compose(request: MemoryViewRequest, sources: readonly MemoryAvailableSource[], contributions?: readonly import("dsh-mnemon/extension-sdk").MemoryStrategyContribution[] | undefined): MemoryViewSpec;
+  compose(request: projectionSDK.MemoryViewRequest, sources: readonly projectionSDK.MemoryAvailableSource[], contributions?: readonly projectionSDK.MemoryStrategyContribution[] | undefined): projectionSDK.MemoryViewSpec;
 };
 //#endregion
 //#region src/index.d.ts

package/lib/index.js

@@ -1,4 +1,5 @@
 import { threeTierContributions } from "./extension-sdk.js";
+import * as projectionSDK from "dsh-mnemon/extension-sdk";
 import { defineMemoryPlugin, defineMemoryStrategy, defineMemoryStrategyConfiguration, installMemory, memoryInputRecord, truncateMemoryText } from "dsh-mnemon/extension-sdk";
 import { COMPOSABLE_MEMORY_API_VERSION } from "dsh-mnemon/contracts";
 import { createHash, randomUUID } from "node:crypto";
@@ -510,11 +511,30 @@ const VIEW_ROLES = [
 	"narrative",
 	"durable-evidence"
 ];
+/** The Host accepts at most 32 ViewSpec diagnostics; the summary keeps us inside it. */
+const MAX_DIAGNOSTICS = 32;
 function soleSource(sources, role) {
 	const matches = sources.filter((source) => source.role === role && source.availability !== "unavailable").sort((left, right) => left.sourceInstanceKey.localeCompare(right.sourceInstanceKey));
 	if (matches.length > 1) throw new Error(`default-three-tier View Strategy found ambiguous ${role} Sources; select an explicit Strategy`);
 	return matches[0];
 }
+/**
+* Why an installed Source stays out of this View (#504). A custom role is not a
+* failure, so it is explained instead of silently dropped; an unavailable Source
+* already carries the Host's own diagnostic. Sorted by instance key so repeated
+* composition stays deterministic.
+*/
+function unsupportedRoleDiagnostics(sources) {
+	const unsupported = sources.filter((source) => source.availability !== "unavailable" && !VIEW_ROLES.includes(source.role)).sort((left, right) => left.sourceInstanceKey.localeCompare(right.sourceInstanceKey));
+	const reported = unsupported.length <= MAX_DIAGNOSTICS ? unsupported : unsupported.slice(0, 31);
+	return [...reported.map((source) => ({
+		code: "unsupported-source-role",
+		message: `Installed Source ${source.sourceInstanceKey} declares the role "${source.role}", which the default-three-tier Strategy does not admit, so it contributes no projection, Routes or Actions to this View. Use the general Strategy to compose it.`
+	})), ...reported.length === unsupported.length ? [] : [{
+		code: "unsupported-source-role",
+		message: `${unsupported.length - reported.length} more installed Sources declare a role the default-three-tier Strategy does not admit.`
+	}]];
+}
 /** Pure View composition; no dependency on any Source implementation. */
 const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 	createTurn: createThreeTierTurn,
@@ -536,7 +556,16 @@ const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 		workflows: ["idle-review", "runtime-capacity"]
 	},
 	compose(request, sources, contributions = []) {
-		if (contributions.length === 0) return composeThreeTier(request, sources);
+		const diagnostics = unsupportedRoleDiagnostics(sources);
+		const explained = (spec, budget = request.budget.maxProjectionCharacters) => {
+			if (typeof projectionSDK.reserveMemoryProjection !== "function" && sources.some((source) => source.hints && typeof source.hints === "object" && !Array.isArray(source.hints) && Number(source.hints.minimumProjectionCharacters) > 0)) throw new Error("Pinned Runtime requires a newer dsh-mnemon Host; update the Host and official Strategies together.");
+			const reserved = projectionSDK.reserveMemoryProjection?.(spec, sources, budget) ?? spec;
+			return diagnostics.length === 0 ? reserved : {
+				...reserved,
+				diagnostics
+			};
+		};
+		if (contributions.length === 0) return explained(composeThreeTier(request, sources));
 		const policies = threeTierContributions(contributions);
 		const boundedRequest = policies.projection === void 0 ? request : {
 			...request,
@@ -545,7 +574,7 @@ const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 				maxProjectionCharacters: Math.min(request.budget.maxProjectionCharacters, policies.projection.maxProjectionCharacters)
 			}
 		};
-		const spec = policies.selection === void 0 ? composeThreeTier(boundedRequest, sources) : composeSelected(boundedRequest, sources, policies.selection);
+		const spec = explained(policies.selection === void 0 ? composeThreeTier(boundedRequest, sources) : composeSelected(boundedRequest, sources, policies.selection), boundedRequest.budget.maxProjectionCharacters);
 		if (policies.capture !== void 0) {
 			const targets = spec.sources.filter((selected) => (policies.capture.sourceKeys === void 0 || policies.capture.sourceKeys.includes(selected.sourceInstanceKey)) && sources.some((source) => source.sourceInstanceKey === selected.sourceInstanceKey && source.actions.some((action) => selected.actionIds?.includes(action.id) && policies.capture.actionIds.includes(action.id) && action.authority === void 0 && ["write", "maintain"].includes(action.capability))));
 			if (targets.length > 0) {
@@ -627,7 +656,7 @@ function composeSelected(request, sources, selection) {
 	const selected = selection.sourceKeys.map((key) => {
 		const source = sources.find((source) => source.sourceInstanceKey === key);
 		if (source === void 0) throw new Error(`scoped three-tier Source is not installed: ${key}`);
-		if (!VIEW_ROLES.includes(source.role)) throw new Error(`unsupported scoped three-tier Source role: ${source.role}`);
+		if (!VIEW_ROLES.includes(source.role)) throw new Error(`unsupported scoped three-tier Source role: ${source.role} (${source.sourceInstanceKey}); default-three-tier admits ${VIEW_ROLES.join(", ")} only, so remove it from the selection or select the general Strategy`);
 		return source;
 	}).filter((source) => source.availability !== "unavailable");
 	const projected = selected.filter((source) => source.capabilities.includes("project"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-strategy-default-three-tier",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "description": "Explicit three-tier View Strategy for Composable View Memory.",
   "license": "MIT",
   "type": "module",
@@ -32,11 +32,11 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "dsh-mnemon": "^0.5.17"
+    "dsh-mnemon": "^0.5.43"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "dsh-mnemon": "^0.5.35",
+    "dsh-mnemon": "^0.5.43",
     "tsdown": "^0.22.0",
     "typescript": "^5.9.0",
     "vitest": "^3.2.0"