@omniloy/sofia-sdk 1.0.10 → 1.0.12

package/dist/react/index.es.js

@@ -5145,7 +5145,7 @@ const {
   create: create$1,
 } = axios;
 
-const version$2 = "1.0.10";
+const version$2 = "1.0.12";
 
 const handleApiError$1 = async (error) => {
   return Promise.reject(error);
@@ -5903,6 +5903,11 @@ const ar = {
   "Generation failed": "فشل الإنشاء",
   "Could not generate {category}. Please try again.": "تعذّر إنشاء {category}. يرجى المحاولة مرة أخرى.",
   "The new note is waiting for this review — apply or cancel to continue.": "الملاحظة الجديدة في انتظار هذه المراجعة — طبّق أو ألغِ للمتابعة.",
+  " +{count} more": " +{count} أخرى",
+  "{count} mandatory fields missing in this group": "{count, plural, zero {# حقل إلزامي ناقص} one {# حقل إلزامي ناقص} two {حقلان إلزاميان ناقصان} few {# حقول إلزامية ناقصة} many {# حقلاً إلزامياً ناقصاً} other {# حقل إلزامي ناقص}} في هذه المجموعة",
+  "{group} · row {row}": "{group} · الصف {row}",
+  "{group} · row {row} · {field}": "{group} · الصف {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, zero {# صف يحتاج} one {# صف يحتاج} two {صفّان يحتاجان} few {# صفوف تحتاج} many {# صفاً يحتاج} other {# صف يحتاج}} إلى تحديد النوع في هذه المجموعة",
 };
 
 const Add$b = "Afegir";
@@ -6273,6 +6278,11 @@ const ca = {
   "Generation failed": "La generació ha fallat",
   "Could not generate {category}. Please try again.": "No s'ha pogut generar {category}. Torna-ho a provar.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nova nota està esperant aquesta revisió: aplica o cancel·la per continuar.",
+  " +{count} more": " +{count} més",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # camp obligatori} other {Falten # camps obligatoris}} en aquest grup",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necessita} other {# files necessiten}} que se seleccioni un tipus en aquest grup",
 };
 
 const Add$a = "Afegir";
@@ -6643,6 +6653,11 @@ const ca_valencia = {
   "Generation failed": "La generació ha fallat",
   "Could not generate {category}. Please try again.": "No s'ha pogut generar {category}. Torna-ho a provar.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nova nota està esperant aquesta revisió: aplica o cancel·la per continuar.",
+  " +{count} more": " +{count} més",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # camp obligatori} other {Falten # camps obligatoris}} en este grup",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necessita} other {# files necessiten}} que se seleccione un tipus en este grup",
 };
 
 const Add$9 = "Přidat";
@@ -7013,6 +7028,11 @@ const cs = {
   "Generation failed": "Generování se nezdařilo",
   "Could not generate {category}. Please try again.": "Nepodařilo se vygenerovat {category}. Zkuste to znovu.",
   "The new note is waiting for this review — apply or cancel to continue.": "Nová poznámka čeká na tuto kontrolu — potvrďte ji, nebo ji zrušte, aby mohla pokračovat.",
+  " +{count} more": " +{count} dalších",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Chybí # povinné pole} few {Chybí # povinná pole} other {Chybí # povinných polí}} v této skupině",
+  "{group} · row {row}": "{group} · řádek {row}",
+  "{group} · row {row} · {field}": "{group} · řádek {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {U # řádku} few {U # řádků} other {U # řádků}} v této skupině je třeba vybrat typ",
 };
 
 const Add$8 = "Add";
@@ -7383,6 +7403,11 @@ const en_GB = {
   "Generation failed": "Generation failed",
   "Could not generate {category}. Please try again.": "Could not generate {category}. Please try again.",
   "The new note is waiting for this review — apply or cancel to continue.": "The new note is waiting for this review — apply or cancel to continue.",
+  " +{count} more": " +{count} more",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group",
+  "{group} · row {row}": "{group} · row {row}",
+  "{group} · row {row} · {field}": "{group} · row {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# row needs} other {# rows need}} a type selected in this group",
 };
 
 const Add$7 = "Add";
@@ -7754,6 +7779,11 @@ const en_US = {
   "Generation failed": "Generation failed",
   "Could not generate {category}. Please try again.": "Could not generate {category}. Please try again.",
   "The new note is waiting for this review — apply or cancel to continue.": "The new note is waiting for this review — apply or cancel to continue.",
+  " +{count} more": " +{count} more",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group",
+  "{group} · row {row}": "{group} · row {row}",
+  "{group} · row {row} · {field}": "{group} · row {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# row needs} other {# rows need}} a type selected in this group",
 };
 
 const Add$6 = "Añadir";
@@ -8137,6 +8167,11 @@ const es = {
   "{name} has expressly refused the use of AI, so recording and report generation are unavailable in this consultation.": "{name} ha rechazado expresamente el uso de IA, así que no se puede grabar ni generar informes en esta consulta.",
   "{name} expressly refused the use of AI on {date}, so recording and report generation are unavailable in this consultation.": "{name} rechazó expresamente el uso de IA el {date}, así que no se puede grabar ni generar informes en esta consulta.",
   "this patient": "este paciente",
+  " +{count} more": " +{count} más",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # campo obligatorio} other {Faltan # campos obligatorios}} en este grupo",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necesita} other {# filas necesitan}} que se seleccione un tipo en este grupo",
 };
 
 const Add$5 = "Ajouter";
@@ -8507,6 +8542,11 @@ const fr = {
   "Generation failed": "Échec de la génération",
   "Could not generate {category}. Please try again.": "Impossible de générer {category}. Veuillez réessayer.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nouvelle note attend cette révision : appliquez ou annulez pour continuer.",
+  " +{count} more": " +{count} de plus",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# champ obligatoire manquant} other {# champs obligatoires manquants}} dans ce groupe",
+  "{group} · row {row}": "{group} · ligne {row}",
+  "{group} · row {row} · {field}": "{group} · ligne {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# ligne nécessite} other {# lignes nécessitent}} la sélection d'un type dans ce groupe",
 };
 
 const Add$4 = "जोड़ें";
@@ -8856,6 +8896,11 @@ const hi = {
   "Generation failed": "जनरेशन विफल रहा",
   "Could not generate {category}. Please try again.": "{category} जनरेट नहीं किया जा सका। कृपया पुनः प्रयास करें।",
   "The new note is waiting for this review — apply or cancel to continue.": "नई नोट इस समीक्षा की प्रतीक्षा कर रही है — जारी रखने के लिए लागू करें या रद्द करें।",
+  " +{count} more": " +{count} और",
+  "{count} mandatory fields missing in this group": "इस समूह में {count, plural, one {# अनिवार्य फ़ील्ड खाली है} other {# अनिवार्य फ़ील्ड खाली हैं}}",
+  "{group} · row {row}": "{group} · पंक्ति {row}",
+  "{group} · row {row} · {field}": "{group} · पंक्ति {row} · {field}",
+  "{count} rows need a type selected in this group": "इस समूह में {count, plural, one {# पंक्ति के लिए} other {# पंक्तियों के लिए}} प्रकार चुनना आवश्यक है",
 };
 
 const Add$3 = "Tambahkan";
@@ -9204,6 +9249,11 @@ const id = {
   "Generation failed": "Pembuatan gagal",
   "Could not generate {category}. Please try again.": "Tidak dapat membuat {category}. Silakan coba lagi.",
   "The new note is waiting for this review — apply or cancel to continue.": "Catatan baru menunggu tinjauan ini — terapkan atau batalkan untuk melanjutkan.",
+  " +{count} more": " +{count} lainnya",
+  "{count} mandatory fields missing in this group": "{count, plural, other {# bidang wajib belum diisi}} di grup ini",
+  "{group} · row {row}": "{group} · baris {row}",
+  "{group} · row {row} · {field}": "{group} · baris {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, other {# baris perlu dipilih jenisnya}} di grup ini",
 };
 
 const Add$2 = "ਸ਼ਾਮਲ ਕਰੋ";
@@ -9574,6 +9624,11 @@ const pa = {
   "Generation failed": "ਜਨਰੇਸ਼ਨ ਅਸਫਲ ਰਹੀ",
   "Could not generate {category}. Please try again.": "{category} ਜਨਰੇਟ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਿਆ। ਕਿਰਪਾ ਕਰਕੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ।",
   "The new note is waiting for this review — apply or cancel to continue.": "ਨਵਾਂ ਨੋਟ ਇਸ ਸਮੀਖਿਆ ਦੀ ਉਡੀਕ ਕਰ ਰਿਹਾ ਹੈ — ਜਾਰੀ ਰੱਖਣ ਲਈ ਲਾਗੂ ਕਰੋ ਜਾਂ ਰੱਦ ਕਰੋ।",
+  " +{count} more": " +{count} ਹੋਰ",
+  "{count} mandatory fields missing in this group": "ਇਸ ਸਮੂਹ ਵਿੱਚ {count, plural, one {# ਲਾਜ਼ਮੀ ਖੇਤਰ ਖਾਲੀ ਹੈ} other {# ਲਾਜ਼ਮੀ ਖੇਤਰ ਖਾਲੀ ਹਨ}}",
+  "{group} · row {row}": "{group} · ਕਤਾਰ {row}",
+  "{group} · row {row} · {field}": "{group} · ਕਤਾਰ {row} · {field}",
+  "{count} rows need a type selected in this group": "ਇਸ ਸਮੂਹ ਵਿੱਚ {count, plural, one {# ਕਤਾਰ ਲਈ} other {# ਕਤਾਰਾਂ ਲਈ}} ਕਿਸਮ ਚੁਣਨੀ ਲਾਜ਼ਮੀ ਹੈ",
 };
 
 const Add$1 = "Lägg till";
@@ -9944,6 +9999,11 @@ const sv = {
   "Generation failed": "Genereringen misslyckades",
   "Could not generate {category}. Please try again.": "Det gick inte att generera {category}. Försök igen.",
   "The new note is waiting for this review — apply or cancel to continue.": "Den nya anteckningen väntar på den här granskningen — tillämpa eller avbryt för att fortsätta.",
+  " +{count} more": " +{count} till",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# obligatoriskt fält saknas} other {# obligatoriska fält saknas}} i den här gruppen",
+  "{group} · row {row}": "{group} · rad {row}",
+  "{group} · row {row} · {field}": "{group} · rad {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# rad behöver} other {# rader behöver}} en vald typ i den här gruppen",
 };
 
 const Add = "شامل کریں";
@@ -10315,6 +10375,11 @@ const ur = {
   "Generation failed": "تخلیق ناکام ہو گئی",
   "Could not generate {category}. Please try again.": "{category} تیار نہیں کیا جا سکا۔ براہ کرم دوبارہ کوشش کریں۔",
   "The new note is waiting for this review — apply or cancel to continue.": "نیا نوٹ اس جائزے کا منتظر ہے — جاری رکھنے کے لیے لاگو کریں یا منسوخ کریں۔",
+  " +{count} more": " +{count} مزید",
+  "{count} mandatory fields missing in this group": "اس گروپ میں {count, plural, one {# لازمی خانہ خالی ہے} other {# لازمی خانے خالی ہیں}}",
+  "{group} · row {row}": "{group} · قطار {row}",
+  "{group} · row {row} · {field}": "{group} · قطار {row} · {field}",
+  "{count} rows need a type selected in this group": "اس گروپ میں {count, plural, one {# قطار کے لیے} other {# قطاروں کے لیے}} قسم منتخب کرنا ضروری ہے",
 };
 
 var LanguageCode = /* @__PURE__ */ ((LanguageCode2) => {
@@ -11078,6 +11143,299 @@ const useVadCoverage = () => {
   };
 };
 
+const KNOWN_SDK_EVENT_NAMES = [
+  "recording.started",
+  "recording.stopped",
+  "recording.audio_lost",
+  "recording.microphone_disconnected",
+  "recording.heartbeat",
+  "activity.interaction",
+  "activity.typing",
+  "report.generation_started",
+  "report.settled",
+  "lifecycle.ready",
+  "lifecycle.closed"
+];
+const SDK_EVENT_FAMILIES = [
+  "recording",
+  "activity",
+  "report",
+  "lifecycle"
+];
+const FAMILIES = SDK_EVENT_FAMILIES;
+const familyOf = (name) => {
+  const prefix = name.split(".")[0];
+  return FAMILIES.includes(prefix) ? prefix : "lifecycle";
+};
+
+const KNOWN_NAMES = new Set(KNOWN_SDK_EVENT_NAMES);
+const KNOWN_FAMILIES = new Set(SDK_EVENT_FAMILIES);
+const distance = (a, b) => {
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    let corner = prev[0];
+    prev[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const next = Math.min(
+        prev[j] + 1,
+        prev[j - 1] + 1,
+        corner + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+      corner = prev[j];
+      prev[j] = next;
+    }
+  }
+  return prev[b.length];
+};
+const describeEntry = (entry) => {
+  try {
+    return JSON.stringify(entry) ?? `<${typeof entry}>`;
+  } catch {
+    return `<unserializable ${typeof entry}>`;
+  }
+};
+const suggest = (value, candidates) => {
+  let best = null;
+  let bestScore = Infinity;
+  for (const candidate of candidates) {
+    const score = distance(value, candidate);
+    if (score < bestScore) {
+      bestScore = score;
+      best = candidate;
+    }
+  }
+  return best !== null && bestScore <= Math.max(3, best.length / 3) ? ` Did you mean "${best}"?` : "";
+};
+const REJECTED_KEY_CHARS = 40;
+const scanSubscriptions = (input) => {
+  if (input === void 0 || input === null) {
+    return { patterns: [], rejected: [], unusable: false, key: "" };
+  }
+  const raw = typeof input === "string" ? [input] : input;
+  if (!Array.isArray(raw)) {
+    return {
+      patterns: [],
+      rejected: [],
+      unusable: true,
+      key: `!${typeof input}`
+    };
+  }
+  const patterns = [];
+  const rejected = [];
+  for (const entry of raw) {
+    if (typeof entry !== "string") {
+      rejected.push(entry);
+      continue;
+    }
+    const pattern = entry.trim();
+    if (pattern === "" || patterns.includes(pattern)) continue;
+    patterns.push(pattern);
+  }
+  const key = JSON.stringify(patterns) + (rejected.length > 0 ? `!${rejected.map((entry) => describeEntry(entry).slice(0, REJECTED_KEY_CHARS)).join(",")}` : "");
+  return { patterns, rejected, unusable: false, key };
+};
+const normalizeSubscriptions = (input) => {
+  const { patterns, rejected, unusable, key } = scanSubscriptions(input);
+  const problems = [];
+  const warnings = [];
+  if (unusable) {
+    problems.push(
+      `eventSubscriptions must be an array of strings, received ${typeof input}. No events will be delivered.`
+    );
+    return { patterns, key, problems, warnings };
+  }
+  for (const entry of rejected) {
+    problems.push(
+      `eventSubscriptions entry ${describeEntry(entry)} is not a string and was ignored.`
+    );
+  }
+  for (const pattern of patterns) {
+    if (pattern === "*" || KNOWN_NAMES.has(pattern)) continue;
+    if (pattern.endsWith(".*")) {
+      const family = pattern.slice(0, -2);
+      if (!KNOWN_FAMILIES.has(family)) {
+        const hint2 = suggest(family, KNOWN_FAMILIES);
+        (hint2 ? problems : warnings).push(
+          `"${pattern}" is not a known event family.${hint2}`
+        );
+      }
+      continue;
+    }
+    const hint = suggest(pattern, KNOWN_NAMES);
+    (hint ? problems : warnings).push(
+      `"${pattern}" is not an event this SDK version emits.${hint}`
+    );
+  }
+  const present = input !== void 0 && input !== null;
+  if (present && patterns.length === 0 && problems.length === 0) {
+    problems.push(
+      'eventSubscriptions is empty, so onEvent will never fire. Pass e.g. ["recording.*", "activity.*"] or ["*"].'
+    );
+  }
+  return { patterns, key, problems, warnings };
+};
+const reported = /* @__PURE__ */ new Set();
+const VALID_VALUES = `Valid values are "*", a family wildcard (${SDK_EVENT_FAMILIES.map((f) => `"${f}.*"`).join(", ")}), or an exact name (${KNOWN_SDK_EVENT_NAMES.join(", ")}).`;
+const reportOnce = (level, signature, message) => {
+  if (reported.has(signature)) return;
+  reported.add(signature);
+  if (level === "error") logger.configError(message);
+  else logger.warn(message);
+};
+const reportSubscriptionProblems = ({
+  key,
+  problems,
+  warnings
+}) => {
+  if (problems.length > 0) {
+    reportOnce(
+      "error",
+      `error:${key}:${problems.join("|")}`,
+      `[Sofia SDK] eventSubscriptions: ${problems.join(" ")} ${VALID_VALUES}`
+    );
+  }
+  if (warnings.length > 0) {
+    reportOnce(
+      "warn",
+      `warn:${key}:${warnings.join("|")}`,
+      `[Sofia SDK] eventSubscriptions: ${warnings.join(" ")} ${VALID_VALUES}`
+    );
+  }
+};
+const reportHandlerWithoutSubscriptions = () => {
+  reportOnce(
+    "error",
+    "onEvent:no-subscriptions",
+    "[Sofia SDK] onEvent: onEvent was provided without eventSubscriptions, so no events will be delivered. " + VALID_VALUES
+  );
+};
+const compileSubscription = (input) => {
+  const normalized = normalizeSubscriptions(input);
+  reportSubscriptionProblems(normalized);
+  const { patterns } = normalized;
+  if (patterns.length === 0) return () => false;
+  if (patterns.includes("*")) return () => true;
+  const exact = /* @__PURE__ */ new Set();
+  const families = /* @__PURE__ */ new Set();
+  for (const pattern of patterns) {
+    if (pattern.endsWith(".*")) families.add(pattern.slice(0, -2));
+    else exact.add(pattern);
+  }
+  if (families.size === 0) return (name) => exact.has(name);
+  return (name) => {
+    if (exact.has(name)) return true;
+    const dot = name.indexOf(".");
+    return dot > 0 && families.has(name.slice(0, dot));
+  };
+};
+const subscriptionKey = (input) => scanSubscriptions(input).key;
+
+const QUEUE_CAP = 200;
+let handler = null;
+let matches = () => false;
+let sessionId = null;
+let seq = 0;
+let queue$1 = [];
+let draining = false;
+let handlerFailed = false;
+let registrations = 0;
+const drain = () => {
+  draining = false;
+  const batch = queue$1;
+  queue$1 = [];
+  const current = handler;
+  if (!current) return;
+  for (const event of batch) {
+    try {
+      current(event);
+    } catch {
+      if (!handlerFailed) {
+        handlerFailed = true;
+        logger.warn(
+          "[SdkEvents] onEvent handler threw; further failures suppressed"
+        );
+      }
+    }
+  }
+};
+const schedule = () => {
+  if (draining) return;
+  draining = true;
+  queueMicrotask(drain);
+};
+const SdkEventBus = {
+  /**
+   * Installs the host handler. Returns an unsubscribe. Events that matched
+   * the subscription but arrived before a handler existed are queued and
+   * delivered on the next microtask. That window is real: React runs child
+   * effects before parent ones, so a provider below `Omniscribe` can emit
+   * after `setSubscription` and before this call.
+   */
+  setHandler(next) {
+    registrations += 1;
+    if (next && handler && registrations > 1) {
+      logger.warn(
+        "[SdkEvents] a second onEvent handler was registered. The SDK supports one <Omniscribe> per page; the newest handler wins."
+      );
+    }
+    handler = next;
+    if (next && queue$1.length > 0) schedule();
+    return () => {
+      if (handler === next) handler = null;
+    };
+  },
+  setSubscription(patterns) {
+    matches = compileSubscription(patterns);
+  },
+  setSessionId(next) {
+    sessionId = next;
+  },
+  /**
+   * Cheap guard for callers on a hot path who would otherwise build a
+   * payload for nobody.
+   */
+  wants(name) {
+    return matches(name);
+  },
+  /**
+   * Queues an event for delivery on the next microtask.
+   *
+   * Never throws. Deferring delivery does three things at once: host code
+   * never runs inside React's render phase (where a `setState` would
+   * throw), a slow handler cannot block `socket.onmessage` on the audio
+   * path, and a handler that itself triggers an event cannot recurse —
+   * the re-entrant call only appends to a queue the current drain has
+   * already taken. One shared drain, not one microtask per event, so `seq`
+   * ordering is preserved.
+   */
+  emit(name, payload, level = "info") {
+    if (!matches(name)) return;
+    queue$1.push({
+      name,
+      family: familyOf(name),
+      level,
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      seq: ++seq,
+      sdkVersion: version$2,
+      sessionId,
+      payload
+    });
+    if (queue$1.length > QUEUE_CAP) queue$1.shift();
+    if (handler) schedule();
+  },
+  /** Test-only: restores the module to its initial state. */
+  __resetForTests() {
+    handler = null;
+    matches = () => false;
+    sessionId = null;
+    seq = 0;
+    queue$1 = [];
+    draining = false;
+    handlerFailed = false;
+    registrations = 0;
+  }
+};
+
 const SettingsContext = React__default.createContext(
   void 0
 );
@@ -11118,6 +11476,7 @@ const SettingsProvider = ({
     DEFAULT_MINOR_AGE_THRESHOLD
   );
   const [isLoading, setIsLoading] = React__default.useState(true);
+  const hasEmittedReadyRef = React__default.useRef(false);
   const isInitializedRef = React__default.useRef(false);
   const applySettings = React__default.useCallback(
     (parsed) => {
@@ -11170,6 +11529,10 @@ const SettingsProvider = ({
       SettingsCache.getInstance().clear();
     } finally {
       setIsLoading(false);
+      if (!hasEmittedReadyRef.current) {
+        hasEmittedReadyRef.current = true;
+        SdkEventBus.emit("lifecycle.ready", {});
+      }
     }
   }, [toolArgs, templateId, predefinedLanguage, applySettings]);
   const reloadSettings = React__default.useCallback(async () => {
@@ -17282,8 +17645,147 @@ const evaluateMinorRule = ({
 
 const postAppEvent = (event) => requester.post("/app-events", event).catch(() => void 0);
 
+const ACTIVITY_THROTTLE_MS = 5e3;
+const lastEmittedAt = /* @__PURE__ */ new Map();
+const shouldEmit = (key) => {
+  const now = Date.now();
+  const previous = lastEmittedAt.get(key);
+  if (previous !== void 0 && now - previous < ACTIVITY_THROTTLE_MS) {
+    return false;
+  }
+  lastEmittedAt.set(key, now);
+  return true;
+};
+const emitInteraction = (kind) => {
+  if (!SdkEventBus.wants("activity.interaction")) return;
+  if (!shouldEmit(`interaction:${kind}`)) return;
+  SdkEventBus.emit("activity.interaction", { kind });
+};
+const emitTyping = (surface) => {
+  if (!SdkEventBus.wants("activity.typing")) return;
+  if (!shouldEmit(`typing:${surface}`)) return;
+  SdkEventBus.emit("activity.typing", { surface });
+};
+
+let open$1 = false;
+const openReportBracket = () => {
+  if (open$1) return;
+  open$1 = true;
+  SdkEventBus.emit("report.generation_started", {});
+};
+const closeReportBracket = (ok) => {
+  if (!open$1) return;
+  open$1 = false;
+  SdkEventBus.emit("report.settled", { ok });
+};
+
+const RECORDING_HEARTBEAT_MS = 3e4;
+let lastBeatAt = null;
+const emitRecordingHeartbeat = () => {
+  if (!SdkEventBus.wants("recording.heartbeat")) return;
+  const now = Date.now();
+  if (lastBeatAt !== null && now - lastBeatAt < RECORDING_HEARTBEAT_MS) return;
+  lastBeatAt = now;
+  SdkEventBus.emit("recording.heartbeat", {});
+};
+const resetRecordingHeartbeat = () => {
+  lastBeatAt = null;
+};
+
+const INTERACTION_KIND = {
+  recording_button: "recording",
+  chat_mic_button: "chat",
+  attach_file_button: "chat",
+  remove_file_button: "chat",
+  edit_message_button: "chat",
+  cancel_edit_message_button: "chat",
+  send_edit_message_button: "chat",
+  copy_human_message_button: "chat",
+  copy_ai_message_button: "chat",
+  settings_button: "settings",
+  settings_back_button: "settings",
+  settings_section_button: "settings",
+  select_audio_environment: "settings",
+  compile_summary_button: "report",
+  regenerate_summary_button: "report",
+  generate_extras_button: "report",
+  expand_transcription_button: "transcript",
+  history_thread_item: "history",
+  close_widget_button: "widget",
+  main_menu_button: "widget",
+  play_panel_button: "widget"
+};
+const CLICK_FALLBACK_KIND = "widget";
+const RECORDING_MODES = ["consultation", "dictation"];
+const AUDIO_LOSS_CAUSES = ["mic", "network", "server"];
+const readNumber = (payload, key) => {
+  const value = payload?.[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+};
+const readMode = (payload) => {
+  const value = payload?.mode;
+  return typeof value === "string" && RECORDING_MODES.includes(value) ? value : "consultation";
+};
+const readCause = (payload) => {
+  const value = payload?.cause;
+  return typeof value === "string" && AUDIO_LOSS_CAUSES.includes(value) ? value : "server";
+};
+const fanOutAppEvent = (input) => {
+  try {
+    const { event_type, event_name, payload } = input;
+    if (event_type === "click") {
+      emitInteraction(INTERACTION_KIND[event_name] ?? CLICK_FALLBACK_KIND);
+    }
+    switch (event_name) {
+      case "recording_started":
+        resetRecordingHeartbeat();
+        SdkEventBus.emit("recording.started", { mode: readMode(payload) });
+        break;
+      case "recording_stopped":
+        SdkEventBus.emit("recording.stopped", {
+          mode: readMode(payload),
+          durationSeconds: readNumber(payload, "duration_seconds")
+        });
+        break;
+      // The mic/network emitter reports the length of the gap once audio
+      // recovers. The server-close emitter has no gap to measure — capture
+      // is torn down on the spot — and reports the recording position
+      // instead, so fall back to that rather than hand the host a silent 0.
+      case "audio_lost":
+        SdkEventBus.emit(
+          "recording.audio_lost",
+          {
+            cause: readCause(payload),
+            durationSeconds: readNumber(payload, "duration_seconds") || readNumber(payload, "recording_position_seconds")
+          },
+          "warn"
+        );
+        break;
+      case "mic_disconnected":
+        SdkEventBus.emit("recording.microphone_disconnected", {}, "warn");
+        break;
+      // A report request is in flight. The host must suppress its idle
+      // timer until report.settled, or it will close the widget during
+      // generation — which looks exactly like idleness and loses the note.
+      // openReportBracket ignores a second click while one is in flight, so
+      // the pair stays balanced.
+      case "compile_summary_button":
+      case "regenerate_summary_button":
+        openReportBracket();
+        break;
+      case "close_widget_button":
+        SdkEventBus.emit("lifecycle.closed", {});
+        break;
+      default:
+        break;
+    }
+  } catch {
+  }
+};
+
 const EventTracker = {
   track(input) {
+    fanOutAppEvent(input);
     const event = {
       event_type: input.event_type,
       event_name: input.event_name,
@@ -21051,6 +21553,7 @@ const useAudioProcessor = ({
           );
           socket.send(audioData16kHz);
           lastSendAtRef.current = Date.now();
+          emitRecordingHeartbeat();
         }
       };
       audioTracks.forEach((t) => {
@@ -22540,6 +23043,7 @@ const useReportPreviewState = ({
   }, []);
   const setScalarEdit = React__default.useCallback(
     (entryKey, value) => {
+      emitTyping("note");
       setEdits((prev) => {
         const next = new Map(prev);
         next.set(entryKey, value);
@@ -22550,6 +23054,7 @@ const useReportPreviewState = ({
   );
   const setRowFieldEdit = React__default.useCallback(
     (entryKey, rowIndex, fieldKey, value) => {
+      emitTyping("note");
       setEdits((prev) => {
         const next = new Map(prev);
         next.set(rowFieldEditKey(entryKey, rowIndex, fieldKey), value);
@@ -22559,6 +23064,7 @@ const useReportPreviewState = ({
     []
   );
   const setScalarGapValue = React__default.useCallback((key, value) => {
+    emitTyping("note");
     setFilledScalarGaps((prev) => {
       const next = new Map(prev);
       next.set(key, value);
@@ -22588,18 +23094,22 @@ const useReportPreviewState = ({
     }),
     [entries, selectedKeys, selectedRows, filledScalarGaps]
   );
-  const blockingMandatoryCount = React__default.useMemo(() => {
-    let count = 0;
+  const blockingGaps = React__default.useMemo(() => {
+    const out = [];
     for (const g of scalarGaps) {
       if (!g.mandatory) continue;
       const filled = filledScalarGaps.get(g.key);
-      if (isEmptyValue(filled)) count++;
+      if (isEmptyValue(filled)) {
+        out.push({ scope: "field", key: g.key, label: g.descriptor.label });
+      }
     }
     for (const e of entries) {
       if (!selectedKeys.has(e.key)) continue;
       if (e.descriptor.kind !== "array-of-objects" && e.descriptor.mandatory) {
         const v = edits.has(e.key) ? edits.get(e.key) : e.value;
-        if (isEmptyValue(v)) count++;
+        if (isEmptyValue(v)) {
+          out.push({ scope: "field", key: e.key, label: e.descriptor.label });
+        }
       }
       if (e.descriptor.kind !== "array-of-objects") continue;
       const rows = e.value ?? [];
@@ -22607,16 +23117,32 @@ const useReportPreviewState = ({
         if (!selectedRows.has(`${e.key}#${idx}`)) return;
         const row = mergeRowEdits(e.key, idx, rawRow, edits);
         if (e.descriptor.discriminator && !pickBranch(e.descriptor, row)) {
-          count++;
+          out.push({
+            scope: "row",
+            key: e.key,
+            groupLabel: e.descriptor.label,
+            rowIndex: idx,
+            label: null,
+            fieldKey: e.descriptor.discriminator.propertyName
+          });
           return;
         }
-        const mandatoryItemKeys = effectiveItemFields(e.descriptor, row).filter((f) => f.mandatory).map((f) => f.key);
-        for (const mk of mandatoryItemKeys) {
-          if (isEmptyValue(row[mk])) count++;
+        for (const f of effectiveItemFields(e.descriptor, row)) {
+          if (!f.mandatory) continue;
+          if (isEmptyValue(row[f.key])) {
+            out.push({
+              scope: "row",
+              key: e.key,
+              groupLabel: e.descriptor.label,
+              rowIndex: idx,
+              label: f.label,
+              fieldKey: f.key
+            });
+          }
         }
       });
     }
-    return count;
+    return out;
   }, [
     entries,
     scalarGaps,
@@ -22625,9 +23151,11 @@ const useReportPreviewState = ({
     edits,
     filledScalarGaps
   ]);
+  const blockingMandatoryCount = blockingGaps.length;
   return {
     entries,
     scalarGaps,
+    blockingGaps,
     rowGaps,
     selectedKeys,
     selectedRows,
@@ -23351,13 +23879,41 @@ const InsertionPreviewModal = ({
               ]
             }
           ),
-          (state.scalarGaps.length > 0 || state.blockingMandatoryCount > 0) && /* @__PURE__ */ jsx$2("p", { className: "omniscribe_insertion-preview__sub", children: state.blockingMandatoryCount > 0 ? /* @__PURE__ */ jsx$2("strong", { className: "omniscribe_insertion-preview__sub--blocking", children: formatMessage(
-            {
-              id: "{count} mandatory fields must be filled before applying",
-              defaultMessage: "{count, plural, one {# mandatory field} other {# mandatory fields}} must be filled before applying"
-            },
-            { count: state.blockingMandatoryCount }
-          ) }) : formatMessage(
+          (state.scalarGaps.length > 0 || state.blockingMandatoryCount > 0) && /* @__PURE__ */ jsx$2("p", { className: "omniscribe_insertion-preview__sub", children: state.blockingMandatoryCount > 0 ? /* @__PURE__ */ jsxs("strong", { className: "omniscribe_insertion-preview__sub--blocking", children: [
+            formatMessage(
+              {
+                id: "{count} mandatory fields must be filled before applying",
+                defaultMessage: "{count, plural, one {# mandatory field} other {# mandatory fields}} must be filled before applying"
+              },
+              { count: state.blockingMandatoryCount }
+            ),
+            ": ",
+            state.blockingGaps.slice(0, BLOCKING_GAPS_SHOWN).map(
+              (g) => g.scope === "field" ? g.label : g.label === null ? formatMessage(
+                {
+                  id: "{group} · row {row}",
+                  defaultMessage: "{group} · row {row}"
+                },
+                { group: g.groupLabel, row: g.rowIndex + 1 }
+              ) : formatMessage(
+                {
+                  id: "{group} · row {row} · {field}",
+                  defaultMessage: "{group} · row {row} · {field}"
+                },
+                {
+                  group: g.groupLabel,
+                  row: g.rowIndex + 1,
+                  field: g.label
+                }
+              )
+            ).join(", "),
+            state.blockingGaps.length > BLOCKING_GAPS_SHOWN && formatMessage(
+              { id: " +{count} more", defaultMessage: " +{count} more" },
+              {
+                count: state.blockingGaps.length - BLOCKING_GAPS_SHOWN
+              }
+            )
+          ] }) : formatMessage(
             {
               id: "{count} fields need your attention",
               defaultMessage: "{count, plural, one {# field needs} other {# fields need}} your attention"
@@ -23543,14 +24099,44 @@ const EntrySection = ({
   classNames
 }) => {
   const { formatMessage } = useIntl();
-  const hasMandatoryRowGap = React.useMemo(() => {
-    const gaps = state.rowGaps.get(entry.key);
-    return !!gaps?.some((g) => g.mandatoryMissingKeys.length > 0);
-  }, [state.rowGaps, entry.key]);
+  const blockingRows = React.useMemo(
+    () => state.blockingGaps.filter((g) => g.scope === "row" && g.key === entry.key),
+    [state.blockingGaps, entry.key]
+  );
+  const hasMandatoryRowGap = blockingRows.length > 0;
+  const missingFieldCount = blockingRows.filter(
+    (g) => g.scope === "row" && g.label !== null
+  ).length;
+  const untypedRowCount = blockingRows.length - missingFieldCount;
+  const groupGapSummary = [
+    missingFieldCount > 0 && formatMessage(
+      {
+        id: "{count} mandatory fields missing in this group",
+        defaultMessage: "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group"
+      },
+      { count: missingFieldCount }
+    ),
+    untypedRowCount > 0 && formatMessage(
+      {
+        id: "{count} rows need a type selected in this group",
+        defaultMessage: "{count, plural, one {# row needs} other {# rows need}} a type selected in this group"
+      },
+      { count: untypedRowCount }
+    )
+  ].filter(Boolean).join(" · ");
   const [expanded, setExpanded] = React.useState(hasMandatoryRowGap);
   React.useEffect(() => {
     if (hasMandatoryRowGap) setExpanded(true);
   }, [hasMandatoryRowGap]);
+  const missingKeysOfRow = (idx) => {
+    const keys = new Set(
+      state.rowGaps.get(entry.key)?.find((g) => g.index === idx)?.missingKeys
+    );
+    for (const g of blockingRows) {
+      if (g.scope === "row" && g.rowIndex === idx) keys.add(g.fieldKey);
+    }
+    return [...keys];
+  };
   if (entry.descriptor.kind === "array-of-objects") {
     const rows = entry.value;
     return /* @__PURE__ */ jsxs(
@@ -23576,7 +24162,23 @@ const EntrySection = ({
               /* @__PURE__ */ jsx$2("div", { className: "omniscribe_insertion-preview__row-body", children: /* @__PURE__ */ jsxs("div", { className: "omniscribe_insertion-preview__row-label", children: [
                 entry.descriptor.label,
                 " · ",
-                rows.length
+                rows.length,
+                hasMandatoryRowGap && // `role="img"` + `aria-label`: a `title` alone is not exposed
+                // reliably, so a screen reader announced only "star 1".
+                /* @__PURE__ */ jsxs(
+                  "span",
+                  {
+                    className: "omniscribe_insertion-preview__group-count--gap",
+                    role: "img",
+                    title: groupGapSummary,
+                    "aria-label": groupGapSummary,
+                    children: [
+                      " ",
+                      "★ ",
+                      blockingRows.length
+                    ]
+                  }
+                )
               ] }) })
             ] }),
             /* @__PURE__ */ jsx$2(
@@ -23597,7 +24199,7 @@ const EntrySection = ({
               row,
               descriptor: entry.descriptor,
               state,
-              missingKeys: state.rowGaps.get(entry.key)?.find((g) => g.index === idx)?.missingKeys ?? [],
+              missingKeys: missingKeysOfRow(idx),
               classNames
             },
             idx
@@ -23763,6 +24365,7 @@ const RowItem = ({
     }
   );
 };
+const BLOCKING_GAPS_SHOWN = 3;
 const ScalarGapRow = ({
   descriptor,
   value,
@@ -24458,6 +25061,7 @@ const useReportGeneration = (options) => {
     } finally {
       setState((prev) => ({ ...prev, generating: false }));
       regenerateInflightRef.current = false;
+      closeReportBracket(false);
     }
   }, [
     abortIfBlocked,
@@ -24498,6 +25102,7 @@ const useReportGeneration = (options) => {
         handleReport?.(result);
       }
       trackEvent("event", "summary_compiled");
+      closeReportBracket(true);
       if (patientId && doctorId) {
         await saveDayData({
           patientId,
@@ -24688,6 +25293,7 @@ const useReportGeneration = (options) => {
       }
     } finally {
       generateInflightRef.current = false;
+      closeReportBracket(false);
       setUserPendingClick(false);
       const finalPid = appointmentData?.patientId;
       const finalDid = appointmentData?.doctorId;
@@ -151315,122 +151921,108 @@ const ChatFooter = ({
           ]
         }
       ),
-      /* @__PURE__ */ jsxs(
-        "form",
-        {
-          onSubmit,
-          className: "omniscribe_chat-view-combined-footer-row",
-          children: [
-            /* @__PURE__ */ jsx$2(
-              "input",
-              {
-                ref: fileInputRef,
-                type: "file",
-                multiple: true,
-                accept: "image/*,.pdf",
-                onChange: onFileSelect,
-                style: { display: "none" }
-              }
-            ),
-            /* @__PURE__ */ jsxs(
-              "div",
-              {
-                className: `omniscribe_chat-view-combined-input-container${uploadedFiles.length > 0 ? " omniscribe_chat-view-combined-input-container--with-files" : ""}`,
-                children: [
-                  uploadedFiles.length > 0 && /* @__PURE__ */ jsx$2("div", { className: "omniscribe_chat-view-combined-files-row", children: /* @__PURE__ */ jsx$2(FilePreview, { files: uploadedFiles, onRemove: onFileRemove }) }),
-                  /* @__PURE__ */ jsxs("div", { className: "omniscribe_chat-view-combined-input-row", children: [
-                    /* @__PURE__ */ jsx$2(
-                      Tooltip,
+      /* @__PURE__ */ jsxs("div", { className: "omniscribe_chat-view-combined-footer-row", children: [
+        /* @__PURE__ */ jsx$2(
+          "input",
+          {
+            ref: fileInputRef,
+            type: "file",
+            multiple: true,
+            accept: "image/*,.pdf",
+            onChange: onFileSelect,
+            style: { display: "none" }
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: `omniscribe_chat-view-combined-input-container${uploadedFiles.length > 0 ? " omniscribe_chat-view-combined-input-container--with-files" : ""}`,
+            children: [
+              uploadedFiles.length > 0 && /* @__PURE__ */ jsx$2("div", { className: "omniscribe_chat-view-combined-files-row", children: /* @__PURE__ */ jsx$2(FilePreview, { files: uploadedFiles, onRemove: onFileRemove }) }),
+              /* @__PURE__ */ jsxs("div", { className: "omniscribe_chat-view-combined-input-row", children: [
+                /* @__PURE__ */ jsx$2(
+                  Tooltip,
+                  {
+                    message: formatMessage({ id: "Attach file" }),
+                    side: "top",
+                    children: /* @__PURE__ */ jsx$2(
+                      "button",
                       {
-                        message: formatMessage({ id: "Attach file" }),
-                        side: "top",
+                        type: "button",
+                        className: "omniscribe_chat-view-combined-clip-icon",
+                        onClick: () => {
+                          trackEvent("click", "attach_file_button");
+                          onAttachClick();
+                        },
+                        disabled: uploadedFiles.length >= MAX_FILES,
+                        "aria-label": formatMessage({ id: "Attach file" }),
                         children: /* @__PURE__ */ jsx$2(
-                          "button",
+                          "svg",
                           {
-                            type: "button",
-                            className: "omniscribe_chat-view-combined-clip-icon",
-                            onClick: () => {
-                              trackEvent("click", "attach_file_button");
-                              onAttachClick();
-                            },
-                            disabled: uploadedFiles.length >= MAX_FILES,
-                            "aria-label": formatMessage({ id: "Attach file" }),
-                            children: /* @__PURE__ */ jsx$2(
-                              "svg",
-                              {
-                                width: "12",
-                                height: "12",
-                                viewBox: "0 0 24 24",
-                                fill: "none",
-                                stroke: "currentColor",
-                                strokeWidth: "2",
-                                strokeLinecap: "round",
-                                strokeLinejoin: "round",
-                                children: /* @__PURE__ */ jsx$2("path", { d: "M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48" })
-                              }
-                            )
+                            width: "12",
+                            height: "12",
+                            viewBox: "0 0 24 24",
+                            fill: "none",
+                            stroke: "currentColor",
+                            strokeWidth: "2",
+                            strokeLinecap: "round",
+                            strokeLinejoin: "round",
+                            children: /* @__PURE__ */ jsx$2("path", { d: "M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48" })
                           }
                         )
                       }
-                    ),
-                    /* @__PURE__ */ jsx$2(
-                      Textarea,
-                      {
-                        ref: textareaRef,
-                        rows: 1,
-                        "data-testid": "sofia-chat-input",
-                        value: inputValue,
-                        variant: "secondary",
-                        onChange: onInputChange,
-                        onKeyDown: (e) => {
-                          if (e.key === "Enter" && !e.shiftKey && !e.metaKey) {
-                            e.preventDefault();
-                            const el = e.target;
-                            const form = el?.closest("form");
-                            form?.requestSubmit();
-                          }
-                        },
-                        maxLength: inputMaxLength,
-                        className: "omniscribe_chat-view-combined-textarea no-scrollbar text-p",
-                        placeholder: formatMessage({
-                          id: "What do you need to know?"
-                        })
-                      }
-                    ),
-                    isLoading ? /* @__PURE__ */ jsx$2(
-                      "button",
-                      {
-                        type: "button",
-                        "data-testid": "sofia-chat-stop",
-                        onClick: onStop,
-                        className: "omniscribe_chat-view-combined-send-btn omniscribe_chat-view-combined-stop-btn",
-                        title: formatMessage({ id: "Stop" }),
-                        children: /* @__PURE__ */ jsx$2(SquareIcon, { width: 10, height: 10 })
-                      }
-                    ) : inputValue.length > 0 ? /* @__PURE__ */ jsx$2(
-                      "button",
-                      {
-                        type: "button",
-                        "data-testid": "sofia-chat-send",
-                        onClick: (e) => {
-                          const form = e.currentTarget.closest(
-                            "form"
-                          );
-                          form?.requestSubmit();
-                        },
-                        className: "omniscribe_chat-view-combined-send-btn",
-                        disabled: isLoading || !inputIsValid,
-                        title: formatMessage({ id: "Send" }),
-                        children: /* @__PURE__ */ jsx$2(SendArrowIcon, { width: 16, height: 16 })
+                    )
+                  }
+                ),
+                /* @__PURE__ */ jsx$2(
+                  Textarea,
+                  {
+                    ref: textareaRef,
+                    rows: 1,
+                    "data-testid": "sofia-chat-input",
+                    value: inputValue,
+                    variant: "secondary",
+                    onChange: onInputChange,
+                    onKeyDown: (e) => {
+                      if (e.key === "Enter" && !e.shiftKey && !e.metaKey) {
+                        e.preventDefault();
+                        onSubmit(e);
                       }
-                    ) : /* @__PURE__ */ jsx$2(MicrophoneButton, { onTextUpdate: onTranscriptionUpdate })
-                  ] })
-                ]
-              }
-            )
-          ]
-        }
-      )
+                    },
+                    maxLength: inputMaxLength,
+                    className: "omniscribe_chat-view-combined-textarea no-scrollbar text-p",
+                    placeholder: formatMessage({
+                      id: "What do you need to know?"
+                    })
+                  }
+                ),
+                isLoading ? /* @__PURE__ */ jsx$2(
+                  "button",
+                  {
+                    type: "button",
+                    "data-testid": "sofia-chat-stop",
+                    onClick: onStop,
+                    className: "omniscribe_chat-view-combined-send-btn omniscribe_chat-view-combined-stop-btn",
+                    title: formatMessage({ id: "Stop" }),
+                    children: /* @__PURE__ */ jsx$2(SquareIcon, { width: 10, height: 10 })
+                  }
+                ) : inputValue.length > 0 ? /* @__PURE__ */ jsx$2(
+                  "button",
+                  {
+                    type: "button",
+                    "data-testid": "sofia-chat-send",
+                    onClick: onSubmit,
+                    className: "omniscribe_chat-view-combined-send-btn",
+                    disabled: isLoading || !inputIsValid,
+                    title: formatMessage({ id: "Send" }),
+                    children: /* @__PURE__ */ jsx$2(SendArrowIcon, { width: 16, height: 16 })
+                  }
+                ) : /* @__PURE__ */ jsx$2(MicrophoneButton, { onTextUpdate: onTranscriptionUpdate })
+              ] })
+            ]
+          }
+        )
+      ] })
     ] })
   ] });
 };
@@ -152083,6 +152675,7 @@ const ChatView = () => {
     appointmentData?.doctorId
   ]);
   const handleInputChange = (e) => {
+    emitTyping("chat");
     input.onChange(e);
     setInputIsValid(
       InputValidator.validate(e.target.value, CHAT_INPUT_VALIDATION).isValid
@@ -156492,6 +157085,9 @@ const SessionProvider = ({ children }) => {
     prevPatientIdRef.current = patientId;
     setSessionId(patientId ? generateUuid() : null);
   }, [patientId]);
+  useEffect(() => {
+    SdkEventBus.setSessionId(sessionId);
+  }, [sessionId]);
   return /* @__PURE__ */ jsx$2(SessionContext.Provider, { value: { sessionId }, children });
 };
 
@@ -156677,6 +157273,7 @@ const useBrowserCapabilityCheck = () => {
   }, []);
 };
 
+const MISSING_SUBSCRIPTIONS_GRACE_MS = 1e3;
 const BrowserCapabilityProbe = () => {
   useBrowserCapabilityCheck();
   return null;
@@ -156711,7 +157308,9 @@ const Omniscribe = ({
   onReportApply,
   updateTemplate,
   templateExtras,
-  handleExtras
+  handleExtras,
+  onEvent,
+  eventSubscriptions
 }) => {
   const templateFields = template ?? toolsargs;
   const effectiveBaseUrl = React.useMemo(
@@ -156760,6 +157359,30 @@ const Omniscribe = ({
   React.useEffect(() => {
     logger.setDebugMode(debug || false);
   }, [debug]);
+  const onEventRef = React.useRef(onEvent);
+  onEventRef.current = onEvent;
+  const hasEventHandler = onEvent !== void 0;
+  const subscriptionsRef = React.useRef(
+    eventSubscriptions
+  );
+  subscriptionsRef.current = eventSubscriptions;
+  const subscriptions = subscriptionKey(eventSubscriptions);
+  React.useEffect(() => {
+    SdkEventBus.setSubscription(subscriptionsRef.current);
+  }, [subscriptions]);
+  React.useEffect(() => {
+    if (!hasEventHandler) return;
+    return SdkEventBus.setHandler((event) => onEventRef.current?.(event));
+  }, [hasEventHandler]);
+  const hasSubscriptionsProp = eventSubscriptions !== void 0 && eventSubscriptions !== null;
+  React.useEffect(() => {
+    if (!hasEventHandler || hasSubscriptionsProp) return;
+    const timer = setTimeout(
+      reportHandlerWithoutSubscriptions,
+      MISSING_SUBSCRIPTIONS_GRACE_MS
+    );
+    return () => clearTimeout(timer);
+  }, [hasEventHandler, hasSubscriptionsProp]);
   React.useEffect(() => {
     if (apikey && apikey.trim() !== "") {
       setEncryptionSeed(apikey);