@roackb2/heddle 0.0.38 → 1.0.0

package/dist/src/core/chat/engine/turns/context.js

@@ -0,0 +1,41 @@
+import { createDefaultAgentTools } from '../../../runtime/default-tools.js';
+import { loadChatSessions } from '../sessions/storage.js';
+import { resolveConversationTurnRuntime } from './runtime.js';
+export function prepareConversationTurnContext(args) {
+    const sessions = loadChatSessions(args.sessionStoragePath, true);
+    const session = sessions.find((candidate) => candidate.id === args.sessionId);
+    if (!session) {
+        throw new Error(`Chat session not found: ${args.sessionId}`);
+    }
+    const runtime = resolveConversationTurnRuntime({
+        stateRoot: args.stateRoot,
+        sessionModel: session.model,
+        apiKey: args.apiKey,
+        preferApiKey: args.preferApiKey,
+        credentialStorePath: args.credentialStorePath,
+        systemContext: args.systemContext,
+    });
+    const tools = createDefaultAgentTools({
+        model: runtime.model,
+        apiKey: runtime.apiKey,
+        providerCredentialSource: runtime.providerCredentialSource,
+        credentialStorePath: args.credentialStorePath,
+        workspaceRoot: args.workspaceRoot,
+        memoryDir: runtime.memoryDir,
+        searchIgnoreDirs: [],
+        includePlanTool: true,
+    });
+    return {
+        sessions,
+        session,
+        runtime,
+        tools,
+        toolNames: tools.map((tool) => tool.name),
+        leaseOwner: args.leaseOwner ?? {
+            ownerKind: 'ask',
+            ownerId: `submit-${process.pid}`,
+            clientLabel: 'another Heddle client',
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/src/core/chat/engine/turns/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,8BAA8B,EAAwB,MAAM,cAAc,CAAC;AAuBpF,MAAM,UAAU,8BAA8B,CAAC,IAAwC;IACrF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,8BAA8B,CAAC;QAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,OAAO,CAAC,KAAK;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,uBAAuB,CAAC;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;QAC1D,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,gBAAgB,EAAE,EAAE;QACpB,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,KAAK;QACL,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI;YAC7B,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE;YAChC,WAAW,EAAE,uBAAuB;SACrC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { ToolApprovalDecision } from '../../../approvals/types.js';
+import type { RunAgentLoopOptions } from '../../../runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../runtime/events.js';
+import type { ToolCall, ToolDefinition } from '../../../types.js';
+import type { PersistChatTurnCompactionStatus } from './result.js';
+import type { ChatTurnPreflightCompactionStatus } from './preflight.js';
+export type ChatTurnApprovalRequest = {
+    call: ToolCall;
+    tool: ToolDefinition;
+};
+export interface ChatTurnEventPort {
+    onAgentLoopEvent?(event: AgentLoopEvent): void;
+}
+export interface ChatTurnCompactionPort {
+    onPreflightCompactionStatus?(event: ChatTurnPreflightCompactionStatus): void;
+    onFinalCompactionStatus?(event: PersistChatTurnCompactionStatus): void;
+}
+export interface ChatTurnApprovalPort {
+    requestToolApproval?(request: ChatTurnApprovalRequest): Promise<ToolApprovalDecision>;
+}
+export interface ChatTurnHostPort {
+    events?: ChatTurnEventPort;
+    compaction?: ChatTurnCompactionPort;
+    approvals?: ChatTurnApprovalPort;
+}
+export type CreateChatTurnHostBridgeArgs = {
+    host?: ChatTurnHostPort;
+    onCompactionStatus?: (event: ChatTurnPreflightCompactionStatus | PersistChatTurnCompactionStatus) => void;
+};
+export type ChatTurnHostBridge = {
+    onAgentLoopEvent?: (event: AgentLoopEvent) => void;
+    approveToolCall?: RunAgentLoopOptions['approveToolCall'];
+    notifyPreflightCompactionStatus(event: ChatTurnPreflightCompactionStatus): void;
+    notifyFinalCompactionStatus(event: PersistChatTurnCompactionStatus): void;
+};
+export declare function createChatTurnHostBridge(args: CreateChatTurnHostBridgeArgs): ChatTurnHostBridge;
+//# sourceMappingURL=host-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/host-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAExE,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,2BAA2B,CAAC,CAAC,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAAC;IAC7E,uBAAuB,CAAC,CAAC,KAAK,EAAE,+BAA+B,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,GAAG,+BAA+B,KAAK,IAAI,CAAC;CAC3G,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACzD,+BAA+B,CAAC,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAAC;IAChF,2BAA2B,CAAC,KAAK,EAAE,+BAA+B,GAAG,IAAI,CAAC;CAC3E,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,kBAAkB,CAoB/F"}

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

@@ -0,0 +1,20 @@
+export function createChatTurnHostBridge(args) {
+    const onAgentLoopEvent = args.host?.events?.onAgentLoopEvent;
+    const requestToolApproval = args.host?.approvals?.requestToolApproval;
+    const approveToolCall = requestToolApproval
+        ? ((call, tool) => requestToolApproval({ call, tool }) ?? Promise.resolve({ approved: false, reason: 'Missing approval port.' }))
+        : undefined;
+    return {
+        onAgentLoopEvent,
+        approveToolCall,
+        notifyPreflightCompactionStatus(event) {
+            args.onCompactionStatus?.(event);
+            args.host?.compaction?.onPreflightCompactionStatus?.(event);
+        },
+        notifyFinalCompactionStatus(event) {
+            args.onCompactionStatus?.(event);
+            args.host?.compaction?.onFinalCompactionStatus?.(event);
+        },
+    };
+}
+//# sourceMappingURL=host-bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/host-bridge.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,wBAAwB,CAAC,IAAkC;IACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC;IAC7D,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC;IACtE,MAAM,eAAe,GAAuD,mBAAmB;QAC7F,CAAC,CAAC,CAAC,CAAC,IAAc,EAAE,IAAoB,EAAE,EAAE,CACxC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAClH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,gBAAgB;QAChB,eAAe;QACf,+BAA+B,CAAC,KAAK;YACnC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,2BAA2B,CAAC,KAAK;YAC/B,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ConversationEngineHost, NormalizedConversationEngineHost } from '../types.js';
+export declare function normalizeConversationEngineHost(host?: ConversationEngineHost): NormalizedConversationEngineHost;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gCAAgC,EACjC,MAAM,aAAa,CAAC;AAQrB,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,gCAAgC,CAyC/G"}

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

@@ -0,0 +1,42 @@
+import { projectAgentLoopEventToConversationActivities, projectCompactionStatusToConversationActivities, projectTraceEventToConversationActivities, } from '../../../observability/conversation-activity.js';
+export function normalizeConversationEngineHost(host) {
+    const onActivity = host?.events?.onActivity;
+    const onAgentLoopEvent = host?.events?.onAgentLoopEvent;
+    const onTraceEvent = host?.trace?.onEvent;
+    const turnHost = {
+        events: {
+            onAgentLoopEvent: (event) => {
+                onAgentLoopEvent?.(event);
+                for (const activity of projectAgentLoopEventToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+        },
+        approvals: host?.approvals?.requestToolApproval
+            ? {
+                requestToolApproval: host.approvals.requestToolApproval,
+            }
+            : undefined,
+    };
+    return {
+        turnHost,
+        onAssistantStream: host?.assistant?.onText
+            ? ((update) => {
+                host.assistant?.onText?.(update.text);
+            })
+            : undefined,
+        onTraceEvent: (event) => {
+            onTraceEvent?.(event);
+            for (const activity of projectTraceEventToConversationActivities(event)) {
+                onActivity?.(activity);
+            }
+        },
+        onCompactionStatus: (event) => {
+            host?.compaction?.onStatus?.(event);
+            for (const activity of projectCompactionStatusToConversationActivities(event)) {
+                onActivity?.(activity);
+            }
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/host.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,6CAA6C,EAC7C,+CAA+C,EAC/C,yCAAyC,GAC1C,MAAM,iDAAiD,CAAC;AAGzD,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;IAC5C,MAAM,gBAAgB,GAAG,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC;IACxD,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;IAE1C,MAAM,QAAQ,GAAqB;QACjC,MAAM,EAAE;YACN,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;SACF;QACD,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB;YAC7C,CAAC,CAAC;gBACE,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB;aACxD;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;YACxC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE;gBACV,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACtB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;YACtB,KAAK,MAAM,QAAQ,IAAI,yCAAyC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxE,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;YACpC,KAAK,MAAM,QAAQ,IAAI,+CAA+C,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9E,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { LlmAdapter } from '../../../llm/types.js';
+import type { AgentLoopResult } from '../../../runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../runtime/events.js';
+import type { TraceEvent } from '../../../types.js';
+export type RunInlineTurnMemoryMaintenanceArgs = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    result: AgentLoopResult;
+    onEvent?: (event: AgentLoopEvent) => void;
+};
+export declare function runInlineTurnMemoryMaintenance(args: RunInlineTurnMemoryMaintenanceArgs): Promise<AgentLoopResult>;
+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 declare function scheduleBackgroundTurnMemoryMaintenance(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): void;
+export declare function runBackgroundTurnMemoryMaintenance(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): Promise<void>;
+export declare function appendTurnMemoryMaintenanceEvents(args: {
+    traceFile: string;
+    events: TraceEvent[];
+    sessionStoragePath: string;
+    sessionId: string;
+}): void;
+export declare function appendAgentLoopTrace(result: AgentLoopResult, events: TraceEvent[]): AgentLoopResult;
+//# sourceMappingURL=memory-maintenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-maintenance.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/memory-maintenance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,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,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,kCAAkC,GACvC,OAAO,CAAC,eAAe,CAAC,CAiB1B;AAED,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,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,2CAA2C,QAYxG;AAED,wBAAsB,kCAAkC,CAAC,IAAI,EAAE,2CAA2C,iBAyBzG;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB,QAuBA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,CAoBnG"}

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

@@ -0,0 +1,120 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { runMaintenanceForRecordedCandidates } from '../../../memory/maintenance-integration.js';
+import { summarizeTrace } from '../../../observability/trace-summarizers.js';
+import { loadChatSessions, saveChatSessions, touchSession } from '../sessions/storage.js';
+export async function runInlineTurnMemoryMaintenance(args) {
+    const maintenance = await runMaintenanceForRecordedCandidates({
+        memoryRoot: args.memoryRoot,
+        llm: args.llm,
+        source: args.source,
+        trace: args.result.trace,
+        maxSteps: 20,
+        onTraceEvent: (event) => args.onEvent?.({
+            type: 'trace',
+            runId: args.result.state.runId,
+            event,
+            timestamp: new Date().toISOString(),
+        }),
+    });
+    return appendAgentLoopTrace(args.result, maintenance.events);
+}
+export function scheduleBackgroundTurnMemoryMaintenance(args) {
+    void runBackgroundTurnMemoryMaintenance(args).catch((error) => {
+        args.onEvent?.({
+            type: 'trace',
+            runId: args.runId,
+            event: createMemoryMaintenanceFailureEvent({
+                error,
+                trace: args.trace,
+            }),
+            timestamp: new Date().toISOString(),
+        });
+    });
+}
+export async function runBackgroundTurnMemoryMaintenance(args) {
+    const maintenance = await runMaintenanceForRecordedCandidates({
+        memoryRoot: args.memoryRoot,
+        llm: args.llm,
+        source: args.source,
+        trace: args.trace,
+        maxSteps: 20,
+        onTraceEvent: (event) => args.onEvent?.({
+            type: 'trace',
+            runId: args.runId,
+            event,
+            timestamp: new Date().toISOString(),
+        }),
+    });
+    if (maintenance.events.length === 0) {
+        return;
+    }
+    appendTurnMemoryMaintenanceEvents({
+        traceFile: args.traceFile,
+        events: maintenance.events,
+        sessionStoragePath: args.sessionStoragePath,
+        sessionId: args.sessionId,
+    });
+}
+export function appendTurnMemoryMaintenanceEvents(args) {
+    const nextTrace = [...readTraceEvents(args.traceFile), ...args.events];
+    writeFileSync(args.traceFile, `${JSON.stringify(nextTrace, null, 2)}\n`, 'utf8');
+    const sessions = loadChatSessions(args.sessionStoragePath, true);
+    const nextSessions = sessions.map((session) => {
+        if (session.id !== args.sessionId) {
+            return session;
+        }
+        return touchSession({
+            ...session,
+            turns: session.turns.map((turn, index) => index === session.turns.length - 1
+                ? {
+                    ...turn,
+                    events: summarizeTrace(nextTrace),
+                }
+                : turn),
+        });
+    });
+    saveChatSessions(args.sessionStoragePath, nextSessions);
+}
+export function 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,
+        },
+    };
+}
+function readTraceEvents(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function createMemoryMaintenanceFailureEvent(args) {
+    return {
+        type: 'memory.maintenance_failed',
+        runId: `memory-run-${Date.now()}`,
+        error: args.error instanceof Error ? args.error.message : String(args.error),
+        candidateIds: [],
+        step: nextTraceStep(args.trace),
+        timestamp: new Date().toISOString(),
+    };
+}
+function nextTraceStep(trace) {
+    return trace.reduce((max, event) => ('step' in event ? Math.max(max, event.step) : max), 0) + 1;
+}
+//# sourceMappingURL=memory-maintenance.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { ChatMessage } from '../../../llm/types.js';
+import type { TraceSummarizerRegistry } from '../../../observability/trace-summarizers.js';
+import type { ProviderCredentialSource } from '../../../runtime/api-keys.js';
+import type { AgentLoopResult } from '../../../runtime/agent-loop.js';
+import { type PersistChatTurnResult } from './result.js';
+import type { ChatTurnHostBridge } from './host-bridge.js';
+import type { ChatSession } from '../../types.js';
+export type PersistCompletedChatTurnArgs = {
+    result: AgentLoopResult;
+    prompt: string;
+    session: ChatSession;
+    sessions: ChatSession[];
+    sessionStoragePath: string;
+    model: string;
+    stateRoot: string;
+    traceDir: string;
+    systemContext?: string;
+    toolNames: string[];
+    historyForTokenEstimate: ChatMessage[];
+    credentialSource: ProviderCredentialSource;
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
+    hostBridge: Pick<ChatTurnHostBridge, 'notifyFinalCompactionStatus'>;
+};
+export declare function persistCompletedChatTurn(args: PersistCompletedChatTurnArgs): Promise<PersistChatTurnResult>;
+//# sourceMappingURL=persistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB,EAAE,WAAW,EAAE,CAAC;IACvC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,6BAA6B,CAAC,CAAC;CACrE,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8BjH"}

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

@@ -0,0 +1,45 @@
+import { buildCompactionRunningContext } from '../history/compaction.js';
+import { persistChatTurnResult } from './result.js';
+import { saveChatSessions, touchSession } from '../sessions/storage.js';
+export async function persistCompletedChatTurn(args) {
+    const persisted = await persistChatTurnResult({
+        result: args.result,
+        prompt: args.prompt,
+        session: args.session,
+        model: args.model,
+        stateRoot: args.stateRoot,
+        traceDir: args.traceDir,
+        systemContext: args.systemContext,
+        toolNames: args.toolNames,
+        historyForTokenEstimate: args.historyForTokenEstimate,
+        summarizer: { credentialSource: args.credentialSource },
+        traceSummarizerRegistry: args.traceSummarizerRegistry,
+        createTurnId: () => `server-turn-${Date.now()}`,
+        onCompactionStatus: (event) => {
+            args.hostBridge.notifyFinalCompactionStatus(event);
+            if (event.status === 'running') {
+                persistFinalCompactionRunningSeed({
+                    ...args,
+                    archivePath: event.archivePath,
+                });
+            }
+        },
+    });
+    saveChatSessions(args.sessionStoragePath, args.sessions.map((candidate) => (candidate.id === args.session.id ? persisted.session : candidate)));
+    return persisted;
+}
+function persistFinalCompactionRunningSeed(args) {
+    const compactionSeed = touchSession({
+        ...args.session,
+        history: args.result.transcript,
+        context: buildCompactionRunningContext({
+            history: args.result.transcript,
+            previous: args.session.context,
+            archiveCount: args.session.archives?.length,
+            currentSummaryPath: args.session.context?.currentSummaryPath,
+            lastArchivePath: args.archivePath,
+        }),
+    });
+    saveChatSessions(args.sessionStoragePath, args.sessions.map((candidate) => (candidate.id === args.session.id ? compactionSeed : candidate)));
+}
+//# sourceMappingURL=persistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/persistence.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAA8B,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAqBxE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAkC;IAC/E,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC;QAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;QACrD,UAAU,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE;QACvD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;QACrD,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE;QAC/C,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC,UAAU,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,iCAAiC,CAAC;oBAChC,GAAG,IAAI;oBACP,WAAW,EAAE,KAAK,CAAC,WAAW;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,gBAAgB,CACd,IAAI,CAAC,kBAAkB,EACvB,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,CACrG,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,iCAAiC,CACxC,IAEC;IAED,MAAM,cAAc,GAAG,YAAY,CAAC;QAClC,GAAG,IAAI,CAAC,OAAO;QACf,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;QAC/B,OAAO,EAAE,6BAA6B,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC9B,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM;YAC3C,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB;YAC5D,eAAe,EAAE,IAAI,CAAC,WAAW;SAClC,CAAC;KACH,CAAC,CAAC;IACH,gBAAgB,CACd,IAAI,CAAC,kBAAkB,EACvB,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,CAClG,CAAC;AACJ,CAAC"}

package/dist/src/core/chat/{session-turn-preflight.d.ts → engine/turns/preflight.d.ts}

@@ -1,7 +1,8 @@
-import type { ChatMessage } from '../llm/types.js';
-import { compactChatHistoryWithArchive } from './compaction.js';
-import { type ChatSessionLeaseOwner } from './session-lease.js';
-import type { ChatArchiveRecord, ChatContextStats, ChatSession } from './types.js';
+import type { ChatMessage } from '../../../llm/types.js';
+import { compactChatHistoryWithArchive } from '../history/compaction.js';
+import { type ChatSessionLeaseOwner } from '../sessions/lease.js';
+import type { ChatArchiveRecord, ChatContextStats, ChatSession } from '../../types.js';
+import type { ChatTurnHostBridge } from './host-bridge.js';
 export type ChatTurnPreflightCompactionStatus = {
     status: 'running' | 'finished' | 'failed';
     archivePath?: string;
@@ -19,7 +20,8 @@ export type PrepareChatSessionTurnArgs = {
     toolNames: string[];
     summarizer: Parameters<typeof compactChatHistoryWithArchive>[0]['summarizer'];
     leaseOwner: ChatSessionLeaseOwner;
-    onCompactionStatus?: (event: ChatTurnPreflightCompactionStatus, sourceHistory: ChatMessage[], leasedSession?: ChatSession) => void;
+    sessions: ChatSession[];
+    hostBridge: Pick<ChatTurnHostBridge, 'notifyPreflightCompactionStatus'>;
 };
 export type PrepareChatSessionTurnResult = {
     ok: true;
@@ -34,4 +36,21 @@ export type PrepareChatSessionTurnResult = {
     message: string;
 };
 export declare function prepareChatSessionTurn(args: PrepareChatSessionTurnArgs): Promise<PrepareChatSessionTurnResult>;
-//# sourceMappingURL=session-turn-preflight.d.ts.map
+export declare function persistPreflightCompactionRunningSeed(args: {
+    sessionStoragePath: string;
+    sessions: ChatSession[];
+    sessionId: string;
+    leasedSession: ChatSession;
+    archivePath?: string;
+}): void;
+export declare function persistPreparedChatSessionTurn(args: {
+    sessionStoragePath: string;
+    sessions: ChatSession[];
+    session: ChatSession;
+    prepared: Extract<PrepareChatSessionTurnResult, {
+        ok: true;
+    }>;
+}): Extract<PrepareChatSessionTurnResult, {
+    ok: true;
+}>;
+//# sourceMappingURL=preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAiC,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAAgD,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEhH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,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,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9E,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iCAAiC,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAyDpH;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,WAAW,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,QAeA;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC,4BAA4B,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAC/D,GAAG,OAAO,CAAC,4BAA4B,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAoBtD"}

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

@@ -0,0 +1,96 @@
+import { buildConversationMessages } from '../sessions/conversation-lines.js';
+import { buildCompactionRunningContext, compactChatHistoryWithArchive } from '../history/compaction.js';
+import { acquireSessionLease, getSessionLeaseConflict } from '../sessions/lease.js';
+import { readChatSession, saveChatSessions, touchSession } from '../sessions/storage.js';
+export async function prepareChatSessionTurn(args) {
+    const persistedSession = readChatSession(args.sessionStoragePath, args.sessionId, true);
+    const leaseConflict = persistedSession ? getSessionLeaseConflict(persistedSession, args.leaseOwner) : undefined;
+    if (leaseConflict) {
+        return {
+            ok: false,
+            reason: 'lease_conflict',
+            message: leaseConflict,
+        };
+    }
+    const leasedSession = persistedSession ? touchSession(acquireSessionLease(persistedSession, args.leaseOwner)) : undefined;
+    const initialHistory = leasedSession?.history ?? args.fallbackHistory;
+    const preflightCompacted = await compactChatHistoryWithArchive({
+        history: initialHistory,
+        model: args.model,
+        sessionId: args.sessionId,
+        stateRoot: args.stateRoot,
+        systemContext: args.systemContext,
+        toolNames: args.toolNames,
+        goal: args.prompt,
+        summarizer: args.summarizer,
+        onStatusChange: (event) => {
+            args.hostBridge.notifyPreflightCompactionStatus(event);
+            if (event.status === 'running' && leasedSession) {
+                persistPreflightCompactionRunningSeed({
+                    sessionStoragePath: args.sessionStoragePath,
+                    sessions: args.sessions,
+                    sessionId: args.sessionId,
+                    leasedSession,
+                    archivePath: event.archivePath,
+                });
+            }
+        },
+    });
+    return persistPreparedChatSessionTurn({
+        sessionStoragePath: args.sessionStoragePath,
+        sessions: args.sessions,
+        session: persistedSession ?? readRequiredFallbackSession(args.sessions, args.sessionId),
+        prepared: {
+            ok: true,
+            session: leasedSession
+                ? {
+                    ...leasedSession,
+                    history: preflightCompacted.history,
+                    context: preflightCompacted.context,
+                    archives: preflightCompacted.archives,
+                    messages: buildConversationMessages(preflightCompacted.history),
+                }
+                : undefined,
+            historyForRun: preflightCompacted.history,
+            preflightHistory: preflightCompacted.history,
+            context: preflightCompacted.context,
+            archives: preflightCompacted.archives,
+        },
+    });
+}
+export function persistPreflightCompactionRunningSeed(args) {
+    const compactionSeed = touchSession({
+        ...args.leasedSession,
+        context: buildCompactionRunningContext({
+            history: args.leasedSession.history,
+            previous: args.leasedSession.context,
+            archiveCount: args.leasedSession.archives?.length,
+            currentSummaryPath: args.leasedSession.context?.currentSummaryPath,
+            lastArchivePath: args.archivePath,
+        }),
+    });
+    saveChatSessions(args.sessionStoragePath, args.sessions.map((candidate) => (candidate.id === args.sessionId ? compactionSeed : candidate)));
+}
+export function persistPreparedChatSessionTurn(args) {
+    const preparedSession = args.prepared.session ??
+        touchSession({
+            ...args.session,
+            history: args.prepared.preflightHistory,
+            context: args.prepared.context,
+            archives: args.prepared.archives,
+            messages: buildConversationMessages(args.prepared.preflightHistory),
+        });
+    saveChatSessions(args.sessionStoragePath, args.sessions.map((candidate) => (candidate.id === args.session.id ? preparedSession : candidate)));
+    return {
+        ...args.prepared,
+        session: preparedSession,
+    };
+}
+function readRequiredFallbackSession(sessions, sessionId) {
+    const session = sessions.find((candidate) => candidate.id === sessionId);
+    if (!session) {
+        throw new Error(`Chat session not found: ${sessionId}`);
+    }
+    return session;
+}
+//# sourceMappingURL=preflight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAA8B,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAyCzF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAgC;IAC3E,MAAM,gBAAgB,GAAG,eAAe,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxF,MAAM,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,uBAAuB,CAAC,gBAAgB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChH,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,aAAa;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1H,MAAM,cAAc,GAAG,aAAa,EAAE,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC;IACtE,MAAM,kBAAkB,GAAG,MAAM,6BAA6B,CAAC;QAC7D,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC,UAAU,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,aAAa,EAAE,CAAC;gBAChD,qCAAqC,CAAC;oBACpC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;oBAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,aAAa;oBACb,WAAW,EAAE,KAAK,CAAC,WAAW;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,8BAA8B,CAAC;QACpC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,gBAAgB,IAAI,2BAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC;QACvF,QAAQ,EAAE;YACR,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,aAAa;gBACpB,CAAC,CAAC;oBACE,GAAG,aAAa;oBAChB,OAAO,EAAE,kBAAkB,CAAC,OAAO;oBACnC,OAAO,EAAE,kBAAkB,CAAC,OAAO;oBACnC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;oBACrC,QAAQ,EAAE,yBAAyB,CAAC,kBAAkB,CAAC,OAAO,CAAC;iBAChE;gBACH,CAAC,CAAC,SAAS;YACb,aAAa,EAAE,kBAAkB,CAAC,OAAO;YACzC,gBAAgB,EAAE,kBAAkB,CAAC,OAAO;YAC5C,OAAO,EAAE,kBAAkB,CAAC,OAAO;YACnC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;SACtC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,IAMrD;IACC,MAAM,cAAc,GAAG,YAAY,CAAC;QAClC,GAAG,IAAI,CAAC,aAAa;QACrB,OAAO,EAAE,6BAA6B,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO;YACnC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO;YACpC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM;YACjD,kBAAkB,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,kBAAkB;YAClE,eAAe,EAAE,IAAI,CAAC,WAAW;SAClC,CAAC;KACH,CAAC,CAAC;IACH,gBAAgB,CACd,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACjG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAK9C;IACC,MAAM,eAAe,GACnB,IAAI,CAAC,QAAQ,CAAC,OAAO;QACrB,YAAY,CAAC;YACX,GAAG,IAAI,CAAC,OAAO;YACf,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB;YACvC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,QAAQ,EAAE,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACpE,CAAC,CAAC;IAEL,gBAAgB,CACd,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACnG,CAAC;IAEF,OAAO;QACL,GAAG,IAAI,CAAC,QAAQ;QAChB,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAuB,EAAE,SAAiB;IAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/core/chat/{session-turn-result.d.ts → engine/turns/result.d.ts}

@@ -1,7 +1,8 @@
-import type { RunResult } from '../types.js';
-import type { ChatMessage } from '../llm/types.js';
-import { compactChatHistoryWithArchive } from './compaction.js';
-import type { ChatSession, TurnSummary } from './types.js';
+import type { RunResult } from '../../../types.js';
+import type { ChatMessage } from '../../../llm/types.js';
+import { compactChatHistoryWithArchive } from '../history/compaction.js';
+import { type TraceSummarizerRegistry } from '../../../observability/trace-summarizers.js';
+import type { ChatSession, TurnSummary } from '../../types.js';
 export type PersistChatTurnCompactionStatus = {
     status: 'running' | 'finished' | 'failed';
     archivePath?: string;
@@ -19,6 +20,7 @@ export type PersistChatTurnResultArgs = {
     toolNames: string[];
     historyForTokenEstimate: ChatMessage[];
     summarizer: Parameters<typeof compactChatHistoryWithArchive>[0]['summarizer'];
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
     createTurnId: () => string;
     onCompactionStatus?: (event: PersistChatTurnCompactionStatus, sourceHistory: ChatMessage[]) => void;
 };
@@ -33,4 +35,4 @@ export type PersistChatTurnResult = PersistChatTurnArtifacts & {
 };
 export declare function createChatTurnPersistenceArtifacts(args: PersistChatTurnResultArgs): Promise<PersistChatTurnArtifacts>;
 export declare function persistChatTurnResult(args: PersistChatTurnResultArgs): Promise<PersistChatTurnResult>;
-//# sourceMappingURL=session-turn-result.d.ts.map
+//# sourceMappingURL=result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/turns/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAA6B,MAAM,0BAA0B,CAAC;AAGpG,OAAO,EAAuC,KAAK,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEhI,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG/D,MAAM,MAAM,+BAA+B,GAAG;IAC5C,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,yBAAyB,GAAG;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB,EAAE,WAAW,EAAE,CAAC;IACvC,UAAU,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9E,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,+BAA+B,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAAG;IAC7D,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAwCnC;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAiB3G"}