@gymmymac/bob-widget 3.2.4 → 3.2.13

package/CHANGELOG.md

@@ -5,6 +5,75 @@ All notable changes to the `@gymmymac/bob-widget` package will be documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v3.2.13] - 2026-03-09
+
+### Fixed
+- 🛒 **ProductTile Add-to-Cart Button**: Wired `onAddToCart` callback through `ResponsiveProductCard` to `ProductTile` — the green "+" button on partslot product tiles now correctly fires the add-to-cart callback
+- 📜 **Eager Shelf Category Registration**: Service package titles and partslot categories are now populated in `shelfCategoriesRef` during SSE stream processing (on `service_packages_found` / `parts_found` events) instead of waiting for a post-render `useEffect` — fixes auto-scroll failing because `shelfCategories` was empty at match time
+
+---
+
+## [v3.2.12] - 2026-03-09
+
+### Fixed
+- 🛡️ **Anti-Hallucination on Follow-Up Bypass**: The v3.2.11 follow-up bypass skipped [SHELF DATA] injection, causing the LLM to hallucinate brands/products. The bypass path now re-fetches service packages from the API (~1-2s) and injects real tier/price data so Bob only discusses actual inventory
+- 📜 **Service Package Scroll Anchors**: Service package cards now register in `groupRefs` alongside product categories — when Bob mentions "Front Brake Service", the shelf scrolls to that package card instead of doing nothing
+- 📦 **Client Shelf Context**: `useBobChat` now sends a compact `shelfContext` field (comma-separated category names from the shelf) with every request, providing a fallback data source on the bypass path
+
+---
+
+## [v3.2.11] - 2026-03-09
+
+### Fixed
+- ⚡ **Follow-Up Latency**: Extended `canBypassToolLoop` to skip the 3-round-trip tool-calling loop on follow-up requests when vehicle context is already confirmed — reduces "tell me about brake pads" responses from ~25-35s to ~5-8s by eliminating redundant LLM calls for data the client already has on the shelf
+
+---
+
+## [v3.2.10] - 2026-03-09
+
+### Fixed
+- 🎯 **Shelf Category Scoring**: Replaced naive substring matching with word-scoring algorithm — categories are now ranked by how many of their words appear in Bob's response, with only full matches considered. "BRAKE PADS FRONT" (3/3 words) now correctly wins over "BRAKE FLUID" (1/2 words)
+
+---
+
+## [v3.2.9] - 2026-03-09
+
+### Fixed
+- 📜 **Post-Stream Shelf Scroll**: When Bob discusses a specific part type in follow-up responses, the shelf now scrolls to that category — matches against actual shelf content (not hardcoded keywords) with server `highlight_category` events taking priority
+
+---
+
+## [v3.2.8] - 2026-03-09
+
+### Fixed
+- 🔇 **Removed Optimistic Searching Audio**: Removed the `parts_searching.mp3` canned audio trigger that played at inappropriate times during follow-up conversations — aligns with V2.0 architecture decision to disable canned audio triggers
+
+---
+
+## [v3.2.7] - 2026-03-09
+
+### Fixed
+- 🛒 **Follow-Up Products Merge**: New products requested mid-conversation are now **merged** into the existing shelf instead of replacing it — existing items are preserved and deduplicated by SKU
+- 📜 **Auto-Scroll to New Categories**: When follow-up parts introduce a new category not already on the shelf, the shelf automatically scrolls to that section with a 300ms smooth animation
+
+---
+
+## [v3.2.6] - 2026-03-09
+
+### Fixed
+- 📜 **Shelf Auto-Scroll on Load**: Removed legacy `PART_TYPE_KEYWORDS` scan that fired `onHighlightPart` after every assistant message — generic words like "brakes" in Bob's greeting were scrolling the shelf to the bottom. Highlighting now only triggers from explicit server-side `highlight_category` SSE events
+
+---
+
+## [v3.2.5] - 2026-03-09
+
+### Fixed
+- 🔇 **Bug #1 — Quick-Reply Speech Stop**: Quick-reply/suggestion buttons now call `onInterrupt()` to stop all active speech before triggering `onNavigate`, preventing jarring audio overlap during navigation
+- 🎛️ **Bug #2 — Imperative Stop Handle**: `BobStandaloneHandle.stopSpeech()` / `.interrupt()` now calls `stopAllAudio` (TTS + canned clips + searching audio) instead of only cancelling TTS — host apps can now fully silence Bob via ref
+- 🎤 **Bug #3 — PTT Interrupt During Canned Audio**: Composite `isSpeaking` state now tracks both TTS and audio controller playback, so the PTT button correctly detects the `speaking` state during pre-recorded clips and interrupts immediately on tap
+
+---
+
 ## [v3.2.4] - 2026-03-09
 
 ### Fixed

package/dist/__tests__/v325BugFixes.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * v3.2.5 Bug Fix Regression Tests
+ *
+ * Covers three critical CARFIX production bugs:
+ *   Bug #1 — Quick-reply buttons must call onInterrupt before onQuickReply (stop speech before navigating)
+ *   Bug #2 — Imperative handle must call stopAllAudio (TTS + canned + searching), not just stopSpeech
+ *   Bug #3 — Composite isSpeaking must be true when EITHER TTS or audio controller is playing
+ */
+export {};

package/dist/components/mobile/ContainedMobileBobLayout.d.ts

@@ -26,6 +26,8 @@ interface ContainedMobileBobLayoutProps {
     servicePackages: ServicePackage[];
     highlightedPartType?: string | null;
     highlightedProduct?: HighlightedProduct | null;
+    scrollToCategory?: string | null;
+    onScrollToCategoryComplete?: () => void;
     onProductClick?: (product: Product) => void;
     onPackageSelect?: (pkg: ServicePackage) => void;
     isResearching?: boolean;

package/dist/components/mobile/MobileBobLayout.d.ts

@@ -26,6 +26,8 @@ interface MobileBobLayoutProps {
     servicePackages: ServicePackage[];
     highlightedPartType?: string | null;
     highlightedProduct?: HighlightedProduct | null;
+    scrollToCategory?: string | null;
+    onScrollToCategoryComplete?: () => void;
     onProductClick?: (product: Product) => void;
     onPackageSelect?: (pkg: ServicePackage) => void;
     isResearching?: boolean;

package/dist/components/mobile/MobileProductColumn.d.ts

@@ -21,6 +21,8 @@ interface MobileProductColumnProps {
     servicePackages: ServicePackage[];
     highlightedPartType?: string | null;
     highlightedProduct?: HighlightedProduct | null;
+    scrollToCategory?: string | null;
+    onScrollToCategoryComplete?: () => void;
     onProductClick?: (product: Product) => void;
     onPackageSelect?: (pkg: ServicePackage) => void;
     isResearching?: boolean;

package/dist/hooks/useBobChat.d.ts

@@ -22,8 +22,10 @@ interface UseBobChatProps {
     onAutoFetchComplete?: () => void;
     /** When backend requires user to pick a vehicle variant, provide UI-ready cards for the shelf */
     onVariantSelectionRequired?: (variants: VariantCard[], make: string, model: string) => void;
+    /** Ref containing current shelf category names for post-stream scroll matching */
+    shelfCategoriesRef?: React.RefObject<Set<string>>;
 }
-export declare const useBobChat: ({ setAnimationState, manualMode, talkingState, thinkingState, completeState, idleState, listenState, onStreamStart, onStreamComplete, onShowingProduct, onResearchStart, onReadyToSpeak, onHighlightPart, onHighlightProduct, onNoPartsFound, onAutoFetchComplete, onVariantSelectionRequired }: UseBobChatProps) => {
+export declare const useBobChat: ({ setAnimationState, manualMode, talkingState, thinkingState, completeState, idleState, listenState, onStreamStart, onStreamComplete, onShowingProduct, onResearchStart, onReadyToSpeak, onHighlightPart, onHighlightProduct, onNoPartsFound, onAutoFetchComplete, onVariantSelectionRequired, shelfCategoriesRef }: UseBobChatProps) => {
     messages: Message[];
     input: string;
     setInput: import('react').Dispatch<import('react').SetStateAction<string>>;