@oh-my-pi/pi-agent-core 16.4.8 → 16.5.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [16.5.0] - 2026-07-13
+
+### Added
+
+- Added an automated image-dropping rescue tier to compaction dead-end recovery.
+- Added visual warnings and detailed recovery instructions to the session timeline when compaction fails to free sufficient space.
+
 ## [16.4.5] - 2026-07-11
 
 ### Added

package/dist/types/compaction/entries.d.ts

@@ -37,6 +37,12 @@ export interface CompactionEntry<T = unknown> extends SessionEntryBase {
     preserveData?: Record<string, unknown>;
     /** True if generated by an extension, undefined/false if pi-generated (backward compatible) */
     fromExtension?: boolean;
+    /**
+     * Dead-end warning from the post-pass progress guard: the pass completed
+     * but freed too little for maintenance to continue. Rendered on the
+     * compaction divider.
+     */
+    warning?: string;
 }
 export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
     type: "branch_summary";

package/dist/types/compaction/messages.d.ts

@@ -39,6 +39,8 @@ export interface CompactionSummaryMessage {
     blocks?: (TextContent | ImageContent)[];
     /** Snapcompact image blocks, kept for display counts / legacy consumers. */
     images?: ImageContent[];
+    /** Post-pass dead-end warning attached to this compaction (progress guard). */
+    warning?: string;
     timestamp: number;
 }
 export type CoreCompactionMessage = CustomMessage | HookMessage | BranchSummaryMessage | CompactionSummaryMessage;
@@ -54,7 +56,7 @@ export type ConvertToLlm = (messages: AgentMessage[]) => Message[];
 export declare function renderBranchSummaryContext(summary: string): string;
 export declare function renderCompactionSummaryContext(summary: string): string;
 export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
-export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string, shortSummary?: string, providerPayload?: ProviderPayload, images?: ImageContent[], blocks?: (TextContent | ImageContent)[]): CompactionSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string, shortSummary?: string, providerPayload?: ProviderPayload, images?: ImageContent[], blocks?: (TextContent | ImageContent)[], warning?: string): CompactionSummaryMessage;
 export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string, attribution?: MessageAttribution): CustomMessage;
 /**
  * Transform a single core-domain agent message to its LLM form; `undefined`

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-agent-core",
-	"version": "16.4.8",
+	"version": "16.5.0",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -35,12 +35,12 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "16.4.8",
-		"@oh-my-pi/pi-catalog": "16.4.8",
-		"@oh-my-pi/pi-natives": "16.4.8",
-		"@oh-my-pi/pi-utils": "16.4.8",
-		"@oh-my-pi/pi-wire": "16.4.8",
-		"@oh-my-pi/snapcompact": "16.4.8",
+		"@oh-my-pi/pi-ai": "16.5.0",
+		"@oh-my-pi/pi-catalog": "16.5.0",
+		"@oh-my-pi/pi-natives": "16.5.0",
+		"@oh-my-pi/pi-utils": "16.5.0",
+		"@oh-my-pi/pi-wire": "16.5.0",
+		"@oh-my-pi/snapcompact": "16.5.0",
 		"@opentelemetry/api": "^1.9.1"
 	},
 	"devDependencies": {

package/src/compaction/entries.ts

@@ -43,6 +43,12 @@ export interface CompactionEntry<T = unknown> extends SessionEntryBase {
 	preserveData?: Record<string, unknown>;
 	/** True if generated by an extension, undefined/false if pi-generated (backward compatible) */
 	fromExtension?: boolean;
+	/**
+	 * Dead-end warning from the post-pass progress guard: the pass completed
+	 * but freed too little for maintenance to continue. Rendered on the
+	 * compaction divider.
+	 */
+	warning?: string;
 }
 
 export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {

package/src/compaction/messages.ts

@@ -56,6 +56,8 @@ export interface CompactionSummaryMessage {
 	blocks?: (TextContent | ImageContent)[];
 	/** Snapcompact image blocks, kept for display counts / legacy consumers. */
 	images?: ImageContent[];
+	/** Post-pass dead-end warning attached to this compaction (progress guard). */
+	warning?: string;
 	timestamp: number;
 }
 
@@ -105,6 +107,7 @@ export function createCompactionSummaryMessage(
 	providerPayload?: ProviderPayload,
 	images?: ImageContent[],
 	blocks?: (TextContent | ImageContent)[],
+	warning?: string,
 ): CompactionSummaryMessage {
 	const imageBlocks =
 		blocks?.filter((block): block is ImageContent => block.type === "image") ??
@@ -117,6 +120,7 @@ export function createCompactionSummaryMessage(
 		providerPayload,
 		blocks: blocks && blocks.length > 0 ? blocks : undefined,
 		images: imageBlocks && imageBlocks.length > 0 ? imageBlocks : undefined,
+		warning,
 		timestamp: new Date(timestamp).getTime(),
 	};
 }