@manta-eu/client 0.1.0

package/dist/shared/memory-decay.d.ts

@@ -0,0 +1,22 @@
+export declare const personalMemoryScope = "user";
+export type MemoryDecayCandidate = {
+    scope?: string | null;
+    memoryUseCount?: number | null;
+    memoryCiteCount?: number | null;
+    memoryLastUsedAt?: Date | string | null;
+};
+export declare const preloadedUseWeight = 1;
+export declare const citedUseWeight = 0;
+export type UseWeights = {
+    preloaded?: number;
+    cited?: number;
+};
+export declare function weightedUseCount(memory: MemoryDecayCandidate, weights?: UseWeights): number;
+export declare const decayUseCountCap = 20;
+export declare const decayHalfLifeDays = 7;
+export declare const decayDemotionThreshold = 0.5;
+export declare const decayHoldOutDays = 30;
+export declare function usageWeight(useCount: number | null | undefined, lastUsedAt: Date | string | null | undefined, now?: Date): number;
+export declare function coldOnsetDays(useCount: number): number;
+export declare function shouldDemoteOnUsage(memory: MemoryDecayCandidate, now?: Date, weights?: UseWeights): boolean;
+//# sourceMappingURL=memory-decay.d.ts.map

package/dist/shared/memory-decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-decay.d.ts","sourceRoot":"","sources":["../../src/shared/memory-decay.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAI3F;AAED,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,GAAG,GAAE,IAAiB,GACrB,MAAM,CASR;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,GAAG,GAAE,IAAiB,EACtB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAYT"}

package/dist/shared/memory-decay.js

@@ -0,0 +1,43 @@
+import { msPerDay, parseMemoryDate } from "./memory-dates.js";
+export const personalMemoryScope = "user";
+export const preloadedUseWeight = 1;
+export const citedUseWeight = 0;
+export function weightedUseCount(memory, weights) {
+    const preloaded = Math.max(memory.memoryUseCount ?? 0, 0) * (weights?.preloaded ?? preloadedUseWeight);
+    const cited = Math.max(memory.memoryCiteCount ?? 0, 0) * (weights?.cited ?? citedUseWeight);
+    return preloaded + cited;
+}
+export const decayUseCountCap = 20;
+export const decayHalfLifeDays = 7;
+export const decayDemotionThreshold = 0.5;
+export const decayHoldOutDays = 30;
+export function usageWeight(useCount, lastUsedAt, now = new Date()) {
+    const uses = Math.min(Math.max(useCount ?? 0, 0), decayUseCountCap);
+    if (uses === 0)
+        return 0;
+    const lastUsed = parseMemoryDate(lastUsedAt);
+    if (!lastUsed)
+        return uses;
+    const days = Math.max((now.getTime() - lastUsed.getTime()) / msPerDay, 0);
+    return uses * Math.pow(0.5, days / decayHalfLifeDays);
+}
+export function coldOnsetDays(useCount) {
+    // Floor at the demotion threshold, not 1: a fractional weighted count is already below it at day 0,
+    // so clamping to 1 would report an onset the decay curve never had.
+    const uses = Math.min(Math.max(useCount, decayDemotionThreshold), decayUseCountCap);
+    return decayHalfLifeDays * Math.log2(uses / decayDemotionThreshold);
+}
+export function shouldDemoteOnUsage(memory, now = new Date(), weights) {
+    if (memory.scope !== personalMemoryScope)
+        return false;
+    const uses = weightedUseCount(memory, weights);
+    if (uses <= 0)
+        return false;
+    if (usageWeight(uses, memory.memoryLastUsedAt, now) >= decayDemotionThreshold)
+        return false;
+    const lastUsed = parseMemoryDate(memory.memoryLastUsedAt);
+    if (!lastUsed)
+        return false;
+    const daysSinceUse = (now.getTime() - lastUsed.getTime()) / msPerDay;
+    return daysSinceUse < coldOnsetDays(uses) + decayHoldOutDays;
+}

package/dist/shared/memory-diversity.d.ts

@@ -0,0 +1,10 @@
+export declare const memoryRedundancyThreshold = 0.6;
+export declare const memoryDiversityCandidateMultiplier = 3;
+export type DiversityCandidate = {
+    label?: string | null;
+    description?: string | null;
+};
+export declare function memoryTokens(memory: DiversityCandidate): Set<string>;
+export declare function jaccardSimilarity(a: Set<string>, b: Set<string>): number;
+export declare function selectDiverseMemories<T extends DiversityCandidate>(candidates: readonly T[], limit: number, threshold?: number): T[];
+//# sourceMappingURL=memory-diversity.d.ts.map

package/dist/shared/memory-diversity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-diversity.d.ts","sourceRoot":"","sources":["../../src/shared/memory-diversity.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAMF,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,CAAC,CAIpE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAMxE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,EAChE,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAkC,GAC5C,CAAC,EAAE,CAuBL"}

package/dist/shared/memory-diversity.js

@@ -0,0 +1,44 @@
+export const memoryRedundancyThreshold = 0.6;
+export const memoryDiversityCandidateMultiplier = 3;
+const tokenPattern = /[a-z0-9]+/g;
+const minimumTokenLength = 3;
+export function memoryTokens(memory) {
+    const text = `${memory.label ?? ""} ${memory.description ?? ""}`.toLowerCase();
+    const tokens = text.match(tokenPattern) ?? [];
+    return new Set(tokens.filter((t) => t.length >= minimumTokenLength));
+}
+export function jaccardSimilarity(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let shared = 0;
+    for (const token of a)
+        if (b.has(token))
+            shared += 1;
+    const union = a.size + b.size - shared;
+    return union === 0 ? 0 : shared / union;
+}
+export function selectDiverseMemories(candidates, limit, threshold = memoryRedundancyThreshold) {
+    if (limit <= 0)
+        return [];
+    if (candidates.length <= limit)
+        return [...candidates];
+    const tokens = candidates.map(memoryTokens);
+    const taken = [];
+    const skipped = [];
+    for (let i = 0; i < candidates.length && taken.length < limit; i += 1) {
+        const redundant = taken.some((j) => jaccardSimilarity(tokens[i] ?? new Set(), tokens[j] ?? new Set()) >= threshold);
+        if (redundant)
+            skipped.push(i);
+        else
+            taken.push(i);
+    }
+    for (const i of skipped) {
+        if (taken.length >= limit)
+            break;
+        taken.push(i);
+    }
+    return taken
+        .sort((a, b) => a - b)
+        .map((i) => candidates[i])
+        .filter((memory) => memory !== undefined);
+}

package/dist/shared/memory-entity-recall.d.ts

@@ -0,0 +1,8 @@
+export declare const entityHopLimit = 8;
+export declare const entityLabelMatchLimit = 6;
+export type EntityHopCandidate = {
+    aboutEntityIris?: readonly string[] | null;
+};
+export declare function collectAboutEntities(memories: readonly EntityHopCandidate[], limit?: number): string[];
+export declare function withoutEntities(entityIris: readonly string[], exclude: readonly string[]): string[];
+//# sourceMappingURL=memory-entity-recall.d.ts.map

package/dist/shared/memory-entity-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-entity-recall.d.ts","sourceRoot":"","sources":["../../src/shared/memory-entity-recall.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAAG;IAAE,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAEhF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,KAAK,GAAE,MAAuB,GAC7B,MAAM,EAAE,CAWV;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAGnG"}

package/dist/shared/memory-entity-recall.js

@@ -0,0 +1,17 @@
+export const entityHopLimit = 8;
+export const entityLabelMatchLimit = 6;
+export function collectAboutEntities(memories, limit = entityHopLimit) {
+    const seen = new Set();
+    for (const memory of memories) {
+        for (const iri of memory.aboutEntityIris ?? []) {
+            if (seen.size >= limit)
+                return [...seen];
+            seen.add(iri);
+        }
+    }
+    return [...seen];
+}
+export function withoutEntities(entityIris, exclude) {
+    const excluded = new Set(exclude);
+    return entityIris.filter((iri) => !excluded.has(iri));
+}

package/dist/shared/memory-importance.d.ts

@@ -0,0 +1,4 @@
+export declare const defaultMemoryImportance = 3;
+export declare function clampImportance(value: number): number;
+export declare function clampImportanceForVolatility(value: number, volatility: unknown): number;
+//# sourceMappingURL=memory-importance.d.ts.map

package/dist/shared/memory-importance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-importance.d.ts","sourceRoot":"","sources":["../../src/shared/memory-importance.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAEvF"}

package/dist/shared/memory-importance.js

@@ -0,0 +1,9 @@
+import { clamp } from "ramda";
+import { maxImportanceForVolatility } from "./memory-volatility.js";
+export const defaultMemoryImportance = 3;
+export function clampImportance(value) {
+    return clamp(1, 5, Math.round(value));
+}
+export function clampImportanceForVolatility(value, volatility) {
+    return Math.min(clampImportance(value), maxImportanceForVolatility(volatility));
+}

package/dist/shared/memory-keyword-recall.d.ts

@@ -0,0 +1,13 @@
+import { type DiversityCandidate } from "./memory-diversity.js";
+export declare const rankFusionConstant = 60;
+export declare const maxKeywordTerms = 8;
+export type KeywordCandidate = DiversityCandidate & {
+    iri: string;
+};
+export declare function keywordTerms(text: string, limit?: number): string[];
+export declare function keywordOverlap(memory: DiversityCandidate, terms: readonly string[]): number;
+export declare function fuseRankings<T extends {
+    iri: string;
+}>(lists: readonly (readonly T[])[]): T[];
+export declare function fuseKeywordRanking<T extends KeywordCandidate>(semanticOrder: readonly T[], queryText: string): T[];
+//# sourceMappingURL=memory-keyword-recall.d.ts.map

package/dist/shared/memory-keyword-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-keyword-recall.d.ts","sourceRoot":"","sources":["../../src/shared/memory-keyword-recall.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAgGpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAwB,GAAG,MAAM,EAAE,CAKpF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM3F;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAe7F;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,CAalH"}

package/dist/shared/memory-keyword-recall.js

@@ -0,0 +1,141 @@
+import { isPresent } from "@manta-eu/lib/present";
+import { memoryTokens } from "./memory-diversity.js";
+export const rankFusionConstant = 60;
+export const maxKeywordTerms = 8;
+// A term feeds a SPARQL CONTAINS that admits rows, so a stray function word like "the" would widen the pool to the
+// entire store.
+const stopWords = new Set([
+    "the",
+    "and",
+    "but",
+    "for",
+    "not",
+    "you",
+    "your",
+    "our",
+    "are",
+    "was",
+    "were",
+    "has",
+    "have",
+    "had",
+    "with",
+    "from",
+    "that",
+    "this",
+    "these",
+    "those",
+    "what",
+    "when",
+    "where",
+    "which",
+    "who",
+    "why",
+    "how",
+    "can",
+    "could",
+    "would",
+    "should",
+    "will",
+    "shall",
+    "may",
+    "might",
+    "must",
+    "there",
+    "their",
+    "them",
+    "they",
+    "its",
+    "his",
+    "her",
+    "him",
+    "she",
+    "here",
+    "into",
+    "onto",
+    "over",
+    "under",
+    "about",
+    "than",
+    "then",
+    "some",
+    "any",
+    "all",
+    "both",
+    "each",
+    "more",
+    "most",
+    "other",
+    "such",
+    "only",
+    "own",
+    "same",
+    "too",
+    "very",
+    "just",
+    "now",
+    "get",
+    "got",
+    "let",
+    "make",
+    "made",
+    "does",
+    "did",
+    "done",
+    "been",
+    "being",
+    "also",
+    "well",
+    "much",
+    "many",
+    "like",
+    "want",
+    "need",
+    "give",
+    "take",
+    "see",
+]);
+export function keywordTerms(text, limit = maxKeywordTerms) {
+    return [...memoryTokens({ label: text })]
+        .filter((token) => !stopWords.has(token))
+        .sort((a, b) => b.length - a.length || a.localeCompare(b))
+        .slice(0, limit);
+}
+export function keywordOverlap(memory, terms) {
+    if (!isPresent(terms))
+        return 0;
+    const tokens = memoryTokens(memory);
+    let hits = 0;
+    for (const term of terms)
+        if (tokens.has(term))
+            hits += 1;
+    return hits;
+}
+export function fuseRankings(lists) {
+    const scores = new Map();
+    const byIri = new Map();
+    for (const list of lists) {
+        list.forEach((item, rank) => {
+            scores.set(item.iri, (scores.get(item.iri) ?? 0) + 1 / (rankFusionConstant + rank));
+            if (!byIri.has(item.iri))
+                byIri.set(item.iri, item);
+        });
+    }
+    return [...scores.entries()]
+        .sort(([iriA, scoreA], [iriB, scoreB]) => scoreB - scoreA || iriA.localeCompare(iriB))
+        .map(([iri]) => byIri.get(iri))
+        .filter((item) => item !== undefined);
+}
+export function fuseKeywordRanking(semanticOrder, queryText) {
+    const terms = keywordTerms(queryText);
+    if (!isPresent(terms) || !isPresent(semanticOrder))
+        return [...semanticOrder];
+    const keywordOrder = semanticOrder
+        .map((memory) => ({ memory, hits: keywordOverlap(memory, terms) }))
+        .filter((scored) => scored.hits > 0)
+        .sort((a, b) => b.hits - a.hits)
+        .map((scored) => scored.memory);
+    if (!isPresent(keywordOrder))
+        return [...semanticOrder];
+    return fuseRankings([semanticOrder, keywordOrder]);
+}

package/dist/shared/memory-kind-iris.d.ts

@@ -0,0 +1,9 @@
+export declare const memoryKinds: readonly ["preference", "fact", "objective", "context"];
+export type MemoryKind = (typeof memoryKinds)[number];
+export declare const memoryKindIris: Record<MemoryKind, string>;
+export type MemoryKindIri = (typeof memoryKindIris)[MemoryKind];
+export declare function isKindIri(iri: string): boolean;
+export declare function kindIriToKind(iri: string): MemoryKind | null;
+export declare function kindIriToLabel(iri: string): string | null;
+export declare function kindToKindIri(kind: MemoryKind): string;
+//# sourceMappingURL=memory-kind-iris.d.ts.map

package/dist/shared/memory-kind-iris.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kind-iris.d.ts","sourceRoot":"","sources":["../../src/shared/memory-kind-iris.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,yDAA0D,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAItD,eAAO,MAAM,cAAc,EAEtB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEhC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC;AAQhE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAE5D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEtD"}

package/dist/shared/memory-kind-iris.js

@@ -0,0 +1,22 @@
+import { vocabBase } from "@manta-eu/ldo/realm";
+// GraphQL MemoryKind, backend valid-kind?, and KG sh:in must stay in sync with this.
+export const memoryKinds = ["preference", "fact", "objective", "context"];
+const memoryKindIriBase = `${vocabBase}MemoryKind_`;
+export const memoryKindIris = Object.fromEntries(memoryKinds.map((kind) => [kind, `${memoryKindIriBase}${kind}`]));
+const iriToKind = new Map(memoryKinds.map((kind) => [memoryKindIris[kind], kind]));
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+export function isKindIri(iri) {
+    return iriToKind.has(iri);
+}
+export function kindIriToKind(iri) {
+    return iriToKind.get(iri) ?? null;
+}
+export function kindIriToLabel(iri) {
+    const kind = iriToKind.get(iri);
+    return kind ? capitalize(kind) : null;
+}
+export function kindToKindIri(kind) {
+    return memoryKindIris[kind];
+}

package/dist/shared/memory-preload-gate.d.ts

@@ -0,0 +1,37 @@
+import { parseMemoryDate } from "./memory-dates.js";
+import { type UseWeights } from "./memory-decay.js";
+export { parseMemoryDate };
+export type { UseWeights };
+export declare const memoryPreloadConfidenceThreshold = 0.75;
+export declare const memoryPreloadImportanceThreshold = 4;
+export declare const memorySearchImportanceThreshold = 2;
+export declare const memoryPreloadRowLimit = 20;
+export declare const companyMemoryScope = "company";
+export declare const validFromWorthShowingDays = 2;
+export declare const trustedUntilExpiringSoonDays = 7;
+export type MemoryPreloadCandidate = {
+    importance: number;
+    confidence?: number | null;
+    memoryValidUntil?: Date | string | null;
+    memoryValidFrom?: Date | string | null;
+    memoryTrustedUntil?: Date | string | null;
+    memoryUseCount?: number | null;
+    memoryCiteCount?: number | null;
+    memoryLastUsedAt?: Date | string | null;
+    scope?: string | null;
+    supersededBy?: string | null;
+};
+export type MemoryPreloadExclusion = "archived" | "importance" | "confidence" | "stale" | "expired" | "scheduled" | "cold";
+export declare function isPastTrustedUntilAt(memoryTrustedUntil: Date | string | null | undefined, now: Date): boolean;
+export declare function isTrustedUntilExpiringSoon(memoryTrustedUntil: Date | string | null | undefined, now: Date): boolean;
+export declare function isMemoryArchived(memory: MemoryPreloadCandidate): boolean;
+export declare function isNeverUsed(memory: MemoryPreloadCandidate, now?: Date): boolean;
+export declare function needsTrustReview(memory: MemoryPreloadCandidate, now?: Date): boolean;
+export declare function isMemorySearchable(memory: MemoryPreloadCandidate): boolean;
+export declare function memoryPreloadQueryExclusions(memory: MemoryPreloadCandidate, now?: Date): MemoryPreloadExclusion[];
+export declare function isMemoryQueryGateEligible(memory: MemoryPreloadCandidate, now?: Date): boolean;
+export declare function memoryPreloadExclusions(memory: MemoryPreloadCandidate, now?: Date, weights?: UseWeights): MemoryPreloadExclusion[];
+export declare function isMemoryPreloaded(memory: MemoryPreloadCandidate, now?: Date, weights?: UseWeights): boolean;
+export declare function describeMemoryPreloadExclusions(memory: MemoryPreloadCandidate, exclusions: MemoryPreloadExclusion[]): string;
+export declare function describeMemoryPreload(memory: MemoryPreloadCandidate, now?: Date): string;
+//# sourceMappingURL=memory-preload-gate.d.ts.map

package/dist/shared/memory-preload-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-preload-gate.d.ts","sourceRoot":"","sources":["../../src/shared/memory-preload-gate.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,SAAS,GACT,WAAW,GACX,MAAM,CAAC;AAEX,wBAAgB,oBAAoB,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAG7G;AAID,wBAAgB,0BAA0B,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAInH;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAExE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAMhG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAE1E;AAGD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE,IAAiB,GACrB,sBAAsB,EAAE,CAoB1B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAEzG;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE,IAAiB,EACtB,OAAO,CAAC,EAAE,UAAU,GACnB,sBAAsB,EAAE,CAK1B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,GAAG,GAAE,IAAiB,EACtB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAET;AAYD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,sBAAsB,EAAE,GACnC,MAAM,CASR;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEpG"}

package/dist/shared/memory-preload-gate.js

@@ -0,0 +1,95 @@
+import { isPresent } from "@manta-eu/lib/present";
+import { msPerDay, parseMemoryDate } from "./memory-dates.js";
+import { shouldDemoteOnUsage } from "./memory-decay.js";
+export { parseMemoryDate };
+export const memoryPreloadConfidenceThreshold = 0.75;
+export const memoryPreloadImportanceThreshold = 4;
+export const memorySearchImportanceThreshold = 2;
+export const memoryPreloadRowLimit = 20;
+export const companyMemoryScope = "company";
+export const validFromWorthShowingDays = 2;
+export const trustedUntilExpiringSoonDays = 7;
+export function isPastTrustedUntilAt(memoryTrustedUntil, now) {
+    const horizon = parseMemoryDate(memoryTrustedUntil);
+    return horizon != null && horizon <= now;
+}
+// Elapsed time, not calendar days: this module runs in the browser too, where the local zone would
+// shift the boundary by a day either side of UTC.
+export function isTrustedUntilExpiringSoon(memoryTrustedUntil, now) {
+    const horizon = parseMemoryDate(memoryTrustedUntil);
+    if (horizon == null || horizon <= now)
+        return false;
+    return horizon.getTime() - now.getTime() <= trustedUntilExpiringSoonDays * msPerDay;
+}
+export function isMemoryArchived(memory) {
+    return isPresent(memory.supersededBy);
+}
+export function isNeverUsed(memory, now = new Date()) {
+    return isMemoryPreloaded(memory, now) && (memory.memoryUseCount ?? 0) + (memory.memoryCiteCount ?? 0) === 0;
+}
+export function needsTrustReview(memory, now = new Date()) {
+    if (isMemoryArchived(memory))
+        return false;
+    if (memory.memoryValidUntil)
+        return false;
+    return (isPastTrustedUntilAt(memory.memoryTrustedUntil, now) || isTrustedUntilExpiringSoon(memory.memoryTrustedUntil, now));
+}
+export function isMemorySearchable(memory) {
+    return !isMemoryArchived(memory) && memory.importance >= memorySearchImportanceThreshold;
+}
+// Mirrors the SPARQL pre-load gate; "cold" stays client-side since decay is weighted per caller.
+export function memoryPreloadQueryExclusions(memory, now = new Date()) {
+    const exclusions = [];
+    if (isMemoryArchived(memory))
+        exclusions.push("archived");
+    if (memory.importance < memoryPreloadImportanceThreshold)
+        exclusions.push("importance");
+    if (memory.scope !== companyMemoryScope &&
+        memory.confidence != null &&
+        memory.confidence < memoryPreloadConfidenceThreshold) {
+        exclusions.push("confidence");
+    }
+    if (isPastTrustedUntilAt(memory.memoryTrustedUntil, now))
+        exclusions.push("stale");
+    // Mirrors liveContextMemoryDateFilter: the query drops on all three date predicates, not just trust.
+    const validUntil = parseMemoryDate(memory.memoryValidUntil);
+    if (validUntil != null && validUntil <= now)
+        exclusions.push("expired");
+    const validFrom = parseMemoryDate(memory.memoryValidFrom);
+    if (validFrom != null && validFrom > now)
+        exclusions.push("scheduled");
+    return exclusions;
+}
+export function isMemoryQueryGateEligible(memory, now = new Date()) {
+    return !isPresent(memoryPreloadQueryExclusions(memory, now));
+}
+export function memoryPreloadExclusions(memory, now = new Date(), weights) {
+    const exclusions = memoryPreloadQueryExclusions(memory, now);
+    if (shouldDemoteOnUsage(memory, now, weights))
+        exclusions.push("cold");
+    return exclusions;
+}
+export function isMemoryPreloaded(memory, now = new Date(), weights) {
+    return !isPresent(memoryPreloadExclusions(memory, now, weights));
+}
+const exclusionReasons = {
+    archived: "it was replaced by a newer memory",
+    importance: `importance is below ${memoryPreloadImportanceThreshold} (High)`,
+    confidence: `confidence is below ${memoryPreloadConfidenceThreshold} — it has not been reviewed`,
+    stale: "it is no longer trusted and needs re-confirming",
+    expired: "its expiry date has passed",
+    scheduled: "it does not take effect until a later date",
+    cold: "nothing has used it in a long time, so it no longer earns a place in every prompt",
+};
+export function describeMemoryPreloadExclusions(memory, exclusions) {
+    if (!isPresent(exclusions)) {
+        return `In your assistant's context, up to ${memoryPreloadRowLimit} per scope on any one turn (most relevant first).`;
+    }
+    const reasons = exclusions.map((exclusion) => exclusionReasons[exclusion]).join("; ");
+    return isMemorySearchable(memory)
+        ? `Not in context: ${reasons}. Still retrievable with searchMemories.`
+        : `Not in context: ${reasons}. Not retrievable with searchMemories either.`;
+}
+export function describeMemoryPreload(memory, now = new Date()) {
+    return describeMemoryPreloadExclusions(memory, memoryPreloadExclusions(memory, now));
+}

package/dist/shared/memory-sources.d.ts

@@ -0,0 +1,3 @@
+export declare const userManualMemorySource: string;
+export declare const derivedAbstractionMemorySource: string;
+//# sourceMappingURL=memory-sources.d.ts.map

package/dist/shared/memory-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-sources.d.ts","sourceRoot":"","sources":["../../src/shared/memory-sources.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAElE,eAAO,MAAM,8BAA8B,QAAsC,CAAC"}

package/dist/shared/memory-sources.js

@@ -0,0 +1,3 @@
+import { expandPrefix } from "./rdf-namespaces.js";
+export const userManualMemorySource = expandPrefix(":UserManual");
+export const derivedAbstractionMemorySource = expandPrefix(":DerivedAbstraction");

package/dist/shared/memory-teams.d.ts

@@ -0,0 +1,2 @@
+export declare function unionOfTeams(teamSets: readonly (readonly string[] | null | undefined)[]): string[];
+//# sourceMappingURL=memory-teams.d.ts.map

package/dist/shared/memory-teams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-teams.d.ts","sourceRoot":"","sources":["../../src/shared/memory-teams.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,CAElG"}

package/dist/shared/memory-teams.js

@@ -0,0 +1,3 @@
+export function unionOfTeams(teamSets) {
+    return [...new Set(teamSets.flatMap((teams) => teams ?? []))];
+}

package/dist/shared/memory-token-budget.d.ts

@@ -0,0 +1,8 @@
+export declare const charsPerTokenEstimate = 4;
+export declare const memoryPreloadRowTokenAllowance = 120;
+export declare const memoryPreloadTokenBudgetPerBlock: number;
+export declare const memoryPreloadBlockCount = 3;
+export declare const memoryPreloadTokenBudgetTotal: number;
+export declare function estimateTokens(text: string): number;
+export declare function packToBudget<T>(items: readonly T[], cost: (item: T) => number, budget: number): T[];
+//# sourceMappingURL=memory-token-budget.d.ts.map

package/dist/shared/memory-token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-token-budget.d.ts","sourceRoot":"","sources":["../../src/shared/memory-token-budget.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,eAAO,MAAM,gCAAgC,QAAyD,CAAC;AAEvG,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,6BAA6B,QAA6D,CAAC;AAExG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAYnG"}

package/dist/shared/memory-token-budget.js

@@ -0,0 +1,23 @@
+import { isPresent } from "@manta-eu/lib/present";
+import { memoryPreloadRowLimit } from "./memory-preload-gate.js";
+// 4 chars/token approximates English prose; the serving model's real tokenizer is not available in the Worker.
+export const charsPerTokenEstimate = 4;
+export const memoryPreloadRowTokenAllowance = 120;
+export const memoryPreloadTokenBudgetPerBlock = memoryPreloadRowLimit * memoryPreloadRowTokenAllowance;
+export const memoryPreloadBlockCount = 3;
+export const memoryPreloadTokenBudgetTotal = memoryPreloadTokenBudgetPerBlock * memoryPreloadBlockCount;
+export function estimateTokens(text) {
+    return Math.ceil(text.length / charsPerTokenEstimate);
+}
+export function packToBudget(items, cost, budget) {
+    const kept = [];
+    let spent = 0;
+    for (const item of items) {
+        const itemCost = cost(item);
+        if (isPresent(kept) && spent + itemCost > budget)
+            continue;
+        kept.push(item);
+        spent += itemCost;
+    }
+    return kept;
+}

package/dist/shared/memory-volatility.d.ts

@@ -0,0 +1,24 @@
+export declare const memoryVolatilities: readonly ["stable", "slow", "volatile"];
+export type MemoryVolatility = (typeof memoryVolatilities)[number];
+export type MemoryVolatilityRule = {
+    trustDays: number | null;
+    maxImportance: number;
+};
+export declare const volatilityRules: Record<MemoryVolatility, MemoryVolatilityRule>;
+export declare const defaultMemoryVolatility: MemoryVolatility;
+export declare function isMemoryVolatility(value: unknown): value is MemoryVolatility;
+export declare function normalizeVolatility(value: unknown): MemoryVolatility;
+export declare function volatilityTrustDays(volatility: unknown): number | null;
+export declare function maxImportanceForVolatility(volatility: unknown): number;
+export declare const volatilityInferenceSlack = 1.5;
+export declare function inferVolatility(memoryTrustedUntil: Date | string | null | undefined, since: Date | string | null | undefined): MemoryVolatility;
+export type VolatilityTrace = {
+    memoryTrustedUntil?: Date | string | null;
+    memoryValidUntil?: Date | string | null;
+    extractedAt?: Date | string | null;
+};
+export declare function isDeadlineDerivedHorizon(memoryTrustedUntil: Date | string | null | undefined, memoryValidUntil: Date | string | null | undefined): boolean;
+export declare function importanceCeilingFor(memory: VolatilityTrace): number;
+export declare function capHorizonByDeadline(horizon: string | null, memoryValidUntil: string | null, now?: Date): string | null;
+export declare function resolveTrustedUntil(volatility: unknown, memoryValidUntil: string | null, now?: Date): string | null;
+//# sourceMappingURL=memory-volatility.d.ts.map

package/dist/shared/memory-volatility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-volatility.d.ts","sourceRoot":"","sources":["../../src/shared/memory-volatility.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,yCAA0C,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,CAI1E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAAyB,CAAC;AAEhE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAEtE;AAED,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACpD,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,gBAAgB,CAUlB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,kBAAkB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACpD,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAIT;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAIpE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,GAAG,GAAE,IAAiB,GACrB,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,GAAG,GAAE,IAAiB,GACrB,MAAM,GAAG,IAAI,CAIf"}