dsh-mnemon-strategy-default-three-tier 0.5.6 → 0.5.7

package/lib/extension-sdk.d.ts

@@ -1,24 +1,12 @@
-import { MemoryAvailableSource, MemoryJsonValue, MemoryStrategyContribution, MemoryStrategyExtensionDefinition, MemoryViewRequest } from "dsh-mnemon/contracts";
+import { MemoryAvailableSource, MemoryJsonValue, MemoryStrategyContribution, MemoryStrategyExtensionDefinition, MemoryViewExtensionSlot, MemoryViewExtensionValues, MemoryViewRequest } from "dsh-mnemon/contracts";
 //#region src/extension-sdk.d.ts
-/** These slots belong to the three-tier product. Core does not interpret them. */
-type ThreeTierExtensionValues = {
-  selection: {
-    sourceKeys: string[];
-    writableSourceKeys?: string[];
-  };
-  projection: {
-    maxProjectionCharacters: number;
-  };
-  capture: {
-    instruction: string;
-    actionIds: string[];
-    sourceKeys?: string[];
-  };
-};
-type ThreeTierExtensionSlot = keyof ThreeTierExtensionValues;
+/** The three-tier slots are Core's standard View extension slots. */
+type ThreeTierExtensionValues = MemoryViewExtensionValues;
+type ThreeTierExtensionSlot = MemoryViewExtensionSlot;
 /** Pure default-product policy. The Host executes it through public Source protocols. */
 declare function threeTierActionWorkflow(strategyTypeId: string, sourceTypeId: string, actionId: string): 'runtime-capacity' | undefined;
 declare function validateThreeTierExtension<K extends ThreeTierExtensionSlot>(slot: K, value: MemoryJsonValue): ThreeTierExtensionValues[K];
+/** An extension only for this Strategy; `defineMemoryViewExtension` also follows other Strategies. */
 declare function defineThreeTierExtension<K extends ThreeTierExtensionSlot>(definition: {
   typeId: string;
   packageName: string;

package/lib/extension-sdk.js

@@ -1,46 +1,14 @@
-import { defineMemoryStrategyExtension, memoryInputInteger, memoryInputRecord, memoryInputText } from "dsh-mnemon/extension-sdk";
+import { defineMemoryStrategyExtension, memoryViewExtensionValues, validateMemoryViewExtension } from "dsh-mnemon/extension-sdk";
 import { COMPOSABLE_MEMORY_API_VERSION } from "dsh-mnemon/contracts";
 //#region src/extension-sdk.ts
 /** Pure default-product policy. The Host executes it through public Source protocols. */
 function threeTierActionWorkflow(strategyTypeId, sourceTypeId, actionId) {
 	return strategyTypeId === "default-three-tier" && sourceTypeId === "runtime" && actionId === "mutate" ? "runtime-capacity" : void 0;
 }
-function keys(value, label) {
-	if (!Array.isArray(value) || value.length > 32 || value.some((key) => typeof key !== "string" || !/^source:[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,292}$/u.test(key))) throw new Error(`${label} must contain at most 32 exact Source instance keys`);
-	if (new Set(value).size !== value.length) throw new Error(`${label} contains duplicate Source keys`);
-	return [...value];
-}
 function validateThreeTierExtension(slot, value) {
-	const input = memoryInputRecord(value, `three-tier ${slot} contribution`);
-	const allowed = slot === "selection" ? ["sourceKeys", "writableSourceKeys"] : slot === "projection" ? ["maxProjectionCharacters"] : slot === "capture" ? [
-		"instruction",
-		"actionIds",
-		"sourceKeys"
-	] : [];
-	if (allowed.length === 0) throw new Error(`unsupported three-tier extension slot: ${String(slot)}`);
-	for (const key of Object.keys(input)) if (!allowed.includes(key)) throw new Error(`unsupported three-tier ${slot} field: ${key}`);
-	let result;
-	if (slot === "selection") {
-		const sourceKeys = keys(input.sourceKeys, "sourceKeys");
-		const writableSourceKeys = input.writableSourceKeys === void 0 ? void 0 : keys(input.writableSourceKeys, "writableSourceKeys");
-		if (writableSourceKeys?.some((key) => !sourceKeys.includes(key))) throw new Error("writableSourceKeys must be within selected sourceKeys");
-		result = {
-			sourceKeys,
-			...writableSourceKeys === void 0 ? {} : { writableSourceKeys }
-		};
-	} else if (slot === "projection") {
-		if (input.maxProjectionCharacters === void 0) throw new Error("maxProjectionCharacters is required");
-		result = { maxProjectionCharacters: memoryInputInteger(input.maxProjectionCharacters, 4096, 1, 1e7) };
-	} else {
-		if (!Array.isArray(input.actionIds) || input.actionIds.length === 0 || input.actionIds.length > 32 || input.actionIds.some((id) => typeof id !== "string" || !/^[a-z][a-z0-9-]{0,127}$/u.test(id)) || new Set(input.actionIds).size !== input.actionIds.length) throw new Error("capture actionIds must name 1..32 distinct Source-local recording actions");
-		result = {
-			instruction: memoryInputText(input.instruction, "capture instruction", 4e3),
-			actionIds: [...input.actionIds],
-			...input.sourceKeys === void 0 ? {} : { sourceKeys: keys(input.sourceKeys, "capture sourceKeys") }
-		};
-	}
-	return result;
+	return validateMemoryViewExtension(slot, value);
 }
+/** An extension only for this Strategy; `defineMemoryViewExtension` also follows other Strategies. */
 function defineThreeTierExtension(definition) {
 	return defineMemoryStrategyExtension({
 		manifest: {
@@ -52,18 +20,11 @@ function defineThreeTierExtension(definition) {
 			slot: definition.slot,
 			deterministic: true
 		},
-		contribute: (request, sources) => validateThreeTierExtension(definition.slot, definition.contribute(request, sources))
+		contribute: (request, sources) => validateMemoryViewExtension(definition.slot, definition.contribute(request, sources))
 	});
 }
 function threeTierContributions(values) {
-	const output = {};
-	for (const contribution of values) {
-		const slot = contribution.slot;
-		if (Object.hasOwn(output, slot)) throw new Error(`duplicate three-tier extension slot: ${slot}`);
-		const value = validateThreeTierExtension(slot, contribution.value);
-		Object.assign(output, { [slot]: value });
-	}
-	return output;
+	return memoryViewExtensionValues(values);
 }
 //#endregion
 export { defineThreeTierExtension, threeTierActionWorkflow, threeTierContributions, validateThreeTierExtension };

package/lib/index.js

@@ -54,13 +54,6 @@ const MODEL_RECALL_MEDIUM_LIMIT_PER_ATTEMPT = 1;
 const MODEL_RECALL_UNKNOWN_LIMIT_PER_ATTEMPT = 1;
 const MODEL_RECALL_LIST_LIMIT = 8;
 const MODEL_RECALL_METADATA_LIMIT = 300;
-function boundedModelText(value, maximum) {
-	if (maximum <= 0) return "";
-	if (value.length <= maximum) return value;
-	let end = maximum - 1;
-	if (end > 0 && /[\uD800-\uDBFF]/u.test(value[end - 1])) end -= 1;
-	return `${value.slice(0, end)}…`;
-}
 function insightDigest(result) {
 	return sha256(result.content.trim().replace(/\s+/gu, " "));
 }
@@ -109,7 +102,7 @@ function boundedModelInsights(results, admission = {}) {
 		if (seenReferences.has(reference) || seenDigests.has(digest)) continue;
 		const remainingContent = totalContentLimit - contentCharacters;
 		if (remainingContent <= 0) break;
-		const content = boundedModelText(result.content, Math.min(contentLimit, remainingContent));
+		const content = truncateMemoryText(result.content, Math.min(contentLimit, remainingContent));
 		if (content === "") continue;
 		seenReferences.add(reference);
 		seenDigests.add(digest);
@@ -119,19 +112,19 @@ function boundedModelInsights(results, admission = {}) {
 		admitted.push({
 			id: result.id,
 			content,
-			...result.category === void 0 ? {} : { category: boundedModelText(result.category, MODEL_RECALL_METADATA_LIMIT) },
+			...result.category === void 0 ? {} : { category: truncateMemoryText(result.category, MODEL_RECALL_METADATA_LIMIT) },
 			...typeof result.importance !== "number" || !Number.isFinite(result.importance) ? {} : { importance: result.importance },
-			...result.tags === void 0 ? {} : { tags: result.tags.slice(0, MODEL_RECALL_LIST_LIMIT).map((tag) => boundedModelText(tag, MODEL_RECALL_METADATA_LIMIT)) },
-			...result.entities === void 0 ? {} : { entities: result.entities.slice(0, MODEL_RECALL_LIST_LIMIT).map((entity) => boundedModelText(entity, MODEL_RECALL_METADATA_LIMIT)) },
-			...result.source === void 0 ? {} : { source: boundedModelText(result.source, MODEL_RECALL_METADATA_LIMIT) },
-			...result.createdAt === void 0 ? {} : { createdAt: boundedModelText(result.createdAt, MODEL_RECALL_METADATA_LIMIT) },
+			...result.tags === void 0 ? {} : { tags: result.tags.slice(0, MODEL_RECALL_LIST_LIMIT).map((tag) => truncateMemoryText(tag, MODEL_RECALL_METADATA_LIMIT)) },
+			...result.entities === void 0 ? {} : { entities: result.entities.slice(0, MODEL_RECALL_LIST_LIMIT).map((entity) => truncateMemoryText(entity, MODEL_RECALL_METADATA_LIMIT)) },
+			...result.source === void 0 ? {} : { source: truncateMemoryText(result.source, MODEL_RECALL_METADATA_LIMIT) },
+			...result.createdAt === void 0 ? {} : { createdAt: truncateMemoryText(result.createdAt, MODEL_RECALL_METADATA_LIMIT) },
 			...typeof result.depth !== "number" || !Number.isFinite(result.depth) ? {} : { depth: result.depth },
-			...result.edgeType === void 0 ? {} : { edgeType: boundedModelText(result.edgeType, MODEL_RECALL_METADATA_LIMIT) },
-			...result.memoryBodyId === void 0 ? {} : { memoryBodyId: boundedModelText(result.memoryBodyId, 1e3) },
-			...result.memoryBodyName === void 0 ? {} : { memoryBodyName: boundedModelText(result.memoryBodyName, MODEL_RECALL_METADATA_LIMIT) },
+			...result.edgeType === void 0 ? {} : { edgeType: truncateMemoryText(result.edgeType, MODEL_RECALL_METADATA_LIMIT) },
+			...result.memoryBodyId === void 0 ? {} : { memoryBodyId: truncateMemoryText(result.memoryBodyId, 1e3) },
+			...result.memoryBodyName === void 0 ? {} : { memoryBodyName: truncateMemoryText(result.memoryBodyName, MODEL_RECALL_METADATA_LIMIT) },
 			...result.memoryProviderId === void 0 ? {} : { memoryProviderId: result.memoryProviderId },
 			...result.memoryCapabilities === void 0 ? {} : { memoryCapabilities: structuredClone(result.memoryCapabilities) },
-			...result.externalUri === void 0 ? {} : { externalUri: boundedModelText(result.externalUri, 2e3) }
+			...result.externalUri === void 0 ? {} : { externalUri: truncateMemoryText(result.externalUri, 2e3) }
 		});
 	}
 	return { results: admitted };
@@ -604,12 +597,12 @@ const inject = ["mnemonMemory"];
 const memoryPlugin = defineMemoryPlugin({
 	packageName: name,
 	label: {
-		en: "Default three-tier",
-		"zh-CN": "默认三层"
+		en: "Layered strategy",
+		"zh-CN": "分层策略"
 	},
 	description: {
-		en: "Compile available runtime, document and durable Sources into one View.",
-		"zh-CN": "将可用的运行时、档案与长期 Source 编译为一个 View。"
+		en: "Resident runtime memory, on-demand documents and durable memory.",
+		"zh-CN": "运行时记忆常驻，档案与长期记忆按需读取。"
 	},
 	roles: ["strategy"],
 	provides: [{ id: "strategy" }, { id: "strategy.default-three-tier" }],
@@ -618,10 +611,7 @@ const memoryPlugin = defineMemoryPlugin({
 const memoryStrategyConfiguration = defineMemoryStrategyConfiguration({
 	kind: "strategy",
 	typeId: "default-three-tier",
-	label: {
-		en: "Default three-tier",
-		"zh-CN": "默认三层"
-	},
+	label: memoryPlugin.label,
 	description: {
 		en: "Compose runtime context, documents and durable memory.",
 		"zh-CN": "组合运行时、档案与长期记忆。"

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Layered strategy",
+    "description": "Resident runtime memory, on-demand documents and durable memory."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "分层策略",
+    "description": "运行时记忆常驻，档案与长期记忆按需读取。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-strategy-default-three-tier",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "Explicit three-tier View Strategy for Composable View Memory.",
   "license": "MIT",
   "type": "module",
@@ -16,10 +16,12 @@
       "types": "./lib/extension-sdk.d.ts",
       "default": "./lib/extension-sdk.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
     "lib",
+    "locale",
     "README.md"
   ],
   "scripts": {
@@ -30,11 +32,11 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "dsh-mnemon": "^0.5.1"
+    "dsh-mnemon": "^0.5.17"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "dsh-mnemon": "^0.5.15",
+    "dsh-mnemon": "^0.5.17",
     "tsdown": "^0.22.0",
     "typescript": "^5.9.0",
     "vitest": "^3.2.0"