@caupulican/pi-agent-core 0.93.16 → 0.93.18

package/dist/compaction/compaction.d.ts

@@ -4,8 +4,8 @@
  * Pure functions for compaction logic. The session manager handles I/O,
  * and after compaction the session is reloaded.
  */
-import type { AssistantMessage, Context, Model, SimpleStreamOptions, Usage } from "@caupulican/pi-ai/types";
-import { type SessionEntry } from "../session/session-manager.ts";
+import type { AssistantMessage, CacheRetention, Context, Model, SimpleStreamOptions, Usage } from "@caupulican/pi-ai/types";
+import { type CompactionRetention, type SessionEntry } from "../session/session-manager.ts";
 import type { AgentMessage, StreamFn, ThinkingLevel } from "../types.ts";
 import { type CompactionFacts } from "./extraction.ts";
 import { type FileOperations } from "./utils.ts";
@@ -33,6 +33,8 @@ export interface CompactionResult<T = unknown> {
     summary: string;
     firstKeptEntryId: string;
     tokensBefore: number;
+    /** Sparse history retained when compaction atomically replaces the provider-visible session. */
+    retention?: CompactionRetention;
     /** Provider usage spent generating this checkpoint, including chunk and verification retries. */
     usage?: Usage;
     /** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */
@@ -43,6 +45,17 @@ export interface CompactionResult<T = unknown> {
 }
 /** Host-owned provider boundary for shared compaction request enforcement and accounting. */
 export type CompactionCompletion = (model: Model<any>, context: Context, options: SimpleStreamOptions) => Promise<AssistantMessage>;
+/** Existing provider-visible prefix reused by a session-replacement summary request. */
+export interface StructuredCompactionRequest {
+    context: Context;
+    sessionId: string;
+    cacheRetention: Exclude<CacheRetention, "none">;
+}
+export interface CompactionExecutionOptions {
+    chunked?: boolean;
+    completion?: CompactionCompletion;
+    structuredRequest?: StructuredCompactionRequest;
+}
 /**
  * Carry failed LLM verification attempts into the result that the retry ladder eventually applies.
  * Only bounded numeric/check identifiers are persisted in details; raw facts stay in the in-memory reports.
@@ -60,6 +73,8 @@ export interface CompactionSettings {
      * reserve-based behavior while large windows compact earlier. `0`/`1`+ disables the fractional cap.
      */
     triggerPercent?: number;
+    /** Provider-neutral request/history strategy selected by the host adapter. */
+    strategy?: "session-replacement";
 }
 export declare const DEFAULT_COMPACTION_SETTINGS: CompactionSettings;
 /**
@@ -161,8 +176,8 @@ export declare function findCutPoint(entries: SessionEntry[], startIndex: number
  *   the same message span across multiple attempts (a verification-gate retry), compute this once
  *   via {@link prepareSummarizationConversationText} and pass it to every attempt.
  */
-export declare function generateSummary(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, factsBlock?: string, chunked?: boolean, precomputedConversationText?: string, completion?: CompactionCompletion): Promise<string>;
-export declare function generateSummaryWithUsage(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, factsBlock?: string, chunked?: boolean, precomputedConversationText?: string, completion?: CompactionCompletion): Promise<{
+export declare function generateSummary(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, factsBlock?: string, chunked?: boolean, precomputedConversationText?: string, completion?: CompactionCompletion, structuredRequest?: StructuredCompactionRequest): Promise<string>;
+export declare function generateSummaryWithUsage(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, factsBlock?: string, chunked?: boolean, precomputedConversationText?: string, completion?: CompactionCompletion, structuredRequest?: StructuredCompactionRequest): Promise<{
     text: string;
     usage: Usage;
 }>;
@@ -191,6 +206,8 @@ export interface CompactionPreparation {
     tokensBefore: number;
     /** Summary from previous compaction, for iterative update */
     previousSummary?: string;
+    /** Sparse history contract persisted with a session-replacement checkpoint. */
+    retention?: CompactionRetention;
     /** File operations extracted from messagesToSummarize */
     fileOps: FileOperations;
     /** Facts extracted from the compacted span for verification gating */
@@ -208,9 +225,6 @@ export declare function prepareCompaction(pathEntries: SessionEntry[], settings:
  * @param preparation - Pre-calculated preparation from prepareCompaction()
  * @param customInstructions - Optional custom focus for the summary
  */
-export declare function compact(preparation: CompactionPreparation, model: Model<any>, apiKey: string | undefined, headers?: Record<string, string>, customInstructions?: string, signal?: AbortSignal, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, executionOptions?: {
-    chunked?: boolean;
-    completion?: CompactionCompletion;
-}): Promise<CompactionResult>;
+export declare function compact(preparation: CompactionPreparation, model: Model<any>, apiKey: string | undefined, headers?: Record<string, string>, customInstructions?: string, signal?: AbortSignal, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, preDigest?: (conversationText: string, signal?: AbortSignal) => Promise<string>, executionOptions?: CompactionExecutionOptions): Promise<CompactionResult>;
 export declare function createDeterministicCompaction(preparation: CompactionPreparation): CompactionResult;
 //# sourceMappingURL=compaction.d.ts.map

package/dist/compaction/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/compaction/compaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/compaction/compaction.ts"],"names":[],"mappings":"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"}

package/dist/compaction/compaction.js

@@ -7,8 +7,8 @@
 import { completeSimple } from "@caupulican/pi-ai/stream";
 import { uuidv7 } from "@caupulican/pi-ai/uuid";
 import { convertToLlm, createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, } from "../messages.js";
-import { ESTIMATED_IMAGE_CHARS } from "../provider-request-estimator.js";
-import { buildSessionContext } from "../session/session-manager.js";
+import { ESTIMATED_IMAGE_CHARS, estimateProviderRequestTokens } from "../provider-request-estimator.js";
+import { buildSessionContext, } from "../session/session-manager.js";
 import { addUsage, createEmptyUsage } from "../usage.js";
 import { ACTIVE_TASK_SOURCE_MAX_CHARS, extractCompactionFacts, mergePersistentCompactionUserFacts, renderFactsBlock, } from "./extraction.js";
 import { addPersistedFileOperations, computeFileLists, createFileOps, extractFileOpsFromMessage, isPlainRecord, SUMMARIZATION_PROMPT, SUMMARIZATION_SYSTEM_PROMPT, serializeConversation, UPDATE_SUMMARIZATION_PROMPT, } from "./utils.js";
@@ -445,22 +445,39 @@ export function findCutPoint(entries, startIndex, endIndex, keepRecentTokens) {
 // ============================================================================
 // Summarization
 // ============================================================================
-function createSummarizationOptions(model, maxTokens, apiKey, headers, signal, thinkingLevel) {
-    // Summaries are one-shot prompts. A fresh affinity identity prevents them from contaminating the
-    // foreground continuation cache, while "none" prevents cache writes that cannot be reused.
+function createSummarizationOptions(model, maxTokens, apiKey, headers, signal, thinkingLevel, affinity) {
+    // Standalone summaries are isolated one-shot prompts. A session-replacement request deliberately
+    // reuses the live affinity so the provider can reuse and validate the exact structured prefix.
     const options = {
         maxTokens,
         signal,
         apiKey,
         headers,
-        cacheRetention: "none",
-        sessionId: uuidv7(),
+        cacheRetention: affinity?.cacheRetention ?? "none",
+        sessionId: affinity?.sessionId ?? uuidv7(),
     };
     if (model.reasoning && thinkingLevel && thinkingLevel !== "off") {
         options.reasoning = thinkingLevel;
     }
     return options;
 }
+const STRUCTURED_SUMMARIZATION_CONTROL = `Create a replacement checkpoint for the conversation above.
+The preceding messages are source history; this final temporary message is control data and must not appear in the checkpoint.
+Do not continue the task and do not call tools. Return only the checkpoint.
+Preserve the owner's exact active request and prohibitions, durable decisions, paths, commands, errors, completed work, pending work, and immediate next step. Never include secrets, credentials, or tokens; write [REDACTED].`;
+function buildStructuredSummarizationContext(promptText, request) {
+    return {
+        ...request.context,
+        messages: [
+            ...request.context.messages,
+            {
+                role: "user",
+                content: [{ type: "text", text: `${STRUCTURED_SUMMARIZATION_CONTROL}\n\n${promptText}` }],
+                timestamp: Date.now(),
+            },
+        ],
+    };
+}
 async function completeSummarization(model, context, options, streamFn, completion) {
     if (completion)
         return completion(model, context, options);
@@ -470,6 +487,14 @@ async function completeSummarization(model, context, options, streamFn, completi
     const stream = await streamFn(model, context, options);
     return stream.result();
 }
+function accountAndValidateSummarization(response, usage, failureLabel) {
+    if (usage)
+        addUsage(usage, response.usage);
+    if (response.stopReason === "error") {
+        throw new Error(`${failureLabel} failed: ${response.errorMessage || "Unknown error"}`);
+    }
+    return response;
+}
 async function completeSummarizationPrompt(promptText, model, maxTokens, apiKey, headers, signal, thinkingLevel, streamFn, completion, usage, failureLabel = "Summarization") {
     const response = await completeSummarization(model, {
         systemPrompt: SUMMARIZATION_SYSTEM_PROMPT,
@@ -481,12 +506,19 @@ async function completeSummarizationPrompt(promptText, model, maxTokens, apiKey,
             },
         ],
     }, createSummarizationOptions(model, maxTokens, apiKey, headers, signal, thinkingLevel), streamFn, completion);
-    if (usage)
-        addUsage(usage, response.usage);
-    if (response.stopReason === "error") {
-        throw new Error(`${failureLabel} failed: ${response.errorMessage || "Unknown error"}`);
+    return accountAndValidateSummarization(response, usage, failureLabel);
+}
+async function completeStructuredSummarizationPrompt(context, request, model, maxTokens, apiKey, headers, signal, thinkingLevel, streamFn, completion, usage) {
+    const response = await completeSummarization(model, context, createSummarizationOptions(model, maxTokens, apiKey, headers, signal, thinkingLevel, request), streamFn, completion);
+    return accountAndValidateSummarization(response, usage, "Summarization");
+}
+function finalizeSummaryResponse(response, summaryBudget, usage) {
+    // A length-stopped checkpoint silently lost its tail sections — gating it as if complete
+    // guarantees a verification failure. Fail loudly so the compaction ladder escalates instead.
+    if (response.stopReason === "length") {
+        throw new Error("summary-length-stop: summarizer hit its output cap before completing the checkpoint");
     }
-    return response;
+    return { text: truncateSummaryToBudget(extractTextContent(response), summaryBudget), usage };
 }
 /**
  * Serialize messages to conversation text and, if a `preDigest` callback is supplied, run it
@@ -520,10 +552,10 @@ async function prepareSummarizationConversationText(currentMessages, preDigest,
  *   the same message span across multiple attempts (a verification-gate retry), compute this once
  *   via {@link prepareSummarizationConversationText} and pass it to every attempt.
  */
-export async function generateSummary(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock = "verification demands:\nfiles-modified-recall (must appear in ## Files):\nfiles-read-recall (must appear as exact paths in ## Files, path recall threshold applies):\nworking-set-recall (must appear in ## Working Set):\nopen-errors-recall (must appear in ## Open Problems):\nactions-recall (must appear in ## Done):\nmandatory-rules-recall (must appear in ### Mandatory Rules):\nactive-task-containment (must appear in ## Active Task):\ncancelled-work-dropped (must NOT appear outside ### Mandatory Rules):", chunked = false, precomputedConversationText, completion) {
-    return (await generateSummaryWithUsage(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock, chunked, precomputedConversationText, completion)).text;
+export async function generateSummary(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock = "verification demands:\nfiles-modified-recall (must appear in ## Files):\nfiles-read-recall (must appear as exact paths in ## Files, path recall threshold applies):\nworking-set-recall (must appear in ## Working Set):\nopen-errors-recall (must appear in ## Open Problems):\nactions-recall (must appear in ## Done):\nmandatory-rules-recall (must appear in ### Mandatory Rules):\nactive-task-containment (must appear in ## Active Task):\ncancelled-work-dropped (must NOT appear outside ### Mandatory Rules):", chunked = false, precomputedConversationText, completion, structuredRequest) {
+    return (await generateSummaryWithUsage(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock, chunked, precomputedConversationText, completion, structuredRequest)).text;
 }
-export async function generateSummaryWithUsage(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock = "verification demands:\nfiles-modified-recall (must appear in ## Files):\nfiles-read-recall (must appear as exact paths in ## Files, path recall threshold applies):\nworking-set-recall (must appear in ## Working Set):\nopen-errors-recall (must appear in ## Open Problems):\nactions-recall (must appear in ## Done):\nmandatory-rules-recall (must appear in ### Mandatory Rules):\nactive-task-containment (must appear in ## Active Task):\ncancelled-work-dropped (must NOT appear outside ### Mandatory Rules):", chunked = false, precomputedConversationText, completion) {
+export async function generateSummaryWithUsage(currentMessages, model, reserveTokens, apiKey, headers, signal, customInstructions, previousSummary, thinkingLevel, streamFn, preDigest, factsBlock = "verification demands:\nfiles-modified-recall (must appear in ## Files):\nfiles-read-recall (must appear as exact paths in ## Files, path recall threshold applies):\nworking-set-recall (must appear in ## Working Set):\nopen-errors-recall (must appear in ## Open Problems):\nactions-recall (must appear in ## Done):\nmandatory-rules-recall (must appear in ### Mandatory Rules):\nactive-task-containment (must appear in ## Active Task):\ncancelled-work-dropped (must NOT appear outside ### Mandatory Rules):", chunked = false, precomputedConversationText, completion, structuredRequest) {
     const usage = createEmptyUsage();
     const summaryBudget = getSummaryBudget(reserveTokens, model, factsBlock);
     const maxTokens = summaryBudget;
@@ -531,10 +563,20 @@ export async function generateSummaryWithUsage(currentMessages, model, reserveTo
     if (customInstructions) {
         promptSuffix = `${promptSuffix}\n\nAdditional focus: ${customInstructions}`;
     }
+    const inputBound = getSummarizerInputBound(model, maxTokens);
+    if (structuredRequest) {
+        const structuredContext = buildStructuredSummarizationContext(promptSuffix, structuredRequest);
+        if (estimateProviderRequestTokens(structuredContext, model) <= inputBound) {
+            const response = await completeStructuredSummarizationPrompt(structuredContext, structuredRequest, model, maxTokens, apiKey, headers, signal, thinkingLevel, streamFn, completion, usage);
+            return finalizeSummaryResponse(response, summaryBudget, usage);
+        }
+        if (!chunked) {
+            throw new Error("input-overflow: structured summarization request exceeds summarizer window");
+        }
+    }
     let conversationText = precomputedConversationText !== undefined
         ? precomputedConversationText
         : await prepareSummarizationConversationText(currentMessages, preDigest, signal);
-    const inputBound = getSummarizerInputBound(model, maxTokens);
     const initialPromptText = buildSummarizationPrompt(conversationText, previousSummary, promptSuffix);
     if (estimateStringTokens(initialPromptText) > inputBound) {
         if (!chunked) {
@@ -547,12 +589,7 @@ export async function generateSummaryWithUsage(currentMessages, model, reserveTo
         throw new Error("input-overflow: chunked summarization merge still exceeds summarizer window");
     }
     const response = await completeSummarizationPrompt(promptText, model, maxTokens, apiKey, headers, signal, thinkingLevel, streamFn, completion, usage);
-    // A length-stopped checkpoint silently lost its tail sections — gating it as if complete
-    // guarantees a verification failure. Fail loudly so the compaction ladder escalates instead.
-    if (response.stopReason === "length") {
-        throw new Error("summary-length-stop: summarizer hit its output cap before completing the checkpoint");
-    }
-    return { text: truncateSummaryToBudget(extractTextContent(response), summaryBudget), usage };
+    return finalizeSummaryResponse(response, summaryBudget, usage);
 }
 function fillPromptTemplate(template, factsBlock, budget) {
     return template.replaceAll("{FACTS_BLOCK}", factsBlock).replaceAll("{BUDGET}", String(budget));
@@ -716,7 +753,34 @@ export function prepareCompaction(pathEntries, settings, options) {
     const boundaryEnd = options?.allowTrailingCompactionAsPrevious && pathEntries[pathEntries.length - 1]?.type === "compaction"
         ? pathEntries.length - 1
         : pathEntries.length;
-    const tokensBefore = estimateContextTokens(buildSessionContext(pathEntries).messages).tokens;
+    const liveMessages = buildSessionContext(pathEntries).messages;
+    const tokensBefore = estimateContextTokens(liveMessages).tokens;
+    if (settings.strategy === "session-replacement") {
+        const previousRetention = prevCompactionIndex >= 0 ? pathEntries[prevCompactionIndex].retention : undefined;
+        const originalUserEntry = pathEntries.find((entry) => entry.type === "message" &&
+            entry.message.role === "user" &&
+            (previousRetention?.mode !== "original-user" || entry.id === previousRetention.userEntryId));
+        if (!originalUserEntry?.id)
+            return undefined;
+        const fileOps = extractFileOperations(liveMessages, pathEntries, prevCompactionIndex);
+        const factStart = prevCompactionIndex >= 0 ? prevCompactionIndex + 1 : 0;
+        let facts = extractCompactionFacts(pathEntries, factStart, boundaryEnd);
+        if (prevCompactionIndex >= 0) {
+            const persistedUserFacts = previousUserFacts ?? extractCompactionFacts(pathEntries, 0, boundaryEnd);
+            facts = mergePersistentCompactionUserFacts(facts, persistedUserFacts);
+        }
+        return {
+            firstKeptEntryId: originalUserEntry.id,
+            messagesToSummarize: liveMessages,
+            turnPrefixMessages: [],
+            isSplitTurn: false,
+            tokensBefore,
+            retention: { mode: "original-user", userEntryId: originalUserEntry.id },
+            fileOps,
+            facts,
+            settings,
+        };
+    }
     const cutPoint = findCutPoint(pathEntries, boundaryStart, boundaryEnd, settings.keepRecentTokens);
     // Get UUID of first kept entry
     const firstKeptEntry = pathEntries[cutPoint.firstKeptEntryIndex];
@@ -772,9 +836,11 @@ async function generateVerifiedSummary(options) {
     let retryInstructions = options.customInstructions;
     const usage = createEmptyUsage();
     const verificationGateFailures = [];
-    const precomputedConversationText = await prepareSummarizationConversationText(options.messages, options.preDigest, options.signal);
+    const precomputedConversationText = options.structuredRequest
+        ? undefined
+        : await prepareSummarizationConversationText(options.messages, options.preDigest, options.signal);
     for (let attempt = 0; attempt < 2; attempt++) {
-        const generated = await generateSummaryWithUsage(options.messages, options.model, options.reserveTokens, options.apiKey, options.headers, options.signal, retryInstructions, options.previousSummary, options.thinkingLevel, options.streamFn, options.preDigest, options.factsBlock, options.chunked, precomputedConversationText, options.completion);
+        const generated = await generateSummaryWithUsage(options.messages, options.model, options.reserveTokens, options.apiKey, options.headers, options.signal, retryInstructions, options.previousSummary, options.thinkingLevel, options.streamFn, options.preDigest, options.factsBlock, options.chunked, precomputedConversationText, options.completion, options.structuredRequest);
         addUsage(usage, generated.usage);
         const summary = generated.text;
         const verification = verifySummary(summary, options.facts);
@@ -810,7 +876,7 @@ async function generateVerifiedSummary(options) {
  * @param customInstructions - Optional custom focus for the summary
  */
 export async function compact(preparation, model, apiKey, headers, customInstructions, signal, thinkingLevel, streamFn, preDigest, executionOptions) {
-    const { firstKeptEntryId, messagesToSummarize, turnPrefixMessages, isSplitTurn, tokensBefore, previousSummary, fileOps, settings, facts: factsFromPreparation, } = preparation;
+    const { firstKeptEntryId, messagesToSummarize, turnPrefixMessages, isSplitTurn, tokensBefore, previousSummary, retention, fileOps, settings, facts: factsFromPreparation, } = preparation;
     const facts = factsFromPreparation ?? {
         files: [],
         workingSet: [],
@@ -834,6 +900,7 @@ export async function compact(preparation, model, apiKey, headers, customInstruc
         thinkingLevel,
         streamFn,
         completion: executionOptions?.completion,
+        structuredRequest: executionOptions?.structuredRequest,
         preDigest,
         facts,
         factsBlock,
@@ -852,6 +919,7 @@ export async function compact(preparation, model, apiKey, headers, customInstruc
         summary,
         firstKeptEntryId,
         tokensBefore,
+        retention,
         usage: summaryUsage,
         details: {
             readFiles,
@@ -867,7 +935,7 @@ export async function compact(preparation, model, apiKey, headers, customInstruc
     }, verified.verificationGateFailures);
 }
 export function createDeterministicCompaction(preparation) {
-    const { firstKeptEntryId, tokensBefore, fileOps, facts } = preparation;
+    const { firstKeptEntryId, tokensBefore, retention, fileOps, facts } = preparation;
     if (!firstKeptEntryId) {
         throw new Error("First kept entry has no UUID - session may need migration");
     }
@@ -935,6 +1003,7 @@ export function createDeterministicCompaction(preparation) {
         summary,
         firstKeptEntryId,
         tokensBefore,
+        retention,
         details: {
             readFiles,
             modifiedFiles,