@roackb2/heddle 1.3.0 → 1.4.0

package/dist/src/core/chat/engine/turns/host/host-normalizer.js

@@ -0,0 +1,51 @@
+import { projectAgentLoopEventToConversationActivities, projectCompactionStatusToConversationActivities, projectTraceEventToConversationActivities, } from '../../../../../core/observability/conversation-activity.js';
+/**
+ * Normalizes host-facing engine callbacks into turn-runtime ports.
+ */
+export class ConversationEngineHostNormalizer {
+    static normalize(host) {
+        const onActivity = host?.events?.onActivity;
+        const onAgentLoopEvent = host?.events?.onAgentLoopEvent;
+        const onTraceEvent = host?.trace?.onEvent;
+        const requestToolApproval = host?.approvals?.requestToolApproval;
+        const turnHost = {
+            onAgentLoopEvent: (event) => {
+                onAgentLoopEvent?.(event);
+                for (const activity of projectAgentLoopEventToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+            approveToolCall: requestToolApproval
+                ? ((call, tool) => requestToolApproval({ call, tool }))
+                : undefined,
+            onCompactionStatus: (event, phase) => {
+                host?.compaction?.onStatus?.(event);
+                if (phase === 'preflight') {
+                    host?.compaction?.onPreflightCompactionStatus?.(event);
+                }
+                else {
+                    host?.compaction?.onFinalCompactionStatus?.(event);
+                }
+                for (const activity of projectCompactionStatusToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+        };
+        return {
+            turnHost,
+            onAssistantStream: host?.assistant?.onStream
+                ?? (host?.assistant?.onText
+                    ? ((update) => {
+                        host.assistant?.onText?.(update.text);
+                    })
+                    : undefined),
+            onTraceEvent: (event) => {
+                onTraceEvent?.(event);
+                for (const activity of projectTraceEventToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=host-normalizer.js.map

package/dist/src/core/chat/engine/turns/host/host-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-normalizer.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/host-normalizer.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6CAA6C,EAC7C,+CAA+C,EAC/C,yCAAyC,GAC1C,MAAM,+CAA+C,CAAC;AAGvD;;GAEG;AACH,MAAM,OAAO,gCAAgC;IAC3C,MAAM,CAAC,SAAS,CAAC,IAA6B;QAC5C,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;QAC5C,MAAM,gBAAgB,GAAG,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QAC1C,MAAM,mBAAmB,GAAG,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC;QAEjE,MAAM,QAAQ,GAAqB;YACjC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC1B,KAAK,MAAM,QAAQ,IAAI,6CAA6C,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5E,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,eAAe,EAAE,mBAAmB;gBAClC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACnC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;gBACpC,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC1B,IAAI,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,KAAK,CAAC,CAAC;gBACzD,CAAC;qBAAM,CAAC;oBACN,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC;gBACrD,CAAC;gBACD,KAAK,MAAM,QAAQ,IAAI,+CAA+C,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9E,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;SACF,CAAC;QAEF,OAAO;YACL,QAAQ;YACR,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ;mBACvC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM;oBACzB,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE;wBACV,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxC,CAAC,CAAC;oBACJ,CAAC,CAAC,SAAS,CAAC;YAChB,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;gBACtB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;gBACtB,KAAK,MAAM,QAAQ,IAAI,yCAAyC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxE,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/host/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationEngineHostNormalizer } from './host-normalizer.js';
+export type { ChatTurnCompactionPhase, ChatTurnCompactionStatus, ChatTurnHostPort, ConversationEngineHostAdapterResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,mCAAmC,GACpC,MAAM,YAAY,CAAC"}

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

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

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

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

package/dist/src/core/chat/engine/turns/host/types.d.ts

@@ -0,0 +1,17 @@
+import type { RunAgentLoopOptions } from '../../../../../core/runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../../../core/runtime/events.js';
+import type { PersistChatTurnCompactionStatus } from '../persistence/index.js';
+import type { ChatTurnPreflightCompactionStatus } from '../preflight/index.js';
+export type ChatTurnCompactionPhase = 'preflight' | 'final';
+export type ChatTurnCompactionStatus = ChatTurnPreflightCompactionStatus | PersistChatTurnCompactionStatus;
+export type ChatTurnHostPort = {
+    onAgentLoopEvent?: (event: AgentLoopEvent) => void;
+    approveToolCall?: RunAgentLoopOptions['approveToolCall'];
+    onCompactionStatus?: (event: ChatTurnCompactionStatus, phase: ChatTurnCompactionPhase) => void;
+};
+export type ConversationEngineHostAdapterResult = {
+    turnHost?: ChatTurnHostPort;
+    onAssistantStream?: RunAgentLoopOptions['onAssistantStream'];
+    onTraceEvent?: RunAgentLoopOptions['onTraceEvent'];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,wBAAwB,GAAG,iCAAiC,GAAG,+BAA+B,CAAC;AAE3G,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACzD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAChG,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;CACpD,CAAC"}

package/dist/src/core/chat/engine/turns/host/types.js

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

package/dist/src/core/chat/engine/turns/host/types.js.map

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

package/dist/src/core/chat/engine/turns/memory/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationTurnMemoryMaintenance } from './turn-memory-maintenance.js';
+export type { RunInlineTurnMemoryMaintenanceArgs, ScheduleBackgroundTurnMemoryMaintenanceArgs, TurnMemoryMaintenanceRuntimeInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,YAAY,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,iCAAiC,GAClC,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,2 @@
+export { ConversationTurnMemoryMaintenance } from './turn-memory-maintenance.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.d.ts

@@ -0,0 +1,17 @@
+import type { AgentLoopResult } from '../../../../../core/runtime/agent-loop.js';
+import type { TraceEvent } from '../../../../../core/types.js';
+import type { AppendTurnMemoryMaintenanceEventsArgs, RunInlineTurnMemoryMaintenanceArgs, ScheduleBackgroundTurnMemoryMaintenanceArgs } from './types.js';
+/**
+ * Runs and records memory maintenance associated with a completed turn.
+ */
+export declare class ConversationTurnMemoryMaintenance {
+    static runInline(args: RunInlineTurnMemoryMaintenanceArgs): Promise<AgentLoopResult>;
+    static scheduleBackground(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): void;
+    static runBackground(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): Promise<void>;
+    static appendEvents(args: AppendTurnMemoryMaintenanceEventsArgs): void;
+    static appendAgentLoopTrace(result: AgentLoopResult, events: TraceEvent[]): AgentLoopResult;
+    private static readTraceEvents;
+    private static createFailureEvent;
+    private static nextTraceStep;
+}
+//# sourceMappingURL=turn-memory-maintenance.d.ts.map

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-memory-maintenance.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/turn-memory-maintenance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD,OAAO,KAAK,EACV,qCAAqC,EAErC,kCAAkC,EAClC,2CAA2C,EAC5C,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,iCAAiC;WAC/B,SAAS,CAAC,IAAI,EAAE,kCAAkC,GAAG,OAAO,CAAC,eAAe,CAAC;IAsB1F,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,2CAA2C;WAc9D,aAAa,CAAC,IAAI,EAAE,2CAA2C;IAuB5E,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,qCAAqC;IA0B/D,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe;IAsB3F,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC,OAAO,CAAC,MAAM,CAAC,aAAa;CAG7B"}

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.js

@@ -0,0 +1,126 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { runMaintenanceForRecordedCandidates } from '../../../../../core/memory/maintenance-integration.js';
+import { summarizeTrace } from '../../../../../core/observability/trace-summarizers.js';
+import { ChatSessionRecords } from '../../../../../core/chat/engine/sessions/records/index.js';
+import { FileChatSessionRepository } from '../../../../../core/chat/engine/sessions/repository/index.js';
+/**
+ * Runs and records memory maintenance associated with a completed turn.
+ */
+export class ConversationTurnMemoryMaintenance {
+    static async runInline(args) {
+        const maintenanceInput = {
+            memoryRoot: args.memoryRoot,
+            llm: args.llm,
+            source: args.source,
+            trace: args.result.trace,
+        };
+        const maintenance = await runMaintenanceForRecordedCandidates({
+            ...maintenanceInput,
+            maxSteps: 20,
+            onTraceEvent: (event) => args.onEvent?.({
+                type: 'trace',
+                runId: args.result.state.runId,
+                event,
+                timestamp: new Date().toISOString(),
+            }),
+        });
+        return ConversationTurnMemoryMaintenance.appendAgentLoopTrace(args.result, maintenance.events);
+    }
+    static scheduleBackground(args) {
+        void ConversationTurnMemoryMaintenance.runBackground(args).catch((error) => {
+            args.onEvent?.({
+                type: 'trace',
+                runId: args.runId,
+                event: ConversationTurnMemoryMaintenance.createFailureEvent({
+                    error,
+                    trace: args.trace,
+                }),
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+    static async runBackground(args) {
+        const maintenanceInput = args;
+        const maintenance = await runMaintenanceForRecordedCandidates({
+            ...maintenanceInput,
+            maxSteps: 20,
+            onTraceEvent: (event) => args.onEvent?.({
+                type: 'trace',
+                runId: args.runId,
+                event,
+                timestamp: new Date().toISOString(),
+            }),
+        });
+        if (maintenance.events.length === 0) {
+            return;
+        }
+        ConversationTurnMemoryMaintenance.appendEvents({
+            ...args,
+            events: maintenance.events,
+        });
+    }
+    static appendEvents(args) {
+        const nextTrace = [...ConversationTurnMemoryMaintenance.readTraceEvents(args.traceFile), ...args.events];
+        writeFileSync(args.traceFile, `${JSON.stringify(nextTrace, null, 2)}\n`, 'utf8');
+        const repository = new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath });
+        const sessions = repository.list(true);
+        const nextSessions = sessions.map((session) => {
+            if (session.id !== args.sessionId) {
+                return session;
+            }
+            return ChatSessionRecords.touch({
+                ...session,
+                turns: session.turns.map((turn, index) => index === session.turns.length - 1
+                    ? {
+                        ...turn,
+                        events: summarizeTrace(nextTrace),
+                    }
+                    : turn),
+            });
+        });
+        repository.save(nextSessions);
+    }
+    static appendAgentLoopTrace(result, events) {
+        if (events.length === 0) {
+            return {
+                ...result,
+                state: {
+                    ...result.state,
+                    trace: result.trace,
+                },
+            };
+        }
+        const trace = [...result.trace, ...events];
+        return {
+            ...result,
+            trace,
+            state: {
+                ...result.state,
+                trace,
+            },
+        };
+    }
+    static readTraceEvents(path) {
+        try {
+            const parsed = JSON.parse(readFileSync(path, 'utf8'));
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    static createFailureEvent(args) {
+        return {
+            type: 'memory.maintenance_failed',
+            runId: `memory-run-${Date.now()}`,
+            error: args.error instanceof Error ? args.error.message : String(args.error),
+            candidateIds: [],
+            step: ConversationTurnMemoryMaintenance.nextTraceStep(args.trace),
+            timestamp: new Date().toISOString(),
+        };
+    }
+    static nextTraceStep(trace) {
+        return trace.reduce((max, event) => ('step' in event ? Math.max(max, event.step) : max), 0) + 1;
+    }
+}
+//# sourceMappingURL=turn-memory-maintenance.js.map

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.js.map

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

package/dist/src/core/chat/engine/turns/memory/types.d.ts

@@ -0,0 +1,29 @@
+import type { LlmAdapter } from '../../../../../core/llm/types.js';
+import type { AgentLoopResult } from '../../../../../core/runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../../../core/runtime/events.js';
+export type RunInlineTurnMemoryMaintenanceArgs = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    result: AgentLoopResult;
+    onEvent?: (event: AgentLoopEvent) => void;
+};
+export type ScheduleBackgroundTurnMemoryMaintenanceArgs = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    trace: AgentLoopResult['trace'];
+    traceFile: string;
+    sessionStoragePath: string;
+    sessionId: string;
+    runId: string;
+    onEvent?: (event: AgentLoopEvent) => void;
+};
+export type RunMemoryMaintenanceCoreArgs = Pick<RunInlineTurnMemoryMaintenanceArgs, 'memoryRoot' | 'llm' | 'source'> & {
+    trace: AgentLoopResult['trace'];
+};
+export type TurnMemoryMaintenanceRuntimeInput = Pick<RunInlineTurnMemoryMaintenanceArgs, 'memoryRoot' | 'llm' | 'source' | 'onEvent'>;
+export type AppendTurnMemoryMaintenanceEventsArgs = Pick<ScheduleBackgroundTurnMemoryMaintenanceArgs, 'traceFile' | 'sessionStoragePath' | 'sessionId'> & {
+    events: AgentLoopResult['trace'];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAC7C,kCAAkC,EAClC,YAAY,GAAG,KAAK,GAAG,QAAQ,CAChC,GAAG;IACF,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,kCAAkC,EAClC,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAC5C,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG,IAAI,CACtD,2CAA2C,EAC3C,WAAW,GAAG,oBAAoB,GAAG,WAAW,CACjD,GAAG;IACF,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC"}

package/dist/src/core/chat/engine/turns/memory/types.js

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

package/dist/src/core/chat/engine/turns/memory/types.js.map

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

package/dist/src/core/chat/engine/turns/persistence/index.d.ts

@@ -0,0 +1,4 @@
+export { ConversationTurnArtifacts } from './turn-artifacts.js';
+export { ConversationTurnPersistenceService } from './turn-persistence-service.js';
+export type { PersistChatTurnArtifacts, PersistChatTurnCompactionStatus, PersistChatTurnResult, PersistChatTurnResultArgs, PersistCompletedChatTurnArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,YAAY,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,3 @@
+export { ConversationTurnArtifacts } from './turn-artifacts.js';
+export { ConversationTurnPersistenceService } from './turn-persistence-service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.d.ts

@@ -0,0 +1,9 @@
+import type { PersistChatTurnArtifacts, PersistChatTurnResult, PersistChatTurnResultArgs } from './types.js';
+/**
+ * Builds persisted artifacts for a completed turn without owning storage.
+ */
+export declare class ConversationTurnArtifacts {
+    static build(args: PersistChatTurnResultArgs): Promise<PersistChatTurnArtifacts>;
+    static persist(args: PersistChatTurnResultArgs): Promise<PersistChatTurnResult>;
+}
+//# sourceMappingURL=turn-artifacts.d.ts.map

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-artifacts.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/turn-artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,yBAAyB;WACvB,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;WAwCzE,OAAO,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CActF"}

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.js

@@ -0,0 +1,60 @@
+import { ConversationCompactionService } from '../../../../../core/chat/engine/compaction/index.js';
+import { ConversationTurnFailureMessages } from '../../../../../core/chat/engine/turns/failure/index.js';
+import { ChatSessionRecords } from '../../../../../core/chat/engine/sessions/records/index.js';
+import { TraceWriter } from '../trace/index.js';
+/**
+ * Builds persisted artifacts for a completed turn without owning storage.
+ */
+export class ConversationTurnArtifacts {
+    static async build(args) {
+        const compactionRuntime = args;
+        const sourceHistory = args.result.transcript;
+        const compactionRequest = {
+            usage: args.result.usage,
+            toolNames: args.toolNames,
+            goal: args.prompt,
+        };
+        const compacted = await ConversationCompactionService.compact({
+            history: sourceHistory,
+            runtime: compactionRuntime,
+            session: args.session,
+            request: compactionRequest,
+            summarizer: args.summarizer,
+            onStatusChange: (event) => args.onCompactionStatus?.(event, sourceHistory),
+        });
+        const traceFile = TraceWriter.write(args.traceDir, args.result.trace);
+        const turn = ChatSessionRecords.buildTurnSummary({
+            id: args.createTurnId(),
+            prompt: args.prompt,
+            result: args.result,
+            traceFile,
+            traceSummarizerRegistry: args.traceSummarizerRegistry,
+        });
+        const summary = args.result.outcome === 'error'
+            ? ConversationTurnFailureMessages.format(args.result.summary, {
+                model: compactionRuntime.model,
+                estimatedHistoryTokens: ConversationCompactionService.estimateTokens(args.historyForTokenEstimate),
+            })
+            : args.result.summary;
+        return {
+            compacted,
+            summary,
+            traceFile,
+            turn,
+        };
+    }
+    static async persist(args) {
+        const artifacts = await ConversationTurnArtifacts.build(args);
+        const session = ChatSessionRecords.applyCompletedTurn({
+            session: args.session,
+            prompt: args.prompt,
+            compacted: artifacts.compacted,
+            turn: artifacts.turn,
+        });
+        return {
+            ...artifacts,
+            session,
+        };
+    }
+}
+//# sourceMappingURL=turn-artifacts.js.map

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-artifacts.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/turn-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAA+B;QAChD,MAAM,iBAAiB,GAAiC,IAAI,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAC7C,MAAM,iBAAiB,GAAiC;YACtD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,MAAM;SAClB,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,6BAA6B,CAAC,OAAO,CAAC;YAC5D,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC;SAC3E,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,kBAAkB,CAAC,gBAAgB,CAAC;YAC/C,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS;YACT,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;SACtD,CAAC,CAAC;QACH,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO;YAC7B,CAAC,CAAC,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC1D,KAAK,EAAE,iBAAiB,CAAC,KAAK;gBAC9B,sBAAsB,EAAE,6BAA6B,CAAC,cAAc,CAAC,IAAI,CAAC,uBAAuB,CAAC;aACnG,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAE1B,OAAO;YACL,SAAS;YACT,OAAO;YACP,SAAS;YACT,IAAI;SACL,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAA+B;QAClD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,kBAAkB,CAAC;YACpD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,IAAI,EAAE,SAAS,CAAC,IAAI;SACrB,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,SAAS;YACZ,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/persistence/turn-persistence-service.d.ts

@@ -0,0 +1,10 @@
+import type { PersistChatTurnResult, PersistCompletedChatTurnArgs, PersistFinalCompactionRunningSeedArgs } from './types.js';
+/**
+ * Owns writing the completed turn back to the session catalog.
+ */
+export declare class ConversationTurnPersistenceService {
+    static persistCompleted(args: PersistCompletedChatTurnArgs): Promise<PersistChatTurnResult>;
+    static persistFinalCompactionRunningSeed(args: PersistFinalCompactionRunningSeedArgs): void;
+    private static buildRunningCompactionContext;
+}
+//# sourceMappingURL=turn-persistence-service.d.ts.map

package/dist/src/core/chat/engine/turns/persistence/turn-persistence-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-persistence-service.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/turn-persistence-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,qBAAqB,EACrB,4BAA4B,EAE5B,qCAAqC,EACtC,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,kCAAkC;WAChC,gBAAgB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsBjG,MAAM,CAAC,iCAAiC,CAAC,IAAI,EAAE,qCAAqC;IAcpF,OAAO,CAAC,MAAM,CAAC,6BAA6B;CAO7C"}

package/dist/src/core/chat/engine/turns/persistence/turn-persistence-service.js

@@ -0,0 +1,50 @@
+import { ConversationCompactionService } from '../../../../../core/chat/engine/compaction/index.js';
+import { ChatSessionRecords } from '../../../../../core/chat/engine/sessions/records/index.js';
+import { FileChatSessionRepository } from '../../../../../core/chat/engine/sessions/repository/index.js';
+import { ConversationTurnArtifacts } from './turn-artifacts.js';
+/**
+ * Owns writing the completed turn back to the session catalog.
+ */
+export class ConversationTurnPersistenceService {
+    static async persistCompleted(args) {
+        const artifactInput = args;
+        const persisted = await ConversationTurnArtifacts.persist({
+            ...artifactInput,
+            summarizer: { credentialSource: args.credentialSource },
+            createTurnId: () => `server-turn-${Date.now()}`,
+            onCompactionStatus: (event) => {
+                args.host.onCompactionStatus?.(event, 'final');
+                if (event.status === 'running') {
+                    ConversationTurnPersistenceService.persistFinalCompactionRunningSeed({
+                        ...args,
+                        archivePath: event.archivePath,
+                    });
+                }
+            },
+        });
+        new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath })
+            .save(args.sessions.map((candidate) => (candidate.id === args.session.id ? persisted.session : candidate)));
+        return persisted;
+    }
+    static persistFinalCompactionRunningSeed(args) {
+        const sourceHistory = args.result.transcript;
+        const compactionSeed = ChatSessionRecords.touch({
+            ...args.session,
+            history: sourceHistory,
+            context: ConversationTurnPersistenceService.buildRunningCompactionContext({
+                ...args,
+                sourceHistory,
+            }),
+        });
+        new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath })
+            .save(args.sessions.map((candidate) => (candidate.id === args.session.id ? compactionSeed : candidate)));
+    }
+    static buildRunningCompactionContext(args) {
+        return ConversationCompactionService.buildSessionRunningContext({
+            session: args.session,
+            history: args.sourceHistory,
+            lastArchivePath: args.archivePath,
+        });
+    }
+}
+//# sourceMappingURL=turn-persistence-service.js.map

package/dist/src/core/chat/engine/turns/persistence/turn-persistence-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-persistence-service.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/turn-persistence-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAShE;;GAEG;AACH,MAAM,OAAO,kCAAkC;IAC7C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAkC;QAC9D,MAAM,aAAa,GAAiC,IAAI,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC;YACxD,GAAG,aAAa;YAChB,UAAU,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE;YACvD,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE;YAC/C,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC5B,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/B,kCAAkC,CAAC,iCAAiC,CAAC;wBACnE,GAAG,IAAI;wBACP,WAAW,EAAE,KAAK,CAAC,WAAW;qBAC/B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,yBAAyB,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;aAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9G,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,iCAAiC,CAAC,IAA2C;QAClF,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAC7C,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC;YAC9C,GAAG,IAAI,CAAC,OAAO;YACf,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,kCAAkC,CAAC,6BAA6B,CAAC;gBACxE,GAAG,IAAI;gBACP,aAAa;aACd,CAAC;SACH,CAAC,CAAC;QACH,IAAI,yBAAyB,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;aAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC;IAEO,MAAM,CAAC,6BAA6B,CAAC,IAA8C;QACzF,OAAO,6BAA6B,CAAC,0BAA0B,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,aAAa;YAC3B,eAAe,EAAE,IAAI,CAAC,WAAW;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/persistence/types.d.ts

@@ -0,0 +1,69 @@
+import type { AgentLoopResult } from '../../../../../core/runtime/agent-loop.js';
+import type { RunResult } from '../../../../../core/types.js';
+import type { ChatMessage } from '../../../../../core/llm/types.js';
+import type { ProviderCredentialSource } from '../../../../../core/runtime/api-keys.js';
+import type { TraceSummarizerRegistry } from '../../../../../core/observability/trace-summarizers.js';
+import type { ChatSession, TurnSummary } from '../../../../../core/chat/types.js';
+import type { ChatTurnHostPort } from '../host/index.js';
+import type { ConversationCompactionResult, ConversationCompactionOptions } from '../../../../../core/chat/engine/compaction/index.js';
+export type PersistChatTurnCompactionStatus = {
+    status: 'running' | 'finished' | 'failed';
+    archivePath?: string;
+    summaryPath?: string;
+    error?: string;
+};
+export type PersistChatTurnResultArgs = {
+    result: RunResult;
+    prompt: string;
+    session: ChatSession;
+    model: string;
+    stateRoot: string;
+    traceDir: string;
+    systemContext?: string;
+    toolNames: string[];
+    historyForTokenEstimate: ChatMessage[];
+    summarizer: ConversationCompactionOptions['summarizer'];
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
+    createTurnId: () => string;
+    onCompactionStatus?: (event: PersistChatTurnCompactionStatus, sourceHistory: ChatMessage[]) => void;
+};
+export type PersistTurnCompactionRuntime = Pick<PersistChatTurnResultArgs, 'model' | 'stateRoot' | 'systemContext'>;
+export type PersistTurnCompactionRequest = {
+    usage?: RunResult['usage'];
+    toolNames: string[];
+    goal: string;
+};
+export type PersistChatTurnArtifacts = {
+    compacted: ConversationCompactionResult;
+    summary: string;
+    traceFile: string;
+    turn: TurnSummary;
+};
+export type PersistChatTurnResult = PersistChatTurnArtifacts & {
+    session: ChatSession;
+};
+export type PersistCompletedChatTurnBase = {
+    result: AgentLoopResult;
+    prompt: string;
+    session: ChatSession;
+    model: string;
+    stateRoot: string;
+    traceDir: string;
+    systemContext?: string;
+    toolNames: string[];
+    historyForTokenEstimate: ChatMessage[];
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
+};
+export type PersistCompletedChatTurnArgs = PersistCompletedChatTurnBase & {
+    sessions: ChatSession[];
+    sessionStoragePath: string;
+    credentialSource: ProviderCredentialSource;
+    host: Pick<ChatTurnHostPort, 'onCompactionStatus'>;
+};
+export type PersistFinalCompactionRunningSeedArgs = PersistCompletedChatTurnArgs & {
+    archivePath?: string;
+};
+export type PersistFinalCompactionRunningContextArgs = PersistFinalCompactionRunningSeedArgs & {
+    sourceHistory: PersistFinalCompactionRunningSeedArgs['result']['transcript'];
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/core/chat/engine/turns/persistence/types.js

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

package/dist/src/core/chat/engine/turns/persistence/types.js.map

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

package/dist/src/core/chat/engine/turns/preflight/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationTurnPreflightService } from './turn-preflight-service.js';
+export type { ChatTurnPreflightCompactionStatus, PrepareChatSessionTurnArgs, PrepareChatSessionTurnResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/preflight/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EACV,iCAAiC,EACjC,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

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

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

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

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

package/dist/src/core/chat/engine/turns/preflight/turn-preflight-service.d.ts

@@ -0,0 +1,14 @@
+import type { PersistPreflightRunningSeedArgs, PersistPreparedChatSessionTurnArgs, PrepareChatSessionTurnArgs, PrepareChatSessionTurnResult } from './types.js';
+/**
+ * Owns pre-run session lease acquisition and preflight compaction persistence.
+ */
+export declare class ConversationTurnPreflightService {
+    static prepare(args: PrepareChatSessionTurnArgs): Promise<PrepareChatSessionTurnResult>;
+    static persistRunningSeed(args: PersistPreflightRunningSeedArgs): void;
+    static persistPrepared(args: PersistPreparedChatSessionTurnArgs): Extract<PrepareChatSessionTurnResult, {
+        ok: true;
+    }>;
+    private static readRequiredFallbackSession;
+    private static buildRunningCompactionContext;
+}
+//# sourceMappingURL=turn-preflight-service.d.ts.map

package/dist/src/core/chat/engine/turns/preflight/turn-preflight-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-preflight-service.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/preflight/turn-preflight-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EAGlC,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,gCAAgC;WAC9B,OAAO,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IA4C7F,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,+BAA+B;IAS/D,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,kCAAkC,GAAG,OAAO,CAAC,4BAA4B,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC;IAgBrH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAS1C,OAAO,CAAC,MAAM,CAAC,6BAA6B;CAO7C"}