@roackb2/heddle 1.2.0 → 1.4.0

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":"AAcA,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 { hasProviderCredentialForModel, resolveApiKeyForModel, resolveProviderCredentialSourceForModel, } from '../../../../../core/runtime/api-keys.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 ?? resolveApiKeyForModel(model);
+        const summarizerCredentialRuntime = {
+            apiKey,
+            apiKeyProvider: options.summarizer?.apiKey ? 'explicit' : apiKey ? provider : undefined,
+        };
+        if (!hasProviderCredentialForModel(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 ?? resolveProviderCredentialSourceForModel(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"}

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

@@ -0,0 +1,26 @@
+import { MAX_ROLLING_SUMMARY_CHARS } from './constants.js';
+/**
+ * Small formatting helpers for compaction prompts and compacted history text.
+ */
+export class CompactionText {
+    static truncateSummary(value) {
+        if (value.length <= MAX_ROLLING_SUMMARY_CHARS) {
+            return value;
+        }
+        return `${value.slice(0, MAX_ROLLING_SUMMARY_CHARS - 1).trimEnd()}…`;
+    }
+    static truncateForSummary(value, maxChars) {
+        if (value.length <= maxChars) {
+            return value;
+        }
+        return `${value.slice(0, Math.max(0, maxChars - 80)).trimEnd()}\n\n[truncated ${value.length - maxChars} chars; full content is in the raw archive]`;
+    }
+    static truncateLine(value, maxChars) {
+        const compact = value.replace(/\s+/g, ' ').trim();
+        if (compact.length <= maxChars) {
+            return compact;
+        }
+        return `${compact.slice(0, maxChars - 1).trimEnd()}…`;
+    }
+}
+//# sourceMappingURL=text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,eAAe,CAAC,KAAa;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,yBAAyB,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,KAAa,EAAE,QAAgB;QACvD,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,kBAAkB,KAAK,CAAC,MAAM,GAAG,QAAQ,6CAA6C,CAAC;IACvJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,KAAa,EAAE,QAAgB;QACjD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;IACxD,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/token-estimator.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage } from '../../../../core/llm/types.js';
+import type { ConversationCompactionContextInput } from './types.js';
+/**
+ * Owns low-cost token estimates used by compaction thresholds and context stats.
+ */
+export declare class ConversationCompactionTokenEstimator {
+    static estimateHistory(history: ChatMessage[]): number;
+    static estimateRequest(input: Pick<ConversationCompactionContextInput, 'history' | 'runtime' | 'request'>): number;
+    static isCompactedSummary(message: ChatMessage): boolean;
+    static countNonCompactedMessages(history: ChatMessage[]): number;
+    static estimateMessage(message: ChatMessage): number;
+    static estimateText(text: string): number;
+}
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/src/core/chat/engine/compaction/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/token-estimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,qBAAa,oCAAoC;IAC/C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM;IAItD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,kCAAkC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG,MAAM;IAUlH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIxD,MAAM,CAAC,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM;IAIhE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAepD,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG1C"}

package/dist/src/core/chat/engine/compaction/token-estimator.js

@@ -0,0 +1,41 @@
+import { COMPACTED_HISTORY_MARKER } from './constants.js';
+/**
+ * Owns low-cost token estimates used by compaction thresholds and context stats.
+ */
+export class ConversationCompactionTokenEstimator {
+    static estimateHistory(history) {
+        return history.reduce((total, message) => total + ConversationCompactionTokenEstimator.estimateMessage(message), 0);
+    }
+    static estimateRequest(input) {
+        const syntheticGoal = input.request?.goal ?? 'Continue from the current conversation.';
+        const systemPromptEstimate = ConversationCompactionTokenEstimator.estimateText([
+            syntheticGoal,
+            input.runtime.systemContext ?? '',
+            input.request?.toolNames?.join(',') ?? '',
+        ].join('\n'));
+        return systemPromptEstimate + ConversationCompactionTokenEstimator.estimateHistory(input.history) + ConversationCompactionTokenEstimator.estimateText(syntheticGoal) + 24;
+    }
+    static isCompactedSummary(message) {
+        return message.role === 'system' && message.content.startsWith(COMPACTED_HISTORY_MARKER);
+    }
+    static countNonCompactedMessages(history) {
+        return history.filter((message) => !ConversationCompactionTokenEstimator.isCompactedSummary(message)).length;
+    }
+    static estimateMessage(message) {
+        if (ConversationCompactionTokenEstimator.isCompactedSummary(message)) {
+            return ConversationCompactionTokenEstimator.estimateText(message.content) + 12;
+        }
+        switch (message.role) {
+            case 'system':
+            case 'user':
+            case 'tool':
+                return ConversationCompactionTokenEstimator.estimateText(message.content) + 12;
+            case 'assistant':
+                return ConversationCompactionTokenEstimator.estimateText(message.content) + 12 + (message.toolCalls?.length ?? 0) * 24;
+        }
+    }
+    static estimateText(text) {
+        return Math.ceil(text.length / 4);
+    }
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/src/core/chat/engine/compaction/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/token-estimator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D;;GAEG;AACH,MAAM,OAAO,oCAAoC;IAC/C,MAAM,CAAC,eAAe,CAAC,OAAsB;QAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,oCAAoC,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACtH,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,KAAkF;QACvG,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,yCAAyC,CAAC;QACvF,MAAM,oBAAoB,GAAG,oCAAoC,CAAC,YAAY,CAAC;YAC7E,aAAa;YACb,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE;YACjC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;SAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACd,OAAO,oBAAoB,GAAG,oCAAoC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,oCAAoC,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;IAC5K,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAoB;QAC5C,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,CAAC,yBAAyB,CAAC,OAAsB;QACrD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,oCAAoC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/G,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,OAAoB;QACzC,IAAI,oCAAoC,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YACrE,OAAO,oCAAoC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACjF,CAAC;QAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ,CAAC;YACd,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,OAAO,oCAAoC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjF,KAAK,WAAW;gBACd,OAAO,oCAAoC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3H,CAAC;IACH,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/transcript-renderer.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../../../../core/llm/types.js';
+/**
+ * Renders archived messages into a bounded prompt payload for the summarizer.
+ */
+export declare class CompactionTranscriptRenderer {
+    static render(messages: ChatMessage[], summaryModel: string): string;
+    private static resolveTranscriptCharBudget;
+    private static renderMessage;
+}
+//# sourceMappingURL=transcript-renderer.d.ts.map

package/dist/src/core/chat/engine/compaction/transcript-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-renderer.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/transcript-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvD;;GAEG;AACH,qBAAa,4BAA4B;IACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAgCpE,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAO1C,OAAO,CAAC,MAAM,CAAC,aAAa;CAyB7B"}

package/dist/src/core/chat/engine/compaction/transcript-renderer.js

@@ -0,0 +1,62 @@
+import { estimateBuiltInContextWindow } from '../../../../core/llm/openai-models.js';
+import { DEFAULT_CONTEXT_WINDOW_ESTIMATE, MAX_SUMMARIZER_CONTEXT_RATIO, MAX_SUMMARIZER_MESSAGE_CHARS, MAX_SUMMARIZER_TRANSCRIPT_CHARS, MAX_SUMMARIZER_TRANSCRIPT_TOKENS, MIN_SUMMARIZER_MESSAGE_CHARS, } from './constants.js';
+import { CompactionText } from './text.js';
+/**
+ * Renders archived messages into a bounded prompt payload for the summarizer.
+ */
+export class CompactionTranscriptRenderer {
+    static render(messages, summaryModel) {
+        if (messages.length === 0) {
+            return '(no archived messages)';
+        }
+        const transcriptCharBudget = CompactionTranscriptRenderer.resolveTranscriptCharBudget(summaryModel);
+        const perMessageBudget = Math.max(MIN_SUMMARIZER_MESSAGE_CHARS, Math.min(MAX_SUMMARIZER_MESSAGE_CHARS, Math.floor(transcriptCharBudget / messages.length) - 80));
+        const lines = [
+            `Summarizer transcript note: raw archive contains ${messages.length} complete messages.`,
+            `Each message below is condensed to fit the summarizer request. Read the archive file when exact wording or full tool output matters.`,
+            `Summarizer input budget: about ${Math.floor(transcriptCharBudget / 4).toLocaleString()} estimated text tokens.`,
+        ];
+        let totalChars = lines.join('\n').length;
+        for (const [index, message] of messages.entries()) {
+            const rendered = `## Message ${index + 1}\n${CompactionTranscriptRenderer.renderMessage(message, perMessageBudget)}`;
+            const separator = lines.length > 0 ? '\n\n' : '';
+            if (totalChars + separator.length + rendered.length > transcriptCharBudget) {
+                lines.push(`\n\nOmitted ${messages.length - index} additional archived messages from summarizer input to stay within request budget. Inspect the raw archive for full detail.`);
+                break;
+            }
+            lines.push(rendered);
+            totalChars += separator.length + rendered.length;
+        }
+        return lines.join('\n\n');
+    }
+    static resolveTranscriptCharBudget(summaryModel) {
+        const contextWindow = estimateBuiltInContextWindow(summaryModel) ?? DEFAULT_CONTEXT_WINDOW_ESTIMATE;
+        const budgetByContext = Math.floor(contextWindow * MAX_SUMMARIZER_CONTEXT_RATIO);
+        const tokenBudget = Math.min(MAX_SUMMARIZER_TRANSCRIPT_TOKENS, budgetByContext);
+        return Math.min(MAX_SUMMARIZER_TRANSCRIPT_CHARS, tokenBudget * 4);
+    }
+    static renderMessage(message, maxChars) {
+        if (message.role === 'assistant') {
+            const parts = [
+                'Role: assistant',
+                message.content ? `Content excerpt:\n${CompactionText.truncateForSummary(message.content, maxChars)}` : 'Content: (empty)',
+                message.toolCalls?.length ?
+                    `Tool calls:\n${CompactionText.truncateForSummary(JSON.stringify(message.toolCalls, null, 2), maxChars)}`
+                    : undefined,
+            ].filter((part) => Boolean(part));
+            return parts.join('\n\n');
+        }
+        if (message.role === 'tool') {
+            return [
+                'Role: tool',
+                `Tool call id: ${message.toolCallId}`,
+                `Content excerpt:\n${CompactionText.truncateForSummary(message.content, maxChars)}`,
+            ].join('\n\n');
+        }
+        return [
+            `Role: ${message.role}`,
+            `Content excerpt:\n${CompactionText.truncateForSummary(message.content, maxChars)}`,
+        ].join('\n\n');
+    }
+}
+//# sourceMappingURL=transcript-renderer.js.map

package/dist/src/core/chat/engine/compaction/transcript-renderer.js.map

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

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

@@ -0,0 +1,66 @@
+import type { ChatArchiveRecord, ChatContextStats, ChatSession } from '../../../../core/chat/types.js';
+import type { ChatMessage, LlmAdapter, LlmUsage } from '../../../../core/llm/types.js';
+import type { ProviderCredentialSource } from '../../../../core/runtime/api-keys.js';
+export type ConversationCompactionSummarizerOptions = {
+    provider?: 'openai' | 'anthropic' | 'active';
+    model?: string;
+    apiKey?: string;
+    llm?: LlmAdapter;
+    credentialSource?: ProviderCredentialSource;
+};
+export type ConversationCompactionRuntime = {
+    model: string;
+    stateRoot: string;
+    systemContext?: string;
+};
+export type ConversationCompactionRequest = {
+    usage?: LlmUsage;
+    toolNames?: string[];
+    goal?: string;
+};
+export type ConversationCompactionArchiveState = {
+    archives: ChatArchiveRecord[];
+    currentSummaryPath?: string;
+    lastArchivePath?: string;
+};
+export type ConversationCompactionCompletedArchive = ConversationCompactionArchiveState & {
+    compactedMessages: number;
+    compactedAt: string;
+};
+export type ConversationCompactionContextInput = {
+    history: ChatMessage[];
+    runtime: Pick<ConversationCompactionRuntime, 'systemContext'>;
+    request?: ConversationCompactionRequest;
+    archive: ConversationCompactionArchiveState;
+    completed?: ConversationCompactionCompletedArchive;
+    status?: {
+        state: NonNullable<NonNullable<ChatContextStats['compaction']>['status']>;
+        error?: string;
+    };
+};
+export type ConversationCompactionOptions = {
+    history: ChatMessage[];
+    runtime: ConversationCompactionRuntime;
+    session: Pick<ChatSession, 'id'>;
+    request?: ConversationCompactionRequest;
+    force?: boolean;
+    summarizer?: ConversationCompactionSummarizerOptions;
+    onStatusChange?: (event: ConversationCompactionStatus) => void;
+};
+export type ConversationCompactionResult = {
+    history: ChatMessage[];
+    context: ChatContextStats;
+    archive: ConversationCompactionArchiveState;
+};
+export type ConversationCompactionStatus = {
+    status: 'running' | 'finished' | 'failed';
+    archivePath?: string;
+    summaryPath?: string;
+    error?: string;
+};
+export type BuildSessionCompactionRunningContextOptions = {
+    session: ChatSession;
+    history?: ChatMessage[];
+    lastArchivePath?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

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

package/dist/src/core/chat/engine/conversation-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-engine.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/conversation-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAW7F"}
+{"version":3,"file":"conversation-engine.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/conversation-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAO7F"}

package/dist/src/core/chat/engine/conversation-engine.js

@@ -1,15 +1,11 @@
 import { normalizeConversationEngineConfig } from './config.js';
-import { createConversationSessionService } from './sessions/service.js';
-import { createConversationTurnService } from './turns/service.js';
+import { FileConversationSessionService } from './sessions/service.js';
+import { EngineConversationTurnService } from './turns/service.js';
 export function createConversationEngine(config) {
     const normalizedConfig = normalizeConversationEngineConfig(config);
     return {
-        sessions: createConversationSessionService({
-            config: normalizedConfig,
-        }),
-        turns: createConversationTurnService({
-            config: normalizedConfig,
-        }),
+        sessions: new FileConversationSessionService(normalizedConfig),
+        turns: new EngineConversationTurnService(normalizedConfig),
     };
 }
 //# sourceMappingURL=conversation-engine.js.map