@graphorin/memory 0.5.0

package/dist/consolidator/phases/standard.js

@@ -0,0 +1,499 @@
+import { withMemorySpan } from "../../internal/spans.js";
+import { reconcileToConflictDecision } from "../../conflict/types.js";
+import "../../conflict/index.js";
+import { applyNoiseFilters, renderText } from "../noise-filter.js";
+import { contextualizeWithLlm } from "../../internal/contextualize.js";
+import { newMemoryId } from "../../internal/id.js";
+import { preFilterCandidate, reconcileCandidate } from "../reconcile.js";
+
+//#region src/consolidator/phases/standard.ts
+/** Top-s nearest neighbours surfaced to the reconcile pre-filter + LLM. */
+const RECONCILE_TOP_K = 10;
+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.",
+	"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\": [] }."
+].join(" ");
+/**
+* Per-call output-token ceilings (MCON-14). `BudgetTracker.record()`
+* only runs AFTER `provider.generate` returns, so without a request cap
+* a degenerate model response could blow through the daily ceiling in a
+* single call before `pause` can take effect. All consolidator output
+* shapes are small and well-defined; the caps are deliberately roomy.
+*/
+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.",
+	"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.",
+	"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(" ");
+/**
+* Run the standard phase. Returns a {@link PhaseOutcome}; errors are
+* surfaced via `status: 'failed'` + `errorMessage` so the caller can
+* land the batch in the DLQ.
+*
+* @stable
+*/
+async function runStandardPhase(deps) {
+	return withMemorySpan(deps.tracer, "memory.consolidate.standard", deps.scope, {
+		"consolidator.phase": "standard",
+		"consolidator.tier": deps.tier,
+		"consolidator.cheap_model": deps.cheapModel ?? deps.provider.modelId
+	}, async (span) => {
+		const startedAt = (typeof deps.now === "function" ? deps.now : Date.now)();
+		const session = deps.store.session;
+		let rawBatch;
+		if (deps.batch !== void 0) rawBatch = deps.batch;
+		else {
+			if (typeof session.listMessagesSince !== "function") {
+				span.setAttributes({
+					"consolidator.standard.skipped": "no-cursor-support",
+					"consolidator.duration_ms": 0,
+					"consolidator.facts_extracted": 0,
+					"consolidator.budget_used_usd": 0
+				});
+				return emptyOutcome("completed");
+			}
+			rawBatch = await session.listMessagesSince(deps.scope, deps.lastProcessedMessageId, deps.maxBatchSize);
+		}
+		const filtered = applyNoiseFilters(rawBatch, deps.noiseFilters);
+		span.setAttributes({
+			"consolidator.standard.batch_size": rawBatch.length,
+			"consolidator.standard.kept_count": filtered.kept.length,
+			"consolidator.standard.noise_filtered": filtered.droppedCount
+		});
+		if (filtered.kept.length === 0) {
+			span.setAttributes({
+				"consolidator.duration_ms": Math.max(0, (typeof deps.now === "function" ? deps.now : Date.now)() - startedAt),
+				"consolidator.facts_extracted": 0,
+				"consolidator.budget_used_usd": 0
+			});
+			return {
+				...emptyOutcome("completed"),
+				noiseFilteredCount: filtered.droppedCount
+			};
+		}
+		const transcript = renderTranscript(filtered.kept);
+		const request = buildRequest(deps, transcript);
+		const response = await deps.provider.generate(request);
+		const usage = response.usage;
+		const cost = deps.priceUsage?.({
+			promptTokens: usage.promptTokens,
+			completionTokens: usage.completionTokens
+		}) ?? 0;
+		const facts = parseExtraction(response.text);
+		let factsCreated = 0;
+		let factsUpdated = 0;
+		let conflictsResolved = 0;
+		let reconcileTokens = 0;
+		let reconcileCost = 0;
+		let contextualTokens = 0;
+		let contextualCost = 0;
+		const extractionTokens = (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0) + (usage.reasoningTokens ?? 0);
+		deps.budget.record({
+			phase: "standard",
+			tokens: extractionTokens,
+			costUsd: cost
+		});
+		for (const fact of facts) {
+			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 decision;
+			let audited;
+			if (route.route === "reconcile" && !deps.budget.snapshot().paused) {
+				const result = await reconcileCandidate({
+					candidateText: fact.text,
+					neighbors: neighbors.map((h) => ({
+						id: h.record.id,
+						text: h.record.text,
+						...h.record.validFrom !== void 0 ? { validFrom: h.record.validFrom } : {}
+					})),
+					provider: deps.provider,
+					scope: deps.scope
+				});
+				decision = result.decision;
+				audited = reconcileToConflictDecision(decision);
+				reconcileTokens += result.usage.totalTokens;
+				const callCost = deps.priceUsage?.({
+					promptTokens: result.usage.promptTokens,
+					completionTokens: result.usage.completionTokens
+				}) ?? 0;
+				reconcileCost += callCost;
+				deps.budget.record({
+					phase: "standard",
+					tokens: result.usage.totalTokens,
+					costUsd: callCost
+				});
+			} else if (route.route === "reconcile") {
+				decision = {
+					action: "add",
+					reason: "reconcile-budget-paused"
+				};
+				audited = {
+					kind: "admit",
+					stage: "defer-to-deep",
+					reason: "reconcile-budget-paused"
+				};
+			} else if (route.route === "noop") {
+				decision = {
+					action: "noop",
+					targetId: route.targetId,
+					reason: route.reason
+				};
+				audited = {
+					kind: "dedup",
+					stage: route.reason === "exact-hash-match" ? "exact-dedup" : "embedding-three-zone",
+					existingId: route.targetId,
+					...route.similarity !== void 0 ? { similarity: route.similarity } : {},
+					reason: route.reason
+				};
+			} else {
+				decision = {
+					action: "add",
+					reason: route.reason
+				};
+				audited = {
+					kind: "admit",
+					stage: "embedding-three-zone",
+					reason: route.reason
+				};
+			}
+			let candidateId;
+			switch (decision.action) {
+				case "add": {
+					let indexText;
+					if (deps.contextualRetrieval === "llm" && !deps.budget.snapshot().paused) {
+						const ctx = await contextualizeWithLlm({
+							text: input.text,
+							...input.subject !== void 0 ? { subject: input.subject } : {},
+							...input.predicate !== void 0 ? { predicate: input.predicate } : {},
+							...input.object !== void 0 ? { object: input.object } : {}
+						}, deps.provider);
+						indexText = ctx.indexText;
+						const ctxTokens = (ctx.usage.promptTokens ?? 0) + (ctx.usage.completionTokens ?? 0) + (ctx.usage.reasoningTokens ?? 0);
+						const ctxCost = deps.priceUsage?.({
+							promptTokens: ctx.usage.promptTokens,
+							completionTokens: ctx.usage.completionTokens
+						}) ?? 0;
+						contextualTokens += ctxTokens;
+						contextualCost += ctxCost;
+						deps.budget.record({
+							phase: "standard",
+							tokens: ctxTokens,
+							costUsd: ctxCost
+						});
+					}
+					candidateId = (await deps.semantic.remember(deps.scope, input, {
+						pipeline: "off",
+						...indexText !== void 0 ? { indexText } : {},
+						...deps.autoPromoteExtraction ? { autoPromoteSynthesized: true } : {}
+					})).id;
+					factsCreated += 1;
+					break;
+				}
+				case "noop":
+					candidateId = newMemoryId("fact");
+					break;
+				case "update": {
+					const { new: stored } = await deps.semantic.supersede(deps.scope, decision.targetId, input, decision.reason);
+					candidateId = stored.id;
+					factsUpdated += 1;
+					break;
+				}
+				case "conflict": {
+					const { new: stored } = await deps.semantic.supersede(deps.scope, decision.targetId, input, decision.reason);
+					candidateId = stored.id;
+					factsUpdated += 1;
+					conflictsResolved += 1;
+					break;
+				}
+			}
+			await recordConflictDecision(deps.store, deps.scope, candidateId, audited);
+		}
+		let episodesFormed = 0;
+		let episodeTokens = 0;
+		let episodeCost = 0;
+		if (deps.formEpisodes && deps.episodic != null && filtered.kept.length > 0 && !deps.budget.snapshot().paused) {
+			const episodeRes = await deps.provider.generate(buildEpisodeRequest(deps, transcript, deps.importanceScoring));
+			const epUsage = episodeRes.usage;
+			episodeTokens = (epUsage.promptTokens ?? 0) + (epUsage.completionTokens ?? 0) + (epUsage.reasoningTokens ?? 0);
+			episodeCost = deps.priceUsage?.({
+				promptTokens: epUsage.promptTokens,
+				completionTokens: epUsage.completionTokens
+			}) ?? 0;
+			deps.budget.record({
+				phase: "standard",
+				tokens: episodeTokens,
+				costUsd: episodeCost
+			});
+			const parsed = parseEpisode(episodeRes.text);
+			if (parsed !== null && parsed.summary.trim().length > 0) {
+				const importance = deps.importanceScoring ? normalizeImportance(parsed.importance) : void 0;
+				const nowFallback = new Date((typeof deps.now === "function" ? deps.now : Date.now)()).toISOString();
+				const startedAt$1 = filtered.kept[0]?.createdAt ?? nowFallback;
+				const endedAt = filtered.kept[filtered.kept.length - 1]?.createdAt ?? startedAt$1;
+				await deps.episodic.record(deps.scope, {
+					summary: parsed.summary,
+					startedAt: startedAt$1,
+					endedAt,
+					...importance !== void 0 ? { importance } : {},
+					provenance: "extraction",
+					status: "quarantined"
+				});
+				episodesFormed = 1;
+			}
+		}
+		const totalTokens = extractionTokens + reconcileTokens + episodeTokens + contextualTokens;
+		const totalCost = cost + reconcileCost + episodeCost + contextualCost;
+		const snapshot = deps.budget.snapshot();
+		span.setAttributes({
+			"consolidator.duration_ms": Math.max(0, (typeof deps.now === "function" ? deps.now : Date.now)() - startedAt),
+			"consolidator.facts_extracted": factsCreated,
+			"consolidator.budget_used_usd": totalCost,
+			"consolidator.standard.facts_extracted": factsCreated,
+			"consolidator.standard.facts_updated": factsUpdated,
+			"consolidator.standard.conflicts_resolved": conflictsResolved,
+			"consolidator.standard.episodes_formed": episodesFormed,
+			"consolidator.standard.reconcile_tokens": reconcileTokens,
+			"consolidator.standard.episode_tokens": episodeTokens,
+			"consolidator.standard.contextual_tokens": contextualTokens,
+			"consolidator.standard.tokens.input": usage.promptTokens,
+			"consolidator.standard.tokens.output": usage.completionTokens,
+			"consolidator.standard.cost.estimate.usd": totalCost,
+			"consolidator.budget.remaining.tokens": snapshot.tokensRemaining,
+			"consolidator.budget.remaining.usd": snapshot.costRemaining,
+			"consolidator.exceeded": snapshot.paused
+		});
+		return {
+			phase: "standard",
+			status: "completed",
+			factsCreated,
+			factsUpdated,
+			conflictsResolved,
+			episodesFormed,
+			insightsCreated: 0,
+			noiseFilteredCount: filtered.droppedCount,
+			emptyExtractions: facts.length === 0 ? 1 : 0,
+			llmTokensUsed: totalTokens,
+			llmCostUsd: totalCost,
+			errorMessage: null
+		};
+	});
+}
+function buildRequest(deps, transcript) {
+	return {
+		messages: [{
+			role: "user",
+			content: `Conversation slice:\n${transcript}`
+		}],
+		systemMessage: EXTRACTION_SYSTEM_PROMPT,
+		temperature: 0,
+		maxTokens: EXTRACTION_MAX_TOKENS,
+		metadata: {
+			userId: deps.scope.userId,
+			...deps.scope.sessionId !== void 0 ? { sessionId: deps.scope.sessionId } : {},
+			...deps.scope.agentId !== void 0 ? { agentId: deps.scope.agentId } : {}
+		},
+		outputType: { kind: "structured" }
+	};
+}
+/**
+* Build the episode-summarization request (P1-2). Uses the same
+* transcript + structured-output seam as {@link buildRequest}; the
+* system prompt switches on `withImportance` so a poignancy score is
+* only requested when importance scoring is enabled.
+*/
+function buildEpisodeRequest(deps, transcript, withImportance) {
+	return {
+		messages: [{
+			role: "user",
+			content: `Conversation slice:\n${transcript}`
+		}],
+		systemMessage: withImportance ? EPISODE_SUMMARY_IMPORTANCE_SYSTEM_PROMPT : EPISODE_SUMMARY_SYSTEM_PROMPT,
+		temperature: 0,
+		maxTokens: EPISODE_MAX_TOKENS,
+		metadata: {
+			userId: deps.scope.userId,
+			...deps.scope.sessionId !== void 0 ? { sessionId: deps.scope.sessionId } : {},
+			...deps.scope.agentId !== void 0 ? { agentId: deps.scope.agentId } : {}
+		},
+		outputType: { kind: "structured" }
+	};
+}
+function renderTranscript(messages) {
+	return messages.map((m) => {
+		const role = m.message.role;
+		const text = renderText(m.message);
+		return `[${m.sequence}] ${role}: ${text}`;
+	}).join("\n");
+}
+/**
+* Parse the model output into the structured fact list. Tolerates
+* fenced blocks + trailing commentary so a chatty model does not
+* wedge the cursor.
+*
+* @internal
+*/
+function parseExtraction(text) {
+	if (text === void 0 || text.length === 0) return [];
+	const candidate = stripFence(text).trim();
+	if (candidate.length === 0) return [];
+	let parsed;
+	try {
+		parsed = JSON.parse(candidate);
+	} catch {
+		const slice = sliceJsonObject(candidate);
+		if (slice === null) return [];
+		try {
+			parsed = JSON.parse(slice);
+		} catch {
+			return [];
+		}
+	}
+	if (parsed === null || typeof parsed !== "object") return [];
+	const root = parsed;
+	const facts = Array.isArray(root.facts) ? root.facts : Array.isArray(parsed) ? parsed : [];
+	const out = [];
+	for (const item of facts) {
+		if (item === null || typeof item !== "object") continue;
+		const obj = item;
+		const text$1 = typeof obj.text === "string" ? obj.text : null;
+		if (text$1 === null || text$1.trim().length === 0) continue;
+		const fact = {
+			text: text$1,
+			...typeof obj.subject === "string" ? { subject: obj.subject } : {},
+			...typeof obj.predicate === "string" ? { predicate: obj.predicate } : {},
+			...typeof obj.object === "string" ? { object: obj.object } : {},
+			...typeof obj.confidence === "number" ? { confidence: obj.confidence } : {},
+			...typeof obj.importance === "number" ? { importance: obj.importance } : {}
+		};
+		out.push(fact);
+	}
+	return out;
+}
+/**
+* Parse the episode-summary model output into `{ summary, importance? }`
+* (P1-2). Tolerates fenced blocks + an optional `{ episode: {...} }`
+* wrapper; returns `null` when no usable `summary` string is present
+* (so an extraction-shaped `{ facts: [...] }` payload is rejected, not
+* mistaken for an episode).
+*
+* @internal
+*/
+function parseEpisode(text) {
+	if (text === void 0 || text.length === 0) return null;
+	const candidate = stripFence(text).trim();
+	if (candidate.length === 0) return null;
+	let parsed;
+	try {
+		parsed = JSON.parse(candidate);
+	} catch {
+		const slice = sliceJsonObject(candidate);
+		if (slice === null) return null;
+		try {
+			parsed = JSON.parse(slice);
+		} catch {
+			return null;
+		}
+	}
+	if (parsed === null || typeof parsed !== "object") return null;
+	const root = parsed;
+	const inner = typeof root.summary === "string" ? root : root.episode !== null && typeof root.episode === "object" ? root.episode : root;
+	const summary = typeof inner.summary === "string" ? inner.summary : null;
+	if (summary === null || summary.trim().length === 0) return null;
+	return {
+		summary,
+		...typeof inner.importance === "number" ? { importance: inner.importance } : {}
+	};
+}
+/**
+* Normalize a raw `[1, 10]` poignancy score into the episodic
+* `importance` field's `[0, 1]` range (P1-2). Out-of-range values are
+* clamped to `[1, 10]` first (so `15 → 1.0`, `0 → 0.1`); non-finite /
+* missing scores return `undefined` so the episode is recorded without
+* an importance signal rather than a bogus one.
+*
+* @internal
+*/
+function normalizeImportance(raw) {
+	if (typeof raw !== "number" || !Number.isFinite(raw)) return void 0;
+	return Math.min(10, Math.max(1, raw)) / 10;
+}
+function stripFence(text) {
+	return /^```[^\n]*\n([\s\S]*?)\n```/u.exec(text.trim())?.[1] ?? text;
+}
+function sliceJsonObject(text) {
+	const start = text.indexOf("{");
+	const end = text.lastIndexOf("}");
+	if (start < 0 || end < start) return null;
+	return text.slice(start, end + 1);
+}
+/**
+* Build the {@link FactInput} for an extracted candidate. P1-4:
+* distilled-from-transcript facts are synthesized memory — tagged
+* `extraction` so they land quarantined (excluded from action-driving
+* recall until validated).
+*/
+function buildFactInput(fact) {
+	const importance = normalizeImportance(fact.importance);
+	return {
+		text: fact.text,
+		provenance: "extraction",
+		...fact.subject !== void 0 ? { subject: fact.subject } : {},
+		...fact.predicate !== void 0 ? { predicate: fact.predicate } : {},
+		...fact.object !== void 0 ? { object: fact.object } : {},
+		...fact.confidence !== void 0 ? { confidence: fact.confidence } : {},
+		...importance !== void 0 ? { importance } : {}
+	};
+}
+/**
+* Record a reconcile / pre-filter decision into `fact_conflicts` so every
+* write-path decision stays auditable (P0-3). Best-effort: a storage
+* adapter without the conflict surface simply skips it.
+*/
+async function recordConflictDecision(store, scope, candidateId, decision) {
+	const conflicts = store.conflicts;
+	if (conflicts === void 0) return;
+	await conflicts.recordDecision({
+		scope,
+		candidateId,
+		decision: decision.kind,
+		stage: decision.stage,
+		...decision.kind === "dedup" || decision.kind === "supersede" ? { existingId: decision.existingId } : {},
+		...decision.kind === "dedup" && decision.similarity !== void 0 ? { similarity: decision.similarity } : {},
+		...decision.reason !== void 0 ? { reason: decision.reason } : {},
+		detectedBy: "reconcile"
+	});
+}
+function emptyOutcome(status) {
+	return {
+		phase: "standard",
+		status,
+		factsCreated: 0,
+		factsUpdated: 0,
+		conflictsResolved: 0,
+		episodesFormed: 0,
+		insightsCreated: 0,
+		noiseFilteredCount: 0,
+		emptyExtractions: 0,
+		llmTokensUsed: 0,
+		llmCostUsd: null,
+		errorMessage: null
+	};
+}
+
+//#endregion
+export { parseExtraction, runStandardPhase };
+//# sourceMappingURL=standard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"standard.js","names":["rawBatch: ReadonlyArray<SessionMessageRecord>","decision: ReconcileDecision","audited: ConflictDecision","candidateId: string","indexText: string | undefined","startedAt","parsed: unknown","out: ExtractedFact[]","text","fact: ExtractedFact"],"sources":["../../../src/consolidator/phases/standard.ts"],"sourcesContent":["/**\n * Standard phase — extracts new facts from session messages via the\n * configured cheap-tier provider. The phase is gated by the active\n * tier (DEC-144 / ADR-038) and the budget tracker; it never runs\n * under `tier: 'free'`.\n *\n * The extraction prompt asks the model to return a JSON array of\n * `{ text, subject?, predicate?, object?, confidence? }` objects;\n * malformed responses are tolerated (counted as `emptyExtractions`)\n * so a flaky cheap model never wedges the pipeline.\n *\n * @packageDocumentation\n */\n\nimport type { Provider, ProviderRequest, SessionScope, Tracer } from '@graphorin/core';\nimport {\n  type ConflictDecision,\n  type ReconcileDecision,\n  reconcileToConflictDecision,\n} from '../../conflict/index.js';\nimport {\n  type ContextualRetrievalMode,\n  contextualizeWithLlm,\n} from '../../internal/contextualize.js';\nimport { newMemoryId } from '../../internal/id.js';\nimport { withMemorySpan } from '../../internal/spans.js';\nimport type {\n  ConsolidatorMemoryStoreExt,\n  MemoryStoreAdapter,\n  SessionMessageRecord,\n} from '../../internal/storage-adapter.js';\nimport type { EpisodicMemory } from '../../tiers/episodic-memory.js';\nimport type { FactInput, SemanticMemory } from '../../tiers/semantic-memory.js';\nimport type { BudgetTracker } from '../budget.js';\nimport { applyNoiseFilters, type NoiseFilterPreset, renderText } from '../noise-filter.js';\nimport { preFilterCandidate, reconcileCandidate } from '../reconcile.js';\nimport type { PhaseOutcome } from '../types.js';\n\n/** Top-s nearest neighbours surfaced to the reconcile pre-filter + LLM. */\nconst RECONCILE_TOP_K = 10;\n\n/** Inputs accepted by {@link runStandardPhase}. */\nexport interface StandardPhaseDeps {\n  readonly semantic: SemanticMemory;\n  /**\n   * Episodic tier used for auto-episode-formation (P1-2). Omitted /\n   * `null` ⇒ episode formation is skipped regardless of `formEpisodes`.\n   */\n  readonly episodic?: EpisodicMemory | null;\n  /** Auto-form a quarantined episode per processed slice (P1-2). */\n  readonly formEpisodes: boolean;\n  /** Ask the episode summary call for a `[1, 10]` importance score (P1-2). */\n  readonly importanceScoring: boolean;\n  /**\n   * Auto-promotion policy (MCON-2). When `true`, an injection-clean extraction\n   * fact is admitted `active` instead of quarantined. Injection-flagged facts\n   * always stay quarantined. Off by default.\n   */\n  readonly autoPromoteExtraction: boolean;\n  /**\n   * Contextual-retrieval mode for additive fact writes (P1-3). `'llm'`\n   * spends one budgeted cheap-model call per `add` to author a situating\n   * prefix; `'late-chunk'` / `'off'` defer to the shared\n   * {@link SemanticMemory} instance (no extra call here).\n   */\n  readonly contextualRetrieval: ContextualRetrievalMode;\n  readonly store: MemoryStoreAdapter;\n  readonly consolidatorStore: ConsolidatorMemoryStoreExt | null;\n  readonly provider: Provider;\n  readonly tracer: Tracer;\n  readonly scope: SessionScope;\n  readonly cheapModel: string | null;\n  readonly noiseFilters: ReadonlyArray<NoiseFilterPreset>;\n  readonly maxBatchSize: number;\n  readonly lastProcessedMessageId: string | null;\n  readonly budget: BudgetTracker;\n  /** Computes USD cost for the recorded usage. Defaults to 0 when omitted. */\n  readonly priceUsage?: (usage: { promptTokens: number; completionTokens: number }) => number;\n  readonly tier: 'cheap' | 'standard' | 'full' | 'custom';\n  /** Override the wall clock — used by tests + the runtime clock seam. */\n  readonly now?: () => number;\n  /**\n   * Pre-fetched message batch — when supplied, the phase skips its\n   * own `listMessagesSince(...)` call and operates on the supplied\n   * rows. The runtime always pre-fetches the batch so the cursor\n   * advance can use the same data the phase processed.\n   */\n  readonly batch?: ReadonlyArray<SessionMessageRecord>;\n}\n\ninterface ExtractedFact {\n  readonly text: string;\n  readonly subject?: string;\n  readonly predicate?: string;\n  readonly object?: string;\n  readonly confidence?: number;\n  /** Raw `[1, 10]` importance as returned by the model, pre-normalization (MCON-12). */\n  readonly importance?: number;\n}\n\n/** Parsed episode-summary payload (P1-2). */\ninterface ExtractedEpisode {\n  readonly summary: string;\n  /** Raw `[1, 10]` importance as returned by the model, pre-normalization. */\n  readonly importance?: number;\n}\n\nconst EXTRACTION_SYSTEM_PROMPT = [\n  'You are a memory-extraction assistant for a long-running personal-assistant runtime.',\n  'Read the supplied conversation slice and return the durable facts it asserts about the user, the world, or stable preferences.',\n  'Skip greetings, banter, transient state, and anything the assistant produced as boilerplate.',\n  '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).',\n  'Return a single JSON object: { \"facts\": [{ \"text\": string, \"subject\"?: string, \"predicate\"?: string, \"object\"?: string, \"confidence\"?: number, \"importance\"?: number }] }.',\n  'If the slice contains no durable facts, return { \"facts\": [] }.',\n].join(' ');\n\n/**\n * Per-call output-token ceilings (MCON-14). `BudgetTracker.record()`\n * only runs AFTER `provider.generate` returns, so without a request cap\n * a degenerate model response could blow through the daily ceiling in a\n * single call before `pause` can take effect. All consolidator output\n * shapes are small and well-defined; the caps are deliberately roomy.\n */\nconst EXTRACTION_MAX_TOKENS = 1024;\nconst EPISODE_MAX_TOKENS = 512;\n\nconst EPISODE_SUMMARY_SYSTEM_PROMPT = [\n  'You are an episode-summarization assistant for a long-running personal-assistant runtime.',\n  'Read the supplied conversation slice and write one concise third-person summary of what happened — the episode.',\n  'Return a single JSON object: { \"summary\": string }.',\n].join(' ');\n\nconst EPISODE_SUMMARY_IMPORTANCE_SYSTEM_PROMPT = [\n  'You are an episode-summarization assistant for a long-running personal-assistant runtime.',\n  'Read the supplied conversation slice and write one concise third-person summary of what happened — the episode.',\n  'Also rate how important / poignant this episode is for remembering the user, on an integer scale from 1 (mundane) to 10 (deeply significant).',\n  'Return a single JSON object: { \"summary\": string, \"importance\": number }.',\n].join(' ');\n\n/**\n * Run the standard phase. Returns a {@link PhaseOutcome}; errors are\n * surfaced via `status: 'failed'` + `errorMessage` so the caller can\n * land the batch in the DLQ.\n *\n * @stable\n */\nexport async function runStandardPhase(deps: StandardPhaseDeps): Promise<PhaseOutcome> {\n  return withMemorySpan(\n    deps.tracer,\n    'memory.consolidate.standard',\n    deps.scope,\n    {\n      'consolidator.phase': 'standard',\n      'consolidator.tier': deps.tier,\n      'consolidator.cheap_model': deps.cheapModel ?? deps.provider.modelId,\n    },\n    async (span) => {\n      const startedAt = (typeof deps.now === 'function' ? deps.now : Date.now)();\n      const session = deps.store.session;\n      let rawBatch: ReadonlyArray<SessionMessageRecord>;\n      if (deps.batch !== undefined) {\n        rawBatch = deps.batch;\n      } else {\n        if (typeof session.listMessagesSince !== 'function') {\n          span.setAttributes({\n            'consolidator.standard.skipped': 'no-cursor-support',\n            'consolidator.duration_ms': 0,\n            'consolidator.facts_extracted': 0,\n            'consolidator.budget_used_usd': 0,\n          });\n          return emptyOutcome('completed');\n        }\n        rawBatch = await session.listMessagesSince(\n          deps.scope,\n          deps.lastProcessedMessageId,\n          deps.maxBatchSize,\n        );\n      }\n      const filtered = applyNoiseFilters(\n        rawBatch as ReadonlyArray<SessionMessageRecord>,\n        deps.noiseFilters,\n      );\n      span.setAttributes({\n        'consolidator.standard.batch_size': rawBatch.length,\n        'consolidator.standard.kept_count': filtered.kept.length,\n        'consolidator.standard.noise_filtered': filtered.droppedCount,\n      });\n      if (filtered.kept.length === 0) {\n        span.setAttributes({\n          'consolidator.duration_ms': Math.max(\n            0,\n            (typeof deps.now === 'function' ? deps.now : Date.now)() - startedAt,\n          ),\n          'consolidator.facts_extracted': 0,\n          'consolidator.budget_used_usd': 0,\n        });\n        return {\n          ...emptyOutcome('completed'),\n          noiseFilteredCount: filtered.droppedCount,\n        };\n      }\n\n      const transcript = renderTranscript(filtered.kept);\n      const request = buildRequest(deps, transcript);\n      const response = await deps.provider.generate(request);\n      const usage = response.usage;\n      const cost =\n        deps.priceUsage?.({\n          promptTokens: usage.promptTokens,\n          completionTokens: usage.completionTokens,\n        }) ?? 0;\n\n      const facts = parseExtraction(response.text);\n      let factsCreated = 0;\n      let factsUpdated = 0;\n      let conflictsResolved = 0;\n      let reconcileTokens = 0;\n      let reconcileCost = 0;\n      let contextualTokens = 0;\n      let contextualCost = 0;\n      const extractionTokens =\n        (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0) + (usage.reasoningTokens ?? 0);\n      deps.budget.record({ phase: 'standard', tokens: extractionTokens, costUsd: cost });\n\n      for (const fact of facts) {\n        if (fact.text.trim().length === 0) continue;\n        const input = buildFactInput(fact);\n\n        // Neighbour-aware reconciliation (P0-3). A cheap, LLM-free pre-filter\n        // (Stage 1 exact-dedup + Stage 2 embedding zones) classifies the\n        // candidate against its nearest neighbours; only the ambiguous\n        // CONFLICT-CHECK mid-zone spends a reconcile LLM call. With no\n        // embedder configured `neighbors` is empty → every candidate is a\n        // fresh `add`, preserving the pre-reconcile behaviour.\n        const neighbors = await deps.semantic.neighbors(deps.scope, fact.text, {\n          topK: RECONCILE_TOP_K,\n        });\n        const route = await preFilterCandidate(fact.text, neighbors);\n\n        let decision: ReconcileDecision;\n        let audited: ConflictDecision;\n        if (route.route === 'reconcile' && !deps.budget.snapshot().paused) {\n          const result = await reconcileCandidate({\n            candidateText: fact.text,\n            neighbors: neighbors.map((h) => ({\n              id: h.record.id,\n              text: h.record.text,\n              ...(h.record.validFrom !== undefined ? { validFrom: h.record.validFrom } : {}),\n            })),\n            provider: deps.provider,\n            scope: deps.scope,\n          });\n          decision = result.decision;\n          audited = reconcileToConflictDecision(decision);\n          reconcileTokens += result.usage.totalTokens;\n          const callCost =\n            deps.priceUsage?.({\n              promptTokens: result.usage.promptTokens,\n              completionTokens: result.usage.completionTokens,\n            }) ?? 0;\n          reconcileCost += callCost;\n          deps.budget.record({\n            phase: 'standard',\n            tokens: result.usage.totalTokens,\n            costUsd: callCost,\n          });\n        } else if (route.route === 'reconcile') {\n          // Mid-zone but the budget is exhausted — fall back to a safe\n          // additive write rather than spending an over-budget LLM call.\n          decision = { action: 'add', reason: 'reconcile-budget-paused' };\n          audited = { kind: 'admit', stage: 'defer-to-deep', reason: 'reconcile-budget-paused' };\n        } else if (route.route === 'noop') {\n          decision = { action: 'noop', targetId: route.targetId, reason: route.reason };\n          audited = {\n            kind: 'dedup',\n            stage: route.reason === 'exact-hash-match' ? 'exact-dedup' : 'embedding-three-zone',\n            existingId: route.targetId,\n            ...(route.similarity !== undefined ? { similarity: route.similarity } : {}),\n            reason: route.reason,\n          };\n        } else {\n          decision = { action: 'add', reason: route.reason };\n          audited = { kind: 'admit', stage: 'embedding-three-zone', reason: route.reason };\n        }\n\n        // Apply the decision. Updates / conflicts route through the\n        // bi-temporal supersede (close the old interval, insert the new) —\n        // never a destructive delete (P0-3).\n        let candidateId: string;\n        switch (decision.action) {\n          case 'add': {\n            // Contextual retrieval (P1-3). In `'llm'` mode (and only when\n            // the budget is not exhausted) spend one cheap-model call to\n            // author a situating prefix and pass it as the write's index\n            // text; the helper degrades to the deterministic late-chunk\n            // prefix on any failure. `'late-chunk'` / `'off'` add nothing\n            // here — the shared SemanticMemory instance contextualizes the\n            // write. This LLM call is the only contextualization that\n            // touches a provider, keeping `'llm'` strictly consolidator-only.\n            let indexText: string | undefined;\n            if (deps.contextualRetrieval === 'llm' && !deps.budget.snapshot().paused) {\n              const ctx = await contextualizeWithLlm(\n                {\n                  text: input.text,\n                  ...(input.subject !== undefined ? { subject: input.subject } : {}),\n                  ...(input.predicate !== undefined ? { predicate: input.predicate } : {}),\n                  ...(input.object !== undefined ? { object: input.object } : {}),\n                },\n                deps.provider,\n              );\n              indexText = ctx.indexText;\n              const ctxTokens =\n                (ctx.usage.promptTokens ?? 0) +\n                (ctx.usage.completionTokens ?? 0) +\n                (ctx.usage.reasoningTokens ?? 0);\n              const ctxCost =\n                deps.priceUsage?.({\n                  promptTokens: ctx.usage.promptTokens,\n                  completionTokens: ctx.usage.completionTokens,\n                }) ?? 0;\n              contextualTokens += ctxTokens;\n              contextualCost += ctxCost;\n              deps.budget.record({ phase: 'standard', tokens: ctxTokens, costUsd: ctxCost });\n            }\n            // `pipeline: 'off'` — the standard phase has already made the\n            // conflict decision; a second inline pass would re-search +\n            // double-audit.\n            const stored = await deps.semantic.remember(deps.scope, input, {\n              pipeline: 'off',\n              ...(indexText !== undefined ? { indexText } : {}),\n              ...(deps.autoPromoteExtraction ? { autoPromoteSynthesized: true } : {}),\n            });\n            candidateId = stored.id;\n            factsCreated += 1;\n            break;\n          }\n          case 'noop': {\n            // Duplicate of `targetId` — record the dedup, write nothing.\n            candidateId = newMemoryId('fact');\n            break;\n          }\n          case 'update': {\n            const { new: stored } = await deps.semantic.supersede(\n              deps.scope,\n              decision.targetId,\n              input,\n              decision.reason,\n            );\n            candidateId = stored.id;\n            factsUpdated += 1;\n            break;\n          }\n          case 'conflict': {\n            const { new: stored } = await deps.semantic.supersede(\n              deps.scope,\n              decision.targetId,\n              input,\n              decision.reason,\n            );\n            candidateId = stored.id;\n            factsUpdated += 1;\n            conflictsResolved += 1;\n            break;\n          }\n        }\n\n        // Every decision is auditable in `fact_conflicts` (best-effort —\n        // a store without the conflict surface simply skips it).\n        await recordConflictDecision(deps.store, deps.scope, candidateId, audited);\n      }\n\n      // Episode formation (P1-2). Summarize the processed slice into one\n      // quarantined episode carrying an LLM importance score, so the\n      // episodic triple-signal ranking (recency × relevance × importance)\n      // runs on all three signals. Budget-gated + provenance-tagged\n      // (P1-4): skipped when `formEpisodes` is off, no episodic tier is\n      // wired, or the budget is exhausted — the slice still advanced the\n      // cursor, so the phase degrades to fact-only behaviour.\n      let episodesFormed = 0;\n      let episodeTokens = 0;\n      let episodeCost = 0;\n      if (\n        deps.formEpisodes &&\n        deps.episodic != null &&\n        filtered.kept.length > 0 &&\n        !deps.budget.snapshot().paused\n      ) {\n        const episodeRes = await deps.provider.generate(\n          buildEpisodeRequest(deps, transcript, deps.importanceScoring),\n        );\n        const epUsage = episodeRes.usage;\n        episodeTokens =\n          (epUsage.promptTokens ?? 0) +\n          (epUsage.completionTokens ?? 0) +\n          (epUsage.reasoningTokens ?? 0);\n        episodeCost =\n          deps.priceUsage?.({\n            promptTokens: epUsage.promptTokens,\n            completionTokens: epUsage.completionTokens,\n          }) ?? 0;\n        deps.budget.record({ phase: 'standard', tokens: episodeTokens, costUsd: episodeCost });\n\n        const parsed = parseEpisode(episodeRes.text);\n        if (parsed !== null && parsed.summary.trim().length > 0) {\n          const importance = deps.importanceScoring\n            ? normalizeImportance(parsed.importance)\n            : undefined;\n          const nowFallback = new Date(\n            (typeof deps.now === 'function' ? deps.now : Date.now)(),\n          ).toISOString();\n          const startedAt = filtered.kept[0]?.createdAt ?? nowFallback;\n          const endedAt = filtered.kept[filtered.kept.length - 1]?.createdAt ?? startedAt;\n          await deps.episodic.record(deps.scope, {\n            summary: parsed.summary,\n            startedAt,\n            endedAt,\n            ...(importance !== undefined ? { importance } : {}),\n            provenance: 'extraction',\n            status: 'quarantined',\n          });\n          episodesFormed = 1;\n        }\n      }\n\n      const totalTokens = extractionTokens + reconcileTokens + episodeTokens + contextualTokens;\n      const totalCost = cost + reconcileCost + episodeCost + contextualCost;\n      const snapshot = deps.budget.snapshot();\n\n      span.setAttributes({\n        'consolidator.duration_ms': Math.max(\n          0,\n          (typeof deps.now === 'function' ? deps.now : Date.now)() - startedAt,\n        ),\n        'consolidator.facts_extracted': factsCreated,\n        'consolidator.budget_used_usd': totalCost,\n        'consolidator.standard.facts_extracted': factsCreated,\n        'consolidator.standard.facts_updated': factsUpdated,\n        'consolidator.standard.conflicts_resolved': conflictsResolved,\n        'consolidator.standard.episodes_formed': episodesFormed,\n        'consolidator.standard.reconcile_tokens': reconcileTokens,\n        'consolidator.standard.episode_tokens': episodeTokens,\n        'consolidator.standard.contextual_tokens': contextualTokens,\n        'consolidator.standard.tokens.input': usage.promptTokens,\n        'consolidator.standard.tokens.output': usage.completionTokens,\n        'consolidator.standard.cost.estimate.usd': totalCost,\n        'consolidator.budget.remaining.tokens': snapshot.tokensRemaining,\n        'consolidator.budget.remaining.usd': snapshot.costRemaining,\n        'consolidator.exceeded': snapshot.paused,\n      });\n\n      return {\n        phase: 'standard',\n        status: 'completed',\n        factsCreated,\n        factsUpdated,\n        conflictsResolved,\n        episodesFormed,\n        insightsCreated: 0,\n        noiseFilteredCount: filtered.droppedCount,\n        emptyExtractions: facts.length === 0 ? 1 : 0,\n        llmTokensUsed: totalTokens,\n        llmCostUsd: totalCost,\n        errorMessage: null,\n      };\n    },\n  );\n}\n\nfunction buildRequest(deps: StandardPhaseDeps, transcript: string): ProviderRequest {\n  return {\n    messages: [\n      {\n        role: 'user',\n        content: `Conversation slice:\\n${transcript}`,\n      },\n    ],\n    systemMessage: EXTRACTION_SYSTEM_PROMPT,\n    temperature: 0,\n    maxTokens: EXTRACTION_MAX_TOKENS,\n    metadata: {\n      userId: deps.scope.userId,\n      ...(deps.scope.sessionId !== undefined ? { sessionId: deps.scope.sessionId } : {}),\n      ...(deps.scope.agentId !== undefined ? { agentId: deps.scope.agentId } : {}),\n    },\n    outputType: { kind: 'structured' },\n  };\n}\n\n/**\n * Build the episode-summarization request (P1-2). Uses the same\n * transcript + structured-output seam as {@link buildRequest}; the\n * system prompt switches on `withImportance` so a poignancy score is\n * only requested when importance scoring is enabled.\n */\nfunction buildEpisodeRequest(\n  deps: StandardPhaseDeps,\n  transcript: string,\n  withImportance: boolean,\n): ProviderRequest {\n  return {\n    messages: [\n      {\n        role: 'user',\n        content: `Conversation slice:\\n${transcript}`,\n      },\n    ],\n    systemMessage: withImportance\n      ? EPISODE_SUMMARY_IMPORTANCE_SYSTEM_PROMPT\n      : EPISODE_SUMMARY_SYSTEM_PROMPT,\n    temperature: 0,\n    maxTokens: EPISODE_MAX_TOKENS,\n    metadata: {\n      userId: deps.scope.userId,\n      ...(deps.scope.sessionId !== undefined ? { sessionId: deps.scope.sessionId } : {}),\n      ...(deps.scope.agentId !== undefined ? { agentId: deps.scope.agentId } : {}),\n    },\n    outputType: { kind: 'structured' },\n  };\n}\n\nfunction renderTranscript(messages: ReadonlyArray<SessionMessageRecord>): string {\n  return messages\n    .map((m) => {\n      const role = m.message.role;\n      const text = renderText(m.message);\n      return `[${m.sequence}] ${role}: ${text}`;\n    })\n    .join('\\n');\n}\n\n/**\n * Parse the model output into the structured fact list. Tolerates\n * fenced blocks + trailing commentary so a chatty model does not\n * wedge the cursor.\n *\n * @internal\n */\nexport function parseExtraction(text: string | undefined): ReadonlyArray<ExtractedFact> {\n  if (text === undefined || text.length === 0) return [];\n  const candidate = stripFence(text).trim();\n  if (candidate.length === 0) return [];\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(candidate);\n  } catch {\n    const slice = sliceJsonObject(candidate);\n    if (slice === null) return [];\n    try {\n      parsed = JSON.parse(slice);\n    } catch {\n      return [];\n    }\n  }\n  if (parsed === null || typeof parsed !== 'object') return [];\n  const root = parsed as { facts?: unknown };\n  const facts = Array.isArray(root.facts) ? root.facts : Array.isArray(parsed) ? parsed : [];\n  const out: ExtractedFact[] = [];\n  for (const item of facts) {\n    if (item === null || typeof item !== 'object') continue;\n    const obj = item as Record<string, unknown>;\n    const text = typeof obj.text === 'string' ? obj.text : null;\n    if (text === null || text.trim().length === 0) continue;\n    const fact: ExtractedFact = {\n      text,\n      ...(typeof obj.subject === 'string' ? { subject: obj.subject } : {}),\n      ...(typeof obj.predicate === 'string' ? { predicate: obj.predicate } : {}),\n      ...(typeof obj.object === 'string' ? { object: obj.object } : {}),\n      ...(typeof obj.confidence === 'number' ? { confidence: obj.confidence } : {}),\n      ...(typeof obj.importance === 'number' ? { importance: obj.importance } : {}),\n    };\n    out.push(fact);\n  }\n  return out;\n}\n\n/**\n * Parse the episode-summary model output into `{ summary, importance? }`\n * (P1-2). Tolerates fenced blocks + an optional `{ episode: {...} }`\n * wrapper; returns `null` when no usable `summary` string is present\n * (so an extraction-shaped `{ facts: [...] }` payload is rejected, not\n * mistaken for an episode).\n *\n * @internal\n */\nexport function parseEpisode(text: string | undefined): ExtractedEpisode | null {\n  if (text === undefined || text.length === 0) return null;\n  const candidate = stripFence(text).trim();\n  if (candidate.length === 0) return null;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(candidate);\n  } catch {\n    const slice = sliceJsonObject(candidate);\n    if (slice === null) return null;\n    try {\n      parsed = JSON.parse(slice);\n    } catch {\n      return null;\n    }\n  }\n  if (parsed === null || typeof parsed !== 'object') return null;\n  const root = parsed as Record<string, unknown>;\n  const inner =\n    typeof root.summary === 'string'\n      ? root\n      : root.episode !== null && typeof root.episode === 'object'\n        ? (root.episode as Record<string, unknown>)\n        : root;\n  const summary = typeof inner.summary === 'string' ? inner.summary : null;\n  if (summary === null || summary.trim().length === 0) return null;\n  return {\n    summary,\n    ...(typeof inner.importance === 'number' ? { importance: inner.importance } : {}),\n  };\n}\n\n/**\n * Normalize a raw `[1, 10]` poignancy score into the episodic\n * `importance` field's `[0, 1]` range (P1-2). Out-of-range values are\n * clamped to `[1, 10]` first (so `15 → 1.0`, `0 → 0.1`); non-finite /\n * missing scores return `undefined` so the episode is recorded without\n * an importance signal rather than a bogus one.\n *\n * @internal\n */\nexport function normalizeImportance(raw: number | undefined): number | undefined {\n  if (typeof raw !== 'number' || !Number.isFinite(raw)) return undefined;\n  const clamped = Math.min(10, Math.max(1, raw));\n  return clamped / 10;\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 sliceJsonObject(text: string): string | null {\n  const start = text.indexOf('{');\n  const end = text.lastIndexOf('}');\n  if (start < 0 || end < start) return null;\n  return text.slice(start, end + 1);\n}\n\n/**\n * Build the {@link FactInput} for an extracted candidate. P1-4:\n * distilled-from-transcript facts are synthesized memory — tagged\n * `extraction` so they land quarantined (excluded from action-driving\n * recall until validated).\n */\nfunction buildFactInput(fact: ExtractedFact): FactInput {\n  // MCON-12: normalize the model's raw [1, 10] importance into the\n  // [0.1, 1.0] store scale (same contract as episodes); non-finite raw\n  // scores drop the signal rather than fabricating one.\n  const importance = normalizeImportance(fact.importance);\n  return {\n    text: fact.text,\n    provenance: 'extraction',\n    ...(fact.subject !== undefined ? { subject: fact.subject } : {}),\n    ...(fact.predicate !== undefined ? { predicate: fact.predicate } : {}),\n    ...(fact.object !== undefined ? { object: fact.object } : {}),\n    ...(fact.confidence !== undefined ? { confidence: fact.confidence } : {}),\n    ...(importance !== undefined ? { importance } : {}),\n  };\n}\n\n/**\n * Record a reconcile / pre-filter decision into `fact_conflicts` so every\n * write-path decision stays auditable (P0-3). Best-effort: a storage\n * adapter without the conflict surface simply skips it.\n */\nasync function recordConflictDecision(\n  store: MemoryStoreAdapter,\n  scope: SessionScope,\n  candidateId: string,\n  decision: ConflictDecision,\n): Promise<void> {\n  const conflicts = store.conflicts;\n  if (conflicts === undefined) return;\n  await conflicts.recordDecision({\n    scope,\n    candidateId,\n    decision: decision.kind,\n    stage: decision.stage,\n    ...(decision.kind === 'dedup' || decision.kind === 'supersede'\n      ? { existingId: decision.existingId }\n      : {}),\n    ...(decision.kind === 'dedup' && decision.similarity !== undefined\n      ? { similarity: decision.similarity }\n      : {}),\n    ...(decision.reason !== undefined ? { reason: decision.reason } : {}),\n    detectedBy: 'reconcile',\n  });\n}\n\nfunction emptyOutcome(status: PhaseOutcome['status']): PhaseOutcome {\n  return {\n    phase: 'standard',\n    status,\n    factsCreated: 0,\n    factsUpdated: 0,\n    conflictsResolved: 0,\n    episodesFormed: 0,\n    insightsCreated: 0,\n    noiseFilteredCount: 0,\n    emptyExtractions: 0,\n    llmTokensUsed: 0,\n    llmCostUsd: null,\n    errorMessage: null,\n  };\n}\n"],"mappings":"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"}