@burdenoff/fe-libs 2026.903.2 → 2026.903.4

package/dist/shared/assistant/voice/voiceStageState.d.ts

@@ -0,0 +1,49 @@
+import { VoiceSessionSnapshot } from './voiceSession';
+export type VoiceStageState = 'connecting' | 'listening' | 'endpoint-grace' | 'thinking' | 'speaking' | 'interrupting' | 'mic-error' | 'ended';
+export interface StageInputs {
+    snapshot: VoiceSessionSnapshot;
+    /** Is the recogniser genuinely running? False during start-up. */
+    capturing: boolean;
+    /** True from the moment the user cuts the assistant off until listening resumes. */
+    interrupting?: boolean;
+    /**
+     * The user has stopped producing new words and the submit timer is running.
+     *
+     * Its own state because the checklist asks for it: the two-second correction
+     * window should look like a deliberate pause the user can still speak into,
+     * not like the session has already moved on.
+     */
+    awaitingEndpoint?: boolean;
+}
+/**
+ * Precedence is the whole design. A failure outranks a phase — a session that
+ * cannot hear must never render as "Listening…", which is precisely the lie the
+ * operator screenshotted.
+ */
+export declare function voiceStageState({ snapshot, capturing, interrupting, awaitingEndpoint, }: StageInputs): VoiceStageState;
+/** Does this stage show the user's live transcript rather than the reply? */
+export declare function showsUserCaption(state: VoiceStageState): boolean;
+/** Does this stage show the assistant's caption? */
+export declare function showsAssistantCaption(state: VoiceStageState): boolean;
+/** Is the microphone control an INTERRUPT rather than a mute toggle? */
+export declare function micIsInterrupt(state: VoiceStageState): boolean;
+/**
+ * Does this stage show a LIVE waveform?
+ *
+ * ★ Shared rather than repeated, because the two surfaces had already drifted:
+ * the full stage and the docked strip each answered this question with their
+ * own inline expression, so teaching one about a new state silently left the
+ * other frozen. `endpoint-grace` in particular MUST animate — it is the window
+ * in which the user may still be talking, and a still waveform beside the words
+ * "still listening" says the opposite of the label.
+ */
+export declare function waveformIsActive(state: VoiceStageState): boolean;
+/**
+ * Is the waveform open but WAITING rather than actively hearing speech?
+ *
+ * The correction window is not the same as mid-sentence listening, and a status
+ * line is a weak way to say so: a calmer, shorter profile makes the pause
+ * visible without implying the microphone closed.
+ */
+export declare function waveformIsSettled(state: VoiceStageState): boolean;
+//# sourceMappingURL=voiceStageState.d.ts.map

package/dist/shared/assistant/voice/voiceStageState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceStageState.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceStageState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,MAAM,eAAe,GACzB,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,OAAO,CAAC;AAEnH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,SAAS,EACT,YAAoB,EACpB,gBAAwB,GACzB,EAAE,WAAW,GAAG,eAAe,CAwB/B;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAKhE;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAErE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEjE"}

package/dist/shared-assistant.js

@@ -6,4 +6,7 @@ import { buildProgress as y, getAssistantMedia as b, isRecoverable as x, mapSess
 import { createSandboxAssistantTransport as T } from "./shared/assistant/createSandboxAssistantTransport.js";
 import { useSandboxAssistantTransport as E } from "./shared/assistant/useSandboxAssistantTransport.js";
 import { chatTurns as D, groupBySession as O, groupConsecutiveBySession as k, isVoiceTurn as A, voiceMarker as j, voiceSessionIdOf as M, voiceTurnsOnly as N } from "./shared/assistant/voice/turnVisibility.js";
-export { v as AssistantRuntimeManager, y as buildProgress, n as buildPromptRequestBody, D as chatTurns, r as checkAssistantAiCredits, i as createAssistantSandbox, a as createAssistantSession, T as createSandboxAssistantTransport, o as downloadAssistantArtifact, s as extendAssistantSandboxTTL, c as findExistingSandbox, l as getAssistantArtifacts, b as getAssistantMedia, u as getAssistantMessages, d as getAssistantSession, f as getAssistantStreamAccess, O as groupBySession, k as groupConsecutiveBySession, t as isQuotaExhaustedError, x as isRecoverable, A as isVoiceTurn, S as mapSessionToHistory, C as mergeMessagesById, p as reportAssistantAiTokenUsage, w as sanitize, m as sendAssistantPromptAsync, h as sendHeartbeat, E as useSandboxAssistantTransport, e as useVoiceInput, j as voiceMarker, M as voiceSessionIdOf, N as voiceTurnsOnly, g as waitForAssistantServiceReady, _ as waitForSandboxRunning };
+import { toCaptionText as P } from "./shared/assistant/voice/captionText.js";
+import { findPendingWrite as F, parseConfirmationRefusal as I } from "./shared/assistant/pendingWrite.js";
+import { createSpeechEngines as L } from "./shared/assistant/speech/createSpeechEngine.js";
+export { v as AssistantRuntimeManager, y as buildProgress, n as buildPromptRequestBody, D as chatTurns, r as checkAssistantAiCredits, i as createAssistantSandbox, a as createAssistantSession, T as createSandboxAssistantTransport, L as createSpeechEngines, o as downloadAssistantArtifact, s as extendAssistantSandboxTTL, c as findExistingSandbox, F as findPendingWrite, l as getAssistantArtifacts, b as getAssistantMedia, u as getAssistantMessages, d as getAssistantSession, f as getAssistantStreamAccess, O as groupBySession, k as groupConsecutiveBySession, t as isQuotaExhaustedError, x as isRecoverable, A as isVoiceTurn, S as mapSessionToHistory, C as mergeMessagesById, I as parseConfirmationRefusal, p as reportAssistantAiTokenUsage, w as sanitize, m as sendAssistantPromptAsync, h as sendHeartbeat, P as toCaptionText, E as useSandboxAssistantTransport, e as useVoiceInput, j as voiceMarker, M as voiceSessionIdOf, N as voiceTurnsOnly, g as waitForAssistantServiceReady, _ as waitForSandboxRunning };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.903.2",
+  "version": "2026.903.4",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "bin": {