@qduc/term2 0.32.2 → 0.33.0

package/dist/services/conversation/conversation-record-stream.js

@@ -0,0 +1,186 @@
+import { extractReplaySnapshot, extractFinalizationSnapshot } from '../stream-snapshot.js';
+import { collectDuplicateToolCallResultPairs } from '../input-surge-guard.js';
+import { projectConversationMessage } from './conversation-message-projection.js';
+import { normalizeRunItem } from './run-item-normalizer.js';
+import { projectPersistedAssistantItemToProviderHistory } from './conversation-turn-items.js';
+import { resolveSessionId } from '../session/session-identity.js';
+const hasConversationMessageItems = (items) => items.some(projectConversationMessage);
+/**
+ * ApplicationRunLoop output is the canonical application event stream. Provider
+ * history is kept separately in `stream.history`; only `item` events are
+ * projected when a current-run snapshot is used for persistence.
+ */
+const isCanonicalApplicationItemEvent = (item) => {
+    if (!item || typeof item !== 'object' || Array.isArray(item))
+        return false;
+    const event = item;
+    return event.type === 'item' && !!event.item && typeof event.item === 'object';
+};
+const canonicalProviderHistoryItems = (items) => items.flatMap((item) => {
+    if (!item || typeof item !== 'object' || Array.isArray(item))
+        return [];
+    const event = item;
+    if (event.type === 'item' && event.item && typeof event.item === 'object')
+        return [event.item];
+    if (event.type === 'text_delta' ||
+        event.type === 'reasoning_delta' ||
+        event.type === 'codex_rate_limits' ||
+        event.type === 'tool_call_streaming_delta' ||
+        event.type === 'tool_call_dispatched' ||
+        event.type === 'usage_update' ||
+        event.type === 'run_budget' ||
+        event.type === 'context_compaction_started' ||
+        event.type === 'context_compaction_completed') {
+        return [];
+    }
+    return [item];
+});
+const hasToolResultItems = (items) => items.some((item) => normalizeRunItem(item).some((normalized) => normalized.type === 'tool_result'));
+export const lastOpenAICompaction = (items) => {
+    let last;
+    for (const item of items) {
+        for (const normalized of normalizeRunItem(item)) {
+            if (normalized.type === 'provider_opaque' &&
+                normalized.provider === 'openai' &&
+                normalized.item.type === 'compaction') {
+                last = normalized;
+            }
+        }
+    }
+    return last;
+};
+const compactedProviderHistory = (existingHistory, output) => {
+    const compaction = lastOpenAICompaction(output);
+    if (!compaction)
+        return undefined;
+    const userTurns = existingHistory.filter((item) => {
+        const message = projectConversationMessage(item);
+        return message?.role === 'user' && !message.isSynthetic;
+    });
+    return [...userTurns, projectPersistedAssistantItemToProviderHistory(compaction)];
+};
+const toolItemSignature = (item) => {
+    for (const normalized of normalizeRunItem(item)) {
+        if (normalized.type === 'tool_call' || normalized.type === 'tool_result') {
+            return `${normalized.type}:${normalized.callId}`;
+        }
+    }
+    return null;
+};
+/**
+ * Drops tool call/result items the store already holds.
+ *
+ * An interrupted run carries its accumulated generated items forward into every
+ * later resume segment, so each `continueRunStream` finalization re-offers the
+ * pairs from all earlier segments. Appending them unfiltered grows history
+ * quadratically until the input surge guard blocks the turn. A canonical
+ * tool-kind/call-id pair is unique within a conversation, so equivalent SDK,
+ * provider, and domain representations share an identity. An item already
+ * present is a replay, not new output. Non-tool items are never filtered, and
+ * kept items retain their original provider representation.
+ */
+const dropAlreadyCommittedToolItems = (items, existingHistory) => {
+    const committed = new Set();
+    for (const item of existingHistory) {
+        const signature = toolItemSignature(item);
+        if (signature) {
+            committed.add(signature);
+        }
+    }
+    const kept = [];
+    const droppedSignatures = [];
+    for (const item of items) {
+        const signature = toolItemSignature(item);
+        if (signature && committed.has(signature)) {
+            droppedSignatures.push(signature);
+            continue;
+        }
+        if (signature) {
+            committed.add(signature);
+        }
+        kept.push(item);
+    }
+    return { kept, droppedSignatures };
+};
+const warnIfStreamHistoryReplayedTools = ({ logger, sessionId, source, snapshot, }) => {
+    const { history, newItems } = snapshot;
+    const historyDuplicates = collectDuplicateToolCallResultPairs(history);
+    const newItemsDuplicates = collectDuplicateToolCallResultPairs(newItems);
+    if (historyDuplicates.pairs === 0 && newItemsDuplicates.pairs === 0) {
+        return;
+    }
+    logger.warn('Completed stream history contains replayed tool call/result pairs', {
+        eventType: 'conversation.stream_history.replayed_tools',
+        category: 'provider',
+        phase: 'post_stream',
+        sessionId: resolveSessionId(sessionId),
+        traceId: logger.getCorrelationId(),
+        source,
+        historyLength: history.length,
+        newItemsLength: newItems.length,
+        historyDuplicatePairs: historyDuplicates.pairs,
+        historyMaxCopies: historyDuplicates.maxCopies,
+        newItemsDuplicatePairs: newItemsDuplicates.pairs,
+        newItemsMaxCopies: newItemsDuplicates.maxCopies,
+    });
+};
+/** Pure selection; ConversationRecord alone applies the resulting history mutation. */
+export function selectAcceptedStreamHistory(input) {
+    const { stream, history, inputMode, source, logger, sessionId } = input;
+    const snapshot = extractFinalizationSnapshot(stream);
+    const projected = {
+        history: canonicalProviderHistoryItems(snapshot.history),
+        newItems: canonicalProviderHistoryItems(snapshot.newItems),
+        output: canonicalProviderHistoryItems(snapshot.output),
+    };
+    const terminal = !stream.interruptions || stream.interruptions.length === 0;
+    warnIfStreamHistoryReplayedTools({ logger, sessionId, source, snapshot: extractReplaySnapshot(stream) });
+    if (!terminal)
+        return { terminal, lastResponseId: snapshot.lastResponseId };
+    const append = (items) => {
+        const offered = canonicalProviderHistoryItems(items);
+        const { kept, droppedSignatures } = dropAlreadyCommittedToolItems(offered, history);
+        if (droppedSignatures.length)
+            logger.warn('Dropped replayed tool call/result items before committing stream history', {
+                eventType: 'conversation.stream_history.replay_dropped',
+                category: 'provider',
+                phase: 'post_stream',
+                sessionId: resolveSessionId(sessionId),
+                traceId: logger.getCorrelationId(),
+                source,
+                inputMode,
+                offeredCount: offered.length,
+                droppedCount: droppedSignatures.length,
+                droppedSignatures,
+            });
+        return [...history, ...kept];
+    };
+    let accepted;
+    const replacement = compactedProviderHistory(history, projected.output);
+    const hasCanonicalItems = [...snapshot.newItems, ...snapshot.output].some(isCanonicalApplicationItemEvent);
+    if (stream.historyReplacedByCompaction && projected.history.length) {
+        // Acceptance cannot depend on a presentation log sink replaying assistant_turn.
+        accepted = projected.history;
+    }
+    else if (replacement)
+        accepted = replacement;
+    else if (inputMode === 'delta') {
+        if (projected.output.length)
+            accepted = append(projected.output);
+    }
+    else if (hasCanonicalItems && hasConversationMessageItems(projected.history)) {
+        accepted = projected.history;
+    }
+    else if (hasConversationMessageItems(projected.newItems))
+        accepted = append(projected.newItems);
+    else if (hasConversationMessageItems(projected.output))
+        accepted = append(projected.output);
+    else if (hasConversationMessageItems(projected.history))
+        accepted = projected.history;
+    else if (hasToolResultItems(projected.newItems))
+        accepted = append(projected.newItems);
+    else if (hasToolResultItems(projected.output))
+        accepted = append(projected.output);
+    return { terminal, ...(accepted ? { history: accepted } : {}), lastResponseId: snapshot.lastResponseId };
+}
+//# sourceMappingURL=conversation-record-stream.js.map

package/dist/services/conversation/conversation-record-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-record-stream.js","sourceRoot":"","sources":["../../../source/services/conversation/conversation-record-stream.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAA6B,MAAM,uBAAuB,CAAC;AACtH,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,8CAA8C,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIlE,MAAM,2BAA2B,GAAG,CAAC,KAAgB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAE1G;;;;GAIG;AACH,MAAM,+BAA+B,GAAG,CAAC,IAAa,EAAW,EAAE;IACjE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,MAAM,KAAK,GAAG,IAA+B,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,KAAyB,EAAa,EAAE,CAC7E,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IACrB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,IAA+B,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/F,IACE,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,KAAK,CAAC,IAAI,KAAK,iBAAiB;QAChC,KAAK,CAAC,IAAI,KAAK,mBAAmB;QAClC,KAAK,CAAC,IAAI,KAAK,2BAA2B;QAC1C,KAAK,CAAC,IAAI,KAAK,sBAAsB;QACrC,KAAK,CAAC,IAAI,KAAK,cAAc;QAC7B,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,KAAK,CAAC,IAAI,KAAK,4BAA4B;QAC3C,KAAK,CAAC,IAAI,KAAK,8BAA8B,EAC7C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL,MAAM,kBAAkB,GAAG,CAAC,KAAgB,EAAW,EAAE,CACvD,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC;AAEvG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAyB,EAAkC,EAAE;IAChG,IAAI,IAAoC,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,UAAU,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IACE,UAAU,CAAC,IAAI,KAAK,iBAAiB;gBACrC,UAAU,CAAC,QAAQ,KAAK,QAAQ;gBAChC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,EACrC,CAAC;gBACD,IAAI,GAAG,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC/B,eAA6C,EAC7C,MAA0B,EACO,EAAE;IACnC,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAChD,MAAM,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,OAAO,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,SAAS,EAAE,8CAA8C,CAAC,UAAU,CAAC,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,IAAa,EAAiB,EAAE;IACzD,KAAK,MAAM,UAAU,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACzE,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,6BAA6B,GAAG,CACpC,KAAyB,EACzB,eAAmC,EACe,EAAE;IACpD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,gCAAgC,GAAG,CAAC,EACxC,MAAM,EACN,SAAS,EACT,MAAM,EACN,QAAQ,GAMT,EAAQ,EAAE;IACT,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAEvC,MAAM,iBAAiB,GAAG,mCAAmC,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,kBAAkB,GAAG,mCAAmC,CAAC,QAAQ,CAAC,CAAC;IAEzE,IAAI,iBAAiB,CAAC,KAAK,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACpE,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,mEAAmE,EAAE;QAC/E,SAAS,EAAE,4CAA4C;QACvD,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC,gBAAgB,EAAE;QAClC,MAAM;QACN,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,qBAAqB,EAAE,iBAAiB,CAAC,KAAK;QAC9C,gBAAgB,EAAE,iBAAiB,CAAC,SAAS;QAC7C,sBAAsB,EAAE,kBAAkB,CAAC,KAAK;QAChD,iBAAiB,EAAE,kBAAkB,CAAC,SAAS;KAChD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CAAC,KAO3C;IACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACxE,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG;QAChB,OAAO,EAAE,6BAA6B,CAAC,QAAQ,CAAC,OAAO,CAAC;QACxD,QAAQ,EAAE,6BAA6B,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1D,MAAM,EAAE,6BAA6B,CAAC,QAAQ,CAAC,MAAM,CAAC;KACvD,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5E,gCAAgC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,CAAC,KAAgB,EAAuB,EAAE;QACvD,MAAM,OAAO,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,6BAA6B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpF,IAAI,iBAAiB,CAAC,MAAM;YAC1B,MAAM,CAAC,IAAI,CAAC,0EAA0E,EAAE;gBACtF,SAAS,EAAE,4CAA4C;gBACvD,QAAQ,EAAE,UAAU;gBACpB,KAAK,EAAE,aAAa;gBACpB,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC;gBACtC,OAAO,EAAE,MAAM,CAAC,gBAAgB,EAAE;gBAClC,MAAM;gBACN,SAAS;gBACT,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,YAAY,EAAE,iBAAiB,CAAC,MAAM;gBACtC,iBAAiB;aAClB,CAAC,CAAC;QACL,OAAO,CAAC,GAAG,OAAO,EAAE,GAAI,IAA4B,CAAC,CAAC;IACxD,CAAC,CAAC;IACF,IAAI,QAAyC,CAAC;IAC9C,MAAM,WAAW,GAAG,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,iBAAiB,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC3G,IAAI,MAAM,CAAC,2BAA2B,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACnE,gFAAgF;QAChF,QAAQ,GAAG,SAAS,CAAC,OAA8B,CAAC;IACtD,CAAC;SAAM,IAAI,WAAW;QAAE,QAAQ,GAAG,WAAW,CAAC;SAC1C,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM;YAAE,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;SAAM,IAAI,iBAAiB,IAAI,2BAA2B,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,QAAQ,GAAG,SAAS,CAAC,OAA8B,CAAC;IACtD,CAAC;SAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,QAAQ,CAAC;QAAE,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;SAC7F,IAAI,2BAA2B,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SACvF,IAAI,2BAA2B,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,QAAQ,GAAG,SAAS,CAAC,OAA8B,CAAC;SACxG,IAAI,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC;QAAE,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;SAClF,IAAI,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnF,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;AAC3G,CAAC"}

package/dist/services/conversation/conversation-record.d.ts

@@ -0,0 +1,160 @@
+import type { ProviderInputItem } from '../../contracts/provider-input.js';
+import type { UserTurn } from '../../types/user-turn.js';
+import type { ILoggingService } from '../service-interfaces.js';
+import { type RewindTargetId } from './conversation-store.js';
+import { ToolExecutionLedger, type SavedToolExecution } from '../tool-execution-ledger.js';
+import type { LogEvent } from '../logging/conversation-log-events.js';
+import type { AgentStream } from '../agent-stream.js';
+import type { SessionIdSource } from '../session/session-identity.js';
+import type { ProviderContinuity } from '../provider-continuity.js';
+import type { OpenAIRootCheckpointLifecycleObserver } from '../openai-root-checkpoint-lifecycle-observer.js';
+import type { RecoveryPlan, RecoveryState, CommittedToolContinuation } from '../retry/retry-contracts.js';
+export type RecordAcceptanceReceipt = {
+    accepted: 'memory';
+    /** A void sink returning is acknowledgement of delivery, never proof of fsync. */
+    persistence: 'not_requested' | 'unconfigured' | 'acknowledged' | 'failed';
+};
+/**
+ * Sole acceptance authority for provider history, tool evidence and assistant journal.
+ * Physical execution and recovery policy remain with their existing owners. All
+ * reconstruction, rewind and import transitions keep these representations together.
+ */
+export declare class ConversationRecord {
+    #private;
+    constructor(options?: {
+        logger?: ILoggingService;
+        providerContext?: ProviderContinuity;
+        checkpointObserver?: OpenAIRootCheckpointLifecycleObserver;
+    });
+    setJournalSink(sink: ((event: LogEvent) => void) | null): void;
+    /** Preserve the pre-attempt recovery baseline without exporting journal state. */
+    beginAttempt(): void;
+    /** A decision changes the segment view, never the execution position. */
+    beginDecisionResolution(source?: 'continueRunStream' | 'abortResolution'): void;
+    beginTurn(): void;
+    getCurrentTurnId(): string;
+    getHistory(): ProviderInputItem[];
+    getProviderHistorySnapshot(): import("./conversation-store.js").ProviderHistorySnapshot;
+    getProviderHistoryIdentity(): {
+        revision: number;
+        identity: string;
+        origin: string;
+    };
+    getLastUserMessage(): string;
+    listUserTurns(): {
+        index: number;
+        text: string;
+        imageCount: number;
+    }[];
+    listRewindTargets(): import("./conversation-store.js").RewindTarget[];
+    getCurrentTurnItems(): import("../../contracts/conversation-items.js").Item[];
+    recordTextDelta(delta: string): void;
+    recordReasoningDelta(delta: string): void;
+    rollbackReasoning(characters: number): void;
+    exportToolEvidence(): SavedToolExecution[];
+    activeCallIdsForCurrentTurn(): string[];
+    completedResultCallIdsForCurrentTurn(): string[];
+    unsettledToolCallIdsForCurrentTurn(): string[];
+    inspectCommittedToolContinuation(): CommittedToolContinuation;
+    acceptInput(turn: string | UserTurn): RecordAcceptanceReceipt;
+    addUserTurn(turn: string | UserTurn): RecordAcceptanceReceipt;
+    removeLastUserMessage(): void;
+    addShellContext(text: string): void;
+    markDispatched(callId: string): void;
+    recordFunctionCall(item: unknown): void;
+    recordFunctionResult(item: unknown): void;
+    recordAbortedApproval(output: string, error: string, callId?: string): void;
+    markOpenCallsAborted(error: string, callId?: string): void;
+    getRecoverySummary(): import("../tool-execution-ledger.js").ToolLedgerRecoverySummary | null;
+    /** A segment is a wire view over the same record, not another acceptance owner. */
+    beginSegment(): void;
+    /** Accept one observed provider item into both evidence representations before publication. */
+    acceptObservedItem(item: unknown): RecordAcceptanceReceipt;
+    /** Accept a completed or interrupted execution view, independent of rendering. */
+    acceptSegment(stream: AgentStream, inputMode: 'delta' | 'full_history', diagnostics: {
+        logger: ILoggingService;
+        sessionId: SessionIdSource;
+    }): {
+        kind: "committed" | "partial";
+        snapshot: import("./conversation-store.js").ProviderHistorySnapshot;
+        historyCommitted: boolean;
+        lastResponseId: string | null;
+        unsettledToolCallIds: string[];
+    };
+    snapshot(metadata: {
+        previousResponseId: string | null;
+        model?: string;
+        provider?: string;
+    }): import("../logging/conversation-log-events.js").StateSnapshot;
+    exportState(previousResponseId: string | null): {
+        history: ProviderInputItem[];
+        previousResponseId: string | null;
+        toolLedger: SavedToolExecution[];
+    };
+    getReconciledHistory(): ProviderInputItem[];
+    /** Conditional compaction acceptance preserves the existing transcript revision guard. */
+    replaceHistoryAtRevision(revision: number, history: readonly ProviderInputItem[]): boolean;
+    /** Apply a policy-selected recovery transition without exposing representation precedence. */
+    recover(plan: RecoveryPlan, state: RecoveryState): ReturnType<ToolExecutionLedger['getRecoverySummary']>;
+    reset(): void;
+    importState(state: {
+        history: unknown[];
+        previousResponseId: string | null;
+        toolLedger?: SavedToolExecution[];
+        updatedAt?: string;
+    }): {
+        validated: {
+            [x: string]: unknown;
+            history: unknown[];
+            previousResponseId: string | null;
+            toolLedger?: {
+                [x: string]: unknown;
+                turnId: string;
+                callId: string;
+                toolName: string;
+                arguments?: unknown;
+                status: "aborted" | "approval_required" | "completed" | "failed" | "started" | "unknown";
+                output?: unknown;
+                failureReason?: string | undefined;
+                startedAt: string;
+                dispatchedAt?: string | undefined;
+                completedAt?: string | undefined;
+                historyItems?: unknown[] | undefined;
+            }[] | undefined;
+            updatedAt?: string | undefined;
+        };
+        projected: import("./conversation-state-projector.js").ImportedStateProjection;
+    };
+    removeLastUserTurn(): {
+        text: string;
+        imageCount: number;
+        images?: UserTurn['images'];
+    } | null;
+    retryLastUserTurn(): false | {
+        discardedSnapshot: {
+            history: ProviderInputItem[];
+            toolLedger: SavedToolExecution[];
+        };
+    };
+    removeNLastUserTurns(n: number): {
+        text: string;
+        imageCount: number;
+        images?: UserTurn['images'];
+    } | null;
+    rewindToTarget(target: RewindTargetId): import("./conversation-store.js").RewoundTarget | null;
+    peekLastToolOutput(): {
+        index: number;
+        callId?: string;
+        toolName?: string;
+        output?: unknown;
+        itemType: string;
+    } | null;
+    removeAfterLastToolOutput(): {
+        index: number;
+        callId?: string;
+        toolName?: string;
+        output?: unknown;
+        itemType: string;
+    } | null;
+}
+//# sourceMappingURL=conversation-record.d.ts.map

package/dist/services/conversation/conversation-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-record.d.ts","sourceRoot":"","sources":["../../../source/services/conversation/conversation-record.ts"],"names":[],"mappings":"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"}