@mnemoai/core 1.1.0 → 1.1.1

package/dist/src/reflection-item-store.js

@@ -0,0 +1,69 @@
+const REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS = 45;
+const REFLECTION_INVARIANT_DECAY_K = 0.22;
+const REFLECTION_INVARIANT_BASE_WEIGHT = 1.1;
+const REFLECTION_INVARIANT_QUALITY = 1;
+const REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS = 7;
+const REFLECTION_DERIVED_DECAY_K = 0.65;
+const REFLECTION_DERIVED_BASE_WEIGHT = 1;
+const REFLECTION_DERIVED_QUALITY = 0.95;
+function getReflectionItemDecayDefaults(itemKind) {
+  if (itemKind === "invariant") {
+    return {
+      midpointDays: REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,
+      k: REFLECTION_INVARIANT_DECAY_K,
+      baseWeight: REFLECTION_INVARIANT_BASE_WEIGHT,
+      quality: REFLECTION_INVARIANT_QUALITY
+    };
+  }
+  return {
+    midpointDays: REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,
+    k: REFLECTION_DERIVED_DECAY_K,
+    baseWeight: REFLECTION_DERIVED_BASE_WEIGHT,
+    quality: REFLECTION_DERIVED_QUALITY
+  };
+}
+function buildReflectionItemPayloads(params) {
+  return params.items.map((item) => {
+    const defaults = getReflectionItemDecayDefaults(item.itemKind);
+    const metadata = {
+      type: "memory-reflection-item",
+      reflectionVersion: 4,
+      stage: "reflect-store",
+      eventId: params.eventId,
+      itemKind: item.itemKind,
+      section: item.section,
+      ordinal: item.ordinal,
+      groupSize: item.groupSize,
+      agentId: params.agentId,
+      sessionKey: params.sessionKey,
+      sessionId: params.sessionId,
+      storedAt: params.runAt,
+      usedFallback: params.usedFallback,
+      errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),
+      decayModel: "logistic",
+      decayMidpointDays: defaults.midpointDays,
+      decayK: defaults.k,
+      baseWeight: defaults.baseWeight,
+      quality: defaults.quality,
+      ...params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}
+    };
+    return {
+      kind: item.itemKind === "invariant" ? "item-invariant" : "item-derived",
+      text: item.text,
+      metadata
+    };
+  });
+}
+export {
+  REFLECTION_DERIVED_BASE_WEIGHT,
+  REFLECTION_DERIVED_DECAY_K,
+  REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,
+  REFLECTION_DERIVED_QUALITY,
+  REFLECTION_INVARIANT_BASE_WEIGHT,
+  REFLECTION_INVARIANT_DECAY_K,
+  REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,
+  REFLECTION_INVARIANT_QUALITY,
+  buildReflectionItemPayloads,
+  getReflectionItemDecayDefaults
+};
+//# sourceMappingURL=reflection-item-store.js.map

package/dist/src/reflection-item-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-item-store.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport type { ReflectionSliceItem } from \"./reflection-slices.js\";\n\nexport type ReflectionItemKind = \"invariant\" | \"derived\";\n\nexport interface ReflectionItemMetadata {\n  type: \"memory-reflection-item\";\n  reflectionVersion: 4;\n  stage: \"reflect-store\";\n  eventId: string;\n  itemKind: ReflectionItemKind;\n  section: \"Invariants\" | \"Derived\";\n  ordinal: number;\n  groupSize: number;\n  agentId: string;\n  sessionKey: string;\n  sessionId: string;\n  storedAt: number;\n  usedFallback: boolean;\n  errorSignals: string[];\n  decayModel: \"logistic\";\n  decayMidpointDays: number;\n  decayK: number;\n  baseWeight: number;\n  quality: number;\n  sourceReflectionPath?: string;\n}\n\nexport interface ReflectionItemPayload {\n  kind: \"item-invariant\" | \"item-derived\";\n  text: string;\n  metadata: ReflectionItemMetadata;\n}\n\nexport interface BuildReflectionItemPayloadsParams {\n  items: ReflectionSliceItem[];\n  eventId: string;\n  agentId: string;\n  sessionKey: string;\n  sessionId: string;\n  runAt: number;\n  usedFallback: boolean;\n  toolErrorSignals: Array<{ signatureHash: string }>;\n  sourceReflectionPath?: string;\n}\n\nexport const REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS = 45;\nexport const REFLECTION_INVARIANT_DECAY_K = 0.22;\nexport const REFLECTION_INVARIANT_BASE_WEIGHT = 1.1;\nexport const REFLECTION_INVARIANT_QUALITY = 1;\n\nexport const REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS = 7;\nexport const REFLECTION_DERIVED_DECAY_K = 0.65;\nexport const REFLECTION_DERIVED_BASE_WEIGHT = 1;\nexport const REFLECTION_DERIVED_QUALITY = 0.95;\n\nexport function getReflectionItemDecayDefaults(itemKind: ReflectionItemKind): {\n  midpointDays: number;\n  k: number;\n  baseWeight: number;\n  quality: number;\n} {\n  if (itemKind === \"invariant\") {\n    return {\n      midpointDays: REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,\n      k: REFLECTION_INVARIANT_DECAY_K,\n      baseWeight: REFLECTION_INVARIANT_BASE_WEIGHT,\n      quality: REFLECTION_INVARIANT_QUALITY,\n    };\n  }\n\n  return {\n    midpointDays: REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,\n    k: REFLECTION_DERIVED_DECAY_K,\n    baseWeight: REFLECTION_DERIVED_BASE_WEIGHT,\n    quality: REFLECTION_DERIVED_QUALITY,\n  };\n}\n\nexport function buildReflectionItemPayloads(params: BuildReflectionItemPayloadsParams): ReflectionItemPayload[] {\n  return params.items.map((item) => {\n    const defaults = getReflectionItemDecayDefaults(item.itemKind);\n    const metadata: ReflectionItemMetadata = {\n      type: \"memory-reflection-item\",\n      reflectionVersion: 4,\n      stage: \"reflect-store\",\n      eventId: params.eventId,\n      itemKind: item.itemKind,\n      section: item.section,\n      ordinal: item.ordinal,\n      groupSize: item.groupSize,\n      agentId: params.agentId,\n      sessionKey: params.sessionKey,\n      sessionId: params.sessionId,\n      storedAt: params.runAt,\n      usedFallback: params.usedFallback,\n      errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),\n      decayModel: \"logistic\",\n      decayMidpointDays: defaults.midpointDays,\n      decayK: defaults.k,\n      baseWeight: defaults.baseWeight,\n      quality: defaults.quality,\n      ...(params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}),\n    };\n\n    return {\n      kind: item.itemKind === \"invariant\" ? \"item-invariant\" : \"item-derived\",\n      text: item.text,\n      metadata,\n    };\n  });\n}\n"],
+  "mappings": "AA8CO,MAAM,2CAA2C;AACjD,MAAM,+BAA+B;AACrC,MAAM,mCAAmC;AACzC,MAAM,+BAA+B;AAErC,MAAM,yCAAyC;AAC/C,MAAM,6BAA6B;AACnC,MAAM,iCAAiC;AACvC,MAAM,6BAA6B;AAEnC,SAAS,+BAA+B,UAK7C;AACA,MAAI,aAAa,aAAa;AAC5B,WAAO;AAAA,MACL,cAAc;AAAA,MACd,GAAG;AAAA,MACH,YAAY;AAAA,MACZ,SAAS;AAAA,IACX;AAAA,EACF;AAEA,SAAO;AAAA,IACL,cAAc;AAAA,IACd,GAAG;AAAA,IACH,YAAY;AAAA,IACZ,SAAS;AAAA,EACX;AACF;AAEO,SAAS,4BAA4B,QAAoE;AAC9G,SAAO,OAAO,MAAM,IAAI,CAAC,SAAS;AAChC,UAAM,WAAW,+BAA+B,KAAK,QAAQ;AAC7D,UAAM,WAAmC;AAAA,MACvC,MAAM;AAAA,MACN,mBAAmB;AAAA,MACnB,OAAO;AAAA,MACP,SAAS,OAAO;AAAA,MAChB,UAAU,KAAK;AAAA,MACf,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,WAAW,KAAK;AAAA,MAChB,SAAS,OAAO;AAAA,MAChB,YAAY,OAAO;AAAA,MACnB,WAAW,OAAO;AAAA,MAClB,UAAU,OAAO;AAAA,MACjB,cAAc,OAAO;AAAA,MACrB,cAAc,OAAO,iBAAiB,IAAI,CAAC,WAAW,OAAO,aAAa;AAAA,MAC1E,YAAY;AAAA,MACZ,mBAAmB,SAAS;AAAA,MAC5B,QAAQ,SAAS;AAAA,MACjB,YAAY,SAAS;AAAA,MACrB,SAAS,SAAS;AAAA,MAClB,GAAI,OAAO,uBAAuB,EAAE,sBAAsB,OAAO,qBAAqB,IAAI,CAAC;AAAA,IAC7F;AAEA,WAAO;AAAA,MACL,MAAM,KAAK,aAAa,cAAc,mBAAmB;AAAA,MACzD,MAAM,KAAK;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/src/reflection-mapped-metadata.d.ts

@@ -0,0 +1,47 @@
+import type { ReflectionMappedMemoryItem } from "./reflection-slices.js";
+export type ReflectionMappedKind = "user-model" | "agent-model" | "lesson" | "decision";
+export type ReflectionMappedCategory = "preference" | "fact" | "decision";
+export interface ReflectionMappedMetadata {
+    type: "memory-reflection-mapped";
+    reflectionVersion: 4;
+    stage: "reflect-store";
+    eventId: string;
+    mappedKind: ReflectionMappedKind;
+    mappedCategory: ReflectionMappedCategory;
+    section: string;
+    ordinal: number;
+    groupSize: number;
+    agentId: string;
+    sessionKey: string;
+    sessionId: string;
+    storedAt: number;
+    usedFallback: boolean;
+    errorSignals: string[];
+    decayModel: "logistic";
+    decayMidpointDays: number;
+    decayK: number;
+    baseWeight: number;
+    quality: number;
+    sourceReflectionPath?: string;
+}
+export interface ReflectionMappedDecayDefaults {
+    midpointDays: number;
+    k: number;
+    baseWeight: number;
+    quality: number;
+}
+export declare function getReflectionMappedDecayDefaults(kind: ReflectionMappedKind): ReflectionMappedDecayDefaults;
+export declare function buildReflectionMappedMetadata(params: {
+    mappedItem: ReflectionMappedMemoryItem;
+    eventId: string;
+    agentId: string;
+    sessionKey: string;
+    sessionId: string;
+    runAt: number;
+    usedFallback: boolean;
+    toolErrorSignals: Array<{
+        signatureHash: string;
+    }>;
+    sourceReflectionPath?: string;
+}): ReflectionMappedMetadata;
+//# sourceMappingURL=reflection-mapped-metadata.d.ts.map

package/dist/src/reflection-mapped-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-mapped-metadata.d.ts","sourceRoot":"","sources":["../../src/reflection-mapped-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,0BAA0B,CAAC;IACjC,iBAAiB,EAAE,CAAC,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,oBAAoB,CAAC;IACjC,cAAc,EAAE,wBAAwB,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,oBAAoB,GAAG,6BAA6B,CAE1G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,UAAU,EAAE,0BAA0B,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,wBAAwB,CAyB3B"}

package/dist/src/reflection-mapped-metadata.js

@@ -0,0 +1,40 @@
+const REFLECTION_MAPPED_DECAY_DEFAULTS = {
+  decision: { midpointDays: 45, k: 0.25, baseWeight: 1.1, quality: 1 },
+  "user-model": { midpointDays: 21, k: 0.3, baseWeight: 1, quality: 0.95 },
+  "agent-model": { midpointDays: 10, k: 0.35, baseWeight: 0.95, quality: 0.93 },
+  lesson: { midpointDays: 7, k: 0.45, baseWeight: 0.9, quality: 0.9 }
+};
+function getReflectionMappedDecayDefaults(kind) {
+  return REFLECTION_MAPPED_DECAY_DEFAULTS[kind];
+}
+function buildReflectionMappedMetadata(params) {
+  const defaults = getReflectionMappedDecayDefaults(params.mappedItem.mappedKind);
+  return {
+    type: "memory-reflection-mapped",
+    reflectionVersion: 4,
+    stage: "reflect-store",
+    eventId: params.eventId,
+    mappedKind: params.mappedItem.mappedKind,
+    mappedCategory: params.mappedItem.category,
+    section: params.mappedItem.heading,
+    ordinal: params.mappedItem.ordinal,
+    groupSize: params.mappedItem.groupSize,
+    agentId: params.agentId,
+    sessionKey: params.sessionKey,
+    sessionId: params.sessionId,
+    storedAt: params.runAt,
+    usedFallback: params.usedFallback,
+    errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),
+    decayModel: "logistic",
+    decayMidpointDays: defaults.midpointDays,
+    decayK: defaults.k,
+    baseWeight: defaults.baseWeight,
+    quality: defaults.quality,
+    ...params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}
+  };
+}
+export {
+  buildReflectionMappedMetadata,
+  getReflectionMappedDecayDefaults
+};
+//# sourceMappingURL=reflection-mapped-metadata.js.map

package/dist/src/reflection-mapped-metadata.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-mapped-metadata.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport type { ReflectionMappedMemoryItem } from \"./reflection-slices.js\";\n\nexport type ReflectionMappedKind = \"user-model\" | \"agent-model\" | \"lesson\" | \"decision\";\nexport type ReflectionMappedCategory = \"preference\" | \"fact\" | \"decision\";\n\nexport interface ReflectionMappedMetadata {\n  type: \"memory-reflection-mapped\";\n  reflectionVersion: 4;\n  stage: \"reflect-store\";\n  eventId: string;\n  mappedKind: ReflectionMappedKind;\n  mappedCategory: ReflectionMappedCategory;\n  section: string;\n  ordinal: number;\n  groupSize: number;\n  agentId: string;\n  sessionKey: string;\n  sessionId: string;\n  storedAt: number;\n  usedFallback: boolean;\n  errorSignals: string[];\n  decayModel: \"logistic\";\n  decayMidpointDays: number;\n  decayK: number;\n  baseWeight: number;\n  quality: number;\n  sourceReflectionPath?: string;\n}\n\nexport interface ReflectionMappedDecayDefaults {\n  midpointDays: number;\n  k: number;\n  baseWeight: number;\n  quality: number;\n}\n\nconst REFLECTION_MAPPED_DECAY_DEFAULTS: Record<ReflectionMappedKind, ReflectionMappedDecayDefaults> = {\n  decision: { midpointDays: 45, k: 0.25, baseWeight: 1.1, quality: 1 },\n  \"user-model\": { midpointDays: 21, k: 0.3, baseWeight: 1, quality: 0.95 },\n  \"agent-model\": { midpointDays: 10, k: 0.35, baseWeight: 0.95, quality: 0.93 },\n  lesson: { midpointDays: 7, k: 0.45, baseWeight: 0.9, quality: 0.9 },\n};\n\nexport function getReflectionMappedDecayDefaults(kind: ReflectionMappedKind): ReflectionMappedDecayDefaults {\n  return REFLECTION_MAPPED_DECAY_DEFAULTS[kind];\n}\n\nexport function buildReflectionMappedMetadata(params: {\n  mappedItem: ReflectionMappedMemoryItem;\n  eventId: string;\n  agentId: string;\n  sessionKey: string;\n  sessionId: string;\n  runAt: number;\n  usedFallback: boolean;\n  toolErrorSignals: Array<{ signatureHash: string }>;\n  sourceReflectionPath?: string;\n}): ReflectionMappedMetadata {\n  const defaults = getReflectionMappedDecayDefaults(params.mappedItem.mappedKind);\n  return {\n    type: \"memory-reflection-mapped\",\n    reflectionVersion: 4,\n    stage: \"reflect-store\",\n    eventId: params.eventId,\n    mappedKind: params.mappedItem.mappedKind,\n    mappedCategory: params.mappedItem.category,\n    section: params.mappedItem.heading,\n    ordinal: params.mappedItem.ordinal,\n    groupSize: params.mappedItem.groupSize,\n    agentId: params.agentId,\n    sessionKey: params.sessionKey,\n    sessionId: params.sessionId,\n    storedAt: params.runAt,\n    usedFallback: params.usedFallback,\n    errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),\n    decayModel: \"logistic\",\n    decayMidpointDays: defaults.midpointDays,\n    decayK: defaults.k,\n    baseWeight: defaults.baseWeight,\n    quality: defaults.quality,\n    ...(params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}),\n  };\n}\n"],
+  "mappings": "AAqCA,MAAM,mCAAgG;AAAA,EACpG,UAAU,EAAE,cAAc,IAAI,GAAG,MAAM,YAAY,KAAK,SAAS,EAAE;AAAA,EACnE,cAAc,EAAE,cAAc,IAAI,GAAG,KAAK,YAAY,GAAG,SAAS,KAAK;AAAA,EACvE,eAAe,EAAE,cAAc,IAAI,GAAG,MAAM,YAAY,MAAM,SAAS,KAAK;AAAA,EAC5E,QAAQ,EAAE,cAAc,GAAG,GAAG,MAAM,YAAY,KAAK,SAAS,IAAI;AACpE;AAEO,SAAS,iCAAiC,MAA2D;AAC1G,SAAO,iCAAiC,IAAI;AAC9C;AAEO,SAAS,8BAA8B,QAUjB;AAC3B,QAAM,WAAW,iCAAiC,OAAO,WAAW,UAAU;AAC9E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,mBAAmB;AAAA,IACnB,OAAO;AAAA,IACP,SAAS,OAAO;AAAA,IAChB,YAAY,OAAO,WAAW;AAAA,IAC9B,gBAAgB,OAAO,WAAW;AAAA,IAClC,SAAS,OAAO,WAAW;AAAA,IAC3B,SAAS,OAAO,WAAW;AAAA,IAC3B,WAAW,OAAO,WAAW;AAAA,IAC7B,SAAS,OAAO;AAAA,IAChB,YAAY,OAAO;AAAA,IACnB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO;AAAA,IACjB,cAAc,OAAO;AAAA,IACrB,cAAc,OAAO,iBAAiB,IAAI,CAAC,WAAW,OAAO,aAAa;AAAA,IAC1E,YAAY;AAAA,IACZ,mBAAmB,SAAS;AAAA,IAC5B,QAAQ,SAAS;AAAA,IACjB,YAAY,SAAS;AAAA,IACrB,SAAS,SAAS;AAAA,IAClB,GAAI,OAAO,uBAAuB,EAAE,sBAAsB,OAAO,qBAAqB,IAAI,CAAC;AAAA,EAC7F;AACF;",
+  "names": []
+}

package/dist/src/reflection-metadata.d.ts

@@ -0,0 +1,11 @@
+export declare function parseReflectionMetadata(metadataRaw: string | undefined): Record<string, unknown>;
+export declare function isReflectionEntry(entry: {
+    category: string;
+    metadata?: string;
+}): boolean;
+export declare function getDisplayCategoryTag(entry: {
+    category: string;
+    scope: string;
+    metadata?: string;
+}): string;
+//# sourceMappingURL=reflection-metadata.d.ts.map

package/dist/src/reflection-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-metadata.d.ts","sourceRoot":"","sources":["../../src/reflection-metadata.ts"],"names":[],"mappings":"AACA,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQhG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAMzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG3G"}

package/dist/src/reflection-metadata.js

@@ -0,0 +1,24 @@
+function parseReflectionMetadata(metadataRaw) {
+  if (!metadataRaw) return {};
+  try {
+    const parsed = JSON.parse(metadataRaw);
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function isReflectionEntry(entry) {
+  if (entry.category === "reflection") return true;
+  const metadata = parseReflectionMetadata(entry.metadata);
+  return metadata.type === "memory-reflection" || metadata.type === "memory-reflection-event" || metadata.type === "memory-reflection-item";
+}
+function getDisplayCategoryTag(entry) {
+  if (!isReflectionEntry(entry)) return `${entry.category}:${entry.scope}`;
+  return `reflection:${entry.scope}`;
+}
+export {
+  getDisplayCategoryTag,
+  isReflectionEntry,
+  parseReflectionMetadata
+};
+//# sourceMappingURL=reflection-metadata.js.map

package/dist/src/reflection-metadata.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-metadata.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nexport function parseReflectionMetadata(metadataRaw: string | undefined): Record<string, unknown> {\n  if (!metadataRaw) return {};\n  try {\n    const parsed = JSON.parse(metadataRaw);\n    return parsed && typeof parsed === \"object\" ? parsed as Record<string, unknown> : {};\n  } catch {\n    return {};\n  }\n}\n\nexport function isReflectionEntry(entry: { category: string; metadata?: string }): boolean {\n  if (entry.category === \"reflection\") return true;\n  const metadata = parseReflectionMetadata(entry.metadata);\n  return metadata.type === \"memory-reflection\" ||\n    metadata.type === \"memory-reflection-event\" ||\n    metadata.type === \"memory-reflection-item\";\n}\n\nexport function getDisplayCategoryTag(entry: { category: string; scope: string; metadata?: string }): string {\n  if (!isReflectionEntry(entry)) return `${entry.category}:${entry.scope}`;\n  return `reflection:${entry.scope}`;\n}\n"],
+  "mappings": "AACO,SAAS,wBAAwB,aAA0D;AAChG,MAAI,CAAC,YAAa,QAAO,CAAC;AAC1B,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,WAAW;AACrC,WAAO,UAAU,OAAO,WAAW,WAAW,SAAoC,CAAC;AAAA,EACrF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEO,SAAS,kBAAkB,OAAyD;AACzF,MAAI,MAAM,aAAa,aAAc,QAAO;AAC5C,QAAM,WAAW,wBAAwB,MAAM,QAAQ;AACvD,SAAO,SAAS,SAAS,uBACvB,SAAS,SAAS,6BAClB,SAAS,SAAS;AACtB;AAEO,SAAS,sBAAsB,OAAuE;AAC3G,MAAI,CAAC,kBAAkB,KAAK,EAAG,QAAO,GAAG,MAAM,QAAQ,IAAI,MAAM,KAAK;AACtE,SAAO,cAAc,MAAM,KAAK;AAClC;",
+  "names": []
+}

package/dist/src/reflection-ranking.d.ts

@@ -0,0 +1,13 @@
+export declare const REFLECTION_FALLBACK_SCORE_FACTOR = 0.75;
+export interface ReflectionScoreInput {
+    ageDays: number;
+    midpointDays: number;
+    k: number;
+    baseWeight: number;
+    quality: number;
+    usedFallback: boolean;
+}
+export declare function computeReflectionLogistic(ageDays: number, midpointDays: number, k: number): number;
+export declare function computeReflectionScore(input: ReflectionScoreInput): number;
+export declare function normalizeReflectionLineForAggregation(line: string): string;
+//# sourceMappingURL=reflection-ranking.d.ts.map

package/dist/src/reflection-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-ranking.d.ts","sourceRoot":"","sources":["../../src/reflection-ranking.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAM1E;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/{src/reflection-ranking.ts → dist/src/reflection-ranking.js}

@@ -1,33 +1,24 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
-export const REFLECTION_FALLBACK_SCORE_FACTOR = 0.75;
-
-export interface ReflectionScoreInput {
-  ageDays: number;
-  midpointDays: number;
-  k: number;
-  baseWeight: number;
-  quality: number;
-  usedFallback: boolean;
-}
-
-export function computeReflectionLogistic(ageDays: number, midpointDays: number, k: number): number {
+const REFLECTION_FALLBACK_SCORE_FACTOR = 0.75;
+function computeReflectionLogistic(ageDays, midpointDays, k) {
   const safeAgeDays = Number.isFinite(ageDays) ? Math.max(0, ageDays) : 0;
   const safeMidpointDays = Number.isFinite(midpointDays) && midpointDays > 0 ? midpointDays : 1;
   const safeK = Number.isFinite(k) && k > 0 ? k : 0.1;
   return 1 / (1 + Math.exp(safeK * (safeAgeDays - safeMidpointDays)));
 }
-
-export function computeReflectionScore(input: ReflectionScoreInput): number {
+function computeReflectionScore(input) {
   const logistic = computeReflectionLogistic(input.ageDays, input.midpointDays, input.k);
   const baseWeight = Number.isFinite(input.baseWeight) && input.baseWeight > 0 ? input.baseWeight : 1;
   const quality = Number.isFinite(input.quality) ? Math.max(0, Math.min(1, input.quality)) : 1;
   const fallbackFactor = input.usedFallback ? REFLECTION_FALLBACK_SCORE_FACTOR : 1;
   return logistic * baseWeight * quality * fallbackFactor;
 }
-
-export function normalizeReflectionLineForAggregation(line: string): string {
-  return String(line)
-    .trim()
-    .replace(/\s+/g, " ")
-    .toLowerCase();
+function normalizeReflectionLineForAggregation(line) {
+  return String(line).trim().replace(/\s+/g, " ").toLowerCase();
 }
+export {
+  REFLECTION_FALLBACK_SCORE_FACTOR,
+  computeReflectionLogistic,
+  computeReflectionScore,
+  normalizeReflectionLineForAggregation
+};
+//# sourceMappingURL=reflection-ranking.js.map

package/dist/src/reflection-ranking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-ranking.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nexport const REFLECTION_FALLBACK_SCORE_FACTOR = 0.75;\n\nexport interface ReflectionScoreInput {\n  ageDays: number;\n  midpointDays: number;\n  k: number;\n  baseWeight: number;\n  quality: number;\n  usedFallback: boolean;\n}\n\nexport function computeReflectionLogistic(ageDays: number, midpointDays: number, k: number): number {\n  const safeAgeDays = Number.isFinite(ageDays) ? Math.max(0, ageDays) : 0;\n  const safeMidpointDays = Number.isFinite(midpointDays) && midpointDays > 0 ? midpointDays : 1;\n  const safeK = Number.isFinite(k) && k > 0 ? k : 0.1;\n  return 1 / (1 + Math.exp(safeK * (safeAgeDays - safeMidpointDays)));\n}\n\nexport function computeReflectionScore(input: ReflectionScoreInput): number {\n  const logistic = computeReflectionLogistic(input.ageDays, input.midpointDays, input.k);\n  const baseWeight = Number.isFinite(input.baseWeight) && input.baseWeight > 0 ? input.baseWeight : 1;\n  const quality = Number.isFinite(input.quality) ? Math.max(0, Math.min(1, input.quality)) : 1;\n  const fallbackFactor = input.usedFallback ? REFLECTION_FALLBACK_SCORE_FACTOR : 1;\n  return logistic * baseWeight * quality * fallbackFactor;\n}\n\nexport function normalizeReflectionLineForAggregation(line: string): string {\n  return String(line)\n    .trim()\n    .replace(/\\s+/g, \" \")\n    .toLowerCase();\n}\n"],
+  "mappings": "AACO,MAAM,mCAAmC;AAWzC,SAAS,0BAA0B,SAAiB,cAAsB,GAAmB;AAClG,QAAM,cAAc,OAAO,SAAS,OAAO,IAAI,KAAK,IAAI,GAAG,OAAO,IAAI;AACtE,QAAM,mBAAmB,OAAO,SAAS,YAAY,KAAK,eAAe,IAAI,eAAe;AAC5F,QAAM,QAAQ,OAAO,SAAS,CAAC,KAAK,IAAI,IAAI,IAAI;AAChD,SAAO,KAAK,IAAI,KAAK,IAAI,SAAS,cAAc,iBAAiB;AACnE;AAEO,SAAS,uBAAuB,OAAqC;AAC1E,QAAM,WAAW,0BAA0B,MAAM,SAAS,MAAM,cAAc,MAAM,CAAC;AACrF,QAAM,aAAa,OAAO,SAAS,MAAM,UAAU,KAAK,MAAM,aAAa,IAAI,MAAM,aAAa;AAClG,QAAM,UAAU,OAAO,SAAS,MAAM,OAAO,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI;AAC3F,QAAM,iBAAiB,MAAM,eAAe,mCAAmC;AAC/E,SAAO,WAAW,aAAa,UAAU;AAC3C;AAEO,SAAS,sCAAsC,MAAsB;AAC1E,SAAO,OAAO,IAAI,EACf,KAAK,EACL,QAAQ,QAAQ,GAAG,EACnB,YAAY;AACjB;",
+  "names": []
+}

package/dist/src/reflection-retry.d.ts

@@ -0,0 +1,30 @@
+type RetryClassifierInput = {
+    inReflectionScope: boolean;
+    retryCount: number;
+    usefulOutputChars: number;
+    error: unknown;
+};
+type RetryClassifierResult = {
+    retryable: boolean;
+    reason: "not_reflection_scope" | "retry_already_used" | "useful_output_present" | "non_retry_error" | "non_transient_error" | "transient_upstream_failure";
+    normalizedError: string;
+};
+type RetryState = {
+    count: number;
+};
+type RetryRunnerParams<T> = {
+    scope: "reflection" | "distiller";
+    runner: "embedded" | "cli";
+    retryState: RetryState;
+    execute: () => Promise<T>;
+    onLog?: (level: "info" | "warn", message: string) => void;
+    random?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+};
+export declare function isTransientReflectionUpstreamError(error: unknown): boolean;
+export declare function isReflectionNonRetryError(error: unknown): boolean;
+export declare function classifyReflectionRetry(input: RetryClassifierInput): RetryClassifierResult;
+export declare function computeReflectionRetryDelayMs(random?: () => number): number;
+export declare function runWithReflectionTransientRetryOnce<T>(params: RetryRunnerParams<T>): Promise<T>;
+export {};
+//# sourceMappingURL=reflection-retry.d.ts.map

package/dist/src/reflection-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-retry.d.ts","sourceRoot":"","sources":["../../src/reflection-retry.ts"],"names":[],"mappings":"AACA,KAAK,oBAAoB,GAAG;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EACJ,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,GACjB,qBAAqB,GACrB,4BAA4B,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,KAAK,iBAAiB,CAAC,CAAC,IAAI;IAC1B,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC;IAClC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AA6EF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG1E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGjE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAmB1F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAIxF;AAED,wBAAsB,mCAAmC,CAAC,CAAC,EACzD,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAkCZ"}

package/{src/reflection-retry.ts → dist/src/reflection-retry.js}

@@ -1,36 +1,4 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
-type RetryClassifierInput = {
-  inReflectionScope: boolean;
-  retryCount: number;
-  usefulOutputChars: number;
-  error: unknown;
-};
-
-type RetryClassifierResult = {
-  retryable: boolean;
-  reason:
-  | "not_reflection_scope"
-  | "retry_already_used"
-  | "useful_output_present"
-  | "non_retry_error"
-  | "non_transient_error"
-  | "transient_upstream_failure";
-  normalizedError: string;
-};
-
-type RetryState = { count: number };
-
-type RetryRunnerParams<T> = {
-  scope: "reflection" | "distiller";
-  runner: "embedded" | "cli";
-  retryState: RetryState;
-  execute: () => Promise<T>;
-  onLog?: (level: "info" | "warn", message: string) => void;
-  random?: () => number;
-  sleep?: (ms: number) => Promise<void>;
-};
-
-const REFLECTION_TRANSIENT_PATTERNS: RegExp[] = [
+const REFLECTION_TRANSIENT_PATTERNS = [
   /unexpected eof/i,
   /\beconnreset\b/i,
   /\beconnaborted\b/i,
@@ -52,10 +20,9 @@ const REFLECTION_TRANSIENT_PATTERNS: RegExp[] = [
   /\btimeout\b/i,
   /\bund_err_(?:socket|headers_timeout|body_timeout)\b/i,
   /network error/i,
-  /fetch failed/i,
+  /fetch failed/i
 ];
-
-const REFLECTION_NON_RETRY_PATTERNS: RegExp[] = [
+const REFLECTION_NON_RETRY_PATTERNS = [
   /\b401\b/i,
   /\bunauthorized\b/i,
   /invalid api key/i,
@@ -81,12 +48,10 @@ const REFLECTION_NON_RETRY_PATTERNS: RegExp[] = [
   /content policy/i,
   /safety policy/i,
   /content filter/i,
-  /disallowed/i,
+  /disallowed/i
 ];
-
-const DEFAULT_SLEEP = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));
-
-function toErrorMessage(error: unknown): string {
+const DEFAULT_SLEEP = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function toErrorMessage(error) {
   if (error instanceof Error) {
     const msg = `${error.name}: ${error.message}`.trim();
     return msg || "Error";
@@ -98,26 +63,21 @@ function toErrorMessage(error: unknown): string {
     return String(error);
   }
 }
-
-function clipSingleLine(text: string, maxLen = 260): string {
+function clipSingleLine(text, maxLen = 260) {
   const oneLine = text.replace(/\s+/g, " ").trim();
   if (oneLine.length <= maxLen) return oneLine;
   return `${oneLine.slice(0, maxLen - 3)}...`;
 }
-
-export function isTransientReflectionUpstreamError(error: unknown): boolean {
+function isTransientReflectionUpstreamError(error) {
   const msg = toErrorMessage(error);
   return REFLECTION_TRANSIENT_PATTERNS.some((pattern) => pattern.test(msg));
 }
-
-export function isReflectionNonRetryError(error: unknown): boolean {
+function isReflectionNonRetryError(error) {
   const msg = toErrorMessage(error);
   return REFLECTION_NON_RETRY_PATTERNS.some((pattern) => pattern.test(msg));
 }
-
-export function classifyReflectionRetry(input: RetryClassifierInput): RetryClassifierResult {
+function classifyReflectionRetry(input) {
   const normalizedError = clipSingleLine(toErrorMessage(input.error), 260);
-
   if (!input.inReflectionScope) {
     return { retryable: false, reason: "not_reflection_scope", normalizedError };
   }
@@ -135,16 +95,12 @@ export function classifyReflectionRetry(input: RetryClassifierInput): RetryClass
   }
   return { retryable: false, reason: "non_transient_error", normalizedError };
 }
-
-export function computeReflectionRetryDelayMs(random: () => number = Math.random): number {
+function computeReflectionRetryDelayMs(random = Math.random) {
   const raw = random();
   const clamped = Number.isFinite(raw) ? Math.min(1, Math.max(0, raw)) : 0;
-  return 1000 + Math.floor(clamped * 2000);
+  return 1e3 + Math.floor(clamped * 2e3);
 }
-
-export async function runWithReflectionTransientRetryOnce<T>(
-  params: RetryRunnerParams<T>
-): Promise<T> {
+async function runWithReflectionTransientRetryOnce(params) {
   try {
     return await params.execute();
   } catch (error) {
@@ -152,19 +108,16 @@ export async function runWithReflectionTransientRetryOnce<T>(
       inReflectionScope: params.scope === "reflection" || params.scope === "distiller",
       retryCount: params.retryState.count,
       usefulOutputChars: 0,
-      error,
+      error
     });
     if (!decision.retryable) throw error;
-
     const delayMs = computeReflectionRetryDelayMs(params.random);
     params.retryState.count += 1;
     params.onLog?.(
       "warn",
-      `memory-${params.scope}: transient upstream failure detected (${params.runner}); ` +
-      `retrying once in ${delayMs}ms (${decision.reason}). error=${decision.normalizedError}`
+      `memory-${params.scope}: transient upstream failure detected (${params.runner}); retrying once in ${delayMs}ms (${decision.reason}). error=${decision.normalizedError}`
     );
     await (params.sleep ?? DEFAULT_SLEEP)(delayMs);
-
     try {
       const result = await params.execute();
       params.onLog?.("info", `memory-${params.scope}: retry succeeded (${params.runner})`);
@@ -172,10 +125,17 @@ export async function runWithReflectionTransientRetryOnce<T>(
     } catch (retryError) {
       params.onLog?.(
         "warn",
-        `memory-${params.scope}: retry exhausted (${params.runner}). ` +
-        `error=${clipSingleLine(toErrorMessage(retryError), 260)}`
+        `memory-${params.scope}: retry exhausted (${params.runner}). error=${clipSingleLine(toErrorMessage(retryError), 260)}`
       );
       throw retryError;
     }
   }
 }
+export {
+  classifyReflectionRetry,
+  computeReflectionRetryDelayMs,
+  isReflectionNonRetryError,
+  isTransientReflectionUpstreamError,
+  runWithReflectionTransientRetryOnce
+};
+//# sourceMappingURL=reflection-retry.js.map

package/dist/src/reflection-retry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-retry.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\ntype RetryClassifierInput = {\n  inReflectionScope: boolean;\n  retryCount: number;\n  usefulOutputChars: number;\n  error: unknown;\n};\n\ntype RetryClassifierResult = {\n  retryable: boolean;\n  reason:\n  | \"not_reflection_scope\"\n  | \"retry_already_used\"\n  | \"useful_output_present\"\n  | \"non_retry_error\"\n  | \"non_transient_error\"\n  | \"transient_upstream_failure\";\n  normalizedError: string;\n};\n\ntype RetryState = { count: number };\n\ntype RetryRunnerParams<T> = {\n  scope: \"reflection\" | \"distiller\";\n  runner: \"embedded\" | \"cli\";\n  retryState: RetryState;\n  execute: () => Promise<T>;\n  onLog?: (level: \"info\" | \"warn\", message: string) => void;\n  random?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n};\n\nconst REFLECTION_TRANSIENT_PATTERNS: RegExp[] = [\n  /unexpected eof/i,\n  /\\beconnreset\\b/i,\n  /\\beconnaborted\\b/i,\n  /\\betimedout\\b/i,\n  /\\bepipe\\b/i,\n  /connection reset/i,\n  /socket hang up/i,\n  /socket (?:closed|disconnected)/i,\n  /connection (?:closed|aborted|dropped)/i,\n  /early close/i,\n  /stream (?:ended|closed) unexpectedly/i,\n  /temporar(?:y|ily).*unavailable/i,\n  /upstream.*unavailable/i,\n  /service unavailable/i,\n  /bad gateway/i,\n  /gateway timeout/i,\n  /\\b(?:http|status)\\s*(?:502|503|504)\\b/i,\n  /\\btimed out\\b/i,\n  /\\btimeout\\b/i,\n  /\\bund_err_(?:socket|headers_timeout|body_timeout)\\b/i,\n  /network error/i,\n  /fetch failed/i,\n];\n\nconst REFLECTION_NON_RETRY_PATTERNS: RegExp[] = [\n  /\\b401\\b/i,\n  /\\bunauthorized\\b/i,\n  /invalid api key/i,\n  /invalid[_ -]?token/i,\n  /\\bauth(?:entication)?_?unavailable\\b/i,\n  /insufficient (?:credit|credits|balance)/i,\n  /\\bbilling\\b/i,\n  /\\bquota exceeded\\b/i,\n  /payment required/i,\n  /model .*not found/i,\n  /no such model/i,\n  /unknown model/i,\n  /context length/i,\n  /context window/i,\n  /request too large/i,\n  /payload too large/i,\n  /too many tokens/i,\n  /token limit/i,\n  /prompt too long/i,\n  /session expired/i,\n  /invalid session/i,\n  /refusal/i,\n  /content policy/i,\n  /safety policy/i,\n  /content filter/i,\n  /disallowed/i,\n];\n\nconst DEFAULT_SLEEP = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nfunction toErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    const msg = `${error.name}: ${error.message}`.trim();\n    return msg || \"Error\";\n  }\n  if (typeof error === \"string\") return error;\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n}\n\nfunction clipSingleLine(text: string, maxLen = 260): string {\n  const oneLine = text.replace(/\\s+/g, \" \").trim();\n  if (oneLine.length <= maxLen) return oneLine;\n  return `${oneLine.slice(0, maxLen - 3)}...`;\n}\n\nexport function isTransientReflectionUpstreamError(error: unknown): boolean {\n  const msg = toErrorMessage(error);\n  return REFLECTION_TRANSIENT_PATTERNS.some((pattern) => pattern.test(msg));\n}\n\nexport function isReflectionNonRetryError(error: unknown): boolean {\n  const msg = toErrorMessage(error);\n  return REFLECTION_NON_RETRY_PATTERNS.some((pattern) => pattern.test(msg));\n}\n\nexport function classifyReflectionRetry(input: RetryClassifierInput): RetryClassifierResult {\n  const normalizedError = clipSingleLine(toErrorMessage(input.error), 260);\n\n  if (!input.inReflectionScope) {\n    return { retryable: false, reason: \"not_reflection_scope\", normalizedError };\n  }\n  if (input.retryCount > 0) {\n    return { retryable: false, reason: \"retry_already_used\", normalizedError };\n  }\n  if (input.usefulOutputChars > 0) {\n    return { retryable: false, reason: \"useful_output_present\", normalizedError };\n  }\n  if (isReflectionNonRetryError(input.error)) {\n    return { retryable: false, reason: \"non_retry_error\", normalizedError };\n  }\n  if (isTransientReflectionUpstreamError(input.error)) {\n    return { retryable: true, reason: \"transient_upstream_failure\", normalizedError };\n  }\n  return { retryable: false, reason: \"non_transient_error\", normalizedError };\n}\n\nexport function computeReflectionRetryDelayMs(random: () => number = Math.random): number {\n  const raw = random();\n  const clamped = Number.isFinite(raw) ? Math.min(1, Math.max(0, raw)) : 0;\n  return 1000 + Math.floor(clamped * 2000);\n}\n\nexport async function runWithReflectionTransientRetryOnce<T>(\n  params: RetryRunnerParams<T>\n): Promise<T> {\n  try {\n    return await params.execute();\n  } catch (error) {\n    const decision = classifyReflectionRetry({\n      inReflectionScope: params.scope === \"reflection\" || params.scope === \"distiller\",\n      retryCount: params.retryState.count,\n      usefulOutputChars: 0,\n      error,\n    });\n    if (!decision.retryable) throw error;\n\n    const delayMs = computeReflectionRetryDelayMs(params.random);\n    params.retryState.count += 1;\n    params.onLog?.(\n      \"warn\",\n      `memory-${params.scope}: transient upstream failure detected (${params.runner}); ` +\n      `retrying once in ${delayMs}ms (${decision.reason}). error=${decision.normalizedError}`\n    );\n    await (params.sleep ?? DEFAULT_SLEEP)(delayMs);\n\n    try {\n      const result = await params.execute();\n      params.onLog?.(\"info\", `memory-${params.scope}: retry succeeded (${params.runner})`);\n      return result;\n    } catch (retryError) {\n      params.onLog?.(\n        \"warn\",\n        `memory-${params.scope}: retry exhausted (${params.runner}). ` +\n        `error=${clipSingleLine(toErrorMessage(retryError), 260)}`\n      );\n      throw retryError;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/reflection-slices.d.ts

@@ -0,0 +1,42 @@
+export interface ReflectionSlices {
+    invariants: string[];
+    derived: string[];
+}
+export interface ReflectionMappedMemory {
+    text: string;
+    category: "preference" | "fact" | "decision";
+    heading: string;
+}
+export type ReflectionMappedKind = "user-model" | "agent-model" | "lesson" | "decision";
+export interface ReflectionMappedMemoryItem extends ReflectionMappedMemory {
+    mappedKind: ReflectionMappedKind;
+    ordinal: number;
+    groupSize: number;
+}
+export interface ReflectionSliceItem {
+    text: string;
+    itemKind: "invariant" | "derived";
+    section: "Invariants" | "Derived";
+    ordinal: number;
+    groupSize: number;
+}
+export interface ReflectionGovernanceEntry {
+    priority?: string;
+    status?: string;
+    area?: string;
+    summary: string;
+    details?: string;
+    suggestedAction?: string;
+}
+export declare function extractSectionMarkdown(markdown: string, heading: string): string;
+export declare function parseSectionBullets(markdown: string, heading: string): string[];
+export declare function isPlaceholderReflectionSliceLine(line: string): boolean;
+export declare function normalizeReflectionSliceLine(line: string): string;
+export declare function sanitizeReflectionSliceLines(lines: string[]): string[];
+export declare function extractReflectionLessons(reflectionText: string): string[];
+export declare function extractReflectionLearningGovernanceCandidates(reflectionText: string): ReflectionGovernanceEntry[];
+export declare function extractReflectionMappedMemories(reflectionText: string): ReflectionMappedMemory[];
+export declare function extractReflectionMappedMemoryItems(reflectionText: string): ReflectionMappedMemoryItem[];
+export declare function extractReflectionSlices(reflectionText: string): ReflectionSlices;
+export declare function extractReflectionSliceItems(reflectionText: string): ReflectionSliceItem[];
+//# sourceMappingURL=reflection-slices.d.ts.map

package/dist/src/reflection-slices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-slices.d.ts","sourceRoot":"","sources":["../../src/reflection-slices.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExF,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBhF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW/E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAStE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAItE;AAgBD,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED,wBAAgB,6CAA6C,CAAC,cAAc,EAAE,MAAM,GAAG,yBAAyB,EAAE,CA4BjH;AAgCD,wBAAgB,+BAA+B,CAAC,cAAc,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAEhG;AAED,wBAAgB,kCAAkC,CAAC,cAAc,EAAE,MAAM,GAAG,0BAA0B,EAAE,CAiCvG;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,CA+BhF;AAED,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAqBzF"}