@graphorin/memory 0.5.0 → 0.6.1

package/dist/consolidator/phases/learned-context.js

@@ -0,0 +1,129 @@
+import { withMemorySpan } from "../../internal/spans.js";
+import { defineBlock } from "../../tiers/working-memory.js";
+
+//#region src/consolidator/phases/learned-context.ts
+/** Reserved working-block label maintained by the pass. */
+const LEARNED_CONTEXT_BLOCK_LABEL = "learned_context";
+/** How many recent episode summaries feed one rewrite. */
+const EPISODE_CONTEXT_LIMIT = 15;
+/** How many active insights / procedures feed one rewrite. */
+const INSIGHT_CONTEXT_LIMIT = 10;
+const PROCEDURE_CONTEXT_LIMIT = 8;
+const LEARNED_CONTEXT_SYSTEM_PROMPT = [
+	"You maintain the learned-context block of a long-running personal-assistant memory:",
+	"a compact standing digest of what is durably known about the user and their active",
+	"work (profile, preferences, ongoing projects, validated insights, working procedures).",
+	"Rewrite the digest by folding the new evidence into the previous digest: keep what is",
+	"still true, drop what is stale or superseded, and never invent anything the evidence",
+	"does not support. Write plain prose or short dashed lines - no markdown headings, no",
+	"code fences, no preamble. Stay strictly under the character budget."
+].join(" ");
+/**
+* Strip an accidental leading code fence from the model's digest and
+* clamp it to the character budget. Returns `null` for an effectively
+* empty rewrite (the previous digest is then left untouched).
+*/
+function normalizeLearnedContext(raw, maxChars) {
+	let text = raw.trim();
+	const fence = /^```[^\n]*\n([\s\S]*?)\n?```\s*$/.exec(text);
+	if (fence?.[1] !== void 0) text = fence[1].trim();
+	if (text.length === 0) return null;
+	return text.length > maxChars ? text.slice(0, maxChars).trimEnd() : text;
+}
+/** Build the single rewrite request (pure - testable offline). */
+function buildLearnedContextRequest(args) {
+	const sections = [`Character budget: ${args.maxChars}.`, args.previous.length > 0 ? `Previous digest:\n${args.previous}` : "Previous digest: (none yet - write the first one)"];
+	if (args.episodes.length > 0) sections.push(`Recent episodes:\n${args.episodes.map((s) => `- ${s}`).join("\n")}`);
+	if (args.insights.length > 0) sections.push(`Validated insights:\n${args.insights.map((s) => `- ${s}`).join("\n")}`);
+	if (args.procedures.length > 0) sections.push(`Active procedures:\n${args.procedures.map((s) => `- ${s}`).join("\n")}`);
+	sections.push("Return ONLY the rewritten digest text.");
+	return {
+		messages: [{
+			role: "user",
+			content: sections.join("\n\n")
+		}],
+		systemMessage: LEARNED_CONTEXT_SYSTEM_PROMPT,
+		temperature: 0,
+		maxTokens: Math.max(256, Math.ceil(args.maxChars / 2))
+	};
+}
+/**
+* Run the learned-context rewrite. Resilient by construction: a
+* provider failure or empty rewrite leaves the existing block untouched
+* and never throws; only storage errors propagate.
+*/
+async function runLearnedContextPass(deps) {
+	return withMemorySpan(deps.tracer, "memory.consolidate.learned-context", deps.scope, { "consolidator.phase": "learned-context" }, async (span) => {
+		const skip = (reason, chars = 0) => {
+			span.setAttributes({ "consolidator.learned_context.skipped": reason });
+			return {
+				updated: false,
+				chars,
+				tokens: 0,
+				costUsd: 0,
+				skippedReason: reason
+			};
+		};
+		if (deps.budget.snapshot().paused) return skip("budget");
+		if (deps.working.definitionFor(LEARNED_CONTEXT_BLOCK_LABEL) === void 0) deps.working.define(defineBlock({
+			label: LEARNED_CONTEXT_BLOCK_LABEL,
+			description: "Standing digest of durable knowledge about the user and active work, maintained by the deep-phase learned-context pass.",
+			charLimit: deps.maxChars
+		}));
+		const previous = await deps.working.read(deps.scope, LEARNED_CONTEXT_BLOCK_LABEL) ?? "";
+		const episodes = deps.episodic === null ? [] : (await deps.episodic.listRecent(deps.scope, EPISODE_CONTEXT_LIMIT, { includeQuarantined: true })).map((episode) => episode.summary);
+		const insights = deps.store.insights === void 0 ? [] : (await deps.store.insights.list(deps.scope, { limit: INSIGHT_CONTEXT_LIMIT })).map((insight) => insight.text);
+		const procedures = (await deps.store.procedural.list(deps.scope)).filter((rule) => rule.status !== "quarantined").slice(0, PROCEDURE_CONTEXT_LIMIT).map((rule) => rule.text.split("\n")[0] ?? rule.text);
+		const evidenceCount = episodes.length + insights.length + procedures.length;
+		span.setAttributes({ "consolidator.learned_context.evidence": evidenceCount });
+		if (evidenceCount === 0) return skip("no-evidence", previous.length);
+		let tokens = 0;
+		let costUsd = 0;
+		try {
+			const res = await deps.provider.generate(buildLearnedContextRequest({
+				previous,
+				episodes,
+				insights,
+				procedures,
+				maxChars: deps.maxChars
+			}));
+			tokens = (res.usage.promptTokens ?? 0) + (res.usage.completionTokens ?? 0) + (res.usage.reasoningTokens ?? 0);
+			costUsd = deps.priceUsage?.({
+				promptTokens: res.usage.promptTokens ?? 0,
+				completionTokens: res.usage.completionTokens ?? 0
+			}) ?? 0;
+			deps.budget.record({
+				phase: "deep",
+				tokens,
+				costUsd
+			});
+			const next = normalizeLearnedContext(res.text ?? "", deps.maxChars);
+			if (next === null) return {
+				...skip("empty-rewrite", previous.length),
+				tokens,
+				costUsd
+			};
+			await deps.working.write(deps.scope, LEARNED_CONTEXT_BLOCK_LABEL, next);
+			span.setAttributes({
+				"consolidator.learned_context.updated": true,
+				"consolidator.learned_context.chars": next.length
+			});
+			return {
+				updated: true,
+				chars: next.length,
+				tokens,
+				costUsd
+			};
+		} catch {
+			return {
+				...skip("provider-error", previous.length),
+				tokens,
+				costUsd
+			};
+		}
+	});
+}
+
+//#endregion
+export { runLearnedContextPass };
+//# sourceMappingURL=learned-context.js.map

package/dist/consolidator/phases/learned-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learned-context.js","names":["sections: string[]"],"sources":["../../../src/consolidator/phases/learned-context.ts"],"sourcesContent":["/**\n * Learned-context pass (D3) - Letta-style sleep-time maintenance of a\n * persistent, size-bounded, agent-editable digest block. The deep phase\n * rewrites one reserved working-memory block (`learned_context`) from\n * the previous digest + fresh evidence (recent episodes, active\n * insights, active procedures), so every subsequent step's system\n * prompt carries a compact \"what I have learned about this user /\n * project\" summary inside the stable KV-cache prefix - without\n * retrieval latency and without unbounded growth.\n *\n * The block itself is an ordinary working block: it is spliced into\n * layer 3 of the assembled context automatically, re-anchored after\n * compaction by the persona-block hook pattern, and remains editable by\n * the agent through the existing `block_*` tools (the pass rewrites it\n * on its own cadence, folding any agent edits into the next rewrite).\n *\n * Runs after the deep-phase reflection pass, reusing the same budget /\n * lock / run-audit envelope. Gated off by default at every tier\n * (`learnedContext: false`) - Wave-D trial discipline.\n *\n * @packageDocumentation\n */\n\nimport type { Provider, ProviderRequest, SessionScope, Tracer } from '@graphorin/core';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type { MemoryStoreAdapter } from '../../internal/storage-adapter.js';\nimport type { EpisodicMemory } from '../../tiers/episodic-memory.js';\nimport { defineBlock, type WorkingMemory } from '../../tiers/working-memory.js';\nimport type { BudgetTracker } from '../budget.js';\n\n/** Reserved working-block label maintained by the pass. */\nexport const LEARNED_CONTEXT_BLOCK_LABEL = 'learned_context';\n\n/** Default character bound for the digest block. */\nexport const DEFAULT_LEARNED_CONTEXT_MAX_CHARS = 1200;\n\n/** How many recent episode summaries feed one rewrite. */\nconst EPISODE_CONTEXT_LIMIT = 15;\n\n/** How many active insights / procedures feed one rewrite. */\nconst INSIGHT_CONTEXT_LIMIT = 10;\nconst PROCEDURE_CONTEXT_LIMIT = 8;\n\nconst LEARNED_CONTEXT_SYSTEM_PROMPT = [\n  'You maintain the learned-context block of a long-running personal-assistant memory:',\n  'a compact standing digest of what is durably known about the user and their active',\n  'work (profile, preferences, ongoing projects, validated insights, working procedures).',\n  'Rewrite the digest by folding the new evidence into the previous digest: keep what is',\n  'still true, drop what is stale or superseded, and never invent anything the evidence',\n  'does not support. Write plain prose or short dashed lines - no markdown headings, no',\n  'code fences, no preamble. Stay strictly under the character budget.',\n].join(' ');\n\n/** Inputs accepted by {@link runLearnedContextPass}. */\nexport interface LearnedContextDeps {\n  readonly provider: Provider;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  /** Working tier that owns the digest block. */\n  readonly working: WorkingMemory;\n  /** Recent-episode evidence source. `null` ⇒ episodes are skipped. */\n  readonly episodic: EpisodicMemory | null;\n  /** Storage adapter - supplies active insights + procedures as evidence. */\n  readonly store: MemoryStoreAdapter;\n  readonly budget: BudgetTracker;\n  /** Character bound enforced on the stored digest. */\n  readonly maxChars: number;\n  readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n  /** Override the wall clock - used by tests. */\n  readonly now?: () => number;\n}\n\n/** Summary returned by {@link runLearnedContextPass}. */\nexport interface LearnedContextOutcome {\n  /** True when the block was rewritten this pass. */\n  readonly updated: boolean;\n  /** Stored digest length after the pass (0 when skipped and absent). */\n  readonly chars: number;\n  readonly tokens: number;\n  readonly costUsd: number;\n  /** Why the pass made no LLM call, when it did not. */\n  readonly skippedReason?: 'budget' | 'no-evidence' | 'empty-rewrite' | 'provider-error';\n}\n\n/**\n * Strip an accidental leading code fence from the model's digest and\n * clamp it to the character budget. Returns `null` for an effectively\n * empty rewrite (the previous digest is then left untouched).\n */\nexport function normalizeLearnedContext(raw: string, maxChars: number): string | null {\n  let text = raw.trim();\n  const fence = /^```[^\\n]*\\n([\\s\\S]*?)\\n?```\\s*$/.exec(text);\n  if (fence?.[1] !== undefined) text = fence[1].trim();\n  if (text.length === 0) return null;\n  return text.length > maxChars ? text.slice(0, maxChars).trimEnd() : text;\n}\n\n/** Build the single rewrite request (pure - testable offline). */\nexport function buildLearnedContextRequest(args: {\n  readonly previous: string;\n  readonly episodes: ReadonlyArray<string>;\n  readonly insights: ReadonlyArray<string>;\n  readonly procedures: ReadonlyArray<string>;\n  readonly maxChars: number;\n}): ProviderRequest {\n  const sections: string[] = [\n    `Character budget: ${args.maxChars}.`,\n    args.previous.length > 0\n      ? `Previous digest:\\n${args.previous}`\n      : 'Previous digest: (none yet - write the first one)',\n  ];\n  if (args.episodes.length > 0) {\n    sections.push(`Recent episodes:\\n${args.episodes.map((s) => `- ${s}`).join('\\n')}`);\n  }\n  if (args.insights.length > 0) {\n    sections.push(`Validated insights:\\n${args.insights.map((s) => `- ${s}`).join('\\n')}`);\n  }\n  if (args.procedures.length > 0) {\n    sections.push(`Active procedures:\\n${args.procedures.map((s) => `- ${s}`).join('\\n')}`);\n  }\n  sections.push('Return ONLY the rewritten digest text.');\n  return {\n    messages: [{ role: 'user', content: sections.join('\\n\\n') }],\n    systemMessage: LEARNED_CONTEXT_SYSTEM_PROMPT,\n    temperature: 0,\n    maxTokens: Math.max(256, Math.ceil(args.maxChars / 2)),\n  };\n}\n\n/**\n * Run the learned-context rewrite. Resilient by construction: a\n * provider failure or empty rewrite leaves the existing block untouched\n * and never throws; only storage errors propagate.\n */\nexport async function runLearnedContextPass(\n  deps: LearnedContextDeps,\n): Promise<LearnedContextOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.learned-context',\n    deps.scope,\n    { 'consolidator.phase': 'learned-context' },\n    async (span) => {\n      const skip = (\n        reason: NonNullable<LearnedContextOutcome['skippedReason']>,\n        chars = 0,\n      ): LearnedContextOutcome => {\n        span.setAttributes({ 'consolidator.learned_context.skipped': reason });\n        return { updated: false, chars, tokens: 0, costUsd: 0, skippedReason: reason };\n      };\n      if (deps.budget.snapshot().paused) return skip('budget');\n\n      // Ensure the reserved block is registered so write() can create it.\n      if (deps.working.definitionFor(LEARNED_CONTEXT_BLOCK_LABEL) === undefined) {\n        deps.working.define(\n          defineBlock({\n            label: LEARNED_CONTEXT_BLOCK_LABEL,\n            description:\n              'Standing digest of durable knowledge about the user and active work, ' +\n              'maintained by the deep-phase learned-context pass.',\n            charLimit: deps.maxChars,\n          }),\n        );\n      }\n      const previous = (await deps.working.read(deps.scope, LEARNED_CONTEXT_BLOCK_LABEL)) ?? '';\n\n      // Evidence: recent episodes (incl. quarantined auto-formed ones -\n      // they carry the importance signal), ACTIVE insights only (the\n      // digest drives behaviour, so quarantined synthesis stays out),\n      // and active procedures.\n      const episodes =\n        deps.episodic === null\n          ? []\n          : (\n              await deps.episodic.listRecent(deps.scope, EPISODE_CONTEXT_LIMIT, {\n                includeQuarantined: true,\n              })\n            ).map((episode) => episode.summary);\n      const insights =\n        deps.store.insights === undefined\n          ? []\n          : (await deps.store.insights.list(deps.scope, { limit: INSIGHT_CONTEXT_LIMIT })).map(\n              (insight) => insight.text,\n            );\n      const procedures = (await deps.store.procedural.list(deps.scope))\n        .filter((rule) => rule.status !== 'quarantined')\n        .slice(0, PROCEDURE_CONTEXT_LIMIT)\n        .map((rule) => rule.text.split('\\n')[0] ?? rule.text);\n\n      const evidenceCount = episodes.length + insights.length + procedures.length;\n      span.setAttributes({ 'consolidator.learned_context.evidence': evidenceCount });\n      // Nothing new to fold and nothing written yet ⇒ no paid call.\n      if (evidenceCount === 0) return skip('no-evidence', previous.length);\n\n      let tokens = 0;\n      let costUsd = 0;\n      try {\n        const res = await deps.provider.generate(\n          buildLearnedContextRequest({\n            previous,\n            episodes,\n            insights,\n            procedures,\n            maxChars: deps.maxChars,\n          }),\n        );\n        tokens =\n          (res.usage.promptTokens ?? 0) +\n          (res.usage.completionTokens ?? 0) +\n          (res.usage.reasoningTokens ?? 0);\n        costUsd =\n          deps.priceUsage?.({\n            promptTokens: res.usage.promptTokens ?? 0,\n            completionTokens: res.usage.completionTokens ?? 0,\n          }) ?? 0;\n        deps.budget.record({ phase: 'deep', tokens, costUsd });\n        const next = normalizeLearnedContext(res.text ?? '', deps.maxChars);\n        if (next === null) {\n          return { ...skip('empty-rewrite', previous.length), tokens, costUsd };\n        }\n        await deps.working.write(deps.scope, LEARNED_CONTEXT_BLOCK_LABEL, next);\n        span.setAttributes({\n          'consolidator.learned_context.updated': true,\n          'consolidator.learned_context.chars': next.length,\n        });\n        return { updated: true, chars: next.length, tokens, costUsd };\n      } catch {\n        // Resilient: a provider failure must never fail the deep phase.\n        return { ...skip('provider-error', previous.length), tokens, costUsd };\n      }\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/consolidator/phases/light.js

@@ -34,6 +34,7 @@ async function runLightPhase(deps) {
 					importance: row.importance,
 					quarantined: row.status === "quarantined",
 					foreignProvenance: isForeignProvenance(row.provenance),
+					accessCount: row.accessCount ?? 0,
 					weights: deps.salienceWeights
 				});
 				if (score < deps.decayArchiveThreshold) {
@@ -84,7 +85,7 @@ async function runLightPhase(deps) {
 	});
 }
 /**
-* `true` for provenance that did not originate first-party (P1-4) — used
+* `true` for provenance that did not originate first-party (P1-4) - used
 * to apply the mild salience penalty in capacity eviction. First-party
 * is `null` (legacy / direct write), `'user'`, and `'extraction'` (the
 * consolidator distilling the user's own session); `'tool'`,

package/dist/consolidator/phases/light.js.map

@@ -1 +1 @@
-{"version":3,"file":"light.js","names":["survivors: Array<{ id: string; salience: number }>"],"sources":["../../../src/consolidator/phases/light.ts"],"sourcesContent":["/**\n * Light phase — no LLM. Decays every fact's retention curve and\n * archives facts whose salience has fallen below the configured\n * threshold (plus the X-1 capacity pass). Noise filtering happens in\n * the standard phase where the batch is actually consumed — the old\n * advisory re-count here read the same unconsumed messages on every\n * pass for a counter nothing acted on (MCON-17).\n *\n * @packageDocumentation\n */\n\nimport type { SessionScope, Tracer } from '@graphorin/core';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type {\n  ConsolidatorMemoryStoreExt,\n  MemoryStoreAdapter,\n} from '../../internal/storage-adapter.js';\nimport { type SalienceWeights, salience, selectForCapacityEviction } from '../decay.js';\nimport type { NoiseFilterPreset } from '../noise-filter.js';\nimport type { PhaseOutcome } from '../types.js';\n\n/** Inputs accepted by {@link runLightPhase}. */\nexport interface LightPhaseDeps {\n  readonly store: MemoryStoreAdapter;\n  readonly consolidatorStore: ConsolidatorMemoryStoreExt | null;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  readonly now: () => number;\n  readonly decayTauDays: number;\n  readonly decayArchiveThreshold: number;\n  /**\n   * Capacity-bounded eviction (X-1). When non-null, the light phase\n   * archives the lowest-salience live facts in the decay window down to\n   * this many, in addition to the threshold archiving. `null` (the\n   * default) leaves storage unbounded — behaviour identical to pre-X-1.\n   */\n  readonly decayCapacity: number | null;\n  /** Weights for the multi-signal salience score (X-1). */\n  readonly salienceWeights: SalienceWeights;\n  readonly noiseFilters: ReadonlyArray<NoiseFilterPreset>;\n  readonly maxBatchSize: number;\n  readonly lastProcessedMessageId: string | null;\n  /** The active consolidator tier — surfaced on the AISpan attribute. */\n  readonly tier?: 'free' | 'cheap' | 'standard' | 'full' | 'custom';\n}\n\n/**\n * Run the light phase against the supplied scope.\n *\n * @stable\n */\nexport async function runLightPhase(deps: LightPhaseDeps): Promise<PhaseOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.light',\n    deps.scope,\n    {\n      'consolidator.phase': 'light',\n      'consolidator.tier': deps.tier ?? 'free',\n    },\n    async (span) => {\n      const startedAt = deps.now();\n      let facts = 0;\n      let archived = 0;\n      let capacityEvicted = 0;\n      if (typeof deps.store.semantic.listForDecay === 'function') {\n        // When a capacity bound is set we widen the decay window past the\n        // batch size so there is always headroom to trim the overflow; the\n        // window is the LRU head (ordered by last-accessed ASC), so the\n        // bound converges over repeated passes.\n        const decayLimit =\n          deps.decayCapacity !== null\n            ? Math.max(deps.maxBatchSize, deps.decayCapacity + deps.maxBatchSize)\n            : deps.maxBatchSize;\n        const rows = await deps.store.semantic.listForDecay(deps.scope, decayLimit);\n        facts = rows.length;\n        const now = deps.now();\n        // Bind once so the optional method stays narrowed across `await`\n        // (and keeps its `this`); `undefined` ⇒ the store can't archive.\n        const archiveFact = deps.store.semantic.archiveFact?.bind(deps.store.semantic);\n        // Pass 1 — multi-signal threshold archiving. Salience folds the\n        // Ebbinghaus retention curve together with the P1-2 importance hint\n        // and the P1-4 security-risk negative term, so a stale, low-value,\n        // or quarantined fact crosses the threshold sooner. Neutral inputs\n        // collapse salience to plain retention (pre-X-1 behaviour).\n        const survivors: Array<{ id: string; salience: number }> = [];\n        for (const row of rows) {\n          if (row.archived) continue;\n          const score = salience({\n            now,\n            lastAccessedAt: row.lastAccessedAt,\n            createdAt: row.createdAt,\n            strength: row.strength,\n            tauDays: deps.decayTauDays,\n            importance: row.importance,\n            quarantined: row.status === 'quarantined',\n            foreignProvenance: isForeignProvenance(row.provenance),\n            weights: deps.salienceWeights,\n          });\n          if (score < deps.decayArchiveThreshold) {\n            if (archiveFact !== undefined) {\n              await archiveFact(row.id, 'low_salience');\n              archived += 1;\n            }\n            continue;\n          }\n          survivors.push({ id: row.id, salience: score });\n        }\n        // Pass 2 — capacity-bounded eviction. Archive the lowest-salience\n        // survivors (security-flagged first) until the window fits.\n        if (deps.decayCapacity !== null && archiveFact !== undefined) {\n          const evictIds = selectForCapacityEviction(survivors, deps.decayCapacity);\n          for (const id of evictIds) {\n            await archiveFact(id, 'capacity_exceeded');\n            archived += 1;\n            capacityEvicted += 1;\n          }\n        }\n      }\n\n      // MCON-17: the light phase no longer re-reads the unconsumed batch\n      // just to produce an advisory dropped-count — the standard phase\n      // filters where extraction actually consumes the messages.\n      const noiseFilteredCount = 0;\n\n      span.setAttributes({\n        'consolidator.duration_ms': Math.max(0, deps.now() - startedAt),\n        'consolidator.facts_extracted': 0,\n        'consolidator.budget_used_usd': 0,\n        'consolidator.light.facts_seen': facts,\n        'consolidator.light.facts_archived': archived,\n        'consolidator.light.capacity_evicted': capacityEvicted,\n        'consolidator.light.noise_filtered': noiseFilteredCount,\n      });\n\n      return {\n        phase: 'light',\n        status: 'completed',\n        factsCreated: 0,\n        factsUpdated: archived,\n        conflictsResolved: 0,\n        episodesFormed: 0,\n        insightsCreated: 0,\n        noiseFilteredCount,\n        emptyExtractions: 0,\n        llmTokensUsed: 0,\n        llmCostUsd: null,\n        errorMessage: null,\n      };\n    },\n  );\n}\n\n/**\n * `true` for provenance that did not originate first-party (P1-4) — used\n * to apply the mild salience penalty in capacity eviction. First-party\n * is `null` (legacy / direct write), `'user'`, and `'extraction'` (the\n * consolidator distilling the user's own session); `'tool'`,\n * `'imported'`, and `'reflection'` are treated as foreign.\n */\nfunction isForeignProvenance(provenance: string | null): boolean {\n  return provenance !== null && provenance !== 'user' && provenance !== 'extraction';\n}\n"],"mappings":";;;;;;;;;AAmDA,eAAsB,cAAc,MAA6C;AAC/E,QAAO,eACL,KAAK,QACL,4BACA,KAAK,OACL;EACE,sBAAsB;EACtB,qBAAqB,KAAK,QAAQ;EACnC,EACD,OAAO,SAAS;EACd,MAAM,YAAY,KAAK,KAAK;EAC5B,IAAI,QAAQ;EACZ,IAAI,WAAW;EACf,IAAI,kBAAkB;AACtB,MAAI,OAAO,KAAK,MAAM,SAAS,iBAAiB,YAAY;GAK1D,MAAM,aACJ,KAAK,kBAAkB,OACnB,KAAK,IAAI,KAAK,cAAc,KAAK,gBAAgB,KAAK,aAAa,GACnE,KAAK;GACX,MAAM,OAAO,MAAM,KAAK,MAAM,SAAS,aAAa,KAAK,OAAO,WAAW;AAC3E,WAAQ,KAAK;GACb,MAAM,MAAM,KAAK,KAAK;GAGtB,MAAM,cAAc,KAAK,MAAM,SAAS,aAAa,KAAK,KAAK,MAAM,SAAS;GAM9E,MAAMA,YAAqD,EAAE;AAC7D,QAAK,MAAM,OAAO,MAAM;AACtB,QAAI,IAAI,SAAU;IAClB,MAAM,QAAQ,SAAS;KACrB;KACA,gBAAgB,IAAI;KACpB,WAAW,IAAI;KACf,UAAU,IAAI;KACd,SAAS,KAAK;KACd,YAAY,IAAI;KAChB,aAAa,IAAI,WAAW;KAC5B,mBAAmB,oBAAoB,IAAI,WAAW;KACtD,SAAS,KAAK;KACf,CAAC;AACF,QAAI,QAAQ,KAAK,uBAAuB;AACtC,SAAI,gBAAgB,QAAW;AAC7B,YAAM,YAAY,IAAI,IAAI,eAAe;AACzC,kBAAY;;AAEd;;AAEF,cAAU,KAAK;KAAE,IAAI,IAAI;KAAI,UAAU;KAAO,CAAC;;AAIjD,OAAI,KAAK,kBAAkB,QAAQ,gBAAgB,QAAW;IAC5D,MAAM,WAAW,0BAA0B,WAAW,KAAK,cAAc;AACzE,SAAK,MAAM,MAAM,UAAU;AACzB,WAAM,YAAY,IAAI,oBAAoB;AAC1C,iBAAY;AACZ,wBAAmB;;;;EAQzB,MAAM,qBAAqB;AAE3B,OAAK,cAAc;GACjB,4BAA4B,KAAK,IAAI,GAAG,KAAK,KAAK,GAAG,UAAU;GAC/D,gCAAgC;GAChC,gCAAgC;GAChC,iCAAiC;GACjC,qCAAqC;GACrC,uCAAuC;GACvC,qCAAqC;GACtC,CAAC;AAEF,SAAO;GACL,OAAO;GACP,QAAQ;GACR,cAAc;GACd,cAAc;GACd,mBAAmB;GACnB,gBAAgB;GAChB,iBAAiB;GACjB;GACA,kBAAkB;GAClB,eAAe;GACf,YAAY;GACZ,cAAc;GACf;GAEJ;;;;;;;;;AAUH,SAAS,oBAAoB,YAAoC;AAC/D,QAAO,eAAe,QAAQ,eAAe,UAAU,eAAe"}
+{"version":3,"file":"light.js","names":["survivors: Array<{ id: string; salience: number }>"],"sources":["../../../src/consolidator/phases/light.ts"],"sourcesContent":["/**\n * Light phase - no LLM. Decays every fact's retention curve and\n * archives facts whose salience has fallen below the configured\n * threshold (plus the X-1 capacity pass). Noise filtering happens in\n * the standard phase where the batch is actually consumed - the old\n * advisory re-count here read the same unconsumed messages on every\n * pass for a counter nothing acted on (MCON-17).\n *\n * @packageDocumentation\n */\n\nimport type { SessionScope, Tracer } from '@graphorin/core';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type {\n  ConsolidatorMemoryStoreExt,\n  MemoryStoreAdapter,\n} from '../../internal/storage-adapter.js';\nimport { type SalienceWeights, salience, selectForCapacityEviction } from '../decay.js';\nimport type { NoiseFilterPreset } from '../noise-filter.js';\nimport type { PhaseOutcome } from '../types.js';\n\n/** Inputs accepted by {@link runLightPhase}. */\nexport interface LightPhaseDeps {\n  readonly store: MemoryStoreAdapter;\n  readonly consolidatorStore: ConsolidatorMemoryStoreExt | null;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  readonly now: () => number;\n  readonly decayTauDays: number;\n  readonly decayArchiveThreshold: number;\n  /**\n   * Capacity-bounded eviction (X-1). When non-null, the light phase\n   * archives the lowest-salience live facts in the decay window down to\n   * this many, in addition to the threshold archiving. `null` (the\n   * default) leaves storage unbounded - behaviour identical to pre-X-1.\n   */\n  readonly decayCapacity: number | null;\n  /** Weights for the multi-signal salience score (X-1). */\n  readonly salienceWeights: SalienceWeights;\n  readonly noiseFilters: ReadonlyArray<NoiseFilterPreset>;\n  readonly maxBatchSize: number;\n  readonly lastProcessedMessageId: string | null;\n  /** The active consolidator tier - surfaced on the AISpan attribute. */\n  readonly tier?: 'free' | 'cheap' | 'standard' | 'full' | 'custom';\n}\n\n/**\n * Run the light phase against the supplied scope.\n *\n * @stable\n */\nexport async function runLightPhase(deps: LightPhaseDeps): Promise<PhaseOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.light',\n    deps.scope,\n    {\n      'consolidator.phase': 'light',\n      'consolidator.tier': deps.tier ?? 'free',\n    },\n    async (span) => {\n      const startedAt = deps.now();\n      let facts = 0;\n      let archived = 0;\n      let capacityEvicted = 0;\n      if (typeof deps.store.semantic.listForDecay === 'function') {\n        // When a capacity bound is set we widen the decay window past the\n        // batch size so there is always headroom to trim the overflow; the\n        // window is the LRU head (ordered by last-accessed ASC), so the\n        // bound converges over repeated passes.\n        const decayLimit =\n          deps.decayCapacity !== null\n            ? Math.max(deps.maxBatchSize, deps.decayCapacity + deps.maxBatchSize)\n            : deps.maxBatchSize;\n        const rows = await deps.store.semantic.listForDecay(deps.scope, decayLimit);\n        facts = rows.length;\n        const now = deps.now();\n        // Bind once so the optional method stays narrowed across `await`\n        // (and keeps its `this`); `undefined` ⇒ the store can't archive.\n        const archiveFact = deps.store.semantic.archiveFact?.bind(deps.store.semantic);\n        // Pass 1 - multi-signal threshold archiving. Salience folds the\n        // Ebbinghaus retention curve together with the P1-2 importance hint\n        // and the P1-4 security-risk negative term, so a stale, low-value,\n        // or quarantined fact crosses the threshold sooner. Neutral inputs\n        // collapse salience to plain retention (pre-X-1 behaviour).\n        const survivors: Array<{ id: string; salience: number }> = [];\n        for (const row of rows) {\n          if (row.archived) continue;\n          const score = salience({\n            now,\n            lastAccessedAt: row.lastAccessedAt,\n            createdAt: row.createdAt,\n            strength: row.strength,\n            tauDays: deps.decayTauDays,\n            importance: row.importance,\n            quarantined: row.status === 'quarantined',\n            foreignProvenance: isForeignProvenance(row.provenance),\n            // D3: retrieval-frequency reinforcement - inert at the\n            // default weight 0; adapters without the column report 0.\n            accessCount: row.accessCount ?? 0,\n            weights: deps.salienceWeights,\n          });\n          if (score < deps.decayArchiveThreshold) {\n            if (archiveFact !== undefined) {\n              await archiveFact(row.id, 'low_salience');\n              archived += 1;\n            }\n            continue;\n          }\n          survivors.push({ id: row.id, salience: score });\n        }\n        // Pass 2 - capacity-bounded eviction. Archive the lowest-salience\n        // survivors (security-flagged first) until the window fits.\n        if (deps.decayCapacity !== null && archiveFact !== undefined) {\n          const evictIds = selectForCapacityEviction(survivors, deps.decayCapacity);\n          for (const id of evictIds) {\n            await archiveFact(id, 'capacity_exceeded');\n            archived += 1;\n            capacityEvicted += 1;\n          }\n        }\n      }\n\n      // MCON-17: the light phase no longer re-reads the unconsumed batch\n      // just to produce an advisory dropped-count - the standard phase\n      // filters where extraction actually consumes the messages.\n      const noiseFilteredCount = 0;\n\n      span.setAttributes({\n        'consolidator.duration_ms': Math.max(0, deps.now() - startedAt),\n        'consolidator.facts_extracted': 0,\n        'consolidator.budget_used_usd': 0,\n        'consolidator.light.facts_seen': facts,\n        'consolidator.light.facts_archived': archived,\n        'consolidator.light.capacity_evicted': capacityEvicted,\n        'consolidator.light.noise_filtered': noiseFilteredCount,\n      });\n\n      return {\n        phase: 'light',\n        status: 'completed',\n        factsCreated: 0,\n        factsUpdated: archived,\n        conflictsResolved: 0,\n        episodesFormed: 0,\n        insightsCreated: 0,\n        noiseFilteredCount,\n        emptyExtractions: 0,\n        llmTokensUsed: 0,\n        llmCostUsd: null,\n        errorMessage: null,\n      };\n    },\n  );\n}\n\n/**\n * `true` for provenance that did not originate first-party (P1-4) - used\n * to apply the mild salience penalty in capacity eviction. First-party\n * is `null` (legacy / direct write), `'user'`, and `'extraction'` (the\n * consolidator distilling the user's own session); `'tool'`,\n * `'imported'`, and `'reflection'` are treated as foreign.\n */\nfunction isForeignProvenance(provenance: string | null): boolean {\n  return provenance !== null && provenance !== 'user' && provenance !== 'extraction';\n}\n"],"mappings":";;;;;;;;;AAmDA,eAAsB,cAAc,MAA6C;AAC/E,QAAO,eACL,KAAK,QACL,4BACA,KAAK,OACL;EACE,sBAAsB;EACtB,qBAAqB,KAAK,QAAQ;EACnC,EACD,OAAO,SAAS;EACd,MAAM,YAAY,KAAK,KAAK;EAC5B,IAAI,QAAQ;EACZ,IAAI,WAAW;EACf,IAAI,kBAAkB;AACtB,MAAI,OAAO,KAAK,MAAM,SAAS,iBAAiB,YAAY;GAK1D,MAAM,aACJ,KAAK,kBAAkB,OACnB,KAAK,IAAI,KAAK,cAAc,KAAK,gBAAgB,KAAK,aAAa,GACnE,KAAK;GACX,MAAM,OAAO,MAAM,KAAK,MAAM,SAAS,aAAa,KAAK,OAAO,WAAW;AAC3E,WAAQ,KAAK;GACb,MAAM,MAAM,KAAK,KAAK;GAGtB,MAAM,cAAc,KAAK,MAAM,SAAS,aAAa,KAAK,KAAK,MAAM,SAAS;GAM9E,MAAMA,YAAqD,EAAE;AAC7D,QAAK,MAAM,OAAO,MAAM;AACtB,QAAI,IAAI,SAAU;IAClB,MAAM,QAAQ,SAAS;KACrB;KACA,gBAAgB,IAAI;KACpB,WAAW,IAAI;KACf,UAAU,IAAI;KACd,SAAS,KAAK;KACd,YAAY,IAAI;KAChB,aAAa,IAAI,WAAW;KAC5B,mBAAmB,oBAAoB,IAAI,WAAW;KAGtD,aAAa,IAAI,eAAe;KAChC,SAAS,KAAK;KACf,CAAC;AACF,QAAI,QAAQ,KAAK,uBAAuB;AACtC,SAAI,gBAAgB,QAAW;AAC7B,YAAM,YAAY,IAAI,IAAI,eAAe;AACzC,kBAAY;;AAEd;;AAEF,cAAU,KAAK;KAAE,IAAI,IAAI;KAAI,UAAU;KAAO,CAAC;;AAIjD,OAAI,KAAK,kBAAkB,QAAQ,gBAAgB,QAAW;IAC5D,MAAM,WAAW,0BAA0B,WAAW,KAAK,cAAc;AACzE,SAAK,MAAM,MAAM,UAAU;AACzB,WAAM,YAAY,IAAI,oBAAoB;AAC1C,iBAAY;AACZ,wBAAmB;;;;EAQzB,MAAM,qBAAqB;AAE3B,OAAK,cAAc;GACjB,4BAA4B,KAAK,IAAI,GAAG,KAAK,KAAK,GAAG,UAAU;GAC/D,gCAAgC;GAChC,gCAAgC;GAChC,iCAAiC;GACjC,qCAAqC;GACrC,uCAAuC;GACvC,qCAAqC;GACtC,CAAC;AAEF,SAAO;GACL,OAAO;GACP,QAAQ;GACR,cAAc;GACd,cAAc;GACd,mBAAmB;GACnB,gBAAgB;GAChB,iBAAiB;GACjB;GACA,kBAAkB;GAClB,eAAe;GACf,YAAY;GACZ,cAAc;GACf;GAEJ;;;;;;;;;AAUH,SAAS,oBAAoB,YAAoC;AAC/D,QAAO,eAAe,QAAQ,eAAe,UAAU,eAAe"}

package/dist/consolidator/phases/reflect.js

@@ -20,7 +20,7 @@ const INSIGHT_SYSTEM_PROMPT = [
 	"JSON: { \"insight\": string }."
 ].join(" ");
 /**
-* Run the reflection pass. Idempotent w.r.t. failures — a parse miss or
+* Run the reflection pass. Idempotent w.r.t. failures - a parse miss or
 * empty synthesis simply yields no insight. Never throws on model
 * output; only storage errors propagate.
 */
@@ -121,6 +121,7 @@ async function runReflectionPass(deps) {
 				salience: STARTING_SALIENCE,
 				provenance: "reflection",
 				status: "quarantined",
+				owner: "agent",
 				sensitivity: "internal",
 				createdAt: iso,
 				updatedAt: iso
@@ -155,7 +156,7 @@ async function runReflectionPass(deps) {
 	});
 }
 /**
-* Normalise an insight for exact-dedup comparison — lowercased, punctuation
+* Normalise an insight for exact-dedup comparison - lowercased, punctuation
 * stripped, whitespace collapsed. Two insights that differ only in casing or
 * trailing punctuation collapse to the same key.
 *
@@ -219,7 +220,7 @@ function dedupeEvidence(items) {
 	return out;
 }
 /**
-* Parse the salient-questions response — accepts `{ questions: [...] }`
+* Parse the salient-questions response - accepts `{ questions: [...] }`
 * or a bare `[...]`, tolerating chatty / fenced output. Returns the
 * trimmed, non-empty string questions (possibly `[]`).
 *
@@ -234,7 +235,7 @@ function parseQuestions(text) {
 	return arr.filter((q) => typeof q === "string" && q.trim().length > 0).map((q) => q.trim());
 }
 /**
-* Parse the insight-synthesis response — accepts `{ insight: string }`
+* Parse the insight-synthesis response - accepts `{ insight: string }`
 * (or `{ text: string }`), tolerating chatty / fenced output. Returns
 * the trimmed insight text, or `null` when absent / empty (insufficient
 * evidence ⇒ no insight).

package/dist/consolidator/phases/reflect.js.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.js","names":["created: string[]","out: Evidence[]"],"sources":["../../../src/consolidator/phases/reflect.ts"],"sourcesContent":["/**\n * Reflection pass (P1-1) — the deep phase's higher-order synthesis\n * step, following the Generative-Agents recipe. When the accumulated\n * importance of recent episodes crosses a threshold, ask the model for\n * the few most salient questions, retrieve evidence for each, and\n * synthesize an **insight** the evidence supports — recorded\n * quarantined, `provenance: 'reflection'`, and **citing the retrieved\n * memory ids** (citations are set by the framework from the actual\n * evidence, never chosen by the model, so they can never be\n * hallucinated). Insights start at ExpeL salience `2`; the pass prunes\n * any that have decayed to `0`.\n *\n * Runs after the deep-phase conflict drain (wired in the runtime\n * dispatch), reusing the same budget / lock / run-audit envelope. The\n * conflict-resolution logic in `deep.ts` is untouched.\n *\n * @packageDocumentation\n */\n\nimport type { Provider, ProviderRequest, SessionScope, Tracer } from '@graphorin/core';\nimport { newMemoryId } from '../../internal/id.js';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type { InsightMemoryStoreExt } from '../../internal/storage-adapter.js';\nimport type { EpisodicMemory } from '../../tiers/episodic-memory.js';\nimport type { SemanticMemory } from '../../tiers/semantic-memory.js';\nimport type { BudgetTracker } from '../budget.js';\n\n/** ExpeL starting salience for a freshly-synthesized insight. */\nconst STARTING_SALIENCE = 2;\n\n/** How many recent episode summaries to show the salient-questions prompt. */\nconst RECENT_CONTEXT_LIMIT = 20;\n\n/** Inputs accepted by {@link runReflectionPass}. */\nexport interface ReflectionDeps {\n  readonly provider: Provider;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  /** Tier used to retrieve fact evidence for each salient question. */\n  readonly semantic: SemanticMemory;\n  /** Importance source + episode-evidence retrieval. `null` ⇒ pass is a no-op. */\n  readonly episodic: EpisodicMemory | null;\n  /** Insight write + salience surface. */\n  readonly insights: InsightMemoryStoreExt;\n  readonly budget: BudgetTracker;\n  /** Reflection fires only when accumulated episode importance ≥ this. */\n  readonly importanceThreshold: number;\n  /**\n   * `ended_at` (epoch ms) of the newest episode a prior pass already reflected\n   * on (MCON-13). The gate accumulates importance only from strictly-newer\n   * episodes, so a deep run with no new episodes never re-fires. `null` /\n   * absent ⇒ nothing reflected yet (accumulate over all recent episodes).\n   */\n  readonly reflectionWatermark?: number | null;\n  /** Upper bound on salient questions asked per pass. */\n  readonly maxQuestions: number;\n  readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n  /** Override the wall clock — used by tests. */\n  readonly now?: () => number;\n}\n\n/** Summary returned by {@link runReflectionPass}. */\nexport interface ReflectionOutcome {\n  /** True when accumulated importance crossed the threshold and the pass ran. */\n  readonly triggered: boolean;\n  readonly accumulatedImportance: number;\n  readonly questionsAsked: number;\n  readonly insightsCreated: number;\n  readonly tokens: number;\n  readonly costUsd: number;\n  /**\n   * Watermark to persist for the next pass (MCON-13): the `ended_at` (epoch\n   * ms) of the newest episode this pass reflected on, or the incoming\n   * watermark unchanged when the pass did not fire. The runtime persists it\n   * to `consolidator_state`.\n   */\n  readonly nextWatermark: number | null;\n}\n\nconst QUESTIONS_SYSTEM_PROMPT = [\n  'You are the reflection step (salient-questions) of a long-running personal-assistant memory.',\n  'Given a list of recent memories, name the few most salient, high-level questions whose',\n  'answers would most improve understanding of the user. Do NOT answer them; ask only what the',\n  'memories collectively raise. Return strictly JSON: { \"questions\": string[] }.',\n].join(' ');\n\nconst INSIGHT_SYSTEM_PROMPT = [\n  'You are the reflection step (insight-synthesis) of a long-running personal-assistant memory.',\n  'Given a salient question and the supporting evidence, synthesize ONE concise, higher-order',\n  'insight that the evidence collectively supports. Ground it ONLY in the supplied evidence; if',\n  'the evidence is insufficient, return an empty string. Do NOT invent facts. Return strictly',\n  'JSON: { \"insight\": string }.',\n].join(' ');\n\ninterface Evidence {\n  readonly id: string;\n  readonly text: string;\n}\n\n/**\n * Run the reflection pass. Idempotent w.r.t. failures — a parse miss or\n * empty synthesis simply yields no insight. Never throws on model\n * output; only storage errors propagate.\n */\nexport async function runReflectionPass(deps: ReflectionDeps): Promise<ReflectionOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.reflect',\n    deps.scope,\n    { 'consolidator.phase': 'reflect' },\n    async (span) => {\n      const empty = (over: Partial<ReflectionOutcome> = {}): ReflectionOutcome => ({\n        triggered: false,\n        accumulatedImportance: 0,\n        questionsAsked: 0,\n        insightsCreated: 0,\n        tokens: 0,\n        costUsd: 0,\n        nextWatermark: deps.reflectionWatermark ?? null,\n        ...over,\n      });\n\n      if (deps.episodic === null) {\n        span.setAttributes({ 'consolidator.reflect.skipped': 'no-episodic' });\n        return empty();\n      }\n      if (deps.budget.snapshot().paused) {\n        span.setAttributes({ 'consolidator.reflect.skipped': 'budget' });\n        return empty();\n      }\n\n      // 1. Accumulated-importance gate. Recency, not relevance: list the most\n      //    recent episodes (MCON-1 — the old `'*'` FTS probe matched zero rows\n      //    on real SQLite). Auto-formed episodes (P1-2) land\n      //    quarantined, so importance accrues there — include them. Only count\n      //    episodes newer than the watermark so a pass with no new episodes\n      //    never re-fires the paid synthesis (MCON-13).\n      const recentEpisodes = await deps.episodic.listRecent(deps.scope, 50, {\n        includeQuarantined: true,\n      });\n      const watermark = deps.reflectionWatermark ?? null;\n      const fresh =\n        watermark === null\n          ? recentEpisodes\n          : recentEpisodes.filter((e) => Date.parse(e.endedAt) > watermark);\n      const accumulated = fresh.reduce((sum, episode) => sum + (episode.importance ?? 0), 0);\n      span.setAttributes({\n        'consolidator.reflect.accumulated_importance': accumulated,\n        'consolidator.reflect.threshold': deps.importanceThreshold,\n      });\n      if (accumulated < deps.importanceThreshold) {\n        span.setAttributes({ 'consolidator.reflect.triggered': 0 });\n        return empty({ accumulatedImportance: accumulated });\n      }\n      // The newest episode this pass will reflect on — persisted as the next\n      // watermark so subsequent passes skip everything up to here.\n      const advancedWatermark = fresh.reduce(\n        (max, episode) => Math.max(max, Date.parse(episode.endedAt)),\n        watermark ?? Number.NEGATIVE_INFINITY,\n      );\n\n      let tokens = 0;\n      let costUsd = 0;\n      const record = (usage: {\n        promptTokens?: number;\n        completionTokens?: number;\n        reasoningTokens?: number;\n      }): void => {\n        const t =\n          (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0) + (usage.reasoningTokens ?? 0);\n        const c =\n          deps.priceUsage?.({\n            promptTokens: usage.promptTokens ?? 0,\n            completionTokens: usage.completionTokens ?? 0,\n          }) ?? 0;\n        tokens += t;\n        costUsd += c;\n        deps.budget.record({ phase: 'deep', tokens: t, costUsd: c });\n      };\n\n      // 2. Salient questions over the new (post-watermark) memories.\n      const recentSummaries = fresh\n        .slice(0, RECENT_CONTEXT_LIMIT)\n        .map((episode) => `- ${episode.summary}`)\n        .join('\\n');\n      const questionsRes = await deps.provider.generate(\n        buildQuestionsRequest(deps, recentSummaries),\n      );\n      record(questionsRes.usage);\n      const questions = parseQuestions(questionsRes.text).slice(0, Math.max(0, deps.maxQuestions));\n      span.setAttributes({ 'consolidator.reflect.questions': questions.length });\n\n      // Pre-filter new insights against already-stored ones so a re-fire over\n      // overlapping evidence does not write near-duplicates (MCON-13). Offline\n      // and embedding-free: normalised exact match, the insight analogue of\n      // the conflict pipeline's stage-1 dedup.\n      const seenInsights = new Set(\n        (await deps.insights.list(deps.scope, { includeQuarantined: true, limit: 200 })).map((i) =>\n          normalizeInsightText(i.text),\n        ),\n      );\n\n      const nowFn = typeof deps.now === 'function' ? deps.now : Date.now;\n      let insightsCreated = 0;\n      const created: string[] = [];\n      for (const question of questions) {\n        if (deps.budget.snapshot().paused) break;\n\n        // 3. Retrieve evidence. Facts are trustworthy (active only);\n        //    episodes include the quarantined auto-formed ones.\n        const factHits = await deps.semantic.search(deps.scope, question, { topK: 5 });\n        const epHits = await deps.episodic.search(deps.scope, question, {\n          topK: 5,\n          includeQuarantined: true,\n        });\n        const evidence = dedupeEvidence([\n          ...factHits.map((h) => ({ id: h.record.id, text: h.record.text })),\n          ...epHits.map((h) => ({ id: h.record.id, text: h.record.summary })),\n        ]);\n        // Citations are mandatory — no evidence ⇒ no insight.\n        if (evidence.length === 0) continue;\n\n        // 4. Synthesize an insight grounded in that evidence.\n        if (deps.budget.snapshot().paused) break;\n        const insightRes = await deps.provider.generate(\n          buildInsightRequest(deps, question, evidence),\n        );\n        record(insightRes.usage);\n        const text = parseInsight(insightRes.text);\n        if (text === null) continue;\n\n        // Skip near-duplicates of an already-stored insight (and of one just\n        // written this pass).\n        const normalized = normalizeInsightText(text);\n        if (seenInsights.has(normalized)) continue;\n        seenInsights.add(normalized);\n\n        const iso = new Date(nowFn()).toISOString();\n        const insightId = newMemoryId('ins');\n        await deps.insights.insert({\n          id: insightId,\n          kind: 'insight',\n          userId: deps.scope.userId,\n          ...(deps.scope.sessionId !== undefined ? { sessionId: deps.scope.sessionId } : {}),\n          ...(deps.scope.agentId !== undefined ? { agentId: deps.scope.agentId } : {}),\n          text,\n          // cites = the actual retrieved evidence ids (framework-set).\n          cites: evidence.map((e) => e.id),\n          salience: STARTING_SALIENCE,\n          provenance: 'reflection',\n          status: 'quarantined',\n          sensitivity: 'internal',\n          createdAt: iso,\n          updatedAt: iso,\n        });\n        created.push(insightId);\n        insightsCreated += 1;\n      }\n\n      // 5. ExpeL forgetting (MCON-16): decay every existing insight by 1\n      // per reflection pass. Retrieval bumps +1 (InsightMemory.search),\n      // so an insight recalled since the last pass nets level-or-better\n      // while an unused one slides toward the prune floor — starting\n      // salience 2 ⇒ pruned after two idle passes. Fresh insights from\n      // THIS pass are exempt (they were inserted above at full salience\n      // and have had no retrieval window yet).\n      const freshIds = new Set(created);\n      for (const existing of await deps.insights.list(deps.scope, {\n        includeQuarantined: true,\n        limit: 500,\n      })) {\n        if (freshIds.has(existing.id)) continue;\n        await deps.insights.bumpSalience(existing.id, -1, 'reflection-pass-decay');\n      }\n      await deps.insights.prune(deps.scope);\n\n      span.setAttributes({\n        'consolidator.reflect.triggered': 1,\n        'consolidator.reflect.insights_created': insightsCreated,\n        'consolidator.reflect.tokens': tokens,\n        'consolidator.reflect.cost.usd': costUsd,\n      });\n      return {\n        triggered: true,\n        accumulatedImportance: accumulated,\n        questionsAsked: questions.length,\n        insightsCreated,\n        tokens,\n        costUsd,\n        // Advance past everything reflected on this pass. `advancedWatermark`\n        // is finite here (the gate fired ⇒ `fresh` is non-empty).\n        nextWatermark: Number.isFinite(advancedWatermark) ? advancedWatermark : watermark,\n      };\n    },\n  );\n}\n\n/**\n * Normalise an insight for exact-dedup comparison — lowercased, punctuation\n * stripped, whitespace collapsed. Two insights that differ only in casing or\n * trailing punctuation collapse to the same key.\n *\n * @internal\n */\nexport function normalizeInsightText(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^\\p{L}\\p{N}\\s]/gu, ' ')\n    .replace(/\\s+/gu, ' ')\n    .trim();\n}\n\nfunction buildQuestionsRequest(deps: ReflectionDeps, recentSummaries: string): ProviderRequest {\n  const userBlock = [\n    'Recent memories:',\n    recentSummaries.length > 0 ? recentSummaries : '(none)',\n    '',\n    `Name up to ${deps.maxQuestions} salient questions.`,\n  ].join('\\n');\n  return {\n    messages: [{ role: 'user', content: userBlock }],\n    systemMessage: QUESTIONS_SYSTEM_PROMPT,\n    temperature: 0,\n    // MCON-14: per-call output cap — a short question list.\n    maxTokens: 512,\n    metadata: scopeMetadata(deps.scope),\n    outputType: { kind: 'structured' },\n  };\n}\n\nfunction buildInsightRequest(\n  deps: ReflectionDeps,\n  question: string,\n  evidence: ReadonlyArray<Evidence>,\n): ProviderRequest {\n  const evidenceBlock = evidence.map((e, i) => `[${i + 1}] (id=${e.id}) ${e.text}`).join('\\n');\n  const userBlock = [`Question: ${question}`, '', 'Evidence:', evidenceBlock].join('\\n');\n  return {\n    messages: [{ role: 'user', content: userBlock }],\n    systemMessage: INSIGHT_SYSTEM_PROMPT,\n    temperature: 0,\n    // MCON-14: per-call output cap — one insight object.\n    maxTokens: 512,\n    metadata: scopeMetadata(deps.scope),\n    outputType: { kind: 'structured' },\n  };\n}\n\nfunction scopeMetadata(scope: SessionScope): Record<string, string> {\n  return {\n    userId: scope.userId,\n    ...(scope.sessionId !== undefined ? { sessionId: scope.sessionId } : {}),\n    ...(scope.agentId !== undefined ? { agentId: scope.agentId } : {}),\n  };\n}\n\nfunction dedupeEvidence(items: ReadonlyArray<Evidence>): Evidence[] {\n  const seen = new Set<string>();\n  const out: Evidence[] = [];\n  for (const e of items) {\n    if (e.id.length === 0 || seen.has(e.id)) continue;\n    seen.add(e.id);\n    out.push(e);\n  }\n  return out;\n}\n\n/**\n * Parse the salient-questions response — accepts `{ questions: [...] }`\n * or a bare `[...]`, tolerating chatty / fenced output. Returns the\n * trimmed, non-empty string questions (possibly `[]`).\n *\n * @internal\n */\nexport function parseQuestions(text: string | undefined): string[] {\n  if (text === undefined || text.length === 0) return [];\n  const candidate = stripFence(text).trim();\n  const parsed = tryParse(candidate);\n  if (parsed === undefined) return [];\n  const arr = Array.isArray(parsed)\n    ? parsed\n    : isRecord(parsed) && Array.isArray(parsed.questions)\n      ? parsed.questions\n      : null;\n  if (arr === null) return [];\n  return arr\n    .filter((q): q is string => typeof q === 'string' && q.trim().length > 0)\n    .map((q) => q.trim());\n}\n\n/**\n * Parse the insight-synthesis response — accepts `{ insight: string }`\n * (or `{ text: string }`), tolerating chatty / fenced output. Returns\n * the trimmed insight text, or `null` when absent / empty (insufficient\n * evidence ⇒ no insight).\n *\n * @internal\n */\nexport function parseInsight(text: string | undefined): string | null {\n  if (text === undefined || text.length === 0) return null;\n  const candidate = stripFence(text).trim();\n  const parsed = tryParse(candidate);\n  if (!isRecord(parsed)) return null;\n  const raw = typeof parsed.insight === 'string' ? parsed.insight : null;\n  const fallback = typeof parsed.text === 'string' ? parsed.text : null;\n  const value = raw ?? fallback;\n  if (value === null || value.trim().length === 0) return null;\n  return value.trim();\n}\n\nfunction tryParse(candidate: string): unknown {\n  if (candidate.length === 0) return undefined;\n  try {\n    return JSON.parse(candidate);\n  } catch {\n    const obj = sliceBetween(candidate, '{', '}');\n    if (obj !== null) {\n      try {\n        return JSON.parse(obj);\n      } catch {\n        // fall through to array attempt\n      }\n    }\n    const arr = sliceBetween(candidate, '[', ']');\n    if (arr !== null) {\n      try {\n        return JSON.parse(arr);\n      } catch {\n        return undefined;\n      }\n    }\n    return undefined;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction stripFence(text: string): string {\n  const match = /^```[^\\n]*\\n([\\s\\S]*?)\\n```/u.exec(text.trim());\n  return match?.[1] ?? text;\n}\n\nfunction sliceBetween(text: string, open: string, close: string): string | null {\n  const start = text.indexOf(open);\n  const end = text.lastIndexOf(close);\n  if (start < 0 || end < start) return null;\n  return text.slice(start, end + 1);\n}\n"],"mappings":"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"}
+{"version":3,"file":"reflect.js","names":["created: string[]","out: Evidence[]"],"sources":["../../../src/consolidator/phases/reflect.ts"],"sourcesContent":["/**\n * Reflection pass (P1-1) - the deep phase's higher-order synthesis\n * step, following the Generative-Agents recipe. When the accumulated\n * importance of recent episodes crosses a threshold, ask the model for\n * the few most salient questions, retrieve evidence for each, and\n * synthesize an **insight** the evidence supports - recorded\n * quarantined, `provenance: 'reflection'`, and **citing the retrieved\n * memory ids** (citations are set by the framework from the actual\n * evidence, never chosen by the model, so they can never be\n * hallucinated). Insights start at ExpeL salience `2`; the pass prunes\n * any that have decayed to `0`.\n *\n * Runs after the deep-phase conflict drain (wired in the runtime\n * dispatch), reusing the same budget / lock / run-audit envelope. The\n * conflict-resolution logic in `deep.ts` is untouched.\n *\n * @packageDocumentation\n */\n\nimport type { Provider, ProviderRequest, SessionScope, Tracer } from '@graphorin/core';\nimport { newMemoryId } from '../../internal/id.js';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type { InsightMemoryStoreExt } from '../../internal/storage-adapter.js';\nimport type { EpisodicMemory } from '../../tiers/episodic-memory.js';\nimport type { SemanticMemory } from '../../tiers/semantic-memory.js';\nimport type { BudgetTracker } from '../budget.js';\n\n/** ExpeL starting salience for a freshly-synthesized insight. */\nconst STARTING_SALIENCE = 2;\n\n/** How many recent episode summaries to show the salient-questions prompt. */\nconst RECENT_CONTEXT_LIMIT = 20;\n\n/** Inputs accepted by {@link runReflectionPass}. */\nexport interface ReflectionDeps {\n  readonly provider: Provider;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  /** Tier used to retrieve fact evidence for each salient question. */\n  readonly semantic: SemanticMemory;\n  /** Importance source + episode-evidence retrieval. `null` ⇒ pass is a no-op. */\n  readonly episodic: EpisodicMemory | null;\n  /** Insight write + salience surface. */\n  readonly insights: InsightMemoryStoreExt;\n  readonly budget: BudgetTracker;\n  /** Reflection fires only when accumulated episode importance ≥ this. */\n  readonly importanceThreshold: number;\n  /**\n   * `ended_at` (epoch ms) of the newest episode a prior pass already reflected\n   * on (MCON-13). The gate accumulates importance only from strictly-newer\n   * episodes, so a deep run with no new episodes never re-fires. `null` /\n   * absent ⇒ nothing reflected yet (accumulate over all recent episodes).\n   */\n  readonly reflectionWatermark?: number | null;\n  /** Upper bound on salient questions asked per pass. */\n  readonly maxQuestions: number;\n  readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n  /** Override the wall clock - used by tests. */\n  readonly now?: () => number;\n}\n\n/** Summary returned by {@link runReflectionPass}. */\nexport interface ReflectionOutcome {\n  /** True when accumulated importance crossed the threshold and the pass ran. */\n  readonly triggered: boolean;\n  readonly accumulatedImportance: number;\n  readonly questionsAsked: number;\n  readonly insightsCreated: number;\n  readonly tokens: number;\n  readonly costUsd: number;\n  /**\n   * Watermark to persist for the next pass (MCON-13): the `ended_at` (epoch\n   * ms) of the newest episode this pass reflected on, or the incoming\n   * watermark unchanged when the pass did not fire. The runtime persists it\n   * to `consolidator_state`.\n   */\n  readonly nextWatermark: number | null;\n}\n\nconst QUESTIONS_SYSTEM_PROMPT = [\n  'You are the reflection step (salient-questions) of a long-running personal-assistant memory.',\n  'Given a list of recent memories, name the few most salient, high-level questions whose',\n  'answers would most improve understanding of the user. Do NOT answer them; ask only what the',\n  'memories collectively raise. Return strictly JSON: { \"questions\": string[] }.',\n].join(' ');\n\nconst INSIGHT_SYSTEM_PROMPT = [\n  'You are the reflection step (insight-synthesis) of a long-running personal-assistant memory.',\n  'Given a salient question and the supporting evidence, synthesize ONE concise, higher-order',\n  'insight that the evidence collectively supports. Ground it ONLY in the supplied evidence; if',\n  'the evidence is insufficient, return an empty string. Do NOT invent facts. Return strictly',\n  'JSON: { \"insight\": string }.',\n].join(' ');\n\ninterface Evidence {\n  readonly id: string;\n  readonly text: string;\n}\n\n/**\n * Run the reflection pass. Idempotent w.r.t. failures - a parse miss or\n * empty synthesis simply yields no insight. Never throws on model\n * output; only storage errors propagate.\n */\nexport async function runReflectionPass(deps: ReflectionDeps): Promise<ReflectionOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.reflect',\n    deps.scope,\n    { 'consolidator.phase': 'reflect' },\n    async (span) => {\n      const empty = (over: Partial<ReflectionOutcome> = {}): ReflectionOutcome => ({\n        triggered: false,\n        accumulatedImportance: 0,\n        questionsAsked: 0,\n        insightsCreated: 0,\n        tokens: 0,\n        costUsd: 0,\n        nextWatermark: deps.reflectionWatermark ?? null,\n        ...over,\n      });\n\n      if (deps.episodic === null) {\n        span.setAttributes({ 'consolidator.reflect.skipped': 'no-episodic' });\n        return empty();\n      }\n      if (deps.budget.snapshot().paused) {\n        span.setAttributes({ 'consolidator.reflect.skipped': 'budget' });\n        return empty();\n      }\n\n      // 1. Accumulated-importance gate. Recency, not relevance: list the most\n      //    recent episodes (MCON-1 - the old `'*'` FTS probe matched zero rows\n      //    on real SQLite). Auto-formed episodes (P1-2) land\n      //    quarantined, so importance accrues there - include them. Only count\n      //    episodes newer than the watermark so a pass with no new episodes\n      //    never re-fires the paid synthesis (MCON-13).\n      const recentEpisodes = await deps.episodic.listRecent(deps.scope, 50, {\n        includeQuarantined: true,\n      });\n      const watermark = deps.reflectionWatermark ?? null;\n      const fresh =\n        watermark === null\n          ? recentEpisodes\n          : recentEpisodes.filter((e) => Date.parse(e.endedAt) > watermark);\n      const accumulated = fresh.reduce((sum, episode) => sum + (episode.importance ?? 0), 0);\n      span.setAttributes({\n        'consolidator.reflect.accumulated_importance': accumulated,\n        'consolidator.reflect.threshold': deps.importanceThreshold,\n      });\n      if (accumulated < deps.importanceThreshold) {\n        span.setAttributes({ 'consolidator.reflect.triggered': 0 });\n        return empty({ accumulatedImportance: accumulated });\n      }\n      // The newest episode this pass will reflect on - persisted as the next\n      // watermark so subsequent passes skip everything up to here.\n      const advancedWatermark = fresh.reduce(\n        (max, episode) => Math.max(max, Date.parse(episode.endedAt)),\n        watermark ?? Number.NEGATIVE_INFINITY,\n      );\n\n      let tokens = 0;\n      let costUsd = 0;\n      const record = (usage: {\n        promptTokens?: number;\n        completionTokens?: number;\n        reasoningTokens?: number;\n      }): void => {\n        const t =\n          (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0) + (usage.reasoningTokens ?? 0);\n        const c =\n          deps.priceUsage?.({\n            promptTokens: usage.promptTokens ?? 0,\n            completionTokens: usage.completionTokens ?? 0,\n          }) ?? 0;\n        tokens += t;\n        costUsd += c;\n        deps.budget.record({ phase: 'deep', tokens: t, costUsd: c });\n      };\n\n      // 2. Salient questions over the new (post-watermark) memories.\n      const recentSummaries = fresh\n        .slice(0, RECENT_CONTEXT_LIMIT)\n        .map((episode) => `- ${episode.summary}`)\n        .join('\\n');\n      const questionsRes = await deps.provider.generate(\n        buildQuestionsRequest(deps, recentSummaries),\n      );\n      record(questionsRes.usage);\n      const questions = parseQuestions(questionsRes.text).slice(0, Math.max(0, deps.maxQuestions));\n      span.setAttributes({ 'consolidator.reflect.questions': questions.length });\n\n      // Pre-filter new insights against already-stored ones so a re-fire over\n      // overlapping evidence does not write near-duplicates (MCON-13). Offline\n      // and embedding-free: normalised exact match, the insight analogue of\n      // the conflict pipeline's stage-1 dedup.\n      const seenInsights = new Set(\n        (await deps.insights.list(deps.scope, { includeQuarantined: true, limit: 200 })).map((i) =>\n          normalizeInsightText(i.text),\n        ),\n      );\n\n      const nowFn = typeof deps.now === 'function' ? deps.now : Date.now;\n      let insightsCreated = 0;\n      const created: string[] = [];\n      for (const question of questions) {\n        if (deps.budget.snapshot().paused) break;\n\n        // 3. Retrieve evidence. Facts are trustworthy (active only);\n        //    episodes include the quarantined auto-formed ones.\n        const factHits = await deps.semantic.search(deps.scope, question, { topK: 5 });\n        const epHits = await deps.episodic.search(deps.scope, question, {\n          topK: 5,\n          includeQuarantined: true,\n        });\n        const evidence = dedupeEvidence([\n          ...factHits.map((h) => ({ id: h.record.id, text: h.record.text })),\n          ...epHits.map((h) => ({ id: h.record.id, text: h.record.summary })),\n        ]);\n        // Citations are mandatory - no evidence ⇒ no insight.\n        if (evidence.length === 0) continue;\n\n        // 4. Synthesize an insight grounded in that evidence.\n        if (deps.budget.snapshot().paused) break;\n        const insightRes = await deps.provider.generate(\n          buildInsightRequest(deps, question, evidence),\n        );\n        record(insightRes.usage);\n        const text = parseInsight(insightRes.text);\n        if (text === null) continue;\n\n        // Skip near-duplicates of an already-stored insight (and of one just\n        // written this pass).\n        const normalized = normalizeInsightText(text);\n        if (seenInsights.has(normalized)) continue;\n        seenInsights.add(normalized);\n\n        const iso = new Date(nowFn()).toISOString();\n        const insightId = newMemoryId('ins');\n        await deps.insights.insert({\n          id: insightId,\n          kind: 'insight',\n          userId: deps.scope.userId,\n          ...(deps.scope.sessionId !== undefined ? { sessionId: deps.scope.sessionId } : {}),\n          ...(deps.scope.agentId !== undefined ? { agentId: deps.scope.agentId } : {}),\n          text,\n          // cites = the actual retrieved evidence ids (framework-set).\n          cites: evidence.map((e) => e.id),\n          salience: STARTING_SALIENCE,\n          provenance: 'reflection',\n          status: 'quarantined',\n          // D3: a synthesized insight is the agent's own inference.\n          owner: 'agent',\n          sensitivity: 'internal',\n          createdAt: iso,\n          updatedAt: iso,\n        });\n        created.push(insightId);\n        insightsCreated += 1;\n      }\n\n      // 5. ExpeL forgetting (MCON-16): decay every existing insight by 1\n      // per reflection pass. Retrieval bumps +1 (InsightMemory.search),\n      // so an insight recalled since the last pass nets level-or-better\n      // while an unused one slides toward the prune floor - starting\n      // salience 2 ⇒ pruned after two idle passes. Fresh insights from\n      // THIS pass are exempt (they were inserted above at full salience\n      // and have had no retrieval window yet).\n      const freshIds = new Set(created);\n      for (const existing of await deps.insights.list(deps.scope, {\n        includeQuarantined: true,\n        limit: 500,\n      })) {\n        if (freshIds.has(existing.id)) continue;\n        await deps.insights.bumpSalience(existing.id, -1, 'reflection-pass-decay');\n      }\n      await deps.insights.prune(deps.scope);\n\n      span.setAttributes({\n        'consolidator.reflect.triggered': 1,\n        'consolidator.reflect.insights_created': insightsCreated,\n        'consolidator.reflect.tokens': tokens,\n        'consolidator.reflect.cost.usd': costUsd,\n      });\n      return {\n        triggered: true,\n        accumulatedImportance: accumulated,\n        questionsAsked: questions.length,\n        insightsCreated,\n        tokens,\n        costUsd,\n        // Advance past everything reflected on this pass. `advancedWatermark`\n        // is finite here (the gate fired ⇒ `fresh` is non-empty).\n        nextWatermark: Number.isFinite(advancedWatermark) ? advancedWatermark : watermark,\n      };\n    },\n  );\n}\n\n/**\n * Normalise an insight for exact-dedup comparison - lowercased, punctuation\n * stripped, whitespace collapsed. Two insights that differ only in casing or\n * trailing punctuation collapse to the same key.\n *\n * @internal\n */\nexport function normalizeInsightText(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^\\p{L}\\p{N}\\s]/gu, ' ')\n    .replace(/\\s+/gu, ' ')\n    .trim();\n}\n\nfunction buildQuestionsRequest(deps: ReflectionDeps, recentSummaries: string): ProviderRequest {\n  const userBlock = [\n    'Recent memories:',\n    recentSummaries.length > 0 ? recentSummaries : '(none)',\n    '',\n    `Name up to ${deps.maxQuestions} salient questions.`,\n  ].join('\\n');\n  return {\n    messages: [{ role: 'user', content: userBlock }],\n    systemMessage: QUESTIONS_SYSTEM_PROMPT,\n    temperature: 0,\n    // MCON-14: per-call output cap - a short question list.\n    maxTokens: 512,\n    metadata: scopeMetadata(deps.scope),\n    outputType: { kind: 'structured' },\n  };\n}\n\nfunction buildInsightRequest(\n  deps: ReflectionDeps,\n  question: string,\n  evidence: ReadonlyArray<Evidence>,\n): ProviderRequest {\n  const evidenceBlock = evidence.map((e, i) => `[${i + 1}] (id=${e.id}) ${e.text}`).join('\\n');\n  const userBlock = [`Question: ${question}`, '', 'Evidence:', evidenceBlock].join('\\n');\n  return {\n    messages: [{ role: 'user', content: userBlock }],\n    systemMessage: INSIGHT_SYSTEM_PROMPT,\n    temperature: 0,\n    // MCON-14: per-call output cap - one insight object.\n    maxTokens: 512,\n    metadata: scopeMetadata(deps.scope),\n    outputType: { kind: 'structured' },\n  };\n}\n\nfunction scopeMetadata(scope: SessionScope): Record<string, string> {\n  return {\n    userId: scope.userId,\n    ...(scope.sessionId !== undefined ? { sessionId: scope.sessionId } : {}),\n    ...(scope.agentId !== undefined ? { agentId: scope.agentId } : {}),\n  };\n}\n\nfunction dedupeEvidence(items: ReadonlyArray<Evidence>): Evidence[] {\n  const seen = new Set<string>();\n  const out: Evidence[] = [];\n  for (const e of items) {\n    if (e.id.length === 0 || seen.has(e.id)) continue;\n    seen.add(e.id);\n    out.push(e);\n  }\n  return out;\n}\n\n/**\n * Parse the salient-questions response - accepts `{ questions: [...] }`\n * or a bare `[...]`, tolerating chatty / fenced output. Returns the\n * trimmed, non-empty string questions (possibly `[]`).\n *\n * @internal\n */\nexport function parseQuestions(text: string | undefined): string[] {\n  if (text === undefined || text.length === 0) return [];\n  const candidate = stripFence(text).trim();\n  const parsed = tryParse(candidate);\n  if (parsed === undefined) return [];\n  const arr = Array.isArray(parsed)\n    ? parsed\n    : isRecord(parsed) && Array.isArray(parsed.questions)\n      ? parsed.questions\n      : null;\n  if (arr === null) return [];\n  return arr\n    .filter((q): q is string => typeof q === 'string' && q.trim().length > 0)\n    .map((q) => q.trim());\n}\n\n/**\n * Parse the insight-synthesis response - accepts `{ insight: string }`\n * (or `{ text: string }`), tolerating chatty / fenced output. Returns\n * the trimmed insight text, or `null` when absent / empty (insufficient\n * evidence ⇒ no insight).\n *\n * @internal\n */\nexport function parseInsight(text: string | undefined): string | null {\n  if (text === undefined || text.length === 0) return null;\n  const candidate = stripFence(text).trim();\n  const parsed = tryParse(candidate);\n  if (!isRecord(parsed)) return null;\n  const raw = typeof parsed.insight === 'string' ? parsed.insight : null;\n  const fallback = typeof parsed.text === 'string' ? parsed.text : null;\n  const value = raw ?? fallback;\n  if (value === null || value.trim().length === 0) return null;\n  return value.trim();\n}\n\nfunction tryParse(candidate: string): unknown {\n  if (candidate.length === 0) return undefined;\n  try {\n    return JSON.parse(candidate);\n  } catch {\n    const obj = sliceBetween(candidate, '{', '}');\n    if (obj !== null) {\n      try {\n        return JSON.parse(obj);\n      } catch {\n        // fall through to array attempt\n      }\n    }\n    const arr = sliceBetween(candidate, '[', ']');\n    if (arr !== null) {\n      try {\n        return JSON.parse(arr);\n      } catch {\n        return undefined;\n      }\n    }\n    return undefined;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction stripFence(text: string): string {\n  const match = /^```[^\\n]*\\n([\\s\\S]*?)\\n```/u.exec(text.trim());\n  return match?.[1] ?? text;\n}\n\nfunction sliceBetween(text: string, open: string, close: string): string | null {\n  const start = text.indexOf(open);\n  const end = text.lastIndexOf(close);\n  if (start < 0 || end < start) return null;\n  return text.slice(start, end + 1);\n}\n"],"mappings":"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"}

package/dist/consolidator/phases/standard.js

@@ -13,6 +13,7 @@ const EXTRACTION_SYSTEM_PROMPT = [
 	"You are a memory-extraction assistant for a long-running personal-assistant runtime.",
 	"Read the supplied conversation slice and return the durable facts it asserts about the user, the world, or stable preferences.",
 	"Skip greetings, banter, transient state, and anything the assistant produced as boilerplate.",
+	"Each fact text MUST be a self-contained proposition understandable with no surrounding context: resolve pronouns and ellipses to the named person or thing (\"she\" -> \"Maria\"), inline the concrete entities, and never write a fact that needs a neighbouring fact to make sense.",
 	"For each fact also rate how important it is for remembering the user, on an integer scale from 1 (incidental detail) to 10 (identity-defining).",
 	"Return a single JSON object: { \"facts\": [{ \"text\": string, \"subject\"?: string, \"predicate\"?: string, \"object\"?: string, \"confidence\"?: number, \"importance\"?: number }] }.",
 	"If the slice contains no durable facts, return { \"facts\": [] }."
@@ -28,12 +29,12 @@ const EXTRACTION_MAX_TOKENS = 1024;
 const EPISODE_MAX_TOKENS = 512;
 const EPISODE_SUMMARY_SYSTEM_PROMPT = [
 	"You are an episode-summarization assistant for a long-running personal-assistant runtime.",
-	"Read the supplied conversation slice and write one concise third-person summary of what happened — the episode.",
+	"Read the supplied conversation slice and write one concise third-person summary of what happened - the episode.",
 	"Return a single JSON object: { \"summary\": string }."
 ].join(" ");
 const EPISODE_SUMMARY_IMPORTANCE_SYSTEM_PROMPT = [
 	"You are an episode-summarization assistant for a long-running personal-assistant runtime.",
-	"Read the supplied conversation slice and write one concise third-person summary of what happened — the episode.",
+	"Read the supplied conversation slice and write one concise third-person summary of what happened - the episode.",
 	"Also rate how important / poignant this episode is for remembering the user, on an integer scale from 1 (mundane) to 10 (deeply significant).",
 	"Return a single JSON object: { \"summary\": string, \"importance\": number }."
 ].join(" ");
@@ -109,7 +110,15 @@ async function runStandardPhase(deps) {
 			if (fact.text.trim().length === 0) continue;
 			const input = buildFactInput(fact);
 			const neighbors = await deps.semantic.neighbors(deps.scope, fact.text, { topK: RECONCILE_TOP_K });
-			const route = await preFilterCandidate(fact.text, neighbors);
+			let route = await preFilterCandidate(fact.text, neighbors);
+			if (route.route !== "noop" && neighbors.length === 0) {
+				const exactId = await findExactTextDuplicate(deps.semantic, deps.scope, fact.text);
+				if (exactId !== null) route = {
+					route: "noop",
+					targetId: exactId,
+					reason: "exact-text-fts"
+				};
+			}
 			let decision;
 			let audited;
 			if (route.route === "reconcile" && !deps.budget.snapshot().paused) {
@@ -154,7 +163,7 @@ async function runStandardPhase(deps) {
 				};
 				audited = {
 					kind: "dedup",
-					stage: route.reason === "exact-hash-match" ? "exact-dedup" : "embedding-three-zone",
+					stage: route.reason === "exact-hash-match" || route.reason === "exact-text-fts" ? "exact-dedup" : "embedding-three-zone",
 					existingId: route.targetId,
 					...route.similarity !== void 0 ? { similarity: route.similarity } : {},
 					reason: route.reason
@@ -250,7 +259,8 @@ async function runStandardPhase(deps) {
 					endedAt,
 					...importance !== void 0 ? { importance } : {},
 					provenance: "extraction",
-					status: "quarantined"
+					status: "quarantined",
+					owner: "agent"
 				});
 				episodesFormed = 1;
 			}
@@ -293,12 +303,13 @@ async function runStandardPhase(deps) {
 	});
 }
 function buildRequest(deps, transcript) {
+	const today = new Date(deps.now?.() ?? Date.now()).toISOString().slice(0, 10);
 	return {
 		messages: [{
 			role: "user",
 			content: `Conversation slice:\n${transcript}`
 		}],
-		systemMessage: EXTRACTION_SYSTEM_PROMPT,
+		systemMessage: `${EXTRACTION_SYSTEM_PROMPT} Today is ${today}. Each transcript line carries its timestamp in parentheses; resolve relative dates ("next Friday", "last month") into absolute ISO dates in the extracted fact text.`,
 		temperature: 0,
 		maxTokens: EXTRACTION_MAX_TOKENS,
 		metadata: {
@@ -336,7 +347,8 @@ function renderTranscript(messages) {
 	return messages.map((m) => {
 		const role = m.message.role;
 		const text = renderText(m.message);
-		return `[${m.sequence}] ${role}: ${text}`;
+		const stamp = typeof m.createdAt === "string" && m.createdAt.length > 0 ? m.createdAt : "";
+		return stamp.length > 0 ? `[${m.sequence}] (${stamp}) ${role}: ${text}` : `[${m.sequence}] ${role}: ${text}`;
 	}).join("\n");
 }
 /**
@@ -442,15 +454,32 @@ function sliceJsonObject(text) {
 }
 /**
 * Build the {@link FactInput} for an extracted candidate. P1-4:
-* distilled-from-transcript facts are synthesized memory — tagged
+* distilled-from-transcript facts are synthesized memory - tagged
 * `extraction` so they land quarantined (excluded from action-driving
 * recall until validated).
 */
+/**
+* Embedder-independent exact-duplicate lookup
+* (memory-consolidation-07): FTS top hits + strict string equality.
+* Returns the existing fact's id or `null`. Failures are swallowed -
+* the guard is an optimization, never a reason to fail the slice.
+*/
+async function findExactTextDuplicate(semantic, scope, text) {
+	try {
+		return (await semantic.search(scope, text, {
+			topK: 5,
+			includeQuarantined: true
+		})).find((h) => h.record.text === text)?.record.id ?? null;
+	} catch {
+		return null;
+	}
+}
 function buildFactInput(fact) {
 	const importance = normalizeImportance(fact.importance);
 	return {
 		text: fact.text,
 		provenance: "extraction",
+		owner: "agent",
 		...fact.subject !== void 0 ? { subject: fact.subject } : {},
 		...fact.predicate !== void 0 ? { predicate: fact.predicate } : {},
 		...fact.object !== void 0 ? { object: fact.object } : {},