@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/chat/engine/compaction/service.js

@@ -0,0 +1,189 @@
+import { estimateBuiltInContextWindow } from '../../../../core/llm/openai-models.js';
+import { DEFAULT_CONTEXT_WINDOW_ESTIMATE, MAX_HISTORY_RATIO, MAX_RECENT_HISTORY_RATIO, PREFERRED_FORCED_RECENT_MESSAGES, PREFERRED_RECENT_MESSAGES, } from './constants.js';
+import { ConversationCompactionContextBuilder } from './context-builder.js';
+import { ConversationArchiveSummarizer } from './summarizer/index.js';
+import { ConversationCompactionSplitPolicy } from './split-policy.js';
+import { ConversationCompactionSummaryMessage } from './summary-message.js';
+import { ConversationCompactionTokenEstimator } from './token-estimator.js';
+import { FileChatArchiveRepository } from '../../../../core/chat/engine/sessions/archives/index.js';
+/**
+ * Main compaction service.
+ *
+ * Owns archive-backed conversation history compaction. Supporting classes in
+ * this folder own token estimates, split policy, summary message rendering,
+ * summarizer prompting, and persisted context projection.
+ */
+export class ConversationCompactionService {
+    static async compact(options) {
+        const estimatedWindow = estimateBuiltInContextWindow(options.runtime.model) ?? DEFAULT_CONTEXT_WINDOW_ESTIMATE;
+        const maxHistoryTokens = Math.floor(estimatedWindow * MAX_HISTORY_RATIO);
+        const recentTokenBudget = ConversationCompactionSplitPolicy.resolveRecentHistoryTokenBudget(estimatedWindow, MAX_RECENT_HISTORY_RATIO);
+        const preferredRecentMessages = options.force ? PREFERRED_FORCED_RECENT_MESSAGES : PREFERRED_RECENT_MESSAGES;
+        const needsCompaction = ConversationCompactionTokenEstimator.estimateHistory(options.history) > maxHistoryTokens
+            || (Boolean(options.force) && ConversationCompactionTokenEstimator.countNonCompactedMessages(options.history) > 0);
+        if (!needsCompaction) {
+            return ConversationCompactionService.buildUnchangedResult(options);
+        }
+        const splitIndex = ConversationCompactionSplitPolicy.findSplit(options.history, {
+            recentTokenBudget,
+            preferredRecentMessages,
+            stopAtPreferredMessages: Boolean(options.force),
+        });
+        if (splitIndex <= 0 || splitIndex >= options.history.length) {
+            return ConversationCompactionService.buildUnchangedResult(options);
+        }
+        return await ConversationCompactionService.compactArchivedSlice({ options, splitIndex });
+    }
+    static estimateTokens(history) {
+        return ConversationCompactionTokenEstimator.estimateHistory(history);
+    }
+    static isCompactedHistorySummary(message) {
+        return ConversationCompactionSummaryMessage.isSummary(message);
+    }
+    static buildSessionRunningContext(options) {
+        return ConversationCompactionContextBuilder.buildSessionRunning(options);
+    }
+    static buildUnchangedResult(options) {
+        const archiveRepository = ConversationCompactionService.createArchiveRepository(options);
+        const manifest = archiveRepository.loadManifest();
+        const archive = {
+            archives: manifest.archives,
+            currentSummaryPath: manifest.currentSummaryPath,
+        };
+        return {
+            history: options.history,
+            context: ConversationCompactionContextBuilder.build({
+                history: options.history,
+                runtime: options.runtime,
+                request: options.request,
+                archive,
+            }),
+            archive,
+        };
+    }
+    static async compactArchivedSlice(args) {
+        const { options, splitIndex } = args;
+        const archivedMessages = options.history.slice(0, splitIndex);
+        const recentMessages = options.history.slice(splitIndex);
+        const archiveRepository = ConversationCompactionService.createArchiveRepository(options);
+        const manifest = archiveRepository.loadManifest();
+        const previousRollingSummary = (manifest.currentSummaryPath ? archiveRepository.readSummaryMarkdown(manifest.currentSummaryPath) : undefined)
+            ?? ConversationCompactionSummaryMessage.extractPriorSummary(options.history);
+        const archiveId = FileChatArchiveRepository.createArchiveId();
+        const archivePath = archiveRepository.writeMessagesJsonl(archiveId, archivedMessages);
+        options.onStatusChange?.({ status: 'running', archivePath });
+        try {
+            const summarizer = ConversationArchiveSummarizer.resolve(options);
+            if (!summarizer.llm) {
+                throw new Error(`Missing provider API key for ${summarizer.model}`);
+            }
+            const rollingSummary = await ConversationArchiveSummarizer.summarizeArchive({
+                runtime: { llm: summarizer.llm, model: summarizer.model },
+                summaryModel: summarizer.model,
+                sessionId: options.session.id,
+                archivePath,
+                manifest,
+                previousRollingSummary,
+                archivedMessages,
+            });
+            const summaryPath = archiveRepository.writeSummaryMarkdown(archiveId, rollingSummary);
+            const archiveRecord = ConversationCompactionService.buildArchiveRecord({
+                archiveId,
+                archivePath,
+                summaryPath,
+                rollingSummary,
+                archivedMessagesCount: ConversationCompactionTokenEstimator.countNonCompactedMessages(archivedMessages),
+                summaryModel: summarizer.model,
+            });
+            const nextManifest = FileChatArchiveRepository.appendManifestArchive(manifest, archiveRecord);
+            archiveRepository.saveManifest(nextManifest);
+            const compactedHistory = [
+                ConversationCompactionSummaryMessage.buildArchivedSummaryMessage({
+                    sessionId: options.session.id,
+                    rollingSummary,
+                    archives: nextManifest.archives,
+                }),
+                ...recentMessages,
+            ];
+            options.onStatusChange?.({
+                status: 'finished',
+                archivePath: archiveRecord.path,
+                summaryPath: archiveRecord.summaryPath,
+            });
+            return ConversationCompactionService.buildCompactedResult({
+                options,
+                compactedHistory,
+                archiveRecord,
+                archive: {
+                    archives: nextManifest.archives,
+                    currentSummaryPath: nextManifest.currentSummaryPath,
+                    lastArchivePath: archiveRecord.path,
+                },
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            options.onStatusChange?.({ status: 'failed', archivePath, error: message });
+            return ConversationCompactionService.buildFailedResult({
+                options,
+                message,
+                archive: {
+                    archives: manifest.archives,
+                    currentSummaryPath: manifest.currentSummaryPath,
+                    lastArchivePath: archivePath,
+                },
+            });
+        }
+    }
+    static buildArchiveRecord(args) {
+        return {
+            id: args.archiveId,
+            path: args.archivePath,
+            summaryPath: args.summaryPath,
+            shortDescription: ConversationArchiveSummarizer.deriveShortDescription(args.rollingSummary),
+            messageCount: args.archivedMessagesCount,
+            createdAt: new Date().toISOString(),
+            summaryModel: args.summaryModel,
+        };
+    }
+    static buildCompactedResult(args) {
+        return {
+            history: args.compactedHistory,
+            context: ConversationCompactionContextBuilder.build({
+                history: args.compactedHistory,
+                runtime: args.options.runtime,
+                request: args.options.request,
+                archive: args.archive,
+                completed: {
+                    ...args.archive,
+                    compactedMessages: args.archiveRecord.messageCount,
+                    compactedAt: args.archiveRecord.createdAt,
+                },
+            }),
+            archive: args.archive,
+        };
+    }
+    static buildFailedResult(args) {
+        return {
+            history: args.options.history,
+            context: ConversationCompactionContextBuilder.build({
+                history: args.options.history,
+                runtime: args.options.runtime,
+                request: args.options.request,
+                archive: args.archive,
+                status: {
+                    state: 'failed',
+                    error: args.message,
+                },
+            }),
+            archive: args.archive,
+        };
+    }
+    static createArchiveRepository(options) {
+        return new FileChatArchiveRepository({
+            stateRoot: options.runtime.stateRoot,
+            sessionId: options.session.id,
+        });
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/chat/engine/compaction/service.js.map

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

package/dist/src/core/chat/engine/compaction/split-policy.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage } from '../../../../core/llm/types.js';
+/**
+ * Chooses the archive/recent boundary without splitting tool-call pairs.
+ */
+export declare class ConversationCompactionSplitPolicy {
+    static resolveRecentHistoryTokenBudget(contextWindow: number, ratio: number): number;
+    static findSplit(history: ChatMessage[], options: {
+        recentTokenBudget: number;
+        preferredRecentMessages: number;
+        stopAtPreferredMessages?: boolean;
+    }): number;
+    private static isAssistantToolCallMessage;
+}
+//# sourceMappingURL=split-policy.d.ts.map

package/dist/src/core/chat/engine/compaction/split-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-policy.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/split-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD;;GAEG;AACH,qBAAa,iCAAiC;IAC5C,MAAM,CAAC,+BAA+B,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAOpF,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE;QAChD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,uBAAuB,EAAE,MAAM,CAAC;QAChC,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,MAAM;IA+CV,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAK1C"}

package/dist/src/core/chat/engine/compaction/split-policy.js

@@ -0,0 +1,52 @@
+import { MAX_RECENT_HISTORY_TOKEN_BUDGET, MIN_RECENT_HISTORY_TOKEN_BUDGET, } from './constants.js';
+import { ConversationCompactionTokenEstimator } from './token-estimator.js';
+/**
+ * Chooses the archive/recent boundary without splitting tool-call pairs.
+ */
+export class ConversationCompactionSplitPolicy {
+    static resolveRecentHistoryTokenBudget(contextWindow, ratio) {
+        return Math.max(MIN_RECENT_HISTORY_TOKEN_BUDGET, Math.min(MAX_RECENT_HISTORY_TOKEN_BUDGET, Math.floor(contextWindow * ratio)));
+    }
+    static findSplit(history, options) {
+        let splitIndex = history.length;
+        let recentTokens = 0;
+        let recentMessages = 0;
+        while (splitIndex > 0) {
+            if (options.stopAtPreferredMessages && recentMessages >= options.preferredRecentMessages) {
+                break;
+            }
+            const nextMessage = history[splitIndex - 1];
+            if (!nextMessage) {
+                break;
+            }
+            const nextTokens = ConversationCompactionTokenEstimator.estimateMessage(nextMessage);
+            const exceedsBudget = recentTokens + nextTokens > options.recentTokenBudget;
+            const reachedPreferredCount = recentMessages >= options.preferredRecentMessages;
+            if (recentMessages > 0 && exceedsBudget && reachedPreferredCount) {
+                break;
+            }
+            if (recentMessages > 0 && exceedsBudget && nextTokens > options.recentTokenBudget) {
+                break;
+            }
+            splitIndex--;
+            recentTokens += nextTokens;
+            if (!ConversationCompactionTokenEstimator.isCompactedSummary(nextMessage)) {
+                recentMessages++;
+            }
+            if (recentMessages >= options.preferredRecentMessages && recentTokens >= options.recentTokenBudget) {
+                break;
+            }
+        }
+        while (splitIndex > 0 && history[splitIndex]?.role === 'tool') {
+            splitIndex--;
+        }
+        if (splitIndex > 0 && ConversationCompactionSplitPolicy.isAssistantToolCallMessage(history[splitIndex - 1])) {
+            splitIndex--;
+        }
+        return splitIndex;
+    }
+    static isAssistantToolCallMessage(message) {
+        return message?.role === 'assistant' && !!message.toolCalls && message.toolCalls.length > 0;
+    }
+}
+//# sourceMappingURL=split-policy.js.map

package/dist/src/core/chat/engine/compaction/split-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-policy.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/split-policy.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,OAAO,iCAAiC;IAC5C,MAAM,CAAC,+BAA+B,CAAC,aAAqB,EAAE,KAAa;QACzE,OAAO,IAAI,CAAC,GAAG,CACb,+BAA+B,EAC/B,IAAI,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAsB,EAAE,OAIxC;QACC,IAAI,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAChC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,OAAO,UAAU,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,OAAO,CAAC,uBAAuB,IAAI,cAAc,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;gBACzF,MAAM;YACR,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YAED,MAAM,UAAU,GAAG,oCAAoC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;YACrF,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAC5E,MAAM,qBAAqB,GAAG,cAAc,IAAI,OAAO,CAAC,uBAAuB,CAAC;YAChF,IAAI,cAAc,GAAG,CAAC,IAAI,aAAa,IAAI,qBAAqB,EAAE,CAAC;gBACjE,MAAM;YACR,CAAC;YACD,IAAI,cAAc,GAAG,CAAC,IAAI,aAAa,IAAI,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAClF,MAAM;YACR,CAAC;YAED,UAAU,EAAE,CAAC;YACb,YAAY,IAAI,UAAU,CAAC;YAC3B,IAAI,CAAC,oCAAoC,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1E,cAAc,EAAE,CAAC;YACnB,CAAC;YAED,IAAI,cAAc,IAAI,OAAO,CAAC,uBAAuB,IAAI,YAAY,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBACnG,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9D,UAAU,EAAE,CAAC;QACf,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,IAAI,iCAAiC,CAAC,0BAA0B,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5G,UAAU,EAAE,CAAC;QACf,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,MAAM,CAAC,0BAA0B,CACvC,OAAgC;QAEhC,OAAO,OAAO,EAAE,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/summarizer/context-builder.d.ts

@@ -0,0 +1,9 @@
+import type { ChatMessage } from '../../../../../core/llm/types.js';
+import type { ConversationArchiveSummaryContext } from './types.js';
+/**
+ * Builds the exact prompt context the archive summarizer needs.
+ */
+export declare class ConversationArchiveSummarizerContextBuilder {
+    static build(context: ConversationArchiveSummaryContext): ChatMessage[];
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/core/chat/engine/compaction/summarizer/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAEpE;;GAEG;AACH,qBAAa,2CAA2C;IACtD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iCAAiC,GAAG,WAAW,EAAE;CA4BxE"}

package/dist/src/core/chat/engine/compaction/summarizer/context-builder.js

@@ -0,0 +1,35 @@
+import { CompactionTranscriptRenderer } from '../transcript-renderer.js';
+import { CONVERSATION_ARCHIVE_SUMMARIZER_SYSTEM_PROMPT } from './prompt.js';
+/**
+ * Builds the exact prompt context the archive summarizer needs.
+ */
+export class ConversationArchiveSummarizerContextBuilder {
+    static build(context) {
+        const transcript = CompactionTranscriptRenderer.render(context.archivedMessages, context.summaryModel);
+        return [
+            {
+                role: 'system',
+                content: CONVERSATION_ARCHIVE_SUMMARIZER_SYSTEM_PROMPT,
+            },
+            {
+                role: 'user',
+                content: [
+                    `Session: ${context.sessionId}`,
+                    `New archive path: ${context.archivePath}`,
+                    '',
+                    'Previous rolling summary:',
+                    context.previousRollingSummary?.trim() || '(none)',
+                    '',
+                    'Existing archive index JSON:',
+                    JSON.stringify(context.manifest.archives, null, 2),
+                    '',
+                    'Newly archived transcript:',
+                    transcript,
+                    '',
+                    'Produce the next cumulative rolling summary for the active history. Keep it concise enough for model context, but detailed enough that another agent can reconstruct the work state.',
+                ].join('\n'),
+            },
+        ];
+    }
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/src/core/chat/engine/compaction/summarizer/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/context-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,6CAA6C,EAAE,MAAM,aAAa,CAAC;AAG5E;;GAEG;AACH,MAAM,OAAO,2CAA2C;IACtD,MAAM,CAAC,KAAK,CAAC,OAA0C;QACrD,MAAM,UAAU,GAAG,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAEvG,OAAO;YACL;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,6CAA6C;aACvD;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,YAAY,OAAO,CAAC,SAAS,EAAE;oBAC/B,qBAAqB,OAAO,CAAC,WAAW,EAAE;oBAC1C,EAAE;oBACF,2BAA2B;oBAC3B,OAAO,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,QAAQ;oBAClD,EAAE;oBACF,8BAA8B;oBAC9B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClD,EAAE;oBACF,4BAA4B;oBAC5B,UAAU;oBACV,EAAE;oBACF,sLAAsL;iBACvL,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/summarizer/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationArchiveSummarizer } from './service.js';
+export type { ConversationArchiveSummarizerRuntime, ConversationArchiveSummaryContext, ResolvedConversationArchiveSummarizer, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/compaction/summarizer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EACV,oCAAoC,EACpC,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/compaction/summarizer/index.js

@@ -0,0 +1,2 @@
+export { ConversationArchiveSummarizer } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/compaction/summarizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/core/chat/engine/compaction/summarizer/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const CONVERSATION_ARCHIVE_SUMMARIZER_SYSTEM_PROMPT = "# Role\n\nYou summarize archived coding-agent conversations for later continuation.\n\n# Requirements\n\n- Produce markdown with moderate fidelity and no preamble.\n- Preserve confirmed facts, user intent, concrete file/code references, decisions, commands, verification, risks, and follow-ups.\n- Integrate the previous rolling summary when present.\n- Do not invent work that did not happen.\n\n# Output Sections\n\n# Compacted Conversation Rolling Summary\n\n## User Goals And Preferences\n\n## Work Completed\n\n## Important Decisions\n\n## Files And Code Areas Touched\n\n## Commands And Verification\n\n## Open Questions / Follow-Ups\n\n## Archive Index\n\n## High-Fidelity Details Worth Retrieving";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/core/chat/engine/compaction/summarizer/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6CAA6C,qsBA6BhB,CAAC"}

package/dist/src/core/chat/engine/compaction/summarizer/prompt.js

@@ -0,0 +1,31 @@
+export const CONVERSATION_ARCHIVE_SUMMARIZER_SYSTEM_PROMPT = `# Role
+
+You summarize archived coding-agent conversations for later continuation.
+
+# Requirements
+
+- Produce markdown with moderate fidelity and no preamble.
+- Preserve confirmed facts, user intent, concrete file/code references, decisions, commands, verification, risks, and follow-ups.
+- Integrate the previous rolling summary when present.
+- Do not invent work that did not happen.
+
+# Output Sections
+
+# Compacted Conversation Rolling Summary
+
+## User Goals And Preferences
+
+## Work Completed
+
+## Important Decisions
+
+## Files And Code Areas Touched
+
+## Commands And Verification
+
+## Open Questions / Follow-Ups
+
+## Archive Index
+
+## High-Fidelity Details Worth Retrieving`;
+//# sourceMappingURL=prompt.js.map

package/dist/src/core/chat/engine/compaction/summarizer/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6CAA6C,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CA6BnB,CAAC"}

package/dist/src/core/chat/engine/compaction/summarizer/service.d.ts

@@ -0,0 +1,14 @@
+import type { ConversationCompactionOptions } from '../types.js';
+import type { ConversationArchiveSummarizerRuntime, ConversationArchiveSummaryContext, ResolvedConversationArchiveSummarizer } from './types.js';
+/**
+ * Resolves and runs the LLM summarizer for archived conversation slices.
+ */
+export declare class ConversationArchiveSummarizer {
+    static resolve(options: ConversationCompactionOptions): ResolvedConversationArchiveSummarizer;
+    static summarizeArchive(options: ConversationArchiveSummaryContext & {
+        runtime: ConversationArchiveSummarizerRuntime;
+    }): Promise<string>;
+    private static resolveCredentialMode;
+    static deriveShortDescription(summary: string): string | undefined;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/chat/engine/compaction/summarizer/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EACV,oCAAoC,EACpC,iCAAiC,EACjC,qCAAqC,EACtC,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,6BAA6B;IACxC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,6BAA6B,GAAG,qCAAqC;WAuChF,gBAAgB,CAAC,OAAO,EAAE,iCAAiC,GAAG;QACzE,OAAO,EAAE,oCAAoC,CAAC;KAC/C,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnB,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAepC,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAQnE"}

package/dist/src/core/chat/engine/compaction/summarizer/service.js

@@ -0,0 +1,70 @@
+import { createLlmAdapter, inferProviderFromModel } from '../../../../../core/llm/factory.js';
+import { RuntimeCredentialService, } from '../../../../../core/runtime/credentials/index.js';
+import { credentialModeFromSource, resolveSystemSelectedModel, } from '../../../../../core/llm/model-policy.js';
+import { CompactionText } from '../text.js';
+import { ConversationArchiveSummarizerContextBuilder } from './context-builder.js';
+/**
+ * Resolves and runs the LLM summarizer for archived conversation slices.
+ */
+export class ConversationArchiveSummarizer {
+    static resolve(options) {
+        if (options.summarizer?.llm) {
+            return {
+                llm: options.summarizer.llm,
+                model: options.summarizer.llm.info?.model ?? options.summarizer.model ?? options.runtime.model,
+            };
+        }
+        const provider = options.summarizer?.provider === 'active' || !options.summarizer?.provider ?
+            inferProviderFromModel(options.runtime.model)
+            : options.summarizer.provider;
+        const model = options.summarizer?.model
+            ?? resolveSystemSelectedModel({
+                purpose: 'chat-compaction',
+                provider,
+                activeModel: options.runtime.model,
+                credentialMode: ConversationArchiveSummarizer.resolveCredentialMode({
+                    activeModel: options.runtime.model,
+                    explicitApiKey: options.summarizer?.apiKey,
+                    credentialSource: options.summarizer?.credentialSource,
+                }),
+            });
+        const apiKey = options.summarizer?.apiKey ?? RuntimeCredentialService.resolveApiKeyForModel(model);
+        const summarizerCredentialRuntime = {
+            apiKey,
+            apiKeyProvider: options.summarizer?.apiKey ? 'explicit' : apiKey ? provider : undefined,
+        };
+        if (!RuntimeCredentialService.hasCredentialForModel(model, summarizerCredentialRuntime)) {
+            return { model };
+        }
+        return {
+            model,
+            llm: createLlmAdapter({ model, apiKey }),
+        };
+    }
+    static async summarizeArchive(options) {
+        const response = await options.runtime.llm.chat(ConversationArchiveSummarizerContextBuilder.build(options), []);
+        const content = response.content?.trim();
+        if (!content) {
+            throw new Error(`Compaction summarizer returned no content for ${options.runtime.model}`);
+        }
+        return content;
+    }
+    static resolveCredentialMode(args) {
+        const { activeModel, explicitApiKey, credentialSource, credentialStorePath } = args;
+        const credentialRuntime = {
+            apiKey: explicitApiKey,
+            apiKeyProvider: explicitApiKey ? 'explicit' : undefined,
+            credentialStorePath,
+        };
+        return credentialModeFromSource(credentialSource ?? RuntimeCredentialService.resolveCredentialSourceForModel(activeModel, credentialRuntime));
+    }
+    static deriveShortDescription(summary) {
+        const lines = summary
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith('#'));
+        const first = lines[0];
+        return first ? CompactionText.truncateLine(first, 120) : undefined;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/chat/engine/compaction/summarizer/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/service.ts"],"names":[],"mappings":"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"}

package/dist/src/core/chat/engine/compaction/summarizer/types.d.ts

@@ -0,0 +1,19 @@
+import type { ChatArchiveManifest } from '../../../../../core/chat/types.js';
+import type { ChatMessage, LlmAdapter } from '../../../../../core/llm/types.js';
+export type ConversationArchiveSummarizerRuntime = {
+    llm: LlmAdapter;
+    model: string;
+};
+export type ConversationArchiveSummaryContext = {
+    sessionId: string;
+    archivePath: string;
+    manifest: ChatArchiveManifest;
+    previousRollingSummary?: string;
+    archivedMessages: ChatMessage[];
+    summaryModel: string;
+};
+export type ResolvedConversationArchiveSummarizer = {
+    llm?: LlmAdapter;
+    model: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/compaction/summarizer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,MAAM,oCAAoC,GAAG;IACjD,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/src/core/chat/engine/compaction/summarizer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/chat/engine/compaction/summarizer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/compaction/summarizer/types.ts"],"names":[],"mappings":""}

package/dist/src/core/chat/engine/compaction/summary-message.d.ts

@@ -0,0 +1,18 @@
+import type { ChatArchiveRecord } from '../../../../core/chat/types.js';
+import type { ChatMessage } from '../../../../core/llm/types.js';
+/**
+ * Builds and detects the compacted-history marker message placed back into active chat history.
+ *
+ * This is not the LLM summarizer. It only shapes the synthetic system message
+ * that points future turns at the rolling summary and archive files.
+ */
+export declare class ConversationCompactionSummaryMessage {
+    static isSummary(message: ChatMessage): boolean;
+    static extractPriorSummary(history: ChatMessage[]): string | undefined;
+    static buildArchivedSummaryMessage(options: {
+        sessionId: string;
+        rollingSummary: string;
+        archives: ChatArchiveRecord[];
+    }): ChatMessage;
+}
+//# sourceMappingURL=summary-message.d.ts.map

package/dist/src/core/chat/engine/compaction/summary-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-message.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/summary-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD;;;;;GAKG;AACH,qBAAa,oCAAoC;IAC/C,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAI/C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS;IAUtE,MAAM,CAAC,2BAA2B,CAAC,OAAO,EAAE;QAC1C,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;KAC/B,GAAG,WAAW;CAwBhB"}

package/dist/src/core/chat/engine/compaction/summary-message.js

@@ -0,0 +1,46 @@
+import { FileChatArchiveRepository } from '../../../../core/chat/engine/sessions/archives/index.js';
+import { COMPACTED_HISTORY_MARKER } from './constants.js';
+import { CompactionText } from './text.js';
+import { ConversationCompactionTokenEstimator } from './token-estimator.js';
+/**
+ * Builds and detects the compacted-history marker message placed back into active chat history.
+ *
+ * This is not the LLM summarizer. It only shapes the synthetic system message
+ * that points future turns at the rolling summary and archive files.
+ */
+export class ConversationCompactionSummaryMessage {
+    static isSummary(message) {
+        return ConversationCompactionTokenEstimator.isCompactedSummary(message);
+    }
+    static extractPriorSummary(history) {
+        const summaryMessage = history.find(ConversationCompactionSummaryMessage.isSummary);
+        if (!summaryMessage || summaryMessage.role !== 'system') {
+            return undefined;
+        }
+        const content = summaryMessage.content.slice(COMPACTED_HISTORY_MARKER.length).trim();
+        return content || undefined;
+    }
+    static buildArchivedSummaryMessage(options) {
+        const archivePaths = options.archives
+            .slice(-8)
+            .map((archive) => `- ${archive.path}: ${archive.shortDescription ?? `${archive.messageCount} messages archived`}`);
+        const content = [
+            COMPACTED_HISTORY_MARKER,
+            '',
+            `Archive root: ${FileChatArchiveRepository.derivePaths('.', options.sessionId).displayArchivesDir}`,
+            '',
+            'Current rolling summary:',
+            CompactionText.truncateSummary(options.rollingSummary),
+            '',
+            'Archive index:',
+            ...(archivePaths.length > 0 ? archivePaths : ['- No archive records found.']),
+            '',
+            'If exact wording, tool output, or earlier rationale matters, inspect the archive files with normal file tools before relying on this summary.',
+        ].join('\n');
+        return {
+            role: 'system',
+            content,
+        };
+    }
+}
+//# sourceMappingURL=summary-message.js.map

package/dist/src/core/chat/engine/compaction/summary-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-message.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/summary-message.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAE1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,OAAO,oCAAoC;IAC/C,MAAM,CAAC,SAAS,CAAC,OAAoB;QACnC,OAAO,oCAAoC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,OAAsB;QAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACrF,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,2BAA2B,CAAC,OAIlC;QACC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ;aAClC,KAAK,CAAC,CAAC,CAAC,CAAC;aACT,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,gBAAgB,IAAI,GAAG,OAAO,CAAC,YAAY,oBAAoB,EAAE,CAAC,CAAC;QAErH,MAAM,OAAO,GAAG;YACd,wBAAwB;YACxB,EAAE;YACF,iBAAiB,yBAAyB,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE;YACnG,EAAE;YACF,0BAA0B;YAC1B,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,cAAc,CAAC;YACtD,EAAE;YACF,gBAAgB;YAChB,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;YAC7E,EAAE;YACF,+IAA+I;SAChJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Small formatting helpers for compaction prompts and compacted history text.
+ */
+export declare class CompactionText {
+    static truncateSummary(value: string): string;
+    static truncateForSummary(value: string, maxChars: number): string;
+    static truncateLine(value: string, maxChars: number): string;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/src/core/chat/engine/compaction/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/text.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,cAAc;IACzB,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ7C,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQlE,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAQ7D"}