@omniloy/sofia-sdk 1.0.10 → 1.0.12

package/dist/react/index.css

@@ -230,6 +230,7 @@
   --color-gray-200: oklch(92.8% 0.006 264.531);
   --color-gray-500: oklch(55.1% 0.027 264.364);
   --color-gray-900: oklch(21% 0.034 264.665);
+  --color-zinc-500: oklch(55.2% 0.016 285.938);
   --color-zinc-900: oklch(21% 0.006 285.885);
   --color-sidebar: var(--sidebar);
   --color-sidebar-foreground: var(--sidebar-foreground);
@@ -3321,85 +3322,104 @@
   }
 }
 
+/* Escala de encabezados calibrada al ancho del panel del chat (~380px) con
+   cuerpo de 14px. La escala anterior (26/24/22/20/18px) venía de la tipografía
+   por defecto de un documento a ancho completo: en el panel el encabezado
+   dominaba el mensaje y los seis niveles quedaban a 2px unos de otros, sin
+   jerarquía legible. Aquí h1-h3 bajan de tamaño y h4-h6 se diferencian por
+   peso, no por tamaño. Los márgenes usan --spacing (rem): un host que altere
+   el font-size de :root los escala, aunque los tamaños en px no se muevan. */
+
 .omniscribe_markdown-h1 {
-  margin-bottom: calc(var(--spacing) * 8) /* 2rem = 32px */;
-  scroll-margin: calc(var(--spacing) * 20) /* 5rem = 80px */;
-  font-size: var(--text-4xl) /* 2.25rem = 36px */;
-  line-height: var(--text-4xl--line-height) /* calc(2.5 / 2.25) ≈ 1.1111 */;
-  font-weight: var(--font-weight-extrabold) /* 800 */;
+  margin-top: calc(var(--spacing) * 5) /* 20px */;
+  margin-bottom: calc(var(--spacing) * 2) /* 8px */;
+  scroll-margin: calc(var(--spacing) * 20) /* 80px */;
+  font-size: var(--text-xl) /* 20px */;
+  line-height: var(--text-xl--line-height);
+  font-weight: var(--font-weight-bold) /* 700 */;
   letter-spacing: var(--tracking-tight) /* -0.025em */;
+  &:first-child {
+    margin-top: calc(var(--spacing) * 0);
+  }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
 
 .omniscribe_markdown-h2 {
-  margin-bottom: calc(var(--spacing) * 4);
-  margin-top: calc(var(--spacing) * 8) /* 2rem = 32px */;
-  scroll-margin: calc(var(--spacing) * 20) /* 5rem = 80px */;
-  font-size: var(--text-3xl) /* 1.875rem = 30px */;
-  line-height: var(--text-3xl--line-height) /* calc(2.25 / 1.875) ≈ 1.2 */;
+  margin-top: calc(var(--spacing) * 4) /* 16px */;
+  margin-bottom: calc(var(--spacing) * 2) /* 8px */;
+  scroll-margin: calc(var(--spacing) * 20);
+  font-size: var(--text-lg) /* 18px */;
+  line-height: var(--text-lg--line-height);
   font-weight: var(--font-weight-semibold) /* 600 */;
-  letter-spacing: var(--tracking-tight) /* -0.025em */;
+  letter-spacing: var(--tracking-tight);
   &:first-child {
-    margin-top: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-top: calc(var(--spacing) * 0);
   }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
+
 .omniscribe_markdown-h3 {
-  margin-bottom: calc(var(--spacing) * 4);
-  margin-top: calc(var(--spacing) * 6);
-  scroll-margin: calc(var(--spacing) * 20) /* 5rem = 80px */;
-  font-size: var(--text-2xl);
-  line-height: var(--text-2xl--line-height);
+  margin-top: calc(var(--spacing) * 4) /* 16px */;
+  margin-bottom: calc(var(--spacing) * 2) /* 8px */;
+  scroll-margin: calc(var(--spacing) * 20);
+  font-size: var(--text-base) /* 16px */;
+  line-height: var(--text-base--line-height);
   font-weight: var(--font-weight-semibold) /* 600 */;
-  letter-spacing: var(--tracking-tight) /* -0.025em */;
   &:first-child {
-    margin-top: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-top: calc(var(--spacing) * 0);
   }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
 
+/* h4-h6 comparten el tamaño del cuerpo (14px) y se distinguen por peso.
+   Bajar de 14px haría el encabezado menos legible que el texto que titula. */
 .omniscribe_markdown-h4 {
-  margin-bottom: calc(var(--spacing) * 4);
-  margin-top: calc(var(--spacing) * 6);
-  scroll-margin: calc(var(--spacing) * 20) /* 5rem = 80px */;
-  font-size: var(--text-xl);
-  line-height: var(--text-xl--line-height);
-  font-weight: var(--font-weight-semibold) /* 600 */;
-  letter-spacing: var(--tracking-tight) /* -0.025em */;
+  margin-top: calc(var(--spacing) * 3) /* 12px */;
+  margin-bottom: calc(var(--spacing) * 1) /* 4px */;
+  scroll-margin: calc(var(--spacing) * 20);
+  font-size: var(--text-sm) /* 14px */;
+  line-height: var(--text-sm--line-height);
+  font-weight: var(--font-weight-bold) /* 700 */;
   &:first-child {
-    margin-top: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-top: calc(var(--spacing) * 0);
   }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
+
 .omniscribe_markdown-h5 {
-  margin-block: calc(var(--spacing) * 4) /* 1rem = 16px */;
-  font-size: var(--text-lg);
-  line-height: var(--text-lg--line-height);
+  margin-top: calc(var(--spacing) * 3) /* 12px */;
+  margin-bottom: calc(var(--spacing) * 1) /* 4px */;
+  font-size: var(--text-sm) /* 14px */;
+  line-height: var(--text-sm--line-height);
   font-weight: var(--font-weight-semibold) /* 600 */;
   &:first-child {
-    margin-top: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-top: calc(var(--spacing) * 0);
   }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
 
 .omniscribe_markdown-h6 {
-  margin-block: calc(var(--spacing) * 4) /* 1rem = 16px */;
+  margin-top: calc(var(--spacing) * 3) /* 12px */;
+  margin-bottom: calc(var(--spacing) * 1) /* 4px */;
+  font-size: var(--text-sm) /* 14px */;
+  line-height: var(--text-sm--line-height);
   font-weight: var(--font-weight-semibold) /* 600 */;
+  color: var(--color-zinc-500);
   &:first-child {
-    margin-top: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-top: calc(var(--spacing) * 0);
   }
   &:last-child {
-    margin-bottom: calc(var(--spacing) * 0) /* 0rem = 0px */;
+    margin-bottom: calc(var(--spacing) * 0);
   }
 }
 

package/dist/react/index.d.ts

@@ -3,6 +3,9 @@ import { JSX } from 'react/jsx-runtime';
 import * as React_2 from 'react';
 import { VariantProps } from 'class-variance-authority';
 
+/** Where audio stopped flowing, as reported by the recording pipeline. */
+export declare type AudioLossCause = 'mic' | 'network' | 'server';
+
 export declare function Button({ className, variant, size, asChild, isDisabled, isLoading, text, whitespace, rounded, type, ...props }: ButtonProps): JSX.Element;
 
 declare type ButtonProps = React_2.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
@@ -63,6 +66,11 @@ declare interface InsertionPreviewClassNames {
     cancelButton?: string;
 }
 
+/** Coarse area of the widget the clinician touched. */
+export declare type InteractionKind = 'recording' | 'chat' | 'settings' | 'report' | 'transcript' | 'history' | 'widget';
+
+export declare type KnownSdkEventName = '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';
+
 export declare enum LanguageCode {
     ar = "ar",
     ca = "ca",
@@ -252,8 +260,152 @@ export declare interface OmniscribeProps {
      * the appropriate action. To change the delivered shape, change templateExtras.
      */
     handleExtras?: (extras: Extra[]) => void;
+    /**
+     * Subscribe to the SDK's activity stream.
+     *
+     * Called with a typed, PHI-free event whenever something the host asked
+     * for happens inside the widget. Payloads carry only enums, booleans and
+     * numbers — never clinical content, message text or patient identifiers.
+     * Clinical content has its own explicitly scoped channels (`handleReport`,
+     * `onReportApply`, `handleExtras`).
+     *
+     * The primary use case is knowing whether the clinician is working, so the
+     * host can run an inactivity timeout:
+     * ```
+     * onEvent={e => {
+     *   if (e.name === 'recording.started') idleTimer.cancel();
+     *   if (e.name === 'recording.stopped') idleTimer.start();
+     *   if (e.family === 'activity') idleTimer.reset();
+     * }}
+     * ```
+     * Suppress the timer between `report.generation_started` and
+     * `report.settled` — generation runs for tens of seconds with no user
+     * input, and closing the widget there loses the note.
+     *
+     * If the host must keep an *external* session alive (an auto-logout on
+     * inactivity), key off `recording.heartbeat` instead of the
+     * `started`/`stopped` pair. It beats every ~30s while audio is actually
+     * flowing to the transcriber, needs no host-side state, and stops by
+     * itself the moment a recording silently breaks:
+     * ```
+     * onEvent={e => {
+     *   if (e.name === 'recording.heartbeat') session.keepAlive();
+     * }}
+     * ```
+     *
+     * Delivered asynchronously on a microtask, so a slow handler cannot block
+     * recording. Requires `eventSubscriptions`; without it nothing is sent.
+     */
+    onEvent?: SdkEventHandler;
+    /**
+     * Which events `onEvent` should receive. Exact names
+     * (`'recording.started'`), family wildcards (`'recording.*'`), or `'*'`.
+     *
+     * Omitted or empty means no events are delivered — subscription is
+     * explicit so the SDK never does work for a listener that does not exist.
+     */
+    eventSubscriptions?: SdkEventSubscription[];
 }
 
+export declare type RecordingMode = 'consultation' | 'dictation';
+
+export declare interface SdkEvent<N extends SdkEventName = SdkEventName> {
+    /** Fully qualified name, e.g. `'recording.started'`. */
+    name: N;
+    /** The part of `name` before the dot. */
+    family: SdkEventFamily;
+    level: 'info' | 'warn' | 'error';
+    /** ISO-8601. */
+    ts: string;
+    /**
+     * Monotonic per page load. Restores ordering that the fire-and-forget
+     * analytics POSTs cannot guarantee.
+     */
+    seq: number;
+    sdkVersion: string;
+    /** Random per-session UUID. Not an identifier for a person. */
+    sessionId: string | null;
+    payload: SdkEventPayload<N>;
+}
+
+/**
+ * Public, host-facing SDK event vocabulary.
+ *
+ * PRIVACY INVARIANT — read before adding an event.
+ * No payload field may carry user-, patient-, or clinician-derived text.
+ * Every field is a string-literal union, a boolean, or a number. Errors
+ * travel as codes, never as messages; reports as counts, never as content.
+ * A host that needs clinical content already has purpose-built, explicitly
+ * scoped channels for it (`handleReport`, `onReportApply`, `handleExtras`).
+ * `sdk-events.types.test.ts` fails the build if an unconstrained `string`
+ * appears in `SdkEventPayloadMap`.
+ *
+ * This vocabulary is deliberately separate from the internal analytics
+ * `AppEventName`. Merging them would make every internal telemetry addition
+ * a public breaking change.
+ */
+export declare type SdkEventFamily = 'recording' | 'activity' | 'report' | 'lifecycle';
+
+/** Handler shape for the `onEvent` prop. */
+export declare type SdkEventHandler = (event: SdkEvent) => void;
+
+/**
+ * Widened on purpose. New event names ship in minor releases, and a closed
+ * union would make every addition a type-level break for hosts that switch
+ * exhaustively. Hosts wanting exhaustiveness narrow to `KnownSdkEventName`.
+ */
+export declare type SdkEventName = KnownSdkEventName | (string & {});
+
+declare type SdkEventPayload<N extends SdkEventName> = N extends KnownSdkEventName ? SdkEventPayloadMap[N] : Record<string, unknown>;
+
+export declare interface SdkEventPayloadMap {
+    'recording.started': {
+        mode: RecordingMode;
+    };
+    'recording.stopped': {
+        mode: RecordingMode;
+        durationSeconds: number;
+    };
+    'recording.audio_lost': {
+        cause: AudioLossCause;
+        /**
+         * For `mic` / `network`: length of the gap, reported once audio
+         * recovers. For `server`: the recording position at which the socket
+         * closed — capture is torn down on the spot, so there is no gap to
+         * measure.
+         */
+        durationSeconds: number;
+    };
+    'recording.microphone_disconnected': Record<string, never>;
+    /**
+     * Audio is actually flowing to the transcriber. Emitted from the
+     * audio-chunk send path, throttled — see `recording-heartbeat.ts`.
+     * A host that must keep an external session alive while the clinician
+     * records should key off this, not off `started`/`stopped`: it needs no
+     * host-side state and stops by itself the moment a recording silently
+     * breaks.
+     */
+    'recording.heartbeat': Record<string, never>;
+    'activity.interaction': {
+        kind: InteractionKind;
+    };
+    'activity.typing': {
+        surface: TypingSurface;
+    };
+    'report.generation_started': Record<string, never>;
+    'report.settled': {
+        ok: boolean;
+    };
+    'lifecycle.ready': Record<string, never>;
+    'lifecycle.closed': Record<string, never>;
+}
+
+/**
+ * What a host asks for: an exact name, a family wildcard (`'recording.*'`),
+ * or everything (`'*'`).
+ */
+export declare type SdkEventSubscription = KnownSdkEventName | `${SdkEventFamily}.*` | '*';
+
 /**
  * Get a value from local storage (decrypted)
  * @param key - The key to get the value from
@@ -333,6 +485,9 @@ declare type TTranscriptorSelect = {
     label: string;
 }[];
 
+/** Which free-text surface received keystrokes. Never the text itself. */
+export declare type TypingSurface = 'chat' | 'note';
+
 /**
  * Host-provided callback that returns whatever the doctor has already written
  * in SINA/HIS, keyed by template property id (e.g. `{ chief_complaint: '...',