@fiodos/web-core 0.1.5 → 0.1.9

package/dist/cjs/adapters/webVoiceAdapter.js

@@ -401,20 +401,40 @@ function createWebVoiceAdapter(options = {}) {
             // later programmatic playback (after the network round-trip) is allowed
             // and audible even with the silent switch on.
             const ctx = ensureAudioCtx();
-            if (!ctx)
-                return;
-            try {
-                if (ctx.state === 'suspended')
-                    void ctx.resume();
-                // A 1-frame silent buffer fully unlocks playback on iOS Safari.
-                const buffer = ctx.createBuffer(1, 1, ctx.sampleRate);
-                const source = ctx.createBufferSource();
-                source.buffer = buffer;
-                source.connect(ctx.destination);
-                source.start(0);
+            if (ctx) {
+                try {
+                    if (ctx.state === 'suspended')
+                        void ctx.resume();
+                    // A 1-frame silent buffer fully unlocks playback on iOS Safari.
+                    const buffer = ctx.createBuffer(1, 1, ctx.sampleRate);
+                    const source = ctx.createBufferSource();
+                    source.buffer = buffer;
+                    source.connect(ctx.destination);
+                    source.start(0);
+                }
+                catch {
+                    /* best-effort unlock */
+                }
             }
-            catch {
-                /* best-effort unlock */
+            // Unlock device TTS (SpeechSynthesis) too. The spoken reply happens AFTER
+            // the network round-trip — outside this gesture — and Safari/Chrome stay
+            // SILENT for a first programmatic speak that wasn't preceded by a
+            // gesture-initiated one. Warm the engine here: kick off voice loading and
+            // speak a zero-volume blank utterance inside the tap so the real reply is
+            // allowed to play later.
+            if (!options.disableDeviceTtsFallback && typeof window !== 'undefined' && window.speechSynthesis) {
+                try {
+                    const synth = window.speechSynthesis;
+                    synth.getVoices(); // triggers async voice loading on Chrome
+                    if (synth.paused)
+                        synth.resume();
+                    const warm = new SpeechSynthesisUtterance(' ');
+                    warm.volume = 0;
+                    synth.speak(warm);
+                }
+                catch {
+                    /* best-effort unlock */
+                }
             }
         },
         async playAudioBase64Mp3(base64) {
@@ -456,20 +476,32 @@ function createWebVoiceAdapter(options = {}) {
             // Voices load lazily on Chrome — speaking before they exist is silent.
             const voices = await loadVoicesOnce(synth);
             return new Promise((resolve) => {
+                let keepAlive = null;
+                const cleanup = () => {
+                    if (keepAlive) {
+                        clearInterval(keepAlive);
+                        keepAlive = null;
+                    }
+                };
                 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();
+                    // Clear any previous/wedged queue. After a prior cancel() (e.g. the
+                    // stopPlayback() fired when listening started) Chrome on macOS can sit
+                    // in a stuck "paused" state that does NOT report paused===true, so a
+                    // conditional resume() never fires and every later speak() is silent.
+                    synth.cancel();
                     const utter = new SpeechSynthesisUtterance(text);
                     utter.lang = ttsOptions.locale;
                     const voice = pickVoiceForLocale(voices, ttsOptions.locale);
                     if (voice)
                         utter.voice = voice;
+                    utter.volume = 1;
+                    utter.rate = 1;
+                    utter.pitch = 1;
+                    // Keep a strong ref so Chrome can't GC the utterance mid-speech.
                     ttsUtterance = utter;
                     const finish = () => {
+                        cleanup();
+                        utter.onstart = null;
                         utter.onend = null;
                         utter.onerror = null;
                         if (ttsUtterance === utter)
@@ -479,8 +511,22 @@ function createWebVoiceAdapter(options = {}) {
                     utter.onend = finish;
                     utter.onerror = finish;
                     synth.speak(utter);
+                    // THE FIX: resume() unconditionally right after queuing. This un-wedges
+                    // the engine from the silent stuck-paused state described above.
+                    synth.resume();
+                    // Chrome desktop stops speaking after ~15s; pulse pause/resume to keep
+                    // long replies going, and stop the timer once it has finished.
+                    keepAlive = setInterval(() => {
+                        if (!synth.speaking && !synth.pending) {
+                            cleanup();
+                            return;
+                        }
+                        synth.pause();
+                        synth.resume();
+                    }, 9000);
                 }
                 catch {
+                    cleanup();
                     resolve();
                 }
             });

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

@@ -75,6 +75,7 @@ export declare class AgentController {
     private watchdog;
     private confirmWindow;
     private speakTimer;
+    private serverTtsUnavailable;
     private pendingConsentIntent;
     private readonly listeners;
     private unsubscribeSpeech;

package/dist/cjs/controller/AgentController.js

@@ -54,6 +54,9 @@ class AgentController {
         // 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;
+        // Once the backend shows it has no server-side TTS (a reply arrives with null
+        // audio), skip the extra /preview-tts round-trip and speak via device voice.
+        this.serverTtsUnavailable = false;
         this.pendingConsentIntent = null;
         this.listeners = new Set();
         this.unsubscribeSpeech = null;
@@ -90,7 +93,11 @@ class AgentController {
                 });
         this.screenStore = (0, screenContextStore_1.createScreenContextStore)({
             getCurrentRoute: () => config.navigation.getCurrentRoute(),
-            routeFallback: config.routeContextFallback,
+            // The integrator's fallback wins; otherwise the orb gets screen awareness
+            // out of the box from the matched manifest route (label + description +
+            // available actions). Null when no route matches → raw route, as today.
+            routeFallback: config.routeContextFallback ??
+                ((route) => (0, core_1.defaultRouteContextText)(route, config.manifest, this.messages)),
         });
         this.speech = (0, speechSession_1.createSpeechSession)({
             adapter: config.voice,
@@ -197,13 +204,20 @@ class AgentController {
         this.setPhase('speaking');
         try {
             let audio = audioBase64;
-            if (!audio && text) {
-                // A server-TTS failure must NOT skip the device-voice fallback below.
+            if (audio) {
+                this.serverTtsUnavailable = false; // server voice is working
+            }
+            // Once we know the backend ships no server TTS, skip the dead
+            // /preview-tts round-trip (pure latency) and use the device voice.
+            if (!audio && text && !this.serverTtsUnavailable) {
                 try {
                     audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
+                    if (!audio)
+                        this.serverTtsUnavailable = true;
                 }
                 catch {
                     audio = null;
+                    this.serverTtsUnavailable = true;
                 }
             }
             const playback = audio
@@ -418,6 +432,10 @@ class AgentController {
             }, { signal: controller.signal });
             reply = turn.reply;
             audioBase64 = turn.audioBase64;
+            // Learn whether this backend ships server-side TTS: a non-empty reply
+            // with no audio means it doesn't — later lines then speak instantly.
+            if (reply)
+                this.serverTtsUnavailable = !audioBase64;
             const decision = await (0, turnEngine_1.decideAction)({
                 action: turn.action,
                 manifest: this.config.manifest,

package/dist/cjs/dropin/createFiodosAgent.d.ts

@@ -27,8 +27,12 @@ export interface CreateFiodosAgentOptions {
     manifest?: AppManifest;
     /** Action handlers / context validators (defaults to empty registries). */
     registries?: ActionRegistries;
-    /** Agent reply locale (e.g. 'es', 'en'). Defaults to the browser language. */
+    /** Agent UI locale (e.g. 'en', 'es'). Defaults to `'en'`. */
     locale?: string;
+    /** Live locale resolver — overrides `locale` when set. */
+    getLocale?: () => string;
+    /** Auto-detect locale when `locale` / `getLocale` are unset. Default: none (English). */
+    localeDetection?: 'browser' | 'document';
     /** STT locale (e.g. 'es-ES', 'en-US'). Defaults to the browser language. */
     sttLocale?: string;
     /** Host router navigate delegate. Defaults to location.assign. */

package/dist/cjs/dropin/createFiodosAgent.js

@@ -32,10 +32,27 @@ function browserLocale() {
     const lang = typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'en-US';
     return { locale: lang.split('-')[0] || 'en', sttLocale: lang };
 }
+function resolveAgentLocale(options) {
+    const fromApp = options.getLocale?.()?.trim();
+    if (fromApp)
+        return fromApp;
+    if (options.locale?.trim())
+        return options.locale.trim();
+    if (options.localeDetection === 'browser')
+        return browserLocale().locale;
+    if (options.localeDetection === 'document') {
+        const docLang = typeof document !== 'undefined'
+            ? document.documentElement.lang?.split(/[-_]/)[0]?.trim()
+            : '';
+        if (docLang)
+            return docLang;
+    }
+    return 'en';
+}
 /** Build the controller + adapters from a known manifest (shared by both paths). */
 function assemble(options, manifest, baseUrl) {
     const fallback = browserLocale();
-    const locale = options.locale ?? fallback.locale;
+    const locale = resolveAgentLocale(options);
     const sttLocale = options.sttLocale ?? options.locale ?? fallback.sttLocale;
     const backend = (0, backendClient_1.createFiodosBackendClient)({
         baseUrl,

package/dist/cjs/orb/mountOrb.js

@@ -42,6 +42,8 @@ const CSS = `
 .fyodos-bubble-row{display:flex;gap:8px;align-items:flex-end;padding:8px 10px;border-top:1px solid rgba(160,180,220,0.18);}
 .fyodos-bubble-row input{flex:1;border:1px solid rgba(15,23,42,0.12);outline:none;border-radius:10px;padding:9px 11px;font-size:15px;}
 .fyodos-bubble-row button{appearance:none;border:none;flex-shrink:0;display:flex;align-items:center;justify-content:center;width:32px;height:32px;min-width:32px;padding:0;font-size:17px;font-weight:700;line-height:1;color:#000;cursor:pointer;}
+.fyodos-thought{position:absolute;appearance:none;display:inline-block;width:max-content;max-width:min(280px,70vw);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;text-align:left;line-height:1.25;font-weight:500;cursor:pointer;box-shadow:0 8px 24px rgba(0,0,0,0.22);animation:fyodos-thought-in .18s ease-out;}
+@keyframes fyodos-thought-in{from{opacity:0;transform:translateY(4px) scale(0.96)}to{opacity:1;transform:none}}
 @keyframes fyodos-fade-in{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}
 @keyframes fyodos-blink{0%,100%{opacity:.25}50%{opacity:.9}}
 @keyframes fy-spin{to{transform:rotate(360deg)}}
@@ -130,6 +132,12 @@ function mountOrb(controller, options = {}) {
     let publishedAppearance = null;
     let chipTheme = null;
     let modalTheme;
+    let bubbleTheme = (0, core_1.resolveBubbleTheme)(null);
+    let bubbleEnabled = true;
+    // Dashboard VOICE switch. Default true (voice on). When false the orb never
+    // listens/speaks: a tap opens the keyboard directly and text turns are silent.
+    let voiceInputEnabled = true;
+    let currentRoute = null;
     let screenPosition = options.corner
         ? cornerToPosition(options.corner)
         : { ...core_1.DEFAULT_ORB_SCREEN_POSITION };
@@ -160,6 +168,22 @@ function mountOrb(controller, options = {}) {
     anchor.appendChild(btn);
     root.appendChild(anchor);
     let chipEl = null;
+    // Thought bubble: a short, screen-aware CTA beside the orb. Created once and
+    // shown/hidden by syncThoughtBubble; tapping it opens the keyboard.
+    const thoughtBubbleEl = document.createElement('button');
+    thoughtBubbleEl.type = 'button';
+    thoughtBubbleEl.className = 'fyodos-thought';
+    thoughtBubbleEl.style.display = 'none';
+    thoughtBubbleEl.addEventListener('click', () => {
+        haptics.trigger('orbTap');
+        controller.primeAudio();
+        if (enableTextInput) {
+            openTextPanel();
+            return;
+        }
+        void controller.toggleListening();
+    });
+    anchor.appendChild(thoughtBubbleEl);
     container.appendChild(root);
     // ── Position (dashboard position; user drag is SESSION-only, never persisted) ─
     // The orb ALWAYS starts at the dashboard-published position on every load.
@@ -209,6 +233,9 @@ function mountOrb(controller, options = {}) {
                 chipEl.style.right = '';
             }
         }
+        // Keep the thought bubble on the orb's free side too while it is visible.
+        if (thoughtBubbleEl.style.display !== 'none')
+            positionThoughtBubble();
     }
     window.addEventListener('resize', reposition);
     // Recalc when a scrollbar appears/disappears as the page content changes (the
@@ -459,6 +486,65 @@ function mountOrb(controller, options = {}) {
         anchor.appendChild(chipEl);
         applyDeployment();
     }
+    // ── Thought bubble (screen-aware CTA beside the orb) ─────────────────────────
+    function resolveCurrentBubblePrompt() {
+        return (0, core_1.resolveBubblePrompt)((0, core_1.matchRouteIntent)(currentRoute, controller.config.manifest.routes), controller.messages, { locale: controller.config.locale, actions: controller.config.manifest.actions });
+    }
+    function applyThoughtBubbleTheme() {
+        const t = bubbleTheme;
+        const { fontPx, padV, padH, approxHeight } = (0, core_1.resolveBubblePadding)(t);
+        const shapeStyle = (0, core_1.resolveBubbleShapeStyle)(t, approxHeight);
+        thoughtBubbleEl.style.fontSize = `${fontPx}px`;
+        thoughtBubbleEl.style.padding = `${padV}px ${padH}px`;
+        thoughtBubbleEl.style.color = t.textColor;
+        thoughtBubbleEl.style.background = t.backgroundColor;
+        thoughtBubbleEl.style.border = `${t.borderWidth}px solid ${t.borderColor}`;
+        thoughtBubbleEl.style.borderRadius =
+            shapeStyle.borderRadius != null ? `${shapeStyle.borderRadius}px` : '';
+        thoughtBubbleEl.style.borderTopLeftRadius =
+            shapeStyle.borderTopLeftRadius != null ? `${shapeStyle.borderTopLeftRadius}px` : '';
+        thoughtBubbleEl.style.borderTopRightRadius =
+            shapeStyle.borderTopRightRadius != null ? `${shapeStyle.borderTopRightRadius}px` : '';
+        thoughtBubbleEl.style.borderBottomLeftRadius =
+            shapeStyle.borderBottomLeftRadius != null ? `${shapeStyle.borderBottomLeftRadius}px` : '';
+        thoughtBubbleEl.style.borderBottomRightRadius =
+            shapeStyle.borderBottomRightRadius != null ? `${shapeStyle.borderBottomRightRadius}px` : '';
+        thoughtBubbleEl.style.clipPath = shapeStyle.clipPath ?? '';
+    }
+    function positionThoughtBubble() {
+        const dep = (0, core_1.resolveOrbDeployment)(effectivePosition());
+        if (dep.horizontal === 'left') {
+            thoughtBubbleEl.style.right = 'calc(100% + 10px)';
+            thoughtBubbleEl.style.left = '';
+        }
+        else {
+            thoughtBubbleEl.style.left = 'calc(100% + 10px)';
+            thoughtBubbleEl.style.right = '';
+        }
+        if (dep.vertical === 'up') {
+            thoughtBubbleEl.style.top = '0';
+            thoughtBubbleEl.style.bottom = '';
+            thoughtBubbleEl.style.transform = '';
+        }
+        else {
+            thoughtBubbleEl.style.bottom = '0';
+            thoughtBubbleEl.style.top = '';
+            thoughtBubbleEl.style.transform = '';
+        }
+    }
+    function syncThoughtBubble(state) {
+        const idle = !state.showThinking && !state.showWaveform && state.phase !== 'speaking' && !micFallbackActive;
+        const prompt = bubbleEnabled && !bubbleOpen && idle ? resolveCurrentBubblePrompt() : null;
+        if (!prompt) {
+            thoughtBubbleEl.style.display = 'none';
+            return;
+        }
+        thoughtBubbleEl.textContent = prompt;
+        thoughtBubbleEl.setAttribute('aria-label', ui.orbLabel);
+        applyThoughtBubbleTheme();
+        positionThoughtBubble();
+        thoughtBubbleEl.style.display = 'block';
+    }
     // ── Overlays (confirmation + consent) ────────────────────────────────────────
     let overlayEl = null;
     function clearOverlay() {
@@ -571,9 +657,16 @@ function mountOrb(controller, options = {}) {
             setBubble(false);
             return;
         }
+        // Voice disabled in the dashboard: never listen/speak. Tap opens the keyboard
+        // directly (text turns are silent by default); animations are unchanged.
+        if (!voiceInputEnabled && enableTextInput) {
+            micFallbackActive = false;
+            openTextPanel();
+            return;
+        }
         // `voiceAvailable` is dynamic: the Web Speech API may be present yet the mic
         // denied/blocked, in which case we skip voice and go straight to the keyboard.
-        if (controller.voiceAvailable) {
+        if (controller.voiceAvailable && voiceInputEnabled) {
             micFallbackActive = false;
             void controller.toggleListening();
             return;
@@ -663,6 +756,7 @@ function mountOrb(controller, options = {}) {
             sendBtn.disabled = false;
         }
         syncChip(state);
+        syncThoughtBubble(state);
         if (state.confirmationMessage !== lastConfirm) {
             lastConfirm = state.confirmationMessage;
             if (state.confirmationMessage)
@@ -680,6 +774,26 @@ function mountOrb(controller, options = {}) {
     }
     const unsubscribe = controller.subscribe(render);
     render(controller.getState());
+    // Track the current route so the thought bubble re-resolves its CTA on
+    // navigation. No universal navigation event exists, so poll + listen to
+    // popstate / visibility for snappier updates.
+    const readRoute = () => {
+        let next = null;
+        try {
+            next = controller.config.navigation.getCurrentRoute();
+        }
+        catch {
+            /* navigation read is best-effort */
+        }
+        if (next !== currentRoute) {
+            currentRoute = next;
+            syncThoughtBubble(controller.getState());
+        }
+    };
+    readRoute();
+    const routeTimer = window.setInterval(readRoute, 700);
+    window.addEventListener('popstate', readRoute);
+    document.addEventListener('visibilitychange', readRoute);
     // ── Live dashboard config ────────────────────────────────────────────────────
     const stopWatch = (0, publishedConfig_1.watchPublishedConfig)(controller, {
         pollMs: options.appearancePollMs,
@@ -692,6 +806,9 @@ function mountOrb(controller, options = {}) {
                 publishedAppearance = config.appearance;
                 chipTheme = config.keyboardChip;
                 modalTheme = config.modalTheme;
+                bubbleTheme = config.bubbleTheme;
+                bubbleEnabled = config.bubbleEnabled;
+                voiceInputEnabled = config.voiceInputEnabled;
                 if (usePublishedPosition && config.screenPosition)
                     screenPosition = config.screenPosition;
             }
@@ -702,6 +819,7 @@ function mountOrb(controller, options = {}) {
                 chipEl = null;
             }
             syncChip(controller.getState());
+            syncThoughtBubble(controller.getState());
             if (bubbleOpen)
                 applyBubbleTheme();
         },
@@ -710,6 +828,9 @@ function mountOrb(controller, options = {}) {
         unmount() {
             unsubscribe();
             stopWatch();
+            window.clearInterval(routeTimer);
+            window.removeEventListener('popstate', readRoute);
+            document.removeEventListener('visibilitychange', readRoute);
             window.removeEventListener('resize', reposition);
             contentObserver?.disconnect();
             visualViewport?.removeEventListener('resize', onViewportChange);

package/dist/cjs/orb/publishedConfig.d.ts

@@ -9,7 +9,7 @@
  * mobile — in real time, via polling. So Vue/Svelte/Angular read the dashboard
  * config identically to the reference, instead of ignoring it.
  */
-import { type OrbScreenPosition, type PublishedModalTheme } from '@fiodos/core';
+import { type OrbScreenPosition, type PublishedModalTheme, type ResolvedBubbleTheme } from '@fiodos/core';
 import type { AgentController } from '../controller/AgentController';
 import { type ChipTheme, type OrbAppearance } from './orbView';
 export interface ResolvedOrbConfig {
@@ -17,6 +17,16 @@ export interface ResolvedOrbConfig {
     keyboardChip: ChipTheme | null;
     modalTheme: PublishedModalTheme | undefined;
     screenPosition: OrbScreenPosition | undefined;
+    /** Resolved orb thought-bubble theme (defaults filled). */
+    bubbleTheme: ResolvedBubbleTheme;
+    /** Dashboard on/off for the thought bubble. Default true (absent = enabled). */
+    bubbleEnabled: boolean;
+    /**
+     * Dashboard on/off for the orb's VOICE channel (`voiceInputEnabled`). False
+     * ONLY when the developer turned voice off; then the orb opens the keyboard
+     * directly on tap and never plays TTS. Default true (absent = voice on).
+     */
+    voiceInputEnabled: boolean;
     /**
      * Dashboard master visibility switch (`orbEnabled`). False ONLY when the
      * developer explicitly turned the orb off. The orb is hidden when false and

package/dist/cjs/orb/publishedConfig.js

@@ -14,7 +14,8 @@ exports.watchPublishedConfig = watchPublishedConfig;
  */
 const core_1 = require("@fiodos/core");
 const orbView_1 = require("./orbView");
-function toResolved(props, enabled) {
+function toResolved(props, published) {
+    const enabled = published.orbEnabled !== false;
     const theme = props.theme;
     const appearance = {
         accentColor: theme.accentColor ?? orbView_1.DEFAULT_ORB_APPEARANCE.accentColor,
@@ -33,6 +34,9 @@ function toResolved(props, enabled) {
         keyboardChip: theme.keyboardChip ?? null,
         modalTheme: props.modalTheme,
         screenPosition: props.screenPosition,
+        bubbleTheme: (0, core_1.resolveBubbleTheme)(published.bubbleTheme),
+        bubbleEnabled: published.bubbleEnabled !== false,
+        voiceInputEnabled: published.voiceInputEnabled !== false,
         enabled,
     };
 }
@@ -54,7 +58,7 @@ function watchPublishedConfig(controller, options) {
             if (cancelled)
                 return;
             options.onChange(res.published
-                ? toResolved((0, core_1.mapPublishedConfigToOrbProps)(res.published), res.published.orbEnabled !== false)
+                ? toResolved((0, core_1.mapPublishedConfigToOrbProps)(res.published), res.published)
                 : null);
         }
         catch {

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.5";
+export declare const SDK_VERSION = "0.1.9";
 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.5';
+exports.SDK_VERSION = '0.1.9';
 exports.SDK_PACKAGE = '@fiodos/web-core';

package/dist/esm/adapters/webVoiceAdapter.js

@@ -398,20 +398,40 @@ export function createWebVoiceAdapter(options = {}) {
             // later programmatic playback (after the network round-trip) is allowed
             // and audible even with the silent switch on.
             const ctx = ensureAudioCtx();
-            if (!ctx)
-                return;
-            try {
-                if (ctx.state === 'suspended')
-                    void ctx.resume();
-                // A 1-frame silent buffer fully unlocks playback on iOS Safari.
-                const buffer = ctx.createBuffer(1, 1, ctx.sampleRate);
-                const source = ctx.createBufferSource();
-                source.buffer = buffer;
-                source.connect(ctx.destination);
-                source.start(0);
+            if (ctx) {
+                try {
+                    if (ctx.state === 'suspended')
+                        void ctx.resume();
+                    // A 1-frame silent buffer fully unlocks playback on iOS Safari.
+                    const buffer = ctx.createBuffer(1, 1, ctx.sampleRate);
+                    const source = ctx.createBufferSource();
+                    source.buffer = buffer;
+                    source.connect(ctx.destination);
+                    source.start(0);
+                }
+                catch {
+                    /* best-effort unlock */
+                }
             }
-            catch {
-                /* best-effort unlock */
+            // Unlock device TTS (SpeechSynthesis) too. The spoken reply happens AFTER
+            // the network round-trip — outside this gesture — and Safari/Chrome stay
+            // SILENT for a first programmatic speak that wasn't preceded by a
+            // gesture-initiated one. Warm the engine here: kick off voice loading and
+            // speak a zero-volume blank utterance inside the tap so the real reply is
+            // allowed to play later.
+            if (!options.disableDeviceTtsFallback && typeof window !== 'undefined' && window.speechSynthesis) {
+                try {
+                    const synth = window.speechSynthesis;
+                    synth.getVoices(); // triggers async voice loading on Chrome
+                    if (synth.paused)
+                        synth.resume();
+                    const warm = new SpeechSynthesisUtterance(' ');
+                    warm.volume = 0;
+                    synth.speak(warm);
+                }
+                catch {
+                    /* best-effort unlock */
+                }
             }
         },
         async playAudioBase64Mp3(base64) {
@@ -453,20 +473,32 @@ export function createWebVoiceAdapter(options = {}) {
             // Voices load lazily on Chrome — speaking before they exist is silent.
             const voices = await loadVoicesOnce(synth);
             return new Promise((resolve) => {
+                let keepAlive = null;
+                const cleanup = () => {
+                    if (keepAlive) {
+                        clearInterval(keepAlive);
+                        keepAlive = null;
+                    }
+                };
                 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();
+                    // Clear any previous/wedged queue. After a prior cancel() (e.g. the
+                    // stopPlayback() fired when listening started) Chrome on macOS can sit
+                    // in a stuck "paused" state that does NOT report paused===true, so a
+                    // conditional resume() never fires and every later speak() is silent.
+                    synth.cancel();
                     const utter = new SpeechSynthesisUtterance(text);
                     utter.lang = ttsOptions.locale;
                     const voice = pickVoiceForLocale(voices, ttsOptions.locale);
                     if (voice)
                         utter.voice = voice;
+                    utter.volume = 1;
+                    utter.rate = 1;
+                    utter.pitch = 1;
+                    // Keep a strong ref so Chrome can't GC the utterance mid-speech.
                     ttsUtterance = utter;
                     const finish = () => {
+                        cleanup();
+                        utter.onstart = null;
                         utter.onend = null;
                         utter.onerror = null;
                         if (ttsUtterance === utter)
@@ -476,8 +508,22 @@ export function createWebVoiceAdapter(options = {}) {
                     utter.onend = finish;
                     utter.onerror = finish;
                     synth.speak(utter);
+                    // THE FIX: resume() unconditionally right after queuing. This un-wedges
+                    // the engine from the silent stuck-paused state described above.
+                    synth.resume();
+                    // Chrome desktop stops speaking after ~15s; pulse pause/resume to keep
+                    // long replies going, and stop the timer once it has finished.
+                    keepAlive = setInterval(() => {
+                        if (!synth.speaking && !synth.pending) {
+                            cleanup();
+                            return;
+                        }
+                        synth.pause();
+                        synth.resume();
+                    }, 9000);
                 }
                 catch {
+                    cleanup();
                     resolve();
                 }
             });

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

@@ -75,6 +75,7 @@ export declare class AgentController {
     private watchdog;
     private confirmWindow;
     private speakTimer;
+    private serverTtsUnavailable;
     private pendingConsentIntent;
     private readonly listeners;
     private unsubscribeSpeech;

package/dist/esm/controller/AgentController.js

@@ -15,7 +15,7 @@
  *    deliberate modal tap; a loose "yes" never confirms them.
  *  - The agent only ever executes actions declared in the manifest.
  */
-import { combineContexts, createActionExecutor, createConsentManager, createSafeTelemetry, createSanitizer, createConversationSession, formatMessage, prepareConversationForTurn, recordConversationExchange, resolveConfirmationLexicon, resolveMessages, validateManifest, } from '@fiodos/core';
+import { combineContexts, createActionExecutor, createConsentManager, createSafeTelemetry, createSanitizer, createConversationSession, defaultRouteContextText, formatMessage, prepareConversationForTurn, recordConversationExchange, resolveConfirmationLexicon, resolveMessages, validateManifest, } from '@fiodos/core';
 import { AgentApiError } from '../api/errors.js';
 import { formatAgentTurnError } from '../api/formatTurnError.js';
 import { buildManifestPayload } from '../api/backendClient.js';
@@ -51,6 +51,9 @@ export class AgentController {
         // 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;
+        // Once the backend shows it has no server-side TTS (a reply arrives with null
+        // audio), skip the extra /preview-tts round-trip and speak via device voice.
+        this.serverTtsUnavailable = false;
         this.pendingConsentIntent = null;
         this.listeners = new Set();
         this.unsubscribeSpeech = null;
@@ -87,7 +90,11 @@ export class AgentController {
                 });
         this.screenStore = createScreenContextStore({
             getCurrentRoute: () => config.navigation.getCurrentRoute(),
-            routeFallback: config.routeContextFallback,
+            // The integrator's fallback wins; otherwise the orb gets screen awareness
+            // out of the box from the matched manifest route (label + description +
+            // available actions). Null when no route matches → raw route, as today.
+            routeFallback: config.routeContextFallback ??
+                ((route) => defaultRouteContextText(route, config.manifest, this.messages)),
         });
         this.speech = createSpeechSession({
             adapter: config.voice,
@@ -194,13 +201,20 @@ export class AgentController {
         this.setPhase('speaking');
         try {
             let audio = audioBase64;
-            if (!audio && text) {
-                // A server-TTS failure must NOT skip the device-voice fallback below.
+            if (audio) {
+                this.serverTtsUnavailable = false; // server voice is working
+            }
+            // Once we know the backend ships no server TTS, skip the dead
+            // /preview-tts round-trip (pure latency) and use the device voice.
+            if (!audio && text && !this.serverTtsUnavailable) {
                 try {
                     audio = await this.config.backend.previewTts(this.getTtsVoice() ?? '', text);
+                    if (!audio)
+                        this.serverTtsUnavailable = true;
                 }
                 catch {
                     audio = null;
+                    this.serverTtsUnavailable = true;
                 }
             }
             const playback = audio
@@ -415,6 +429,10 @@ export class AgentController {
             }, { signal: controller.signal });
             reply = turn.reply;
             audioBase64 = turn.audioBase64;
+            // Learn whether this backend ships server-side TTS: a non-empty reply
+            // with no audio means it doesn't — later lines then speak instantly.
+            if (reply)
+                this.serverTtsUnavailable = !audioBase64;
             const decision = await decideAction({
                 action: turn.action,
                 manifest: this.config.manifest,

package/dist/esm/dropin/createFiodosAgent.d.ts

@@ -27,8 +27,12 @@ export interface CreateFiodosAgentOptions {
     manifest?: AppManifest;
     /** Action handlers / context validators (defaults to empty registries). */
     registries?: ActionRegistries;
-    /** Agent reply locale (e.g. 'es', 'en'). Defaults to the browser language. */
+    /** Agent UI locale (e.g. 'en', 'es'). Defaults to `'en'`. */
     locale?: string;
+    /** Live locale resolver — overrides `locale` when set. */
+    getLocale?: () => string;
+    /** Auto-detect locale when `locale` / `getLocale` are unset. Default: none (English). */
+    localeDetection?: 'browser' | 'document';
     /** STT locale (e.g. 'es-ES', 'en-US'). Defaults to the browser language. */
     sttLocale?: string;
     /** Host router navigate delegate. Defaults to location.assign. */

package/dist/esm/dropin/createFiodosAgent.js

@@ -29,10 +29,27 @@ function browserLocale() {
     const lang = typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'en-US';
     return { locale: lang.split('-')[0] || 'en', sttLocale: lang };
 }
+function resolveAgentLocale(options) {
+    const fromApp = options.getLocale?.()?.trim();
+    if (fromApp)
+        return fromApp;
+    if (options.locale?.trim())
+        return options.locale.trim();
+    if (options.localeDetection === 'browser')
+        return browserLocale().locale;
+    if (options.localeDetection === 'document') {
+        const docLang = typeof document !== 'undefined'
+            ? document.documentElement.lang?.split(/[-_]/)[0]?.trim()
+            : '';
+        if (docLang)
+            return docLang;
+    }
+    return 'en';
+}
 /** Build the controller + adapters from a known manifest (shared by both paths). */
 function assemble(options, manifest, baseUrl) {
     const fallback = browserLocale();
-    const locale = options.locale ?? fallback.locale;
+    const locale = resolveAgentLocale(options);
     const sttLocale = options.sttLocale ?? options.locale ?? fallback.sttLocale;
     const backend = createFiodosBackendClient({
         baseUrl,

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, resolveOrbAnchorPx, resolveOrbDeployment, snapOrbScreenPositionToSide, viewportPixelsToOrbScreenPosition, } from '@fiodos/core';
+import { DEFAULT_ORB_SCREEN_POSITION, createWebOrbHaptics, matchRouteIntent, resolveBubblePrompt, resolveBubbleTheme, resolveBubblePadding, resolveBubbleShapeStyle, 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';
@@ -39,6 +39,8 @@ const CSS = `
 .fyodos-bubble-row{display:flex;gap:8px;align-items:flex-end;padding:8px 10px;border-top:1px solid rgba(160,180,220,0.18);}
 .fyodos-bubble-row input{flex:1;border:1px solid rgba(15,23,42,0.12);outline:none;border-radius:10px;padding:9px 11px;font-size:15px;}
 .fyodos-bubble-row button{appearance:none;border:none;flex-shrink:0;display:flex;align-items:center;justify-content:center;width:32px;height:32px;min-width:32px;padding:0;font-size:17px;font-weight:700;line-height:1;color:#000;cursor:pointer;}
+.fyodos-thought{position:absolute;appearance:none;display:inline-block;width:max-content;max-width:min(280px,70vw);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;text-align:left;line-height:1.25;font-weight:500;cursor:pointer;box-shadow:0 8px 24px rgba(0,0,0,0.22);animation:fyodos-thought-in .18s ease-out;}
+@keyframes fyodos-thought-in{from{opacity:0;transform:translateY(4px) scale(0.96)}to{opacity:1;transform:none}}
 @keyframes fyodos-fade-in{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}
 @keyframes fyodos-blink{0%,100%{opacity:.25}50%{opacity:.9}}
 @keyframes fy-spin{to{transform:rotate(360deg)}}
@@ -127,6 +129,12 @@ export function mountOrb(controller, options = {}) {
     let publishedAppearance = null;
     let chipTheme = null;
     let modalTheme;
+    let bubbleTheme = resolveBubbleTheme(null);
+    let bubbleEnabled = true;
+    // Dashboard VOICE switch. Default true (voice on). When false the orb never
+    // listens/speaks: a tap opens the keyboard directly and text turns are silent.
+    let voiceInputEnabled = true;
+    let currentRoute = null;
     let screenPosition = options.corner
         ? cornerToPosition(options.corner)
         : { ...DEFAULT_ORB_SCREEN_POSITION };
@@ -157,6 +165,22 @@ export function mountOrb(controller, options = {}) {
     anchor.appendChild(btn);
     root.appendChild(anchor);
     let chipEl = null;
+    // Thought bubble: a short, screen-aware CTA beside the orb. Created once and
+    // shown/hidden by syncThoughtBubble; tapping it opens the keyboard.
+    const thoughtBubbleEl = document.createElement('button');
+    thoughtBubbleEl.type = 'button';
+    thoughtBubbleEl.className = 'fyodos-thought';
+    thoughtBubbleEl.style.display = 'none';
+    thoughtBubbleEl.addEventListener('click', () => {
+        haptics.trigger('orbTap');
+        controller.primeAudio();
+        if (enableTextInput) {
+            openTextPanel();
+            return;
+        }
+        void controller.toggleListening();
+    });
+    anchor.appendChild(thoughtBubbleEl);
     container.appendChild(root);
     // ── Position (dashboard position; user drag is SESSION-only, never persisted) ─
     // The orb ALWAYS starts at the dashboard-published position on every load.
@@ -206,6 +230,9 @@ export function mountOrb(controller, options = {}) {
                 chipEl.style.right = '';
             }
         }
+        // Keep the thought bubble on the orb's free side too while it is visible.
+        if (thoughtBubbleEl.style.display !== 'none')
+            positionThoughtBubble();
     }
     window.addEventListener('resize', reposition);
     // Recalc when a scrollbar appears/disappears as the page content changes (the
@@ -456,6 +483,65 @@ export function mountOrb(controller, options = {}) {
         anchor.appendChild(chipEl);
         applyDeployment();
     }
+    // ── Thought bubble (screen-aware CTA beside the orb) ─────────────────────────
+    function resolveCurrentBubblePrompt() {
+        return resolveBubblePrompt(matchRouteIntent(currentRoute, controller.config.manifest.routes), controller.messages, { locale: controller.config.locale, actions: controller.config.manifest.actions });
+    }
+    function applyThoughtBubbleTheme() {
+        const t = bubbleTheme;
+        const { fontPx, padV, padH, approxHeight } = resolveBubblePadding(t);
+        const shapeStyle = resolveBubbleShapeStyle(t, approxHeight);
+        thoughtBubbleEl.style.fontSize = `${fontPx}px`;
+        thoughtBubbleEl.style.padding = `${padV}px ${padH}px`;
+        thoughtBubbleEl.style.color = t.textColor;
+        thoughtBubbleEl.style.background = t.backgroundColor;
+        thoughtBubbleEl.style.border = `${t.borderWidth}px solid ${t.borderColor}`;
+        thoughtBubbleEl.style.borderRadius =
+            shapeStyle.borderRadius != null ? `${shapeStyle.borderRadius}px` : '';
+        thoughtBubbleEl.style.borderTopLeftRadius =
+            shapeStyle.borderTopLeftRadius != null ? `${shapeStyle.borderTopLeftRadius}px` : '';
+        thoughtBubbleEl.style.borderTopRightRadius =
+            shapeStyle.borderTopRightRadius != null ? `${shapeStyle.borderTopRightRadius}px` : '';
+        thoughtBubbleEl.style.borderBottomLeftRadius =
+            shapeStyle.borderBottomLeftRadius != null ? `${shapeStyle.borderBottomLeftRadius}px` : '';
+        thoughtBubbleEl.style.borderBottomRightRadius =
+            shapeStyle.borderBottomRightRadius != null ? `${shapeStyle.borderBottomRightRadius}px` : '';
+        thoughtBubbleEl.style.clipPath = shapeStyle.clipPath ?? '';
+    }
+    function positionThoughtBubble() {
+        const dep = resolveOrbDeployment(effectivePosition());
+        if (dep.horizontal === 'left') {
+            thoughtBubbleEl.style.right = 'calc(100% + 10px)';
+            thoughtBubbleEl.style.left = '';
+        }
+        else {
+            thoughtBubbleEl.style.left = 'calc(100% + 10px)';
+            thoughtBubbleEl.style.right = '';
+        }
+        if (dep.vertical === 'up') {
+            thoughtBubbleEl.style.top = '0';
+            thoughtBubbleEl.style.bottom = '';
+            thoughtBubbleEl.style.transform = '';
+        }
+        else {
+            thoughtBubbleEl.style.bottom = '0';
+            thoughtBubbleEl.style.top = '';
+            thoughtBubbleEl.style.transform = '';
+        }
+    }
+    function syncThoughtBubble(state) {
+        const idle = !state.showThinking && !state.showWaveform && state.phase !== 'speaking' && !micFallbackActive;
+        const prompt = bubbleEnabled && !bubbleOpen && idle ? resolveCurrentBubblePrompt() : null;
+        if (!prompt) {
+            thoughtBubbleEl.style.display = 'none';
+            return;
+        }
+        thoughtBubbleEl.textContent = prompt;
+        thoughtBubbleEl.setAttribute('aria-label', ui.orbLabel);
+        applyThoughtBubbleTheme();
+        positionThoughtBubble();
+        thoughtBubbleEl.style.display = 'block';
+    }
     // ── Overlays (confirmation + consent) ────────────────────────────────────────
     let overlayEl = null;
     function clearOverlay() {
@@ -568,9 +654,16 @@ export function mountOrb(controller, options = {}) {
             setBubble(false);
             return;
         }
+        // Voice disabled in the dashboard: never listen/speak. Tap opens the keyboard
+        // directly (text turns are silent by default); animations are unchanged.
+        if (!voiceInputEnabled && enableTextInput) {
+            micFallbackActive = false;
+            openTextPanel();
+            return;
+        }
         // `voiceAvailable` is dynamic: the Web Speech API may be present yet the mic
         // denied/blocked, in which case we skip voice and go straight to the keyboard.
-        if (controller.voiceAvailable) {
+        if (controller.voiceAvailable && voiceInputEnabled) {
             micFallbackActive = false;
             void controller.toggleListening();
             return;
@@ -660,6 +753,7 @@ export function mountOrb(controller, options = {}) {
             sendBtn.disabled = false;
         }
         syncChip(state);
+        syncThoughtBubble(state);
         if (state.confirmationMessage !== lastConfirm) {
             lastConfirm = state.confirmationMessage;
             if (state.confirmationMessage)
@@ -677,6 +771,26 @@ export function mountOrb(controller, options = {}) {
     }
     const unsubscribe = controller.subscribe(render);
     render(controller.getState());
+    // Track the current route so the thought bubble re-resolves its CTA on
+    // navigation. No universal navigation event exists, so poll + listen to
+    // popstate / visibility for snappier updates.
+    const readRoute = () => {
+        let next = null;
+        try {
+            next = controller.config.navigation.getCurrentRoute();
+        }
+        catch {
+            /* navigation read is best-effort */
+        }
+        if (next !== currentRoute) {
+            currentRoute = next;
+            syncThoughtBubble(controller.getState());
+        }
+    };
+    readRoute();
+    const routeTimer = window.setInterval(readRoute, 700);
+    window.addEventListener('popstate', readRoute);
+    document.addEventListener('visibilitychange', readRoute);
     // ── Live dashboard config ────────────────────────────────────────────────────
     const stopWatch = watchPublishedConfig(controller, {
         pollMs: options.appearancePollMs,
@@ -689,6 +803,9 @@ export function mountOrb(controller, options = {}) {
                 publishedAppearance = config.appearance;
                 chipTheme = config.keyboardChip;
                 modalTheme = config.modalTheme;
+                bubbleTheme = config.bubbleTheme;
+                bubbleEnabled = config.bubbleEnabled;
+                voiceInputEnabled = config.voiceInputEnabled;
                 if (usePublishedPosition && config.screenPosition)
                     screenPosition = config.screenPosition;
             }
@@ -699,6 +816,7 @@ export function mountOrb(controller, options = {}) {
                 chipEl = null;
             }
             syncChip(controller.getState());
+            syncThoughtBubble(controller.getState());
             if (bubbleOpen)
                 applyBubbleTheme();
         },
@@ -707,6 +825,9 @@ export function mountOrb(controller, options = {}) {
         unmount() {
             unsubscribe();
             stopWatch();
+            window.clearInterval(routeTimer);
+            window.removeEventListener('popstate', readRoute);
+            document.removeEventListener('visibilitychange', readRoute);
             window.removeEventListener('resize', reposition);
             contentObserver?.disconnect();
             visualViewport?.removeEventListener('resize', onViewportChange);

package/dist/esm/orb/publishedConfig.d.ts

@@ -9,7 +9,7 @@
  * mobile — in real time, via polling. So Vue/Svelte/Angular read the dashboard
  * config identically to the reference, instead of ignoring it.
  */
-import { type OrbScreenPosition, type PublishedModalTheme } from '@fiodos/core';
+import { type OrbScreenPosition, type PublishedModalTheme, type ResolvedBubbleTheme } from '@fiodos/core';
 import type { AgentController } from '../controller/AgentController.js';
 import { type ChipTheme, type OrbAppearance } from './orbView.js';
 export interface ResolvedOrbConfig {
@@ -17,6 +17,16 @@ export interface ResolvedOrbConfig {
     keyboardChip: ChipTheme | null;
     modalTheme: PublishedModalTheme | undefined;
     screenPosition: OrbScreenPosition | undefined;
+    /** Resolved orb thought-bubble theme (defaults filled). */
+    bubbleTheme: ResolvedBubbleTheme;
+    /** Dashboard on/off for the thought bubble. Default true (absent = enabled). */
+    bubbleEnabled: boolean;
+    /**
+     * Dashboard on/off for the orb's VOICE channel (`voiceInputEnabled`). False
+     * ONLY when the developer turned voice off; then the orb opens the keyboard
+     * directly on tap and never plays TTS. Default true (absent = voice on).
+     */
+    voiceInputEnabled: boolean;
     /**
      * Dashboard master visibility switch (`orbEnabled`). False ONLY when the
      * developer explicitly turned the orb off. The orb is hidden when false and

package/dist/esm/orb/publishedConfig.js

@@ -9,9 +9,10 @@
  * mobile — in real time, via polling. So Vue/Svelte/Angular read the dashboard
  * config identically to the reference, instead of ignoring it.
  */
-import { mapPublishedConfigToOrbProps, } from '@fiodos/core';
+import { mapPublishedConfigToOrbProps, resolveBubbleTheme, } from '@fiodos/core';
 import { DEFAULT_ORB_APPEARANCE } from './orbView.js';
-function toResolved(props, enabled) {
+function toResolved(props, published) {
+    const enabled = published.orbEnabled !== false;
     const theme = props.theme;
     const appearance = {
         accentColor: theme.accentColor ?? DEFAULT_ORB_APPEARANCE.accentColor,
@@ -30,6 +31,9 @@ function toResolved(props, enabled) {
         keyboardChip: theme.keyboardChip ?? null,
         modalTheme: props.modalTheme,
         screenPosition: props.screenPosition,
+        bubbleTheme: resolveBubbleTheme(published.bubbleTheme),
+        bubbleEnabled: published.bubbleEnabled !== false,
+        voiceInputEnabled: published.voiceInputEnabled !== false,
         enabled,
     };
 }
@@ -51,7 +55,7 @@ export function watchPublishedConfig(controller, options) {
             if (cancelled)
                 return;
             options.onChange(res.published
-                ? toResolved(mapPublishedConfigToOrbProps(res.published), res.published.orbEnabled !== false)
+                ? toResolved(mapPublishedConfigToOrbProps(res.published), res.published)
                 : null);
         }
         catch {

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.5";
+export declare const SDK_VERSION = "0.1.9";
 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.5';
+export const SDK_VERSION = '0.1.9';
 export const SDK_PACKAGE = '@fiodos/web-core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiodos/web-core",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "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": {
@@ -29,7 +29,7 @@
     "prepublishOnly": "node ../../scripts/sync-sdk-version.mjs && npm run build"
   },
   "dependencies": {
-    "@fiodos/core": "^0.1.0"
+    "@fiodos/core": "^0.1.7"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",