@burdenoff/fe-libs 2026.1013.10 → 2026.1013.11

package/dist/shared/assistant/speech/types.d.ts

@@ -47,8 +47,20 @@ export interface SpeechSpeakOptions {
  * still ends with `onEnd`. Switching it off never goes through the engine's
  * `cancel()`, which silences the reply, nor through `retract()`.
  *
+ * ★★ Refusing is neither leaving nor failing (operator decision D7 b). When the
+ * output cannot show that what it played BEFORE this reply has stopped (its
+ * drain bound ran out while that audio may still be heard), it must not start
+ * this reply anywhere: it writes nothing, unmutes nothing, and rejects the
+ * pending `write` or `drain` (or the next one, if none is pending) and every
+ * later one with a `SpeechOutputRefusal`. The engine then silences it, plays
+ * NOTHING on the speakers, and ends the reply with
+ * `onError('output-not-cleared')`, which no fallback re-speaks. A `drain()`
+ * with nothing written yet is no exception: the engine drains before it
+ * reports a failure of its own, and a drain that resolves lets the device
+ * voice speak the reply.
+ *
  * One object serves exactly one reply: attach a fresh one to each, so neither
- * a leave nor the hard stop carries over to the next reply.
+ * a leave, a refusal nor the hard stop carries over to the next reply.
  */
 export interface SpeechAudioOutput {
     /**
@@ -88,15 +100,34 @@ export interface SpeechAudioOutput {
 }
 /**
  * The `reason` a `SpeechAudioOutput` rejects with once it has LEFT the reply
- * (switched off while the reply goes on). Any other rejection is a failure.
+ * (switched off while the reply goes on). Any other rejection is a failure,
+ * except a refusal (`SPEECH_OUTPUT_REFUSE_AUDIBLE`).
  */
 export declare const SPEECH_OUTPUT_LEFT = "left";
+/**
+ * The `reason` a `SpeechAudioOutput` rejects with to REFUSE the reply
+ * (operator decision D7 b): what it played before could not be shown to have
+ * stopped, so nothing of this reply may be heard, on the output, on the
+ * speakers or on any other voice. Exported so that an output cannot misspell it
+ * and silently turn a refusal into a failure the speakers take over.
+ */
+export declare const SPEECH_OUTPUT_REFUSE_AUDIBLE = "refuse-audible";
+/** What a `SpeechAudioOutput` rejects with to refuse the reply (`SPEECH_OUTPUT_REFUSE_AUDIBLE`). */
+export interface SpeechOutputRefusal {
+    readonly reason: typeof SPEECH_OUTPUT_REFUSE_AUDIBLE;
+}
 /**
  * Why playback stopped. `cancelled` is not a failure: it is what every queued
  * utterance reports when we deliberately cancel (new playback, panel close,
  * conversation switch), and the UI must stay silent about it.
+ *
+ * `output-not-cleared` is a failure that must NEVER be heard (BOFF-8822,
+ * operator decision D7 b): the reply's audio output refused it because what it
+ * played before could not be shown to have stopped. Nothing re-speaks it, the
+ * device voice included, and its text stays where it is. Only a reply with an
+ * `audioOutput` can end this way.
  */
-export type SpeechErrorReason = 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown';
+export type SpeechErrorReason = 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown' | 'output-not-cleared';
 export interface SpeechSpeakHandlers {
     /**
      * Audio has actually begun playing — not merely been requested.

package/dist/shared/assistant/speech/types.js

@@ -1,4 +1,4 @@
 //#region src/shared/assistant/speech/types.ts
-var e = "left";
+var e = "left", t = "refuse-audible";
 //#endregion
-export { e as SPEECH_OUTPUT_LEFT };
+export { e as SPEECH_OUTPUT_LEFT, t as SPEECH_OUTPUT_REFUSE_AUDIBLE };

package/dist/shared/assistant/ui/AssistantSpeechProvider.d.ts

@@ -54,6 +54,17 @@ export interface AssistantSpeechContextValue {
     setVoice: (voiceName: string | null) => void;
     /** The message currently being spoken, if any. */
     speakingMessageId: string | null;
+    /**
+     * ★★ The reply an audio output REFUSED (BOFF-8822, operator decision D7 b;
+     * reason `output-not-cleared`): what it played before could not be shown to
+     * have stopped, so the reply was never heard, on any voice. It ended as a
+     * failure like any other (playback is idle and its text is untouched); this
+     * says WHICH reply, so the voice session can explain the silence. A new
+     * object per refusal; null until one happens, which needs an audio output.
+     */
+    outputNotCleared: {
+        readonly messageId: string;
+    } | null;
     isSpeaking: (messageId: string) => boolean;
     /**
      * Speak this message, or stop if it is already the one speaking.