@nghyane/arcane 0.1.29 → 0.1.30

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.29",
+	"version": "0.1.30",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/nghyane/arcane",
 	"author": "Can Bölük",
@@ -44,9 +44,9 @@
 	},
 	"dependencies": {
 		"@mozilla/readability": "0.6.0",
-		"@nghyane/arcane-stats": "^0.1.14",
-		"@nghyane/arcane-agent": "^0.1.18",
-		"@nghyane/arcane-ai": "^0.1.14",
+		"@nghyane/arcane-stats": "^0.1.15",
+		"@nghyane/arcane-agent": "^0.1.19",
+		"@nghyane/arcane-ai": "^0.1.15",
 		"@nghyane/arcane-natives": "^0.1.11",
 		"@nghyane/arcane-tui": "^0.1.15",
 		"@nghyane/arcane-utils": "^0.1.8",

package/src/cli/config-cli.ts

@@ -346,7 +346,7 @@ ${chalk.bold("Examples:")}
   ${APP_NAME} config list
   ${APP_NAME} config get theme
   ${APP_NAME} config set theme catppuccin-mocha
-  ${APP_NAME} config set compaction.enabled false
+  ${APP_NAME} config set retry.enabled false
   ${APP_NAME} config set defaultThinkingLevel medium
   ${APP_NAME} config reset steeringMode
   ${APP_NAME} config list --json

package/src/config/settings-schema.ts

@@ -6,7 +6,7 @@
  * - Optional UI metadata (label, description, tab)
  *
  * The Settings singleton provides type-safe path-based access:
- *   settings.get("compaction.enabled")  // => boolean
+ *   settings.get("retry.enabled")  // => boolean
  *   settings.set("theme.dark", "titanium")  // sync, saves in background
  */
 
@@ -296,10 +296,22 @@ export const SETTINGS_SCHEMA = {
 		ui: {
 			tab: "agent",
 			label: "Auto-promote context",
-			description: "Promote to a larger-context model on context overflow instead of compacting",
+			description: "Promote to a larger-context model on context overflow",
 		},
 	},
 
+	"autoHandoff.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "agent",
+			label: "Auto-handoff",
+			description: "Automatically hand off to a new session when context window is nearly full",
+		},
+	},
+	"autoHandoff.warningThreshold": { type: "number", default: 80 },
+	"autoHandoff.handoffThreshold": { type: "number", default: 95 },
+
 	// ─────────────────────────────────────────────────────────────────────────
 	// Secrets settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -309,23 +321,6 @@ export const SETTINGS_SCHEMA = {
 		ui: { tab: "config", label: "Hide secrets", description: "Obfuscate secrets before sending to AI providers" },
 	},
 
-	// ─────────────────────────────────────────────────────────────────────────
-	// Compaction settings
-	// ─────────────────────────────────────────────────────────────────────────
-	"compaction.enabled": {
-		type: "boolean",
-		default: true,
-		ui: {
-			tab: "agent",
-			label: "Auto-compact",
-			description: "Automatically compact context when it gets too large",
-		},
-	},
-	"compaction.reserveTokens": { type: "number", default: 16384 },
-	"compaction.keepRecentTokens": { type: "number", default: 20000 },
-	"compaction.autoContinue": { type: "boolean", default: true },
-	"compaction.remoteEndpoint": { type: "string", default: undefined },
-
 	// ─────────────────────────────────────────────────────────────────────────
 	// Branch summary settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -997,16 +992,13 @@ export type StatusLineSeparatorStyle = SettingValue<"statusLine.separator">;
 // Typed Group Definitions
 // ═══════════════════════════════════════════════════════════════════════════
 
-export interface CompactionSettings {
+export interface ContextPromotionSettings {
 	enabled: boolean;
-	reserveTokens: number;
-	keepRecentTokens: number;
-	autoContinue: boolean;
-	remoteEndpoint: string | undefined;
 }
-
-export interface ContextPromotionSettings {
+export interface AutoHandoffSettings {
 	enabled: boolean;
+	warningThreshold: number;
+	handoffThreshold: number;
 }
 export interface RetrySettings {
 	enabled: boolean;
@@ -1080,8 +1072,8 @@ export interface BashInterceptorRule {
 
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
-	compaction: CompactionSettings;
 	contextPromotion: ContextPromotionSettings;
+	autoHandoff: AutoHandoffSettings;
 	retry: RetrySettings;
 	branchSummary: BranchSummarySettings;
 	skills: SkillsSettings;

package/src/config/settings.ts

@@ -4,11 +4,11 @@
  * Usage:
  *   import { settings } from "./settings";
  *
- *   const enabled = settings.get("compaction.enabled");  // sync read
+ *   const enabled = settings.get("retry.enabled");  // sync read
  *   settings.set("theme.dark", "titanium");               // sync write, saves in background
  *
  * For tests:
- *   const isolated = Settings.isolated({ "compaction.enabled": false });
+ *   const isolated = Settings.isolated({ "retry.enabled": false });
  */
 
 import * as fs from "node:fs";
@@ -37,7 +37,6 @@ import {
 export type {
 	BashInterceptorRule,
 	BranchSummarySettings,
-	CompactionSettings,
 	ContextPromotionSettings,
 	ExaSettings,
 	GroupPrefix,
@@ -79,7 +78,7 @@ export interface SettingsOptions {
 
 /**
  * Parse a dotted path into segments.
- * "compaction.enabled" → ["compaction", "enabled"]
+ * "retry.enabled" → ["retry", "enabled"]
  * "theme.dark" → ["theme", "dark"]
  */
 function parsePath(path: string): string[] {

package/src/extensibility/custom-tools/types.ts

@@ -12,7 +12,6 @@ import type { Rule } from "../../capability/rule";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { HookUIContext } from "../../extensibility/hooks/types";
-import type { CompactionResult } from "../../session/compaction";
 import type { ReadonlySessionManager } from "../../session/session-manager";
 import type { Theme } from "../../theme/theme";
 import type { TodoItem } from "../../tools/todo-write";
@@ -71,17 +70,6 @@ export type CustomToolSessionEvent =
 			/** Previous session file path, or undefined for "start" and "shutdown" */
 			previousSessionFile: string | undefined;
 	  }
-	| {
-			reason: "auto_compaction_start";
-			trigger: "threshold" | "overflow";
-	  }
-	| {
-			reason: "auto_compaction_end";
-			result: CompactionResult | undefined;
-			aborted: boolean;
-			willRetry: boolean;
-			errorMessage?: string;
-	  }
 	| {
 			reason: "auto_retry_start";
 			attempt: number;

package/src/extensibility/extensions/index.ts

@@ -89,16 +89,11 @@ export type {
 	SendUserMessageHandler,
 	SessionBeforeBranchEvent,
 	SessionBeforeBranchResult,
-	SessionBeforeCompactEvent,
-	SessionBeforeCompactResult,
 	SessionBeforeSwitchEvent,
 	SessionBeforeSwitchResult,
 	SessionBeforeTreeEvent,
 	SessionBeforeTreeResult,
 	SessionBranchEvent,
-	SessionCompactEvent,
-	SessionCompactingEvent,
-	SessionCompactingResult,
 	SessionEvent,
 	SessionShutdownEvent,
 	// Events - Session

package/src/extensibility/extensions/runner.ts

@@ -11,7 +11,6 @@ import { type Theme, theme } from "../../theme/theme";
 import type {
 	BeforeAgentStartEvent,
 	BeforeAgentStartEventResult,
-	CompactOptions,
 	ContextEvent,
 	ContextEventResult,
 	ContextUsage,
@@ -35,10 +34,8 @@ import type {
 	ResourcesDiscoverEvent,
 	ResourcesDiscoverResult,
 	SessionBeforeBranchResult,
-	SessionBeforeCompactResult,
 	SessionBeforeSwitchResult,
 	SessionBeforeTreeResult,
-	SessionCompactingResult,
 	ToolCallEvent,
 	ToolCallEventResult,
 	ToolResultEvent,
@@ -74,26 +71,18 @@ type RunnerEmitEvent = Exclude<
 
 type SessionBeforeEvent = Extract<
 	RunnerEmitEvent,
-	{ type: "session_before_switch" | "session_before_branch" | "session_before_compact" | "session_before_tree" }
+	{ type: "session_before_switch" | "session_before_branch" | "session_before_tree" }
 >;
 
-type SessionBeforeEventResult =
-	| SessionBeforeSwitchResult
-	| SessionBeforeBranchResult
-	| SessionBeforeCompactResult
-	| SessionBeforeTreeResult;
+type SessionBeforeEventResult = SessionBeforeSwitchResult | SessionBeforeBranchResult | SessionBeforeTreeResult;
 
 type RunnerEmitResult<TEvent extends RunnerEmitEvent> = TEvent extends { type: "session_before_switch" }
 	? SessionBeforeSwitchResult | undefined
 	: TEvent extends { type: "session_before_branch" }
 		? SessionBeforeBranchResult | undefined
-		: TEvent extends { type: "session_before_compact" }
-			? SessionBeforeCompactResult | undefined
-			: TEvent extends { type: "session_before_tree" }
-				? SessionBeforeTreeResult | undefined
-				: TEvent extends { type: "session.compacting" }
-					? SessionCompactingResult | undefined
-					: undefined;
+		: TEvent extends { type: "session_before_tree" }
+			? SessionBeforeTreeResult | undefined
+			: undefined;
 
 export type NewSessionHandler = (options?: {
 	parentSession?: string;
@@ -162,7 +151,6 @@ export class ExtensionRunner {
 	#abortFn: () => void = () => {};
 	#hasPendingMessagesFn: () => boolean = () => false;
 	#getContextUsageFn: () => ContextUsage | undefined = () => undefined;
-	#compactFn: (instructionsOrOptions?: string | CompactOptions) => Promise<void> = async () => {};
 	#getSystemPromptFn: () => string = () => "";
 	#newSessionHandler: NewSessionHandler = async () => ({ cancelled: false });
 	#branchHandler: BranchHandler = async () => ({ cancelled: false });
@@ -217,7 +205,6 @@ export class ExtensionRunner {
 			this.#switchSessionHandler = commandContextActions.switchSession;
 			this.#reloadHandler = commandContextActions.reload;
 			this.#getContextUsageFn = commandContextActions.getContextUsage;
-			this.#compactFn = commandContextActions.compact;
 		}
 
 		this.#uiContext = uiContext ?? noOpUIContext;
@@ -376,7 +363,6 @@ export class ExtensionRunner {
 		return {
 			ui: this.#uiContext,
 			getContextUsage: () => this.#getContextUsageFn(),
-			compact: instructionsOrOptions => this.#compactFn(instructionsOrOptions),
 			hasUI: this.hasUI(),
 			cwd: this.cwd,
 			sessionManager: this.sessionManager,
@@ -410,7 +396,6 @@ export class ExtensionRunner {
 			navigateTree: (targetId, options) => this.#navigateTreeHandler(targetId, options),
 			switchSession: sessionPath => this.#switchSessionHandler(sessionPath),
 			reload: () => this.#reloadHandler(),
-			compact: instructionsOrOptions => this.#compactFn(instructionsOrOptions),
 		};
 	}
 
@@ -418,14 +403,13 @@ export class ExtensionRunner {
 		return (
 			event.type === "session_before_switch" ||
 			event.type === "session_before_branch" ||
-			event.type === "session_before_compact" ||
 			event.type === "session_before_tree"
 		);
 	}
 
 	async emit<TEvent extends RunnerEmitEvent>(event: TEvent): Promise<RunnerEmitResult<TEvent>> {
 		const ctx = this.createContext();
-		let result: SessionBeforeEventResult | SessionCompactingResult | undefined;
+		let result: SessionBeforeEventResult | undefined;
 
 		for (const ext of this.extensions) {
 			const handlers = ext.handlers.get(event.type);
@@ -441,10 +425,6 @@ export class ExtensionRunner {
 							return result as RunnerEmitResult<TEvent>;
 						}
 					}
-
-					if (event.type === "session.compacting" && handlerResult) {
-						result = handlerResult as SessionCompactingResult;
-					}
 				} catch (err) {
 					const message = err instanceof Error ? err.message : String(err);
 					const stack = err instanceof Error ? err.stack : undefined;

package/src/extensibility/extensions/types.ts

@@ -32,11 +32,9 @@ import type { BashResult } from "../../exec/bash-executor";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { PythonResult } from "../../ipy/executor";
 import type { EditToolDetails } from "../../patch";
-import type { CompactionPreparation, CompactionResult } from "../../session/compaction";
 import type { CustomMessage } from "../../session/messages";
 import type {
 	BranchSummaryEntry,
-	CompactionEntry,
 	ReadonlySessionManager,
 	SessionEntry,
 	SessionManager,
@@ -176,18 +174,13 @@ export interface ExtensionUIContext {
 // ============================================================================
 
 export interface ContextUsage {
-	/** Estimated context tokens, or null if unknown (e.g. right after compaction, before next LLM response). */
+	/** Estimated context tokens, or null if unknown. */
 	tokens: number | null;
 	contextWindow: number;
 	/** Context usage as percentage of context window, or null if tokens is unknown. */
 	percent: number | null;
 }
 
-export interface CompactOptions {
-	onComplete?: (result: CompactionResult) => void;
-	onError?: (error: Error) => void;
-}
-
 /**
  * Context passed to extension event handlers.
  */
@@ -196,8 +189,6 @@ export interface ExtensionContext {
 	ui: ExtensionUIContext;
 	/** Get current context usage for the active model. */
 	getContextUsage(): ContextUsage | undefined;
-	/** Compact the session context (interactive mode shows UI). */
-	compact(instructionsOrOptions?: string | CompactOptions): Promise<void>;
 	/** Whether UI is available (false in print/RPC mode) */
 	hasUI: boolean;
 	/** Current working directory */
@@ -250,9 +241,6 @@ export interface ExtensionCommandContext extends ExtensionContext {
 
 	/** Reload the current session/runtime state. */
 	reload(): Promise<void>;
-
-	/** Compact the session context (interactive mode shows UI). */
-	compact(instructionsOrOptions?: string | CompactOptions): Promise<void>;
 }
 
 // ============================================================================
@@ -369,29 +357,6 @@ export interface SessionBranchEvent {
 	previousSessionFile: string | undefined;
 }
 
-/** Fired before context compaction (can be cancelled or customized) */
-export interface SessionBeforeCompactEvent {
-	type: "session_before_compact";
-	preparation: CompactionPreparation;
-	branchEntries: SessionEntry[];
-	customInstructions?: string;
-	signal: AbortSignal;
-}
-
-/** Fired before compaction summarization to customize prompts/context */
-export interface SessionCompactingEvent {
-	type: "session.compacting";
-	sessionId: string;
-	messages: AgentMessage[];
-}
-
-/** Fired after context compaction */
-export interface SessionCompactEvent {
-	type: "session_compact";
-	compactionEntry: CompactionEntry;
-	fromExtension: boolean;
-}
-
 /** Fired on process exit */
 export interface SessionShutdownEvent {
 	type: "session_shutdown";
@@ -428,9 +393,6 @@ export type SessionEvent =
 	| SessionSwitchEvent
 	| SessionBeforeBranchEvent
 	| SessionBranchEvent
-	| SessionBeforeCompactEvent
-	| SessionCompactingEvent
-	| SessionCompactEvent
 	| SessionShutdownEvent
 	| SessionBeforeTreeEvent
 	| SessionTreeEvent;
@@ -525,21 +487,6 @@ export interface ToolExecutionEndEvent {
 	isError: boolean;
 }
 
-/** Fired when auto-compaction starts */
-export interface AutoCompactionStartEvent {
-	type: "auto_compaction_start";
-	reason: "threshold" | "overflow";
-}
-
-/** Fired when auto-compaction ends */
-export interface AutoCompactionEndEvent {
-	type: "auto_compaction_end";
-	result: CompactionResult | undefined;
-	aborted: boolean;
-	willRetry: boolean;
-	errorMessage?: string;
-}
-
 /** Fired when auto-retry starts */
 export interface AutoRetryStartEvent {
 	type: "auto_retry_start";
@@ -770,8 +717,6 @@ export type ExtensionEvent =
 	| ToolExecutionStartEvent
 	| ToolExecutionUpdateEvent
 	| ToolExecutionEndEvent
-	| AutoCompactionStartEvent
-	| AutoCompactionEndEvent
 	| AutoRetryStartEvent
 	| AutoRetryEndEvent
 	| TtsrTriggeredEvent
@@ -838,17 +783,6 @@ export interface SessionBeforeBranchResult {
 	skipConversationRestore?: boolean;
 }
 
-export interface SessionBeforeCompactResult {
-	cancel?: boolean;
-	compaction?: CompactionResult;
-}
-
-export interface SessionCompactingResult {
-	context?: string[];
-	prompt?: string;
-	preserveData?: Record<string, unknown>;
-}
-
 export interface SessionBeforeTreeResult {
 	cancel?: boolean;
 	summary?: {
@@ -923,12 +857,6 @@ export interface ExtensionAPI {
 		handler: ExtensionHandler<SessionBeforeBranchEvent, SessionBeforeBranchResult>,
 	): void;
 	on(event: "session_branch", handler: ExtensionHandler<SessionBranchEvent>): void;
-	on(
-		event: "session_before_compact",
-		handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>,
-	): void;
-	on(event: "session.compacting", handler: ExtensionHandler<SessionCompactingEvent, SessionCompactingResult>): void;
-	on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): void;
 	on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): void;
 	on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): void;
 	on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
@@ -944,8 +872,6 @@ export interface ExtensionAPI {
 	on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
 	on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
 	on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
-	on(event: "auto_compaction_start", handler: ExtensionHandler<AutoCompactionStartEvent>): void;
-	on(event: "auto_compaction_end", handler: ExtensionHandler<AutoCompactionEndEvent>): void;
 	on(event: "auto_retry_start", handler: ExtensionHandler<AutoRetryStartEvent>): void;
 	on(event: "auto_retry_end", handler: ExtensionHandler<AutoRetryEndEvent>): void;
 	on(event: "ttsr_triggered", handler: ExtensionHandler<TtsrTriggeredEvent>): void;
@@ -1239,7 +1165,6 @@ export interface ExtensionContextActions {
 	hasPendingMessages: () => boolean;
 	shutdown: () => void;
 	getContextUsage: () => ContextUsage | undefined;
-	compact: (instructionsOrOptions?: string | CompactOptions) => Promise<void>;
 	getSystemPrompt: () => string;
 }
 
@@ -1253,7 +1178,6 @@ export interface ExtensionCommandContextActions {
 	}) => Promise<{ cancelled: boolean }>;
 	branch: (entryId: string) => Promise<{ cancelled: boolean }>;
 	navigateTree: (targetId: string, options?: { summarize?: boolean }) => Promise<{ cancelled: boolean }>;
-	compact: (instructionsOrOptions?: string | CompactOptions) => Promise<void>;
 	switchSession: (sessionPath: string) => Promise<{ cancelled: boolean }>;
 	reload: () => Promise<void>;
 }

package/src/extensibility/hooks/runner.ts

@@ -26,9 +26,7 @@ import type {
 	HookMessageRenderer,
 	HookUIContext,
 	RegisteredCommand,
-	SessionBeforeCompactResult,
 	SessionBeforeTreeResult,
-	SessionCompactingResult,
 	ToolCallEvent,
 	ToolCallEventResult,
 	ToolResultEventResult,
@@ -270,31 +268,17 @@ export class HookRunner {
 	 */
 	#isSessionBeforeEvent(
 		type: string,
-	): type is "session_before_switch" | "session_before_branch" | "session_before_compact" | "session_before_tree" {
-		return (
-			type === "session_before_switch" ||
-			type === "session_before_branch" ||
-			type === "session_before_compact" ||
-			type === "session_before_tree"
-		);
+	): type is "session_before_switch" | "session_before_branch" | "session_before_tree" {
+		return type === "session_before_switch" || type === "session_before_branch" || type === "session_before_tree";
 	}
 
 	/**
 	 * Emit an event to all hooks.
 	 * Returns the result from session before_* / tool_result events (if any handler returns one).
 	 */
-	async emit(
-		event: HookEvent,
-	): Promise<
-		SessionBeforeCompactResult | SessionBeforeTreeResult | SessionCompactingResult | ToolResultEventResult | undefined
-	> {
+	async emit(event: HookEvent): Promise<SessionBeforeTreeResult | ToolResultEventResult | undefined> {
 		const ctx = this.#createContext();
-		let result:
-			| SessionBeforeCompactResult
-			| SessionBeforeTreeResult
-			| SessionCompactingResult
-			| ToolResultEventResult
-			| undefined;
+		let result: SessionBeforeTreeResult | ToolResultEventResult | undefined;
 
 		for (const hook of this.hooks) {
 			const handlers = hook.handlers.get(event.type);
@@ -306,7 +290,7 @@ export class HookRunner {
 
 					// For session before_* events, capture the result (for cancellation)
 					if (this.#isSessionBeforeEvent(event.type) && handlerResult) {
-						result = handlerResult as SessionBeforeCompactResult | SessionBeforeTreeResult;
+						result = handlerResult as SessionBeforeTreeResult;
 						// If cancelled, stop processing further hooks
 						if (result.cancel) {
 							return result;
@@ -317,9 +301,6 @@ export class HookRunner {
 					if (event.type === "tool_result" && handlerResult) {
 						result = handlerResult as ToolResultEventResult;
 					}
-					if (event.type === "session.compacting" && handlerResult) {
-						result = handlerResult as SessionCompactingResult;
-					}
 				} catch (err) {
 					const message = err instanceof Error ? err.message : String(err);
 					this.emitError({

package/src/extensibility/hooks/types.ts

@@ -11,11 +11,9 @@ import type { Rule } from "../../capability/rule";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { EditToolDetails } from "../../patch";
-import type { CompactionPreparation, CompactionResult } from "../../session/compaction";
 import type { HookMessage } from "../../session/messages";
 import type {
 	BranchSummaryEntry,
-	CompactionEntry,
 	ReadonlySessionManager,
 	SessionEntry,
 	SessionManager,
@@ -249,34 +247,6 @@ export interface SessionBranchEvent {
 	previousSessionFile: string | undefined;
 }
 
-/** Fired before context compaction (can be cancelled) */
-export interface SessionBeforeCompactEvent {
-	type: "session_before_compact";
-	/** Compaction preparation with messages to summarize, file ops, previous summary, etc. */
-	preparation: CompactionPreparation;
-	/** Branch entries (root to current leaf). Use to inspect custom state or previous compactions. */
-	branchEntries: SessionEntry[];
-	/** Optional user-provided instructions for the summary */
-	customInstructions?: string;
-	/** Abort signal - hooks should pass this to LLM calls and check it periodically */
-	signal: AbortSignal;
-}
-
-/** Fired before compaction summarization to customize prompts/context */
-export interface SessionCompactingEvent {
-	type: "session.compacting";
-	sessionId: string;
-	messages: AgentMessage[];
-}
-
-/** Fired after context compaction */
-export interface SessionCompactEvent {
-	type: "session_compact";
-	compactionEntry: CompactionEntry;
-	/** Whether the compaction entry was provided by a hook */
-	fromExtension: boolean;
-}
-
 /** Fired on process exit (SIGINT/SIGTERM) */
 export interface SessionShutdownEvent {
 	type: "session_shutdown";
@@ -290,7 +260,7 @@ export interface TreePreparation {
 	oldLeafId: string | null;
 	/** Common ancestor of target and old leaf, null if no common ancestor */
 	commonAncestorId: string | null;
-	/** Entries to summarize (old leaf back to common ancestor or compaction) */
+	/** Entries to summarize (old leaf back to common ancestor) */
 	entriesToSummarize: SessionEntry[];
 	/** Whether user chose to summarize */
 	userWantsSummary: boolean;
@@ -325,9 +295,6 @@ export type SessionEvent =
 	| SessionSwitchEvent
 	| SessionBeforeBranchEvent
 	| SessionBranchEvent
-	| SessionBeforeCompactEvent
-	| SessionCompactingEvent
-	| SessionCompactEvent
 	| SessionShutdownEvent
 	| SessionBeforeTreeEvent
 	| SessionTreeEvent;
@@ -391,21 +358,6 @@ export interface TurnEndEvent {
 	toolResults: ToolResultMessage[];
 }
 
-/** Event data for auto_compaction_start event. */
-export interface AutoCompactionStartEvent {
-	type: "auto_compaction_start";
-	reason: "threshold" | "overflow";
-}
-
-/** Event data for auto_compaction_end event. */
-export interface AutoCompactionEndEvent {
-	type: "auto_compaction_end";
-	result: CompactionResult | undefined;
-	aborted: boolean;
-	willRetry: boolean;
-	errorMessage?: string;
-}
-
 /** Event data for auto_retry_start event. */
 export interface AutoRetryStartEvent {
 	type: "auto_retry_start";
@@ -533,8 +485,6 @@ export type HookEvent =
 	| AgentEndEvent
 	| TurnStartEvent
 	| TurnEndEvent
-	| AutoCompactionStartEvent
-	| AutoCompactionEndEvent
 	| AutoRetryStartEvent
 	| AutoRetryEndEvent
 	| TtsrTriggeredEvent
@@ -616,24 +566,6 @@ export interface SessionBeforeBranchResult {
 	skipConversationRestore?: boolean;
 }
 
-/** Return type for session_before_compact handlers */
-export interface SessionBeforeCompactResult {
-	/** If true, cancel the compaction */
-	cancel?: boolean;
-	/** Custom compaction result - SessionManager adds id/parentId */
-	compaction?: CompactionResult;
-}
-
-/** Return type for session.compacting handlers */
-export interface SessionCompactingResult {
-	/** Additional context lines to include in summary */
-	context?: string[];
-	/** Override the default compaction prompt */
-	prompt?: string;
-	/** Custom data to store in compaction entry */
-	preserveData?: Record<string, unknown>;
-}
-
 /** Return type for session_before_tree handlers */
 export interface SessionBeforeTreeResult {
 	/** If true, cancel the navigation entirely */
@@ -695,12 +627,6 @@ export interface HookAPI {
 	on(event: "session_switch", handler: HookHandler<SessionSwitchEvent>): void;
 	on(event: "session_before_branch", handler: HookHandler<SessionBeforeBranchEvent, SessionBeforeBranchResult>): void;
 	on(event: "session_branch", handler: HookHandler<SessionBranchEvent>): void;
-	on(
-		event: "session_before_compact",
-		handler: HookHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>,
-	): void;
-	on(event: "session.compacting", handler: HookHandler<SessionCompactingEvent, SessionCompactingResult>): void;
-	on(event: "session_compact", handler: HookHandler<SessionCompactEvent>): void;
 	on(event: "session_shutdown", handler: HookHandler<SessionShutdownEvent>): void;
 	on(event: "session_before_tree", handler: HookHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): void;
 	on(event: "session_tree", handler: HookHandler<SessionTreeEvent>): void;
@@ -712,8 +638,6 @@ export interface HookAPI {
 	on(event: "agent_end", handler: HookHandler<AgentEndEvent>): void;
 	on(event: "turn_start", handler: HookHandler<TurnStartEvent>): void;
 	on(event: "turn_end", handler: HookHandler<TurnEndEvent>): void;
-	on(event: "auto_compaction_start", handler: HookHandler<AutoCompactionStartEvent>): void;
-	on(event: "auto_compaction_end", handler: HookHandler<AutoCompactionEndEvent>): void;
 	on(event: "auto_retry_start", handler: HookHandler<AutoRetryStartEvent>): void;
 	on(event: "auto_retry_end", handler: HookHandler<AutoRetryEndEvent>): void;
 	on(event: "ttsr_triggered", handler: HookHandler<TtsrTriggeredEvent>): void;