@fiodos/web-core 0.1.3 → 0.1.5

package/dist/cjs/adapters/webVoiceAdapter.js

@@ -2,6 +2,43 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWebVoiceAdapter = createWebVoiceAdapter;
 const core_1 = require("@fiodos/core");
+// ── Device TTS (SpeechSynthesis) helpers ────────────────────────────────────
+// Chrome loads voices asynchronously: calling speak() before getVoices() is
+// populated produces NO sound. Resolve the voice list once (event or timeout).
+function loadVoicesOnce(synth) {
+    const ready = synth.getVoices();
+    if (ready.length)
+        return Promise.resolve(ready);
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(synth.getVoices());
+        };
+        try {
+            synth.addEventListener('voiceschanged', finish, { once: true });
+        }
+        catch {
+            /* older engines: the timeout below is the only path */
+        }
+        // Some engines never emit `voiceschanged` — never block the reply forever.
+        setTimeout(finish, 600);
+    });
+}
+/** Best voice for a BCP-47 locale: exact → region-agnostic → language → default. */
+function pickVoiceForLocale(voices, locale) {
+    if (!voices.length)
+        return undefined;
+    const lc = locale.toLowerCase();
+    const lang = lc.split('-')[0] ?? lc;
+    return (voices.find((v) => v.lang?.toLowerCase() === lc) ??
+        voices.find((v) => v.lang?.toLowerCase().startsWith(`${lang}-`)) ??
+        voices.find((v) => v.lang?.toLowerCase().startsWith(lang)) ??
+        voices.find((v) => v.default) ??
+        voices[0]);
+}
 function getRecognitionCtor() {
     if (typeof window === 'undefined')
         return null;
@@ -33,6 +70,9 @@ function createWebVoiceAdapter(options = {}) {
     let aborted = false;
     let settled = false;
     let audioEl = null;
+    // Strong reference to the in-flight utterance: Chrome garbage-collects it
+    // otherwise, cutting device speech off mid-sentence (or producing silence).
+    let ttsUtterance = null;
     // ── Wake-word state (separate recognition instance; the browser allows only
     // one active session, so push-to-talk stops wake first). Desktop-only:
     // foreground tab while the page is visible — there is no passive background
@@ -412,13 +452,33 @@ function createWebVoiceAdapter(options = {}) {
                 return;
             if (typeof window === 'undefined' || !window.speechSynthesis)
                 return;
+            const synth = window.speechSynthesis;
+            // Voices load lazily on Chrome — speaking before they exist is silent.
+            const voices = await loadVoicesOnce(synth);
             return new Promise((resolve) => {
                 try {
+                    // Clear any utterance the engine wedged on (a known Chrome failure
+                    // mode) and unpause before queuing the reply.
+                    if (synth.speaking || synth.pending)
+                        synth.cancel();
+                    if (synth.paused)
+                        synth.resume();
                     const utter = new SpeechSynthesisUtterance(text);
                     utter.lang = ttsOptions.locale;
-                    utter.onend = () => resolve();
-                    utter.onerror = () => resolve();
-                    window.speechSynthesis.speak(utter);
+                    const voice = pickVoiceForLocale(voices, ttsOptions.locale);
+                    if (voice)
+                        utter.voice = voice;
+                    ttsUtterance = utter;
+                    const finish = () => {
+                        utter.onend = null;
+                        utter.onerror = null;
+                        if (ttsUtterance === utter)
+                            ttsUtterance = null;
+                        resolve();
+                    };
+                    utter.onend = finish;
+                    utter.onerror = finish;
+                    synth.speak(utter);
                 }
                 catch {
                     resolve();

package/dist/cjs/controller/AgentController.d.ts

@@ -74,6 +74,7 @@ export declare class AgentController {
     private abort;
     private watchdog;
     private confirmWindow;
+    private speakTimer;
     private pendingConsentIntent;
     private readonly listeners;
     private unsubscribeSpeech;
@@ -95,7 +96,14 @@ export declare class AgentController {
     private setPhase;
     private clearWatchdog;
     private clearConfirmWindow;
+    private clearSpeakTimer;
     private speakReply;
+    /**
+     * Never let the 'speaking' phase hang. If playback/TTS never reports
+     * completion (a stalled engine, a never-firing onend), stop it and continue
+     * after a generous, length-based cap so the orb returns to idle on its own.
+     */
+    private raceSpeakingWatchdog;
     private beginConfirmationVoiceWindow;
     confirmPendingAction(): Promise<void>;
     cancelPendingAction(): void;

package/dist/cjs/controller/AgentController.js

@@ -51,6 +51,9 @@ class AgentController {
         this.abort = null;
         this.watchdog = null;
         this.confirmWindow = null;
+        // Safety cap so the orb can never get stuck in 'speaking' if playback/TTS
+        // never reports completion (e.g. a stalled SpeechSynthesis engine).
+        this.speakTimer = null;
         this.pendingConsentIntent = null;
         this.listeners = new Set();
         this.unsubscribeSpeech = null;
@@ -179,6 +182,12 @@ class AgentController {
         }
         this.confirmationVoiceActive = false;
     }
+    clearSpeakTimer() {
+        if (this.speakTimer) {
+            clearTimeout(this.speakTimer);
+            this.speakTimer = null;
+        }
+    }
     // ── Speech playback (ONE consistent voice) ─────────────────────────────────
     async speakReply(text, audioBase64) {
         if (this.silentTurn)
@@ -189,23 +198,54 @@ class AgentController {
         try {
             let audio = audioBase64;
             if (!audio && text) {
-                audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
-            }
-            if (audio) {
-                await this.config.voice.playAudioBase64Mp3(audio);
-            }
-            else if (text) {
-                await this.config.voice.speakWithDeviceTts(text, { locale: this.ttsLocale });
+                // A server-TTS failure must NOT skip the device-voice fallback below.
+                try {
+                    audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
+                }
+                catch {
+                    audio = null;
+                }
             }
+            const playback = audio
+                ? this.config.voice.playAudioBase64Mp3(audio)
+                : text
+                    ? this.config.voice.speakWithDeviceTts(text, { locale: this.ttsLocale })
+                    : Promise.resolve();
+            await this.raceSpeakingWatchdog(playback, text);
         }
         catch {
             /* playback best-effort */
         }
         finally {
+            this.clearSpeakTimer();
             if (this.phase === 'speaking')
                 this.setPhase('idle');
         }
     }
+    /**
+     * Never let the 'speaking' phase hang. If playback/TTS never reports
+     * completion (a stalled engine, a never-firing onend), stop it and continue
+     * after a generous, length-based cap so the orb returns to idle on its own.
+     */
+    raceSpeakingWatchdog(playback, text) {
+        const capMs = Math.min(60000, 5000 + text.length * 90);
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                this.clearSpeakTimer();
+                resolve();
+            };
+            this.clearSpeakTimer();
+            this.speakTimer = setTimeout(() => {
+                this.config.voice.stopPlayback();
+                finish();
+            }, capMs);
+            playback.then(finish, finish);
+        });
+    }
     // ── Confirmation resolution ─────────────────────────────────────────────────
     beginConfirmationVoiceWindow() {
         const pending = this.pending;
@@ -544,8 +584,14 @@ class AgentController {
             this.setPhase('thinking');
             return;
         }
-        if (this.phase === 'thinking' || this.phase === 'speaking')
+        if (this.phase === 'speaking') {
+            // Tap while the assistant is talking → stop the reply and reset, so the
+            // orb is immediately usable again (no more "stuck pulsing").
+            this.cancelAll();
             return;
+        }
+        if (this.phase === 'thinking')
+            return; // a turn is in flight; let it finish
         const consented = await this.consent.hasConsented();
         if (!consented) {
             this.pendingConsentIntent = 'voice';
@@ -597,6 +643,7 @@ class AgentController {
         this.abort = null;
         this.clearWatchdog();
         this.clearConfirmWindow();
+        this.clearSpeakTimer();
         this.speech.cancel();
         this.config.voice.stopPlayback();
         this.pending = null;

package/dist/cjs/orb/mountOrb.js

@@ -46,6 +46,7 @@ const CSS = `
 @keyframes fyodos-blink{0%,100%{opacity:.25}50%{opacity:.9}}
 @keyframes fy-spin{to{transform:rotate(360deg)}}
 @keyframes fy-opulse{0%,100%{transform:scale(1);opacity:1}50%{transform:scale(1.06);opacity:.85}}
+@keyframes fy-voice{0%{transform:scale(0.6);opacity:.7}100%{transform:scale(1.35);opacity:0}}
 .fyodos-overlay{position:fixed;inset:0;display:flex;align-items:center;justify-content:center;padding:24px;background:rgba(4,6,12,0.6);}
 .fyodos-modal{width:min(420px,100%);border-radius:16px;padding:22px 24px;box-shadow:0 24px 60px rgba(0,0,0,0.5);}
 .fyodos-modal h3{margin:0 0 10px;font-size:17px;font-weight:600;}
@@ -65,6 +66,18 @@ function ensureStyles() {
     el.textContent = CSS;
     document.head.appendChild(el);
 }
+// Content box of the layout viewport. `documentElement.clientWidth/Height`
+// EXCLUDE a classic scrollbar that occupies real width/height (Windows, some
+// Linux/Chromium); overlay scrollbars (macOS, mobile) report the same value as
+// the layout viewport. Anchoring against this — not `innerWidth` — keeps a
+// right/bottom-edge orb just INSIDE the scrollbar instead of under/over it.
+function viewportContentSize() {
+    const de = typeof document !== 'undefined' ? document.documentElement : null;
+    return {
+        width: de?.clientWidth || window.innerWidth,
+        height: de?.clientHeight || window.innerHeight,
+    };
+}
 function cornerToPosition(corner) {
     switch (corner) {
         case 'bottom-left':
@@ -161,14 +174,15 @@ function mountOrb(controller, options = {}) {
     }
     function reposition() {
         const size = orbDiameterPx();
-        const insets = (0, core_1.resolveOrbLayerInsets)({
+        const content = viewportContentSize();
+        const { left, top } = (0, core_1.resolveOrbAnchorPx)({
             viewportWidth: window.innerWidth,
             viewportHeight: window.innerHeight,
+            contentWidth: content.width,
+            contentHeight: content.height,
             orbDiameter: size,
             position: effectivePosition(),
         });
-        const left = Math.max(8, window.innerWidth - insets.right - size);
-        const top = Math.max(8, window.innerHeight - insets.bottom - size);
         root.style.left = `${left}px`;
         root.style.top = `${top}px`;
         root.style.right = '';
@@ -197,6 +211,14 @@ function mountOrb(controller, options = {}) {
         }
     }
     window.addEventListener('resize', reposition);
+    // Recalc when a scrollbar appears/disappears as the page content changes (the
+    // content box shrinks/grows even when the window size doesn't), so the orb
+    // never ends up overlapped by — or detached from — the scrollbar edge.
+    let contentObserver;
+    if (typeof ResizeObserver !== 'undefined' && document.documentElement) {
+        contentObserver = new ResizeObserver(() => reposition());
+        contentObserver.observe(document.documentElement);
+    }
     // Keep the conversation bar above the keyboard as the visual viewport resizes
     // (keyboard open/close) or scrolls on mobile browsers.
     const visualViewport = window.visualViewport;
@@ -240,9 +262,10 @@ function mountOrb(controller, options = {}) {
         dragging = true;
         e.preventDefault();
         const size = orbDiameterPx();
+        const content = viewportContentSize();
         const margin = 8;
-        const maxLeft = window.innerWidth - margin - size;
-        const maxTop = window.innerHeight - margin - size;
+        const maxLeft = content.width - margin - size;
+        const maxTop = content.height - margin - size;
         const left = Math.min(maxLeft, Math.max(margin, originLeft + dx));
         const top = Math.min(maxTop, Math.max(margin, originTop + dy));
         root.style.left = `${left}px`;
@@ -252,8 +275,8 @@ function mountOrb(controller, options = {}) {
         draggedPosition = (0, core_1.viewportPixelsToOrbScreenPosition)({
             centerX: left + size / 2,
             centerY: top + size / 2,
-            viewportWidth: window.innerWidth,
-            viewportHeight: window.innerHeight,
+            viewportWidth: content.width,
+            viewportHeight: content.height,
             orbDiameter: size,
         });
         applyDeployment();
@@ -688,6 +711,7 @@ function mountOrb(controller, options = {}) {
             unsubscribe();
             stopWatch();
             window.removeEventListener('resize', reposition);
+            contentObserver?.disconnect();
             visualViewport?.removeEventListener('resize', onViewportChange);
             visualViewport?.removeEventListener('scroll', onViewportChange);
             clearOverlay();

package/dist/cjs/orb/orbView.js

@@ -215,6 +215,52 @@ function buildThinkingSpinner(orbSizePx, color) {
     wrap.appendChild(spin);
     return wrap;
 }
+// ── Speaking pulse (port of the dashboard's no-logo "speaking" state) ─────────
+// Two expanding rings + a pulsing centre dot — the default "talking" drawing the
+// dashboard orb editor shows when there is no custom photo. Ratios are taken
+// from the editor (118 / 30 / 2 px on its 380px reference orb) so the embedded
+// orb matches it at any size.
+const SPEAK_RING_RATIO = 118 / 380;
+const SPEAK_DOT_RATIO = 30 / 380;
+const SPEAK_BORDER_RATIO = 2 / 380;
+function buildSpeakingPulse(orbSize, color) {
+    const wrap = document.createElement('div');
+    Object.assign(wrap.style, {
+        position: 'absolute',
+        inset: '0',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        pointerEvents: 'none',
+    });
+    const ringPx = orbSize * SPEAK_RING_RATIO;
+    const borderPx = Math.max(1, orbSize * SPEAK_BORDER_RATIO);
+    for (const delay of [0, 0.85]) {
+        const ring = document.createElement('div');
+        Object.assign(ring.style, {
+            position: 'absolute',
+            width: `${ringPx}px`,
+            height: `${ringPx}px`,
+            borderRadius: '50%',
+            border: `${borderPx}px solid ${color}`,
+            opacity: '0.55',
+            animation: `fy-voice 1.7s ease-out infinite ${delay}s`,
+        });
+        wrap.appendChild(ring);
+    }
+    const dotPx = orbSize * SPEAK_DOT_RATIO;
+    const dot = document.createElement('div');
+    Object.assign(dot.style, {
+        width: `${dotPx}px`,
+        height: `${dotPx}px`,
+        borderRadius: '50%',
+        background: color,
+        opacity: '0.9',
+        animation: 'fy-opulse 1s ease-in-out infinite',
+    });
+    wrap.appendChild(dot);
+    return wrap;
+}
 // ── Keyboard chip icon (port of ChipIconSvg) ──────────────────────────────────
 function buildChipIcon(icon, size, color) {
     const spec = (0, core_1.chipIconSpec)(icon);
@@ -369,7 +415,10 @@ function createOrbVisual(initial) {
         waveform?.stop();
         waveform = null;
         fillEl.replaceChildren();
-        wrapper.style.animation = state === 'speaking' ? 'fy-opulse 1.1s ease-in-out infinite' : '';
+        // The "speaking" feedback now lives INSIDE the fill (a pulsing logo, or the
+        // rings + dot when there's no photo) to mirror the dashboard editor, so the
+        // orb no longer pulses as a whole.
+        wrapper.style.animation = '';
         if (state === 'thinking') {
             fillEl.appendChild(buildThinkingSpinner(size, waveColor));
             return;
@@ -397,10 +446,17 @@ function createOrbVisual(initial) {
                 userSelect: 'none',
                 webkitUserSelect: 'none',
                 webkitUserDrag: 'none',
+                // While speaking, the photo gently pulses (matches the dashboard).
+                animation: state === 'speaking' ? 'fy-opulse 1s ease-in-out infinite' : '',
             });
             fillEl.appendChild(img);
             return;
         }
+        if (state === 'speaking') {
+            // No photo → the default "talking" drawing (expanding rings + centre dot).
+            fillEl.appendChild(buildSpeakingPulse(size, waveColor));
+            return;
+        }
         if (state === 'idle') {
             fillEl.appendChild(buildOrbMark(size));
         }

package/dist/cjs/version.d.ts

@@ -5,5 +5,5 @@
  * Auto-generated by scripts/sync-sdk-version.mjs from package.json. Do not edit
  * by hand — change package.json `version` and re-run the sync/release script.
  */
-export declare const SDK_VERSION = "0.1.3";
+export declare const SDK_VERSION = "0.1.5";
 export declare const SDK_PACKAGE = "@fiodos/web-core";

package/dist/cjs/version.js

@@ -8,5 +8,5 @@ exports.SDK_PACKAGE = exports.SDK_VERSION = void 0;
  * Auto-generated by scripts/sync-sdk-version.mjs from package.json. Do not edit
  * by hand — change package.json `version` and re-run the sync/release script.
  */
-exports.SDK_VERSION = '0.1.3';
+exports.SDK_VERSION = '0.1.5';
 exports.SDK_PACKAGE = '@fiodos/web-core';

package/dist/esm/adapters/webVoiceAdapter.js

@@ -1,4 +1,41 @@
 import { detectWakePhrase } from '@fiodos/core';
+// ── Device TTS (SpeechSynthesis) helpers ────────────────────────────────────
+// Chrome loads voices asynchronously: calling speak() before getVoices() is
+// populated produces NO sound. Resolve the voice list once (event or timeout).
+function loadVoicesOnce(synth) {
+    const ready = synth.getVoices();
+    if (ready.length)
+        return Promise.resolve(ready);
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(synth.getVoices());
+        };
+        try {
+            synth.addEventListener('voiceschanged', finish, { once: true });
+        }
+        catch {
+            /* older engines: the timeout below is the only path */
+        }
+        // Some engines never emit `voiceschanged` — never block the reply forever.
+        setTimeout(finish, 600);
+    });
+}
+/** Best voice for a BCP-47 locale: exact → region-agnostic → language → default. */
+function pickVoiceForLocale(voices, locale) {
+    if (!voices.length)
+        return undefined;
+    const lc = locale.toLowerCase();
+    const lang = lc.split('-')[0] ?? lc;
+    return (voices.find((v) => v.lang?.toLowerCase() === lc) ??
+        voices.find((v) => v.lang?.toLowerCase().startsWith(`${lang}-`)) ??
+        voices.find((v) => v.lang?.toLowerCase().startsWith(lang)) ??
+        voices.find((v) => v.default) ??
+        voices[0]);
+}
 function getRecognitionCtor() {
     if (typeof window === 'undefined')
         return null;
@@ -30,6 +67,9 @@ export function createWebVoiceAdapter(options = {}) {
     let aborted = false;
     let settled = false;
     let audioEl = null;
+    // Strong reference to the in-flight utterance: Chrome garbage-collects it
+    // otherwise, cutting device speech off mid-sentence (or producing silence).
+    let ttsUtterance = null;
     // ── Wake-word state (separate recognition instance; the browser allows only
     // one active session, so push-to-talk stops wake first). Desktop-only:
     // foreground tab while the page is visible — there is no passive background
@@ -409,13 +449,33 @@ export function createWebVoiceAdapter(options = {}) {
                 return;
             if (typeof window === 'undefined' || !window.speechSynthesis)
                 return;
+            const synth = window.speechSynthesis;
+            // Voices load lazily on Chrome — speaking before they exist is silent.
+            const voices = await loadVoicesOnce(synth);
             return new Promise((resolve) => {
                 try {
+                    // Clear any utterance the engine wedged on (a known Chrome failure
+                    // mode) and unpause before queuing the reply.
+                    if (synth.speaking || synth.pending)
+                        synth.cancel();
+                    if (synth.paused)
+                        synth.resume();
                     const utter = new SpeechSynthesisUtterance(text);
                     utter.lang = ttsOptions.locale;
-                    utter.onend = () => resolve();
-                    utter.onerror = () => resolve();
-                    window.speechSynthesis.speak(utter);
+                    const voice = pickVoiceForLocale(voices, ttsOptions.locale);
+                    if (voice)
+                        utter.voice = voice;
+                    ttsUtterance = utter;
+                    const finish = () => {
+                        utter.onend = null;
+                        utter.onerror = null;
+                        if (ttsUtterance === utter)
+                            ttsUtterance = null;
+                        resolve();
+                    };
+                    utter.onend = finish;
+                    utter.onerror = finish;
+                    synth.speak(utter);
                 }
                 catch {
                     resolve();

package/dist/esm/controller/AgentController.d.ts

@@ -74,6 +74,7 @@ export declare class AgentController {
     private abort;
     private watchdog;
     private confirmWindow;
+    private speakTimer;
     private pendingConsentIntent;
     private readonly listeners;
     private unsubscribeSpeech;
@@ -95,7 +96,14 @@ export declare class AgentController {
     private setPhase;
     private clearWatchdog;
     private clearConfirmWindow;
+    private clearSpeakTimer;
     private speakReply;
+    /**
+     * Never let the 'speaking' phase hang. If playback/TTS never reports
+     * completion (a stalled engine, a never-firing onend), stop it and continue
+     * after a generous, length-based cap so the orb returns to idle on its own.
+     */
+    private raceSpeakingWatchdog;
     private beginConfirmationVoiceWindow;
     confirmPendingAction(): Promise<void>;
     cancelPendingAction(): void;

package/dist/esm/controller/AgentController.js

@@ -48,6 +48,9 @@ export class AgentController {
         this.abort = null;
         this.watchdog = null;
         this.confirmWindow = null;
+        // Safety cap so the orb can never get stuck in 'speaking' if playback/TTS
+        // never reports completion (e.g. a stalled SpeechSynthesis engine).
+        this.speakTimer = null;
         this.pendingConsentIntent = null;
         this.listeners = new Set();
         this.unsubscribeSpeech = null;
@@ -176,6 +179,12 @@ export class AgentController {
         }
         this.confirmationVoiceActive = false;
     }
+    clearSpeakTimer() {
+        if (this.speakTimer) {
+            clearTimeout(this.speakTimer);
+            this.speakTimer = null;
+        }
+    }
     // ── Speech playback (ONE consistent voice) ─────────────────────────────────
     async speakReply(text, audioBase64) {
         if (this.silentTurn)
@@ -186,23 +195,54 @@ export class AgentController {
         try {
             let audio = audioBase64;
             if (!audio && text) {
-                audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
-            }
-            if (audio) {
-                await this.config.voice.playAudioBase64Mp3(audio);
-            }
-            else if (text) {
-                await this.config.voice.speakWithDeviceTts(text, { locale: this.ttsLocale });
+                // A server-TTS failure must NOT skip the device-voice fallback below.
+                try {
+                    audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
+                }
+                catch {
+                    audio = null;
+                }
             }
+            const playback = audio
+                ? this.config.voice.playAudioBase64Mp3(audio)
+                : text
+                    ? this.config.voice.speakWithDeviceTts(text, { locale: this.ttsLocale })
+                    : Promise.resolve();
+            await this.raceSpeakingWatchdog(playback, text);
         }
         catch {
             /* playback best-effort */
         }
         finally {
+            this.clearSpeakTimer();
             if (this.phase === 'speaking')
                 this.setPhase('idle');
         }
     }
+    /**
+     * Never let the 'speaking' phase hang. If playback/TTS never reports
+     * completion (a stalled engine, a never-firing onend), stop it and continue
+     * after a generous, length-based cap so the orb returns to idle on its own.
+     */
+    raceSpeakingWatchdog(playback, text) {
+        const capMs = Math.min(60000, 5000 + text.length * 90);
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                this.clearSpeakTimer();
+                resolve();
+            };
+            this.clearSpeakTimer();
+            this.speakTimer = setTimeout(() => {
+                this.config.voice.stopPlayback();
+                finish();
+            }, capMs);
+            playback.then(finish, finish);
+        });
+    }
     // ── Confirmation resolution ─────────────────────────────────────────────────
     beginConfirmationVoiceWindow() {
         const pending = this.pending;
@@ -541,8 +581,14 @@ export class AgentController {
             this.setPhase('thinking');
             return;
         }
-        if (this.phase === 'thinking' || this.phase === 'speaking')
+        if (this.phase === 'speaking') {
+            // Tap while the assistant is talking → stop the reply and reset, so the
+            // orb is immediately usable again (no more "stuck pulsing").
+            this.cancelAll();
             return;
+        }
+        if (this.phase === 'thinking')
+            return; // a turn is in flight; let it finish
         const consented = await this.consent.hasConsented();
         if (!consented) {
             this.pendingConsentIntent = 'voice';
@@ -594,6 +640,7 @@ export class AgentController {
         this.abort = null;
         this.clearWatchdog();
         this.clearConfirmWindow();
+        this.clearSpeakTimer();
         this.speech.cancel();
         this.config.voice.stopPlayback();
         this.pending = null;

package/dist/esm/orb/mountOrb.js

@@ -16,7 +16,7 @@
  *  - CONFIRMATIONS: the same security model (manifest decides; strict phrase /
  *    deliberate tap for payment-grade; loose "yes" never resolves strict).
  */
-import { DEFAULT_ORB_SCREEN_POSITION, createWebOrbHaptics, resolveOrbLayerInsets, resolveOrbDeployment, snapOrbScreenPositionToSide, viewportPixelsToOrbScreenPosition, } from '@fiodos/core';
+import { DEFAULT_ORB_SCREEN_POSITION, createWebOrbHaptics, resolveOrbAnchorPx, resolveOrbDeployment, snapOrbScreenPositionToSide, viewportPixelsToOrbScreenPosition, } from '@fiodos/core';
 import { buildKeyboardChip, createOrbVisual, DEFAULT_ORB_APPEARANCE, } from './orbView.js';
 import { watchPublishedConfig } from './publishedConfig.js';
 const STYLE_ID = 'fyodos-orb-styles';
@@ -43,6 +43,7 @@ const CSS = `
 @keyframes fyodos-blink{0%,100%{opacity:.25}50%{opacity:.9}}
 @keyframes fy-spin{to{transform:rotate(360deg)}}
 @keyframes fy-opulse{0%,100%{transform:scale(1);opacity:1}50%{transform:scale(1.06);opacity:.85}}
+@keyframes fy-voice{0%{transform:scale(0.6);opacity:.7}100%{transform:scale(1.35);opacity:0}}
 .fyodos-overlay{position:fixed;inset:0;display:flex;align-items:center;justify-content:center;padding:24px;background:rgba(4,6,12,0.6);}
 .fyodos-modal{width:min(420px,100%);border-radius:16px;padding:22px 24px;box-shadow:0 24px 60px rgba(0,0,0,0.5);}
 .fyodos-modal h3{margin:0 0 10px;font-size:17px;font-weight:600;}
@@ -62,6 +63,18 @@ function ensureStyles() {
     el.textContent = CSS;
     document.head.appendChild(el);
 }
+// Content box of the layout viewport. `documentElement.clientWidth/Height`
+// EXCLUDE a classic scrollbar that occupies real width/height (Windows, some
+// Linux/Chromium); overlay scrollbars (macOS, mobile) report the same value as
+// the layout viewport. Anchoring against this — not `innerWidth` — keeps a
+// right/bottom-edge orb just INSIDE the scrollbar instead of under/over it.
+function viewportContentSize() {
+    const de = typeof document !== 'undefined' ? document.documentElement : null;
+    return {
+        width: de?.clientWidth || window.innerWidth,
+        height: de?.clientHeight || window.innerHeight,
+    };
+}
 function cornerToPosition(corner) {
     switch (corner) {
         case 'bottom-left':
@@ -158,14 +171,15 @@ export function mountOrb(controller, options = {}) {
     }
     function reposition() {
         const size = orbDiameterPx();
-        const insets = resolveOrbLayerInsets({
+        const content = viewportContentSize();
+        const { left, top } = resolveOrbAnchorPx({
             viewportWidth: window.innerWidth,
             viewportHeight: window.innerHeight,
+            contentWidth: content.width,
+            contentHeight: content.height,
             orbDiameter: size,
             position: effectivePosition(),
         });
-        const left = Math.max(8, window.innerWidth - insets.right - size);
-        const top = Math.max(8, window.innerHeight - insets.bottom - size);
         root.style.left = `${left}px`;
         root.style.top = `${top}px`;
         root.style.right = '';
@@ -194,6 +208,14 @@ export function mountOrb(controller, options = {}) {
         }
     }
     window.addEventListener('resize', reposition);
+    // Recalc when a scrollbar appears/disappears as the page content changes (the
+    // content box shrinks/grows even when the window size doesn't), so the orb
+    // never ends up overlapped by — or detached from — the scrollbar edge.
+    let contentObserver;
+    if (typeof ResizeObserver !== 'undefined' && document.documentElement) {
+        contentObserver = new ResizeObserver(() => reposition());
+        contentObserver.observe(document.documentElement);
+    }
     // Keep the conversation bar above the keyboard as the visual viewport resizes
     // (keyboard open/close) or scrolls on mobile browsers.
     const visualViewport = window.visualViewport;
@@ -237,9 +259,10 @@ export function mountOrb(controller, options = {}) {
         dragging = true;
         e.preventDefault();
         const size = orbDiameterPx();
+        const content = viewportContentSize();
         const margin = 8;
-        const maxLeft = window.innerWidth - margin - size;
-        const maxTop = window.innerHeight - margin - size;
+        const maxLeft = content.width - margin - size;
+        const maxTop = content.height - margin - size;
         const left = Math.min(maxLeft, Math.max(margin, originLeft + dx));
         const top = Math.min(maxTop, Math.max(margin, originTop + dy));
         root.style.left = `${left}px`;
@@ -249,8 +272,8 @@ export function mountOrb(controller, options = {}) {
         draggedPosition = viewportPixelsToOrbScreenPosition({
             centerX: left + size / 2,
             centerY: top + size / 2,
-            viewportWidth: window.innerWidth,
-            viewportHeight: window.innerHeight,
+            viewportWidth: content.width,
+            viewportHeight: content.height,
             orbDiameter: size,
         });
         applyDeployment();
@@ -685,6 +708,7 @@ export function mountOrb(controller, options = {}) {
             unsubscribe();
             stopWatch();
             window.removeEventListener('resize', reposition);
+            contentObserver?.disconnect();
             visualViewport?.removeEventListener('resize', onViewportChange);
             visualViewport?.removeEventListener('scroll', onViewportChange);
             clearOverlay();

package/dist/esm/orb/orbView.js

@@ -210,6 +210,52 @@ function buildThinkingSpinner(orbSizePx, color) {
     wrap.appendChild(spin);
     return wrap;
 }
+// ── Speaking pulse (port of the dashboard's no-logo "speaking" state) ─────────
+// Two expanding rings + a pulsing centre dot — the default "talking" drawing the
+// dashboard orb editor shows when there is no custom photo. Ratios are taken
+// from the editor (118 / 30 / 2 px on its 380px reference orb) so the embedded
+// orb matches it at any size.
+const SPEAK_RING_RATIO = 118 / 380;
+const SPEAK_DOT_RATIO = 30 / 380;
+const SPEAK_BORDER_RATIO = 2 / 380;
+function buildSpeakingPulse(orbSize, color) {
+    const wrap = document.createElement('div');
+    Object.assign(wrap.style, {
+        position: 'absolute',
+        inset: '0',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        pointerEvents: 'none',
+    });
+    const ringPx = orbSize * SPEAK_RING_RATIO;
+    const borderPx = Math.max(1, orbSize * SPEAK_BORDER_RATIO);
+    for (const delay of [0, 0.85]) {
+        const ring = document.createElement('div');
+        Object.assign(ring.style, {
+            position: 'absolute',
+            width: `${ringPx}px`,
+            height: `${ringPx}px`,
+            borderRadius: '50%',
+            border: `${borderPx}px solid ${color}`,
+            opacity: '0.55',
+            animation: `fy-voice 1.7s ease-out infinite ${delay}s`,
+        });
+        wrap.appendChild(ring);
+    }
+    const dotPx = orbSize * SPEAK_DOT_RATIO;
+    const dot = document.createElement('div');
+    Object.assign(dot.style, {
+        width: `${dotPx}px`,
+        height: `${dotPx}px`,
+        borderRadius: '50%',
+        background: color,
+        opacity: '0.9',
+        animation: 'fy-opulse 1s ease-in-out infinite',
+    });
+    wrap.appendChild(dot);
+    return wrap;
+}
 // ── Keyboard chip icon (port of ChipIconSvg) ──────────────────────────────────
 function buildChipIcon(icon, size, color) {
     const spec = chipIconSpec(icon);
@@ -364,7 +410,10 @@ export function createOrbVisual(initial) {
         waveform?.stop();
         waveform = null;
         fillEl.replaceChildren();
-        wrapper.style.animation = state === 'speaking' ? 'fy-opulse 1.1s ease-in-out infinite' : '';
+        // The "speaking" feedback now lives INSIDE the fill (a pulsing logo, or the
+        // rings + dot when there's no photo) to mirror the dashboard editor, so the
+        // orb no longer pulses as a whole.
+        wrapper.style.animation = '';
         if (state === 'thinking') {
             fillEl.appendChild(buildThinkingSpinner(size, waveColor));
             return;
@@ -392,10 +441,17 @@ export function createOrbVisual(initial) {
                 userSelect: 'none',
                 webkitUserSelect: 'none',
                 webkitUserDrag: 'none',
+                // While speaking, the photo gently pulses (matches the dashboard).
+                animation: state === 'speaking' ? 'fy-opulse 1s ease-in-out infinite' : '',
             });
             fillEl.appendChild(img);
             return;
         }
+        if (state === 'speaking') {
+            // No photo → the default "talking" drawing (expanding rings + centre dot).
+            fillEl.appendChild(buildSpeakingPulse(size, waveColor));
+            return;
+        }
         if (state === 'idle') {
             fillEl.appendChild(buildOrbMark(size));
         }

package/dist/esm/version.d.ts

@@ -5,5 +5,5 @@
  * Auto-generated by scripts/sync-sdk-version.mjs from package.json. Do not edit
  * by hand — change package.json `version` and re-run the sync/release script.
  */
-export declare const SDK_VERSION = "0.1.3";
+export declare const SDK_VERSION = "0.1.5";
 export declare const SDK_PACKAGE = "@fiodos/web-core";

package/dist/esm/version.js

@@ -5,5 +5,5 @@
  * Auto-generated by scripts/sync-sdk-version.mjs from package.json. Do not edit
  * by hand — change package.json `version` and re-run the sync/release script.
  */
-export const SDK_VERSION = '0.1.3';
+export const SDK_VERSION = '0.1.5';
 export const SDK_PACKAGE = '@fiodos/web-core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiodos/web-core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Framework-agnostic browser layer for the Fiodos agent: a vanilla AgentController (orchestrator), DOM adapters (navigation/voice/storage), HTTP client and decision engine over @fiodos/core. Shared base for @fiodos/vue, @fiodos/svelte and @fiodos/angular (no framework imports).",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
@@ -25,7 +25,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node ../../scripts/fix-esm-extensions.mjs dist/esm && node ../../scripts/mark-dual.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node --import tsx --test test/*.test.ts"
+    "test": "node --import tsx --test test/*.test.ts",
+    "prepublishOnly": "node ../../scripts/sync-sdk-version.mjs && npm run build"
   },
   "dependencies": {
     "@fiodos/core": "^0.1.0"