Software Updates

private Yen mode + listening indicator + weather tool + guest speaking language

• Sparkles toolbar button now opens Yen in PRIVATE mode (publicMode=false) so no tile is broadcast to other participants
• Voice-triggered 'Hey Yen' still fires publicly (tile visible to all)
• Host now has full interactive YenChatPanel in private mode (confirm/ decline/type context) without guests seeing anything
• 'Yen is listening…' pulsing amber badge appears at top-center of meeting room from wake-word detection until query fires
• Hold phrases (wait/also/forgot etc) extend the wait by +1500ms
• Logic simplified to shared firePendingQuery() callback
• New get_weather tool added to yen-chat route and panel labels
• Uses Open-Meteo geocoding + forecast APIs (free, no API key needed)
• Returns current conditions: temp (°F), feels-like, wind, humidity, condition description, peak rain probability for the day
• Pre-join screen now shows a speaking-language picker (17 languages) so guests explicitly set which language they speak, not guessed from browser locale
• Settings panel (gear icon) inside the live room also has an 'I'm speaking' section to change STT language mid-call, which stops and restarts Deepgram with the new language code
• spokenLanguage is now stateful in both GuestRoomClient and RoomContent

Yen wake-word normalization + follow-up voice commands + build fix

• yen-chat/route.ts line 316: wrap ?? expr in parens to fix Turbopack 'nullish coalescing requires parens when mixing with logical operators'
• Deepgram finals now have phonetic Yen variants (Ian, Jan, Jen, Yan…) replaced with canonical 'Yen' in transcript, subtitles, and broadcast captions — 'hey Ian can you…' appears as 'Hey Yen can you…'
• While accumulating a Yen query, if a final contains hold phrases (wait, hold on, not done, also, forgot to mention, let me add, etc.) the silence timer resets and buffering continues — Yen won't fire prematurely mid-sentence
• 'Yen, the email is X' / 'Yen, I forgot to mention Y' detected via YEN_FOLLOWUP_RE while yenChatOpen=true → auto-submitted as new message in the current thread via yenFollowUp state
• YenChatPanel now accepts followUp/onFollowUpConsumed props and fires submitQuery when a new follow-up arrives

increase Yen silence buffer to 3s + improve team member lookup

• YEN_SILENCE_MS: 1800 → 3000ms so Yen waits longer before firing, giving Deepgram time to emit all finals before the query is submitted
• execLookupClient now searches User.firstName, User.lastName, User.jobTitle, User.department fields so employees like Stella (CMO) are found by first name or job title
• Also queries WorkerProfile table (firstName, lastName, preferredName, jobTitle, department) with link back to User.email
• Result label now shows job title + department for team members so Claude can confirm 'Stella · Chief Marketing Officer' before sending

add 'ian' to Yen wake word regex + improve ShipStation city zip inference

• Deepgram transcribes 'Yen' as 'Ian' — added 'ian' to the phonetic regex alternation in both host (meeting-room-client) and guest (guest-room-client) wake word detectors
• Updated ShipStation tool description to instruct Claude to infer city-specific zip codes when a city+state is given (e.g. Greenville SC → 29601) instead of falling back to generic country defaults
• Reinforced shipping guideline in system prompt

ShipStation international rates + Yen team-member lookup

• Fix origin ZIP: 10036 (NYC) → 30120 (Cartersville, GA — Katura studio)
• Fix international rates: don't pass toState for non-US destinations — carriers reject foreign state codes and return empty rate lists
• Better no-rates error message includes per-carrier error detail so the host can see exactly which carriers failed and why
• Tool description: explicit per-country postal code defaults including Brazil (01310100 = São Paulo), Canada, UK, AU, DE, FR, JP, MX; tell Claude to NEVER refuse without calling the tool first
• Tool description: clarify toState is US-domestic only — OMIT for non-US
• lookup_client tool description rewritten to clearly state it covers Katura team members, employees, and staff (not just clients)
• Explicit examples: 'email Stella', 'contact Austin' → lookup_client first
• System prompt: TEAM & CONTACT LOOKUP section with direct instruction to always call lookup_client before send_email when a person is named
• System prompt: Katura studio location (Cartersville, GA, ZIP 30120) explicitly stated so shipping context is always clear
• Multi-address disambiguation example updated with correct Stella email (contatoluiseagency@gmail.com)

Yen no-double-window, invite autocomplete, PDF/email minutes

• When publicMode=true (voice-triggered Hey Yen), YenChatPanel returns null visually — API effects still run, onResponseDone still fires for tile update. Only YenMeetingTile is visible; no duplicate private panel.
• New GET /api/admin/meetings/suggest-participants?q= — returns up to 12 suggestions from team members (role!=CUSTOMER), past meeting guests (MeetingInvite), and top clients (CUSTOMER + totalSpent/totalOrders).
• Instant-launch modal now shows suggestion chips that populate on focus and update live as the user types; debounced 200ms; chips auto-filter already-added addresses; click to add without typing full email.
• MinutesActions client component: 'Download PDF' button calls window.print() (browser Save-as-PDF), 'Email Minutes' opens an inline dialog.
• New POST /api/admin/meetings/[id]/email-minutes — builds a full-fidelity HTML email (summary, action items table, decisions, open questions, risks, follow-ups, participants) and sends via Brevo from yen@katura1999.com.
• MinutesActions added to the minutes page footer (only shown when minutes exist).

Yen silence buffer (1.8s gate), AI notes toggle respects checkbox

• Hey Yen now accumulates Deepgram finals for 1800ms of silence before submitting query — prevents premature fire on mid-sentence endpointing
• initialSubtitlesOn reads joinData.aiNotesEnabled instead of hardcoded true
• AI Notes checkbox in meeting settings now correctly prevents STT auto-start
• Yen buffer cleaned up in stopStt() and unexpected ws.onclose so orphaned timers can never fire after STT has been torn down

camera visibility, Yen tile crush, subtitle lowercase, font sync, email 400

• Remove adaptiveStream:true from both admin + guest LiveKitRoom → adaptiveStream blocks camera subscription until video element is in DOM, causing guest to never see host camera on initial load
• Guest SubtitlePanel: wrap in shrink-0 fixed-height (144px) container → without height constraint, accumulated captions grew to fill flex column, squeezing video + Yen tile section to 0px (full-screen subtitles bug)
• Subtitle textTransform: 'none' → 'lowercase' when caps=false
• Guest default font: font-display → font-narrow (matches admin default)
• Email 400 fix: fromAccountId falls back to user account if yen@ not in DB

meeting platform action items — subtitle caps off, condensed font top, ShipStation live rates, Safari camera, 30s timeout

• Subtitle all-caps OFF by default (both admin + guest rooms)
• Condensed font moved to top of SUBTITLE_FONTS list (both rooms)
• get_shipping_options now calls ShipStation API (getRatesFromAllCarriers) for real FedEx/UPS/USPS quotes
• Tool definition updated: accepts toCountry, toPostalCode, toState, weightOunces
• Claude infers zip codes from partial address info (system prompt)
• 30s timeout on agentic loop prevents infinite processing
• Safari camera fix: adaptiveStream + dynacast, explicit camera re-enable after connect
• Safari video: playsinline attribute enforcement via MutationObserver
• Guest chat panel: added missing open/onOpenChange props (fixes TS error)
• Guest font list: added Condensed + Humanist (parity with admin)

multi-email disambiguation + send from yen@katura1999.com

wire email send end-to-end — correct payload shape, fromAccountId, broader lookup_client

expand Hey Yen detection + fix video squeezing on resize

• ### Hey Yen — phonetic variant coverage
• The regex previously missed 'yin' (and 'yon', 'yean', 'yeun', 'jin')
• which are common Deepgram transcriptions of 'Yen'. Expanded to:
• yen|yan|yin|yon|yenn?|yean|yeun|jen(na?|a)?|jan[aei]?|jin[ae]?|yarn?|ge[mn]h?
• Also simplified the regex structure (removed duplicate/overlapping
• alternatives like yen[nah]? and yenh? which partially overlapped with yen).
• Applied in both admin room (host voice trigger) and guest room.
• ### Guest Hey Yen flow
• Guests with allowGuestYen=true now detect 'Hey Yen' in their own
• speech and broadcast a yen_guest_trigger data packet. The host's data
• handler receives it and opens YenChatPanel in publicMode, so the
• response is broadcast back to all participants as a tile — same
• experience as the host triggering it themselves.
• ### Video squeezing on subtitle panel resize
• LiveKit renders video with object-fit: contain by default, which
• letterboxes the video when the container changes aspect ratio.
• Added global CSS override:
• .lk-participant-tile video { object-fit: cover }
• Now the video always fills its tile regardless of container shape —
• no black bars or squeezed frames when dragging the subtitle panel.

quote camelCase column names in email composite index migration

• Prisma does not auto-convert field names to snake_case — only model names
• are mapped via @@map. The actual Postgres columns are camelCase
• (toAccountId, fromAccountId, sentAt, isRead) and must be double-quoted
• in raw SQL.
• Also ships: subtitle panel now shows 'Speaker is speaking…' during
• interim speech instead of raw partial words.

fix X close button + add post-response action flow

• YenMeetingTile onDismiss now also closes the chat panel (previously dismissed the video tile but left the slide-in panel open)
• handleClose and clearThread both reset postStage so the action buttons don't ghost after a re-open
• A new query is submitted
• The panel is closed
• The thread is cleared

dramatically speed up /admin/email with caching, lighter queries, and composite indexes

• (to_account_id, folder, sent_at DESC) — inbox/folder view
• (from_account_id, folder, sent_at DESC) — sent/drafts view
• (to_account_id, is_read, folder) WHERE is_read=false AND folder='INBOX' — unread badge Migration SQL: scripts/db-migrations/prisma/add-email-composite-indexes.sql
• Inbox page load: ~3 DB queries → 1 (cached) + 1 inbox query
• Message list query: eliminates trackingEvents JOIN (potentially 50 joins/req)
• Bulk select-all archive: 50 HTTP requests → 1
• Repeat navigation: near-zero DB cost for sidebar (30s cache)

remove 8 empty stub files from root directory

• shipengine-rate-calculator.ts (empty stub, real file in scripts/shipping/)
• test-fedex-rates-direct.mjs (empty stub, real file in scripts/shipping/)
• test-fedex-rates.ts (empty stub, real file in scripts/shipping/)
• shipstation-test.ts (empty stub, real file in scripts/shipping/)
• VISUAL_GUIDE.txt (empty)
• NEXT_STEPS.txt (empty)
• .git-commit-msg.txt (empty)
• ShipStation-Tests.postman_collection.json (empty stub, real file in scripts/shipping/)
• Environment configs (.env*, .vercel*)
• Package/lock files (package.json, pnpm-*)
• Build/framework configs (next.config.ts, tsconfig.json, etc)
• Tooling configs (eslint, vitest, playwright, postcss)
• Documentation (README.md)
• Deployment config (vercel.json)

move shipengine docs and sql migrations to organized locations

• Move all 19 ShipEngine docs from root → docs/integrations/shipengine/ (CARRIER_IDS, DELIVERY_SUMMARY, FEDEX_TESTING, QUICK_ACTION, README_SHIPENGINE, REAL_RATE_TEST, SETUP-COMPLETE, INTEGRATION_STATUS, MIGRATION, QUICKSTART, REVIEW_COMPLETE, SETUP, SHIPPING_RATES, SHIPSTATION_*, WEBHOOKS_*, etc)
• Copy all Prisma SQL migrations → scripts/db-migrations/prisma/ (add-casting-reviews, add-order-timeline, fix-support-tickets, add-investors, add-analytics-perf, add-jewelry-project, enable-rls, plus 20260127/0121/0130 timestamped migrations and others)
• Move all cap-table migrations → scripts/db-migrations/cap-table/ (fix_company_entity, seed_cap_table, add_cap_compliance, repair_cap_table, etc)

reorganize docs and scripts into proper folder structure

• Move loose docs from root into appropriate subfolders
• Incident fixes (CONNECTION-POOL, CRON-AUTH, EMERGENCY, etc) → docs/fixes/
• Deployment & infrastructure (DEPLOYMENT-COMPLETE, INFRASTRUCTURE-HARDENING, etc) → docs/deployment/
• Meetings (MEETINGS-PAGINATION, MEETINGS-STRATEGY, DEEPGRAM-STT, etc) → docs/meetings/
• AI/Yen (YEN-CLAUDE-CAPABILITIES, YEN-MEMORY-ARCHITECTURE, etc) → docs/ai/
• Platform & K99 strategy (K99-*, KATURA-OPERATING-PLAN, etc) → docs/platform/
• Audit & reviews (ADMIN_AUDIT, CHECKOUT-AUDIT, SIDEBAR-CONSOLIDATION) → docs/audits/
• Business & brand (LUXURY_BRAND_STRATEGY, ANTAR_PROPOSAL, etc) → docs/marketing/
• Email, Stripe, Integrations moved to respective subfolders
• Changelog, reference docs → docs/reference/
• Database migration scripts → scripts/db-migrations/
• Shipping tests & Postman collection → scripts/shipping/
• ShipStation test scripts → scripts/

integrate ShipEngine real-time rates with insurance

• Replace ShipStation client with direct ShipEngine API calls
• Add dimensions (6x4x2in) for FedEx compatibility
• Add customs declarations for international shipments
• Insure packages for cartValue * 1.08 (incl. avg sales tax)
• Return insurance_amount as separate line item in response
• Deduplicate rates: one best rate per carrier
• Graceful fallback to static regional rates on API error
• Add getShippingRates tool to Yen (all carriers, insured)
• Update Yen system prompt with shipping capability
• Remove webhook HMAC secret (ShipEngine doesn't use it)
• FedEx transit note: One Balance accounts return no transit time via API

Replace pink sparkle icon with Katura dark blue logo in admin/yen interface

align usage API response shape with dashboard UsageData interface

add How It Works tab to memories page

rebuild memories page with graph memory tab + health panel