@natoe/colab 0.1.27 → 0.1.30

package/dist/index.d.mts

@@ -118,17 +118,51 @@ interface PatientData {
     labName?: string;
     bodyParts?: string[];
 }
+/**
+ * What a thread is about — and, crucially, what it is SCOPED to.
+ *
+ *  - `case`     — the discussion about one clinical order. Scoped to an order,
+ *                 so `orderId` is always set. Lab, radiologist, physician, admin.
+ *  - `help_lab` — an imaging centre's help channel with Natoe support. Scoped to
+ *                 the LAB, not to any case: it has NO `orderId`, it outlives
+ *                 every order, and there is exactly one per imaging centre.
+ *
+ * `help_lab` was briefly modelled as per-case (one help thread per order). It is
+ * now per-lab, so support gets one continuous thread with each imaging centre
+ * rather than N short-lived ones scattered across cases. A case can still be
+ * referenced from inside the channel; it just no longer scopes it.
+ *
+ * Isolation — who can see a help channel — is enforced by the backend's
+ * participant seeding, never by anything in this package. Treat this as a label
+ * for rendering and for addressing the right thread, not as a security boundary.
+ *
+ * Optional everywhere, defaulting to `case`, so callers written before help
+ * channels existed keep their exact previous behaviour.
+ */
+type ConversationKind = 'case' | 'help_lab';
+declare function isHelpKind(kind?: ConversationKind | string): boolean;
+/**
+ * True when a thread is scoped to an order and therefore has patient context to
+ * render. Prefer this over testing `orderId` directly: a help channel has no
+ * order, so every patient-shaped affordance must be skipped for it.
+ */
+declare function isCaseKind(kind?: ConversationKind | string): boolean;
 interface Conversation {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — that thread belongs to a lab, not an order. */
+    orderId?: string;
+    /** Set only on a help channel: the imaging centre that owns it. */
+    labUserId?: string;
     name: string;
+    kind?: ConversationKind;
     picture?: string;
     participants: Participant[];
     lastMessage?: Message;
     unreadCount: number;
     createdAt: string;
     updatedAt: string;
-    /** Denormalized patient data snapshot — lets UI render without extra fetch */
+    /** Denormalized patient data snapshot — lets UI render without extra fetch.
+     *  Always absent on a help channel: there is no patient. */
     patientSnapshot?: PatientData;
     /** Currently pinned messages (max 3) */
     pinnedMessages?: Message[];
@@ -139,8 +173,13 @@ interface Conversation {
  */
 interface ConversationListItem$1 {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — see `Conversation.orderId`. */
+    orderId?: string;
+    labUserId?: string;
     name: string;
+    /** Lets the inbox render the lab's help channel distinctly from its case
+     *  threads — they appear as separate rows. */
+    kind?: ConversationKind;
     picture?: string;
     unreadCount: number;
     lastMessage?: Message;
@@ -154,6 +193,7 @@ interface ConversationListItem$1 {
 interface ConversationPreview {
     conversationId: string;
     orderId: string;
+    kind?: ConversationKind;
     messageCount: number;
     unreadCount: number;
     /** Last N messages (typically 5) for inline display */
@@ -163,7 +203,9 @@ interface ConversationPreview {
 }
 /** Batch preview response shape from the backend */
 interface PreviewBatchResponse {
-    /** Key is orderId, value is preview or null if no conversation exists */
+    /** Key is orderId, value is preview or null if no conversation exists.
+     *  Scoped to a single `kind` per request — the backend filters server-side,
+     *  so this map never mixes a case thread and a help thread for one order. */
     previews: Record<string, ConversationPreview | null>;
 }
 /** Response from createConversationWithMessage (first-message flow) */
@@ -261,12 +303,19 @@ interface InviteUserPayload {
 }
 
 interface CollabPanelProps {
-    /** Order ID — one conversation per study */
-    orderId: string;
-    /** Patient/study data displayed in the header */
-    patientData: PatientData;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened.
+     *  Skips the order-keyed preview lookup entirely. */
+    conversation?: Conversation | null;
+    /** Patient/study data displayed in the header. Absent on a help channel:
+     *  there is no patient, and the header renders its support variant instead. */
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Show "seen by" indicator under own messages (default true) */
     showSeenBy?: boolean;
     /**
@@ -317,7 +366,7 @@ interface CollabPanelProps {
  * Full collaboration panel: patient header + pinned bar + message thread + input.
  * Supports reply, pin/unpin, and (optionally) seen-by indicators.
  */
-declare function CollabPanel({ orderId, patientData, participantIds, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
+declare function CollabPanel({ orderId, conversation: providedConversation, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
 
 interface CollabPopupProps {
     /** Order ID for this conversation */
@@ -326,6 +375,8 @@ interface CollabPopupProps {
     patientData: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Whether the popup is open */
     isOpen: boolean;
     /** Close the popup */
@@ -355,7 +406,7 @@ interface CollabPopupProps {
  * Draggable floating chat popup — drop-in replacement for DraggableChatPopup.
  * Renders a CollabPanel inside a movable, resizable container.
  */
-declare function CollabPopup({ orderId, patientData, participantIds, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
+declare function CollabPopup({ orderId, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
 
 type ColabInlineMode = 'light' | 'dark';
 interface CollabInlineProps {
@@ -363,6 +414,8 @@ interface CollabInlineProps {
     patientData: PatientData;
     /** User IDs to invite when the first message creates the conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Called when user clicks the expand button — host opens the floating popup */
     onExpand?: () => void;
     /** Max inline messages to show (default 1 — just the latest) */
@@ -390,7 +443,7 @@ interface CollabInlineProps {
  * Supports text and voice messages. File attachments and full chat features
  * stay in the floating popup / inbox.
  */
-declare function CollabInline({ orderId, patientData, participantIds, onExpand, messageLimit, placeholder, mode, className, style, }: CollabInlineProps): react_jsx_runtime.JSX.Element;
+declare function CollabInline({ orderId, patientData, participantIds, kind, onExpand, messageLimit, placeholder, mode, className, style, }: CollabInlineProps): react_jsx_runtime.JSX.Element;
 
 interface CollabInboxProps {
     /** Optional: preselect a specific conversation (by conversation ID) */
@@ -552,6 +605,8 @@ interface FetchMessagesOptions {
 interface CreateConversationOptions {
     name: string;
     participantIds?: string[];
+    /** Which thread to create. Defaults to the shared case thread. */
+    kind?: ConversationKind;
 }
 interface CollabContextValue {
     socket: CollabSocket;
@@ -573,9 +628,9 @@ interface CollabContextValue {
      */
     unreadCountsByOrder: Record<string, number>;
     /** Batched preview lookup — coalesces calls within a microtask */
-    requestPreview: (orderId: string) => Promise<ConversationPreview | null>;
+    requestPreview: (orderId: string, kind?: ConversationKind) => Promise<ConversationPreview | null>;
     /** Invalidate a cached preview (e.g. when a new message arrives) */
-    invalidatePreview: (orderId: string) => void;
+    invalidatePreview: (orderId: string, kind?: ConversationKind) => void;
     /** Fetch paginated message history */
     fetchMessages: (conversationId: string, options?: FetchMessagesOptions) => Promise<Message[]>;
     /** Atomic create-or-send — creates conversation if missing, then stores the first message */
@@ -603,12 +658,38 @@ interface CollabProviderProps {
 declare function CollabProvider({ config, apiBaseUrl, children }: CollabProviderProps): react_jsx_runtime.JSX.Element | null;
 
 interface UseConversationOptions {
-    orderId: string;
-    patientData: PatientData;
+    /**
+     * The order this thread belongs to. Required for a `case` thread, which is
+     * created lazily on first message and resolved by an order-keyed preview.
+     * Omitted for a help channel — that belongs to a lab, not an order.
+     */
+    orderId?: string;
+    /**
+     * A thread the caller has ALREADY resolved, opened directly instead of being
+     * looked up by order.
+     *
+     * This is how a help channel opens. The backend's `GET /help_channel` does
+     * the get-or-create and hands back the conversation, so there is nothing to
+     * look up and nothing to lazily create — passing it here skips the preview
+     * request entirely. The preview endpoint is order-keyed and could not serve
+     * an order-less thread in any case.
+     */
+    conversation?: Conversation | null;
+    /** Patient/study context. Absent on a help channel — there is no patient. */
+    patientData?: PatientData;
     /** Participant user IDs used only when creating a brand-new conversation */
     participantIds?: string[];
     /** Load full history on mount (default true) */
     loadHistory?: boolean;
+    /**
+     * What this thread is. Defaults to the shared `case` thread, so every
+     * existing caller is unaffected.
+     *
+     * For `help_lab` the backend seats only the imaging centre plus Natoe
+     * support, and `participantIds` is ignored server-side — a help channel must
+     * never be widened by the client.
+     */
+    kind?: ConversationKind;
 }
 interface UseConversationReturn {
     conversation: Conversation | null;
@@ -643,7 +724,7 @@ interface UseConversationReturn {
  * when the user sends the first message. If a conversation already exists for
  * the given orderId, it's loaded and joined automatically.
  */
-declare function useConversation({ orderId, patientData, participantIds, loadHistory, }: UseConversationOptions): UseConversationReturn;
+declare function useConversation({ orderId, conversation: providedConversation, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
 
 interface UseConversationListOptions {
     /**
@@ -677,6 +758,8 @@ interface UseInlineCollabOptions {
     patientData: PatientData;
     /** Participant IDs passed to the backend only when creating a new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Max messages to keep in inline state (default 5) */
     messageLimit?: number;
 }
@@ -704,7 +787,7 @@ interface UseInlineCollabReturn {
  * - First sendMessage creates conversation atomically + starts real-time flow
  * - Subsequent sends go through the socket
  */
-declare function useInlineCollab({ orderId, patientData, participantIds, messageLimit, }: UseInlineCollabOptions): UseInlineCollabReturn;
+declare function useInlineCollab({ orderId, patientData, participantIds, messageLimit, kind, }: UseInlineCollabOptions): UseInlineCollabReturn;
 
 interface UseMessagesOptions {
     conversationId: string | null;
@@ -907,6 +990,13 @@ interface PatientHeaderProps {
     hideName?: boolean;
     /** Override the displayed name — use the stored conversation.name to avoid reconstructing from patientData components */
     displayName?: string;
+    /**
+     * Render the support variant: a help channel has no patient, no study and no
+     * case, so the demographics line and every case-level action are suppressed
+     * and the title is the channel name. Without this the header would show a
+     * row of empty fields and a dead "View DICOM" button.
+     */
+    isSupportChannel?: boolean;
     className?: string;
 }
 /**
@@ -924,7 +1014,7 @@ interface PatientHeaderProps {
  * When `hideName=true` (CollabPopup wraps the conversation in its own
  * window title), only the meta + actions row renders.
  */
-declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, isSupportChannel, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListHandle {
     /** Scroll to a specific message by ID (used by pin jump-to) */
@@ -1187,4 +1277,4 @@ declare const SUPPORTED_IMAGE_TYPES: string[];
 /** Max file size in bytes (20MB) */
 declare const MAX_FILE_SIZE: number;
 
-export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
+export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };

package/dist/index.d.ts

@@ -118,17 +118,51 @@ interface PatientData {
     labName?: string;
     bodyParts?: string[];
 }
+/**
+ * What a thread is about — and, crucially, what it is SCOPED to.
+ *
+ *  - `case`     — the discussion about one clinical order. Scoped to an order,
+ *                 so `orderId` is always set. Lab, radiologist, physician, admin.
+ *  - `help_lab` — an imaging centre's help channel with Natoe support. Scoped to
+ *                 the LAB, not to any case: it has NO `orderId`, it outlives
+ *                 every order, and there is exactly one per imaging centre.
+ *
+ * `help_lab` was briefly modelled as per-case (one help thread per order). It is
+ * now per-lab, so support gets one continuous thread with each imaging centre
+ * rather than N short-lived ones scattered across cases. A case can still be
+ * referenced from inside the channel; it just no longer scopes it.
+ *
+ * Isolation — who can see a help channel — is enforced by the backend's
+ * participant seeding, never by anything in this package. Treat this as a label
+ * for rendering and for addressing the right thread, not as a security boundary.
+ *
+ * Optional everywhere, defaulting to `case`, so callers written before help
+ * channels existed keep their exact previous behaviour.
+ */
+type ConversationKind = 'case' | 'help_lab';
+declare function isHelpKind(kind?: ConversationKind | string): boolean;
+/**
+ * True when a thread is scoped to an order and therefore has patient context to
+ * render. Prefer this over testing `orderId` directly: a help channel has no
+ * order, so every patient-shaped affordance must be skipped for it.
+ */
+declare function isCaseKind(kind?: ConversationKind | string): boolean;
 interface Conversation {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — that thread belongs to a lab, not an order. */
+    orderId?: string;
+    /** Set only on a help channel: the imaging centre that owns it. */
+    labUserId?: string;
     name: string;
+    kind?: ConversationKind;
     picture?: string;
     participants: Participant[];
     lastMessage?: Message;
     unreadCount: number;
     createdAt: string;
     updatedAt: string;
-    /** Denormalized patient data snapshot — lets UI render without extra fetch */
+    /** Denormalized patient data snapshot — lets UI render without extra fetch.
+     *  Always absent on a help channel: there is no patient. */
     patientSnapshot?: PatientData;
     /** Currently pinned messages (max 3) */
     pinnedMessages?: Message[];
@@ -139,8 +173,13 @@ interface Conversation {
  */
 interface ConversationListItem$1 {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — see `Conversation.orderId`. */
+    orderId?: string;
+    labUserId?: string;
     name: string;
+    /** Lets the inbox render the lab's help channel distinctly from its case
+     *  threads — they appear as separate rows. */
+    kind?: ConversationKind;
     picture?: string;
     unreadCount: number;
     lastMessage?: Message;
@@ -154,6 +193,7 @@ interface ConversationListItem$1 {
 interface ConversationPreview {
     conversationId: string;
     orderId: string;
+    kind?: ConversationKind;
     messageCount: number;
     unreadCount: number;
     /** Last N messages (typically 5) for inline display */
@@ -163,7 +203,9 @@ interface ConversationPreview {
 }
 /** Batch preview response shape from the backend */
 interface PreviewBatchResponse {
-    /** Key is orderId, value is preview or null if no conversation exists */
+    /** Key is orderId, value is preview or null if no conversation exists.
+     *  Scoped to a single `kind` per request — the backend filters server-side,
+     *  so this map never mixes a case thread and a help thread for one order. */
     previews: Record<string, ConversationPreview | null>;
 }
 /** Response from createConversationWithMessage (first-message flow) */
@@ -261,12 +303,19 @@ interface InviteUserPayload {
 }
 
 interface CollabPanelProps {
-    /** Order ID — one conversation per study */
-    orderId: string;
-    /** Patient/study data displayed in the header */
-    patientData: PatientData;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened.
+     *  Skips the order-keyed preview lookup entirely. */
+    conversation?: Conversation | null;
+    /** Patient/study data displayed in the header. Absent on a help channel:
+     *  there is no patient, and the header renders its support variant instead. */
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Show "seen by" indicator under own messages (default true) */
     showSeenBy?: boolean;
     /**
@@ -317,7 +366,7 @@ interface CollabPanelProps {
  * Full collaboration panel: patient header + pinned bar + message thread + input.
  * Supports reply, pin/unpin, and (optionally) seen-by indicators.
  */
-declare function CollabPanel({ orderId, patientData, participantIds, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
+declare function CollabPanel({ orderId, conversation: providedConversation, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
 
 interface CollabPopupProps {
     /** Order ID for this conversation */
@@ -326,6 +375,8 @@ interface CollabPopupProps {
     patientData: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Whether the popup is open */
     isOpen: boolean;
     /** Close the popup */
@@ -355,7 +406,7 @@ interface CollabPopupProps {
  * Draggable floating chat popup — drop-in replacement for DraggableChatPopup.
  * Renders a CollabPanel inside a movable, resizable container.
  */
-declare function CollabPopup({ orderId, patientData, participantIds, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
+declare function CollabPopup({ orderId, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
 
 type ColabInlineMode = 'light' | 'dark';
 interface CollabInlineProps {
@@ -363,6 +414,8 @@ interface CollabInlineProps {
     patientData: PatientData;
     /** User IDs to invite when the first message creates the conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Called when user clicks the expand button — host opens the floating popup */
     onExpand?: () => void;
     /** Max inline messages to show (default 1 — just the latest) */
@@ -390,7 +443,7 @@ interface CollabInlineProps {
  * Supports text and voice messages. File attachments and full chat features
  * stay in the floating popup / inbox.
  */
-declare function CollabInline({ orderId, patientData, participantIds, onExpand, messageLimit, placeholder, mode, className, style, }: CollabInlineProps): react_jsx_runtime.JSX.Element;
+declare function CollabInline({ orderId, patientData, participantIds, kind, onExpand, messageLimit, placeholder, mode, className, style, }: CollabInlineProps): react_jsx_runtime.JSX.Element;
 
 interface CollabInboxProps {
     /** Optional: preselect a specific conversation (by conversation ID) */
@@ -552,6 +605,8 @@ interface FetchMessagesOptions {
 interface CreateConversationOptions {
     name: string;
     participantIds?: string[];
+    /** Which thread to create. Defaults to the shared case thread. */
+    kind?: ConversationKind;
 }
 interface CollabContextValue {
     socket: CollabSocket;
@@ -573,9 +628,9 @@ interface CollabContextValue {
      */
     unreadCountsByOrder: Record<string, number>;
     /** Batched preview lookup — coalesces calls within a microtask */
-    requestPreview: (orderId: string) => Promise<ConversationPreview | null>;
+    requestPreview: (orderId: string, kind?: ConversationKind) => Promise<ConversationPreview | null>;
     /** Invalidate a cached preview (e.g. when a new message arrives) */
-    invalidatePreview: (orderId: string) => void;
+    invalidatePreview: (orderId: string, kind?: ConversationKind) => void;
     /** Fetch paginated message history */
     fetchMessages: (conversationId: string, options?: FetchMessagesOptions) => Promise<Message[]>;
     /** Atomic create-or-send — creates conversation if missing, then stores the first message */
@@ -603,12 +658,38 @@ interface CollabProviderProps {
 declare function CollabProvider({ config, apiBaseUrl, children }: CollabProviderProps): react_jsx_runtime.JSX.Element | null;
 
 interface UseConversationOptions {
-    orderId: string;
-    patientData: PatientData;
+    /**
+     * The order this thread belongs to. Required for a `case` thread, which is
+     * created lazily on first message and resolved by an order-keyed preview.
+     * Omitted for a help channel — that belongs to a lab, not an order.
+     */
+    orderId?: string;
+    /**
+     * A thread the caller has ALREADY resolved, opened directly instead of being
+     * looked up by order.
+     *
+     * This is how a help channel opens. The backend's `GET /help_channel` does
+     * the get-or-create and hands back the conversation, so there is nothing to
+     * look up and nothing to lazily create — passing it here skips the preview
+     * request entirely. The preview endpoint is order-keyed and could not serve
+     * an order-less thread in any case.
+     */
+    conversation?: Conversation | null;
+    /** Patient/study context. Absent on a help channel — there is no patient. */
+    patientData?: PatientData;
     /** Participant user IDs used only when creating a brand-new conversation */
     participantIds?: string[];
     /** Load full history on mount (default true) */
     loadHistory?: boolean;
+    /**
+     * What this thread is. Defaults to the shared `case` thread, so every
+     * existing caller is unaffected.
+     *
+     * For `help_lab` the backend seats only the imaging centre plus Natoe
+     * support, and `participantIds` is ignored server-side — a help channel must
+     * never be widened by the client.
+     */
+    kind?: ConversationKind;
 }
 interface UseConversationReturn {
     conversation: Conversation | null;
@@ -643,7 +724,7 @@ interface UseConversationReturn {
  * when the user sends the first message. If a conversation already exists for
  * the given orderId, it's loaded and joined automatically.
  */
-declare function useConversation({ orderId, patientData, participantIds, loadHistory, }: UseConversationOptions): UseConversationReturn;
+declare function useConversation({ orderId, conversation: providedConversation, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
 
 interface UseConversationListOptions {
     /**
@@ -677,6 +758,8 @@ interface UseInlineCollabOptions {
     patientData: PatientData;
     /** Participant IDs passed to the backend only when creating a new conversation */
     participantIds?: string[];
+    /** Which thread on the case. Defaults to the shared `case` thread. */
+    kind?: ConversationKind;
     /** Max messages to keep in inline state (default 5) */
     messageLimit?: number;
 }
@@ -704,7 +787,7 @@ interface UseInlineCollabReturn {
  * - First sendMessage creates conversation atomically + starts real-time flow
  * - Subsequent sends go through the socket
  */
-declare function useInlineCollab({ orderId, patientData, participantIds, messageLimit, }: UseInlineCollabOptions): UseInlineCollabReturn;
+declare function useInlineCollab({ orderId, patientData, participantIds, messageLimit, kind, }: UseInlineCollabOptions): UseInlineCollabReturn;
 
 interface UseMessagesOptions {
     conversationId: string | null;
@@ -907,6 +990,13 @@ interface PatientHeaderProps {
     hideName?: boolean;
     /** Override the displayed name — use the stored conversation.name to avoid reconstructing from patientData components */
     displayName?: string;
+    /**
+     * Render the support variant: a help channel has no patient, no study and no
+     * case, so the demographics line and every case-level action are suppressed
+     * and the title is the channel name. Without this the header would show a
+     * row of empty fields and a dead "View DICOM" button.
+     */
+    isSupportChannel?: boolean;
     className?: string;
 }
 /**
@@ -924,7 +1014,7 @@ interface PatientHeaderProps {
  * When `hideName=true` (CollabPopup wraps the conversation in its own
  * window title), only the meta + actions row renders.
  */
-declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, isSupportChannel, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListHandle {
     /** Scroll to a specific message by ID (used by pin jump-to) */
@@ -1187,4 +1277,4 @@ declare const SUPPORTED_IMAGE_TYPES: string[];
 /** Max file size in bytes (20MB) */
 declare const MAX_FILE_SIZE: number;
 
-export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
+export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };