@fiodos/web-core 0.1.11 → 0.1.14

package/dist/esm/embed/dynamics.js

@@ -0,0 +1,168 @@
+// ── Value normalization ──────────────────────────────────────────────────────
+const MAX_VALUE_CHARS = 120;
+function clip(text) {
+    const t = text.trim();
+    return t.length > MAX_VALUE_CHARS ? `${t.slice(0, MAX_VALUE_CHARS - 1)}…` : t;
+}
+/** Lookup values arrive as [{ id, name, entityType }] — show the names. */
+function lookupNames(value) {
+    const names = value
+        .map((v) => v && typeof v === 'object' && typeof v.name === 'string'
+        ? (v.name)
+        : null)
+        .filter((n) => !!n);
+    return names.length ? names.join(', ') : null;
+}
+function normalizeAttributeValue(attribute) {
+    // Optionset / lookup / boolean attributes carry a human label — prefer it.
+    try {
+        const text = attribute.getText?.();
+        if (typeof text === 'string' && text.trim())
+            return clip(text);
+        if (Array.isArray(text) && text.length)
+            return clip(text.join(', '));
+    }
+    catch {
+        /* some attribute types throw on getText — fall through to raw value */
+    }
+    let value;
+    try {
+        value = attribute.getValue();
+    }
+    catch {
+        return null;
+    }
+    if (value == null)
+        return null;
+    if (typeof value === 'string')
+        return value.trim() ? clip(value) : null;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        const names = lookupNames(value);
+        return names ? clip(names) : null;
+    }
+    return null; // collections / unknown object shapes are skipped, never guessed
+}
+/** "{1D2C…}" → "1d2c…" (Web API URLs want bare lowercase GUIDs). */
+export function normalizeDynamicsId(rawId) {
+    return rawId.replace(/[{}]/g, '').trim().toLowerCase();
+}
+// ── Snapshot builder ─────────────────────────────────────────────────────────
+/**
+ * Builds the AgentScreenSnapshot for the current form state, or null when
+ * there is nothing referenceable yet (create form: no record id).
+ */
+export function dynamicsFormSnapshot(formContext, options = {}) {
+    const entity = formContext.data?.entity;
+    if (!entity)
+        return null;
+    const entityName = entity.getEntityName();
+    const recordId = normalizeDynamicsId(entity.getId() ?? '');
+    const allowlist = options.attributes?.length
+        ? new Set(options.attributes.map((a) => a.trim().toLowerCase()).filter(Boolean))
+        : null;
+    const maxAttributes = options.maxAttributes ?? 12;
+    const fields = {};
+    let count = 0;
+    entity.attributes?.forEach((attribute) => {
+        let name;
+        try {
+            name = attribute.getName();
+        }
+        catch {
+            return;
+        }
+        if (!name)
+            return;
+        if (allowlist) {
+            if (!allowlist.has(name.toLowerCase()))
+                return;
+        }
+        else if (count >= maxAttributes) {
+            return;
+        }
+        const value = normalizeAttributeValue(attribute);
+        if (value == null)
+            return;
+        fields[name] = value;
+        count += 1;
+    });
+    let title;
+    try {
+        title = entity.getPrimaryAttributeValue?.() ?? undefined;
+    }
+    catch {
+        title = undefined;
+    }
+    // Create forms have no id yet: the agent can still SEE the fields, but there
+    // is no target for execute actions, so we publish text-only context.
+    const item = recordId
+        ? { id: recordId, kind: entityName, title, metadata: fields }
+        : null;
+    const fieldSummary = Object.entries(fields)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join('; ');
+    const textParts = [
+        `Dynamics 365 form — entity "${entityName}"`,
+        recordId ? `record "${title ?? recordId}" (id ${recordId})` : 'new record (not saved yet)',
+    ];
+    if (fieldSummary)
+        textParts.push(`Fields: ${fieldSummary}`);
+    const context = {
+        ...(item ? { visibleContent: { items: [item], focusedIndex: 0 } } : {}),
+        custom: {
+            platform: 'dynamics365',
+            entityName,
+            ...(recordId ? { recordId } : {}),
+            ...(typeof formContext.ui?.getFormType === 'function'
+                ? { formType: formContext.ui.getFormType() }
+                : {}),
+        },
+    };
+    return { kind: `dynamics-form:${entityName}`, text: textParts.join('. '), context };
+}
+/**
+ * Publishes the form snapshot now, republishes after every save (when the
+ * form exposes OnPostSave), and clears the context on disconnect. Call it from
+ * the form's OnLoad handler.
+ */
+export function connectDynamicsFormContext(agent, formContext, options = {}) {
+    let disconnected = false;
+    const publish = () => {
+        if (disconnected)
+            return;
+        const snapshot = dynamicsFormSnapshot(formContext, options);
+        if (snapshot)
+            agent.setScreenContext(snapshot);
+        else
+            agent.clearScreenContext();
+    };
+    publish();
+    const entity = formContext.data?.entity;
+    if (entity?.addOnPostSave) {
+        try {
+            entity.addOnPostSave(publish);
+        }
+        catch {
+            /* older clients — the host can still call refresh() manually */
+        }
+    }
+    return {
+        refresh: publish,
+        disconnect() {
+            if (disconnected)
+                return;
+            disconnected = true;
+            try {
+                entity?.removeOnPostSave?.(publish);
+            }
+            catch {
+                /* best-effort unsubscribe */
+            }
+            agent.clearScreenContext();
+        },
+    };
+}

package/dist/esm/embed/global.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Embed entrypoint — single-file IIFE bundle for CLOSED third-party hosts
+ * where npm/ESM is not available: Dynamics 365 web resources, WinCC Unified
+ * Custom Web Controls, Salesforce LWC iframes, plain <script> tags.
+ *
+ * Built by `npm run build:embed` into dist/embed/fiodos-embed.js and exposed
+ * as the `Fiodos` global:
+ *
+ *   <script src="fiodos-embed.js"></script>
+ *   <script>
+ *     const agent = Fiodos.createFiodosAgent({
+ *       manifest,                                   // e.g. from `fiodos from-odata`
+ *       registries: Fiodos.buildApiActionRegistries(manifest, {
+ *         baseUrl: 'https://org.crm.dynamics.com/api/data/v9.2',
+ *         authProviders: { dataverse: () => ({ Authorization: `Bearer ${token}` }) },
+ *       }),
+ *     });
+ *   </script>
+ *
+ * The bundle is self-contained (core + web-core inlined) and side-effect-free
+ * beyond assigning the global — it never auto-mounts; the host decides when.
+ */
+import { createFiodosAgent } from '../dropin/createFiodosAgent.js';
+import { mountOrb } from '../orb/mountOrb.js';
+import { AgentController } from '../controller/AgentController.js';
+import { createScreenContextStore } from '../context/screenContextStore.js';
+import { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId } from './dynamics.js';
+import { buildApiActionRegistries, validateManifest } from '@fiodos/core';
+declare const api: {
+    readonly version: "0.1.14";
+    readonly createFiodosAgent: typeof createFiodosAgent;
+    readonly mountOrb: typeof mountOrb;
+    readonly AgentController: typeof AgentController;
+    readonly createScreenContextStore: typeof createScreenContextStore;
+    readonly buildApiActionRegistries: typeof buildApiActionRegistries;
+    readonly validateManifest: typeof validateManifest;
+    readonly connectDynamicsFormContext: typeof connectDynamicsFormContext;
+    readonly dynamicsFormSnapshot: typeof dynamicsFormSnapshot;
+    readonly normalizeDynamicsId: typeof normalizeDynamicsId;
+};
+declare global {
+    var Fiodos: typeof api | undefined;
+}
+export type FiodosEmbedApi = typeof api;
+export {};

package/dist/esm/embed/global.js

@@ -0,0 +1,46 @@
+/**
+ * Embed entrypoint — single-file IIFE bundle for CLOSED third-party hosts
+ * where npm/ESM is not available: Dynamics 365 web resources, WinCC Unified
+ * Custom Web Controls, Salesforce LWC iframes, plain <script> tags.
+ *
+ * Built by `npm run build:embed` into dist/embed/fiodos-embed.js and exposed
+ * as the `Fiodos` global:
+ *
+ *   <script src="fiodos-embed.js"></script>
+ *   <script>
+ *     const agent = Fiodos.createFiodosAgent({
+ *       manifest,                                   // e.g. from `fiodos from-odata`
+ *       registries: Fiodos.buildApiActionRegistries(manifest, {
+ *         baseUrl: 'https://org.crm.dynamics.com/api/data/v9.2',
+ *         authProviders: { dataverse: () => ({ Authorization: `Bearer ${token}` }) },
+ *       }),
+ *     });
+ *   </script>
+ *
+ * The bundle is self-contained (core + web-core inlined) and side-effect-free
+ * beyond assigning the global — it never auto-mounts; the host decides when.
+ */
+import { createFiodosAgent } from '../dropin/createFiodosAgent.js';
+import { mountOrb } from '../orb/mountOrb.js';
+import { AgentController } from '../controller/AgentController.js';
+import { createScreenContextStore } from '../context/screenContextStore.js';
+import { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId, } from './dynamics.js';
+import { SDK_VERSION } from '../version.js';
+import { buildApiActionRegistries, validateManifest } from '@fiodos/core';
+const api = {
+    version: SDK_VERSION,
+    createFiodosAgent,
+    mountOrb,
+    AgentController,
+    createScreenContextStore,
+    // Closed-software mode: turn ApiExecutionSpec manifests into live handlers,
+    // and validate hand-written / from-odata manifests before mounting.
+    buildApiActionRegistries,
+    validateManifest,
+    // Context bridges: tell the orb what the host is showing. Dynamics gets a
+    // dedicated mapper (formContext); any other host calls agent.setScreenContext.
+    connectDynamicsFormContext,
+    dynamicsFormSnapshot,
+    normalizeDynamicsId,
+};
+globalThis.Fiodos = api;

package/dist/esm/index.d.ts

@@ -26,6 +26,7 @@ export { createWebNavigationAdapter, BACK_ROUTE, } from './adapters/webNavigatio
 export type { WebNavigationAdapter, WebNavigationAdapterOptions, } from './adapters/webNavigationAdapter.js';
 export { createWebVoiceAdapter } from './adapters/webVoiceAdapter.js';
 export type { WebVoiceAdapterOptions } from './adapters/webVoiceAdapter.js';
+export { createWebCredentialAutofillAdapter } from './adapters/webCredentialAutofillAdapter.js';
 export { createFiodosBackendClient, buildManifestPayload } from './api/backendClient.js';
 export type { FiodosBackendClientOptions } from './api/backendClient.js';
 export { createFiodosTelemetry } from './api/backendTelemetry.js';
@@ -36,6 +37,8 @@ export { createBridge } from './bridge/createBridge.js';
 export type { Bridge } from './bridge/createBridge.js';
 export { createScreenContextStore } from './context/screenContextStore.js';
 export type { ScreenContextStore, AgentScreenSnapshot } from './context/screenContextStore.js';
+export { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId, } from './embed/dynamics.js';
+export type { DynamicsFormContextLike, DynamicsSnapshotOptions, DynamicsContextBridge, ScreenContextSink, } from './embed/dynamics.js';
 export { createSpeechSession } from './speech/speechSession.js';
 export type { SpeechSession, SpeechSessionOptions, SpeechSessionState, SpeechSessionSnapshot, } from './speech/speechSession.js';
 export { DEFAULT_AGENT_TIMINGS, DEFAULT_AGENT_CHAINING } from './config/types.js';

package/dist/esm/index.js

@@ -23,6 +23,7 @@ export { watchPublishedConfig } from './orb/publishedConfig.js';
 export { createWebStorageAdapter } from './adapters/webStorageAdapter.js';
 export { createWebNavigationAdapter, BACK_ROUTE, } from './adapters/webNavigationAdapter.js';
 export { createWebVoiceAdapter } from './adapters/webVoiceAdapter.js';
+export { createWebCredentialAutofillAdapter } from './adapters/webCredentialAutofillAdapter.js';
 // ── Backend + telemetry (same wire contract as every platform) ────────────────
 export { createFiodosBackendClient, buildManifestPayload } from './api/backendClient.js';
 export { createFiodosTelemetry } from './api/backendTelemetry.js';
@@ -31,6 +32,8 @@ export { AgentApiError, isAgentApiError } from './api/errors.js';
 export { createBridge } from './bridge/createBridge.js';
 // ── Screen context ────────────────────────────────────────────────────────────
 export { createScreenContextStore } from './context/screenContextStore.js';
+// ── Closed-host context adapters (embed mode) ─────────────────────────────────
+export { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId, } from './embed/dynamics.js';
 // ── Speech session ──────────────────────────────────────────────────────────────
 export { createSpeechSession } from './speech/speechSession.js';
 // ── Config / i18n ─────────────────────────────────────────────────────────────

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, matchRouteIntent, resolveBubblePrompt, bubblePromptToAffirmative, resolveBubbleTheme, resolveBubblePadding, bubbleShapeToCss, resolveOrbAnchorPx, resolveOrbDeployment, snapOrbScreenPositionToSide, viewportPixelsToOrbScreenPosition, fiodosInputInkColor, fiodosInputMutedInkColor, shouldHideInternalOrb, } from '@fiodos/core';
+import { DEFAULT_ORB_SCREEN_POSITION, createWebOrbHaptics, matchRouteIntent, resolveBubblePrompt, bubblePromptToAffirmative, resolveBubbleTheme, resolveBubblePadding, bubbleShapeToCss, applyBubbleShapeCss, resolveOrbAnchorPx, resolveOrbDeployment, snapOrbScreenPositionToSide, viewportPixelsToOrbScreenPosition, fiodosInputInkColor, fiodosInputMutedInkColor, shouldHideInternalOrb, } from '@fiodos/core';
 import { buildKeyboardChip, createOrbVisual, DEFAULT_ORB_APPEARANCE, } from './orbView.js';
 import { watchPublishedConfig } from './publishedConfig.js';
 import { createBubbleDictation, scrollTextInputToEnd } from '../speech/bubbleDictation.js';
@@ -27,8 +27,23 @@ const CSS = `
 .fyodos-orb-btn img{pointer-events:none;-webkit-user-drag:none;user-select:none;}
 .fyodos-orb-btn:focus-visible{outline:2px solid #8ab6ff;outline-offset:4px;border-radius:50%;}
 .fyodos-orb-anchor{position:relative;display:inline-flex;}
-.fyodos-bubble{position:absolute;display:flex;flex-direction:column;width:min(320px,calc(100vw - 48px));max-height:340px;overflow:hidden;border-radius:16px;box-shadow:0 16px 40px rgba(0,0,0,0.28);border:1px solid rgba(160,180,220,0.22);animation:fyodos-fade-in .14s ease-out;}
-.fyodos-bubble-close{position:absolute;top:4px;right:6px;z-index:1;display:flex;align-items:center;justify-content:center;border:none;background:transparent;font-size:18px;line-height:18px;width:28px;height:28px;cursor:pointer;padding:0;opacity:.75;}
+.fyodos-bubble{position:absolute;display:flex;flex-direction:column;width:min(320px,calc(100vw - 48px));max-height:340px;overflow:hidden;border-radius:16px;box-shadow:0 16px 40px rgba(0,0,0,0.28);border:1px solid rgba(160,180,220,0.22);animation:fyodos-fade-in .14s ease-out;transition:width .25s cubic-bezier(0.22,1,0.36,1),max-height .25s cubic-bezier(0.22,1,0.36,1);cursor:zoom-in;}
+.fyodos-bubble--expanded{width:min(560px,calc(100vw - 32px));max-height:min(620px,75vh);cursor:auto;}
+.fyodos-bubble-user,.fyodos-bubble-reply{cursor:text;}
+.fyodos-bubble-row{cursor:default;}
+.fyodos-bubble--expanded .fyodos-bubble-scroll{padding:22px 24px 8px;gap:10px;}
+.fyodos-bubble--expanded .fyodos-bubble-exchanges{gap:14px;}
+.fyodos-bubble--expanded .fyodos-bubble-exchange{gap:9px;}
+.fyodos-bubble--expanded .fyodos-bubble-exchange:first-child .fyodos-bubble-user{padding-right:0;}
+.fyodos-bubble--expanded .fyodos-bubble-user{font-size:14.5px;line-height:21px;}
+.fyodos-bubble--expanded .fyodos-bubble-reply{font-size:17px;line-height:25px;}
+.fyodos-bubble--expanded .fyodos-bubble-row{padding:12px 16px;gap:10px;}
+.fyodos-bubble--expanded .fyodos-bubble-busy{padding:8px 24px;}
+.fyodos-bubble--expanded .fyodos-bubble-row input{padding:12px 14px;font-size:16px;}
+.fyodos-bubble--expanded .fyodos-bubble-mic,.fyodos-bubble--expanded .fyodos-bubble-row button{width:38px;height:38px;min-width:38px;font-size:19px;}
+.fyodos-bubble-close,.fyodos-bubble-unexpand{position:absolute;top:4px;z-index:1;display:flex;align-items:center;justify-content:center;border:none;background:transparent;font-size:18px;line-height:18px;width:28px;height:28px;cursor:pointer;padding:0;opacity:.75;}
+.fyodos-bubble-close{right:6px;}
+.fyodos-bubble-unexpand{right:38px;display:none;}
 .fyodos-bubble-user-row{display:flex;flex-direction:row;align-items:flex-start;gap:6px;}
 .fyodos-bubble-scroll{overflow-y:auto;padding:12px 14px 4px;display:flex;flex-direction:column;gap:6px;min-height:18px;scrollbar-width:none;-ms-overflow-style:none;}
 .fyodos-bubble-scroll::-webkit-scrollbar{display:none;width:0;height:0;}
@@ -370,6 +385,11 @@ export function mountOrb(controller, options = {}) {
     btn.addEventListener('lostpointercapture', onPointerUp);
     // ── Text bubble ─────────────────────────────────────────────────────────────
     let bubbleOpen = false;
+    // Reduced (default) size stays exactly as before. Tapping any EMPTY area of
+    // the panel (not a message, not the input row, not a button — so text stays
+    // selectable/copyable) grows it to the expanded layout; shrinking back is an
+    // explicit tap on `unexpandBtn` next to the close button.
+    let bubbleExpanded = false;
     // When the mic is denied/unavailable, tapping the orb still puts it in the
     // SAME "active/listening" visual state and reveals the keyboard chip — the
     // user is never blocked, text is always an open avenue (Change 1).
@@ -406,6 +426,19 @@ export function mountOrb(controller, options = {}) {
     closeBtn.textContent = '×';
     closeBtn.setAttribute('aria-label', 'Close');
     closeBtn.addEventListener('click', () => setBubble(false));
+    // Collapse button — only shown while expanded, right next to the close
+    // button (same minimalist style). Tapping an empty area of the panel is
+    // what EXPANDS it; shrinking back is always an explicit, discoverable tap.
+    const unexpandBtn = document.createElement('button');
+    unexpandBtn.type = 'button';
+    unexpandBtn.className = 'fyodos-bubble-unexpand';
+    unexpandBtn.innerHTML =
+        '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 14h6v6M20 10h-6V4M14 10l7-7M3 21l7-7"></path></svg>';
+    unexpandBtn.setAttribute('aria-label', 'Collapse');
+    unexpandBtn.addEventListener('click', (e) => {
+        e.stopPropagation();
+        setBubbleExpanded(false);
+    });
     // Loading row shown at the top while an older page of the session history
     // streams in (scroll-to-top pagination).
     const loaderRow = document.createElement('div');
@@ -559,8 +592,71 @@ export function mountOrb(controller, options = {}) {
         micBtn.setAttribute('aria-label', active ? ui.micStopLabel : ui.micLabel);
         micBtn.title = active ? ui.micStopLabel : ui.micLabel;
     }
-    bubble.append(closeBtn, exchangeScroll, busyRow, inputRow);
+    bubble.append(closeBtn, unexpandBtn, exchangeScroll, busyRow, inputRow);
     anchor.appendChild(bubble);
+    function setBubbleExpanded(expanded) {
+        if (bubbleExpanded === expanded)
+            return;
+        bubbleExpanded = expanded;
+        bubble.classList.toggle('fyodos-bubble--expanded', expanded);
+        unexpandBtn.style.display = expanded ? 'flex' : 'none';
+        positionBubble();
+    }
+    // Tap-to-expand: a plain click on the panel grows it. Text selection is
+    // never broken: a drag-selection is a move (threshold guard), a double/
+    // triple-click word/paragraph selection cancels the pending expand (detail
+    // guard + delay), and any active selection blocks it. Controls (input row,
+    // buttons) never expand.
+    let bubbleTapX = 0;
+    let bubbleTapY = 0;
+    let pendingExpandTimer = null;
+    const TAP_MOVE_THRESHOLD = 8;
+    const hasActiveSelection = () => {
+        const selection = typeof window !== 'undefined' ? window.getSelection?.() : null;
+        return !!selection && !selection.isCollapsed && selection.toString().length > 0;
+    };
+    const cancelPendingExpand = () => {
+        if (pendingExpandTimer != null) {
+            window.clearTimeout(pendingExpandTimer);
+            pendingExpandTimer = null;
+        }
+    };
+    bubble.addEventListener('pointerdown', (e) => {
+        bubbleTapX = e.clientX;
+        bubbleTapY = e.clientY;
+    });
+    bubble.addEventListener('click', (e) => {
+        if (bubbleExpanded)
+            return;
+        const target = e.target;
+        if (target?.closest('.fyodos-bubble-row, .fyodos-bubble-close, .fyodos-bubble-unexpand, button, input, a')) {
+            return;
+        }
+        const moved = Math.hypot(e.clientX - bubbleTapX, e.clientY - bubbleTapY);
+        if (moved > TAP_MOVE_THRESHOLD)
+            return;
+        // Double/triple click is a word/paragraph selection gesture, never expand
+        // (it also cancels the pending expand from its own first click).
+        if (e.detail > 1) {
+            cancelPendingExpand();
+            return;
+        }
+        cancelPendingExpand();
+        const overText = !!target?.closest('.fyodos-bubble-user, .fyodos-bubble-reply');
+        if (!overText && !hasActiveSelection()) {
+            // Genuinely empty area, nothing selected — expand immediately.
+            setBubbleExpanded(true);
+            return;
+        }
+        // Over message text, or a selection may still be collapsing: expand after
+        // a short delay, re-checking the selection right before — a double-click's
+        // second click or a real selection cancels it.
+        pendingExpandTimer = window.setTimeout(() => {
+            pendingExpandTimer = null;
+            if (!hasActiveSelection())
+                setBubbleExpanded(true);
+        }, 280);
+    });
     // Initial placement (after the bubble exists, so applyDeployment can lay it out).
     reposition();
     function applyBubbleTheme() {
@@ -571,6 +667,7 @@ export function mountOrb(controller, options = {}) {
         if (modalTheme?.borderRadius != null)
             bubble.style.borderRadius = `${modalTheme.borderRadius}px`;
         closeBtn.style.color = t.bodyColor;
+        unexpandBtn.style.color = t.bodyColor;
         exchangeList.querySelectorAll('.fyodos-bubble-user').forEach((node) => {
             node.style.color = t.bodyColor;
         });
@@ -605,6 +702,9 @@ export function mountOrb(controller, options = {}) {
             controller.resetBubbleWindow();
             // Closing the panel returns the orb to idle (also clears mic fallback).
             micFallbackActive = false;
+            // Always re-open at the reduced size.
+            cancelPendingExpand();
+            setBubbleExpanded(false);
         }
         syncChip(controller.getState());
     }
@@ -707,29 +807,17 @@ export function mountOrb(controller, options = {}) {
         track.appendChild(second);
         thoughtBubbleEl.appendChild(track);
     }
-    function applyThoughtBubbleTheme() {
+    function applyThoughtBubbleTheme(widthPx) {
         const t = bubbleTheme;
         const { fontPx, padH, approxHeight } = resolveBubblePadding(t);
-        const shapeCss = bubbleShapeToCss(t, approxHeight);
+        const shapeCss = bubbleShapeToCss(t, approxHeight, 1, widthPx);
         thoughtBubbleEl.style.fontSize = `${fontPx}px`;
         thoughtBubbleEl.style.height = `${approxHeight}px`;
         thoughtBubbleEl.style.padding = `0 ${padH}px`;
         thoughtBubbleEl.style.color = t.textColor;
         thoughtBubbleEl.style.background = t.backgroundColor;
         thoughtBubbleEl.style.border = `${t.borderWidth}px solid ${t.borderColor}`;
-        const setImportant = (prop, value) => {
-            if (!value) {
-                thoughtBubbleEl.style.removeProperty(prop);
-                return;
-            }
-            thoughtBubbleEl.style.setProperty(prop, value, 'important');
-        };
-        setImportant('border-radius', shapeCss.borderRadius);
-        setImportant('border-top-left-radius', shapeCss.borderTopLeftRadius);
-        setImportant('border-top-right-radius', shapeCss.borderTopRightRadius);
-        setImportant('border-bottom-left-radius', shapeCss.borderBottomLeftRadius);
-        setImportant('border-bottom-right-radius', shapeCss.borderBottomRightRadius);
-        setImportant('clip-path', shapeCss.clipPath);
+        applyBubbleShapeCss(thoughtBubbleEl, shapeCss);
     }
     function positionThoughtBubble() {
         const dep = resolveOrbDeployment(effectivePosition());
@@ -764,6 +852,11 @@ export function mountOrb(controller, options = {}) {
         thoughtBubbleEl.style.display = 'flex';
         applyThoughtBubbleTheme();
         layoutThoughtContent(prompt);
+        if (bubbleTheme.shape === 'cloud') {
+            const widthPx = thoughtBubbleEl.offsetWidth;
+            if (widthPx > 0)
+                applyThoughtBubbleTheme(widthPx);
+        }
         positionThoughtBubble();
     }
     // ── Overlays (confirmation + consent) ────────────────────────────────────────

package/dist/esm/orb/orbView.js

@@ -8,7 +8,7 @@
  * pixel-for-pixel — no "basic circle" divergence. Vue / Svelte / Angular mount
  * THIS orb through createFiodosAgent → mountOrb.
  */
-import { chipBorderRadius, chipIconBaseSizePx, chipIconCenterOffset, chipIconSpec, computeOutwardBorderLayout, normalizeChipIconScale, normalizeKeyboardChipIcon, orbFillDepthBoxShadow, orbOuterGlowBoxShadow, resolveChipIconColor, resolveFiodosOrbMarkBars, resolveInnerBorderColor, resolveOrbBackgroundColor, } from '@fiodos/core';
+import { chipBorderRadius, chipIconBaseSizePx, chipIconCenterOffset, chipIconSpec, computeOutwardBorderLayout, normalizeChipIconScale, normalizeKeyboardChipIcon, orbFillDepthBoxShadow, orbOuterGlowBoxShadow, resolveChipIconColor, fiodosOrbMarkIdleHalfHeight, resolveFiodosOrbMarkAnimatedBars, resolveInnerBorderColor, resolveOrbBackgroundColor, } from '@fiodos/core';
 const SVG_NS = 'http://www.w3.org/2000/svg';
 export const DEFAULT_ORB_APPEARANCE = {
     accentColor: '#4f8cff',
@@ -73,9 +73,14 @@ function buildDoubleBorder(opts) {
     root.appendChild(mid);
     return { root, fill };
 }
-// ── Brand mark (port of FiodosOrbMark) ───────────────────────────────────────
+/**
+ * Neutral Fiodos brand mark (idle, no logo). Breathes very gently on web — a
+ * direct port of the landing hero orbs' waveform easing (see
+ * `fiodosOrbMarkIdleHalfHeight` in @fiodos/core) — deliberately subtler than
+ * and distinct from the volume-reactive waveform shown while listening.
+ */
 function buildOrbMark(orbSize) {
-    const { bars, color, radius } = resolveFiodosOrbMarkBars(orbSize);
+    const { bars, color, radius } = resolveFiodosOrbMarkAnimatedBars(orbSize);
     const svg = svgEl('svg', {
         width: orbSize,
         height: orbSize,
@@ -83,10 +88,31 @@ function buildOrbMark(orbSize) {
         'aria-hidden': 'true',
     });
     svg.style.display = 'block';
-    for (const b of bars) {
-        svg.appendChild(svgEl('rect', { x: b.x, y: b.y, width: b.width, height: b.height, rx: radius, ry: radius, fill: color }));
-    }
-    return svg;
+    const rects = bars.map((b) => {
+        const rect = svgEl('rect', { x: b.x, y: b.y, width: b.width, height: b.height, rx: radius, ry: radius, fill: color });
+        svg.appendChild(rect);
+        return rect;
+    });
+    let raf = 0;
+    return {
+        el: svg,
+        start() {
+            const t0 = performance.now();
+            const loop = (now) => {
+                raf = requestAnimationFrame(loop);
+                const t = (now - t0) / 1000;
+                bars.forEach((b, i) => {
+                    const half = fiodosOrbMarkIdleHalfHeight(t, i, b.baseHalfHeight, b.maxHalfHeight);
+                    rects[i].setAttribute('y', (b.centerY - half).toFixed(2));
+                    rects[i].setAttribute('height', (2 * half).toFixed(2));
+                });
+            };
+            raf = requestAnimationFrame(loop);
+        },
+        stop() {
+            cancelAnimationFrame(raf);
+        },
+    };
 }
 // ── Waveform (port of VoiceWaveform: 9 bars, bell profile, rAF) ───────────────
 const WAVE_BARS = 9;
@@ -377,6 +403,7 @@ export function createOrbVisual(initial) {
     let volume = 0;
     let fillEl = null;
     let waveform = null;
+    let markAnim = null;
     function rebuild() {
         const size = appearance.size ?? DEFAULT_ORB_APPEARANCE.size;
         const fill = resolveOrbBackgroundColor({
@@ -388,6 +415,8 @@ export function createOrbVisual(initial) {
         const interiorColor = resolveInnerBorderColor(appearance.innerBorderColor);
         waveform?.stop();
         waveform = null;
+        markAnim?.stop();
+        markAnim = null;
         wrapper.replaceChildren();
         const { root, fill: fillNode } = buildDoubleBorder({
             fillDiameter: size,
@@ -409,6 +438,8 @@ export function createOrbVisual(initial) {
         const waveColor = appearance.waveformColor ?? '#ffffff';
         waveform?.stop();
         waveform = null;
+        markAnim?.stop();
+        markAnim = null;
         fillEl.replaceChildren();
         // 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
@@ -453,7 +484,9 @@ export function createOrbVisual(initial) {
             return;
         }
         if (state === 'idle') {
-            fillEl.appendChild(buildOrbMark(size));
+            markAnim = buildOrbMark(size);
+            fillEl.appendChild(markAnim.el);
+            markAnim.start();
         }
     }
     rebuild();

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

@@ -60,7 +60,9 @@ export interface WatchPublishedConfigOptions {
 }
 /**
  * Starts watching the published config. Returns an unsubscribe function.
- * Best-effort: a failed fetch reports `null` (the orb keeps its current/default
- * look) and never throws into the host app.
+ * Best-effort: a failed fetch is SILENTLY skipped — the orb keeps its
+ * last-known-good (or cached) look instead of reverting to the default — and
+ * never throws into the host app. `onChange(null)` is reported ONLY when the
+ * backend confirms nothing is published.
  */
 export declare function watchPublishedConfig(controller: AgentController, options: WatchPublishedConfigOptions): () => void;