@fiodos/web-core 0.1.2 → 0.1.3

package/dist/cjs/api/formatTurnError.d.ts

@@ -0,0 +1,2 @@
+/** User-visible chat error — shown IN the text bubble, not only in the console. */
+export declare function formatAgentTurnError(err: unknown, locale: string): string;

package/dist/cjs/api/formatTurnError.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAgentTurnError = formatAgentTurnError;
+const errors_1 = require("./errors");
+/** User-visible chat error — shown IN the text bubble, not only in the console. */
+function formatAgentTurnError(err, locale) {
+    const es = locale.startsWith('es');
+    if (err instanceof errors_1.AgentApiError) {
+        switch (err.code) {
+            case 'timeout':
+                return es
+                    ? 'La respuesta tardó demasiado. Comprueba tu conexión e inténtalo de nuevo.'
+                    : 'The response took too long. Check your connection and try again.';
+            case 'network':
+                return es
+                    ? 'No pude conectar con el servidor de Fiodos. ¿Está el backend en marcha y la URL correcta?'
+                    : 'Could not reach the Fiodos server. Is the backend running and the URL correct?';
+            case 'unauthorized':
+                return es
+                    ? 'La API key fue rechazada. Comprueba que coincide con la del proyecto en el dashboard.'
+                    : 'The API key was rejected. Check it matches the project key in your dashboard.';
+            case 'quota_exceeded':
+                return es
+                    ? 'Has alcanzado el límite de uso de IA de tu plan. Mejóralo en el dashboard para seguir.'
+                    : 'You reached your plan\u2019s AI usage limit. Upgrade in the dashboard to continue.';
+            case 'rate_limited':
+                return es
+                    ? 'Demasiadas peticiones seguidas. Espera un momento e inténtalo de nuevo.'
+                    : 'Too many requests. Wait a moment and try again.';
+            case 'server_error':
+                return es
+                    ? 'El servidor no pudo responder. Revisa que la IA esté configurada en el backend.'
+                    : 'The server could not respond. Check that the AI is configured on the backend.';
+            case 'cancelled':
+                return es ? 'Cancelado.' : 'Cancelled.';
+            default:
+                break;
+        }
+        if (err.message && err.message !== err.code)
+            return err.message;
+    }
+    if (err instanceof Error && err.message)
+        return err.message;
+    return es ? 'No pude responder. Inténtalo de nuevo.' : 'I could not reply. Please try again.';
+}

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

@@ -58,6 +58,8 @@ export declare class AgentController {
     private enabled;
     private phase;
     private lastExchange;
+    /** User text for the turn currently in flight (for error/timeout display). */
+    private pendingTurnText;
     private confirmationMessage;
     private confirmationVoiceHint;
     private consentModalVisible;

package/dist/cjs/controller/AgentController.js

@@ -20,6 +20,7 @@ exports.AgentController = void 0;
  */
 const core_1 = require("@fiodos/core");
 const errors_1 = require("../api/errors");
+const formatTurnError_1 = require("../api/formatTurnError");
 const backendClient_1 = require("../api/backendClient");
 const screenContextStore_1 = require("../context/screenContextStore");
 const speechSession_1 = require("../speech/speechSession");
@@ -34,6 +35,8 @@ class AgentController {
         this.enabled = true;
         this.phase = 'idle';
         this.lastExchange = null;
+        /** User text for the turn currently in flight (for error/timeout display). */
+        this.pendingTurnText = null;
         this.confirmationMessage = null;
         this.confirmationVoiceHint = null;
         this.consentModalVisible = false;
@@ -323,11 +326,21 @@ class AgentController {
             return;
         }
         this.setPhase('thinking');
+        this.pendingTurnText = text;
+        this.lastExchange = { userText: text, replyText: '' };
+        this.emit();
         this.clearWatchdog();
         this.watchdog = setTimeout(() => {
             if (this.phase === 'thinking') {
                 this.telemetry.logEvent({ eventType: 'agent_watchdog_reset', sessionId: this.sessionId });
+                const userText = this.pendingTurnText ?? text;
+                const replyText = this.config.locale.startsWith('es')
+                    ? 'La respuesta tardó demasiado. Inténtalo de nuevo.'
+                    : 'The response took too long. Please try again.';
+                this.lastExchange = { userText, replyText };
+                this.pendingTurnText = null;
                 this.setPhase('idle');
+                this.emit();
             }
         }, this.timings.thinkingWatchdogMs);
         const currentRoute = this.config.navigation.getCurrentRoute();
@@ -435,23 +448,36 @@ class AgentController {
             if (e instanceof errors_1.AgentApiError && e.code === 'cancelled') {
                 if (this.phase === 'thinking')
                     this.setPhase('idle');
+                this.pendingTurnText = null;
                 return;
             }
             if (e instanceof errors_1.AgentApiError && e.code === 'quota_exceeded') {
                 this.config.onQuotaExceeded?.();
             }
+            const errMsg = (0, formatTurnError_1.formatAgentTurnError)(e, this.config.locale);
+            this.lastExchange = { userText: text, replyText: errMsg };
+            this.pendingTurnText = null;
             if (this.phase === 'thinking')
                 this.setPhase('idle');
-            this.notifyError(reply || (e instanceof Error ? e.message : 'error'));
+            this.emit();
+            this.notifyError(errMsg);
             return;
         }
         this.clearWatchdog();
         this.abort = null;
+        this.pendingTurnText = null;
         if (reply) {
             this.lastExchange = { userText: text, replyText: reply };
             this.emit();
             (0, core_1.recordConversationExchange)(this.conversation, text, reply);
         }
+        else {
+            const fallback = this.config.locale.startsWith('es')
+                ? 'No recibí respuesta del servidor. Inténtalo de nuevo.'
+                : 'No reply from the server. Please try again.';
+            this.lastExchange = { userText: text, replyText: fallback };
+            this.emit();
+        }
         const hasPending = this.pending != null;
         await this.speakReply(reply, audioBase64);
         if (hasPending) {

package/dist/cjs/orb/mountOrb.js

@@ -661,6 +661,10 @@ function mountOrb(controller, options = {}) {
     const stopWatch = (0, publishedConfig_1.watchPublishedConfig)(controller, {
         pollMs: options.appearancePollMs,
         onChange: (config) => {
+            // Dashboard master switch: hide the whole orb (button + chip + bubble live
+            // inside `root`) when explicitly turned off, show it otherwise. No host
+            // code change — it flips on the next poll and reappears when re-enabled.
+            root.style.display = config && config.enabled === false ? 'none' : '';
             if (config) {
                 publishedAppearance = config.appearance;
                 chipTheme = config.keyboardChip;

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

@@ -17,6 +17,12 @@ export interface ResolvedOrbConfig {
     keyboardChip: ChipTheme | null;
     modalTheme: PublishedModalTheme | undefined;
     screenPosition: OrbScreenPosition | undefined;
+    /**
+     * Dashboard master visibility switch (`orbEnabled`). False ONLY when the
+     * developer explicitly turned the orb off. The orb is hidden when false and
+     * shown otherwise (including when nothing is published / on error).
+     */
+    enabled: boolean;
 }
 export interface WatchPublishedConfigOptions {
     /** Poll interval (ms) to pick up dashboard changes in real time. Default 12000. */

package/dist/cjs/orb/publishedConfig.js

@@ -14,7 +14,7 @@ exports.watchPublishedConfig = watchPublishedConfig;
  */
 const core_1 = require("@fiodos/core");
 const orbView_1 = require("./orbView");
-function toResolved(props) {
+function toResolved(props, enabled) {
     const theme = props.theme;
     const appearance = {
         accentColor: theme.accentColor ?? orbView_1.DEFAULT_ORB_APPEARANCE.accentColor,
@@ -33,6 +33,7 @@ function toResolved(props) {
         keyboardChip: theme.keyboardChip ?? null,
         modalTheme: props.modalTheme,
         screenPosition: props.screenPosition,
+        enabled,
     };
 }
 /**
@@ -52,7 +53,9 @@ function watchPublishedConfig(controller, options) {
             const res = await fetcher.call(controller.config.backend);
             if (cancelled)
                 return;
-            options.onChange(res.published ? toResolved((0, core_1.mapPublishedConfigToOrbProps)(res.published)) : null);
+            options.onChange(res.published
+                ? toResolved((0, core_1.mapPublishedConfigToOrbProps)(res.published), res.published.orbEnabled !== false)
+                : null);
         }
         catch {
             if (!cancelled)

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

package/dist/esm/api/formatTurnError.d.ts

@@ -0,0 +1,2 @@
+/** User-visible chat error — shown IN the text bubble, not only in the console. */
+export declare function formatAgentTurnError(err: unknown, locale: string): string;

package/dist/esm/api/formatTurnError.js

@@ -0,0 +1,42 @@
+import { AgentApiError } from './errors.js';
+/** User-visible chat error — shown IN the text bubble, not only in the console. */
+export function formatAgentTurnError(err, locale) {
+    const es = locale.startsWith('es');
+    if (err instanceof AgentApiError) {
+        switch (err.code) {
+            case 'timeout':
+                return es
+                    ? 'La respuesta tardó demasiado. Comprueba tu conexión e inténtalo de nuevo.'
+                    : 'The response took too long. Check your connection and try again.';
+            case 'network':
+                return es
+                    ? 'No pude conectar con el servidor de Fiodos. ¿Está el backend en marcha y la URL correcta?'
+                    : 'Could not reach the Fiodos server. Is the backend running and the URL correct?';
+            case 'unauthorized':
+                return es
+                    ? 'La API key fue rechazada. Comprueba que coincide con la del proyecto en el dashboard.'
+                    : 'The API key was rejected. Check it matches the project key in your dashboard.';
+            case 'quota_exceeded':
+                return es
+                    ? 'Has alcanzado el límite de uso de IA de tu plan. Mejóralo en el dashboard para seguir.'
+                    : 'You reached your plan\u2019s AI usage limit. Upgrade in the dashboard to continue.';
+            case 'rate_limited':
+                return es
+                    ? 'Demasiadas peticiones seguidas. Espera un momento e inténtalo de nuevo.'
+                    : 'Too many requests. Wait a moment and try again.';
+            case 'server_error':
+                return es
+                    ? 'El servidor no pudo responder. Revisa que la IA esté configurada en el backend.'
+                    : 'The server could not respond. Check that the AI is configured on the backend.';
+            case 'cancelled':
+                return es ? 'Cancelado.' : 'Cancelled.';
+            default:
+                break;
+        }
+        if (err.message && err.message !== err.code)
+            return err.message;
+    }
+    if (err instanceof Error && err.message)
+        return err.message;
+    return es ? 'No pude responder. Inténtalo de nuevo.' : 'I could not reply. Please try again.';
+}

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

@@ -58,6 +58,8 @@ export declare class AgentController {
     private enabled;
     private phase;
     private lastExchange;
+    /** User text for the turn currently in flight (for error/timeout display). */
+    private pendingTurnText;
     private confirmationMessage;
     private confirmationVoiceHint;
     private consentModalVisible;

package/dist/esm/controller/AgentController.js

@@ -17,6 +17,7 @@
  */
 import { combineContexts, createActionExecutor, createConsentManager, createSafeTelemetry, createSanitizer, createConversationSession, 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';
 import { createScreenContextStore, } from '../context/screenContextStore.js';
 import { createSpeechSession } from '../speech/speechSession.js';
@@ -31,6 +32,8 @@ export class AgentController {
         this.enabled = true;
         this.phase = 'idle';
         this.lastExchange = null;
+        /** User text for the turn currently in flight (for error/timeout display). */
+        this.pendingTurnText = null;
         this.confirmationMessage = null;
         this.confirmationVoiceHint = null;
         this.consentModalVisible = false;
@@ -320,11 +323,21 @@ export class AgentController {
             return;
         }
         this.setPhase('thinking');
+        this.pendingTurnText = text;
+        this.lastExchange = { userText: text, replyText: '' };
+        this.emit();
         this.clearWatchdog();
         this.watchdog = setTimeout(() => {
             if (this.phase === 'thinking') {
                 this.telemetry.logEvent({ eventType: 'agent_watchdog_reset', sessionId: this.sessionId });
+                const userText = this.pendingTurnText ?? text;
+                const replyText = this.config.locale.startsWith('es')
+                    ? 'La respuesta tardó demasiado. Inténtalo de nuevo.'
+                    : 'The response took too long. Please try again.';
+                this.lastExchange = { userText, replyText };
+                this.pendingTurnText = null;
                 this.setPhase('idle');
+                this.emit();
             }
         }, this.timings.thinkingWatchdogMs);
         const currentRoute = this.config.navigation.getCurrentRoute();
@@ -432,23 +445,36 @@ export class AgentController {
             if (e instanceof AgentApiError && e.code === 'cancelled') {
                 if (this.phase === 'thinking')
                     this.setPhase('idle');
+                this.pendingTurnText = null;
                 return;
             }
             if (e instanceof AgentApiError && e.code === 'quota_exceeded') {
                 this.config.onQuotaExceeded?.();
             }
+            const errMsg = formatAgentTurnError(e, this.config.locale);
+            this.lastExchange = { userText: text, replyText: errMsg };
+            this.pendingTurnText = null;
             if (this.phase === 'thinking')
                 this.setPhase('idle');
-            this.notifyError(reply || (e instanceof Error ? e.message : 'error'));
+            this.emit();
+            this.notifyError(errMsg);
             return;
         }
         this.clearWatchdog();
         this.abort = null;
+        this.pendingTurnText = null;
         if (reply) {
             this.lastExchange = { userText: text, replyText: reply };
             this.emit();
             recordConversationExchange(this.conversation, text, reply);
         }
+        else {
+            const fallback = this.config.locale.startsWith('es')
+                ? 'No recibí respuesta del servidor. Inténtalo de nuevo.'
+                : 'No reply from the server. Please try again.';
+            this.lastExchange = { userText: text, replyText: fallback };
+            this.emit();
+        }
         const hasPending = this.pending != null;
         await this.speakReply(reply, audioBase64);
         if (hasPending) {

package/dist/esm/orb/mountOrb.js

@@ -658,6 +658,10 @@ export function mountOrb(controller, options = {}) {
     const stopWatch = watchPublishedConfig(controller, {
         pollMs: options.appearancePollMs,
         onChange: (config) => {
+            // Dashboard master switch: hide the whole orb (button + chip + bubble live
+            // inside `root`) when explicitly turned off, show it otherwise. No host
+            // code change — it flips on the next poll and reappears when re-enabled.
+            root.style.display = config && config.enabled === false ? 'none' : '';
             if (config) {
                 publishedAppearance = config.appearance;
                 chipTheme = config.keyboardChip;

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

@@ -17,6 +17,12 @@ export interface ResolvedOrbConfig {
     keyboardChip: ChipTheme | null;
     modalTheme: PublishedModalTheme | undefined;
     screenPosition: OrbScreenPosition | undefined;
+    /**
+     * Dashboard master visibility switch (`orbEnabled`). False ONLY when the
+     * developer explicitly turned the orb off. The orb is hidden when false and
+     * shown otherwise (including when nothing is published / on error).
+     */
+    enabled: boolean;
 }
 export interface WatchPublishedConfigOptions {
     /** Poll interval (ms) to pick up dashboard changes in real time. Default 12000. */

package/dist/esm/orb/publishedConfig.js

@@ -11,7 +11,7 @@
  */
 import { mapPublishedConfigToOrbProps, } from '@fiodos/core';
 import { DEFAULT_ORB_APPEARANCE } from './orbView.js';
-function toResolved(props) {
+function toResolved(props, enabled) {
     const theme = props.theme;
     const appearance = {
         accentColor: theme.accentColor ?? DEFAULT_ORB_APPEARANCE.accentColor,
@@ -30,6 +30,7 @@ function toResolved(props) {
         keyboardChip: theme.keyboardChip ?? null,
         modalTheme: props.modalTheme,
         screenPosition: props.screenPosition,
+        enabled,
     };
 }
 /**
@@ -49,7 +50,9 @@ export function watchPublishedConfig(controller, options) {
             const res = await fetcher.call(controller.config.backend);
             if (cancelled)
                 return;
-            options.onChange(res.published ? toResolved(mapPublishedConfigToOrbProps(res.published)) : null);
+            options.onChange(res.published
+                ? toResolved(mapPublishedConfigToOrbProps(res.published), res.published.orbEnabled !== false)
+                : null);
         }
         catch {
             if (!cancelled)

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiodos/web-core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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": {