dsh-mnemon 0.5.16 → 0.5.17

package/lib/contracts.js

@@ -1,2 +1,45 @@
-import { a as MEMORY_PLUGIN_API_VERSION, i as DEFAULT_MEMORY_VIEW_BUDGET, n as MEMORY_SOURCE_MODES, r as COMPOSABLE_MEMORY_API_VERSION, t as MEMORY_CAPABILITIES } from "./contracts-D4ghDRK4.js";
-export { COMPOSABLE_MEMORY_API_VERSION, DEFAULT_MEMORY_VIEW_BUDGET, MEMORY_CAPABILITIES, MEMORY_PLUGIN_API_VERSION, MEMORY_SOURCE_MODES };
+//#region src/core/contracts/plugin.ts
+/** Declarative identity and graph relations shared by every Mnemon plugin. */
+const MEMORY_PLUGIN_API_VERSION = "dsh-mnemon/plugin/v1";
+//#endregion
+//#region src/core/contracts/view.ts
+const COMPOSABLE_MEMORY_API_VERSION = "dsh-mnemon/v1";
+/** Extension target for every selected Strategy that declares the extension's standard slot. */
+const ANY_MEMORY_STRATEGY = "*";
+/** Strategy role list entry for a role-agnostic Strategy that may select any Source. */
+const ANY_MEMORY_SOURCE_ROLE = "*";
+/** Standard View extension slots, each with one public value contract any Strategy may accept. */
+const MEMORY_VIEW_EXTENSION_SLOTS = [
+	"selection",
+	"projection",
+	"capture"
+];
+const DEFAULT_MEMORY_VIEW_BUDGET = Object.freeze({
+	maxProjectionCharacters: 65536,
+	maxRoutes: 16,
+	maxActions: 16,
+	maxEvidenceResults: 16,
+	maxEvidenceCharacters: 16384
+});
+//#endregion
+//#region src/core/contracts/index.ts
+const MEMORY_CAPABILITIES = [
+	"status",
+	"project",
+	"recall",
+	"search",
+	"read",
+	"browse",
+	"write",
+	"archive",
+	"graph",
+	"related",
+	"link",
+	"forget",
+	"maintain",
+	"export",
+	"import"
+];
+const MEMORY_SOURCE_MODES = ["eager", "routed"];
+//#endregion
+export { ANY_MEMORY_SOURCE_ROLE, ANY_MEMORY_STRATEGY, COMPOSABLE_MEMORY_API_VERSION, DEFAULT_MEMORY_VIEW_BUDGET, MEMORY_CAPABILITIES, MEMORY_PLUGIN_API_VERSION, MEMORY_SOURCE_MODES, MEMORY_VIEW_EXTENSION_SLOTS };

package/lib/core.js

@@ -1,4 +1,4 @@
-import { t as provideMemoryRuntime } from "./runtime-BEX0sc1z.js";
+import { t as provideMemoryRuntime } from "./runtime-Bk6lFgxd.js";
 //#region src/core/plugin.ts
 const name = "dsh-mnemon-core";
 const provide = ["mnemonMemory"];

package/lib/{definitions-CSPV0ER1.js → definitions-j9QPbrXb.js}

@@ -1,4 +1,4 @@
-import { a as MEMORY_PLUGIN_API_VERSION, t as MEMORY_CAPABILITIES } from "./contracts-D4ghDRK4.js";
+import { MEMORY_CAPABILITIES, MEMORY_PLUGIN_API_VERSION, MEMORY_VIEW_EXTENSION_SLOTS } from "./contracts.js";
 //#region src/core/definitions.ts
 const ID = /^[a-z][a-z0-9-]{0,127}$/u;
 const PACKAGE = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u;
@@ -16,6 +16,19 @@ function id(value, label) {
 	if (!ID.test(normalized)) throw new Error(`${label} must match [a-z][a-z0-9-]{0,127}`);
 	return normalized;
 }
+/** A role-agnostic Strategy names the wildcard alone, never beside specific roles. */
+function sourceRoles(value) {
+	if (value.includes("*")) {
+		if (value.length !== 1) throw new Error("memory Strategy supported Source roles must list the any-role wildcard alone");
+		return ["*"];
+	}
+	return uniqueIds(value, "memory Strategy supported Source role");
+}
+/** Only standard slots have a value contract every Strategy can share. */
+function anyStrategyTarget(slot) {
+	if (!MEMORY_VIEW_EXTENSION_SLOTS.includes(slot)) throw new Error(`memory Strategy extension for any Strategy must use a standard slot: ${String(slot)}`);
+	return "*";
+}
 function positiveInteger(value, label, maximum = 1e6) {
 	if (!Number.isInteger(value) || value < 1 || value > maximum) throw new Error(`${label} must be an integer within 1..${maximum}`);
 	return value;
@@ -216,7 +229,7 @@ function defineMemoryStrategy(definition) {
 		...manifest,
 		typeId,
 		packageName,
-		supportedSourceRoles: uniqueIds(manifest.supportedSourceRoles, "memory Strategy supported Source role"),
+		supportedSourceRoles: sourceRoles(manifest.supportedSourceRoles),
 		maxSources: positiveInteger(manifest.maxSources, "memory Strategy maxSources", 1e3),
 		maxRoutes: positiveInteger(manifest.maxRoutes, "memory Strategy maxRoutes", 1e3),
 		maxActions: positiveInteger(manifest.maxActions, "memory Strategy maxActions", 1e3),
@@ -241,7 +254,7 @@ function defineMemoryStrategyExtension(definition) {
 			...manifest,
 			packageName,
 			typeId: id(manifest.typeId, "memory Strategy extension typeId"),
-			strategyTypeId: id(manifest.strategyTypeId, "memory Strategy extension target"),
+			strategyTypeId: manifest.strategyTypeId === "*" ? anyStrategyTarget(manifest.slot) : id(manifest.strategyTypeId, "memory Strategy extension target"),
 			slot: id(manifest.slot, "memory Strategy extension slot")
 		}, "memory Strategy extension manifest"),
 		contribute: definition.contribute

package/lib/extension-sdk.js

@@ -1,13 +1,12 @@
-import { a as memoryConfigurationDigest, c as record, d as truncate, f as withMemoryStorageLock, i as integer, l as stringArray, o as migrationLineage, s as receipt, t as defineMemoryStrategyConfiguration, u as text } from "./strategy-configuration-D8IEKZdS.js";
-import { a as defineMemoryStrategy, i as defineMemorySource, o as defineMemoryStrategyExtension, r as defineMemoryPlugin } from "./definitions-CSPV0ER1.js";
+import { a as memoryConfigurationDigest, c as record, d as truncate, f as withMemoryStorageLock, i as integer, l as stringArray, o as migrationLineage, s as receipt, t as defineMemoryStrategyConfiguration, u as text } from "./strategy-configuration-sVkKToSW.js";
+import { COMPOSABLE_MEMORY_API_VERSION, MEMORY_VIEW_EXTENSION_SLOTS } from "./contracts.js";
+import { a as defineMemoryStrategy, i as defineMemorySource, o as defineMemoryStrategyExtension, r as defineMemoryPlugin } from "./definitions-j9QPbrXb.js";
 //#region src/sdk/install.ts
 function stableEntryId(ctx, explicit) {
 	const configured = explicit?.trim();
 	if (configured !== void 0 && configured !== "") return configured;
 	const located = ctx.get("loader", false)?.locate(ctx.fiber)?.trim();
 	if (located !== void 0 && located !== "") return located;
-	const entryId = ctx.fiber.entry?.options?.id;
-	if (typeof entryId === "string" && entryId.trim() !== "") return entryId.trim();
 	throw new Error("installMemory requires a stable Loader Entry id; pass options.instanceId for direct ctx.plugin() mounts");
 }
 /**
@@ -22,4 +21,75 @@ function installMemory(ctx, contribution, options = {}) {
 	}), `dsh-mnemon: install ${entryId}`);
 }
 //#endregion
-export { receipt as createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMemoryStrategyConfiguration, defineMemoryStrategyExtension, installMemory, memoryConfigurationDigest, integer as memoryInputInteger, migrationLineage as memoryInputMigrationLineage, record as memoryInputRecord, stringArray as memoryInputStringArray, text as memoryInputText, truncate as truncateMemoryText, withMemoryStorageLock };
+//#region src/sdk/view-extensions.ts
+const SOURCE_KEY = /^source:[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,292}$/u;
+const ACTION_ID = /^[a-z][a-z0-9-]{0,127}$/u;
+const FIELDS = {
+	selection: ["sourceKeys", "writableSourceKeys"],
+	projection: ["maxProjectionCharacters"],
+	capture: [
+		"instruction",
+		"actionIds",
+		"sourceKeys"
+	]
+};
+function sourceKeys(value, label) {
+	if (!Array.isArray(value) || value.length > 32 || value.some((key) => typeof key !== "string" || !SOURCE_KEY.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];
+}
+/** Validate one standard View extension value; a Strategy validates again before interpreting it. */
+function validateMemoryViewExtension(slot, value) {
+	if (!MEMORY_VIEW_EXTENSION_SLOTS.includes(slot)) throw new Error(`unsupported View extension slot: ${String(slot)}`);
+	const input = record(value, `View ${slot} contribution`);
+	for (const key of Object.keys(input)) if (!FIELDS[slot].includes(key)) throw new Error(`unsupported View ${slot} field: ${key}`);
+	let result;
+	if (slot === "selection") {
+		const selected = sourceKeys(input.sourceKeys, "sourceKeys");
+		const writable = input.writableSourceKeys === void 0 ? void 0 : sourceKeys(input.writableSourceKeys, "writableSourceKeys");
+		if (writable?.some((key) => !selected.includes(key))) throw new Error("writableSourceKeys must be within selected sourceKeys");
+		result = {
+			sourceKeys: selected,
+			...writable === void 0 ? {} : { writableSourceKeys: writable }
+		};
+	} else if (slot === "projection") {
+		if (input.maxProjectionCharacters === void 0) throw new Error("maxProjectionCharacters is required");
+		result = { maxProjectionCharacters: integer(input.maxProjectionCharacters, 4096, 1, 1e7) };
+	} else {
+		const actionIds = input.actionIds;
+		if (!Array.isArray(actionIds) || actionIds.length === 0 || actionIds.length > 32 || actionIds.some((id) => typeof id !== "string" || !ACTION_ID.test(id)) || new Set(actionIds).size !== actionIds.length) throw new Error("capture actionIds must name 1..32 distinct Source-local recording actions");
+		result = {
+			instruction: text(input.instruction, "capture instruction", 4e3),
+			actionIds: [...actionIds],
+			...input.sourceKeys === void 0 ? {} : { sourceKeys: sourceKeys(input.sourceKeys, "capture sourceKeys") }
+		};
+	}
+	return result;
+}
+/** Standard values contributed to one composition; each slot has at most one owner. */
+function memoryViewExtensionValues(contributions) {
+	const output = {};
+	for (const contribution of contributions) {
+		const slot = contribution.slot;
+		if (Object.hasOwn(output, slot)) throw new Error(`duplicate View extension slot: ${slot}`);
+		Object.assign(output, { [slot]: validateMemoryViewExtension(slot, contribution.value) });
+	}
+	return output;
+}
+/** An extension for whichever selected Strategy declares its standard slot. */
+function defineMemoryViewExtension(definition) {
+	return defineMemoryStrategyExtension({
+		manifest: {
+			apiVersion: COMPOSABLE_MEMORY_API_VERSION,
+			kind: "strategy-extension",
+			typeId: definition.typeId,
+			packageName: definition.packageName,
+			strategyTypeId: "*",
+			slot: definition.slot,
+			deterministic: true
+		},
+		contribute: (request, sources) => validateMemoryViewExtension(definition.slot, definition.contribute(request, sources))
+	});
+}
+//#endregion
+export { receipt as createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMemoryStrategyConfiguration, defineMemoryStrategyExtension, defineMemoryViewExtension, installMemory, memoryConfigurationDigest, integer as memoryInputInteger, migrationLineage as memoryInputMigrationLineage, record as memoryInputRecord, stringArray as memoryInputStringArray, text as memoryInputText, memoryViewExtensionValues, truncate as truncateMemoryText, validateMemoryViewExtension, withMemoryStorageLock };