@mushi-mushi/web 0.5.1 → 0.8.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createLogger, noopLogger, createApiClient, createPreFilter, createOfflineQueue, createRateLimiter, createPiiScrubber, getDeviceFingerprintHash, getReporterToken, getSessionId, captureEnvironment } from '@mushi-mushi/core';
+import { createLogger, noopLogger, createApiClient, createPreFilter, createOfflineQueue, createRateLimiter, createPiiScrubber, getReporterToken, getDeviceFingerprintHash, getSessionId, captureEnvironment, DEFAULT_API_ENDPOINT, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INTERNAL_HEADER } from '@mushi-mushi/core';
 
 // src/mushi.ts
 
@@ -243,11 +243,6 @@ function getWidgetStyles(theme) {
     *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
     button { font-family: inherit; }
 
-    /* \u2500\u2500 Trigger \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       A small "stamp card" \u2014 soft rounded square (4px radius), paper
-       background, vermillion bottom edge that reads as the inked face
-       of a real \u5370\u9451. A pulsing dot in the top-right hints there's a
-       channel here without needing a notification badge. */
     .mushi-trigger {
       position: fixed;
       width: 52px;
@@ -301,10 +296,53 @@ function getWidgetStyles(theme) {
       outline: 2px solid ${vermillion};
       outline-offset: 3px;
     }
-    .mushi-trigger.bottom-right { bottom: 24px; right: 24px; }
-    .mushi-trigger.bottom-left  { bottom: 24px; left: 24px; }
-    .mushi-trigger.top-right    { top: 24px; right: 24px; }
-    .mushi-trigger.top-left     { top: 24px; left: 24px; }
+    .mushi-trigger.bottom-right {
+      bottom: var(--mushi-bottom, calc(24px + env(safe-area-inset-bottom, 0px)));
+      right: var(--mushi-right, calc(24px + env(safe-area-inset-right, 0px)));
+    }
+    .mushi-trigger.bottom-left  {
+      bottom: var(--mushi-bottom, calc(24px + env(safe-area-inset-bottom, 0px)));
+      left: var(--mushi-left, calc(24px + env(safe-area-inset-left, 0px)));
+    }
+    .mushi-trigger.top-right    {
+      top: var(--mushi-top, calc(24px + env(safe-area-inset-top, 0px)));
+      right: var(--mushi-right, calc(24px + env(safe-area-inset-right, 0px)));
+    }
+    .mushi-trigger.top-left     {
+      top: var(--mushi-top, calc(24px + env(safe-area-inset-top, 0px)));
+      left: var(--mushi-left, calc(24px + env(safe-area-inset-left, 0px)));
+    }
+    .mushi-trigger.edge-tab {
+      width: 32px;
+      height: 88px;
+      border-radius: 4px 0 0 4px;
+      writing-mode: vertical-rl;
+      text-orientation: upright;
+      font-size: 16px;
+      box-shadow:
+        0 1px 0 ${rule},
+        0 10px 24px -14px rgba(14,13,11,0.45),
+        inset -3px 0 0 ${vermillion};
+    }
+    .mushi-trigger.edge-tab.bottom-right,
+    .mushi-trigger.edge-tab.top-right {
+      right: var(--mushi-right, 0);
+    }
+    .mushi-trigger.edge-tab.bottom-left,
+    .mushi-trigger.edge-tab.top-left {
+      left: var(--mushi-left, 0);
+      border-radius: 0 4px 4px 0;
+      box-shadow:
+        0 1px 0 ${rule},
+        0 10px 24px -14px rgba(14,13,11,0.45),
+        inset 3px 0 0 ${vermillion};
+    }
+    .mushi-trigger.shrunk {
+      width: 36px;
+      height: 36px;
+      opacity: 0.82;
+      transform: scale(0.92);
+    }
 
     @keyframes mushi-pulse {
       0%   { box-shadow: 0 0 0 0 ${vermillion}; opacity: 1; }
@@ -312,12 +350,6 @@ function getWidgetStyles(theme) {
       100% { box-shadow: 0 0 0 0 rgba(224,60,44,0); opacity: 1; }
     }
 
-    /* \u2500\u2500 Panel \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Paper-card. Sharper corners (6px) than typical SaaS modals
-       (which default to 12-16px and read as plastic). Two-layer shadow:
-       one hairline that sells the paper edge, one diffuse that lifts
-       the panel off the underlying app. No backdrop-filter \u2014 we want
-       the widget to feel like it sits ON the page, not blur INTO it. */
     .mushi-panel {
       position: fixed;
       width: 384px;
@@ -337,10 +369,49 @@ function getWidgetStyles(theme) {
     }
     .mushi-panel.open  { animation: mushi-stamp-in 320ms ${easeStamp} both; }
     .mushi-panel.closed { display: none; }
-    .mushi-panel.bottom-right { bottom: 88px; right: 24px; --mushi-origin: bottom right; }
-    .mushi-panel.bottom-left  { bottom: 88px; left: 24px;  --mushi-origin: bottom left; }
-    .mushi-panel.top-right    { top: 88px;    right: 24px; --mushi-origin: top right; }
-    .mushi-panel.top-left     { top: 88px;    left: 24px;  --mushi-origin: top left; }
+    .mushi-panel.bottom-right {
+      bottom: var(--mushi-panel-bottom, calc(var(--mushi-bottom, 24px) + 64px));
+      right: var(--mushi-right, calc(24px + env(safe-area-inset-right, 0px)));
+      --mushi-origin: bottom right;
+    }
+    .mushi-panel.bottom-left  {
+      bottom: var(--mushi-panel-bottom, calc(var(--mushi-bottom, 24px) + 64px));
+      left: var(--mushi-left, calc(24px + env(safe-area-inset-left, 0px)));
+      --mushi-origin: bottom left;
+    }
+    .mushi-panel.top-right    {
+      top: var(--mushi-panel-top, calc(var(--mushi-top, 24px) + 64px));
+      right: var(--mushi-right, calc(24px + env(safe-area-inset-right, 0px)));
+      --mushi-origin: top right;
+    }
+    .mushi-panel.top-left     {
+      top: var(--mushi-panel-top, calc(var(--mushi-top, 24px) + 64px));
+      left: var(--mushi-left, calc(24px + env(safe-area-inset-left, 0px)));
+      --mushi-origin: top left;
+    }
+    .mushi-outdated {
+      margin: 12px 14px 0;
+      padding: 10px 12px;
+      border: 1px solid ${vermillionWash};
+      background: ${vermillionWash};
+      color: ${vermillionInk};
+      font-family: ${fontBody};
+      font-size: 12px;
+      line-height: 1.4;
+    }
+    .mushi-outdated strong {
+      display: block;
+      font-family: ${fontMono};
+      font-size: 10px;
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      margin-bottom: 2px;
+    }
+    .mushi-outdated span {
+      display: block;
+      margin-top: 3px;
+      color: ${inkMuted};
+    }
 
     @keyframes mushi-stamp-in {
       0%   { opacity: 0; transform: scale(0.94) translateY(6px); }
@@ -348,10 +419,6 @@ function getWidgetStyles(theme) {
       100% { opacity: 1; transform: scale(1) translateY(0); }
     }
 
-    /* \u2500\u2500 Header \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Editorial masthead: small mono eyebrow ("MUSHI / REPORT") on top,
-       serif display headline below, mono step counter on the far right.
-       A single hairline separates header from body \u2014 no card stacking. */
     .mushi-header {
       padding: 18px 20px 14px;
       border-bottom: 1px solid ${rule};
@@ -448,10 +515,6 @@ function getWidgetStyles(theme) {
     .mushi-body::-webkit-scrollbar { width: 6px; }
     .mushi-body::-webkit-scrollbar-thumb { background: ${inkFaint}; border-radius: 3px; }
 
-    /* \u2500\u2500 Step 1: Categories as a contents-page list \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       No boxes. Hairline rules between rows. Hovering a row pulls a
-       vermillion arrow in from the right and tints the row label \u2014
-       reads like flipping through an index card. */
     .mushi-option-btn {
       display: grid;
       grid-template-columns: auto 1fr auto;
@@ -503,12 +566,76 @@ function getWidgetStyles(theme) {
       transform: translateX(-4px);
       transition: opacity 220ms ${easeStamp}, transform 220ms ${easeStamp}, color 220ms ${easeStamp};
     }
+    .mushi-report-row {
+      width: 100%;
+      display: grid;
+      grid-template-columns: auto 1fr auto;
+      gap: 8px;
+      align-items: center;
+      padding: 10px 0;
+      border: 0;
+      border-bottom: 1px solid ${rule};
+      background: transparent;
+      color: ${ink};
+      cursor: pointer;
+      text-align: left;
+    }
+    .mushi-report-status {
+      font-family: ${fontMono};
+      font-size: 10px;
+      color: ${vermillion};
+      text-transform: uppercase;
+    }
+    .mushi-report-title {
+      font-size: 13px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .mushi-thread-summary {
+      border-bottom: 1px solid ${rule};
+      padding-bottom: 10px;
+      margin-bottom: 10px;
+    }
+    .mushi-thread-summary span {
+      font-family: ${fontMono};
+      font-size: 10px;
+      color: ${vermillion};
+      text-transform: uppercase;
+    }
+    .mushi-thread {
+      display: grid;
+      gap: 8px;
+      max-height: 180px;
+      overflow: auto;
+      margin-bottom: 12px;
+    }
+    .mushi-thread-comment {
+      padding: 8px 10px;
+      border: 1px solid ${rule};
+      background: ${isDark ? "rgba(242,235,221,0.04)" : "rgba(14,13,11,0.03)"};
+    }
+    .mushi-thread-comment.reporter {
+      border-color: ${vermillionWash};
+      background: ${vermillionWash};
+    }
+    .mushi-thread-comment strong {
+      display: block;
+      font-family: ${fontMono};
+      font-size: 10px;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+      margin-bottom: 3px;
+    }
+    .mushi-thread-comment p,
+    .mushi-muted,
+    .mushi-error-inline {
+      font-size: 12px;
+      color: ${inkMuted};
+      line-height: 1.45;
+    }
+    .mushi-error-inline { color: ${vermillion}; }
 
-    /* \u2500\u2500 Step 2: Selected-category breadcrumb + intent text-buttons \u2500
-       Breadcrumb is a thin chip with the kanji-stamp aesthetic carried
-       over (vermillion left rule). Intents are inline TEXT buttons
-       with vermillion underlines on hover \u2014 not pill-shaped chips,
-       which is the SaaS default and not what we are. */
     .mushi-selected-category {
       display: inline-flex;
       align-items: center;
@@ -564,10 +691,6 @@ function getWidgetStyles(theme) {
       box-shadow: inset 2px 0 0 ${vermillion};
     }
 
-    /* \u2500\u2500 Step 3: Borderless textarea + minimal attach pills \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       The textarea has no box around it \u2014 just a hairline underline
-       that turns vermillion on focus. Encourages writing rather than
-       form-filling. */
     .mushi-textarea {
       width: 100%;
       min-height: 96px;
@@ -620,15 +743,21 @@ function getWidgetStyles(theme) {
       border-color: ${vermillion};
       background: ${vermillionWash};
     }
+    .mushi-attach-btn.danger {
+      color: ${vermillionInk};
+      border-color: ${vermillionWash};
+      background: transparent;
+    }
+    .mushi-attach-btn.danger:hover {
+      color: ${vermillion};
+      border-color: ${vermillion};
+      background: ${vermillionWash};
+    }
     .mushi-attach-btn:focus-visible {
       outline: 2px solid ${vermillion};
       outline-offset: 2px;
     }
 
-    /* \u2500\u2500 Footer + submit (vermillion stamp) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Submit button is the heaviest visual moment in the widget \u2014
-       vermillion fill, mono-caps label, send arrow. Holds an ink-
-       bloom pseudo-element that animates outward when pressed. */
     .mushi-footer {
       padding: 14px 22px 16px;
       border-top: 1px solid ${rule};
@@ -693,10 +822,17 @@ function getWidgetStyles(theme) {
     }
     .mushi-submit:hover .mushi-submit-arrow { transform: translateX(3px); }
 
-    /* \u2500\u2500 Step indicator (numeral ledger) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Replaces the generic three-dots with a typographic series:
-       "01 \u2014 02 \u2014 03". The active step uses serif numerals, the
-       others use mono so the active one literally reads heavier. */
+    .mushi-brand-footer {
+      padding: 9px 14px 11px;
+      border-top: 1px solid ${rule};
+      color: ${inkFaint};
+      font-family: ${fontMono};
+      font-size: 9px;
+      letter-spacing: 0.16em;
+      text-align: center;
+      text-transform: uppercase;
+    }
+
     .mushi-step-indicator {
       display: flex;
       align-items: center;
@@ -724,10 +860,6 @@ function getWidgetStyles(theme) {
     }
     .mushi-step-sep { width: 14px; height: 1px; background: ${rule}; }
 
-    /* \u2500\u2500 Success: \u6731\u5370 stamp animation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       The success state is the signature moment. A vermillion ring
-       scribes itself, then a "RECEIVED" mono-caps label fades in at
-       the centre, evoking a hanko being pressed onto the form. */
     .mushi-success {
       text-align: center;
       padding: 28px 16px 20px;
@@ -791,9 +923,6 @@ function getWidgetStyles(theme) {
       100% { opacity: 1; transform: rotate(-6deg) scale(1); }
     }
 
-    /* \u2500\u2500 Error \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Inline editorial note rather than a red box. Vermillion left
-       rule keeps the same accent language. */
     .mushi-error {
       margin-top: 10px;
       padding: 8px 0 8px 10px;
@@ -804,9 +933,6 @@ function getWidgetStyles(theme) {
       letter-spacing: 0.02em;
     }
 
-    /* \u2500\u2500 Reduced motion \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-       Honour the OS preference: kill every transition + animation
-       except the focus underline (which is critical feedback). */
     @media (prefers-reduced-motion: reduce) {
       *,
       *::before,
@@ -836,12 +962,51 @@ var TOTAL_STEPS = 3;
 var STEP_NUMBER = {
   category: 1,
   intent: 2,
-  details: 3
-};
+  details: 3};
 function isSubmitShortcut(e) {
   return (e.metaKey || e.ctrlKey) && e.key === "Enter";
 }
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
 var MushiWidget = class {
+  constructor(config = {}, callbacks, sdkVersion = "0.7.0") {
+    this.sdkVersion = sdkVersion;
+    this.config = {
+      position: config.position ?? "bottom-right",
+      anchor: config.anchor ?? {},
+      theme: config.theme ?? "auto",
+      // Falsy-OR (NOT `??`) on purpose: `triggerText: ''` is semantically
+      // nonsense — it would render a labelless, glyphless trigger button
+      // that users can't see or aim at. Treat empty string the same as
+      // omitted so any caller that wires this to a cleared form input or
+      // pastes a legacy snippet that emitted `triggerText: ""` (see
+      // apps/admin/src/lib/sdkSnippets.ts widgetLines history) still gets
+      // the default 🐛 and a visible button.
+      triggerText: config.triggerText || "\u{1F41B}",
+      expandedTitle: config.expandedTitle ?? "",
+      mode: config.mode ?? "conversational",
+      locale: config.locale ?? "auto",
+      zIndex: config.zIndex ?? 99999,
+      trigger: config.trigger ?? "auto",
+      attachToSelector: config.attachToSelector ?? "",
+      inset: config.inset ?? {},
+      respectSafeArea: config.respectSafeArea ?? true,
+      hideOnSelector: config.hideOnSelector ?? "",
+      hideOnRoutes: config.hideOnRoutes ?? [],
+      environments: config.environments ?? {},
+      smartHide: config.smartHide ?? false,
+      draggable: config.draggable ?? false,
+      brandFooter: config.brandFooter ?? true,
+      outdatedBanner: config.outdatedBanner ?? "auto"
+    };
+    this.callbacks = callbacks;
+    this.locale = getLocale(this.config.locale === "auto" ? void 0 : this.config.locale);
+    this.host = document.createElement("div");
+    this.host.id = "mushi-mushi-widget";
+    this.shadow = this.host.attachShadow({ mode: "closed" });
+  }
+  sdkVersion;
   host;
   shadow;
   config;
@@ -852,8 +1017,21 @@ var MushiWidget = class {
   selectedCategory = null;
   selectedIntent = null;
   screenshotAttached = false;
+  allowScreenshotRemove = true;
   elementSelected = false;
   submitting = false;
+  triggerVisible = true;
+  triggerShrunk = false;
+  triggerHiddenByScroll = false;
+  sdkFreshness = null;
+  reporterReports = [];
+  reporterComments = [];
+  selectedReportId = null;
+  reporterLoading = false;
+  reporterError = null;
+  attachedLaunchers = [];
+  smartHideCleanup = null;
+  smartHideTimer = null;
   /** Captured at the moment of submit so the success ledger metadata
    *  ("REPORT · 14:23:07 JST") doesn't drift while the success step
    *  is on screen. */
@@ -864,45 +1042,42 @@ var MushiWidget = class {
    *  root) for up to ~3.3s after destroy. */
   successTimer = null;
   autoCloseTimer = null;
-  constructor(config = {}, callbacks) {
-    this.config = {
-      position: config.position ?? "bottom-right",
-      theme: config.theme ?? "auto",
-      // Falsy-OR (NOT `??`) on purpose: `triggerText: ''` is semantically
-      // nonsense — it would render a labelless, glyphless trigger button
-      // that users can't see or aim at. Treat empty string the same as
-      // omitted so any caller that wires this to a cleared form input or
-      // pastes a legacy snippet that emitted `triggerText: ""` (see
-      // apps/admin/src/lib/sdkSnippets.ts widgetLines history) still gets
-      // the default 🐛 and a visible button.
-      triggerText: config.triggerText || "\u{1F41B}",
-      expandedTitle: config.expandedTitle ?? "",
-      mode: config.mode ?? "conversational",
-      locale: config.locale ?? "auto",
-      zIndex: config.zIndex ?? 99999
-    };
-    this.callbacks = callbacks;
-    this.locale = getLocale(this.config.locale === "auto" ? void 0 : this.config.locale);
-    this.host = document.createElement("div");
-    this.host.id = "mushi-mushi-widget";
-    this.shadow = this.host.attachShadow({ mode: "closed" });
-  }
   mount() {
+    if (this.host.isConnected) return;
     document.body.appendChild(this.host);
+    this.syncAttachedLaunchers();
+    this.syncSmartHide();
     this.render();
   }
+  getIsMounted() {
+    return this.host.isConnected;
+  }
   updateConfig(config = {}) {
     this.config = {
       ...this.config,
       ...config.position ? { position: config.position } : {},
+      ...config.anchor !== void 0 ? { anchor: config.anchor } : {},
       ...config.theme ? { theme: config.theme } : {},
       ...config.triggerText !== void 0 ? { triggerText: config.triggerText || "\u{1F41B}" } : {},
       ...config.expandedTitle !== void 0 ? { expandedTitle: config.expandedTitle } : {},
       ...config.mode ? { mode: config.mode } : {},
       ...config.locale ? { locale: config.locale } : {},
-      ...config.zIndex !== void 0 ? { zIndex: config.zIndex } : {}
+      ...config.zIndex !== void 0 ? { zIndex: config.zIndex } : {},
+      ...config.trigger ? { trigger: config.trigger } : {},
+      ...config.attachToSelector !== void 0 ? { attachToSelector: config.attachToSelector } : {},
+      ...config.inset !== void 0 ? { inset: config.inset } : {},
+      ...config.respectSafeArea !== void 0 ? { respectSafeArea: config.respectSafeArea } : {},
+      ...config.hideOnSelector !== void 0 ? { hideOnSelector: config.hideOnSelector } : {},
+      ...config.hideOnRoutes !== void 0 ? { hideOnRoutes: config.hideOnRoutes } : {},
+      ...config.environments !== void 0 ? { environments: config.environments } : {},
+      ...config.smartHide !== void 0 ? { smartHide: config.smartHide } : {},
+      ...config.draggable !== void 0 ? { draggable: config.draggable } : {},
+      ...config.brandFooter !== void 0 ? { brandFooter: config.brandFooter } : {},
+      ...config.outdatedBanner !== void 0 ? { outdatedBanner: config.outdatedBanner } : {}
     };
     this.locale = getLocale(this.config.locale === "auto" ? void 0 : this.config.locale);
+    this.syncAttachedLaunchers();
+    this.syncSmartHide();
     this.render();
   }
   open(options) {
@@ -933,14 +1108,46 @@ var MushiWidget = class {
   getIsOpen() {
     return this.isOpen;
   }
+  showTrigger() {
+    this.triggerVisible = true;
+    this.render();
+  }
+  hideTrigger() {
+    this.triggerVisible = false;
+    this.render();
+  }
+  setTrigger(trigger) {
+    this.updateConfig({ trigger });
+  }
+  attachTo(selectorOrElement, options = {}) {
+    const elements = typeof selectorOrElement === "string" ? Array.from(document.querySelectorAll(selectorOrElement)) : [selectorOrElement];
+    const cleanups = elements.map((el) => {
+      const onClick = (event) => {
+        event.preventDefault();
+        this.updateConfig(options);
+        this.open();
+      };
+      el.addEventListener("click", onClick);
+      return () => el.removeEventListener("click", onClick);
+    });
+    return () => cleanups.forEach((cleanup) => cleanup());
+  }
   setScreenshotAttached(attached) {
     this.screenshotAttached = attached;
     if (this.isOpen) this.render();
   }
+  setAllowScreenshotRemove(allow) {
+    this.allowScreenshotRemove = allow;
+    if (this.isOpen) this.render();
+  }
   setElementSelected(selected) {
     this.elementSelected = selected;
     if (this.isOpen) this.render();
   }
+  setSdkFreshness(info) {
+    this.sdkFreshness = info;
+    if (this.isOpen) this.render();
+  }
   destroy() {
     if (this.successTimer !== null) {
       clearTimeout(this.successTimer);
@@ -950,8 +1157,83 @@ var MushiWidget = class {
       clearTimeout(this.autoCloseTimer);
       this.autoCloseTimer = null;
     }
+    if (this.smartHideTimer !== null) {
+      clearTimeout(this.smartHideTimer);
+      this.smartHideTimer = null;
+    }
+    this.smartHideCleanup?.();
+    this.smartHideCleanup = null;
+    this.attachedLaunchers.forEach((cleanup) => cleanup());
+    this.attachedLaunchers = [];
     this.host.remove();
   }
+  syncAttachedLaunchers() {
+    this.attachedLaunchers.forEach((cleanup) => cleanup());
+    this.attachedLaunchers = [];
+    if (this.config.trigger !== "attach" || !this.config.attachToSelector) return;
+    if (typeof document === "undefined") return;
+    this.attachedLaunchers.push(this.attachTo(this.config.attachToSelector));
+  }
+  syncSmartHide() {
+    this.smartHideCleanup?.();
+    this.smartHideCleanup = null;
+    this.triggerShrunk = false;
+    this.triggerHiddenByScroll = false;
+    if (!this.config.smartHide || typeof window === "undefined") return;
+    const smart = this.config.smartHide === true ? { onScroll: "shrink", onIdleMs: 900 } : this.config.smartHide;
+    if (!smart.onScroll) return;
+    const onScroll = () => {
+      if (smart.onScroll === "hide") {
+        this.triggerHiddenByScroll = true;
+      } else {
+        this.triggerShrunk = true;
+      }
+      this.render();
+      if (this.smartHideTimer !== null) clearTimeout(this.smartHideTimer);
+      this.smartHideTimer = setTimeout(() => {
+        this.triggerHiddenByScroll = false;
+        this.triggerShrunk = false;
+        this.render();
+      }, smart.onIdleMs ?? 900);
+    };
+    window.addEventListener("scroll", onScroll, { passive: true });
+    this.smartHideCleanup = () => window.removeEventListener("scroll", onScroll);
+  }
+  shouldRenderTrigger() {
+    if (!this.triggerVisible) return false;
+    if (this.triggerHiddenByScroll) return false;
+    if (this.config.trigger === "manual" || this.config.trigger === "hidden" || this.config.trigger === "attach") {
+      return false;
+    }
+    if (this.isMobileSmartHidden()) return false;
+    if (this.isRouteHidden()) return false;
+    if (this.config.hideOnSelector && document.querySelector(this.config.hideOnSelector)) return false;
+    const action = this.config.environments[this.detectEnvironment()];
+    return action !== "never" && action !== "manual";
+  }
+  effectiveTrigger() {
+    if (!this.config.smartHide || typeof window === "undefined") return this.config.trigger;
+    const smart = this.config.smartHide === true ? { onMobile: "edge-tab" } : this.config.smartHide;
+    if (window.matchMedia("(max-width: 768px)").matches && smart.onMobile === "edge-tab") {
+      return "edge-tab";
+    }
+    return this.config.trigger;
+  }
+  isMobileSmartHidden() {
+    if (!this.config.smartHide || typeof window === "undefined") return false;
+    const smart = this.config.smartHide === true ? { onMobile: "edge-tab" } : this.config.smartHide;
+    return window.matchMedia("(max-width: 768px)").matches && smart.onMobile === "hide";
+  }
+  detectEnvironment() {
+    const host = typeof location !== "undefined" ? location.hostname : "";
+    if (host === "localhost" || host === "127.0.0.1" || host.endsWith(".local")) return "development";
+    if (/\b(staging|stage|preview|dev)\b/i.test(host)) return "staging";
+    return "production";
+  }
+  isRouteHidden() {
+    if (!this.config.hideOnRoutes.length || typeof location === "undefined") return false;
+    return this.config.hideOnRoutes.some((route) => location.pathname.includes(route));
+  }
   getTheme() {
     if (this.config.theme !== "auto") return this.config.theme;
     if (typeof window !== "undefined" && window.matchMedia("(prefers-color-scheme: dark)").matches) {
@@ -967,31 +1249,59 @@ var MushiWidget = class {
     const style = document.createElement("style");
     style.textContent = getWidgetStyles(theme);
     this.shadow.appendChild(style);
-    const trigger = document.createElement("button");
-    trigger.className = `mushi-trigger ${pos}`;
-    trigger.textContent = this.config.triggerText;
-    trigger.setAttribute("aria-label", t.widget.trigger);
-    trigger.setAttribute("aria-haspopup", "dialog");
-    trigger.setAttribute("aria-expanded", String(this.isOpen));
-    trigger.style.zIndex = String(this.config.zIndex);
-    trigger.addEventListener("click", () => {
-      if (this.isOpen) this.close();
-      else this.open();
-    });
-    this.shadow.appendChild(trigger);
+    if (this.shouldRenderTrigger()) {
+      const effectiveTrigger = this.effectiveTrigger();
+      const trigger = document.createElement("button");
+      trigger.className = `mushi-trigger ${pos}${effectiveTrigger === "edge-tab" ? " edge-tab" : ""}${this.triggerShrunk ? " shrunk" : ""}`;
+      trigger.textContent = this.config.triggerText;
+      trigger.setAttribute("aria-label", t.widget.trigger);
+      trigger.setAttribute("aria-haspopup", "dialog");
+      trigger.setAttribute("aria-expanded", String(this.isOpen));
+      trigger.style.zIndex = String(this.config.zIndex);
+      this.applyInsetVars(trigger);
+      trigger.addEventListener("click", () => {
+        if (this.isOpen) this.close();
+        else this.open();
+      });
+      this.shadow.appendChild(trigger);
+    }
     const panel = document.createElement("div");
     panel.className = `mushi-panel ${pos}${this.isOpen ? " open" : " closed"}`;
     panel.setAttribute("role", "dialog");
     panel.setAttribute("aria-modal", "true");
     panel.setAttribute("aria-label", t.widget.title);
     panel.style.zIndex = String(this.config.zIndex + 1);
+    this.applyInsetVars(panel);
     if (this.isOpen) {
-      panel.innerHTML = this.renderStep();
+      panel.innerHTML = `${this.renderOutdatedBanner()}${this.renderStep()}${this.renderBrandFooter()}`;
       this.shadow.appendChild(panel);
       this.attachHandlers(panel);
       this.trapFocus(panel);
     }
   }
+  applyInsetVars(el) {
+    const { anchor } = this.config;
+    if (anchor && Object.keys(anchor).length > 0) {
+      ["top", "right", "bottom", "left"].forEach((edge) => {
+        const value = anchor[edge];
+        if (value !== void 0) el.style.setProperty(`--mushi-${edge}`, value);
+      });
+      el.style.setProperty("--mushi-safe-area", this.config.respectSafeArea ? "1" : "0");
+      return;
+    }
+    const { inset } = this.config;
+    if (!this.config.respectSafeArea) {
+      ["top", "right", "bottom", "left"].forEach((edge) => {
+        if (inset[edge] === void 0) el.style.setProperty(`--mushi-${edge}`, "24px");
+      });
+    }
+    ["top", "right", "bottom", "left"].forEach((edge) => {
+      const value = inset[edge];
+      if (value === void 0) return;
+      el.style.setProperty(`--mushi-${edge}`, value === "auto" ? "auto" : `${value}px`);
+    });
+    el.style.setProperty("--mushi-safe-area", this.config.respectSafeArea ? "1" : "0");
+  }
   renderStep() {
     switch (this.step) {
       case "category":
@@ -1002,8 +1312,29 @@ var MushiWidget = class {
         return this.renderDetailsStep();
       case "success":
         return this.renderSuccessStep();
+      case "reports":
+        return this.renderReportsStep();
+      case "report-detail":
+        return this.renderReportDetailStep();
     }
   }
+  renderOutdatedBanner() {
+    if (!this.sdkFreshness) return "";
+    if (this.config.outdatedBanner === "off" || this.config.outdatedBanner === "console-only") return "";
+    const { latest, current, deprecated, message } = this.sdkFreshness;
+    if (!latest && !deprecated) return "";
+    return `
+      <div class="mushi-outdated" role="status">
+        <strong>Mushi SDK ${escapeHtml(current)}</strong>
+        ${latest ? `latest is ${escapeHtml(latest)}.` : "needs attention."}
+        ${message ? `<span>${escapeHtml(message)}</span>` : ""}
+      </div>
+    `;
+  }
+  renderBrandFooter() {
+    if (this.config.brandFooter === false) return "";
+    return `<div class="mushi-brand-footer">Powered by Mushi v${escapeHtml(this.sdkVersion)}</div>`;
+  }
   /**
    * Editorial masthead. Always carries:
    *   • the brand mark (虫 kanji on vermillion, "MUSHI" in mono above)
@@ -1062,11 +1393,61 @@ var MushiWidget = class {
     return `
       ${this.renderHeader({ title: t.step1.heading, step: STEP_NUMBER.category })}
       <div class="mushi-body" role="radiogroup" aria-label="${t.step1.heading}">
+        <button type="button" class="mushi-option-btn mushi-reports-entry" data-action="reports">
+          <span class="mushi-option-icon" aria-hidden="true">\u{1F4EC}</span>
+          <div class="mushi-option-text">
+            <span class="mushi-option-label">Your reports${this.unreadCount() ? ` (${this.unreadCount()} new)` : ""}</span>
+            <span class="mushi-option-desc">See status, developer replies, and respond</span>
+          </div>
+          <span class="mushi-option-arrow" aria-hidden="true">\u2192</span>
+        </button>
         ${categories}
       </div>
       ${this.renderStepIndicator(STEP_NUMBER.category)}
     `;
   }
+  renderReportsStep() {
+    const reports = this.reporterReports.map((report) => `
+      <button type="button" class="mushi-report-row" data-report-id="${escapeHtml(report.id)}">
+        <span class="mushi-report-status">${escapeHtml(report.status)}</span>
+        <span class="mushi-report-title">${escapeHtml(report.summary ?? report.description ?? `Report ${report.id.slice(0, 8)}`)}</span>
+        ${report.unread_count ? `<b>${report.unread_count}</b>` : ""}
+      </button>
+    `).join("");
+    return `
+      ${this.renderHeader({ title: "Your reports", showBack: true, eyebrow: "Mushi \xB7 Inbox" })}
+      <div class="mushi-body">
+        ${this.reporterLoading ? '<p class="mushi-muted">Loading reports\u2026</p>' : ""}
+        ${this.reporterError ? `<p class="mushi-error-inline">${escapeHtml(this.reporterError)}</p>` : ""}
+        ${reports || (!this.reporterLoading ? '<p class="mushi-muted">No reports from this browser yet.</p>' : "")}
+      </div>
+    `;
+  }
+  renderReportDetailStep() {
+    const report = this.reporterReports.find((r) => r.id === this.selectedReportId);
+    const comments = this.reporterComments.map((comment) => `
+      <div class="mushi-thread-comment ${comment.author_kind}">
+        <strong>${escapeHtml(comment.author_kind === "reporter" ? "You" : comment.author_name ?? "Developer")}</strong>
+        <p>${escapeHtml(comment.body)}</p>
+      </div>
+    `).join("");
+    return `
+      ${this.renderHeader({ title: "Report thread", showBack: true, eyebrow: "Mushi \xB7 Inbox" })}
+      <div class="mushi-body">
+        <div class="mushi-thread-summary">
+          <span>${escapeHtml(report?.status ?? "unknown")}</span>
+          <p>${escapeHtml(report?.summary ?? report?.description ?? "Report details")}</p>
+        </div>
+        <div class="mushi-thread">
+          ${this.reporterLoading ? '<p class="mushi-muted">Loading thread\u2026</p>' : comments || '<p class="mushi-muted">No developer replies yet.</p>'}
+        </div>
+        <textarea class="mushi-textarea" data-role="reporter-reply" rows="3" placeholder="Reply to the developer\u2026"></textarea>
+        <button type="button" class="mushi-submit" data-action="reporter-reply">
+          <span>Reply</span><span class="mushi-submit-arrow" aria-hidden="true">\u2192</span>
+        </button>
+      </div>
+    `;
+  }
   renderIntentStep() {
     const t = this.locale;
     const cat = this.selectedCategory;
@@ -1106,6 +1487,7 @@ var MushiWidget = class {
           <button type="button" class="mushi-attach-btn${this.screenshotAttached ? " active" : ""}" data-action="screenshot">
             \u{1F4F8} ${this.screenshotAttached ? t.step3.screenshotAttached : t.step3.screenshotButton}
           </button>
+          ${this.screenshotAttached && this.allowScreenshotRemove ? '<button type="button" class="mushi-attach-btn danger" data-action="remove-screenshot">\u2715 Remove screenshot</button>' : ""}
           <button type="button" class="mushi-attach-btn${this.elementSelected ? " active" : ""}" data-action="element">
             \u{1F3AF} ${this.elementSelected ? t.step3.elementSelected : t.step3.elementButton}
           </button>
@@ -1158,9 +1540,26 @@ var MushiWidget = class {
       } else if (this.step === "details") {
         this.step = "intent";
         this.selectedIntent = null;
+      } else if (this.step === "reports") {
+        this.step = "category";
+      } else if (this.step === "report-detail") {
+        this.step = "reports";
+        this.selectedReportId = null;
       }
       this.render();
     });
+    panel.querySelector('[data-action="reports"]')?.addEventListener("click", () => {
+      void this.loadReporterReports();
+    });
+    panel.querySelectorAll("[data-report-id]").forEach((btn) => {
+      btn.addEventListener("click", () => {
+        const reportId = btn.dataset.reportId;
+        if (reportId) void this.loadReporterComments(reportId);
+      });
+    });
+    panel.querySelector('[data-action="reporter-reply"]')?.addEventListener("click", () => {
+      void this.submitReporterReply(panel);
+    });
     panel.querySelectorAll("[data-category]").forEach((btn) => {
       btn.addEventListener("click", () => {
         this.selectedCategory = btn.dataset.category;
@@ -1178,6 +1577,9 @@ var MushiWidget = class {
     panel.querySelector('[data-action="screenshot"]')?.addEventListener("click", () => {
       this.callbacks.onScreenshotRequest();
     });
+    panel.querySelector('[data-action="remove-screenshot"]')?.addEventListener("click", () => {
+      this.callbacks.onScreenshotRemove?.();
+    });
     panel.querySelector('[data-action="element"]')?.addEventListener("click", () => {
       this.callbacks.onElementSelectorRequest?.();
     });
@@ -1235,6 +1637,57 @@ var MushiWidget = class {
       if (focusable.length > 0) focusable[0].focus();
     });
   }
+  unreadCount() {
+    return this.reporterReports.reduce((sum, report) => sum + (report.unread_count ?? 0), 0);
+  }
+  async loadReporterReports() {
+    this.step = "reports";
+    this.reporterLoading = true;
+    this.reporterError = null;
+    this.render();
+    try {
+      this.reporterReports = await this.callbacks.onReporterReportsRequest?.() ?? [];
+    } catch (err) {
+      this.reporterError = err instanceof Error ? err.message : "Could not load reports.";
+    } finally {
+      this.reporterLoading = false;
+      this.render();
+    }
+  }
+  async loadReporterComments(reportId) {
+    this.selectedReportId = reportId;
+    this.step = "report-detail";
+    this.reporterLoading = true;
+    this.reporterError = null;
+    this.render();
+    try {
+      this.reporterComments = await this.callbacks.onReporterCommentsRequest?.(reportId) ?? [];
+    } catch (err) {
+      this.reporterError = err instanceof Error ? err.message : "Could not load thread.";
+    } finally {
+      this.reporterLoading = false;
+      this.render();
+    }
+  }
+  async submitReporterReply(panel) {
+    const reportId = this.selectedReportId;
+    const textarea = panel.querySelector('[data-role="reporter-reply"]');
+    const replyButton = panel.querySelector('[data-action="reporter-reply"]');
+    const body = textarea?.value.trim() ?? "";
+    if (!reportId || !body || this.reporterLoading) return;
+    this.reporterLoading = true;
+    if (replyButton) replyButton.disabled = true;
+    this.render();
+    try {
+      await this.callbacks.onReporterReply?.(reportId, body);
+      if (textarea) textarea.value = "";
+      await this.loadReporterComments(reportId);
+    } catch (err) {
+      this.reporterError = err instanceof Error ? err.message : "Could not send reply.";
+      this.reporterLoading = false;
+      this.render();
+    }
+  }
 };
 
 // src/capture/console.ts
@@ -1286,35 +1739,109 @@ function createConsoleCapture() {
     }
   };
 }
+var DEFAULT_INTERNAL_URL_MATCHERS = [
+  /\/v1\/sdk(?:\/|$)/,
+  /\/v1\/reports(?:\/|$)/,
+  /\/v1\/notifications(?:\/|$)/,
+  /\/v1\/reputation(?:\/|$)/
+];
+function getRequestUrl(input) {
+  if (typeof input === "string") return input;
+  if (input instanceof URL) return input.href;
+  return input.url;
+}
+function getInternalRequestKind(input, init) {
+  const marker = init?.[MUSHI_INTERNAL_INIT_MARKER];
+  if (marker) return marker;
+  const initHeader = readHeader(init?.headers, MUSHI_INTERNAL_HEADER);
+  if (initHeader) return initHeader;
+  if (typeof Request !== "undefined" && input instanceof Request) {
+    const requestHeader = input.headers.get(MUSHI_INTERNAL_HEADER);
+    if (requestHeader) return requestHeader;
+  }
+  return null;
+}
+function shouldIgnoreMushiUrl(url, options = {}) {
+  const matchers = [...DEFAULT_INTERNAL_URL_MATCHERS, ...options.ignoreUrls ?? []];
+  if (matchers.some((matcher) => matchesUrl(url, matcher))) return true;
+  const endpoint = normalizeUrlPrefix(options.apiEndpoint);
+  return endpoint ? normalizeComparableUrl(url).startsWith(endpoint) : false;
+}
+function matchesUrl(url, matcher) {
+  if (typeof matcher === "string") {
+    return normalizeComparableUrl(url).includes(matcher);
+  }
+  matcher.lastIndex = 0;
+  return matcher.test(url);
+}
+function normalizeUrlPrefix(url) {
+  if (!url) return null;
+  return normalizeComparableUrl(url).replace(/\/+$/, "");
+}
+function isLocalhostEndpoint(url) {
+  if (!url) return false;
+  try {
+    const parsed = new URL(url);
+    return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "::1" || parsed.hostname.endsWith(".localhost");
+  } catch {
+    return /\blocalhost\b|127\.0\.0\.1/.test(url);
+  }
+}
+function normalizeComparableUrl(url) {
+  try {
+    return new URL(url, typeof location !== "undefined" ? location.href : "http://localhost").href;
+  } catch {
+    return url;
+  }
+}
+function readHeader(headers, name) {
+  if (!headers) return null;
+  if (typeof Headers !== "undefined" && headers instanceof Headers) {
+    return headers.get(name);
+  }
+  if (Array.isArray(headers)) {
+    const found = headers.find(([key]) => key.toLowerCase() === name.toLowerCase());
+    return found?.[1] ?? null;
+  }
+  const record = headers;
+  return record[name] ?? record[name.toLowerCase()] ?? null;
+}
 
 // src/capture/network.ts
 var MAX_ENTRIES2 = 30;
-function createNetworkCapture() {
+function createNetworkCapture(options = {}) {
   const entries = [];
   const originalFetch = globalThis.fetch;
+  let activeOptions = options;
   globalThis.fetch = async function mushiFetchInterceptor(input, init) {
     const startTime = Date.now();
     const method = init?.method?.toUpperCase() ?? "GET";
-    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const url = getRequestUrl(input);
+    const internalKind = getInternalRequestKind(input, init);
+    const shouldRecord = !internalKind && !shouldIgnoreMushiUrl(url, activeOptions);
     try {
       const response = await originalFetch.call(globalThis, input, init);
-      addEntry({
-        method,
-        url: truncateUrl(url),
-        status: response.status,
-        duration: Date.now() - startTime,
-        timestamp: startTime
-      });
+      if (shouldRecord) {
+        addEntry({
+          method,
+          url: truncateUrl(url),
+          status: response.status,
+          duration: Date.now() - startTime,
+          timestamp: startTime
+        });
+      }
       return response;
     } catch (error) {
-      addEntry({
-        method,
-        url: truncateUrl(url),
-        status: 0,
-        duration: Date.now() - startTime,
-        timestamp: startTime,
-        error: error instanceof Error ? error.message : "Network error"
-      });
+      if (shouldRecord) {
+        addEntry({
+          method,
+          url: truncateUrl(url),
+          status: 0,
+          duration: Date.now() - startTime,
+          timestamp: startTime,
+          error: error instanceof Error ? error.message : "Network error"
+        });
+      }
       throw error;
     }
   };
@@ -1331,6 +1858,9 @@ function createNetworkCapture() {
     clear() {
       entries.length = 0;
     },
+    updateOptions(nextOptions) {
+      activeOptions = nextOptions;
+    },
     destroy() {
       globalThis.fetch = originalFetch;
     }
@@ -1350,7 +1880,8 @@ function truncateUrl(url) {
 }
 
 // src/capture/screenshot.ts
-function createScreenshotCapture() {
+function createScreenshotCapture(options = {}) {
+  let activeOptions = options;
   async function take() {
     try {
       if (typeof document === "undefined") return null;
@@ -1363,11 +1894,12 @@ function createScreenshotCapture() {
       canvas.width = width * dpr;
       canvas.height = height * dpr;
       ctx.scale(dpr, dpr);
+      const safeDocument = buildPrivacySafeDocument(activeOptions.privacy);
       const svgData = `
         <svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">
           <foreignObject width="100%" height="100%">
             <div xmlns="http://www.w3.org/1999/xhtml">
-              ${new XMLSerializer().serializeToString(document.documentElement)}
+              ${new XMLSerializer().serializeToString(safeDocument)}
             </div>
           </foreignObject>
         </svg>
@@ -1396,7 +1928,46 @@ function createScreenshotCapture() {
       return null;
     }
   }
-  return { take };
+  return {
+    take,
+    updateOptions(nextOptions) {
+      activeOptions = nextOptions;
+    }
+  };
+}
+function buildPrivacySafeDocument(privacy) {
+  const clone = document.documentElement.cloneNode(true);
+  for (const selector of privacy?.blockSelectors ?? []) {
+    for (const el of safeQueryAll(clone, selector)) {
+      el.remove();
+    }
+  }
+  for (const selector of privacy?.maskSelectors ?? []) {
+    for (const el of safeQueryAll(clone, selector)) {
+      maskElement(el);
+    }
+  }
+  return clone;
+}
+function safeQueryAll(root, selector) {
+  try {
+    return Array.from(root.querySelectorAll(selector));
+  } catch {
+    return [];
+  }
+}
+function maskElement(el) {
+  if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+    el.value = "";
+    el.setAttribute("value", "");
+    el.setAttribute("placeholder", "\u2022\u2022\u2022\u2022");
+  }
+  el.textContent = el.children.length === 0 ? "\u2022\u2022\u2022\u2022" : el.textContent;
+  el.setAttribute(
+    "style",
+    `${el.getAttribute("style") ?? ""};background:#8f8f8f!important;color:transparent!important;text-shadow:none!important;`
+  );
+  el.setAttribute("data-mushi-masked", "true");
 }
 
 // src/capture/performance.ts
@@ -1585,6 +2156,108 @@ function createElementSelector() {
   return { activate, deactivate, isActive: () => active };
 }
 
+// src/capture/timeline.ts
+var MAX_TIMELINE_ENTRIES = 120;
+function createTimelineCapture() {
+  const entries = [];
+  const originalPushState = history.pushState;
+  const originalReplaceState = history.replaceState;
+  const handlePopState = () => recordRoute("popstate");
+  const handleHashChange = () => recordRoute("hashchange");
+  recordRoute("initial");
+  function record(entry) {
+    entries.push(entry);
+    if (entries.length > MAX_TIMELINE_ENTRIES) entries.shift();
+  }
+  function recordRoute(source) {
+    if (typeof location === "undefined") return;
+    record({
+      ts: Date.now(),
+      kind: "route",
+      payload: {
+        source,
+        route: `${location.pathname}${location.search}${location.hash}`,
+        href: location.href
+      }
+    });
+  }
+  function handleClick(event) {
+    const target = event.target instanceof Element ? event.target : null;
+    if (!target) return;
+    const el = target.closest('button,a,[role="button"],input,textarea,select,[data-mushi-track]') ?? target;
+    record({
+      ts: Date.now(),
+      kind: "click",
+      payload: {
+        tag: el.tagName.toLowerCase(),
+        id: el.id || void 0,
+        text: textSnippet(el)
+      }
+    });
+  }
+  history.pushState = function mushiPushState(...args) {
+    const result = originalPushState.apply(this, args);
+    recordRoute("pushState");
+    return result;
+  };
+  history.replaceState = function mushiReplaceState(...args) {
+    const result = originalReplaceState.apply(this, args);
+    recordRoute("replaceState");
+    return result;
+  };
+  window.addEventListener("popstate", handlePopState);
+  window.addEventListener("hashchange", handleHashChange);
+  document.addEventListener("click", handleClick, true);
+  return {
+    setScreen(screen) {
+      record({
+        ts: Date.now(),
+        kind: "screen",
+        payload: screen
+      });
+    },
+    getEntries(input = {}) {
+      const merged = [
+        ...entries,
+        ...(input.consoleLogs ?? []).map((log) => ({
+          ts: log.timestamp,
+          kind: "log",
+          payload: {
+            level: log.level,
+            message: log.message
+          }
+        })),
+        ...(input.networkLogs ?? []).map((network) => ({
+          ts: network.timestamp,
+          kind: "request",
+          payload: {
+            method: network.method,
+            url: network.url,
+            status: network.status,
+            duration: network.duration,
+            error: network.error
+          }
+        }))
+      ].sort((a, b) => a.ts - b.ts);
+      return merged.slice(-MAX_TIMELINE_ENTRIES);
+    },
+    clear() {
+      entries.length = 0;
+    },
+    destroy() {
+      history.pushState = originalPushState;
+      history.replaceState = originalReplaceState;
+      window.removeEventListener("popstate", handlePopState);
+      window.removeEventListener("hashchange", handleHashChange);
+      document.removeEventListener("click", handleClick, true);
+    }
+  };
+}
+function textSnippet(el) {
+  const text = (el.textContent ?? "").replace(/\s+/g, " ").trim();
+  return text ? text.slice(0, 80) : void 0;
+}
+
 // src/sentry.ts
 function getSentryGlobal() {
   try {
@@ -1671,36 +2344,25 @@ function setupProactiveTriggers(callbacks, config = {}) {
     } catch {
     }
   }
-  if (config.apiCascade !== false) {
+  const apiCascade = normalizeApiCascadeConfig(config.apiCascade);
+  if (apiCascade.enabled) {
     const failedRequests = [];
     const origFetch = globalThis.fetch;
     globalThis.fetch = async function(...args) {
+      const [input, init] = args;
+      const url = getRequestUrl(input);
+      const ignoreFailure = Boolean(getInternalRequestKind(input, init)) || shouldIgnoreMushiUrl(url, {
+        apiEndpoint: config.apiEndpoint,
+        ignoreUrls: apiCascade.ignoreUrls
+      });
       try {
         const res = await origFetch.apply(this, args);
-        if (!res.ok && res.status >= 400) {
-          const now = Date.now();
-          failedRequests.push(now);
-          const recentFailures = failedRequests.filter((t) => now - t < 1e4);
-          if (recentFailures.length >= 3) {
-            callbacks.onTrigger("api_cascade", {
-              failureCount: recentFailures.length,
-              windowMs: 1e4
-            });
-            failedRequests.length = 0;
-          }
+        if (!ignoreFailure && !res.ok && res.status >= 400) {
+          recordApiFailure(failedRequests, callbacks);
         }
         return res;
       } catch (err) {
-        const now = Date.now();
-        failedRequests.push(now);
-        const recentFailures = failedRequests.filter((t) => now - t < 1e4);
-        if (recentFailures.length >= 3) {
-          callbacks.onTrigger("api_cascade", {
-            failureCount: recentFailures.length,
-            windowMs: 1e4
-          });
-          failedRequests.length = 0;
-        }
+        if (!ignoreFailure) recordApiFailure(failedRequests, callbacks);
         throw err;
       }
     };
@@ -1735,6 +2397,28 @@ function setupProactiveTriggers(callbacks, config = {}) {
     }
   };
 }
+function normalizeApiCascadeConfig(config) {
+  if (config === false) return { enabled: false, ignoreUrls: [] };
+  if (config && typeof config === "object") {
+    return {
+      enabled: config.enabled !== false,
+      ignoreUrls: config.ignoreUrls ?? []
+    };
+  }
+  return { enabled: true, ignoreUrls: [] };
+}
+function recordApiFailure(failedRequests, callbacks) {
+  const now = Date.now();
+  failedRequests.push(now);
+  const recentFailures = failedRequests.filter((t) => now - t < 1e4);
+  if (recentFailures.length >= 3) {
+    callbacks.onTrigger("api_cascade", {
+      failureCount: recentFailures.length,
+      windowMs: 1e4
+    });
+    failedRequests.length = 0;
+  }
+}
 
 // src/proactive-manager.ts
 var STORAGE_KEY_LAST_DISMISS = "mushi:lastDismiss";
@@ -1787,6 +2471,10 @@ function createProactiveManager(config = {}) {
   return { shouldShow, recordDismissal, recordSubmission, reset };
 }
 
+// src/version.ts
+var MUSHI_SDK_PACKAGE = "@mushi-mushi/web";
+var MUSHI_SDK_VERSION = "0.8.0" ;
+
 // src/mushi.ts
 var instance = null;
 var Mushi = class {
@@ -1816,18 +2504,21 @@ var Mushi = class {
     instance?.destroy();
     instance = null;
   }
+  static diagnose() {
+    return instance?.diagnose() ?? diagnoseWithoutInstance();
+  }
 };
 function createInstance(config) {
-  const bootstrapConfig = config;
-  let activeConfig = config;
+  const bootstrapConfig = applyPresetConfig(config);
+  let activeConfig = bootstrapConfig;
   const log = config.debug ?? false ? createLogger({ scope: "mushi", level: "debug", format: "pretty" }) : noopLogger;
   const apiClient = createApiClient({
-    projectId: config.projectId,
-    apiKey: config.apiKey,
-    ...config.apiEndpoint ? { apiEndpoint: config.apiEndpoint } : {}
+    projectId: bootstrapConfig.projectId,
+    apiKey: bootstrapConfig.apiKey,
+    ...bootstrapConfig.apiEndpoint ? { apiEndpoint: bootstrapConfig.apiEndpoint } : {}
   });
-  const preFilter = createPreFilter(config.preFilter);
-  const offlineQueue = createOfflineQueue(config.offline);
+  const preFilter = createPreFilter(bootstrapConfig.preFilter);
+  const offlineQueue = createOfflineQueue(bootstrapConfig.offline);
   const rateLimiter = createRateLimiter({ maxBurst: 10, refillRate: 1, refillIntervalMs: 5e3 });
   const piiScrubber = createPiiScrubber();
   let consoleCap = null;
@@ -1835,6 +2526,8 @@ function createInstance(config) {
   let perfCap = null;
   let screenshotCap = null;
   let elementSelector = null;
+  const timelineCap = createTimelineCapture();
+  let widget;
   function syncCaptureModules() {
     if (activeConfig.capture?.console !== false) {
       consoleCap ??= createConsoleCapture();
@@ -1843,7 +2536,15 @@ function createInstance(config) {
       consoleCap = null;
     }
     if (activeConfig.capture?.network !== false) {
-      networkCap ??= createNetworkCapture();
+      const networkOptions = {
+        apiEndpoint: resolveApiEndpoint(activeConfig),
+        ignoreUrls: activeConfig.capture?.ignoreUrls
+      };
+      if (networkCap) {
+        networkCap.updateOptions(networkOptions);
+      } else {
+        networkCap = createNetworkCapture(networkOptions);
+      }
     } else {
       networkCap?.destroy();
       networkCap = null;
@@ -1854,8 +2555,18 @@ function createInstance(config) {
       perfCap?.destroy();
       perfCap = null;
     }
-    screenshotCap = activeConfig.capture?.screenshot !== "off" ? screenshotCap ?? createScreenshotCapture() : null;
+    if (activeConfig.capture?.screenshot !== "off") {
+      const screenshotOptions = { privacy: activeConfig.privacy };
+      if (screenshotCap) {
+        screenshotCap.updateOptions(screenshotOptions);
+      } else {
+        screenshotCap = createScreenshotCapture(screenshotOptions);
+      }
+    } else {
+      screenshotCap = null;
+    }
     if (!screenshotCap) pendingScreenshot = null;
+    widget.setAllowScreenshotRemove(activeConfig.privacy?.allowUserRemoveScreenshot !== false);
     if (activeConfig.capture?.elementSelector !== false) {
       elementSelector ??= createElementSelector();
     } else {
@@ -1871,10 +2582,10 @@ function createInstance(config) {
   let pendingScreenshot = null;
   let pendingElement = null;
   let pendingProactiveTrigger = null;
+  let runtimeConfigLoaded = false;
   let userInfo = null;
   const customMetadata = {};
-  syncCaptureModules();
-  const widget = new MushiWidget(config.widget, {
+  widget = new MushiWidget(bootstrapConfig.widget, {
     onSubmit: async ({ category, description, intent }) => {
       log.info("Report submitted", { category, intent });
       proactiveManager?.recordSubmission();
@@ -1901,6 +2612,11 @@ function createInstance(config) {
       pendingScreenshot = await screenshotCap.take();
       widget.setScreenshotAttached(pendingScreenshot !== null);
     },
+    onScreenshotRemove: () => {
+      log.debug("Screenshot attachment removed");
+      pendingScreenshot = null;
+      widget.setScreenshotAttached(false);
+    },
     onElementSelectorRequest: async () => {
       if (!elementSelector || activeConfig.capture?.elementSelector === false) return;
       log.debug("Element selector activated");
@@ -1910,8 +2626,23 @@ function createInstance(config) {
         widget.setElementSelected(true);
         log.debug("Element selected", { tagName: el.tagName, xpath: el.xpath });
       }
+    },
+    async onReporterReportsRequest() {
+      const result = await apiClient.listReporterReports(getReporterToken());
+      if (!result.ok) throw new Error(result.error?.message ?? "Could not load reports");
+      return result.data?.reports ?? [];
+    },
+    async onReporterCommentsRequest(reportId) {
+      const result = await apiClient.listReporterComments(reportId, getReporterToken());
+      if (!result.ok) throw new Error(result.error?.message ?? "Could not load thread");
+      return result.data?.comments ?? [];
+    },
+    async onReporterReply(reportId, body) {
+      const result = await apiClient.replyToReporterReport(reportId, getReporterToken(), body);
+      if (!result.ok) throw new Error(result.error?.message ?? "Could not send reply");
     }
-  });
+  }, MUSHI_SDK_VERSION);
+  syncCaptureModules();
   if (typeof document !== "undefined") {
     if (document.readyState === "loading") {
       document.addEventListener("DOMContentLoaded", () => widget.mount());
@@ -1921,7 +2652,7 @@ function createInstance(config) {
   }
   let proactiveTriggers = null;
   let proactiveManager = null;
-  const proactiveCfg = config.proactive;
+  const proactiveCfg = activeConfig.proactive;
   const hasAnyProactive = proactiveCfg && (proactiveCfg.rageClick !== false || proactiveCfg.longTask !== false || proactiveCfg.apiCascade !== false || proactiveCfg.errorBoundary === true);
   if (hasAnyProactive && typeof document !== "undefined") {
     proactiveManager = createProactiveManager(proactiveCfg?.cooldown);
@@ -1942,6 +2673,7 @@ function createInstance(config) {
         rageClick: proactiveCfg?.rageClick,
         longTask: proactiveCfg?.longTask,
         apiCascade: proactiveCfg?.apiCascade,
+        apiEndpoint: resolveApiEndpoint(activeConfig),
         errorBoundary: proactiveCfg?.errorBoundary
       }
     );
@@ -1957,6 +2689,7 @@ function createInstance(config) {
     if (result.sent > 0) log.info("Synced offline reports", { sent: result.sent });
   });
   function applyRuntimeConfig(runtime) {
+    runtimeConfigLoaded = true;
     if (runtime.enabled === false) {
       activeConfig = bootstrapConfig;
       clearCachedRuntimeConfig(config.projectId);
@@ -1970,7 +2703,7 @@ function createInstance(config) {
     if (runtime.widget) widget.updateConfig(activeConfig.widget);
     log.debug("Applied runtime SDK config", { version: runtime.version });
   }
-  if (config.runtimeConfig !== false) {
+  if (shouldUseRuntimeConfig(config)) {
     const cached = readCachedRuntimeConfig(config.projectId);
     if (cached) applyRuntimeConfig(cached);
     apiClient.getSdkConfig().then((result) => {
@@ -1983,8 +2716,41 @@ function createInstance(config) {
     }).catch((err) => {
       log.debug("Runtime SDK config fetch failed", { error: err instanceof Error ? err.message : String(err) });
     });
+  } else if (config.runtimeConfig !== false && isLocalhostEndpoint(resolveApiEndpoint(config))) {
+    log.debug("Runtime SDK config skipped for localhost apiEndpoint; set runtimeConfig: true to force it");
   }
+  void checkSdkFreshness();
   log.info("Initialized", { projectId: config.projectId });
+  async function checkSdkFreshness() {
+    if (activeConfig.widget?.outdatedBanner === "off") return;
+    const cached = readCachedSdkVersion(MUSHI_SDK_PACKAGE);
+    if (cached) applySdkFreshness(cached);
+    const result = await apiClient.getLatestSdkVersion(MUSHI_SDK_PACKAGE);
+    if (!result.ok || !result.data) return;
+    cacheSdkVersion(MUSHI_SDK_PACKAGE, result.data);
+    applySdkFreshness(result.data);
+  }
+  function applySdkFreshness(info) {
+    const latest = info.latest;
+    const outdated = Boolean(latest && isVersionOlder(MUSHI_SDK_VERSION, latest));
+    if (!outdated && !info.deprecated) return;
+    const message = info.deprecationMessage ?? (outdated ? `Update ${MUSHI_SDK_PACKAGE} to ${latest}.` : null);
+    log.warn("Mushi SDK is outdated", {
+      package: MUSHI_SDK_PACKAGE,
+      current: MUSHI_SDK_VERSION,
+      latest,
+      deprecated: info.deprecated,
+      message
+    });
+    if (activeConfig.widget?.outdatedBanner !== "console-only") {
+      widget.setSdkFreshness({
+        latest,
+        current: MUSHI_SDK_VERSION,
+        deprecated: info.deprecated,
+        message
+      });
+    }
+  }
   async function submitReport(category, description, intent) {
     const filterResult = preFilter.check(description);
     if (!filterResult.passed) {
@@ -2026,6 +2792,8 @@ function createInstance(config) {
     const scrubbedDescription = piiScrubber.scrub(preFilter.truncate(description));
     const sentryCtx = config.sentry ? captureSentryContext(config.sentry) : void 0;
     const fingerprintHash = await getDeviceFingerprintHash().catch(() => null);
+    const consoleLogs = activeConfig.capture?.console === false ? void 0 : consoleCap?.getEntries();
+    const networkLogs = activeConfig.capture?.network === false ? void 0 : networkCap?.getEntries();
     const report = {
       id: crypto.randomUUID?.() ?? `mushi_${Date.now()}_${Math.random().toString(36).slice(2)}`,
       projectId: config.projectId,
@@ -2033,9 +2801,10 @@ function createInstance(config) {
       description: scrubbedDescription,
       userIntent: intent,
       environment: captureEnvironment(),
-      consoleLogs: activeConfig.capture?.console === false ? void 0 : consoleCap?.getEntries(),
-      networkLogs: activeConfig.capture?.network === false ? void 0 : networkCap?.getEntries(),
+      consoleLogs,
+      networkLogs,
       performanceMetrics: activeConfig.capture?.performance === false ? void 0 : perfCap?.getMetrics(),
+      timeline: timelineCap.getEntries({ consoleLogs, networkLogs }),
       screenshotDataUrl: pendingScreenshot ?? void 0,
       selectedElement: pendingElement ?? void 0,
       metadata: {
@@ -2047,6 +2816,8 @@ function createInstance(config) {
       reporterToken: getReporterToken(),
       ...fingerprintHash ? { fingerprintHash } : {},
       appVersion: config.integrations?.vercel?.analyticsId,
+      sdkPackage: MUSHI_SDK_PACKAGE,
+      sdkVersion: MUSHI_SDK_VERSION,
       proactiveTrigger: pendingProactiveTrigger ?? void 0,
       sentryEventId: sentryCtx?.eventId,
       sentryReplayId: sentryCtx?.replayId,
@@ -2101,18 +2872,45 @@ function createInstance(config) {
     setMetadata(key, value) {
       customMetadata[key] = value;
     },
+    setScreen(screen) {
+      timelineCap.setScreen(screen);
+    },
     isOpen() {
       return widget.getIsOpen();
     },
     open() {
       widget.open();
     },
+    openWith(category) {
+      widget.open({ category });
+    },
+    show() {
+      widget.showTrigger();
+    },
+    hide() {
+      widget.hideTrigger();
+    },
+    attachTo(selectorOrElement, options) {
+      return widget.attachTo(selectorOrElement, options);
+    },
+    setTrigger(trigger) {
+      widget.setTrigger(trigger);
+    },
     close() {
       widget.close();
     },
     updateConfig(runtimeConfig) {
       applyRuntimeConfig(runtimeConfig);
     },
+    diagnose() {
+      return runDiagnostics({
+        apiEndpoint: resolveApiEndpoint(activeConfig),
+        widgetMounted: widget.getIsMounted(),
+        runtimeConfigLoaded,
+        captureScreenshotAvailable: screenshotCap !== null,
+        captureNetworkIntercepting: networkCap !== null
+      });
+    },
     destroy() {
       proactiveTriggers?.destroy();
       proactiveManager?.reset();
@@ -2121,6 +2919,7 @@ function createInstance(config) {
       networkCap?.destroy();
       perfCap?.destroy();
       elementSelector?.deactivate();
+      timelineCap.destroy();
       offlineQueue.stopAutoSync();
       listeners.clear();
       instance = null;
@@ -2142,6 +2941,7 @@ function createInstance(config) {
         category,
         description,
         environment: captureEnvironment(),
+        timeline: timelineCap.getEntries(),
         metadata: {
           ...input.metadata ?? {},
           ...userInfo ? { user: userInfo } : {},
@@ -2153,6 +2953,8 @@ function createInstance(config) {
         },
         sessionId: getSessionId(),
         reporterToken: getReporterToken(),
+        sdkPackage: MUSHI_SDK_PACKAGE,
+        sdkVersion: MUSHI_SDK_VERSION,
         createdAt: (/* @__PURE__ */ new Date()).toISOString()
       };
       emit("report:submitted", { reportId: report.id });
@@ -2182,21 +2984,140 @@ function createInstance(config) {
   return sdk;
 }
 function mergeRuntimeConfig(config, runtime) {
+  const nativeTrigger = runtime.native?.triggerMode;
+  const widgetTrigger = runtime.widget?.trigger ?? (nativeTrigger === "none" || nativeTrigger === "shake" ? "manual" : void 0);
   return {
     ...config,
     widget: {
       ...config.widget,
-      ...runtime.widget
+      ...runtime.widget,
+      ...widgetTrigger ? { trigger: widgetTrigger } : {}
     },
     capture: {
       ...config.capture,
       ...runtime.capture
+    },
+    privacy: {
+      ...config.privacy
+    }
+  };
+}
+function applyPresetConfig(config) {
+  if (!config.preset) return config;
+  const preset = presetDefaults(config.preset);
+  return {
+    ...config,
+    widget: {
+      ...preset.widget,
+      ...config.widget
+    },
+    capture: {
+      ...preset.capture,
+      ...config.capture
+    },
+    proactive: {
+      ...preset.proactive,
+      ...config.proactive,
+      cooldown: {
+        ...preset.proactive?.cooldown,
+        ...config.proactive?.cooldown
+      }
     }
   };
 }
+function presetDefaults(preset) {
+  switch (preset) {
+    case "manual-only":
+      return {
+        widget: { trigger: "manual", outdatedBanner: "console-only" },
+        capture: { console: true, network: true, performance: false, screenshot: "on-report", elementSelector: false },
+        proactive: { rageClick: false, longTask: false, apiCascade: false, errorBoundary: false }
+      };
+    case "beta-loud":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "banner" },
+        capture: { console: true, network: true, performance: true, screenshot: "auto", elementSelector: true },
+        proactive: { rageClick: true, longTask: true, apiCascade: true, errorBoundary: true }
+      };
+    case "internal-debug":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "banner", brandFooter: true },
+        capture: { console: true, network: true, performance: true, screenshot: "auto", elementSelector: true },
+        proactive: {
+          rageClick: true,
+          longTask: true,
+          apiCascade: true,
+          errorBoundary: true,
+          cooldown: { maxProactivePerSession: 10, dismissCooldownHours: 0, suppressAfterDismissals: 99 }
+        }
+      };
+    case "production-calm":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "console-only" },
+        capture: { console: true, network: true, performance: false, screenshot: "on-report", elementSelector: false },
+        proactive: { rageClick: false, longTask: false, apiCascade: false, errorBoundary: false }
+      };
+  }
+}
+function resolveApiEndpoint(config) {
+  return config.apiEndpoint ?? DEFAULT_API_ENDPOINT;
+}
+function shouldUseRuntimeConfig(config) {
+  if (config.runtimeConfig === false) return false;
+  if (config.runtimeConfig === true) return true;
+  return !isLocalhostEndpoint(resolveApiEndpoint(config));
+}
+async function runDiagnostics(options) {
+  const endpoint = await probeApiEndpoint(options.apiEndpoint);
+  return {
+    apiEndpointReachable: endpoint.reachable,
+    cspAllowsEndpoint: endpoint.cspAllowed,
+    widgetMounted: options.widgetMounted,
+    shadowDomAvailable: typeof HTMLElement !== "undefined" && typeof HTMLElement.prototype.attachShadow === "function",
+    dialogSupported: typeof HTMLDialogElement !== "undefined",
+    runtimeConfigLoaded: options.runtimeConfigLoaded,
+    captureScreenshotAvailable: options.captureScreenshotAvailable,
+    captureNetworkIntercepting: options.captureNetworkIntercepting,
+    sdkVersion: MUSHI_SDK_VERSION
+  };
+}
+async function diagnoseWithoutInstance() {
+  return {
+    apiEndpointReachable: false,
+    cspAllowsEndpoint: false,
+    widgetMounted: false,
+    shadowDomAvailable: typeof HTMLElement !== "undefined" && typeof HTMLElement.prototype.attachShadow === "function",
+    dialogSupported: typeof HTMLDialogElement !== "undefined",
+    runtimeConfigLoaded: false,
+    captureScreenshotAvailable: false,
+    captureNetworkIntercepting: false,
+    sdkVersion: MUSHI_SDK_VERSION
+  };
+}
+async function probeApiEndpoint(apiEndpoint) {
+  if (typeof fetch === "undefined") return { reachable: false, cspAllowed: false };
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : null;
+  const timer = controller ? setTimeout(() => controller.abort(), 3e3) : null;
+  try {
+    const response = await fetch(`${apiEndpoint.replace(/\/$/, "")}/health`, {
+      method: "GET",
+      cache: "no-store",
+      ...controller ? { signal: controller.signal } : {},
+      [MUSHI_INTERNAL_INIT_MARKER]: "diagnose"
+    });
+    return { reachable: response.ok, cspAllowed: true };
+  } catch {
+    return { reachable: false, cspAllowed: false };
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
 function runtimeConfigCacheKey(projectId) {
   return `mushi:sdk-config:${projectId}`;
 }
+function sdkVersionCacheKey(packageName) {
+  return `mushi:sdk-version:${packageName}`;
+}
 function readCachedRuntimeConfig(projectId) {
   if (typeof localStorage === "undefined") return null;
   try {
@@ -2225,6 +3146,42 @@ function clearCachedRuntimeConfig(projectId) {
   } catch {
   }
 }
+function readCachedSdkVersion(packageName) {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem(sdkVersionCacheKey(packageName));
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed.data || !parsed.cachedAt || Date.now() - parsed.cachedAt > 864e5) return null;
+    return parsed.data;
+  } catch {
+    return null;
+  }
+}
+function cacheSdkVersion(packageName, data) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(sdkVersionCacheKey(packageName), JSON.stringify({
+      cachedAt: Date.now(),
+      data
+    }));
+  } catch {
+  }
+}
+function isVersionOlder(current, latest) {
+  const currentParts = parseVersion(current);
+  const latestParts = parseVersion(latest);
+  for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+    const cur = currentParts[i] ?? 0;
+    const next = latestParts[i] ?? 0;
+    if (cur < next) return true;
+    if (cur > next) return false;
+  }
+  return false;
+}
+function parseVersion(version) {
+  return version.split(/[.-]/).map((part) => Number.parseInt(part, 10)).filter((part) => Number.isFinite(part));
+}
 function createNoopInstance() {
   return {
     report: () => {
@@ -2235,6 +3192,8 @@ function createNoopInstance() {
     },
     setMetadata: () => {
     },
+    setScreen: () => {
+    },
     isOpen: () => false,
     open: () => {
     },
@@ -2242,6 +3201,17 @@ function createNoopInstance() {
     },
     updateConfig: () => {
     },
+    diagnose: diagnoseWithoutInstance,
+    openWith: () => {
+    },
+    show: () => {
+    },
+    hide: () => {
+    },
+    attachTo: () => () => {
+    },
+    setTrigger: () => {
+    },
     destroy: () => {
       instance = null;
     },
@@ -2251,6 +3221,6 @@ function createNoopInstance() {
   };
 }
 
-export { Mushi, MushiWidget, createConsoleCapture, createElementSelector, createNetworkCapture, createPerformanceCapture, createProactiveManager, createScreenshotCapture, getAvailableLocales, getLocale, setupProactiveTriggers };
+export { Mushi, MushiWidget, createConsoleCapture, createElementSelector, createNetworkCapture, createPerformanceCapture, createProactiveManager, createScreenshotCapture, createTimelineCapture, getAvailableLocales, getLocale, setupProactiveTriggers };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map