@memberjunction/ai-agents 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/realtime/realtime-delegation-narrator.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview `DelegationNarrator` — spoken progress updates while a delegated agent run is in flight, for
+ * every SERVER-held realtime session (the generic session runner, and a bridged phone call).
+ *
+ * While the co-agent hands work to a target agent the caller would otherwise sit in silence. The narrator
+ * receives the delegated run's progress events and:
+ *
+ * - always injects each significant one as a background context note (so the model can draw on it), and
+ * - schedules a THROTTLED spoken update — first ~5 s into a burst, then no more often than every ~8 s, with
+ *   floods aggregated into one digest — built with {@link BuildServerNarrationInstructions}.
+ *
+ * It was extracted from `RealtimeSessionRunner` so a bridged call (which never constructs a runner) speaks
+ * progress identically instead of re-implementing the pacing.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import type { IRealtimeSession } from '@memberjunction/ai';
+import type { DelegatedResult, DelegateToTargetRequest } from './realtime-tool-broker.js';
+/** The collaborators a {@link DelegationNarrator} needs. */
+export interface DelegationNarratorDeps {
+    /** The live session to speak on, or `null` when there is none (a stale event is then dropped). */
+    GetSession: () => IRealtimeSession | null;
+    /** The DB-driven narration instruction template, or `null`/absent for the built-in wording. */
+    NarrationInstructionsTemplate?: string | null;
+    /** Minimum gap (ms) between spoken updates (`realtime.narration.paceMs`); absent/invalid uses the default. */
+    NarrationPaceMs?: number | null;
+}
+/** Narration state and pacing for one realtime session. One instance per session. */
+export declare class DelegationNarrator {
+    private readonly deps;
+    /** First spoken update fires no earlier than this long after a delegation burst starts. */
+    private static readonly firstNarrationDelayMs;
+    /** Minimum gap between SUBSEQUENT spoken updates (floods aggregate into one digest). */
+    private static readonly defaultIntervalMs;
+    /** Max progress messages aggregated into one spoken digest. */
+    private static readonly maxDigestMessages;
+    /**
+     * Progress steps worth narrating — mirrors the client-direct resolver's filter so both topologies narrate the
+     * same signal and drop the same initialization/finalization noise.
+     */
+    private static readonly significantProgressSteps;
+    /** Count of delegations currently in flight (anchors the burst lifecycle). */
+    private activeDelegations;
+    /** Epoch ms when the current burst began (first in-flight delegation); 0 = no active burst. */
+    private burstStartedAt;
+    /** Epoch ms of the last spoken update; 0 = never. SESSION-global spacing floor. */
+    private lastNarrationAt;
+    /** Spoken updates so far in the current burst (1-based numbering for the instructions). */
+    private narrationCount;
+    /** Aggregation buffer: distinct progress messages since the last spoken update (oldest first). */
+    private pendingMessages;
+    /** Tail message of the last digest, so an identical trailing progress event is not re-buffered. */
+    private lastNarratedTail;
+    /** Pending deferred-narration timer; cancelled when the delegation finishes or the user barges in. */
+    private timer;
+    constructor(deps: DelegationNarratorDeps);
+    /**
+     * Runs one delegated call through `delegate` while owning the narration burst around it: progress events are
+     * threaded back through {@link DelegateToTargetRequest.OnProgress}, and when the delegation finishes (success,
+     * failure or abort) any still-pending spoken update is cancelled — the final result is about to be voiced.
+     */
+    Run(request: DelegateToTargetRequest, delegate: (request: DelegateToTargetRequest) => Promise<DelegatedResult>): Promise<DelegatedResult>;
+    /**
+     * Owns the narration burst around any delegated work: anchors a burst when `work` starts and cancels pending
+     * narration when it settles. Use this directly when the caller threads {@link HandleProgress} through as the
+     * delegated run's own progress callback (the bridged-call path), rather than through {@link Run}.
+     */
+    Track<T>(work: () => Promise<T>): Promise<T>;
+    /** Cancels any deferred spoken update, drops the digest buffer and resets the burst-timing state. */
+    Cancel(): void;
+    /**
+     * Consumes one delegated-run progress event: significant steps only; always a context note; and a throttled
+     * spoken update when the provider can voice one.
+     */
+    HandleProgress(progress: {
+        step: string;
+        message: string;
+    }): void;
+    /**
+     * Anchors a fresh burst when nothing else is in flight OR the burst state was reset (by {@link Cancel}) — the
+     * second condition keeps timing correct when a prior delegation failed to honour its abort and left the
+     * counter elevated. {@link lastNarrationAt} is deliberately NOT reset across bursts.
+     */
+    private beginDelegation;
+    /** Closes one delegation; when none remain in flight, pending narration is cancelled. */
+    private endDelegation;
+    /** Adds a progress message to the digest buffer (deduped, capped, oldest-first). */
+    private bufferMessage;
+    /** ms until the next spoken update is allowed: >= ~5 s after the burst began AND >= the interval since the last. */
+    private nextDelayMs;
+    /** The configured pace when it is a positive finite number, else the built-in default. */
+    private intervalMs;
+    /** Speaks the aggregated digest — unless the work already finished or the session is gone. */
+    private fireDeferredNarration;
+}
+//# sourceMappingURL=realtime-delegation-narrator.d.ts.map

package/dist/realtime/realtime-delegation-narrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-delegation-narrator.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-delegation-narrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGvF,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACnC,kGAAkG;IAClG,UAAU,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAC1C,+FAA+F;IAC/F,6BAA6B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,8GAA8G;IAC9G,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,qFAAqF;AACrF,qBAAa,kBAAkB;IA4Bf,OAAO,CAAC,QAAQ,CAAC,IAAI;IA3BjC,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IACrD,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IACjD,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAK;IAC9C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAyF;IAEzI,8EAA8E;IAC9E,OAAO,CAAC,iBAAiB,CAAK;IAC9B,+FAA+F;IAC/F,OAAO,CAAC,cAAc,CAAK;IAC3B,mFAAmF;IACnF,OAAO,CAAC,eAAe,CAAK;IAC5B,2FAA2F;IAC3F,OAAO,CAAC,cAAc,CAAK;IAC3B,kGAAkG;IAClG,OAAO,CAAC,eAAe,CAAgB;IACvC,mGAAmG;IACnG,OAAO,CAAC,gBAAgB,CAAM;IAC9B,sGAAsG;IACtG,OAAO,CAAC,KAAK,CAA8C;gBAE9B,IAAI,EAAE,sBAAsB;IAEzD;;;;OAIG;IACU,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAItJ;;;;OAIG;IACU,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASzD,qGAAqG;IAC9F,MAAM,IAAI,IAAI;IAWrB;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkBxE;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAUvB,yFAAyF;IACzF,OAAO,CAAC,aAAa;IAOrB,oFAAoF;IACpF,OAAO,CAAC,aAAa;IAUrB,oHAAoH;IACpH,OAAO,CAAC,WAAW;IAOnB,0FAA0F;IAC1F,OAAO,CAAC,UAAU;IAKlB,8FAA8F;IAC9F,OAAO,CAAC,qBAAqB;CAchC"}

package/dist/realtime/realtime-delegation-narrator.js

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview `DelegationNarrator` — spoken progress updates while a delegated agent run is in flight, for
+ * every SERVER-held realtime session (the generic session runner, and a bridged phone call).
+ *
+ * While the co-agent hands work to a target agent the caller would otherwise sit in silence. The narrator
+ * receives the delegated run's progress events and:
+ *
+ * - always injects each significant one as a background context note (so the model can draw on it), and
+ * - schedules a THROTTLED spoken update — first ~5 s into a burst, then no more often than every ~8 s, with
+ *   floods aggregated into one digest — built with {@link BuildServerNarrationInstructions}.
+ *
+ * It was extracted from `RealtimeSessionRunner` so a bridged call (which never constructs a runner) speaks
+ * progress identically instead of re-implementing the pacing.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { BuildServerNarrationInstructions } from './realtime-narration.js';
+/** Narration state and pacing for one realtime session. One instance per session. */
+export class DelegationNarrator {
+    /** First spoken update fires no earlier than this long after a delegation burst starts. */
+    static { this.firstNarrationDelayMs = 5000; }
+    /** Minimum gap between SUBSEQUENT spoken updates (floods aggregate into one digest). */
+    static { this.defaultIntervalMs = 8000; }
+    /** Max progress messages aggregated into one spoken digest. */
+    static { this.maxDigestMessages = 4; }
+    /**
+     * Progress steps worth narrating — mirrors the client-direct resolver's filter so both topologies narrate the
+     * same signal and drop the same initialization/finalization noise.
+     */
+    static { this.significantProgressSteps = ['prompt_execution', 'action_execution', 'subagent_execution', 'decision_processing']; }
+    constructor(deps) {
+        this.deps = deps;
+        /** Count of delegations currently in flight (anchors the burst lifecycle). */
+        this.activeDelegations = 0;
+        /** Epoch ms when the current burst began (first in-flight delegation); 0 = no active burst. */
+        this.burstStartedAt = 0;
+        /** Epoch ms of the last spoken update; 0 = never. SESSION-global spacing floor. */
+        this.lastNarrationAt = 0;
+        /** Spoken updates so far in the current burst (1-based numbering for the instructions). */
+        this.narrationCount = 0;
+        /** Aggregation buffer: distinct progress messages since the last spoken update (oldest first). */
+        this.pendingMessages = [];
+        /** Tail message of the last digest, so an identical trailing progress event is not re-buffered. */
+        this.lastNarratedTail = '';
+        /** Pending deferred-narration timer; cancelled when the delegation finishes or the user barges in. */
+        this.timer = null;
+    }
+    /**
+     * Runs one delegated call through `delegate` while owning the narration burst around it: progress events are
+     * threaded back through {@link DelegateToTargetRequest.OnProgress}, and when the delegation finishes (success,
+     * failure or abort) any still-pending spoken update is cancelled — the final result is about to be voiced.
+     */
+    async Run(request, delegate) {
+        return this.Track(() => delegate({ ...request, OnProgress: (progress) => this.HandleProgress(progress) }));
+    }
+    /**
+     * Owns the narration burst around any delegated work: anchors a burst when `work` starts and cancels pending
+     * narration when it settles. Use this directly when the caller threads {@link HandleProgress} through as the
+     * delegated run's own progress callback (the bridged-call path), rather than through {@link Run}.
+     */
+    async Track(work) {
+        this.beginDelegation();
+        try {
+            return await work();
+        }
+        finally {
+            this.endDelegation();
+        }
+    }
+    /** Cancels any deferred spoken update, drops the digest buffer and resets the burst-timing state. */
+    Cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pendingMessages = [];
+        this.burstStartedAt = 0;
+        this.narrationCount = 0;
+        this.lastNarratedTail = '';
+    }
+    /**
+     * Consumes one delegated-run progress event: significant steps only; always a context note; and a throttled
+     * spoken update when the provider can voice one.
+     */
+    HandleProgress(progress) {
+        if (!DelegationNarrator.significantProgressSteps.includes(progress.step)) {
+            return;
+        }
+        const session = this.deps.GetSession();
+        if (!session || this.activeDelegations === 0) {
+            return; // session gone / delegation already finished — stale event
+        }
+        session.SendContextNote?.(`[delegated-agent progress] ${progress.message}`);
+        if (!session.RequestSpokenUpdate) {
+            return; // provider can't voice an instructed one-off update — context note only
+        }
+        this.bufferMessage(progress.message);
+        if (this.pendingMessages.length > 0 && !this.timer) {
+            this.timer = setTimeout(() => this.fireDeferredNarration(), this.nextDelayMs());
+        }
+    }
+    /**
+     * Anchors a fresh burst when nothing else is in flight OR the burst state was reset (by {@link Cancel}) — the
+     * second condition keeps timing correct when a prior delegation failed to honour its abort and left the
+     * counter elevated. {@link lastNarrationAt} is deliberately NOT reset across bursts.
+     */
+    beginDelegation() {
+        if (this.activeDelegations === 0 || this.burstStartedAt === 0) {
+            this.burstStartedAt = Date.now();
+            this.narrationCount = 0;
+            this.pendingMessages = [];
+            this.lastNarratedTail = '';
+        }
+        this.activeDelegations++;
+    }
+    /** Closes one delegation; when none remain in flight, pending narration is cancelled. */
+    endDelegation() {
+        this.activeDelegations = Math.max(0, this.activeDelegations - 1);
+        if (this.activeDelegations === 0) {
+            this.Cancel();
+        }
+    }
+    /** Adds a progress message to the digest buffer (deduped, capped, oldest-first). */
+    bufferMessage(message) {
+        if (message === this.lastNarratedTail || this.pendingMessages.includes(message)) {
+            return;
+        }
+        this.pendingMessages.push(message);
+        if (this.pendingMessages.length > DelegationNarrator.maxDigestMessages) {
+            this.pendingMessages.shift();
+        }
+    }
+    /** ms until the next spoken update is allowed: >= ~5 s after the burst began AND >= the interval since the last. */
+    nextDelayMs() {
+        const now = Date.now();
+        const firstAnchor = this.narrationCount === 0 ? this.burstStartedAt + DelegationNarrator.firstNarrationDelayMs : 0;
+        const spacingFloor = this.lastNarrationAt > 0 ? this.lastNarrationAt + this.intervalMs() : 0;
+        return Math.max(50, Math.max(firstAnchor, spacingFloor) - now);
+    }
+    /** The configured pace when it is a positive finite number, else the built-in default. */
+    intervalMs() {
+        const pace = this.deps.NarrationPaceMs;
+        return typeof pace === 'number' && Number.isFinite(pace) && pace > 0 ? pace : DelegationNarrator.defaultIntervalMs;
+    }
+    /** Speaks the aggregated digest — unless the work already finished or the session is gone. */
+    fireDeferredNarration() {
+        this.timer = null;
+        const session = this.deps.GetSession();
+        if (!session?.RequestSpokenUpdate || this.pendingMessages.length === 0 || this.activeDelegations === 0) {
+            this.pendingMessages = [];
+            return;
+        }
+        const digest = this.pendingMessages.join(' → ');
+        this.lastNarratedTail = this.pendingMessages[this.pendingMessages.length - 1];
+        this.pendingMessages = [];
+        this.narrationCount++;
+        this.lastNarrationAt = Date.now();
+        session.RequestSpokenUpdate(BuildServerNarrationInstructions(this.deps.NarrationInstructionsTemplate, digest, this.narrationCount));
+    }
+}
+//# sourceMappingURL=realtime-delegation-narrator.js.map

package/dist/realtime/realtime-delegation-narrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-delegation-narrator.js","sourceRoot":"","sources":["../../src/realtime/realtime-delegation-narrator.ts"],"names":[],"mappings":"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"}

package/dist/realtime/realtime-recording-store.d.ts

@@ -1,12 +1,3 @@
-/**
- * @fileoverview Shared MJStorage finalize for realtime session recordings — the single code path both
- * the **server-bridged** capture (`BaseAgent.finalizeRealtimeRecording`) and the **client-direct**
- * browser upload (`RealtimeClientSessionResolver.UploadRealtimeRecording`) use to: resolve the agent's
- * recording storage account, upload the audio, link it to the `AIAgentSession`, and stamp the session's
- * recording fields. Keeps the storage policy in one place rather than duplicated per topology.
- *
- * @module @memberjunction/ai-agents
- */
 import { IMetadataProvider, UserInfo } from '@memberjunction/core';
 import { MJAIAgentEntity } from '@memberjunction/core-entities';
 import { RealtimeRecordingMedia } from './realtime-recording-capture.js';
@@ -44,6 +35,20 @@ export interface StoreRealtimeRecordingInput {
      * waveform without re-decoding the audio. Best-effort — a sidecar failure never fails the recording.
      */
     Peaks?: number[];
+    /** Name of the uploaded file. Defaults to `recording.<ext>`. */
+    FileName?: string;
+    /** Description stored on the `MJ: Files` row (e.g. how a recovered recording was assembled). */
+    Description?: string;
+    /**
+     * When true, the order becomes re-check -> stamp -> link: the session is re-read immediately before
+     * the stamp and, if it already has a `RecordingFileID`, that recording is left alone (nothing is
+     * linked or stamped; the result is `Superseded`). The link is written only after the stamp saved, so
+     * a superseded or failed store never leaves a link row. Best effort, not a guarantee: without a
+     * compare-and-set, a recording stamped inside the one load -> save window is still overwritten.
+     * Recovery sets this. Left false (the default) for the end-of-call upload, which links and then
+     * stamps unconditionally.
+     */
+    PreserveExistingRecording?: boolean;
 }
 /**
  * Reads a stored recording's bytes back through **authenticated** MJStorage (server-side `GetObject` on
@@ -73,12 +78,13 @@ export interface WriteRecordingSegmentInput {
     ContextUser: UserInfo;
 }
 /**
- * Writes ONE crash-recovery segment shard (`seg-NNNN.<ext>`) into the session's folder as a RAW
+ * Writes ONE crash-recovery segment shard (`seg-NNNN[.r<rate>].<ext>`) into the session's folder as a RAW
  * storage object — no `MJ: Files` row, no session stamping. Shards are durability insurance during a
  * live call (so a browser/tab death loses at most the last window); they are byte-slices of one
  * continuous stream (only the first carries the container header), so they are NOT individually
- * playable — recovery is "concatenate the folder's shards in order". They are deleted once the
- * canonical consolidated file lands ({@link deleteRealtimeRecordingSegments}). Never throws.
+ * playable — recovery (see {@link RecoverRealtimeRecordingFromSegments}) concatenates them in index order,
+ * filling absent indexes with silence. They are deleted once the canonical consolidated file lands
+ * ({@link DeleteRealtimeRecordingSegments}), or by the recovery path once it has stamped its own file. Never throws.
  *
  * @returns `true` on success.
  */
@@ -97,8 +103,10 @@ export declare function WriteRecordingPeaksSidecar(sessionID: string, storageAcc
 /** @deprecated Use {@link WriteRecordingPeaksSidecar}. */
 export declare function writeRecordingPeaksSidecar(sessionID: string, storageAccountID: string, peaks: number[] | undefined, contextUser: UserInfo): Promise<boolean>;
 /**
- * Deletes the `seg-*` shards in a session's folder, leaving the consolidated `recording.*` file. Called
- * after {@link storeRealtimeRecording} writes the canonical file at end of call. Never throws.
+ * Deletes every `seg-*` shard in a session's folder, leaving the consolidated `recording.*` file. Called
+ * after {@link StoreRealtimeRecording} writes the canonical file at end of call. The recovery path
+ * ({@link RecoverRealtimeRecordingFromSegments}) does not use this: it deletes only the shards it listed
+ * and assembled, so a shard written after its listing is not lost. Never throws.
  *
  * @returns The number of shards deleted.
  */
@@ -107,10 +115,20 @@ export declare function DeleteRealtimeRecordingSegments(sessionID: string, stora
 export declare function deleteRealtimeRecordingSegments(sessionID: string, storageAccountID: string, contextUser: UserInfo): Promise<number>;
 /** Outcome of {@link storeRealtimeRecording}. */
 export interface StoreRealtimeRecordingResult {
-    /** The `MJ: Files` id when the recording was stored; null on every failure. */
+    /**
+     * The uploaded `MJ: Files` id; null when the upload itself failed. With `PreserveExistingRecording`
+     * it is also set alongside an `ErrorMessage` when the file was uploaded but the session could not be
+     * re-read or stamped: that file is an orphan, neither linked nor stamped.
+     */
     readonly FileID: string | null;
-    /** Why it failed, verbatim from the layer that knew. Null on success. */
+    /** Why it failed, verbatim from the layer that knew. Null on success and on `Superseded`. */
     readonly ErrorMessage: string | null;
+    /**
+     * True only when `PreserveExistingRecording` was set and the re-check right before the stamp found
+     * the session already had a recording: the file was uploaded but deliberately not linked or stamped,
+     * so it is an orphan. False on every other path.
+     */
+    readonly Superseded: boolean;
 }
 /**
  * Uploads a session recording to MJStorage, links it to the `AIAgentSession` (via
@@ -125,4 +143,106 @@ export interface StoreRealtimeRecordingResult {
 export declare function StoreRealtimeRecording(input: StoreRealtimeRecordingInput): Promise<StoreRealtimeRecordingResult>;
 /** @deprecated Use {@link StoreRealtimeRecording}. */
 export declare function storeRealtimeRecording(input: StoreRealtimeRecordingInput): Promise<StoreRealtimeRecordingResult>;
+/** One recovered shard: its zero-based position in the recording and its raw mono PCM16-LE bytes. */
+export interface RecordingSegmentBytes {
+    readonly Index: number;
+    readonly Bytes: Buffer;
+}
+/** A WAV assembled from shards, plus what had to be invented to keep it aligned. */
+export interface AssembledRecording {
+    /** Canonical 44-byte-header mono 16-bit PCM WAV. */
+    readonly Wav: Buffer;
+    /** Shard indexes (ascending) that were absent and filled with silence. */
+    readonly MissingIndexes: number[];
+    /** Byte length used for each silent gap; reported even when nothing was missing. */
+    readonly GapBytes: number;
+}
+/**
+ * Assembles recovered recording shards into one WAV, in index order, filling every absent index with
+ * silence. Silence (rather than skipping the gap) keeps all later audio at its true time offset, so it
+ * stays aligned with transcript cues, which are offsets from the session's `RecordingStartedAt`.
+ *
+ * The gap length is the median length of the present shards excluding the highest present index (that
+ * one is normally a partial window); with a single shard, that shard's length. It is rounded down to
+ * an even byte count (whole 16-bit samples), minimum 2.
+ *
+ * The byte ceiling does not bound the index range on its own: under the default ceiling a single shard
+ * at index ~10^9 still fits, and the missing-index list grows with the highest index. Callers handling
+ * untrusted shards must cap the shard count and highest index themselves (recovery does, via
+ * {@link MAX_RECOVERY_SEGMENTS}) and pass a smaller `maxDataBytes`.
+ *
+ * @param segments Recovered shards; any order, unique non-negative integer indexes starting from 0.
+ * @param sampleRate Sample rate of the PCM data, in Hz.
+ * @param maxDataBytes Ceiling on the PCM data size (shards plus gap fill), checked before anything is
+ *   allocated. Defaults to the WAV format's own limit; callers handling untrusted shards pass less.
+ * @throws Error on no segments, an invalid sample rate or index, a duplicate index, an empty or
+ *   odd-length shard, or a result too large for a WAV.
+ */
+export declare function BuildRecordingFromSegments(segments: RecordingSegmentBytes[], sampleRate: number, maxDataBytes?: number): AssembledRecording;
+/**
+ * Most shards recovery will assemble. At ~15 s per shard this is an hour of audio, far past any real
+ * call; a listing at or beyond it (by count or by highest index) is treated as corrupt or hostile and
+ * fails closed rather than allocating a huge WAV.
+ */
+export declare const MAX_RECOVERY_SEGMENTS = 240;
+/**
+ * Ceiling on the PCM data a recovery will assemble: 384 MiB covers an hour of 48 kHz mono PCM16
+ * (345.6 MB) with headroom. Shard sizes are client-controlled (the GraphQL body limit is 50 MB, so one
+ * shard can be ~37 MB) and gaps are filled with silence, so without this a session owner could make the
+ * janitor allocate gigabytes. Checked against listed sizes, running actual bytes, and the assembled size.
+ *
+ * It caps the data, not the process's memory: the shard buffers are still held while the WAV is
+ * assembled (2x), and storage drivers can copy on read (the S3 driver copies each shard once more), so
+ * peak memory for one recovery is up to about three times this: two 288 MB recoveries raised the API
+ * process's RSS by 730 MB and 920 MB.
+ */
+export declare const MAX_RECOVERY_BYTES: number;
+/** Input to {@link RecoverRealtimeRecordingFromSegments}. */
+export interface RecoverRealtimeRecordingInput {
+    SessionID: string;
+    /** Storage account the shards were written to. */
+    StorageAccountID: string;
+    /** The recording `t0`, stamped on the session (recovery cannot derive it from the shards). */
+    StartedAt: Date;
+    ContextUser: UserInfo;
+    Provider: IMetadataProvider;
+}
+/** What {@link RecoverRealtimeRecordingFromSegments} did. */
+export type RecoverRealtimeRecordingOutcome = 'Recovered' | 'NoSegments' | 'Superseded' | 'Failed';
+/** Result of {@link RecoverRealtimeRecordingFromSegments}. */
+export interface RecoverRealtimeRecordingResult {
+    readonly Outcome: RecoverRealtimeRecordingOutcome;
+    /** The recovered `MJ: Files` id; set for `Recovered`, and for `Superseded` when an orphan was uploaded. */
+    readonly FileID: string | null;
+    /** Number of shards found in the session folder. */
+    readonly SegmentCount: number;
+    /** Shard indexes that were absent and filled with estimated silence. */
+    readonly MissingIndexes: number[];
+    /** Why recovery failed; null otherwise. */
+    readonly ErrorMessage: string | null;
+}
+/**
+ * Rebuilds a session's recording from the `seg-*` crash-recovery shards left in its storage folder —
+ * for a call whose browser died or whose end-of-call upload never ran, so no `recording.*` exists.
+ * Shards are concatenated in order (silence for absent ones), uploaded under a per-attempt
+ * `recording-recovered-<epoch ms>-<random hex>.wav`, stamped on the session, linked, and only then
+ * deleted. Deletion happens only after a reload confirms the session points at the recovered file, so a
+ * failure at any step leaves the shards for the next try. If the session has (or gains) another
+ * recording, the outcome is `Superseded` and the shards are kept. Deferring to that recording is best
+ * effort: the session is re-checked immediately before the stamp, but a recording stamped inside that
+ * one load -> save window is overwritten (there is no compare-and-set).
+ *
+ * The sample rate comes from the shard keys (`seg-NNNN.r<rate>.pcm`) or, for legacy `seg-NNNN.pcm`
+ * shards, from each object's stored content type. When no shard declares a rate (a legacy shard on a
+ * driver that keeps no content type, such as Box), it is inferred from the size of the full shards; see
+ * {@link LEGACY_SHARD_SECONDS}.
+ *
+ * Once the stamp has saved, the outcome is `Recovered` even if the confirming reload or a shard delete
+ * fails; the shards it could not remove are named in a `LogError` (nothing revisits a stamped session).
+ *
+ * Never throws: every failure is logged with the session id and returned as `Failed`.
+ *
+ * @param input Session, storage account, recording `t0`, and server context.
+ */
+export declare function RecoverRealtimeRecordingFromSegments(input: RecoverRealtimeRecordingInput): Promise<RecoverRealtimeRecordingResult>;
 //# sourceMappingURL=realtime-recording-store.d.ts.map

package/dist/realtime/realtime-recording-store.d.ts.map

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