@agimon-ai/po-autocompact 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/extensions/server.mjs

@@ -1,13 +1,14 @@
-import { S as STATE_CUSTOM_TYPE, _ as withCanonicalFileSections, a as createInitialState, b as RESUME_MESSAGE_TYPE, c as fileDetailsFromUnknown, d as latestCheckpointArtifactEntry, f as mergeFileDetails, h as projectContextMessages, i as contextDetailsFromUnknown, l as fileOperationsFromMessages, m as parseState, n as checkpointRequestDetails, o as createRequestId, p as parseCheckpointDecision, r as checkpointSummaryFromEntry, s as effectiveThresholds, t as baselineUsageIsSettled, u as isStructuredCheckpoint, v as CHECKPOINT_MESSAGE_TYPE, x as RUNTIME_STATE_MESSAGE_TYPE, y as CONTEXT_MESSAGE_TYPE } from "../compactionPolicy-CDCYTj2b.mjs";
-import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
-import { composeRootHooks, defineHook, defineRoot } from "@agimon-ai/po-core/extensionFile";
-import { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, requireDoomContextContributions } from "@agimon-ai/po-core/contextContributions";
-import { DOOM_UI_HUB_SERVICE, requireDoomUiHub } from "@agimon-ai/po-core/uiHub";
-import { loadDoomConfig } from "@agimon-ai/po-config";
-import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+import { C as STATE_CUSTOM_TYPE, S as RUNTIME_STATE_MESSAGE_TYPE, a as createInitialState, b as CONTEXT_MESSAGE_TYPE, c as effectiveThresholds, d as isStructuredCheckpoint, f as latestCheckpointArtifactEntry, g as projectContextMessages, h as parseState, i as contextDetailsFromUnknown, l as fileDetailsFromUnknown, m as parseCheckpointDecision, n as checkpointRequestDetails, o as createRequestId, p as mergeFileDetails, r as checkpointSummaryFromEntry, s as customMessage, t as baselineUsageIsSettled, u as fileOperationsFromMessages, v as withCanonicalFileSections, x as RESUME_MESSAGE_TYPE, y as CHECKPOINT_MESSAGE_TYPE } from "../compactionPolicy-_WTvdEQ2.mjs";
+import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverPlugin";
+import { composeRootHooks, composeRootInjects, defineHook, defineRoot } from "@agimon-ai/po-core/extensionFile";
+import { ArtifactAccessError, COMPACTION_ARTIFACT_DIRECTORY, artifactRoot, listArtifacts, openArtifact, readArtifactBytes, removeArtifact, writeArtifactText } from "@agimon-ai/po-artifact/artifactFiles";
+import { PO_CONTEXT_CONTRIBUTIONS_SERVICE, requirePoContextContributions } from "@agimon-ai/po-core/contextContributions";
+import { PO_UI_HUB_SERVICE, requirePoUiHub } from "@agimon-ai/po-core/uiHub";
+import { loadPoConfig } from "@agimon-ai/po-config";
+import { createPoTelemetry } from "@agimon-ai/po-telemetry";
 import { minimatch } from "minimatch";
-const FOOTER_SOURCE = "doom-autocompact";
-const STATUS_KEY = "doom-autocompact";
+const FOOTER_SOURCE = "po-autocompact";
+const STATUS_KEY = "po-autocompact";
 //#endregion
 //#region src/services/autocompactRuntime/index.ts
 function errorMessage(error) {
@@ -37,7 +38,7 @@ function readContextContributionsSnapshot(service) {
 		return {
 			entries: [],
 			errors: [{
-				source: DOOM_CONTEXT_CONTRIBUTIONS_SERVICE,
+				source: PO_CONTEXT_CONTRIBUTIONS_SERVICE,
 				id: "service-snapshot",
 				label: "Context contributions",
 				order: 0,
@@ -63,7 +64,7 @@ function formatRuntimeState(snapshot) {
 	return `<compaction-runtime-state>
 Authoritative runtime state captured when compaction committed. Use it to resume coordination without reconstructing state from the summary.
 <active-plan>
-${snapshot.planPath ? `Source: ${snapshot.planPath}\nExact plan content is restored separately by Doom Plan.` : "(no active plan document)"}
+${snapshot.planPath ? `Source: ${snapshot.planPath}\nExact plan content is restored separately by Po Plan.` : "(no active plan document)"}
 </active-plan>
 <context-contributions>
 ${formatContextContributions({
@@ -93,7 +94,7 @@ ${importantContext.length > 0 ? importantContext.join("\n") : "(none recorded ou
 }
 function checkpointInstructions(pass, steering) {
 	const decision = pass === 2 ? "Start with exactly <shouldCompact>true</shouldCompact> or <shouldCompact>false</shouldCompact>. Use true when the staged summary safely retains the important parent context. Use false only when it is not yet sufficient for safe compaction.\n\n" : "";
-	return `Create Doom autocompact checkpoint pass ${pass}.
+	return `Create Po autocompact checkpoint pass ${pass}.
 
 ${steeringEnvelope(steering)}
 
@@ -117,7 +118,7 @@ const DEFAULT_RUNTIME_CONFIG = {
 	overrides: []
 };
 /**
-* What the Doom config says about this package.
+* What the Po config says about this package.
 *
 * `modes.autocompact` is read first and `modes.planning.subagents` is the
 * fallback, because summarization borrowed the planning subagent model before
@@ -126,9 +127,9 @@ const DEFAULT_RUNTIME_CONFIG = {
 function autocompactRuntimeConfig(root, onLoadFailure) {
 	let modes;
 	try {
-		modes = loadDoomConfig(root).modes;
+		modes = loadPoConfig(root).modes;
 	} catch (error) {
-		process.emitWarning("Doom autocompact configuration could not be loaded; using the active session model instead.");
+		process.emitWarning("Po autocompact configuration could not be loaded; using the active session model instead.");
 		onLoadFailure?.(error);
 		return DEFAULT_RUNTIME_CONFIG;
 	}
@@ -151,23 +152,24 @@ function autocompactRuntimeConfig(root, onLoadFailure) {
 }
 //#endregion
 //#region src/services/autocompactTelemetry/index.ts
-const SERVICE_NAME = "doom-autocompact";
+const SERVICE_NAME = "po-autocompact";
 const PACKAGE_NAME = "@agimon-ai/po-autocompact";
 const AUTOCOMPACT_EVENT = {
-	checkpointStarted: "doom_autocompact.checkpoint_started",
-	checkpointCompleted: "doom_autocompact.checkpoint_completed",
-	checkpointFailed: "doom_autocompact.checkpoint_failed",
-	checkpointInvalid: "doom_autocompact.checkpoint_invalid",
-	configurationLoadFailed: "doom_autocompact.configuration_load_failed",
-	contextContributionDegraded: "doom_autocompact.context_contribution_degraded",
-	contextCommitted: "doom_autocompact.context_committed",
-	contextApplied: "doom_autocompact.context_applied",
-	contextMarkerInvalid: "doom_autocompact.context_marker_invalid",
-	contextHookSlow: "doom_autocompact.context_hook_slow",
-	nativeCompactionCompleted: "doom_autocompact.native_compaction_completed"
+	checkpointStarted: "po_autocompact.checkpoint_started",
+	checkpointCompleted: "po_autocompact.checkpoint_completed",
+	checkpointFailed: "po_autocompact.checkpoint_failed",
+	checkpointInvalid: "po_autocompact.checkpoint_invalid",
+	configurationLoadFailed: "po_autocompact.configuration_load_failed",
+	contextContributionDegraded: "po_autocompact.context_contribution_degraded",
+	contextCommitted: "po_autocompact.context_committed",
+	contextApplied: "po_autocompact.context_applied",
+	contextMarkerInvalid: "po_autocompact.context_marker_invalid",
+	contextHookSlow: "po_autocompact.context_hook_slow",
+	nativeCompactionCompleted: "po_autocompact.native_compaction_completed",
+	historyWriteFailed: "po_autocompact.history_write_failed"
 };
 function createAutocompactTelemetry(options = {}) {
-	const telemetry = createDoomTelemetry({
+	const telemetry = createPoTelemetry({
 		serviceName: SERVICE_NAME,
 		packageName: PACKAGE_NAME,
 		cwd: options.cwd,
@@ -188,6 +190,119 @@ function createAutocompactTelemetry(options = {}) {
 	};
 }
 //#endregion
+//#region src/services/compactionHistory/index.ts
+const FORMAT = "po-compaction/1";
+const HEADER = `---\nformat: ${JSON.stringify(FORMAT)}\n`;
+const HISTORY_PATH = new RegExp(`^${COMPACTION_ARTIFACT_DIRECTORY}/(?:epoch-\\d+/(?:summary|checkpoint-\\d+)|in-epoch/checkpoint-\\d+)\\.md$`);
+const NATIVE_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+const NATIVE_SUFFIX = "\n</summary>";
+function historyFile(path, fields, body) {
+	const header = Object.entries({
+		format: FORMAT,
+		...fields
+	}).flatMap(([key, value]) => value === void 0 ? [] : [`${key}: ${JSON.stringify(value)}`]);
+	return {
+		path: `${COMPACTION_ARTIFACT_DIRECTORY}/${path}`,
+		text: `---\n${header.join("\n")}\n---\n\n${body}\n`
+	};
+}
+function isoTime(value) {
+	const time = new Date(value);
+	return Number.isFinite(time.getTime()) ? time.toISOString() : void 0;
+}
+function passOf(value) {
+	if (typeof value !== "object" || value === null || !("pass" in value)) return void 0;
+	return value.pass === 1 || value.pass === 2 || value.pass === 3 ? value.pass : void 0;
+}
+function committedFields(entry) {
+	if (entry.type === "compaction") {
+		const summary = entry.summary.trim();
+		return {
+			body: summary.startsWith(NATIVE_PREFIX) && summary.endsWith(NATIVE_SUFFIX) ? summary.slice(96, -11).trim() : summary,
+			fields: {
+				source: "compact",
+				tokensBefore: entry.tokensBefore > 0 ? entry.tokensBefore : void 0
+			}
+		};
+	}
+	const marker = customMessage(entry);
+	const details = marker?.customType === "po-autocompact-context" ? contextDetailsFromUnknown(marker.details) : void 0;
+	if (!details) return void 0;
+	return {
+		body: checkpointSummaryFromEntry(entry) ?? "",
+		fields: {
+			source: "autocompact",
+			pass: details.poAutocompact.pass,
+			tokensBefore: details.poAutocompact.tokensBefore
+		}
+	};
+}
+/** Number commits along the active branch so a rewind rewrites the same epoch folders. */
+function wantedHistory(entries) {
+	const files = [];
+	let staged = [];
+	let epoch = 1;
+	const checkpoints = (folder) => staged.map(({ entry, summary, pass }, index) => historyFile(`${folder}/checkpoint-${index + 1}.md`, {
+		kind: "checkpoint",
+		epoch,
+		checkpoint: index + 1,
+		entryId: entry.id,
+		source: "autocompact",
+		pass,
+		timestamp: isoTime(entry.timestamp)
+	}, summary));
+	for (const entry of entries) {
+		const marker = customMessage(entry);
+		if (entry.type === "custom" && entry.customType === "po-autocompact-checkpoint" || marker?.customType === "po-autocompact-checkpoint") {
+			const summary = checkpointSummaryFromEntry(entry);
+			if (summary) staged.push({
+				entry,
+				summary,
+				pass: passOf(entry.type === "custom" ? entry.data : marker?.details)
+			});
+			continue;
+		}
+		const committed = committedFields(entry);
+		if (!committed) continue;
+		files.push(...checkpoints(`epoch-${epoch}`), historyFile(`epoch-${epoch}/summary.md`, {
+			kind: "summary",
+			epoch,
+			entryId: entry.id,
+			...committed.fields,
+			timestamp: isoTime(entry.timestamp)
+		}, committed.body));
+		staged = [];
+		epoch += 1;
+	}
+	files.push(...checkpoints("in-epoch"));
+	return files;
+}
+async function ownedHistory(root, path) {
+	const file = await openArtifact(root, path).catch((error) => {
+		if (error instanceof ArtifactAccessError && error.status === 404) return void 0;
+		throw error;
+	});
+	if (!file) return false;
+	try {
+		const bytes = await readArtifactBytes(file.handle, Math.min(file.stat.size, HEADER.length));
+		return new TextDecoder().decode(bytes) === HEADER;
+	} finally {
+		await file.handle.close();
+	}
+}
+/** Mirror history into the session artifact folder. Pruning touches only files carrying this mirror's header. */
+async function mirrorCompactionHistory(root, entries) {
+	const files = wantedHistory(entries);
+	if (files.length === 0) return;
+	for (const file of files) await writeArtifactText(root, file.path, file.text);
+	const listed = await listArtifacts(root);
+	if (listed.error) throw new Error(listed.error);
+	const wanted = new Set(files.map((file) => file.path));
+	const stale = listed.items.filter((item) => HISTORY_PATH.test(item.path) && !wanted.has(item.path));
+	for (const item of stale) if (await ownedHistory(root, item.path)) await removeArtifact(root, item.path);
+	for (const folder of new Set(stale.map((item) => item.path.slice(0, item.path.lastIndexOf("/"))))) await removeArtifact(root, folder);
+}
+//#endregion
 //#region src/services/modelOverrides/index.ts
 /**
 * A pattern naming a provider is matched against `provider/id`, anything else
@@ -233,7 +348,7 @@ function tailAfter(snapshot, current) {
 	return current.slice(snapshot.length);
 }
 function leaf(entries) {
-	return entries.findLast((entry) => entry.type !== "custom" || entry.customType !== "doom-autocompact-state" && entry.customType !== "doom-autocompact-checkpoint")?.id ?? "root";
+	return entries.findLast((entry) => entry.type !== "custom" || entry.customType !== "po-autocompact-state" && entry.customType !== "po-autocompact-checkpoint")?.id ?? "root";
 }
 function createNativeAutocompact(dependencies = {}) {
 	const telemetry = dependencies.telemetry ?? createAutocompactTelemetry();
@@ -252,8 +367,11 @@ function createNativeAutocompact(dependencies = {}) {
 	let configFailureReported = false;
 	let footer;
 	let navigating = false;
+	let degraded = false;
 	let lastNativeCompactionId;
 	let checkpointBoundary;
+	let mirrorQueued = false;
+	let historyWarnedSession;
 	const attributes = () => ({
 		"pi.session.id": context?.sessionId ?? "",
 		"autocompact.cycle": state.cycle,
@@ -289,8 +407,6 @@ function createNativeAutocompact(dependencies = {}) {
 		if (!alive(version)) return;
 		await execution.session.appendCustomEntry(STATE_CUSTOM_TYPE, {
 			...state,
-			nativeSnapshot: snapshot,
-			nativePreviousSnapshot: previousSnapshot,
 			nativeLastCompactionId: lastNativeCompactionId
 		});
 		if (alive(version)) refreshStatus(execution);
@@ -305,6 +421,7 @@ function createNativeAutocompact(dependencies = {}) {
 	};
 	const fail = async (execution, version, error, malformed = false) => {
 		if (!alive(version)) return;
+		degraded = true;
 		const eventAttributes = attributes();
 		const attempts = state.invalidAttempts + 1;
 		const pass = state.pass;
@@ -318,28 +435,51 @@ function createNativeAutocompact(dependencies = {}) {
 		state.phase = "waiting";
 		clear();
 		state.lastAttemptLeafId = failedLeaf;
-		await persist(execution, version);
+		const errors = [error];
+		try {
+			await persist(execution, version);
+		} catch (persistError) {
+			errors.push(persistError);
+		}
 		if (!alive(version)) return;
-		await execution.client.notify({
-			body: `Doom autocompact summarization pass ${pass} failed: ${error instanceof Error ? error.message : String(error)}`,
+		await Promise.allSettled([Promise.resolve().then(() => execution.client.notify({
+			body: `Po autocompact summarization pass ${pass} failed: ${error instanceof Error ? error.message : String(error)}`,
 			level: "error"
-		});
-		await telemetry.recordError(malformed ? AUTOCOMPACT_EVENT.checkpointInvalid : AUTOCOMPACT_EVENT.checkpointFailed, error, {
+		})), ...errors.map((failure) => Promise.resolve().then(() => telemetry.recordError(malformed ? AUTOCOMPACT_EVENT.checkpointInvalid : AUTOCOMPACT_EVENT.checkpointFailed, failure, {
 			...eventAttributes,
 			"autocompact.checkpoint.attempts": attempts,
 			"autocompact.checkpoint.exhausted": attempts >= 3
-		});
+		})))]);
 	};
 	const branch = async (execution) => await execution.session.entries();
 	const canonical = async (execution, entries) => {
 		if (!execution.session.contextMessages) throw new Error("Canonical context is unavailable for autocompact.");
 		return projectContextMessages(await execution.session.contextMessages(), entries).messages;
 	};
+	const scheduleMirror = (execution) => {
+		if (mirrorQueued) return;
+		mirrorQueued = true;
+		enqueue(async () => {
+			mirrorQueued = false;
+			try {
+				await mirrorCompactionHistory(artifactRoot(execution.sessionId, execution.environment), await branch(execution));
+			} catch (error) {
+				const warn = historyWarnedSession !== execution.sessionId;
+				historyWarnedSession = execution.sessionId;
+				await Promise.allSettled([Promise.resolve().then(() => telemetry.recordWarning(AUTOCOMPACT_EVENT.historyWriteFailed, error, attributes())), ...warn ? [Promise.resolve().then(() => execution.client.notify({
+					body: `Po autocompact could not save compaction history: ${error instanceof Error ? error.message : String(error)}`,
+					level: "warning"
+				}))] : []]);
+			}
+		}).finally(() => {
+			mirrorQueued = false;
+		});
+	};
 	const contributionSnapshot = async (execution) => {
 		const result = readContextContributionsSnapshot(contributions);
 		for (const error of result.errors) {
 			await execution.client.notify({
-				body: `Doom autocompact context contribution degraded (${error.source}/${error.id}): ${error.message}`,
+				body: `Po autocompact context contribution degraded (${error.source}/${error.id}): ${error.message}`,
 				level: "warning"
 			});
 			await telemetry.recordWarning(AUTOCOMPACT_EVENT.contextContributionDegraded, new Error(error.message), {
@@ -369,6 +509,54 @@ function createNativeAutocompact(dependencies = {}) {
 			"autocompact.runtime.contribution_error_count": saved.contributionErrors.length
 		};
 	};
+	const summaryModel = async (execution, configuration) => {
+		const ownReference = configuration.agent?.model ? parseModelReference(configuration.agent.model) : void 0;
+		const candidate = ownReference ? `${ownReference.provider}/${ownReference.modelId}` : void 0;
+		const reference = candidate && execution.textCompletion.available(candidate) ? candidate : execution.model ? `${execution.model.provider}/${execution.model.id}` : "";
+		return {
+			reference,
+			thinking: configuration.agent?.thinking ?? (reference === candidate ? ownReference?.thinking : void 0) ?? (await execution.session.readModelSettings?.())?.thinkingLevel
+		};
+	};
+	const manualCompaction = async (event, execution) => {
+		const configuration = configured(execution);
+		if (!configuration.enabled || !execution.textCompletion?.summarize) return;
+		try {
+			const entries = await branch(execution);
+			const messages = await canonical(execution, entries);
+			const delta = state.pass > 1 && previousSnapshot ? tailAfter(previousSnapshot, messages) : void 0;
+			const previous = state.pass > 1 ? checkpointSummaryFromEntry(latestCheckpointArtifactEntry(entries)) : void 0;
+			const { reference, thinking } = await summaryModel(execution, configuration);
+			const instructions = checkpointInstructions(3, {
+				plan: latestPlanSnapshot(entries),
+				contextContributions: await contributionSnapshot(execution),
+				readFiles: state.readFiles,
+				modifiedFiles: state.modifiedFiles
+			});
+			const { summary } = parseCheckpointDecision(await execution.textCompletion.summarize(reference, {
+				messages: delta ?? messages,
+				instructions: typeof event.instructions === "string" && event.instructions.trim() ? `${instructions}\n\n${event.instructions}` : instructions,
+				...previous ? { previousSummary: previous } : {},
+				...thinking ? { thinkingLevel: thinking } : {},
+				...execution.signal ? { signal: execution.signal } : {}
+			}));
+			if (!isStructuredCheckpoint(summary)) throw new Error("Summarization returned an incomplete checkpoint.");
+			const files = mergeFileDetails(state, fileOperationsFromMessages(messages));
+			const usage = await execution.session.contextUsage?.();
+			return { compaction: {
+				summary: withCanonicalFileSections(summary, files),
+				tokensBefore: usage?.tokens ?? 0,
+				retainedTail: [],
+				details: files
+			} };
+		} catch (error) {
+			await execution.client.notify({
+				body: `Po autocompact manual compaction failed: ${error instanceof Error ? error.message : String(error)}`,
+				level: "error"
+			});
+			throw error;
+		}
+	};
 	const resetCycle = () => {
 		state.phase = "waiting";
 		state.checkpointQueue = [];
@@ -412,13 +600,14 @@ function createNativeAutocompact(dependencies = {}) {
 			state.invalidAttempts = 0;
 			clear();
 			await persist(execution, version);
+			scheduleMirror(execution);
 			return false;
 		}
 		if (!execution.session.appendMessage) throw new Error("Checkpoint messages are unavailable.");
 		const files = mergeFileDetails(state, fileOperationsFromMessages(messages));
 		const details = {
 			...files,
-			doomAutocompact: {
+			poAutocompact: {
 				version: 2,
 				cycle: state.cycle,
 				pass,
@@ -446,6 +635,7 @@ function createNativeAutocompact(dependencies = {}) {
 		state.modifiedFiles = files.modifiedFiles;
 		resetCycle();
 		await persist(execution, version);
+		scheduleMirror(execution);
 		if (!alive(version)) return false;
 		await telemetry.recordEvent(AUTOCOMPACT_EVENT.contextCommitted, {
 			...committedAttributes,
@@ -454,10 +644,19 @@ function createNativeAutocompact(dependencies = {}) {
 			"autocompact.apply_mode": idle ? "idle" : "turn_end",
 			...runtimeAttributes
 		});
-		if (idle && alive(version)) await execution.session.admitPrompt?.("Asynchronous compaction completed. Continue from the compacted checkpoint's immediate next action without repeating completed work.", "steer", void 0, `${RESUME_MESSAGE_TYPE}:${details.doomAutocompact.requestId}`);
+		if (idle && alive(version)) await execution.session.admitPrompt?.("Asynchronous compaction completed. Continue from the compacted checkpoint's immediate next action without repeating completed work.", "steer", void 0, `${RESUME_MESSAGE_TYPE}:${details.poAutocompact.requestId}`);
 		return true;
 	};
-	const progress = async (execution, allowBusy = false, appendMessage = checkpointBoundary?.appendMessage.bind(checkpointBoundary)) => {
+	const ensureCheckpointBoundary = (execution) => {
+		if (checkpointBoundary) return;
+		if (!execution.session.registerCheckpointBoundary) throw new Error("Native checkpoint boundaries are unavailable.");
+		checkpointBoundary = execution.session.registerCheckpointBoundary(async (boundary) => {
+			if (!active || navigating || boundary.signal?.aborted) return;
+			const current = context ?? execution;
+			await enqueue(() => boundary.signal?.aborted ? Promise.resolve() : progress(current, true, boundary.appendMessage.bind(boundary)));
+		});
+	};
+	const advance = async (execution, allowBusy = false, appendMessage = checkpointBoundary?.appendMessage.bind(checkpointBoundary)) => {
 		const version = generation;
 		context = execution;
 		const activity = await execution.session.activity();
@@ -510,20 +709,18 @@ function createNativeAutocompact(dependencies = {}) {
 		delete state.pendingCheckpoint;
 		await persist(execution, version);
 		if (!alive(version)) return;
+		degraded = false;
 		controller?.abort();
 		controller = new AbortController();
 		const signal = controller.signal;
-		const ownReference = configuration.agent?.model ? parseModelReference(configuration.agent.model) : void 0;
-		const candidate = ownReference ? `${ownReference.provider}/${ownReference.modelId}` : void 0;
-		const reference = candidate && execution.textCompletion.available(candidate) ? candidate : execution.model ? `${execution.model.provider}/${execution.model.id}` : "";
-		const thinking = configuration.agent?.thinking ?? (reference === candidate ? ownReference?.thinking : void 0) ?? (await execution.session.readModelSettings?.())?.thinkingLevel;
-		if (!alive(version)) return;
 		const requestAttributes = {
 			...attributes(),
 			"autocompact.message_count.before": messages.length
 		};
 		const delta = previousSnapshot ? tailAfter(previousSnapshot, messages) : void 0;
-		const completion = telemetry.runInSpan("doom_autocompact.checkpoint", requestAttributes, async () => {
+		const completion = telemetry.runInSpan("po_autocompact.checkpoint", requestAttributes, async () => {
+			const { reference, thinking } = await summaryModel(execution, configuration);
+			if (!alive(version) || signal.aborted) return "";
 			await telemetry.recordEvent(AUTOCOMPACT_EVENT.checkpointStarted, requestAttributes);
 			return execution.textCompletion.summarize(reference, {
 				messages: pass > 1 && delta ? delta : messages,
@@ -562,16 +759,21 @@ function createNativeAutocompact(dependencies = {}) {
 		work.add(completion);
 		completion.then(() => work.delete(completion), () => work.delete(completion));
 	};
-	const restore = async (execution) => {
-		if (!active) return;
-		if (!checkpointBoundary) {
-			if (!execution.session.registerCheckpointBoundary) throw new Error("Native checkpoint boundaries are unavailable.");
-			checkpointBoundary = execution.session.registerCheckpointBoundary(async (boundary) => {
-				if (!active || navigating || boundary.signal?.aborted) return;
-				const current = context ?? execution;
-				await enqueue(() => boundary.signal?.aborted ? Promise.resolve() : progress(current, true, boundary.appendMessage.bind(boundary)));
-			});
+	const progress = async (execution, allowBusy = false, appendMessage) => {
+		const version = generation;
+		try {
+			ensureCheckpointBoundary(execution);
+			await advance(execution, allowBusy, appendMessage);
+		} catch (error) {
+			try {
+				await fail(execution, version, error);
+			} finally {
+				if (alive(version)) delete state.lastAttemptLeafId;
+			}
 		}
+	};
+	const load = async (execution) => {
+		if (!active) return;
 		navigating = false;
 		generation += 1;
 		const version = generation;
@@ -582,7 +784,7 @@ function createNativeAutocompact(dependencies = {}) {
 		invalid.clear();
 		const entries = await branch(execution);
 		if (!alive(version)) return;
-		const entry = entries.findLast((item) => item.type === "custom" && item.customType === "doom-autocompact-state");
+		const entry = entries.findLast((item) => item.type === "custom" && item.customType === "po-autocompact-state");
 		const data = entry?.type === "custom" && entry.data && typeof entry.data === "object" ? entry.data : void 0;
 		state = parseState(data) ?? createInitialState();
 		lastNativeCompactionId = typeof data?.nativeLastCompactionId === "string" ? data.nativeLastCompactionId : void 0;
@@ -593,9 +795,9 @@ function createNativeAutocompact(dependencies = {}) {
 			const artifacts = entries.slice(entry ? entries.indexOf(entry) + 1 : 0);
 			const committed = artifacts.findLast((item) => {
 				const message = item.type === "message" ? item.message : void 0;
-				if (message?.role !== "custom" || message.customType !== "doom-autocompact-context") return false;
+				if (message?.role !== "custom" || message.customType !== "po-autocompact-context") return false;
 				const details = contextDetailsFromUnknown(message.details);
-				return details !== void 0 && details.doomAutocompact.requestId === state.requestId && details.doomAutocompact.cycle === state.cycle && details.doomAutocompact.pass === state.pass && details.doomAutocompact.snapshotLeafId === state.snapshotLeafId && isStructuredCheckpoint(checkpointSummaryFromEntry(item) ?? "");
+				return details !== void 0 && details.poAutocompact.requestId === state.requestId && details.poAutocompact.cycle === state.cycle && details.poAutocompact.pass === state.pass && details.poAutocompact.snapshotLeafId === state.snapshotLeafId && isStructuredCheckpoint(checkpointSummaryFromEntry(item) ?? "");
 			});
 			if (committed?.type === "message" && committed.message.role === "custom") {
 				const details = contextDetailsFromUnknown(committed.message.details);
@@ -604,7 +806,7 @@ function createNativeAutocompact(dependencies = {}) {
 				resetCycle();
 				await persist(execution, version);
 			} else if (artifacts.findLast((item) => {
-				if (item.type !== "custom" || item.customType !== "doom-autocompact-checkpoint") return false;
+				if (item.type !== "custom" || item.customType !== "po-autocompact-checkpoint") return false;
 				const details = item.data;
 				return details?.version === 2 && details.requestId === state.requestId && details.cycle === state.cycle && details.pass === state.pass && isStructuredCheckpoint(checkpointSummaryFromEntry(item) ?? "");
 			}) && (state.pass === 1 || state.pass === 2)) {
@@ -618,12 +820,24 @@ function createNativeAutocompact(dependencies = {}) {
 				await persist(execution, version);
 			}
 		}
-		if (state.phase !== "waiting" && state.phase !== "checkpoint_ready") {
+		if (state.phase !== "waiting" && (state.phase !== "checkpoint_ready" || !snapshot)) {
 			state.phase = "waiting";
 			clear();
+			delete state.lastAttemptLeafId;
 			await persist(execution, version);
 		}
-		if (alive(version)) await enqueue(() => progress(execution));
+		if (!alive(version)) return;
+		const progressed = enqueue(() => progress(execution));
+		scheduleMirror(execution);
+		await progressed;
+	};
+	const restore = async (execution) => {
+		const version = generation + 1;
+		try {
+			await load(execution);
+		} catch (error) {
+			await fail(execution, version, error);
+		}
 	};
 	return {
 		hooks: [
@@ -654,7 +868,11 @@ function createNativeAutocompact(dependencies = {}) {
 			},
 			{
 				event: "session_before_compact",
-				handle: (event, execution) => active && !navigating && configured(execution).enabled && event.reason === "threshold" && (state.phase === "checkpoint_pending" || state.phase === "checkpoint_ready" || state.baselinePending) ? { cancel: true } : void 0
+				handle: (event, execution) => {
+					if (!active || navigating) return;
+					if (event.reason === "manual") return manualCompaction(event, execution);
+					return !degraded && configured(execution).enabled && event.reason === "threshold" && (state.phase === "checkpoint_pending" || state.phase === "checkpoint_ready") ? { cancel: true } : void 0;
+				}
 			},
 			{
 				event: "context",
@@ -670,7 +888,7 @@ function createNativeAutocompact(dependencies = {}) {
 							const id = leaf(entries);
 							if (!invalid.has(id)) {
 								invalid.add(id);
-								await telemetry.recordError(AUTOCOMPACT_EVENT.contextMarkerInvalid, /* @__PURE__ */ new Error("Doom autocompact context marker is malformed."), {
+								await telemetry.recordError(AUTOCOMPACT_EVENT.contextMarkerInvalid, /* @__PURE__ */ new Error("Po autocompact context marker is malformed."), {
 									...attributes(),
 									"autocompact.leaf_id": id
 								});
@@ -727,6 +945,7 @@ function createNativeAutocompact(dependencies = {}) {
 						const nativeAttributes = attributes();
 						resetCycle();
 						await persist(execution, version);
+						scheduleMirror(execution);
 						if (alive(version)) await telemetry.recordEvent(AUTOCOMPACT_EVENT.nativeCompactionCompleted, {
 							...nativeAttributes,
 							"autocompact.native.reason": typeof event.reason === "string" ? event.reason : "unknown",
@@ -739,8 +958,8 @@ function createNativeAutocompact(dependencies = {}) {
 			}
 		],
 		plugin(cordis) {
-			cordis.inject([DOOM_UI_HUB_SERVICE], (injected) => {
-				const contribution = requireDoomUiHub(injected).registerFooter({
+			cordis.inject([PO_UI_HUB_SERVICE], (injected) => {
+				const contribution = requirePoUiHub(injected).registerFooter({
 					source: FOOTER_SOURCE,
 					id: "autocompact",
 					order: 20
@@ -752,8 +971,8 @@ function createNativeAutocompact(dependencies = {}) {
 					if (footer === contribution) footer = void 0;
 				};
 			});
-			cordis.inject([DOOM_CONTEXT_CONTRIBUTIONS_SERVICE], (injected) => {
-				const service = requireDoomContextContributions(injected);
+			cordis.inject([PO_CONTEXT_CONTRIBUTIONS_SERVICE], (injected) => {
+				const service = requirePoContextContributions(injected);
 				contributions = service;
 				return () => {
 					if (contributions === service) contributions = void 0;
@@ -815,11 +1034,12 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = defineServerPlugin({
+const serverPlugin = defineServerPlugin({
 	name: "@agimon-ai/po-autocompact",
 	providerOverrides: composeServerProviderOverrides(root_server_default),
+	injects: composeRootInjects({ session: [root_server_default] }),
 	session: async (context) => {
-		const scopeSession = await root_server_default(context);
+		const scopeSession = await context.scopeRoot("session", root_server_default, context);
 		const contextSession = {
 			...context,
 			root: scopeSession.value
@@ -845,6 +1065,6 @@ const facet = defineServerPlugin({
 	}
 });
 //#endregion
-export { facet as default, facet };
+export { serverPlugin as default, serverPlugin };
 
 //# sourceMappingURL=server.mjs.map