@roackb2/heddle 1.3.0 → 1.5.0

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/credentials/index.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/index.d.ts

@@ -1,5 +1,5 @@
 export { createConversationEngine } from './conversation-engine.js';
-export { runConversationTurn, clearConversationTurnLease } from './turns/run-conversation-turn.js';
-export type { RunConversationTurnArgs, RunConversationTurnResult } from './turns/run-conversation-turn.js';
+export { EngineConversationTurnService } from './turns/service.js';
+export type { RunConversationTurnArgs, RunConversationTurnResult } from './turns/types.js';
 export type { AppendConversationMessageInput, ClearConversationTurnLeaseInput, ConversationEngine, ConversationEngineConfig, ConversationEngineHost, ConversationSessionService, ConversationTurnService, CreateConversationSessionInput, ContinueConversationTurnInput, ResetConversationSessionInput, SubmitConversationTurnInput, SubmitConversationTurnResult, UpdateConversationSessionSettingsInput, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnG,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC3G,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,YAAY,CAAC"}

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

@@ -1,3 +1,3 @@
 export { createConversationEngine } from './conversation-engine.js';
-export { runConversationTurn, clearConversationTurnLease } from './turns/run-conversation-turn.js';
+export { EngineConversationTurnService } from './turns/service.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/chat/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/chat/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/core/chat/engine/sessions/archives/file-chat-archive-repository.d.ts

@@ -0,0 +1,27 @@
+import type { ChatMessage } from '../../../../../core/llm/types.js';
+import type { ChatArchiveManifest, ChatArchiveRecord } from '../../../../../core/chat/types.js';
+import type { ChatArchivePaths, ChatArchiveRepository } from './types.js';
+export declare class FileChatArchiveRepository implements ChatArchiveRepository {
+    private readonly stateRoot;
+    private readonly sessionId;
+    private readonly paths;
+    constructor(args: {
+        stateRoot: string;
+        sessionId: string;
+    });
+    derivePaths(): ChatArchivePaths;
+    ensureArchiveDir(): ChatArchivePaths;
+    loadManifest(): ChatArchiveManifest;
+    saveManifest(manifest: ChatArchiveManifest): void;
+    writeMessagesJsonl(archiveId: string, messages: ChatMessage[]): string;
+    writeSummaryMarkdown(archiveId: string, summary: string): string;
+    readSummaryMarkdown(path: string): string | undefined;
+    static derivePaths(stateRoot: string, sessionId: string): ChatArchivePaths;
+    static createArchiveId(now?: Date): string;
+    static appendManifestArchive(current: ChatArchiveManifest, archive: ChatArchiveRecord): ChatArchiveManifest;
+    private static emptyManifest;
+    private static parseManifest;
+    private static parseArchiveRecord;
+    private static resolveDisplayPath;
+}
+//# sourceMappingURL=file-chat-archive-repository.d.ts.map

package/dist/src/core/chat/engine/sessions/archives/file-chat-archive-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-chat-archive-repository.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/archives/file-chat-archive-repository.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAI1E,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAM1D,WAAW,IAAI,gBAAgB;IAI/B,gBAAgB,IAAI,gBAAgB;IAKpC,YAAY,IAAI,mBAAmB;IAanC,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAKjD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAYtE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAQhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAarD,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAY1E,MAAM,CAAC,eAAe,CAAC,GAAG,OAAa,GAAG,MAAM;IAIhD,MAAM,CAAC,qBAAqB,CAC1B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,iBAAiB,GACzB,mBAAmB;IAStB,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA2BjC,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAOlC"}

package/dist/src/core/chat/engine/sessions/archives/file-chat-archive-repository.js

@@ -0,0 +1,146 @@
+/**
+ * File-backed chat archive repository.
+ *
+ * Owns archive paths, manifest persistence, archived transcript files, and
+ * rolling-summary markdown files for one chat session. Compaction policy stays
+ * in the history module; archive file layout stays here.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const ARCHIVE_MANIFEST_VERSION = 1;
+export class FileChatArchiveRepository {
+    stateRoot;
+    sessionId;
+    paths;
+    constructor(args) {
+        this.stateRoot = args.stateRoot;
+        this.sessionId = args.sessionId;
+        this.paths = FileChatArchiveRepository.derivePaths(args.stateRoot, args.sessionId);
+    }
+    derivePaths() {
+        return this.paths;
+    }
+    ensureArchiveDir() {
+        mkdirSync(this.paths.archivesDir, { recursive: true });
+        return this.paths;
+    }
+    loadManifest() {
+        if (!existsSync(this.paths.manifestPath)) {
+            return FileChatArchiveRepository.emptyManifest(this.sessionId);
+        }
+        try {
+            const parsed = JSON.parse(readFileSync(this.paths.manifestPath, 'utf8'));
+            return FileChatArchiveRepository.parseManifest(parsed, this.sessionId);
+        }
+        catch {
+            return FileChatArchiveRepository.emptyManifest(this.sessionId);
+        }
+    }
+    saveManifest(manifest) {
+        const paths = this.ensureArchiveDir();
+        writeFileSync(paths.manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+    }
+    writeMessagesJsonl(archiveId, messages) {
+        const paths = this.ensureArchiveDir();
+        const displayPath = `${paths.displayArchivesDir}/${archiveId}.jsonl`;
+        const filePath = join(paths.archivesDir, `${archiveId}.jsonl`);
+        const body = messages.map((message, index) => JSON.stringify({
+            index,
+            ...message,
+        })).join('\n');
+        writeFileSync(filePath, body ? `${body}\n` : '', 'utf8');
+        return displayPath;
+    }
+    writeSummaryMarkdown(archiveId, summary) {
+        const paths = this.ensureArchiveDir();
+        const displayPath = `${paths.displayArchivesDir}/${archiveId}.summary.md`;
+        const filePath = join(paths.archivesDir, `${archiveId}.summary.md`);
+        writeFileSync(filePath, summary.endsWith('\n') ? summary : `${summary}\n`, 'utf8');
+        return displayPath;
+    }
+    readSummaryMarkdown(path) {
+        const filePath = FileChatArchiveRepository.resolveDisplayPath(path, this.stateRoot);
+        if (!existsSync(filePath)) {
+            return undefined;
+        }
+        try {
+            return readFileSync(filePath, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    static derivePaths(stateRoot, sessionId) {
+        const sessionDir = join(stateRoot, 'chat-sessions', sessionId);
+        const archivesDir = join(sessionDir, 'archives');
+        return {
+            sessionDir,
+            archivesDir,
+            manifestPath: join(archivesDir, 'manifest.json'),
+            displaySessionDir: `.heddle/chat-sessions/${sessionId}`,
+            displayArchivesDir: `.heddle/chat-sessions/${sessionId}/archives`,
+        };
+    }
+    static createArchiveId(now = new Date()) {
+        return `archive-${now.toISOString().replaceAll(':', '-')}`;
+    }
+    static appendManifestArchive(current, archive) {
+        return {
+            version: ARCHIVE_MANIFEST_VERSION,
+            sessionId: current.sessionId,
+            currentSummaryPath: archive.summaryPath,
+            archives: [...current.archives, archive],
+        };
+    }
+    static emptyManifest(sessionId) {
+        return {
+            version: ARCHIVE_MANIFEST_VERSION,
+            sessionId,
+            archives: [],
+        };
+    }
+    static parseManifest(value, sessionId) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return FileChatArchiveRepository.emptyManifest(sessionId);
+        }
+        const candidate = value;
+        const archives = Array.isArray(candidate.archives) ?
+            candidate.archives.flatMap((archive) => FileChatArchiveRepository.parseArchiveRecord(archive))
+            : [];
+        return {
+            version: ARCHIVE_MANIFEST_VERSION,
+            sessionId: typeof candidate.sessionId === 'string' ? candidate.sessionId : sessionId,
+            currentSummaryPath: typeof candidate.currentSummaryPath === 'string' ? candidate.currentSummaryPath : undefined,
+            archives,
+        };
+    }
+    static parseArchiveRecord(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return [];
+        }
+        const candidate = value;
+        if (typeof candidate.id !== 'string'
+            || typeof candidate.path !== 'string'
+            || typeof candidate.summaryPath !== 'string'
+            || typeof candidate.messageCount !== 'number'
+            || typeof candidate.createdAt !== 'string') {
+            return [];
+        }
+        return [{
+                id: candidate.id,
+                path: candidate.path,
+                summaryPath: candidate.summaryPath,
+                shortDescription: typeof candidate.shortDescription === 'string' ? candidate.shortDescription : undefined,
+                messageCount: candidate.messageCount,
+                createdAt: candidate.createdAt,
+                summaryModel: typeof candidate.summaryModel === 'string' ? candidate.summaryModel : undefined,
+            }];
+    }
+    static resolveDisplayPath(displayPath, stateRoot) {
+        if (displayPath.startsWith('.heddle/')) {
+            return join(stateRoot, displayPath.slice('.heddle/'.length));
+        }
+        return displayPath;
+    }
+}
+//# sourceMappingURL=file-chat-archive-repository.js.map

package/dist/src/core/chat/engine/sessions/archives/file-chat-archive-repository.js.map

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

package/dist/src/core/chat/engine/sessions/archives/index.d.ts

@@ -0,0 +1,3 @@
+export { FileChatArchiveRepository } from './file-chat-archive-repository.js';
+export type { ChatArchivePaths, ChatArchiveRepository } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/sessions/archives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/archives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/sessions/archives/index.js

@@ -0,0 +1,2 @@
+export { FileChatArchiveRepository } from './file-chat-archive-repository.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/sessions/archives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/archives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/src/core/chat/engine/sessions/archives/types.d.ts

@@ -0,0 +1,19 @@
+import type { ChatMessage } from '../../../../../core/llm/types.js';
+import type { ChatArchiveManifest } from '../../../../../core/chat/types.js';
+export type ChatArchivePaths = {
+    sessionDir: string;
+    archivesDir: string;
+    manifestPath: string;
+    displaySessionDir: string;
+    displayArchivesDir: string;
+};
+export type ChatArchiveRepository = {
+    derivePaths(): ChatArchivePaths;
+    ensureArchiveDir(): ChatArchivePaths;
+    loadManifest(): ChatArchiveManifest;
+    saveManifest(manifest: ChatArchiveManifest): void;
+    writeMessagesJsonl(archiveId: string, messages: ChatMessage[]): string;
+    writeSummaryMarkdown(archiveId: string, summary: string): string;
+    readSummaryMarkdown(path: string): string | undefined;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/archives/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,IAAI,gBAAgB,CAAC;IAChC,gBAAgB,IAAI,gBAAgB,CAAC;IACrC,YAAY,IAAI,mBAAmB,CAAC;IACpC,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACjE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACvD,CAAC"}

package/dist/src/core/chat/engine/sessions/archives/types.js

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

package/dist/src/core/chat/engine/sessions/archives/types.js.map

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

package/dist/src/core/chat/engine/sessions/leases/index.d.ts

@@ -0,0 +1,3 @@
+export { ChatSessionLeases } from './leases.js';
+export type { ChatSessionLeaseConflictOptions, ChatSessionLeaseOwner } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/sessions/leases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/leases/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/sessions/leases/index.js

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

package/dist/src/core/chat/engine/sessions/leases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/leases/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/core/chat/engine/sessions/leases/leases.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure chat-session lease policy.
+ *
+ * Keep lease freshness, ownership, acquisition, release, and conflict messages
+ * here. This class should not perform storage I/O; callers persist the returned
+ * session through the owning service or repository.
+ */
+import type { ChatSession, ChatSessionLease } from '../../../../../core/chat/types.js';
+import type { ChatSessionLeaseConflictOptions, ChatSessionLeaseOwner } from './types.js';
+export declare class ChatSessionLeases {
+    static isFresh(lease: ChatSessionLease | undefined, options?: {
+        now?: number;
+        staleAfterMs?: number;
+    }): boolean;
+    static isOwnedByDeadLocalProcess(lease: ChatSessionLease | undefined, options?: {
+        isProcessAlive?: (pid: number) => boolean;
+    }): boolean;
+    static acquire(session: ChatSession, owner: ChatSessionLeaseOwner, options?: {
+        now?: number;
+    }): ChatSession;
+    static release(session: ChatSession, owner?: Pick<ChatSessionLeaseOwner, 'ownerId'>): ChatSession;
+    static conflict(session: ChatSession, owner: ChatSessionLeaseOwner, options?: ChatSessionLeaseConflictOptions): string | undefined;
+    private static defaultIsProcessAlive;
+}
+//# sourceMappingURL=leases.d.ts.map

package/dist/src/core/chat/engine/sessions/leases/leases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leases.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/leases/leases.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKzF,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CACZ,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO;IAaV,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,GACtD,OAAO;IAeV,MAAM,CAAC,OAAO,CACZ,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,WAAW;IAcd,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,GAAG,WAAW;IAWjG,MAAM,CAAC,QAAQ,CACb,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,+BAA+B,GACxC,MAAM,GAAG,SAAS;IAiBrB,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAYrC"}