@xopcai/xopc 0.0.169 → 0.0.171

package/dist/src/gateway/hono/routes/sessions.js

@@ -5,7 +5,6 @@ import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runn
 import { messagesToClientHistory } from "../../../session/client-history.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../../media/session-references.js";
 import { createGatewayRouteLogger, logRouteError } from "../lib/route-logger.js";
-import { computeUserRoundDeleteRange } from "../../../session/user-round-delete.js";
 import { respondStartupUnavailable } from "../lib/startup-unavailable.js";
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/sessions.ts
@@ -35,6 +34,10 @@ function parseOffset(value) {
 	const parsed = value ? Number.parseInt(value, 10) : 0;
 	return Number.isFinite(parsed) ? Math.max(0, parsed) : 0;
 }
+function isHistoryCursor(value) {
+	if (!/^(0|[1-9]\d*)$/.test(value)) return false;
+	return Number.isSafeInteger(Number(value));
+}
 function buildDirectSessionMetadata(params) {
 	return {
 		sourceChannel: params.source,
@@ -268,7 +271,12 @@ function registerSessionsRoutes(authenticated, deps) {
 		const limitRaw = c.req.query("limit");
 		const parsedLimit = limitRaw ? Number.parseInt(limitRaw, 10) : void 0;
 		const limit = parsedLimit !== void 0 && Number.isFinite(parsedLimit) ? Math.min(500, Math.max(1, parsedLimit)) : void 0;
-		const before = c.req.query("before")?.trim();
+		const beforeRaw = c.req.query("before");
+		const before = beforeRaw?.trim();
+		if (beforeRaw !== void 0 && (!before || !isHistoryCursor(before))) return c.json({
+			ok: false,
+			error: "Invalid session history cursor"
+		}, 400);
 		const offsetRaw = c.req.query("offset");
 		const parsedOffset = offsetRaw ? Number.parseInt(offsetRaw, 10) : 0;
 		const offset = Number.isFinite(parsedOffset) ? Math.max(0, parsedOffset) : 0;
@@ -294,7 +302,9 @@ function registerSessionsRoutes(authenticated, deps) {
 		const key = c.req.param("key");
 		const offsetRaw = c.req.query("offset");
 		const limitRaw = c.req.query("limit");
-		const before = c.req.query("before")?.trim();
+		const beforeRaw = c.req.query("before");
+		const before = beforeRaw?.trim();
+		if (beforeRaw !== void 0 && (!before || !isHistoryCursor(before))) return c.json({ error: "Invalid session history cursor" }, 400);
 		const parsedOffset = offsetRaw ? Number.parseInt(offsetRaw, 10) : 0;
 		const parsedLimit = limitRaw ? Number.parseInt(limitRaw, 10) : 50;
 		const offset = Number.isFinite(parsedOffset) ? Math.max(0, parsedOffset) : 0;
@@ -448,48 +458,35 @@ function registerSessionsRoutes(authenticated, deps) {
 		evictEmbeddedSessionRunner(key, "gateway_bash_execution_appended");
 		return c.json({ ok: true });
 	});
-	authenticated.get("/api/sessions/:key/compaction/checkpoints", async (c) => {
+	authenticated.get("/api/sessions/:key/compaction/boundaries", async (c) => {
 		const key = c.req.param("key");
 		if (!await service.sessionIndexInstance.getSessionMetadata(key)) return c.json({
 			ok: false,
 			error: "Session not found"
 		}, 404);
-		const checkpoints = await service.sessions.listCompactionCheckpoints(key);
+		const boundaries = await service.sessions.listCompactionBoundaries(key);
 		return c.json({
 			ok: true,
-			payload: { checkpoints }
-		});
-	});
-	authenticated.get("/api/sessions/:key/compaction/checkpoints/:checkpointId", async (c) => {
-		const key = c.req.param("key");
-		const checkpointId = c.req.param("checkpointId");
-		const checkpoint = await service.sessions.getCompactionCheckpoint(key, checkpointId);
-		if (!checkpoint) return c.json({
-			ok: false,
-			error: "Checkpoint not found"
-		}, 404);
-		return c.json({
-			ok: true,
-			payload: { checkpoint }
+			payload: { boundaries }
 		});
 	});
 	authenticated.post("/api/sessions/:key/compaction/restore", async (c) => {
 		const key = c.req.param("key");
 		const body = await c.req.json().catch(() => ({}));
-		const checkpointId = typeof body.checkpointId === "string" ? body.checkpointId.trim() : "";
-		if (!checkpointId) return c.json({
+		const compactionId = typeof body.compactionId === "string" ? body.compactionId.trim() : "";
+		if (!compactionId) return c.json({
 			ok: false,
-			error: "checkpointId required"
+			error: "compactionId required"
 		}, 400);
 		try {
-			await service.sessions.restoreCompactionCheckpoint(key, checkpointId);
+			await service.sessions.restoreBeforeCompactionBoundary(key, compactionId);
 		} catch (err) {
 			logRouteError(log, c, err, "gateway.route.sessions", {
-				operation: "restoreCheckpoint",
+				operation: "restoreCompactionBoundary",
 				sessionKey: key
 			});
 			const msg = err instanceof Error ? err.message : String(err);
-			if (msg.includes("not found") || msg.includes("Invalid")) return c.json({
+			if (msg.includes("not found")) return c.json({
 				ok: false,
 				error: msg
 			}, 404);
@@ -684,30 +681,19 @@ function registerSessionsRoutes(authenticated, deps) {
 	authenticated.delete("/api/sessions/:key/messages", async (c) => {
 		const key = c.req.param("key");
 		const body = await c.req.json().catch(() => ({}));
-		const loaded = await service.sessionIndexInstance.loadMessages(key);
-		if (!loaded) return c.json({ error: "Session not found" }, 404);
-		let startIndex = typeof body.startIndex === "number" ? body.startIndex : -1;
-		let count = typeof body.count === "number" ? body.count : 0;
 		const userRoundIndex = typeof body.userRoundIndex === "number" ? body.userRoundIndex : void 0;
-		if (userRoundIndex !== void 0) {
-			const range = computeUserRoundDeleteRange(loaded, userRoundIndex);
-			if (!range) return c.json({ error: "User round index out of range" }, 400);
-			startIndex = range.startIndex;
-			count = range.count;
-		}
-		if (startIndex < 0 || count <= 0) return c.json({ error: "Invalid startIndex or count" }, 400);
-		if (startIndex >= loaded.length) return c.json({ error: "Index out of range" }, 400);
-		const deleteCount = Math.min(count, loaded.length - startIndex);
-		const removed = loaded.slice(startIndex, startIndex + deleteCount);
-		const next = loaded.slice(0, startIndex).concat(loaded.slice(startIndex + deleteCount));
-		await service.sessionIndexInstance.saveMessages(key, next);
+		if (userRoundIndex === void 0 || !Number.isInteger(userRoundIndex) || userRoundIndex < 0) return c.json({ error: "userRoundIndex must be a non-negative integer" }, 400);
+		const result = await service.sessionIndexInstance.deleteUserRound(key, userRoundIndex);
+		if (!result) return c.json({ error: "User round index out of range" }, 400);
 		await deleteMediaUrisNoLongerReferenced({
-			removed,
-			remaining: next
+			removed: result.removedMessages,
+			remaining: result.remainingMessages
 		});
+		evictEmbeddedSessionRunner(key, "gateway_user_round_deleted");
+		service.agentService.evictSessionAgent(key);
 		return c.json({
 			ok: true,
-			deleted: deleteCount
+			deleted: result.deleted
 		});
 	});
 	authenticated.post("/api/sessions/:key/reset", async (c) => {

package/dist/src/gateway/service/sessions-api.d.ts

@@ -92,9 +92,8 @@ export declare class GatewaySessionsApi {
         verboseLevel?: string;
         workingDirectory?: string;
     }): Promise<import("../../agent/session/session-config-service.js").PatchSessionAgentConfigResult>;
-    listCompactionCheckpoints(key: string): Promise<import("../../session/types.js").CompactionCheckpointSummary[]>;
-    getCompactionCheckpoint(key: string, checkpointId: string): Promise<import("../../session/types.js").CompactionCheckpointDetail>;
-    restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void>;
+    listCompactionBoundaries(key: string): Promise<import("../../session/types.js").CompactionBoundarySummary[]>;
+    restoreBeforeCompactionBoundary(key: string, compactionId: string): Promise<void>;
     runCompaction(key: string, options?: {
         instructions?: string;
         force?: boolean;

package/dist/src/gateway/service/sessions-api.js

@@ -53,11 +53,11 @@ var GatewaySessionsApi = class {
 	}
 	async getTimeline(key) {
 		if (!await this.opts.sessionIndex.getSessionMetadata(key)) return null;
-		return buildSessionTimeline(await this.opts.sessionIndex.getStore().loadTranscriptRows(key));
+		return buildSessionTimeline(await this.opts.sessionIndex.getStore().loadTranscriptHistoryRows(key));
 	}
 	async getTranscriptWindow(key, options) {
 		if (!await this.opts.sessionIndex.getSessionMetadata(key)) return null;
-		const rows = await this.opts.sessionIndex.getStore().loadTranscriptRows(key);
+		const rows = await this.opts.sessionIndex.getStore().loadTranscriptHistoryRows(key);
 		const totalRows = rows.length;
 		if (totalRows === 0) return {
 			messages: [],
@@ -93,14 +93,11 @@ var GatewaySessionsApi = class {
 	patchAgentConfig(sessionKey, body) {
 		return this.opts.getAgentService().sessionConfig.patch(sessionKey, body);
 	}
-	listCompactionCheckpoints(key) {
-		return this.opts.sessionIndex.listCompactionCheckpoints(key);
+	listCompactionBoundaries(key) {
+		return this.opts.sessionIndex.listCompactionBoundaries(key);
 	}
-	getCompactionCheckpoint(key, checkpointId) {
-		return this.opts.sessionIndex.getCompactionCheckpointDetail(key, checkpointId);
-	}
-	async restoreCompactionCheckpoint(key, checkpointId) {
-		await this.opts.sessionIndex.restoreCompactionCheckpoint(key, checkpointId);
+	async restoreBeforeCompactionBoundary(key, compactionId) {
+		await this.opts.sessionIndex.restoreBeforeCompactionBoundary(key, compactionId);
 		this.opts.getAgentService().evictSessionAgent(key);
 	}
 	async runCompaction(key, options) {

package/dist/src/session/index.d.ts

@@ -6,8 +6,7 @@ export { SessionConfigStore, resolveThinkingLevel, resolveReasoningLevel, resolv
 export { resolveEffectiveThinkingLevel, resolveEffectiveReasoningLevel } from './thinking-resolve.js';
 export type { SessionAgentConfig } from './config-types.js';
 export { normalizeWorkingDirectoryInput, effectiveWorkspacePathForSession, projectWorkspacePath, } from './session-workspace.js';
-export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, type SessionTranscriptSummary, type CompactionCheckpointSummary, type CompactionCheckpointDetail, } from './types.js';
-export { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';
+export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, type SessionTranscriptSummary, type CompactionBoundarySummary, } from './types.js';
 export { shouldSkipWebchatInboundByAbortCutoff } from './abort-cutoff.js';
 export { DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_IDLE_MINUTES, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy, type SessionFreshness, type SessionResetConfig, type SessionResetMode, type SessionResetPolicy, type SessionResetType, } from './reset-policy.js';
 export { resolveChannelResetConfig, resolveSessionResetType, } from './reset-type.js';

package/dist/src/session/index.js

@@ -3,7 +3,6 @@ import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPr
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "./session-workspace.js";
 import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
 import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm } from "./session-title.js";
-import { normalizeCompactionCheckpointId } from "./compaction-checkpoints.js";
 import { flattenMessageContent, messagesToClientHistory } from "./client-history.js";
 import { SessionStore } from "./store.js";
 import { applySessionPatchToMetadata } from "./patch-metadata.js";
@@ -18,4 +17,4 @@ import { resolveSession, resolveSessionKeyForRequest } from "./resolve-session.j
 import { DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, bareResetAckMessage, matchResetTriggers, resolveResetTriggers, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp } from "./reset-triggers.js";
 import { initSessionTurn } from "./init-session-turn.js";
 import { CURRENT_SESSION_TRANSCRIPT_VERSION, XOPC_SESSION_TRANSCRIPT_TYPE } from "./transcript-format.js";
-export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, projectWorkspacePath, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };
+export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, projectWorkspacePath, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };

package/dist/src/session/init-session-turn.d.ts

@@ -19,6 +19,5 @@ export type InitSessionTurnOptions = {
     sessionKey: string;
     body?: string;
     resetSession: SessionResetFn;
-    skipImplicitExpiry?: boolean;
 };
 export declare function initSessionTurn(opts: InitSessionTurnOptions): Promise<InitSessionTurnResult>;

package/dist/src/session/init-session-turn.js

@@ -50,8 +50,7 @@ async function initSessionTurn(opts) {
 		now,
 		policy: resetPolicy
 	}) : { fresh: false };
-	const skipImplicit = opts.skipImplicitExpiry ?? false;
-	const staleRollover = Boolean(sessionMetadata && !skipImplicit && !freshness.fresh);
+	const staleRollover = Boolean(sessionMetadata && resetPolicy.configured === true && !freshness.fresh);
 	const needsRollover = triggerMatch.resetTriggered || staleRollover;
 	let sessionId = sessionMetadata?.sessionId;
 	let previousSessionId;

package/dist/src/session/manager.d.ts

@@ -1,9 +1,10 @@
 import EventEmitter from 'events';
+import type { Api, Model } from '@earendil-works/pi-ai/compat';
 import { SessionStore } from './store.js';
 import type { SessionMetadata, SessionDetail, SessionListQuery, PaginatedResult, GlobalSessionStats, ExportFormat, SessionStatus } from './types.js';
 import type { SessionMetadataSeed } from '../storage/sqlite/index.js';
 import type { Message } from './types.js';
-import type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
+import type { CompactionConfig, CompactionExecutionOptions, CompactionResult } from '../agent/memory/compaction.js';
 import type { XopcSessionTranscriptV1 } from './transcript-format.js';
 import type { XopcTranscriptContextEntry } from './session-context-for-llm.js';
 import { type SessionPatchBody } from './patch-metadata.js';
@@ -129,6 +130,11 @@ export declare class SessionIndex extends EventEmitter {
     saveMessages(key: string, messages: any[], options?: {
         metadata?: SessionMetadataSeed;
     }): Promise<void>;
+    deleteUserRound(key: string, userRoundIndex: number): Promise<{
+        deleted: number;
+        removedMessages: import("@earendil-works/pi-agent-core").AgentMessage[];
+        remainingMessages: import("@earendil-works/pi-agent-core").AgentMessage[];
+    }>;
     /**
      * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
      */
@@ -172,29 +178,17 @@ export declare class SessionIndex extends EventEmitter {
         tool: number;
         needsTrim: boolean;
     };
-    /** Prepare compaction run */
-    prepareCompaction(key: string, messages: any[], contextWindow: number): {
-        needsCompaction: boolean;
-        messages: import("@earendil-works/pi-agent-core").AgentMessage[];
-        stats: {
-            needed: boolean;
-            reason: string;
-            usagePercent?: number;
-        };
-    };
     /** Compact session messages */
-    compact(key: string, messages: any[], contextWindow: number, instructions?: string, force?: boolean): Promise<CompactionResult>;
+    compact(key: string, messages: any[], model: Model<Api>, instructions?: string, force?: boolean, executionOptions?: CompactionExecutionOptions): Promise<CompactionResult>;
     /** Compaction stats for a session */
     getCompactionStats(key: string): Promise<{
         compactionCount: number;
         totalTokensBefore: number;
         totalTokensAfter: number;
-        lastCompactionAt: any;
+        lastCompactionAt: string;
     }>;
-    /** List pre-compaction transcript snapshots (newest first). */
-    listCompactionCheckpoints(key: string): Promise<import("./types.js").CompactionCheckpointSummary[]>;
-    getCompactionCheckpointDetail(key: string, checkpointId: string): Promise<import("./types.js").CompactionCheckpointDetail>;
-    restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void>;
+    listCompactionBoundaries(key: string): Promise<import("./types.js").CompactionBoundarySummary[]>;
+    restoreBeforeCompactionBoundary(key: string, compactionId: string): Promise<void>;
     /** Estimate token usage for messages */
     estimateTokenUsage(key: string, messages: any[]): Promise<number>;
 }

package/dist/src/session/manager.js

@@ -224,6 +224,11 @@ var SessionIndex = class extends EventEmitter$1 {
 	async saveMessages(key, messages, options) {
 		return this.store.saveMessages(key, messages, options);
 	}
+	async deleteUserRound(key, userRoundIndex) {
+		const result = await this.store.deleteUserRound(key, userRoundIndex);
+		if (result) this.emit("sessionUpdated", { key });
+		return result;
+	}
 	/**
 	* Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
 	*/
@@ -261,27 +266,19 @@ var SessionIndex = class extends EventEmitter$1 {
 	getWindowStats(messages) {
 		return this.store.getWindowStats(messages);
 	}
-	/** Prepare compaction run */
-	prepareCompaction(key, messages, contextWindow) {
-		return this.store.prepareCompaction(key, messages, contextWindow);
-	}
 	/** Compact session messages */
-	compact(key, messages, contextWindow, instructions, force) {
-		return this.store.compact(key, messages, contextWindow, instructions, force);
+	compact(key, messages, model, instructions, force, executionOptions) {
+		return this.store.compact(key, messages, model, instructions, force, executionOptions);
 	}
 	/** Compaction stats for a session */
 	async getCompactionStats(key) {
 		return this.store.getCompactionStats(key);
 	}
-	/** List pre-compaction transcript snapshots (newest first). */
-	listCompactionCheckpoints(key) {
-		return this.store.listCompactionCheckpoints(key);
-	}
-	getCompactionCheckpointDetail(key, checkpointId) {
-		return this.store.getCompactionCheckpointDetail(key, checkpointId);
+	listCompactionBoundaries(key) {
+		return this.store.listCompactionBoundaries(key);
 	}
-	restoreCompactionCheckpoint(key, checkpointId) {
-		return this.store.restoreCompactionCheckpoint(key, checkpointId);
+	restoreBeforeCompactionBoundary(key, compactionId) {
+		return this.store.restoreBeforeCompactionBoundary(key, compactionId);
 	}
 	/** Estimate token usage for messages */
 	async estimateTokenUsage(key, messages) {

package/dist/src/session/reset-policy.js

@@ -14,12 +14,10 @@ function resolveSessionResetPolicy(params) {
 	const sessionCfg = params.sessionCfg;
 	const baseReset = params.resetOverride ?? sessionCfg?.reset;
 	const typeReset = params.resetOverride ? void 0 : sessionCfg?.resetByType?.[params.resetType];
-	const hasExplicitReset = Boolean(baseReset || sessionCfg?.resetByType);
-	const legacyIdleMinutes = params.resetOverride ? void 0 : sessionCfg?.idleMinutes;
-	const configured = Boolean(baseReset || typeReset || legacyIdleMinutes != null);
-	const mode = typeReset?.mode ?? baseReset?.mode ?? (!hasExplicitReset && legacyIdleMinutes != null ? "idle" : "daily");
+	const configured = Boolean(baseReset || typeReset);
+	const mode = typeReset?.mode ?? baseReset?.mode ?? "daily";
 	const atHour = normalizeResetAtHour(typeReset?.atHour ?? baseReset?.atHour ?? 4);
-	const idleMinutesRaw = typeReset?.idleMinutes ?? baseReset?.idleMinutes ?? legacyIdleMinutes;
+	const idleMinutesRaw = typeReset?.idleMinutes ?? baseReset?.idleMinutes;
 	let idleMinutes;
 	if (idleMinutesRaw != null) {
 		const normalized = Math.floor(idleMinutesRaw);

package/dist/src/session/session-context-for-llm.d.ts

@@ -68,6 +68,21 @@ export interface XopcTranscriptCompactionSummaryEntry {
     tokensBefore?: number;
     timestamp?: string | number;
 }
+/** Append-only compaction boundary containing the exact LLM context at that point. */
+export interface XopcTranscriptCompactionEntry {
+    type: 'compaction';
+    at: string;
+    baseSeq: number;
+    plannerVersion: number;
+    summaryModelRef: string;
+    qualityAudit: 'passed' | 'disabled';
+    summary: string;
+    messages: AgentMessage[];
+    firstKeptIndex: number;
+    tokensBefore: number;
+    tokensAfter: number;
+    restoredFromCompactionId?: string;
+}
 /** Persisted label change for a transcript entry. */
 export interface XopcTranscriptLabelEntry {
     type: 'label';
@@ -102,14 +117,17 @@ export interface XopcTranscriptSessionInfoEntry {
     name?: string;
     timestamp?: string | number;
 }
-export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry | XopcTranscriptBashExecutionEntry | XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry | XopcTranscriptCustomStateEntry | XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry | XopcTranscriptLabelEntry | XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
+export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry | XopcTranscriptBashExecutionEntry | XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry | XopcTranscriptCustomStateEntry | XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry | XopcTranscriptCompactionEntry | XopcTranscriptLabelEntry | XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
 export declare function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry;
 export declare function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry;
 export declare function isTranscriptCustomMessageEntry(x: unknown): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry;
 export declare function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry;
 export declare function isTranscriptSummaryMessageEntry(x: unknown): x is XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry;
+export declare function isTranscriptCompactionEntry(x: unknown): x is XopcTranscriptCompactionEntry;
 export declare function isTranscriptLabelEntry(x: unknown): x is XopcTranscriptLabelEntry;
 export declare function isTranscriptMetadataEntry(x: unknown): x is XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
+/** Runtime-derived messages are never authoritative transcript rows. */
+export declare function isRuntimeOnlyTranscriptMessage(x: unknown): boolean;
 /**
  * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).
  */