@oh-my-pi/snapcompact 16.1.22 → 16.1.23

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [16.1.23] - 2026-06-26
+
+### Added
+
+- Added `archiveSourceText(archive)` to extract a persisted frame archive's source text as plain text for LLM summarization. ([#3561](https://github.com/can1357/oh-my-pi/pull/3561) by [@serverinspector](https://github.com/serverinspector))
+- Added `stripPreservedArchive(preserveData)` to drop the persisted frame-archive slot (`PRESERVE_KEY`) and collapse to `undefined` when no other state remains — shared by the agent and coding-agent compaction paths instead of duplicating the strip rule.
+
 ## [16.1.13] - 2026-06-22
 
 ### Fixed

package/dist/types/snapcompact.d.ts

@@ -519,6 +519,14 @@ export declare function renderMany(text: string, options?: RenderManyOptions): P
 export declare function frames(text: string, options?: Pick<RenderManyOptions, "shape" | "model" | "frameSize">): number;
 /** Validate and extract a persisted frame archive from `preserveData`. */
 export declare function getPreservedArchive(preserveData: Record<string, unknown> | undefined): Archive | undefined;
+/** Drop the persisted frame archive ({@link PRESERVE_KEY}) from `preserveData`,
+ *  returning the remaining state — or `undefined` when nothing else remains, so
+ *  an empty `{}` is never persisted. Callers strip the archive once its frames
+ *  have been migrated into a new compaction's text, preventing the stale frames
+ *  from leaking back into the rebuilt context. */
+export declare function stripPreservedArchive(preserveData: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+/** Extract persisted archive source text as plain text for LLM summarization. */
+export declare function archiveSourceText(archive: Archive): string | undefined;
 /** Convert archive frames into LLM image blocks (oldest first). */
 export declare function images(archive: Archive): ImageContent[];
 /** Ordered archive blocks for a compaction summary message, oldest to newest:

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/snapcompact",
-	"version": "16.1.22",
+	"version": "16.1.23",
 	"description": "Bitmap-frame context compression for vision-capable LLMs",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,10 +31,10 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "16.1.22",
-		"@oh-my-pi/pi-natives": "16.1.22",
-		"@oh-my-pi/pi-utils": "16.1.22",
-		"@oh-my-pi/pi-wire": "16.1.22"
+		"@oh-my-pi/pi-ai": "16.1.23",
+		"@oh-my-pi/pi-natives": "16.1.23",
+		"@oh-my-pi/pi-utils": "16.1.23",
+		"@oh-my-pi/pi-wire": "16.1.23"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/snapcompact.ts

@@ -1290,6 +1290,29 @@ export function getPreservedArchive(preserveData: Record<string, unknown> | unde
 	};
 }
 
+/** Drop the persisted frame archive ({@link PRESERVE_KEY}) from `preserveData`,
+ *  returning the remaining state — or `undefined` when nothing else remains, so
+ *  an empty `{}` is never persisted. Callers strip the archive once its frames
+ *  have been migrated into a new compaction's text, preventing the stale frames
+ *  from leaking back into the rebuilt context. */
+export function stripPreservedArchive(
+	preserveData: Record<string, unknown> | undefined,
+): Record<string, unknown> | undefined {
+	if (!preserveData || !(PRESERVE_KEY in preserveData)) return preserveData;
+	const { [PRESERVE_KEY]: _removed, ...rest } = preserveData;
+	return Object.keys(rest).length > 0 ? rest : undefined;
+}
+
+/** Extract persisted archive source text as plain text for LLM summarization. */
+export function archiveSourceText(archive: Archive): string | undefined {
+	const text =
+		archive.text ??
+		[archive.textHead, archive.textTail]
+			.filter((part): part is string => typeof part === "string" && part.length > 0)
+			.join(NEWLINE_GLYPH);
+	return text.length > 0 ? toPlainText(text) : undefined;
+}
+
 /** Convert archive frames into LLM image blocks (oldest first). */
 export function images(archive: Archive): ImageContent[] {
 	return archive.frames.map(frame => ({