@roackb2/heddle 1.2.0 → 1.4.0

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"}

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

@@ -0,0 +1,85 @@
+import { ChatSessionRecords } from '../../../../../core/chat/engine/sessions/records/index.js';
+import { ConversationCompactionService } from '../../../../../core/chat/engine/compaction/index.js';
+import { ChatSessionLeases } from '../../../../../core/chat/engine/sessions/leases/index.js';
+import { FileChatSessionRepository } from '../../../../../core/chat/engine/sessions/repository/index.js';
+/**
+ * Owns pre-run session lease acquisition and preflight compaction persistence.
+ */
+export class ConversationTurnPreflightService {
+    static async prepare(args) {
+        const persistedSession = new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath })
+            .read(args.sessionId, true);
+        const leaseConflict = persistedSession ? ChatSessionLeases.conflict(persistedSession, args.leaseOwner) : undefined;
+        if (leaseConflict) {
+            return {
+                ok: false,
+                reason: 'lease_conflict',
+                message: leaseConflict,
+            };
+        }
+        const leasedSession = persistedSession ? ChatSessionRecords.touch(ChatSessionLeases.acquire(persistedSession, args.leaseOwner)) : undefined;
+        const initialHistory = leasedSession?.history ?? args.fallbackHistory;
+        const compactionRuntime = args;
+        const compactionRequest = {
+            toolNames: args.toolNames,
+            goal: args.prompt,
+        };
+        const preflightCompacted = await ConversationCompactionService.compact({
+            history: initialHistory,
+            runtime: compactionRuntime,
+            session: { id: args.sessionId },
+            request: compactionRequest,
+            summarizer: args.summarizer,
+            onStatusChange: (event) => {
+                args.host.onCompactionStatus?.(event, 'preflight');
+                if (event.status === 'running' && leasedSession) {
+                    ConversationTurnPreflightService.persistRunningSeed({
+                        ...args,
+                        leasedSession,
+                        archivePath: event.archivePath,
+                    });
+                }
+            },
+        });
+        return ConversationTurnPreflightService.persistPrepared({
+            ...args,
+            session: persistedSession ?? ConversationTurnPreflightService.readRequiredFallbackSession(args.sessions, args.sessionId),
+            compacted: preflightCompacted,
+        });
+    }
+    static persistRunningSeed(args) {
+        const compactionSeed = ChatSessionRecords.touch({
+            ...args.leasedSession,
+            context: ConversationTurnPreflightService.buildRunningCompactionContext(args),
+        });
+        new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath })
+            .save(args.sessions.map((candidate) => (candidate.id === args.sessionId ? compactionSeed : candidate)));
+    }
+    static persistPrepared(args) {
+        const preparedSession = ChatSessionRecords.touch(ChatSessionRecords.applyCompactedHistory({
+            session: args.session,
+            compacted: args.compacted,
+        }));
+        new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath })
+            .save(args.sessions.map((candidate) => (candidate.id === args.session.id ? preparedSession : candidate)));
+        return {
+            ok: true,
+            session: preparedSession,
+            compacted: args.compacted,
+        };
+    }
+    static readRequiredFallbackSession(sessions, sessionId) {
+        const session = sessions.find((candidate) => candidate.id === sessionId);
+        if (!session) {
+            throw new Error(`Chat session not found: ${sessionId}`);
+        }
+        return session;
+    }
+    static buildRunningCompactionContext(args) {
+        return ConversationCompactionService.buildSessionRunningContext({
+            session: args.leasedSession,
+            lastArchivePath: args.archivePath,
+        });
+    }
+}
+//# sourceMappingURL=turn-preflight-service.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { ChatMessage } from '../../../../../core/llm/types.js';
+import type { ChatSession } from '../../../../../core/chat/types.js';
+import type { ChatSessionLeaseOwner } from '../../../../../core/chat/engine/sessions/leases/index.js';
+import type { ChatTurnHostPort } from '../host/index.js';
+import type { ConversationCompactionResult, ConversationCompactionOptions } from '../../../../../core/chat/engine/compaction/index.js';
+export type ChatTurnPreflightCompactionStatus = {
+    status: 'running' | 'finished' | 'failed';
+    archivePath?: string;
+    summaryPath?: string;
+    error?: string;
+};
+export type PrepareChatSessionTurnArgs = {
+    sessionStoragePath: string;
+    sessionId: string;
+    fallbackHistory: ChatMessage[];
+    prompt: string;
+    model: string;
+    stateRoot: string;
+    systemContext?: string;
+    toolNames: string[];
+    summarizer: ConversationCompactionOptions['summarizer'];
+    leaseOwner: ChatSessionLeaseOwner;
+    sessions: ChatSession[];
+    host: Pick<ChatTurnHostPort, 'onCompactionStatus'>;
+};
+export type PreflightTurnCompactionRuntime = Pick<PrepareChatSessionTurnArgs, 'model' | 'stateRoot' | 'systemContext'>;
+export type PreflightTurnCompactionRequest = {
+    toolNames: string[];
+    goal: string;
+};
+export type PersistPreflightRunningSeedArgs = Pick<PrepareChatSessionTurnArgs, 'sessionStoragePath' | 'sessions' | 'sessionId'> & {
+    leasedSession: ChatSession;
+    archivePath?: string;
+};
+export type PersistPreparedChatSessionTurnArgs = Pick<PrepareChatSessionTurnArgs, 'sessionStoragePath' | 'sessions'> & {
+    session: ChatSession;
+    compacted: ConversationCompactionResult;
+};
+export type PrepareChatSessionTurnResult = {
+    ok: true;
+    session: ChatSession;
+    compacted: ConversationCompactionResult;
+} | {
+    ok: false;
+    reason: 'lease_conflict';
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/preflight/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACxD,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,0BAA0B,EAC1B,OAAO,GAAG,WAAW,GAAG,eAAe,CACxC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,0BAA0B,EAC1B,oBAAoB,GAAG,UAAU,GAAG,WAAW,CAChD,GAAG;IACF,aAAa,EAAE,WAAW,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,IAAI,CACnD,0BAA0B,EAC1B,oBAAoB,GAAG,UAAU,CAClC,GAAG;IACF,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,4BAA4B,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,4BAA4B,CAAC;CACzC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,3 @@
+export { ConversationTurnRuntimeResolver } from './runtime-resolver.js';
+export type { ChatTurnRuntime, ConversationTurnRuntimeConfig, ConversationTurnRuntimeSession, ResolveConversationTurnRuntimeArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EACV,eAAe,EACf,6BAA6B,EAC7B,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,YAAY,CAAC"}

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

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

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

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

package/dist/src/core/chat/engine/turns/runtime/runtime-resolver.d.ts

@@ -0,0 +1,14 @@
+import type { ChatTurnRuntime, ResolveConversationTurnRuntimeArgs } from './types.js';
+/**
+ * Resolves the model/provider/runtime adapter for a persisted conversation turn.
+ */
+export declare class ConversationTurnRuntimeResolver {
+    static resolveModel(args: {
+        sessionModel?: string;
+        env?: Pick<NodeJS.ProcessEnv, 'OPENAI_MODEL' | 'ANTHROPIC_MODEL'>;
+    }): string;
+    static resolve(args: ResolveConversationTurnRuntimeArgs): ChatTurnRuntime;
+    private static credentialRuntime;
+    private static assertCredential;
+}
+//# sourceMappingURL=runtime-resolver.d.ts.map

package/dist/src/core/chat/engine/turns/runtime/runtime-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-resolver.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/runtime/runtime-resolver.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAEtF;;GAEG;AACH,qBAAa,+BAA+B;IAC1C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAC;KACnE,GAAG,MAAM;IAKV,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,kCAAkC,GAAG,eAAe;IAyCzE,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAShC,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAOhC"}

package/dist/src/core/chat/engine/turns/runtime/runtime-resolver.js

@@ -0,0 +1,69 @@
+import { join } from 'node:path';
+import { DEFAULT_OPENAI_MODEL } from '../../../../../core/config.js';
+import { createLlmAdapter } from '../../../../../core/llm/factory.js';
+import { inferProviderFromModel } from '../../../../../core/llm/providers.js';
+import { formatMissingProviderCredentialMessage, hasProviderCredentialForModel, resolveApiKeyForModel, resolveProviderCredentialSourceForModel, } from '../../../../../core/runtime/api-keys.js';
+import { appendAwarenessDomainSystemContext } from '../../../../../core/awareness/domain-prompt.js';
+import { appendMemoryCatalogSystemContext } from '../../../../../core/memory/catalog.js';
+/**
+ * Resolves the model/provider/runtime adapter for a persisted conversation turn.
+ */
+export class ConversationTurnRuntimeResolver {
+    static resolveModel(args) {
+        const env = args.env ?? process.env;
+        return args.sessionModel ?? env.OPENAI_MODEL ?? env.ANTHROPIC_MODEL ?? DEFAULT_OPENAI_MODEL;
+    }
+    static resolve(args) {
+        const { config, session } = args;
+        const model = ConversationTurnRuntimeResolver.resolveModel({
+            sessionModel: session.model,
+            env: config.env,
+        });
+        const provider = inferProviderFromModel(model);
+        const credentialRuntime = ConversationTurnRuntimeResolver.credentialRuntime(config);
+        const apiKey = config.apiKey ?? resolveApiKeyForModel(model, credentialRuntime);
+        const providerCredentialSource = resolveProviderCredentialSourceForModel(model, {
+            ...credentialRuntime,
+            apiKey,
+            apiKeyProvider: config.apiKey ? 'explicit' : apiKey ? provider : undefined,
+        });
+        ConversationTurnRuntimeResolver.assertCredential({
+            model,
+            credentialRuntime,
+        });
+        const memoryDir = join(config.stateRoot, 'memory');
+        return {
+            model,
+            provider,
+            apiKey,
+            providerCredentialSource,
+            memoryDir,
+            systemContext: appendAwarenessDomainSystemContext(appendMemoryCatalogSystemContext({
+                systemContext: config.systemContext,
+                memoryRoot: memoryDir,
+            })),
+            reasoningEffort: session.reasoningEffort,
+            llm: createLlmAdapter({
+                model,
+                apiKey,
+                credentialStorePath: config.credentialStorePath,
+                reasoningEffort: session.reasoningEffort,
+            }),
+        };
+    }
+    static credentialRuntime(config) {
+        return {
+            apiKey: config.apiKey,
+            apiKeyProvider: config.apiKey ? 'explicit' : undefined,
+            credentialStorePath: config.credentialStorePath,
+            preferApiKey: config.preferApiKey,
+        };
+    }
+    static assertCredential(args) {
+        const hasCredential = hasProviderCredentialForModel(args.model, args.credentialRuntime);
+        if (!hasCredential) {
+            throw new Error(formatMissingProviderCredentialMessage(args.model));
+        }
+    }
+}
+//# sourceMappingURL=runtime-resolver.js.map

package/dist/src/core/chat/engine/turns/runtime/runtime-resolver.js.map

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

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

@@ -0,0 +1,24 @@
+import type { LlmAdapter, LlmProvider, ReasoningEffort } from '../../../../../core/llm/types.js';
+import type { ApiKeyRuntime, ProviderCredentialSource } from '../../../../../core/runtime/api-keys.js';
+import type { ChatSession } from '../../../../../core/chat/types.js';
+export type ChatTurnRuntime = {
+    model: string;
+    reasoningEffort?: ReasoningEffort;
+    provider: LlmProvider;
+    apiKey: string | undefined;
+    providerCredentialSource: ProviderCredentialSource;
+    memoryDir: string;
+    systemContext: string | undefined;
+    llm: LlmAdapter;
+};
+export type ConversationTurnRuntimeConfig = ApiKeyRuntime & {
+    stateRoot: string;
+    systemContext?: string;
+    env?: Pick<NodeJS.ProcessEnv, 'OPENAI_MODEL' | 'ANTHROPIC_MODEL'>;
+};
+export type ConversationTurnRuntimeSession = Pick<ChatSession, 'model' | 'reasoningEffort'>;
+export type ResolveConversationTurnRuntimeArgs = {
+    config: ConversationTurnRuntimeConfig;
+    session: ConversationTurnRuntimeSession;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,GAAG,EAAE,UAAU,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,aAAa,GAAG;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,iBAAiB,CAAC,CAAC;AAE5F,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,6BAA6B,CAAC;IACtC,OAAO,EAAE,8BAA8B,CAAC;CACzC,CAAC"}

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

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

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

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

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

@@ -1,6 +1,17 @@
-import type { NormalizedConversationEngineConfig } from '../config.js';
-import type { ConversationTurnService } from '../types.js';
-export declare function createConversationTurnService(args: {
-    config: NormalizedConversationEngineConfig;
-}): ConversationTurnService;
+import type { NormalizedConversationEngineConfig } from '../../../../core/chat/engine/config.js';
+import type { ClearConversationTurnLeaseInput, ContinueConversationTurnInput, ConversationTurnService, SubmitConversationTurnInput, SubmitConversationTurnResult } from '../../../../core/chat/engine/types.js';
+import { type ChatSessionLeaseOwner } from '../../../../core/chat/engine/sessions/leases/index.js';
+import type { RunConversationTurnArgs, RunConversationTurnResult } from './types.js';
+export declare class EngineConversationTurnService implements ConversationTurnService {
+    private readonly config;
+    private readonly sessions;
+    constructor(config: NormalizedConversationEngineConfig);
+    submit(input: SubmitConversationTurnInput): Promise<SubmitConversationTurnResult>;
+    continue(input: ContinueConversationTurnInput): Promise<SubmitConversationTurnResult>;
+    clearLease(input: ClearConversationTurnLeaseInput): void;
+    static run(args: RunConversationTurnArgs): Promise<RunConversationTurnResult>;
+    static clearLeaseFromStorage(sessionStoragePath: string, sessionId: string, owner: ChatSessionLeaseOwner): void;
+    private static hostInput;
+    private static turnHost;
+}
 //# sourceMappingURL=service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,kCAAkC,CAAC;CAC5C,GAAG,uBAAuB,CAkD1B"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAE7B,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAK5G,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAO1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,6BAA8B,YAAW,uBAAuB;IAG/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAEzB,MAAM,EAAE,kCAAkC;IAIjE,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAcjF,QAAQ,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAY3F,UAAU,CAAC,KAAK,EAAE,+BAA+B,GAAG,IAAI;WAQ3C,GAAG,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA2FnF,MAAM,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAkB/G,OAAO,CAAC,MAAM,CAAC,SAAS;IAYxB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAaxB"}