@memberjunction/ng-conversations 5.43.0 → 5.44.0

package/dist/lib/services/realtime-pcm-wav.js

@@ -0,0 +1,205 @@
+/**
+ * @fileoverview Pure, browser-and-node-safe helpers for the CLIENT-DIRECT realtime recorder:
+ * encoding accumulated Float32 PCM into a seekable 16-bit PCM **WAV** container and computing a
+ * bounded, downsampled waveform **peak** array at capture time.
+ *
+ * These functions are deliberately free of any browser API (`AudioContext`, `Blob`, …) so they can
+ * be unit-tested in a plain Node environment. {@link RealtimeAudioRecorder} owns the live audio
+ * graph and feeds the captured samples here.
+ *
+ * Why WAV (PCM) over webm/opus: a RIFF/WAVE header carries the exact duration and maps a byte
+ * offset linearly to a time offset, so HTTP-range seeking is exact (no client-side duration nudge),
+ * and peak extraction is trivial. The tradeoff is size — PCM WAV is larger than opus — which is
+ * acceptable for these short session recordings.
+ *
+ * @module @memberjunction/ng-conversations/realtime-pcm-wav
+ */
+/** Lowest value representable by signed 16-bit PCM. */
+const PCM16_MIN = -32768;
+/** Highest value representable by signed 16-bit PCM. */
+const PCM16_MAX = 32767;
+/** Canonical WAV/PCM header size in bytes (RIFF + fmt + data chunk headers). */
+export const WAV_HEADER_BYTES = 44;
+/**
+ * Converts one Float32 sample (nominally in `[-1, 1]`) to a clamped signed 16-bit integer.
+ * Out-of-range values (a hot mix can briefly exceed unity) are clamped, not wrapped.
+ */
+function floatToPcm16(sample) {
+    const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;
+    // Asymmetric scaling: negative full-scale is -32768, positive is +32767.
+    const scaled = clamped < 0 ? clamped * -PCM16_MIN : clamped * PCM16_MAX;
+    const rounded = Math.round(scaled);
+    return rounded < PCM16_MIN ? PCM16_MIN : rounded > PCM16_MAX ? PCM16_MAX : rounded;
+}
+/**
+ * Encodes mono Float32 PCM samples as a canonical single-chunk 16-bit PCM WAV (RIFF/WAVE).
+ * The returned `ArrayBuffer` is `WAV_HEADER_BYTES + samples.length * 2` bytes — a proper
+ * 44-byte header followed by little-endian PCM16 data, so it is seekable and self-describing.
+ *
+ * @param samples Mono Float32 PCM in `[-1, 1]` (downmixed by the caller).
+ * @param sampleRate Sample rate in Hz (from the capturing `AudioContext`).
+ * @returns A standalone `ArrayBuffer` containing the full WAV file.
+ */
+export function encodePcm16Wav(samples, sampleRate) {
+    const numChannels = 1;
+    const bitsPerSample = 16;
+    const bytesPerSample = bitsPerSample / 8;
+    const blockAlign = numChannels * bytesPerSample;
+    const byteRate = sampleRate * blockAlign;
+    const dataSize = samples.length * bytesPerSample;
+    const buffer = new ArrayBuffer(WAV_HEADER_BYTES + dataSize);
+    const view = new DataView(buffer);
+    writeAscii(view, 0, 'RIFF');
+    view.setUint32(4, 36 + dataSize, true); // ChunkSize = 36 + Subchunk2Size
+    writeAscii(view, 8, 'WAVE');
+    writeAscii(view, 12, 'fmt ');
+    view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)
+    view.setUint16(20, 1, true); // AudioFormat = PCM
+    view.setUint16(22, numChannels, true);
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, byteRate, true);
+    view.setUint16(32, blockAlign, true);
+    view.setUint16(34, bitsPerSample, true);
+    writeAscii(view, 36, 'data');
+    view.setUint32(40, dataSize, true);
+    let offset = WAV_HEADER_BYTES;
+    for (let i = 0; i < samples.length; i++) {
+        view.setInt16(offset, floatToPcm16(samples[i]), true);
+        offset += bytesPerSample;
+    }
+    return buffer;
+}
+/** Writes an ASCII string into a {@link DataView} byte-by-byte at `offset`. */
+function writeAscii(view, offset, text) {
+    for (let i = 0; i < text.length; i++) {
+        view.setUint8(offset + i, text.charCodeAt(i));
+    }
+}
+/**
+ * A bounded, streaming waveform-peak accumulator. It maintains a fixed number of buckets
+ * (`targetBuckets`) of max-absolute amplitude across the WHOLE recording regardless of length:
+ * once every bucket has absorbed `samplesPerBucket` samples, the buckets are halved (pairwise
+ * max-merged) and the per-bucket capacity doubles — so memory + cost stay O(targetBuckets) for an
+ * arbitrarily long call. {@link Normalize} returns the final 0..1 peaks.
+ */
+export class PeakAccumulator {
+    /** Target (max) number of buckets in the produced peak array. */
+    targetBuckets;
+    /** Current max-abs amplitude per bucket (length grows up to `2 * targetBuckets` before folding). */
+    buckets = [];
+    /** How many samples each bucket currently absorbs before a new bucket opens. */
+    samplesPerBucket = 1;
+    /** Samples absorbed into the current (last) bucket so far. */
+    samplesInCurrent = 0;
+    /**
+     * @param targetBuckets Desired bucket count (waveform resolution). Clamped to >= 1.
+     *   ~600 gives a smooth overview waveform at trivial cost.
+     */
+    constructor(targetBuckets = 600) {
+        this.targetBuckets = Math.max(1, Math.floor(targetBuckets));
+    }
+    /** Number of buckets currently held (for tests/inspection). */
+    get BucketCount() {
+        return this.buckets.length;
+    }
+    /** Absorbs a block of Float32 PCM samples, updating the running per-bucket max-abs. */
+    Push(samples) {
+        for (let i = 0; i < samples.length; i++) {
+            this.pushSample(samples[i]);
+        }
+    }
+    /** Absorbs one sample into the current bucket, opening/folding buckets as capacity is reached. */
+    pushSample(sample) {
+        if (this.buckets.length === 0) {
+            this.buckets.push(0);
+            this.samplesInCurrent = 0;
+        }
+        const abs = sample < 0 ? -sample : sample;
+        const last = this.buckets.length - 1;
+        if (abs > this.buckets[last]) {
+            this.buckets[last] = abs;
+        }
+        this.samplesInCurrent++;
+        if (this.samplesInCurrent >= this.samplesPerBucket) {
+            this.buckets.push(0);
+            this.samplesInCurrent = 0;
+            // Keep the bucket array bounded: once it reaches 2x the target, fold pairwise so the
+            // resolution stays under the cap while the per-bucket sample capacity doubles.
+            if (this.buckets.length >= this.targetBuckets * 2) {
+                this.fold();
+            }
+        }
+    }
+    /** Pairwise max-merges adjacent buckets, halving the count and doubling per-bucket capacity. */
+    fold() {
+        const folded = [];
+        for (let i = 0; i < this.buckets.length; i += 2) {
+            const a = this.buckets[i];
+            const b = i + 1 < this.buckets.length ? this.buckets[i + 1] : 0;
+            folded.push(a > b ? a : b);
+        }
+        this.buckets = folded;
+        this.samplesPerBucket *= 2;
+        this.samplesInCurrent = 0;
+    }
+    /**
+     * Produces the final normalized peak array (each value 0..1, divided by the global max).
+     * Trailing empty buckets are trimmed; an all-silent / empty recording yields `[]`.
+     */
+    Normalize() {
+        // Drop a trailing freshly-opened empty bucket that absorbed nothing.
+        const raw = this.buckets.length > 0 && this.samplesInCurrent === 0 && this.buckets.length > 1
+            ? this.buckets.slice(0, -1)
+            : this.buckets.slice();
+        let max = 0;
+        for (const v of raw) {
+            if (v > max) {
+                max = v;
+            }
+        }
+        if (max <= 0) {
+            return [];
+        }
+        return raw.map(v => v / max);
+    }
+}
+/**
+ * One-shot peak downsampling of a complete Float32 PCM buffer into `targetBuckets` normalized
+ * max-abs peaks (0..1). The streaming {@link PeakAccumulator} is the production path; this is the
+ * direct, allocation-light equivalent used where the whole buffer is already in hand (and in tests).
+ *
+ * @param samples The full mono Float32 PCM buffer.
+ * @param targetBuckets Desired bucket count (clamped to >= 1). Buckets beyond the sample count are
+ *   not produced — a short buffer yields at most `samples.length` peaks.
+ * @returns Normalized peaks; `[]` for an empty or all-silent buffer.
+ */
+export function downsamplePeaks(samples, targetBuckets = 600) {
+    const target = Math.max(1, Math.floor(targetBuckets));
+    if (samples.length === 0) {
+        return [];
+    }
+    const buckets = Math.min(target, samples.length);
+    const samplesPerBucket = samples.length / buckets;
+    const peaks = new Array(buckets).fill(0);
+    let globalMax = 0;
+    for (let b = 0; b < buckets; b++) {
+        const start = Math.floor(b * samplesPerBucket);
+        const end = b === buckets - 1 ? samples.length : Math.floor((b + 1) * samplesPerBucket);
+        let localMax = 0;
+        for (let i = start; i < end; i++) {
+            const abs = samples[i] < 0 ? -samples[i] : samples[i];
+            if (abs > localMax) {
+                localMax = abs;
+            }
+        }
+        peaks[b] = localMax;
+        if (localMax > globalMax) {
+            globalMax = localMax;
+        }
+    }
+    if (globalMax <= 0) {
+        return [];
+    }
+    return peaks.map(v => v / globalMax);
+}
+//# sourceMappingURL=realtime-pcm-wav.js.map

package/dist/lib/services/realtime-pcm-wav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-pcm-wav.js","sourceRoot":"","sources":["../../../src/lib/services/realtime-pcm-wav.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure, browser-and-node-safe helpers for the CLIENT-DIRECT realtime recorder:\n * encoding accumulated Float32 PCM into a seekable 16-bit PCM **WAV** container and computing a\n * bounded, downsampled waveform **peak** array at capture time.\n *\n * These functions are deliberately free of any browser API (`AudioContext`, `Blob`, …) so they can\n * be unit-tested in a plain Node environment. {@link RealtimeAudioRecorder} owns the live audio\n * graph and feeds the captured samples here.\n *\n * Why WAV (PCM) over webm/opus: a RIFF/WAVE header carries the exact duration and maps a byte\n * offset linearly to a time offset, so HTTP-range seeking is exact (no client-side duration nudge),\n * and peak extraction is trivial. The tradeoff is size — PCM WAV is larger than opus — which is\n * acceptable for these short session recordings.\n *\n * @module @memberjunction/ng-conversations/realtime-pcm-wav\n */\n\n/** Lowest value representable by signed 16-bit PCM. */\nconst PCM16_MIN = -32768;\n/** Highest value representable by signed 16-bit PCM. */\nconst PCM16_MAX = 32767;\n/** Canonical WAV/PCM header size in bytes (RIFF + fmt + data chunk headers). */\nexport const WAV_HEADER_BYTES = 44;\n\n/**\n * Converts one Float32 sample (nominally in `[-1, 1]`) to a clamped signed 16-bit integer.\n * Out-of-range values (a hot mix can briefly exceed unity) are clamped, not wrapped.\n */\nfunction floatToPcm16(sample: number): number {\n    const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n    // Asymmetric scaling: negative full-scale is -32768, positive is +32767.\n    const scaled = clamped < 0 ? clamped * -PCM16_MIN : clamped * PCM16_MAX;\n    const rounded = Math.round(scaled);\n    return rounded < PCM16_MIN ? PCM16_MIN : rounded > PCM16_MAX ? PCM16_MAX : rounded;\n}\n\n/**\n * Encodes mono Float32 PCM samples as a canonical single-chunk 16-bit PCM WAV (RIFF/WAVE).\n * The returned `ArrayBuffer` is `WAV_HEADER_BYTES + samples.length * 2` bytes — a proper\n * 44-byte header followed by little-endian PCM16 data, so it is seekable and self-describing.\n *\n * @param samples Mono Float32 PCM in `[-1, 1]` (downmixed by the caller).\n * @param sampleRate Sample rate in Hz (from the capturing `AudioContext`).\n * @returns A standalone `ArrayBuffer` containing the full WAV file.\n */\nexport function encodePcm16Wav(samples: Float32Array, sampleRate: number): ArrayBuffer {\n    const numChannels = 1;\n    const bitsPerSample = 16;\n    const bytesPerSample = bitsPerSample / 8;\n    const blockAlign = numChannels * bytesPerSample;\n    const byteRate = sampleRate * blockAlign;\n    const dataSize = samples.length * bytesPerSample;\n\n    const buffer = new ArrayBuffer(WAV_HEADER_BYTES + dataSize);\n    const view = new DataView(buffer);\n\n    writeAscii(view, 0, 'RIFF');\n    view.setUint32(4, 36 + dataSize, true); // ChunkSize = 36 + Subchunk2Size\n    writeAscii(view, 8, 'WAVE');\n\n    writeAscii(view, 12, 'fmt ');\n    view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)\n    view.setUint16(20, 1, true); // AudioFormat = PCM\n    view.setUint16(22, numChannels, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, blockAlign, true);\n    view.setUint16(34, bitsPerSample, true);\n\n    writeAscii(view, 36, 'data');\n    view.setUint32(40, dataSize, true);\n\n    let offset = WAV_HEADER_BYTES;\n    for (let i = 0; i < samples.length; i++) {\n        view.setInt16(offset, floatToPcm16(samples[i]), true);\n        offset += bytesPerSample;\n    }\n\n    return buffer;\n}\n\n/** Writes an ASCII string into a {@link DataView} byte-by-byte at `offset`. */\nfunction writeAscii(view: DataView, offset: number, text: string): void {\n    for (let i = 0; i < text.length; i++) {\n        view.setUint8(offset + i, text.charCodeAt(i));\n    }\n}\n\n/**\n * A bounded, streaming waveform-peak accumulator. It maintains a fixed number of buckets\n * (`targetBuckets`) of max-absolute amplitude across the WHOLE recording regardless of length:\n * once every bucket has absorbed `samplesPerBucket` samples, the buckets are halved (pairwise\n * max-merged) and the per-bucket capacity doubles — so memory + cost stay O(targetBuckets) for an\n * arbitrarily long call. {@link Normalize} returns the final 0..1 peaks.\n */\nexport class PeakAccumulator {\n    /** Target (max) number of buckets in the produced peak array. */\n    private readonly targetBuckets: number;\n    /** Current max-abs amplitude per bucket (length grows up to `2 * targetBuckets` before folding). */\n    private buckets: number[] = [];\n    /** How many samples each bucket currently absorbs before a new bucket opens. */\n    private samplesPerBucket = 1;\n    /** Samples absorbed into the current (last) bucket so far. */\n    private samplesInCurrent = 0;\n\n    /**\n     * @param targetBuckets Desired bucket count (waveform resolution). Clamped to >= 1.\n     *   ~600 gives a smooth overview waveform at trivial cost.\n     */\n    constructor(targetBuckets = 600) {\n        this.targetBuckets = Math.max(1, Math.floor(targetBuckets));\n    }\n\n    /** Number of buckets currently held (for tests/inspection). */\n    public get BucketCount(): number {\n        return this.buckets.length;\n    }\n\n    /** Absorbs a block of Float32 PCM samples, updating the running per-bucket max-abs. */\n    public Push(samples: Float32Array): void {\n        for (let i = 0; i < samples.length; i++) {\n            this.pushSample(samples[i]);\n        }\n    }\n\n    /** Absorbs one sample into the current bucket, opening/folding buckets as capacity is reached. */\n    private pushSample(sample: number): void {\n        if (this.buckets.length === 0) {\n            this.buckets.push(0);\n            this.samplesInCurrent = 0;\n        }\n        const abs = sample < 0 ? -sample : sample;\n        const last = this.buckets.length - 1;\n        if (abs > this.buckets[last]) {\n            this.buckets[last] = abs;\n        }\n        this.samplesInCurrent++;\n        if (this.samplesInCurrent >= this.samplesPerBucket) {\n            this.buckets.push(0);\n            this.samplesInCurrent = 0;\n            // Keep the bucket array bounded: once it reaches 2x the target, fold pairwise so the\n            // resolution stays under the cap while the per-bucket sample capacity doubles.\n            if (this.buckets.length >= this.targetBuckets * 2) {\n                this.fold();\n            }\n        }\n    }\n\n    /** Pairwise max-merges adjacent buckets, halving the count and doubling per-bucket capacity. */\n    private fold(): void {\n        const folded: number[] = [];\n        for (let i = 0; i < this.buckets.length; i += 2) {\n            const a = this.buckets[i];\n            const b = i + 1 < this.buckets.length ? this.buckets[i + 1] : 0;\n            folded.push(a > b ? a : b);\n        }\n        this.buckets = folded;\n        this.samplesPerBucket *= 2;\n        this.samplesInCurrent = 0;\n    }\n\n    /**\n     * Produces the final normalized peak array (each value 0..1, divided by the global max).\n     * Trailing empty buckets are trimmed; an all-silent / empty recording yields `[]`.\n     */\n    public Normalize(): number[] {\n        // Drop a trailing freshly-opened empty bucket that absorbed nothing.\n        const raw = this.buckets.length > 0 && this.samplesInCurrent === 0 && this.buckets.length > 1\n            ? this.buckets.slice(0, -1)\n            : this.buckets.slice();\n        let max = 0;\n        for (const v of raw) {\n            if (v > max) {\n                max = v;\n            }\n        }\n        if (max <= 0) {\n            return [];\n        }\n        return raw.map(v => v / max);\n    }\n}\n\n/**\n * One-shot peak downsampling of a complete Float32 PCM buffer into `targetBuckets` normalized\n * max-abs peaks (0..1). The streaming {@link PeakAccumulator} is the production path; this is the\n * direct, allocation-light equivalent used where the whole buffer is already in hand (and in tests).\n *\n * @param samples The full mono Float32 PCM buffer.\n * @param targetBuckets Desired bucket count (clamped to >= 1). Buckets beyond the sample count are\n *   not produced — a short buffer yields at most `samples.length` peaks.\n * @returns Normalized peaks; `[]` for an empty or all-silent buffer.\n */\nexport function downsamplePeaks(samples: Float32Array, targetBuckets = 600): number[] {\n    const target = Math.max(1, Math.floor(targetBuckets));\n    if (samples.length === 0) {\n        return [];\n    }\n    const buckets = Math.min(target, samples.length);\n    const samplesPerBucket = samples.length / buckets;\n    const peaks = new Array<number>(buckets).fill(0);\n    let globalMax = 0;\n    for (let b = 0; b < buckets; b++) {\n        const start = Math.floor(b * samplesPerBucket);\n        const end = b === buckets - 1 ? samples.length : Math.floor((b + 1) * samplesPerBucket);\n        let localMax = 0;\n        for (let i = start; i < end; i++) {\n            const abs = samples[i] < 0 ? -samples[i] : samples[i];\n            if (abs > localMax) {\n                localMax = abs;\n            }\n        }\n        peaks[b] = localMax;\n        if (localMax > globalMax) {\n            globalMax = localMax;\n        }\n    }\n    if (globalMax <= 0) {\n        return [];\n    }\n    return peaks.map(v => v / globalMax);\n}\n"]}

package/dist/lib/services/realtime-session-review.service.d.ts

@@ -8,14 +8,31 @@ import * as i0 from "@angular/core";
  * legacy row was closed before the column existed.
  */
 export type RealtimeReviewCloseReason = 'Error' | 'Explicit' | 'Janitor' | 'Shutdown';
-/** One historical caption turn of a reviewed session (a persisted `MJ: Conversation Details` row). */
+/**
+ * One historical caption turn of a reviewed session (a persisted `MJ: Conversation Details` row).
+ *
+ * Carries BOTH the thread-rendering fields (`Role`/`Text`/`At`) AND the raw fields the time-aligned
+ * evidence player reads (`ID`, `Message`, `__mj_CreatedAt`, `UtteranceStartMs`, `UtteranceEndMs`) so
+ * a review's turns can be handed straight to {@link RealtimeEvidencePlaybackComponent} for the
+ * Recording tab — this shape structurally satisfies that player's `EvidencePlaybackTurn` input.
+ */
 export interface RealtimeSessionReviewTurn {
+    /** `MJ: Conversation Details.ID` — the player's `@for` track key. */
+    ID: string;
     /** Who spoke the turn. Persisted `AI` rows map to `Assistant`. */
     Role: 'User' | 'Assistant';
     /** The transcript text. */
     Text: string;
+    /** The raw transcript text (mirrors {@link Text}) — the player reads `Message`. */
+    Message: string | null;
+    /** When the turn was persisted (`__mj_CreatedAt`), or null when unknown. Aliases {@link At}. */
+    __mj_CreatedAt: Date | null;
     /** When the turn was persisted (`__mj_CreatedAt`), or null when unknown. */
     At: Date | null;
+    /** Precise media-relative start (ms from recording t0), or null when the driver supplied no timing. */
+    UtteranceStartMs: number | null;
+    /** Precise media-relative end (ms from recording t0), or null. */
+    UtteranceEndMs: number | null;
 }
 /**
  * A compact preview of one DELEGATED agent run the reviewed session spawned (an
@@ -108,6 +125,16 @@ export interface RealtimeSessionReview {
     StartedAt: Date | null;
     LastActiveAt: Date | null;
     ClosedAt: Date | null;
+    /**
+     * The `MJ: Files` id of the reviewed session's recorded audio, or null when nothing was recorded.
+     * When set, review mode resolves a signed download URL and shows a Recording tab with the
+     * time-aligned evidence player. From the PRIMARY (reviewed) leg only.
+     */
+    RecordingFileID: string | null;
+    /** Recording alignment origin (t0), used by the playback transcript sync. From the primary leg. */
+    RecordingStartedAt: Date | null;
+    /** What was captured (`Audio` / `AudioVideo`), or null. From the primary leg. */
+    RecordingMedia: string | null;
     /** Chronological caption turns (oldest first) — ALL legs of the chain, flattened. */
     Turns: RealtimeSessionReviewTurn[];
     /** Delegated run previews (oldest first, all legs), minus each leg's co-agent observability run. */

package/dist/lib/services/realtime-session-review.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-session-review.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/realtime-session-review.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtime-session-review.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/realtime-session-review.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/services/realtime-session-review.service.js

@@ -33,8 +33,8 @@ export function MergeChainChannelStates(legChannelStates) {
     }
     return [...byName.values()];
 }
-const SESSION_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'ConversationID', 'Config', 'LastSessionID', 'LastActiveAt', 'ClosedAt', 'CloseReason', '__mj_CreatedAt'];
-const DETAIL_FIELDS = ['ID', 'Role', 'Message', 'HiddenToUser', '__mj_CreatedAt'];
+const SESSION_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'ConversationID', 'Config', 'LastSessionID', 'LastActiveAt', 'ClosedAt', 'CloseReason', 'RecordingFileID', 'RecordingStartedAt', 'RecordingMedia', '__mj_CreatedAt'];
+const DETAIL_FIELDS = ['ID', 'Role', 'Message', 'HiddenToUser', 'UserID', 'Status', 'UtteranceStartMs', 'UtteranceEndMs', '__mj_CreatedAt'];
 const RUN_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'Success', 'Message', 'ErrorMessage', 'FinalStep', 'StartedAt', 'CompletedAt'];
 const CHANNEL_FIELDS = ['ID', 'Channel', 'Config'];
 const JUNCTION_FIELDS = ['ID', 'ConversationDetailID', 'ArtifactVersionID'];
@@ -326,6 +326,9 @@ export class RealtimeSessionReviewService {
             StartedAt: this.toDate(session.__mj_CreatedAt),
             LastActiveAt: this.toDate(session.LastActiveAt),
             ClosedAt: this.toDate(session.ClosedAt),
+            RecordingFileID: session.RecordingFileID ?? null,
+            RecordingStartedAt: this.toDate(session.RecordingStartedAt),
+            RecordingMedia: session.RecordingMedia ?? null,
             Turns: legs.flatMap(l => l.Turns),
             DelegatedRuns: legs.flatMap(l => l.DelegatedRuns),
             // Multi-leg: newest leg with a SAVED state wins per channel — a final leg that
@@ -355,10 +358,16 @@ export class RealtimeSessionReviewService {
             if (row.HiddenToUser || text.length === 0 || (row.Role !== 'User' && row.Role !== 'AI')) {
                 continue;
             }
+            const createdAt = this.toDate(row.__mj_CreatedAt);
             turns.push({
+                ID: row.ID,
                 Role: row.Role === 'AI' ? 'Assistant' : 'User',
                 Text: text,
-                At: this.toDate(row.__mj_CreatedAt)
+                Message: text,
+                __mj_CreatedAt: createdAt,
+                At: createdAt,
+                UtteranceStartMs: row.UtteranceStartMs ?? null,
+                UtteranceEndMs: row.UtteranceEndMs ?? null
             });
         }
         return turns;

package/dist/lib/services/realtime-session-review.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-session-review.service.js","sourceRoot":"","sources":["../../../src/lib/services/realtime-session-review.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { IMetadataProvider, Metadata, RunView, RunViewParams } from '@memberjunction/core';\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { RealtimeDelegationCardVM, RealtimeThreadItem } from '../components/realtime/realtime-session-state';\nimport { ParsedDelegationArtifact } from './delegation-result-parser';\n\n/**\n * Why a reviewed session was closed, as stamped server-side by `SessionManager.CloseSession`\n * (mirrors `MJAIAgentSessionEntity.CloseReason`). `null` means the session is still open OR a\n * legacy row was closed before the column existed.\n */\nexport type RealtimeReviewCloseReason = 'Error' | 'Explicit' | 'Janitor' | 'Shutdown';\n\n/** One historical caption turn of a reviewed session (a persisted `MJ: Conversation Details` row). */\nexport interface RealtimeSessionReviewTurn {\n  /** Who spoke the turn. Persisted `AI` rows map to `Assistant`. */\n  Role: 'User' | 'Assistant';\n  /** The transcript text. */\n  Text: string;\n  /** When the turn was persisted (`__mj_CreatedAt`), or null when unknown. */\n  At: Date | null;\n}\n\n/**\n * A compact preview of one DELEGATED agent run the reviewed session spawned (an\n * `MJ: AI Agent Runs` row linked via `AgentSessionID`, EXCLUDING the co-agent's own\n * observability run). Carries just enough to render a done delegation card.\n */\nexport interface RealtimeSessionReviewRun {\n  /** `MJ: AI Agent Runs.ID`. */\n  RunID: string;\n  /** The delegated agent's id. */\n  AgentID: string;\n  /** Denormalized agent display name from the run view, when available. */\n  AgentName: string | null;\n  /** Terminal (or last-known) run status (`Completed` | `Failed` | `Running` | …). */\n  Status: string;\n  /** Whether the run reported success. */\n  Success: boolean;\n  /** The run's user-facing result message, when one was recorded. */\n  Message: string | null;\n  /** The run's error message, when it failed. */\n  ErrorMessage: string | null;\n  /** The final step the run reported (`Success` | `Failed` | `Retry` | …), when known. */\n  FinalStep: string | null;\n  StartedAt: Date | null;\n  CompletedAt: Date | null;\n}\n\n/** The persisted state of one interactive channel of the reviewed session. */\nexport interface RealtimeSessionReviewChannelState {\n  /** Channel display name (e.g. `Whiteboard`), denormalized on the session-channel row. */\n  ChannelName: string;\n  /** The channel's serialized state of record (`AIAgentSessionChannel.Config`), or null when none was saved. */\n  StateJson: string | null;\n}\n\n/**\n * MULTI-LEG channel-state merge: folds every leg's channel rows into one state set,\n * NEWEST leg wins per channel name — but only a leg that actually SAVED state counts.\n * A resumed session whose final leg never touched the whiteboard therefore still\n * reviews with the board an EARLIER leg drew (previously only the primary/newest leg's\n * rows were consulted, so that board silently vanished from review).\n *\n * @param legChannelStates Per-leg channel states, ordered OLDEST → NEWEST (the chain order).\n * @returns One entry per channel name (case-insensitive), each from the newest leg that\n *   saved a non-empty state; channels no leg ever saved keep a null-state entry so the\n *   review still knows the channel existed.\n */\nexport function MergeChainChannelStates(\n  legChannelStates: ReadonlyArray<ReadonlyArray<RealtimeSessionReviewChannelState>>\n): RealtimeSessionReviewChannelState[] {\n  const byName = new Map<string, RealtimeSessionReviewChannelState>();\n  for (const leg of legChannelStates) {\n    for (const state of leg) {\n      const key = state.ChannelName.trim().toLowerCase();\n      if (key.length === 0) {\n        continue;\n      }\n      const existing = byName.get(key);\n      const hasState = typeof state.StateJson === 'string' && state.StateJson.trim().length > 0;\n      // Later legs are newer: a saved state always supersedes; a null/empty state only\n      // registers the channel's existence and never clobbers an earlier saved board.\n      if (!existing || hasState) {\n        byName.set(key, hasState ? state : (existing ?? state));\n      }\n    }\n  }\n  return [...byName.values()];\n}\n\n/**\n * One LEG of a reviewed session chain: a single `MJ: AI Agent Sessions` row plus its own\n * caption turns and delegated-run previews. A session resumed via `lastSessionId` chains\n * legs together (newest leg's `LastSessionID` → prior leg); the review loader walks that\n * chain BACKWARDS (capped — see the loader docs) so review mode can render the FULL\n * conversation arc chronologically, with a divider between legs.\n */\nexport interface RealtimeSessionReviewLeg {\n  /** `MJ: AI Agent Sessions.ID` of this leg. */\n  SessionID: string;\n  /** When this leg started (`__mj_CreatedAt`). */\n  StartedAt: Date | null;\n  /** When this leg closed (null while still open). */\n  ClosedAt: Date | null;\n  /** Why this leg closed (null while open / legacy rows). */\n  CloseReason: RealtimeReviewCloseReason | null;\n  /** This leg's chronological caption turns (oldest first). */\n  Turns: RealtimeSessionReviewTurn[];\n  /** This leg's delegated-run previews (oldest first, minus its co-agent observability run). */\n  DelegatedRuns: RealtimeSessionReviewRun[];\n}\n\n/**\n * Everything the call overlay's SESSION REVIEW mode renders for one past realtime session:\n * the session identity/lifecycle row, the chronological caption turns, previews of the\n * delegated runs, and the saved per-channel states (e.g. the whiteboard board).\n */\nexport interface RealtimeSessionReview {\n  /** `MJ: AI Agent Sessions.ID` of the reviewed session. */\n  SessionID: string;\n  /** The session's fronting agent id (`AIAgentSession.AgentID` — usually the Realtime Co-Agent). */\n  AgentID: string;\n  /** Display name shown in the review banner (target agent when resolvable, else the session agent). */\n  AgentName: string;\n  /**\n   * The agent a RESUMED live session should front: the session Config's `targetAgentID`,\n   * falling back to the session's own `AgentID` when the config doesn't carry one.\n   */\n  TargetAgentID: string;\n  /** Conversation the session was bound to, when any. */\n  ConversationID: string | null;\n  Status: 'Active' | 'Closed' | 'Idle';\n  CloseReason: RealtimeReviewCloseReason | null;\n  /** When the session started (`__mj_CreatedAt`). */\n  StartedAt: Date | null;\n  LastActiveAt: Date | null;\n  ClosedAt: Date | null;\n  /** Chronological caption turns (oldest first) — ALL legs of the chain, flattened. */\n  Turns: RealtimeSessionReviewTurn[];\n  /** Delegated run previews (oldest first, all legs), minus each leg's co-agent observability run. */\n  DelegatedRuns: RealtimeSessionReviewRun[];\n  /**\n   * Saved channel states, one per session-channel row that carried a name. Channel state\n   * (e.g. the whiteboard board) is the LATEST leg's only — earlier legs' states were\n   * superseded when the chain resumed.\n   */\n  ChannelStates: RealtimeSessionReviewChannelState[];\n  /**\n   * The session-chain LEGS, chronological (oldest first; the LAST leg is the reviewed\n   * session itself). Single-session reviews carry exactly one leg. Drives the per-leg\n   * dividers `BuildReviewThreadItems` renders.\n   */\n  Legs: RealtimeSessionReviewLeg[];\n  /**\n   * ARTIFACTS attached to the chain's conversation history: every `MJ: Conversation\n   * Detail Artifacts` junction (Direction `Output`) hanging off the chain's\n   * session-stamped `Conversation Details`, resolved to `{ArtifactID, ArtifactVersionID,\n   * Name}`. Review mode registers each as an (unfocused) artifact tab on the surface\n   * panel, and they carry into a resumed live session. Empty when none / on any\n   * tolerated load failure.\n   */\n  Artifacts: ParsedDelegationArtifact[];\n}\n\n// ── Raw row shapes (ResultType: 'simple', narrowed Fields) ──────────────────\n\ninterface SessionRow {\n  ID: string;\n  AgentID: string;\n  Agent: string | null;\n  Status: 'Active' | 'Closed' | 'Idle';\n  ConversationID: string | null;\n  Config: string | null;\n  LastSessionID: string | null;\n  LastActiveAt: string | null;\n  ClosedAt: string | null;\n  CloseReason: RealtimeReviewCloseReason | null;\n  __mj_CreatedAt: string | null;\n}\n\ninterface DetailRow {\n  ID: string;\n  Role: 'AI' | 'Error' | 'User';\n  Message: string | null;\n  HiddenToUser: boolean;\n  __mj_CreatedAt: string | null;\n}\n\ninterface RunRow {\n  ID: string;\n  AgentID: string;\n  Agent: string | null;\n  Status: string;\n  Success: boolean | null;\n  Message: string | null;\n  ErrorMessage: string | null;\n  FinalStep: string | null;\n  StartedAt: string | null;\n  CompletedAt: string | null;\n}\n\ninterface ChannelRow {\n  ID: string;\n  Channel: string | null;\n  Config: string | null;\n}\n\ninterface DetailArtifactJunctionRow {\n  ID: string;\n  ConversationDetailID: string;\n  ArtifactVersionID: string | null;\n}\n\ninterface ArtifactVersionRow {\n  ID: string;\n  ArtifactID: string;\n  /** Version display name (nullable on the row). */\n  Name: string | null;\n  /** Denormalized parent-artifact name from the version view. */\n  Artifact: string | null;\n}\n\n/** The raw rows of ONE chain leg, before mapping to the public review shapes. */\ninterface LegRows {\n  session: SessionRow;\n  details: DetailRow[];\n  runs: RunRow[];\n  channels: ChannelRow[];\n}\n\n/** The Config-JSON keys the realtime voice stack persists on `AIAgentSession.Config`. */\ninterface SessionConfigJson {\n  targetAgentID?: string;\n  coAgentRunID?: string;\n}\n\nconst SESSION_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'ConversationID', 'Config', 'LastSessionID', 'LastActiveAt', 'ClosedAt', 'CloseReason', '__mj_CreatedAt'];\nconst DETAIL_FIELDS = ['ID', 'Role', 'Message', 'HiddenToUser', '__mj_CreatedAt'];\nconst RUN_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'Success', 'Message', 'ErrorMessage', 'FinalStep', 'StartedAt', 'CompletedAt'];\nconst CHANNEL_FIELDS = ['ID', 'Channel', 'Config'];\nconst JUNCTION_FIELDS = ['ID', 'ConversationDetailID', 'ArtifactVersionID'];\nconst VERSION_FIELDS = ['ID', 'ArtifactID', 'Name', 'Artifact'];\n\n/** Maximum number of chain legs the review loader walks (the reviewed session included). */\nexport const MAX_REVIEW_LEGS = 5;\n/** Maximum total caption-detail rows loaded across the whole chain (oldest legs trimmed first). */\nexport const MAX_REVIEW_DETAILS = 500;\n\n// ── Review → thread-item mapping (pure, unit-testable) ──────────────────────\n\n/** Maps one delegated-run preview to the done delegation-card VM the thread/rail render. */\nexport function BuildReviewDelegationCard(run: RealtimeSessionReviewRun, fallbackAgentName: string): RealtimeDelegationCardVM {\n  const startedAt = run.StartedAt?.getTime() ?? 0;\n  return {\n    CallID: run.RunID,\n    AgentName: run.AgentName || fallbackAgentName,\n    LatestMessage: run.Message ?? run.ErrorMessage ?? run.Status,\n    LatestStep: run.FinalStep ?? '',\n    Done: true,\n    Success: run.Success,\n    RunRef: shortRunRef(run.RunID),\n    RunID: run.RunID,\n    Result: run.Message ?? run.ErrorMessage ?? null,\n    StartedAt: startedAt,\n    FinishedAt: run.CompletedAt?.getTime() ?? startedAt\n  };\n}\n\n/**\n * Builds the chronological thread (caption turns + done delegation cards, oldest first)\n * for a reviewed session — the items `RealtimeSessionState.LoadHistoricalItems` takes.\n *\n * CHAIN-AWARE: when the review carries multiple {@link RealtimeSessionReview.Legs}, each\n * leg's items render in leg order with a `divider` item between legs (\"Session leg\n * started · <time>\", carrying the PREVIOUS leg's CloseReason as a chip). A single-leg\n * review (or a legless legacy shape) renders the flat thread with no divider —\n * byte-identical to the pre-chain behavior.\n */\nexport function BuildReviewThreadItems(review: RealtimeSessionReview): RealtimeThreadItem[] {\n  const legs = review.Legs ?? [];\n  if (legs.length <= 1) {\n    const only = legs[0];\n    return buildLegThreadItems(only?.Turns ?? review.Turns, only?.DelegatedRuns ?? review.DelegatedRuns, review.AgentName);\n  }\n  const items: RealtimeThreadItem[] = [];\n  legs.forEach((leg, i) => {\n    if (i > 0) {\n      items.push({\n        Kind: 'divider',\n        Label: 'Session leg started',\n        At: leg.StartedAt,\n        Icon: 'fa-solid fa-arrows-rotate',\n        CloseReason: legs[i - 1].CloseReason ?? null\n      });\n    }\n    items.push(...buildLegThreadItems(leg.Turns, leg.DelegatedRuns, review.AgentName));\n  });\n  return items;\n}\n\n/**\n * Builds ONE leg's chronological items (caption turns + done delegation cards, oldest\n * first). Entries without a timestamp sort to the front, preserving their relative order.\n */\nfunction buildLegThreadItems(\n  turns: RealtimeSessionReviewTurn[],\n  runs: RealtimeSessionReviewRun[],\n  fallbackAgentName: string\n): RealtimeThreadItem[] {\n  const stamped: Array<{ At: number; Item: RealtimeThreadItem }> = [];\n  for (const turn of turns) {\n    stamped.push({ At: turn.At?.getTime() ?? 0, Item: { Kind: 'caption', Role: turn.Role, Text: turn.Text } });\n  }\n  for (const run of runs) {\n    stamped.push({ At: run.StartedAt?.getTime() ?? 0, Item: { Kind: 'delegation', Card: BuildReviewDelegationCard(run, fallbackAgentName) } });\n  }\n  // Array.prototype.sort is stable — equal timestamps keep their build order.\n  stamped.sort((a, b) => a.At - b.At);\n  return stamped.map(s => s.Item);\n}\n\n/** Derives a short run reference (e.g. \"#a3f1\") from the run id — mirrors the live cards. */\nfunction shortRunRef(runId: string): string {\n  const compact = runId.replace(/[^a-z0-9]/gi, '');\n  return compact.length >= 4 ? `#${compact.slice(-4).toLowerCase()}` : `#${compact.toLowerCase()}`;\n}\n\n/**\n * STATELESS loader for the call overlay's SESSION REVIEW mode: given a past\n * `MJ: AI Agent Sessions` id, batch-loads the session row, its persisted caption turns\n * (`MJ: Conversation Details` linked by `AgentSessionID`), its delegated agent runs\n * (minus the co-agent observability run named in the session Config's `coAgentRunID`),\n * and its saved channel states — and folds them into one {@link RealtimeSessionReview}.\n *\n * CHAIN-AWARE: when the reviewed session carries a `LastSessionID` (it RESUMED an earlier\n * session), the loader walks the chain BACKWARDS — capped at {@link MAX_REVIEW_LEGS} legs\n * and {@link MAX_REVIEW_DETAILS} caption rows total (oldest legs trimmed first), with a\n * cycle guard so a corrupt A→B→A chain can never loop — and surfaces ALL legs\n * chronologically on {@link RealtimeSessionReview.Legs}. Channel state stays the\n * reviewed (latest) leg's only. The chain's conversation-history ARTIFACTS (junction\n * rows on the session-stamped details) are collected onto\n * {@link RealtimeSessionReview.Artifacts}.\n *\n * TOLERANT by design: any missing piece degrades to an empty collection; the loader\n * returns `null` only when the reviewed session row itself can't be found.\n */\n@Injectable({ providedIn: 'root' })\nexport class RealtimeSessionReviewService {\n  /**\n   * Loads everything review mode renders for one past session (and its prior-leg chain).\n   *\n   * @param agentSessionId The `MJ: AI Agent Sessions.ID` to review.\n   * @param provider Optional metadata provider (multi-server apps); falls back to the global default.\n   * @returns The assembled review, or `null` when the session doesn't exist / can't be read.\n   */\n  public async LoadSessionReview(agentSessionId: string, provider?: IMetadataProvider): Promise<RealtimeSessionReview | null> {\n    const trimmed = agentSessionId?.trim() ?? '';\n    if (trimmed.length === 0) {\n      return null;\n    }\n    try {\n      const md = provider ?? Metadata.Provider;\n      const primary = await this.loadLegRows(trimmed, md, true);\n      if (!primary) {\n        return null;\n      }\n      const chain = await this.collectChainLegs(primary, md);\n      const artifacts = await this.loadChainArtifacts(chain, md);\n      return this.assembleReview(chain, artifacts);\n    } catch (error) {\n      console.error('[RealtimeSessionReview] Failed to load session review:', error);\n      return null;\n    }\n  }\n\n  /**\n   * One batched RunViews pass for one chain leg: session row + caption turns + linked\n   * runs (+ channel rows for the PRIMARY leg only — channel state is latest-leg-only).\n   * Returns `null` when the session row can't be found.\n   */\n  private async loadLegRows(\n    agentSessionId: string,\n    provider: IMetadataProvider,\n    includeChannels: boolean\n  ): Promise<LegRows | null> {\n    const safeID = agentSessionId.replace(/'/g, \"''\");\n    const rv = RunView.FromMetadataProvider(provider);\n    const queries: RunViewParams[] = [\n      { EntityName: 'MJ: AI Agent Sessions', ExtraFilter: `ID='${safeID}'`, Fields: SESSION_FIELDS, ResultType: 'simple' as const },\n      {\n        EntityName: 'MJ: Conversation Details', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: DETAIL_FIELDS,\n        OrderBy: '__mj_CreatedAt ASC', MaxRows: MAX_REVIEW_DETAILS, ResultType: 'simple' as const\n      },\n      { EntityName: 'MJ: AI Agent Runs', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: RUN_FIELDS, OrderBy: 'StartedAt ASC', ResultType: 'simple' as const }\n    ];\n    if (includeChannels) {\n      queries.push({ EntityName: 'MJ: AI Agent Session Channels', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: CHANNEL_FIELDS, ResultType: 'simple' as const });\n    }\n    const [sessionResult, detailResult, runResult, channelResult] = await rv.RunViews(queries);\n    const sessions = (sessionResult?.Success ? sessionResult.Results : []) as SessionRow[];\n    const session = sessions[0] ?? null;\n    if (!session) {\n      return null;\n    }\n    return {\n      session,\n      details: (detailResult?.Success ? detailResult.Results : []) as DetailRow[],\n      runs: (runResult?.Success ? runResult.Results : []) as RunRow[],\n      channels: (channelResult?.Success ? channelResult.Results : []) as ChannelRow[]\n    };\n  }\n\n  /**\n   * Walks the `LastSessionID` chain BACKWARDS from the reviewed (primary) leg, collecting\n   * raw leg rows OLDEST-FIRST (primary last). Safety rails:\n   *  - at most {@link MAX_REVIEW_LEGS} legs total;\n   *  - at most {@link MAX_REVIEW_DETAILS} caption rows across the chain — an older leg\n   *    whose details would overflow the budget is trimmed to its NEWEST rows and ends\n   *    the walk;\n   *  - a visited-set cycle guard (case-insensitive ids) so A→B→A can never loop;\n   *  - a leg that fails to load simply ends the walk (the collected legs still render).\n   */\n  private async collectChainLegs(primary: LegRows, provider: IMetadataProvider): Promise<LegRows[]> {\n    const chain: LegRows[] = [primary];\n    const visited = new Set<string>([this.normalizeID(primary.session.ID)]);\n    let cursor = primary.session.LastSessionID ?? null;\n    let detailBudget = MAX_REVIEW_DETAILS - primary.details.length;\n\n    while (cursor && chain.length < MAX_REVIEW_LEGS && detailBudget > 0) {\n      const key = this.normalizeID(cursor);\n      if (visited.has(key)) {\n        console.warn(`[RealtimeSessionReview] Session chain cycle detected at ${cursor} — stopping the walk.`);\n        break;\n      }\n      visited.add(key);\n      const leg = await this.loadLegRows(cursor, provider, false);\n      if (!leg) {\n        break;\n      }\n      if (leg.details.length > detailBudget) {\n        // Keep this leg's NEWEST rows (details arrive oldest-first) and end the walk.\n        leg.details = leg.details.slice(leg.details.length - detailBudget);\n        detailBudget = 0;\n      } else {\n        detailBudget -= leg.details.length;\n      }\n      chain.unshift(leg);\n      cursor = leg.session.LastSessionID ?? null;\n    }\n    return chain;\n  }\n\n  /**\n   * Collects the chain's conversation-history ARTIFACTS: `MJ: Conversation Detail\n   * Artifacts` junction rows (Direction `Output`) hanging off the chain's session-stamped\n   * details, resolved through `MJ: Artifact Versions` to `{ArtifactID, ArtifactVersionID,\n   * Name}` (version name, falling back to the artifact name). Order follows junction\n   * creation; duplicate versions are deduped. TOLERANT: any failure returns `[]`.\n   */\n  private async loadChainArtifacts(chain: LegRows[], provider: IMetadataProvider): Promise<ParsedDelegationArtifact[]> {\n    const detailIDs = chain.flatMap(leg => leg.details.map(d => d.ID)).filter(id => typeof id === 'string' && id.length > 0);\n    if (detailIDs.length === 0) {\n      return [];\n    }\n    try {\n      const rv = RunView.FromMetadataProvider(provider);\n      const detailList = detailIDs.map(id => `'${id.replace(/'/g, \"''\")}'`).join(',');\n      const [junctionResult] = await rv.RunViews([{\n        EntityName: 'MJ: Conversation Detail Artifacts',\n        ExtraFilter: `ConversationDetailID IN (${detailList}) AND Direction='Output'`,\n        Fields: JUNCTION_FIELDS,\n        OrderBy: '__mj_CreatedAt ASC',\n        ResultType: 'simple'\n      }]);\n      const junctions = (junctionResult?.Success ? junctionResult.Results : []) as DetailArtifactJunctionRow[];\n      const versionIDs = this.uniqueVersionIDs(junctions);\n      if (versionIDs.length === 0) {\n        return [];\n      }\n\n      const versionList = versionIDs.map(id => `'${id.replace(/'/g, \"''\")}'`).join(',');\n      const [versionResult] = await rv.RunViews([{\n        EntityName: 'MJ: Artifact Versions',\n        ExtraFilter: `ID IN (${versionList})`,\n        Fields: VERSION_FIELDS,\n        ResultType: 'simple'\n      }]);\n      const versions = (versionResult?.Success ? versionResult.Results : []) as ArtifactVersionRow[];\n      const byID = new Map<string, ArtifactVersionRow>(versions.map(v => [this.normalizeID(v.ID), v]));\n\n      const artifacts: ParsedDelegationArtifact[] = [];\n      for (const versionID of versionIDs) {\n        const row = byID.get(this.normalizeID(versionID));\n        if (!row?.ArtifactID) {\n          continue; // junction points at an unreadable / deleted version — skip\n        }\n        artifacts.push({\n          ArtifactID: row.ArtifactID,\n          ArtifactVersionID: row.ID,\n          Name: row.Name?.trim() || row.Artifact?.trim() || 'Artifact'\n        });\n      }\n      return artifacts;\n    } catch (error) {\n      console.warn('[RealtimeSessionReview] Artifact collection failed — review renders without artifact tabs.', error);\n      return [];\n    }\n  }\n\n  /** Unique, non-empty `ArtifactVersionID`s from junction rows, in arrival order (case-insensitive dedupe). */\n  private uniqueVersionIDs(junctions: DetailArtifactJunctionRow[]): string[] {\n    const seen = new Set<string>();\n    const ids: string[] = [];\n    for (const j of junctions) {\n      const id = typeof j.ArtifactVersionID === 'string' ? j.ArtifactVersionID.trim() : '';\n      if (id.length === 0 || seen.has(this.normalizeID(id))) {\n        continue;\n      }\n      seen.add(this.normalizeID(id));\n      ids.push(id);\n    }\n    return ids;\n  }\n\n  /** Case-insensitive UUID key for Set/Map membership (SQL Server uppercase vs PostgreSQL lowercase). */\n  private normalizeID(id: string): string {\n    return (id ?? '').trim().toLowerCase();\n  }\n\n  /**\n   * Folds the chain's raw leg rows into the typed review. The PRIMARY (reviewed) leg —\n   * the chain's LAST entry — supplies identity/lifecycle/channel state; turns and runs\n   * are surfaced both per-leg (`Legs`) and flattened chronologically (`Turns` /\n   * `DelegatedRuns`). Each leg excludes ITS OWN config's co-agent observability run.\n   */\n  private assembleReview(chain: LegRows[], artifacts: ParsedDelegationArtifact[]): RealtimeSessionReview {\n    const primary = chain[chain.length - 1];\n    const session = primary.session;\n    const config = this.parseSessionConfig(session.Config);\n    const legs = chain.map(leg => this.mapLeg(leg));\n    return {\n      SessionID: session.ID,\n      AgentID: session.AgentID,\n      AgentName: session.Agent || 'the agent',\n      TargetAgentID: config.targetAgentID ?? session.AgentID,\n      ConversationID: session.ConversationID ?? null,\n      Status: session.Status,\n      CloseReason: session.CloseReason ?? null,\n      StartedAt: this.toDate(session.__mj_CreatedAt),\n      LastActiveAt: this.toDate(session.LastActiveAt),\n      ClosedAt: this.toDate(session.ClosedAt),\n      Turns: legs.flatMap(l => l.Turns),\n      DelegatedRuns: legs.flatMap(l => l.DelegatedRuns),\n      // Multi-leg: newest leg with a SAVED state wins per channel — a final leg that\n      // never touched the board no longer hides an earlier leg's drawing from review.\n      ChannelStates: MergeChainChannelStates(chain.map(leg => this.mapChannels(leg.channels))),\n      Legs: legs,\n      Artifacts: artifacts\n    };\n  }\n\n  /** Maps one leg's raw rows to the public leg shape (per-leg co-agent-run exclusion). */\n  private mapLeg(leg: LegRows): RealtimeSessionReviewLeg {\n    const config = this.parseSessionConfig(leg.session.Config);\n    return {\n      SessionID: leg.session.ID,\n      StartedAt: this.toDate(leg.session.__mj_CreatedAt),\n      ClosedAt: this.toDate(leg.session.ClosedAt),\n      CloseReason: leg.session.CloseReason ?? null,\n      Turns: this.mapTurns(leg.details),\n      DelegatedRuns: this.mapRuns(leg.runs, config.coAgentRunID ?? null)\n    };\n  }\n\n  /** Persisted detail rows → caption turns: visible `User`/`AI` rows with text (AI → Assistant). */\n  private mapTurns(details: DetailRow[]): RealtimeSessionReviewTurn[] {\n    const turns: RealtimeSessionReviewTurn[] = [];\n    for (const row of details) {\n      const text = row.Message?.trim() ?? '';\n      if (row.HiddenToUser || text.length === 0 || (row.Role !== 'User' && row.Role !== 'AI')) {\n        continue;\n      }\n      turns.push({\n        Role: row.Role === 'AI' ? 'Assistant' : 'User',\n        Text: text,\n        At: this.toDate(row.__mj_CreatedAt)\n      });\n    }\n    return turns;\n  }\n\n  /** Linked run rows → delegated-run previews, EXCLUDING the co-agent's observability run. */\n  private mapRuns(runs: RunRow[], coAgentRunId: string | null): RealtimeSessionReviewRun[] {\n    return runs\n      .filter(r => !coAgentRunId || !UUIDsEqual(r.ID, coAgentRunId))\n      .map(r => ({\n        RunID: r.ID,\n        AgentID: r.AgentID,\n        AgentName: r.Agent ?? null,\n        Status: r.Status ?? '',\n        Success: r.Success === true,\n        Message: r.Message ?? null,\n        ErrorMessage: r.ErrorMessage ?? null,\n        FinalStep: r.FinalStep ?? null,\n        StartedAt: this.toDate(r.StartedAt),\n        CompletedAt: this.toDate(r.CompletedAt)\n      }));\n  }\n\n  /** Session-channel rows → named channel states (rows without a channel name are skipped). */\n  private mapChannels(channels: ChannelRow[]): RealtimeSessionReviewChannelState[] {\n    return channels\n      .filter(c => !!c.Channel)\n      .map(c => ({ ChannelName: c.Channel as string, StateJson: c.Config ?? null }));\n  }\n\n  /** Tolerant Config JSON parse — malformed/missing payloads degrade to `{}`. */\n  private parseSessionConfig(raw: string | null): SessionConfigJson {\n    if (!raw) {\n      return {};\n    }\n    try {\n      const parsed = JSON.parse(raw) as SessionConfigJson;\n      return parsed && typeof parsed === 'object' ? parsed : {};\n    } catch {\n      return {};\n    }\n  }\n\n  /** Tolerant date conversion — view rows arrive as ISO strings (or Dates from some providers). */\n  private toDate(value: string | Date | null | undefined): Date | null {\n    if (value == null) {\n      return null;\n    }\n    const date = value instanceof Date ? value : new Date(value);\n    return isNaN(date.getTime()) ? null : date;\n  }\n}\n"]}
+{"version":3,"file":"realtime-session-review.service.js","sourceRoot":"","sources":["../../../src/lib/services/realtime-session-review.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { IMetadataProvider, Metadata, RunView, RunViewParams } from '@memberjunction/core';\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { RealtimeDelegationCardVM, RealtimeThreadItem } from '../components/realtime/realtime-session-state';\nimport { ParsedDelegationArtifact } from './delegation-result-parser';\n\n/**\n * Why a reviewed session was closed, as stamped server-side by `SessionManager.CloseSession`\n * (mirrors `MJAIAgentSessionEntity.CloseReason`). `null` means the session is still open OR a\n * legacy row was closed before the column existed.\n */\nexport type RealtimeReviewCloseReason = 'Error' | 'Explicit' | 'Janitor' | 'Shutdown';\n\n/**\n * One historical caption turn of a reviewed session (a persisted `MJ: Conversation Details` row).\n *\n * Carries BOTH the thread-rendering fields (`Role`/`Text`/`At`) AND the raw fields the time-aligned\n * evidence player reads (`ID`, `Message`, `__mj_CreatedAt`, `UtteranceStartMs`, `UtteranceEndMs`) so\n * a review's turns can be handed straight to {@link RealtimeEvidencePlaybackComponent} for the\n * Recording tab — this shape structurally satisfies that player's `EvidencePlaybackTurn` input.\n */\nexport interface RealtimeSessionReviewTurn {\n  /** `MJ: Conversation Details.ID` — the player's `@for` track key. */\n  ID: string;\n  /** Who spoke the turn. Persisted `AI` rows map to `Assistant`. */\n  Role: 'User' | 'Assistant';\n  /** The transcript text. */\n  Text: string;\n  /** The raw transcript text (mirrors {@link Text}) — the player reads `Message`. */\n  Message: string | null;\n  /** When the turn was persisted (`__mj_CreatedAt`), or null when unknown. Aliases {@link At}. */\n  __mj_CreatedAt: Date | null;\n  /** When the turn was persisted (`__mj_CreatedAt`), or null when unknown. */\n  At: Date | null;\n  /** Precise media-relative start (ms from recording t0), or null when the driver supplied no timing. */\n  UtteranceStartMs: number | null;\n  /** Precise media-relative end (ms from recording t0), or null. */\n  UtteranceEndMs: number | null;\n}\n\n/**\n * A compact preview of one DELEGATED agent run the reviewed session spawned (an\n * `MJ: AI Agent Runs` row linked via `AgentSessionID`, EXCLUDING the co-agent's own\n * observability run). Carries just enough to render a done delegation card.\n */\nexport interface RealtimeSessionReviewRun {\n  /** `MJ: AI Agent Runs.ID`. */\n  RunID: string;\n  /** The delegated agent's id. */\n  AgentID: string;\n  /** Denormalized agent display name from the run view, when available. */\n  AgentName: string | null;\n  /** Terminal (or last-known) run status (`Completed` | `Failed` | `Running` | …). */\n  Status: string;\n  /** Whether the run reported success. */\n  Success: boolean;\n  /** The run's user-facing result message, when one was recorded. */\n  Message: string | null;\n  /** The run's error message, when it failed. */\n  ErrorMessage: string | null;\n  /** The final step the run reported (`Success` | `Failed` | `Retry` | …), when known. */\n  FinalStep: string | null;\n  StartedAt: Date | null;\n  CompletedAt: Date | null;\n}\n\n/** The persisted state of one interactive channel of the reviewed session. */\nexport interface RealtimeSessionReviewChannelState {\n  /** Channel display name (e.g. `Whiteboard`), denormalized on the session-channel row. */\n  ChannelName: string;\n  /** The channel's serialized state of record (`AIAgentSessionChannel.Config`), or null when none was saved. */\n  StateJson: string | null;\n}\n\n/**\n * MULTI-LEG channel-state merge: folds every leg's channel rows into one state set,\n * NEWEST leg wins per channel name — but only a leg that actually SAVED state counts.\n * A resumed session whose final leg never touched the whiteboard therefore still\n * reviews with the board an EARLIER leg drew (previously only the primary/newest leg's\n * rows were consulted, so that board silently vanished from review).\n *\n * @param legChannelStates Per-leg channel states, ordered OLDEST → NEWEST (the chain order).\n * @returns One entry per channel name (case-insensitive), each from the newest leg that\n *   saved a non-empty state; channels no leg ever saved keep a null-state entry so the\n *   review still knows the channel existed.\n */\nexport function MergeChainChannelStates(\n  legChannelStates: ReadonlyArray<ReadonlyArray<RealtimeSessionReviewChannelState>>\n): RealtimeSessionReviewChannelState[] {\n  const byName = new Map<string, RealtimeSessionReviewChannelState>();\n  for (const leg of legChannelStates) {\n    for (const state of leg) {\n      const key = state.ChannelName.trim().toLowerCase();\n      if (key.length === 0) {\n        continue;\n      }\n      const existing = byName.get(key);\n      const hasState = typeof state.StateJson === 'string' && state.StateJson.trim().length > 0;\n      // Later legs are newer: a saved state always supersedes; a null/empty state only\n      // registers the channel's existence and never clobbers an earlier saved board.\n      if (!existing || hasState) {\n        byName.set(key, hasState ? state : (existing ?? state));\n      }\n    }\n  }\n  return [...byName.values()];\n}\n\n/**\n * One LEG of a reviewed session chain: a single `MJ: AI Agent Sessions` row plus its own\n * caption turns and delegated-run previews. A session resumed via `lastSessionId` chains\n * legs together (newest leg's `LastSessionID` → prior leg); the review loader walks that\n * chain BACKWARDS (capped — see the loader docs) so review mode can render the FULL\n * conversation arc chronologically, with a divider between legs.\n */\nexport interface RealtimeSessionReviewLeg {\n  /** `MJ: AI Agent Sessions.ID` of this leg. */\n  SessionID: string;\n  /** When this leg started (`__mj_CreatedAt`). */\n  StartedAt: Date | null;\n  /** When this leg closed (null while still open). */\n  ClosedAt: Date | null;\n  /** Why this leg closed (null while open / legacy rows). */\n  CloseReason: RealtimeReviewCloseReason | null;\n  /** This leg's chronological caption turns (oldest first). */\n  Turns: RealtimeSessionReviewTurn[];\n  /** This leg's delegated-run previews (oldest first, minus its co-agent observability run). */\n  DelegatedRuns: RealtimeSessionReviewRun[];\n}\n\n/**\n * Everything the call overlay's SESSION REVIEW mode renders for one past realtime session:\n * the session identity/lifecycle row, the chronological caption turns, previews of the\n * delegated runs, and the saved per-channel states (e.g. the whiteboard board).\n */\nexport interface RealtimeSessionReview {\n  /** `MJ: AI Agent Sessions.ID` of the reviewed session. */\n  SessionID: string;\n  /** The session's fronting agent id (`AIAgentSession.AgentID` — usually the Realtime Co-Agent). */\n  AgentID: string;\n  /** Display name shown in the review banner (target agent when resolvable, else the session agent). */\n  AgentName: string;\n  /**\n   * The agent a RESUMED live session should front: the session Config's `targetAgentID`,\n   * falling back to the session's own `AgentID` when the config doesn't carry one.\n   */\n  TargetAgentID: string;\n  /** Conversation the session was bound to, when any. */\n  ConversationID: string | null;\n  Status: 'Active' | 'Closed' | 'Idle';\n  CloseReason: RealtimeReviewCloseReason | null;\n  /** When the session started (`__mj_CreatedAt`). */\n  StartedAt: Date | null;\n  LastActiveAt: Date | null;\n  ClosedAt: Date | null;\n  /**\n   * The `MJ: Files` id of the reviewed session's recorded audio, or null when nothing was recorded.\n   * When set, review mode resolves a signed download URL and shows a Recording tab with the\n   * time-aligned evidence player. From the PRIMARY (reviewed) leg only.\n   */\n  RecordingFileID: string | null;\n  /** Recording alignment origin (t0), used by the playback transcript sync. From the primary leg. */\n  RecordingStartedAt: Date | null;\n  /** What was captured (`Audio` / `AudioVideo`), or null. From the primary leg. */\n  RecordingMedia: string | null;\n  /** Chronological caption turns (oldest first) — ALL legs of the chain, flattened. */\n  Turns: RealtimeSessionReviewTurn[];\n  /** Delegated run previews (oldest first, all legs), minus each leg's co-agent observability run. */\n  DelegatedRuns: RealtimeSessionReviewRun[];\n  /**\n   * Saved channel states, one per session-channel row that carried a name. Channel state\n   * (e.g. the whiteboard board) is the LATEST leg's only — earlier legs' states were\n   * superseded when the chain resumed.\n   */\n  ChannelStates: RealtimeSessionReviewChannelState[];\n  /**\n   * The session-chain LEGS, chronological (oldest first; the LAST leg is the reviewed\n   * session itself). Single-session reviews carry exactly one leg. Drives the per-leg\n   * dividers `BuildReviewThreadItems` renders.\n   */\n  Legs: RealtimeSessionReviewLeg[];\n  /**\n   * ARTIFACTS attached to the chain's conversation history: every `MJ: Conversation\n   * Detail Artifacts` junction (Direction `Output`) hanging off the chain's\n   * session-stamped `Conversation Details`, resolved to `{ArtifactID, ArtifactVersionID,\n   * Name}`. Review mode registers each as an (unfocused) artifact tab on the surface\n   * panel, and they carry into a resumed live session. Empty when none / on any\n   * tolerated load failure.\n   */\n  Artifacts: ParsedDelegationArtifact[];\n}\n\n// ── Raw row shapes (ResultType: 'simple', narrowed Fields) ──────────────────\n\ninterface SessionRow {\n  ID: string;\n  AgentID: string;\n  Agent: string | null;\n  Status: 'Active' | 'Closed' | 'Idle';\n  ConversationID: string | null;\n  Config: string | null;\n  LastSessionID: string | null;\n  LastActiveAt: string | null;\n  ClosedAt: string | null;\n  CloseReason: RealtimeReviewCloseReason | null;\n  RecordingFileID: string | null;\n  RecordingStartedAt: string | null;\n  RecordingMedia: string | null;\n  __mj_CreatedAt: string | null;\n}\n\ninterface DetailRow {\n  ID: string;\n  Role: 'AI' | 'Error' | 'User';\n  Message: string | null;\n  HiddenToUser: boolean;\n  UserID: string | null;\n  Status: string | null;\n  UtteranceStartMs: number | null;\n  UtteranceEndMs: number | null;\n  __mj_CreatedAt: string | null;\n}\n\ninterface RunRow {\n  ID: string;\n  AgentID: string;\n  Agent: string | null;\n  Status: string;\n  Success: boolean | null;\n  Message: string | null;\n  ErrorMessage: string | null;\n  FinalStep: string | null;\n  StartedAt: string | null;\n  CompletedAt: string | null;\n}\n\ninterface ChannelRow {\n  ID: string;\n  Channel: string | null;\n  Config: string | null;\n}\n\ninterface DetailArtifactJunctionRow {\n  ID: string;\n  ConversationDetailID: string;\n  ArtifactVersionID: string | null;\n}\n\ninterface ArtifactVersionRow {\n  ID: string;\n  ArtifactID: string;\n  /** Version display name (nullable on the row). */\n  Name: string | null;\n  /** Denormalized parent-artifact name from the version view. */\n  Artifact: string | null;\n}\n\n/** The raw rows of ONE chain leg, before mapping to the public review shapes. */\ninterface LegRows {\n  session: SessionRow;\n  details: DetailRow[];\n  runs: RunRow[];\n  channels: ChannelRow[];\n}\n\n/** The Config-JSON keys the realtime voice stack persists on `AIAgentSession.Config`. */\ninterface SessionConfigJson {\n  targetAgentID?: string;\n  coAgentRunID?: string;\n}\n\nconst SESSION_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'ConversationID', 'Config', 'LastSessionID', 'LastActiveAt', 'ClosedAt', 'CloseReason', 'RecordingFileID', 'RecordingStartedAt', 'RecordingMedia', '__mj_CreatedAt'];\nconst DETAIL_FIELDS = ['ID', 'Role', 'Message', 'HiddenToUser', 'UserID', 'Status', 'UtteranceStartMs', 'UtteranceEndMs', '__mj_CreatedAt'];\nconst RUN_FIELDS = ['ID', 'AgentID', 'Agent', 'Status', 'Success', 'Message', 'ErrorMessage', 'FinalStep', 'StartedAt', 'CompletedAt'];\nconst CHANNEL_FIELDS = ['ID', 'Channel', 'Config'];\nconst JUNCTION_FIELDS = ['ID', 'ConversationDetailID', 'ArtifactVersionID'];\nconst VERSION_FIELDS = ['ID', 'ArtifactID', 'Name', 'Artifact'];\n\n/** Maximum number of chain legs the review loader walks (the reviewed session included). */\nexport const MAX_REVIEW_LEGS = 5;\n/** Maximum total caption-detail rows loaded across the whole chain (oldest legs trimmed first). */\nexport const MAX_REVIEW_DETAILS = 500;\n\n// ── Review → thread-item mapping (pure, unit-testable) ──────────────────────\n\n/** Maps one delegated-run preview to the done delegation-card VM the thread/rail render. */\nexport function BuildReviewDelegationCard(run: RealtimeSessionReviewRun, fallbackAgentName: string): RealtimeDelegationCardVM {\n  const startedAt = run.StartedAt?.getTime() ?? 0;\n  return {\n    CallID: run.RunID,\n    AgentName: run.AgentName || fallbackAgentName,\n    LatestMessage: run.Message ?? run.ErrorMessage ?? run.Status,\n    LatestStep: run.FinalStep ?? '',\n    Done: true,\n    Success: run.Success,\n    RunRef: shortRunRef(run.RunID),\n    RunID: run.RunID,\n    Result: run.Message ?? run.ErrorMessage ?? null,\n    StartedAt: startedAt,\n    FinishedAt: run.CompletedAt?.getTime() ?? startedAt\n  };\n}\n\n/**\n * Builds the chronological thread (caption turns + done delegation cards, oldest first)\n * for a reviewed session — the items `RealtimeSessionState.LoadHistoricalItems` takes.\n *\n * CHAIN-AWARE: when the review carries multiple {@link RealtimeSessionReview.Legs}, each\n * leg's items render in leg order with a `divider` item between legs (\"Session leg\n * started · <time>\", carrying the PREVIOUS leg's CloseReason as a chip). A single-leg\n * review (or a legless legacy shape) renders the flat thread with no divider —\n * byte-identical to the pre-chain behavior.\n */\nexport function BuildReviewThreadItems(review: RealtimeSessionReview): RealtimeThreadItem[] {\n  const legs = review.Legs ?? [];\n  if (legs.length <= 1) {\n    const only = legs[0];\n    return buildLegThreadItems(only?.Turns ?? review.Turns, only?.DelegatedRuns ?? review.DelegatedRuns, review.AgentName);\n  }\n  const items: RealtimeThreadItem[] = [];\n  legs.forEach((leg, i) => {\n    if (i > 0) {\n      items.push({\n        Kind: 'divider',\n        Label: 'Session leg started',\n        At: leg.StartedAt,\n        Icon: 'fa-solid fa-arrows-rotate',\n        CloseReason: legs[i - 1].CloseReason ?? null\n      });\n    }\n    items.push(...buildLegThreadItems(leg.Turns, leg.DelegatedRuns, review.AgentName));\n  });\n  return items;\n}\n\n/**\n * Builds ONE leg's chronological items (caption turns + done delegation cards, oldest\n * first). Entries without a timestamp sort to the front, preserving their relative order.\n */\nfunction buildLegThreadItems(\n  turns: RealtimeSessionReviewTurn[],\n  runs: RealtimeSessionReviewRun[],\n  fallbackAgentName: string\n): RealtimeThreadItem[] {\n  const stamped: Array<{ At: number; Item: RealtimeThreadItem }> = [];\n  for (const turn of turns) {\n    stamped.push({ At: turn.At?.getTime() ?? 0, Item: { Kind: 'caption', Role: turn.Role, Text: turn.Text } });\n  }\n  for (const run of runs) {\n    stamped.push({ At: run.StartedAt?.getTime() ?? 0, Item: { Kind: 'delegation', Card: BuildReviewDelegationCard(run, fallbackAgentName) } });\n  }\n  // Array.prototype.sort is stable — equal timestamps keep their build order.\n  stamped.sort((a, b) => a.At - b.At);\n  return stamped.map(s => s.Item);\n}\n\n/** Derives a short run reference (e.g. \"#a3f1\") from the run id — mirrors the live cards. */\nfunction shortRunRef(runId: string): string {\n  const compact = runId.replace(/[^a-z0-9]/gi, '');\n  return compact.length >= 4 ? `#${compact.slice(-4).toLowerCase()}` : `#${compact.toLowerCase()}`;\n}\n\n/**\n * STATELESS loader for the call overlay's SESSION REVIEW mode: given a past\n * `MJ: AI Agent Sessions` id, batch-loads the session row, its persisted caption turns\n * (`MJ: Conversation Details` linked by `AgentSessionID`), its delegated agent runs\n * (minus the co-agent observability run named in the session Config's `coAgentRunID`),\n * and its saved channel states — and folds them into one {@link RealtimeSessionReview}.\n *\n * CHAIN-AWARE: when the reviewed session carries a `LastSessionID` (it RESUMED an earlier\n * session), the loader walks the chain BACKWARDS — capped at {@link MAX_REVIEW_LEGS} legs\n * and {@link MAX_REVIEW_DETAILS} caption rows total (oldest legs trimmed first), with a\n * cycle guard so a corrupt A→B→A chain can never loop — and surfaces ALL legs\n * chronologically on {@link RealtimeSessionReview.Legs}. Channel state stays the\n * reviewed (latest) leg's only. The chain's conversation-history ARTIFACTS (junction\n * rows on the session-stamped details) are collected onto\n * {@link RealtimeSessionReview.Artifacts}.\n *\n * TOLERANT by design: any missing piece degrades to an empty collection; the loader\n * returns `null` only when the reviewed session row itself can't be found.\n */\n@Injectable({ providedIn: 'root' })\nexport class RealtimeSessionReviewService {\n  /**\n   * Loads everything review mode renders for one past session (and its prior-leg chain).\n   *\n   * @param agentSessionId The `MJ: AI Agent Sessions.ID` to review.\n   * @param provider Optional metadata provider (multi-server apps); falls back to the global default.\n   * @returns The assembled review, or `null` when the session doesn't exist / can't be read.\n   */\n  public async LoadSessionReview(agentSessionId: string, provider?: IMetadataProvider): Promise<RealtimeSessionReview | null> {\n    const trimmed = agentSessionId?.trim() ?? '';\n    if (trimmed.length === 0) {\n      return null;\n    }\n    try {\n      const md = provider ?? Metadata.Provider;\n      const primary = await this.loadLegRows(trimmed, md, true);\n      if (!primary) {\n        return null;\n      }\n      const chain = await this.collectChainLegs(primary, md);\n      const artifacts = await this.loadChainArtifacts(chain, md);\n      return this.assembleReview(chain, artifacts);\n    } catch (error) {\n      console.error('[RealtimeSessionReview] Failed to load session review:', error);\n      return null;\n    }\n  }\n\n  /**\n   * One batched RunViews pass for one chain leg: session row + caption turns + linked\n   * runs (+ channel rows for the PRIMARY leg only — channel state is latest-leg-only).\n   * Returns `null` when the session row can't be found.\n   */\n  private async loadLegRows(\n    agentSessionId: string,\n    provider: IMetadataProvider,\n    includeChannels: boolean\n  ): Promise<LegRows | null> {\n    const safeID = agentSessionId.replace(/'/g, \"''\");\n    const rv = RunView.FromMetadataProvider(provider);\n    const queries: RunViewParams[] = [\n      { EntityName: 'MJ: AI Agent Sessions', ExtraFilter: `ID='${safeID}'`, Fields: SESSION_FIELDS, ResultType: 'simple' as const },\n      {\n        EntityName: 'MJ: Conversation Details', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: DETAIL_FIELDS,\n        OrderBy: '__mj_CreatedAt ASC', MaxRows: MAX_REVIEW_DETAILS, ResultType: 'simple' as const\n      },\n      { EntityName: 'MJ: AI Agent Runs', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: RUN_FIELDS, OrderBy: 'StartedAt ASC', ResultType: 'simple' as const }\n    ];\n    if (includeChannels) {\n      queries.push({ EntityName: 'MJ: AI Agent Session Channels', ExtraFilter: `AgentSessionID='${safeID}'`, Fields: CHANNEL_FIELDS, ResultType: 'simple' as const });\n    }\n    const [sessionResult, detailResult, runResult, channelResult] = await rv.RunViews(queries);\n    const sessions = (sessionResult?.Success ? sessionResult.Results : []) as SessionRow[];\n    const session = sessions[0] ?? null;\n    if (!session) {\n      return null;\n    }\n    return {\n      session,\n      details: (detailResult?.Success ? detailResult.Results : []) as DetailRow[],\n      runs: (runResult?.Success ? runResult.Results : []) as RunRow[],\n      channels: (channelResult?.Success ? channelResult.Results : []) as ChannelRow[]\n    };\n  }\n\n  /**\n   * Walks the `LastSessionID` chain BACKWARDS from the reviewed (primary) leg, collecting\n   * raw leg rows OLDEST-FIRST (primary last). Safety rails:\n   *  - at most {@link MAX_REVIEW_LEGS} legs total;\n   *  - at most {@link MAX_REVIEW_DETAILS} caption rows across the chain — an older leg\n   *    whose details would overflow the budget is trimmed to its NEWEST rows and ends\n   *    the walk;\n   *  - a visited-set cycle guard (case-insensitive ids) so A→B→A can never loop;\n   *  - a leg that fails to load simply ends the walk (the collected legs still render).\n   */\n  private async collectChainLegs(primary: LegRows, provider: IMetadataProvider): Promise<LegRows[]> {\n    const chain: LegRows[] = [primary];\n    const visited = new Set<string>([this.normalizeID(primary.session.ID)]);\n    let cursor = primary.session.LastSessionID ?? null;\n    let detailBudget = MAX_REVIEW_DETAILS - primary.details.length;\n\n    while (cursor && chain.length < MAX_REVIEW_LEGS && detailBudget > 0) {\n      const key = this.normalizeID(cursor);\n      if (visited.has(key)) {\n        console.warn(`[RealtimeSessionReview] Session chain cycle detected at ${cursor} — stopping the walk.`);\n        break;\n      }\n      visited.add(key);\n      const leg = await this.loadLegRows(cursor, provider, false);\n      if (!leg) {\n        break;\n      }\n      if (leg.details.length > detailBudget) {\n        // Keep this leg's NEWEST rows (details arrive oldest-first) and end the walk.\n        leg.details = leg.details.slice(leg.details.length - detailBudget);\n        detailBudget = 0;\n      } else {\n        detailBudget -= leg.details.length;\n      }\n      chain.unshift(leg);\n      cursor = leg.session.LastSessionID ?? null;\n    }\n    return chain;\n  }\n\n  /**\n   * Collects the chain's conversation-history ARTIFACTS: `MJ: Conversation Detail\n   * Artifacts` junction rows (Direction `Output`) hanging off the chain's session-stamped\n   * details, resolved through `MJ: Artifact Versions` to `{ArtifactID, ArtifactVersionID,\n   * Name}` (version name, falling back to the artifact name). Order follows junction\n   * creation; duplicate versions are deduped. TOLERANT: any failure returns `[]`.\n   */\n  private async loadChainArtifacts(chain: LegRows[], provider: IMetadataProvider): Promise<ParsedDelegationArtifact[]> {\n    const detailIDs = chain.flatMap(leg => leg.details.map(d => d.ID)).filter(id => typeof id === 'string' && id.length > 0);\n    if (detailIDs.length === 0) {\n      return [];\n    }\n    try {\n      const rv = RunView.FromMetadataProvider(provider);\n      const detailList = detailIDs.map(id => `'${id.replace(/'/g, \"''\")}'`).join(',');\n      const [junctionResult] = await rv.RunViews([{\n        EntityName: 'MJ: Conversation Detail Artifacts',\n        ExtraFilter: `ConversationDetailID IN (${detailList}) AND Direction='Output'`,\n        Fields: JUNCTION_FIELDS,\n        OrderBy: '__mj_CreatedAt ASC',\n        ResultType: 'simple'\n      }]);\n      const junctions = (junctionResult?.Success ? junctionResult.Results : []) as DetailArtifactJunctionRow[];\n      const versionIDs = this.uniqueVersionIDs(junctions);\n      if (versionIDs.length === 0) {\n        return [];\n      }\n\n      const versionList = versionIDs.map(id => `'${id.replace(/'/g, \"''\")}'`).join(',');\n      const [versionResult] = await rv.RunViews([{\n        EntityName: 'MJ: Artifact Versions',\n        ExtraFilter: `ID IN (${versionList})`,\n        Fields: VERSION_FIELDS,\n        ResultType: 'simple'\n      }]);\n      const versions = (versionResult?.Success ? versionResult.Results : []) as ArtifactVersionRow[];\n      const byID = new Map<string, ArtifactVersionRow>(versions.map(v => [this.normalizeID(v.ID), v]));\n\n      const artifacts: ParsedDelegationArtifact[] = [];\n      for (const versionID of versionIDs) {\n        const row = byID.get(this.normalizeID(versionID));\n        if (!row?.ArtifactID) {\n          continue; // junction points at an unreadable / deleted version — skip\n        }\n        artifacts.push({\n          ArtifactID: row.ArtifactID,\n          ArtifactVersionID: row.ID,\n          Name: row.Name?.trim() || row.Artifact?.trim() || 'Artifact'\n        });\n      }\n      return artifacts;\n    } catch (error) {\n      console.warn('[RealtimeSessionReview] Artifact collection failed — review renders without artifact tabs.', error);\n      return [];\n    }\n  }\n\n  /** Unique, non-empty `ArtifactVersionID`s from junction rows, in arrival order (case-insensitive dedupe). */\n  private uniqueVersionIDs(junctions: DetailArtifactJunctionRow[]): string[] {\n    const seen = new Set<string>();\n    const ids: string[] = [];\n    for (const j of junctions) {\n      const id = typeof j.ArtifactVersionID === 'string' ? j.ArtifactVersionID.trim() : '';\n      if (id.length === 0 || seen.has(this.normalizeID(id))) {\n        continue;\n      }\n      seen.add(this.normalizeID(id));\n      ids.push(id);\n    }\n    return ids;\n  }\n\n  /** Case-insensitive UUID key for Set/Map membership (SQL Server uppercase vs PostgreSQL lowercase). */\n  private normalizeID(id: string): string {\n    return (id ?? '').trim().toLowerCase();\n  }\n\n  /**\n   * Folds the chain's raw leg rows into the typed review. The PRIMARY (reviewed) leg —\n   * the chain's LAST entry — supplies identity/lifecycle/channel state; turns and runs\n   * are surfaced both per-leg (`Legs`) and flattened chronologically (`Turns` /\n   * `DelegatedRuns`). Each leg excludes ITS OWN config's co-agent observability run.\n   */\n  private assembleReview(chain: LegRows[], artifacts: ParsedDelegationArtifact[]): RealtimeSessionReview {\n    const primary = chain[chain.length - 1];\n    const session = primary.session;\n    const config = this.parseSessionConfig(session.Config);\n    const legs = chain.map(leg => this.mapLeg(leg));\n    return {\n      SessionID: session.ID,\n      AgentID: session.AgentID,\n      AgentName: session.Agent || 'the agent',\n      TargetAgentID: config.targetAgentID ?? session.AgentID,\n      ConversationID: session.ConversationID ?? null,\n      Status: session.Status,\n      CloseReason: session.CloseReason ?? null,\n      StartedAt: this.toDate(session.__mj_CreatedAt),\n      LastActiveAt: this.toDate(session.LastActiveAt),\n      ClosedAt: this.toDate(session.ClosedAt),\n      RecordingFileID: session.RecordingFileID ?? null,\n      RecordingStartedAt: this.toDate(session.RecordingStartedAt),\n      RecordingMedia: session.RecordingMedia ?? null,\n      Turns: legs.flatMap(l => l.Turns),\n      DelegatedRuns: legs.flatMap(l => l.DelegatedRuns),\n      // Multi-leg: newest leg with a SAVED state wins per channel — a final leg that\n      // never touched the board no longer hides an earlier leg's drawing from review.\n      ChannelStates: MergeChainChannelStates(chain.map(leg => this.mapChannels(leg.channels))),\n      Legs: legs,\n      Artifacts: artifacts\n    };\n  }\n\n  /** Maps one leg's raw rows to the public leg shape (per-leg co-agent-run exclusion). */\n  private mapLeg(leg: LegRows): RealtimeSessionReviewLeg {\n    const config = this.parseSessionConfig(leg.session.Config);\n    return {\n      SessionID: leg.session.ID,\n      StartedAt: this.toDate(leg.session.__mj_CreatedAt),\n      ClosedAt: this.toDate(leg.session.ClosedAt),\n      CloseReason: leg.session.CloseReason ?? null,\n      Turns: this.mapTurns(leg.details),\n      DelegatedRuns: this.mapRuns(leg.runs, config.coAgentRunID ?? null)\n    };\n  }\n\n  /** Persisted detail rows → caption turns: visible `User`/`AI` rows with text (AI → Assistant). */\n  private mapTurns(details: DetailRow[]): RealtimeSessionReviewTurn[] {\n    const turns: RealtimeSessionReviewTurn[] = [];\n    for (const row of details) {\n      const text = row.Message?.trim() ?? '';\n      if (row.HiddenToUser || text.length === 0 || (row.Role !== 'User' && row.Role !== 'AI')) {\n        continue;\n      }\n      const createdAt = this.toDate(row.__mj_CreatedAt);\n      turns.push({\n        ID: row.ID,\n        Role: row.Role === 'AI' ? 'Assistant' : 'User',\n        Text: text,\n        Message: text,\n        __mj_CreatedAt: createdAt,\n        At: createdAt,\n        UtteranceStartMs: row.UtteranceStartMs ?? null,\n        UtteranceEndMs: row.UtteranceEndMs ?? null\n      });\n    }\n    return turns;\n  }\n\n  /** Linked run rows → delegated-run previews, EXCLUDING the co-agent's observability run. */\n  private mapRuns(runs: RunRow[], coAgentRunId: string | null): RealtimeSessionReviewRun[] {\n    return runs\n      .filter(r => !coAgentRunId || !UUIDsEqual(r.ID, coAgentRunId))\n      .map(r => ({\n        RunID: r.ID,\n        AgentID: r.AgentID,\n        AgentName: r.Agent ?? null,\n        Status: r.Status ?? '',\n        Success: r.Success === true,\n        Message: r.Message ?? null,\n        ErrorMessage: r.ErrorMessage ?? null,\n        FinalStep: r.FinalStep ?? null,\n        StartedAt: this.toDate(r.StartedAt),\n        CompletedAt: this.toDate(r.CompletedAt)\n      }));\n  }\n\n  /** Session-channel rows → named channel states (rows without a channel name are skipped). */\n  private mapChannels(channels: ChannelRow[]): RealtimeSessionReviewChannelState[] {\n    return channels\n      .filter(c => !!c.Channel)\n      .map(c => ({ ChannelName: c.Channel as string, StateJson: c.Config ?? null }));\n  }\n\n  /** Tolerant Config JSON parse — malformed/missing payloads degrade to `{}`. */\n  private parseSessionConfig(raw: string | null): SessionConfigJson {\n    if (!raw) {\n      return {};\n    }\n    try {\n      const parsed = JSON.parse(raw) as SessionConfigJson;\n      return parsed && typeof parsed === 'object' ? parsed : {};\n    } catch {\n      return {};\n    }\n  }\n\n  /** Tolerant date conversion — view rows arrive as ISO strings (or Dates from some providers). */\n  private toDate(value: string | Date | null | undefined): Date | null {\n    if (value == null) {\n      return null;\n    }\n    const date = value instanceof Date ? value : new Date(value);\n    return isNaN(date.getTime()) ? null : date;\n  }\n}\n"]}