@evelan/jexity-widget 0.27.0 → 0.29.0

package/dist/types/entries/react.d.ts

@@ -4,6 +4,8 @@ interface JexityChatContextValue {
     open: () => void;
     close: () => void;
     toggle: () => void;
+    /** Opens the chat and sends `text` as the visitor's message. */
+    ask: (text: string) => void;
     isOpen: boolean;
 }
 export interface JexityChatProviderProps extends JexityChatOptions {

package/dist/types/entries/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/entries/react.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAA;AAGrE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;CAChB;AAID,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,0GAsGhE;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAMtD"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/entries/react.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAA;AAGrE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,gEAAgE;IAChE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;CAChB;AAID,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,0GA4GhE;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAMtD"}

package/dist/types/features/chat/components/ChatScreen.d.ts

@@ -14,6 +14,8 @@ interface ChatScreenProps {
     isOrgDeleted: boolean;
     ensureSession: () => Promise<SessionResult | null>;
     startFresh: () => Promise<SessionResult | null>;
+    /** True while the deployment's write-freeze is active — disables the composer. */
+    maintenance: boolean;
 }
 /**
  * Chat screen — renders immediately with greeting + input.
@@ -25,6 +27,6 @@ interface ChatScreenProps {
  * Note: session state is hoisted into WidgetShell so the Header can show
  * HumanHandoffAction with the same sessionId/visitorId — no duplicate subscriptions.
  */
-export declare function ChatScreen({ greeting, botName, starterQuestions, sessionId, visitorId, isLoading, sessionNotFound, resumeFailed, isOrgDeleted, ensureSession, startFresh }: ChatScreenProps): import("preact").JSX.Element;
+export declare function ChatScreen({ greeting, botName, starterQuestions, sessionId, visitorId, isLoading, sessionNotFound, resumeFailed, isOrgDeleted, ensureSession, startFresh, maintenance }: ChatScreenProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=ChatScreen.d.ts.map

package/dist/types/features/chat/components/ChatScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatScreen.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAanE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAE1B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAClD,UAAU,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAChD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,eAAe,gCAkJ3L"}
+{"version":3,"file":"ChatScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatScreen.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAenE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAE1B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAClD,UAAU,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAC/C,kFAAkF;IAClF,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,eAAe,gCAuKxM"}

package/dist/types/features/chat/components/EscalationFormScreen.d.ts

@@ -1,9 +1,11 @@
+import type { Availability } from '../hooks/useAvailability';
 import type { Id } from '@repo/backend/convex/_generated/dataModel';
 interface EscalationFormScreenProps {
     formMessageId: Id<'conversations'>;
     sessionId: Id<'contactSessions'>;
     visitorId: string;
-    orgSlug: string;
+    /** Live availability from the shell (per project when the embed names one). */
+    availability?: Availability;
     waitingSetAt: number;
 }
 /**
@@ -11,6 +13,6 @@ interface EscalationFormScreenProps {
  * Uses the same .jex-form-* styling as FormScreen but calls the real
  * submitEscalation mutation instead of a mock.
  */
-export declare function EscalationFormScreen({ formMessageId, sessionId, visitorId, orgSlug }: EscalationFormScreenProps): import("preact").JSX.Element;
+export declare function EscalationFormScreen({ formMessageId, sessionId, visitorId, availability }: EscalationFormScreenProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=EscalationFormScreen.d.ts.map

package/dist/types/features/chat/components/EscalationFormScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EscalationFormScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/EscalationFormScreen.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,yBAAyB;IACjC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,yBAAyB,gCAsE/G"}
+{"version":3,"file":"EscalationFormScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/EscalationFormScreen.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,yBAAyB;IACjC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,yBAAyB,gCA8EpH"}

package/dist/types/features/chat/components/FormMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormMessage.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/FormMessage.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAExE,UAAU,gBAAgB;IACxB,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC7B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,gBAAgB,gCA6B5F"}
+{"version":3,"file":"FormMessage.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/FormMessage.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAExE,UAAU,gBAAgB;IACxB,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC7B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,gBAAgB,gCA6B5F"}

package/dist/types/features/chat/components/HumanHandoffAction.d.ts

@@ -16,6 +16,16 @@ interface HumanHandoffActionProps {
  *
  * Calls createEscalationRequest. Backend decides whether the form is needed.
  * Zero LLM tokens consumed on this path.
+ *
+ * Disabled while the deployment is frozen. A handoff is a promise that a human
+ * will pick this up, and recording it is a write — so during maintenance the
+ * request cannot be stored and nobody would ever see it. Left enabled, the
+ * click reached `createOrResume`, was refused by the freeze, and died in the
+ * console: the visitor pressed a button and nothing happened at all.
+ *
+ * Gated here rather than in `ChatScreen` because the button lives in the
+ * Header, which `WidgetShell` renders TWICE — once embedded, once floating. A
+ * prop threaded from one path would have left the other still broken.
  */
 export declare function HumanHandoffAction({ sessionId, visitorId, ensureSession, availability }: HumanHandoffActionProps): import("preact").JSX.Element;
 export {};

package/dist/types/features/chat/components/HumanHandoffAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HumanHandoffAction.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/HumanHandoffAction.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,uBAAuB;IAC/B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;8EAC0E;IAC1E,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAClD;4EACwE;IACxE,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,uBAAuB,gCA+BhH"}
+{"version":3,"file":"HumanHandoffAction.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/HumanHandoffAction.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,uBAAuB;IAC/B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;8EAC0E;IAC1E,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAClD;4EACwE;IACxE,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,uBAAuB,gCAkChH"}

package/dist/types/features/chat/components/MessageAttachments.d.ts

@@ -0,0 +1,19 @@
+import type { FunctionReturnType } from 'convex/server';
+import { api } from '@repo/backend/convex/_generated/api';
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+export type AttachmentRow = FunctionReturnType<typeof api.conversationAttachments.visitor.list>[number];
+interface MessageAttachmentsProps {
+    items: readonly AttachmentRow[];
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+    align: 'user' | 'bot';
+}
+/**
+ * The files of one message, under its bubble: image thumbnails and file
+ * cards that open in a new tab through a 15-minute signed URL, and a muted
+ * card for a file that is gone. When the links cannot be loaded, the files
+ * show as cards with a line that says so and a retry button.
+ */
+export declare function MessageAttachments({ items, sessionId, visitorId, align }: MessageAttachmentsProps): import("preact").JSX.Element | null;
+export {};
+//# sourceMappingURL=MessageAttachments.d.ts.map

package/dist/types/features/chat/components/MessageAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageAttachments.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageAttachments.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAE,GAAG,EAAE,MAAM,qCAAqC,CAAA;AACzD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAInE,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;AAYvG,UAAU,uBAAuB;IAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,GAAG,KAAK,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,uBAAuB,uCA2GjG"}

package/dist/types/features/chat/components/MessageList.d.ts

@@ -1,6 +1,9 @@
+import { type AttachmentRow } from './MessageAttachments';
 import type { Doc, Id } from '@repo/backend/convex/_generated/dataModel';
 interface MessageListProps {
     conversations: Doc<'conversations'>[] | undefined;
+    /** The session's sent files; shown under the message that carried them. */
+    attachments?: readonly AttachmentRow[];
     greeting: string;
     /** The widget title / bot display name (shown in each bot message header). */
     botName: string;
@@ -20,6 +23,6 @@ interface MessageListProps {
     visitorId: string | null;
 }
 /** Scrollable message area — renders messages with streaming status support. */
-export declare function MessageList({ conversations, greeting, botName, starterQuestions, onPickStarter, sessionNotFound, resumeFailed, onStartFresh, sessionId, visitorId }: MessageListProps): import("preact").JSX.Element;
+export declare function MessageList({ conversations, attachments, greeting, botName, starterQuestions, onPickStarter, sessionNotFound, resumeFailed, onStartFresh, sessionId, visitorId }: MessageListProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=MessageList.d.ts.map

package/dist/types/features/chat/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AA+ExE,UAAU,gBAAgB;IACxB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,CAAA;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,iDAAiD;IACjD,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,gBAAgB,gCA2NrL"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAM7E,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AA+ExE,UAAU,gBAAgB;IACxB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,CAAA;IACjD,2EAA2E;IAC3E,WAAW,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,iDAAiD;IACjD,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAaD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,gBAAgB,gCA2QlM"}

package/dist/types/features/chat/components/magicline/TrialSessionBookingForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrialSessionBookingForm.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/TrialSessionBookingForm.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,4BAA4B;IACpC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAuB,EACvB,YAAoB,GACrB,EAAE,4BAA4B,gCA2C9B"}
+{"version":3,"file":"TrialSessionBookingForm.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/TrialSessionBookingForm.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,4BAA4B;IACpC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAuB,EACvB,YAAoB,GACrB,EAAE,4BAA4B,gCA2C9B"}

package/dist/types/features/chat/composer/components/ChatInput.d.ts

@@ -11,8 +11,11 @@ interface ChatInputProps {
         visitorId: string;
     } | null>;
     onStartFresh: () => void;
+    /** True while the deployment's write-freeze is active — disables the composer,
+     *  preserving any draft text, and shows the maintenance notice. */
+    maintenance?: boolean;
 }
 /** Composer area: stacks inline notices above a single focus-within input row. */
-export declare function ChatInput({ sessionId, visitorId, isLoading, isStreaming, sessionStatus, ensureSession, onStartFresh, }: ChatInputProps): import("preact").JSX.Element;
+export declare function ChatInput({ sessionId, visitorId, isLoading, isStreaming, sessionStatus, ensureSession, onStartFresh, maintenance, }: ChatInputProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=ChatInput.d.ts.map

package/dist/types/features/chat/composer/components/ChatInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatInput.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/ChatInput.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,UAAU,cAAc;IACtB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IAGpB,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACvC,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC5F,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,GACb,EAAE,cAAc,gCA4EhB"}
+{"version":3,"file":"ChatInput.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/ChatInput.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,UAAU,cAAc;IACtB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IAGpB,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACvC,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC5F,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB;uEACmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAmB,GACpB,EAAE,cAAc,gCAqHhB"}

package/dist/types/features/chat/composer/components/ComposerRow.d.ts

@@ -4,25 +4,32 @@ interface ComposerRowProps {
     inputDisabled: boolean;
     onSend: () => void;
     onFocus?: () => void;
+    /** Visitor files may be sent here (widget switch on, a person joined, Media live). */
+    canAttach: boolean;
+    /** Picked files; the caller uploads them. */
+    onFiles: (files: File[]) => void;
 }
 /**
- * Composer row — autosize textarea, attach button, staged image chips,
+ * Composer row — autosize textarea, attach button, staged file chips,
  * and a state-driven send button rendered inside one focus-within card.
  *
  * Pure presentation. All side effects (autosize, file picker proxy,
  * focus-on-empty-click, Enter-to-send) live in `useComposerInput`.
  * The component reads two composer signals (`draftMessage`,
- * `attachedImages`) for render-time conditionals and writes through
- * the hook + `removeAttachedImage`.
+ * `stagedFiles`) for render-time conditionals and writes through
+ * the hook + `removeStaged`. Uploads run in `useAttachmentUpload`.
  *
  * Design notes:
  *  - The whole card owns the border + focus-within highlight so the
  *    send button can never overflow at narrow viewports.
- *  - Send button has two visual states: "muted" (no draft / images)
- *    and "active" (something to send). Streaming locks the textarea
+ *  - Send button has two visual states: "muted" (no draft / ready file,
+ *    or a file still uploading) and "active" (something to send). Streaming locks the textarea
  *    via `inputDisabled` upstream; the button stays muted because
  *    hasInput is false after clear-on-send.
+ *  - Mic (voice dictation) is gated by the `voiceDictationEnabled` platform
+ *    flag and browser support; dictation is cancelled on send and whenever
+ *    the input locks.
  */
-export declare function ComposerRow({ isStreaming, disabled, inputDisabled, onSend, onFocus }: ComposerRowProps): import("preact").JSX.Element;
+export declare function ComposerRow({ isStreaming, disabled, inputDisabled, onSend, onFocus, canAttach, onFiles }: ComposerRowProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=ComposerRow.d.ts.map

package/dist/types/features/chat/composer/components/ComposerRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComposerRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/ComposerRow.tsx"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,gBAAgB,gCAiHtG"}
+{"version":3,"file":"ComposerRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/ComposerRow.tsx"],"names":[],"mappings":"AAqBA,UAAU,gBAAgB;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAA;IAClB,6CAA6C;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,gBAAgB,gCAmM1H"}

package/dist/types/features/chat/composer/components/MicButton.d.ts

@@ -0,0 +1,13 @@
+interface MicButtonProps {
+    listening: boolean;
+    disabled: boolean;
+    onClick: () => void;
+}
+/**
+ * Voice-dictation toggle. The ring scales with the live mic level while
+ * listening; under reduced motion / on touch devices the level stays 0 and
+ * CSS pulses the ring instead (`.jex-mic-btn-listening .jex-mic-ring`).
+ */
+export declare function MicButton({ listening, disabled, onClick }: MicButtonProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=MicButton.d.ts.map

package/dist/types/features/chat/composer/components/MicButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicButton.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/MicButton.tsx"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,cAAc,gCA0BzE"}

package/dist/types/features/chat/composer/components/SessionErrorNotice.d.ts

@@ -1,3 +1,16 @@
+import { type SessionErrorReason } from '../../state';
+/**
+ * Picks which reason to show. A live `sessionError` (from an actual failed
+ * send/resume attempt) always wins — it's the most current information. With
+ * no send attempt yet, the boot-time `maintenance` flag from the bootstrap
+ * response fills in so the notice shows on first render, not only after a
+ * failed send.
+ */
+export declare function resolveSessionErrorReason(reason: SessionErrorReason | null, maintenance: boolean): SessionErrorReason | null;
+interface SessionErrorNoticeProps {
+    /** True while the deployment's write-freeze is active — see resolveSessionErrorReason. */
+    maintenance?: boolean;
+}
 /**
  * Inline banner rendered above the chat input when session creation fails.
  * Mirrors the RateLimitNotice pattern: module-scope signal, no prop drill,
@@ -7,5 +20,6 @@
  * silent catch in useConvexSession / refreshBootstrap writes a reason here
  * and this component renders it. See state/session-error.ts for the reason enum.
  */
-export declare function SessionErrorNotice(): import("preact").JSX.Element | null;
+export declare function SessionErrorNotice({ maintenance }?: SessionErrorNoticeProps): import("preact").JSX.Element | null;
+export {};
 //# sourceMappingURL=SessionErrorNotice.d.ts.map

package/dist/types/features/chat/composer/components/SessionErrorNotice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionErrorNotice.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/SessionErrorNotice.tsx"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,wCAgBjC"}
+{"version":3,"file":"SessionErrorNotice.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/components/SessionErrorNotice.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEnE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,GACnB,kBAAkB,GAAG,IAAI,CAE3B;AAED,UAAU,uBAAuB;IAC/B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,WAAmB,EAAE,GAAE,uBAA4B,uCAiBvF"}

package/dist/types/features/chat/composer/hooks/useAttachmentUpload.d.ts

@@ -0,0 +1,21 @@
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+import type { WidgetStrings } from '../../../../i18n/locales/en';
+interface UseAttachmentUploadArgs {
+    sessionId: Id<'contactSessions'> | null;
+    visitorId: string | null;
+}
+/**
+ * Visitor files: each picked file uploads at once, in the same three steps
+ * as the dashboard's Media upload (`apps/web/modules/saas/organization/media/hooks.ts`):
+ * reserve (signed PUT) → PUT straight to R2 → finalize (server checks the
+ * real size and file signature). The chip shows uploading / ready / failed.
+ * `addFiles` returns how many files were refused before upload (type, size,
+ * or more than 4).
+ */
+export declare function useAttachmentUpload({ sessionId, visitorId }: UseAttachmentUploadArgs): {
+    addFiles: (files: File[]) => number;
+};
+/** One sentence for a failed chip or the live region. */
+export declare function attachmentErrorText(code: string | null, s: WidgetStrings): string;
+export {};
+//# sourceMappingURL=useAttachmentUpload.d.ts.map

package/dist/types/features/chat/composer/hooks/useAttachmentUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentUpload.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useAttachmentUpload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAGhE,UAAU,uBAAuB;IAC/B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,uBAAuB,GAAG;IACtF,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,MAAM,CAAA;CACpC,CAmDA;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAmBjF"}

package/dist/types/features/chat/composer/hooks/useComposerInput.d.ts

@@ -2,6 +2,8 @@ import type { RefObject } from 'preact';
 interface UseComposerInputArgs {
     /** Called when the visitor presses Enter (without Shift). */
     onSend: () => void;
+    /** Called with the files the visitor picked (uploads start there). */
+    onFiles: (files: File[]) => void;
 }
 interface UseComposerInputResult {
     textareaRef: RefObject<HTMLTextAreaElement>;
@@ -10,7 +12,7 @@ interface UseComposerInputResult {
     onKeyDown: (e: KeyboardEvent) => void;
     /** Proxy click into the hidden native file input. */
     onAttachClick: () => void;
-    /** Validate + stage selected files, then reset the input value. */
+    /** Hand picked files to `onFiles`, then reset the input value. */
     onFilesPicked: (e: Event) => void;
     /** Focus the textarea when the visitor clicks empty card padding. */
     onCardClick: (e: MouseEvent) => void;
@@ -30,6 +32,6 @@ interface UseComposerInputResult {
  * the autosize effect depends on the draft value, and that
  * dependency is composer-internal.
  */
-export declare function useComposerInput({ onSend }: UseComposerInputArgs): UseComposerInputResult;
+export declare function useComposerInput({ onSend, onFiles }: UseComposerInputArgs): UseComposerInputResult;
 export {};
 //# sourceMappingURL=useComposerInput.d.ts.map

package/dist/types/features/chat/composer/hooks/useComposerInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useComposerInput.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useComposerInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAMvC,UAAU,oBAAoB;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,UAAU,sBAAsB;IAI9B,WAAW,EAAE,SAAS,CAAC,mBAAmB,CAAC,CAAA;IAC3C,YAAY,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAA;IACzC,2CAA2C;IAC3C,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IACrC,qDAAqD;IACrD,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,mEAAmE;IACnE,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;IACjC,qEAAqE;IACrE,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;CACrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,oBAAoB,GAAG,sBAAsB,CAyEzF"}
+{"version":3,"file":"useComposerInput.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useComposerInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAMvC,UAAU,oBAAoB;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,sEAAsE;IACtE,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;CACjC;AAED,UAAU,sBAAsB;IAI9B,WAAW,EAAE,SAAS,CAAC,mBAAmB,CAAC,CAAA;IAC3C,YAAY,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAA;IACzC,2CAA2C;IAC3C,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IACrC,qDAAqD;IACrD,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,kEAAkE;IAClE,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;IACjC,qEAAqE;IACrE,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;CACrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,oBAAoB,GAAG,sBAAsB,CAwElG"}

package/dist/types/features/chat/composer/hooks/useMicLevel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Live 0..1 microphone level while `active`, for the mic button's ring.
+ *
+ * Called inside MicButton so only the button re-renders per frame. Opens its
+ * own getUserMedia stream (SpeechRecognition does not expose its stream).
+ * Decorative: reduced motion, coarse pointer (single-capture mobile engines)
+ * or a denied stream → no stream, level stays 0, the CSS pulse takes over.
+ */
+export declare function useMicLevel(active: boolean): number;
+//# sourceMappingURL=useMicLevel.d.ts.map

package/dist/types/features/chat/composer/hooks/useMicLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMicLevel.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useMicLevel.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAoDnD"}

package/dist/types/features/chat/composer/hooks/useSendMessage.d.ts

@@ -16,11 +16,13 @@ interface UseSendMessageArgs {
  *  - rate_limit response → write `rateLimitedUntilMs` signal
  *  - success → `markActivity` so the session stays in history list
  *  - network / NOT_FOUND throws → log
+ *  - visitor files: the ready ones ride with the send and leave the
+ *    composer only once the send succeeded (a rate-limited or failed send
+ *    keeps them); a refused file turns its chip red with the reason
  *
  * The returned function takes only `content` because the session
- * deps are captured at hook-call time. Composer state mutations
- * (clear draft, clear staged images) remain in the calling component
- * so the component still owns its composer reset.
+ * deps are captured at hook-call time. `content` may be empty when
+ * files are sent.
  */
 export declare function useSendMessage({ sessionId, visitorId, ensureSession }: UseSendMessageArgs): (content: string) => Promise<void>;
 export {};

package/dist/types/features/chat/composer/hooks/useSendMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSendMessage.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useSendMessage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAcnE,UAAU,kBAAkB;IAC1B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CAC7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,kBAAkB,aAK7C,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAyFlE"}
+{"version":3,"file":"useSendMessage.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useSendMessage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAmBnE,UAAU,kBAAkB;IAC1B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CAC7F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,kBAAkB,aAK7C,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAyGlE"}

package/dist/types/features/chat/composer/hooks/useVoiceDictation.d.ts

@@ -0,0 +1,30 @@
+import { type DictationError } from '../lib/dictation';
+interface UseVoiceDictationArgs {
+    /** Widget UI locale (`de` / `en`) → recognition language. */
+    locale: string;
+    getDraft: () => string;
+    setDraft: (text: string) => void;
+}
+export interface VoiceDictation {
+    /** False on Firefox / insecure contexts — the caller renders no mic. */
+    supported: boolean;
+    listening: boolean;
+    error: DictationError | null;
+    toggle: () => void;
+    /** Abort immediately (send, lock, unmount). Pending interim words are dropped. */
+    cancel: () => void;
+}
+/**
+ * Browser-native dictation into the composer draft.
+ *
+ * - One recognition instance at a time; the draft snapshot at start is the base
+ *   the transcript is appended to.
+ * - A draft that changed under us (visitor typed, a send cleared it) ends
+ *   dictation without writing — one rule for typing and every send origin.
+ * - Mobile (coarse pointer) runs single-utterance: continuous mode duplicates
+ *   results on Android and the engines allow one capture at a time.
+ * - Never logs the transcript.
+ */
+export declare function useVoiceDictation({ locale, getDraft, setDraft }: UseVoiceDictationArgs): VoiceDictation;
+export {};
+//# sourceMappingURL=useVoiceDictation.d.ts.map

package/dist/types/features/chat/composer/hooks/useVoiceDictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceDictation.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/hooks/useVoiceDictation.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAA;AAMzB,UAAU,qBAAqB;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAsLvG"}

package/dist/types/features/chat/composer/lib/dictation.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Pure helpers behind `useVoiceDictation` / `useMicLevel` (browser-native
+ * speech-to-text into the composer draft). No DOM access here, so every
+ * branch is unit-testable in node.
+ *
+ * ponytail: twin of apps/web/modules/saas/organization/project/conversations/lib/voiceDictation.ts — fix both.
+ */
+/** User-facing error buckets. `insecure` never surfaces: no secure context = unsupported = no button. */
+export type DictationError = 'permission' | 'no-mic' | 'no-speech' | 'network' | 'lang';
+export interface SpeechRecognitionAlternativeLike {
+    readonly transcript: string;
+}
+export interface SpeechRecognitionResultLike {
+    readonly isFinal: boolean;
+    readonly length: number;
+    readonly [index: number]: SpeechRecognitionAlternativeLike;
+}
+export interface SpeechRecognitionResultListLike {
+    readonly length: number;
+    readonly [index: number]: SpeechRecognitionResultLike;
+}
+export interface SpeechRecognitionEventLike {
+    readonly resultIndex: number;
+    readonly results: SpeechRecognitionResultListLike;
+}
+export interface SpeechRecognitionErrorEventLike {
+    readonly error: string;
+}
+export interface SpeechRecognitionLike {
+    lang: string;
+    continuous: boolean;
+    interimResults: boolean;
+    onresult: ((e: SpeechRecognitionEventLike) => void) | null;
+    onerror: ((e: SpeechRecognitionErrorEventLike) => void) | null;
+    onend: (() => void) | null;
+    start(): void;
+    stop(): void;
+    abort(): void;
+}
+export type SpeechRecognitionCtor = new () => SpeechRecognitionLike;
+export interface SpeechHost {
+    readonly isSecureContext?: boolean;
+    readonly SpeechRecognition?: SpeechRecognitionCtor;
+    readonly webkitSpeechRecognition?: SpeechRecognitionCtor;
+}
+/** Feature detect: a secure context plus the standard or webkit-prefixed constructor. */
+export declare function getSpeechRecognitionCtor(host: SpeechHost | undefined): SpeechRecognitionCtor | null;
+/** UI locale → `recognition.lang`. German market default. */
+export declare function toRecognitionLang(locale: string): string;
+/**
+ * Raw `SpeechRecognitionErrorEvent.error` → bucket; `aborted` is a normal stop.
+ *
+ * `network` is usually NOT our bug: Chrome streams audio to Google's speech
+ * service, and browsers that expose `webkitSpeechRecognition` without shipping
+ * that service (Brave, some Chromium forks) fail every attempt with `network`.
+ * Unknown raw codes also land here — `describeRecognitionError` logs the raw one.
+ */
+export declare function mapRecognitionError(raw: string): DictationError | null;
+/** Developer-facing log line: bucket, raw code, and for `network` why it is not an app bug. */
+export declare function describeRecognitionError(raw: string, bucket: DictationError): string;
+/**
+ * Full transcript of the session so far. Continuous mode keeps every result
+ * (final and interim) in `results`, so concatenating from 0 is always current.
+ */
+export declare function transcriptFromEvent(e: SpeechRecognitionEventLike): string;
+/** Append dictated text to the draft that existed when dictation started. */
+export declare function mergeTranscript(base: string, transcript: string): string;
+/**
+ * Time-domain samples (-1..1) → 0..1 level, quantized to 0.05 steps so the
+ * meter only re-renders on a visible change.
+ *
+ * ponytail: single AnalyserNode RMS, no waveform history; upgrade only if design asks.
+ */
+export declare function rmsToLevel(samples: ArrayLike<number>): number;
+//# sourceMappingURL=dictation.d.ts.map

package/dist/types/features/chat/composer/lib/dictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/lib/dictation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yGAAyG;AACzG,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;AAIvF,MAAM,WAAW,gCAAgC;IAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACjF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,gCAAgC,CAAA;CAC3D;AACD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,2BAA2B,CAAA;CACtD;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAA;CAClD;AACD,MAAM,WAAW,+BAA+B;IAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC3E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,0BAA0B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAC1D,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,+BAA+B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAC9D,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAC1B,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,KAAK,IAAI,IAAI,CAAA;CACd;AACD,MAAM,MAAM,qBAAqB,GAAG,UAAU,qBAAqB,CAAA;AACnE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;IAClD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,qBAAqB,CAAA;CACzD;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,qBAAqB,GAAG,IAAI,CAKnG;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgBtE;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAMpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,0BAA0B,GAAG,MAAM,CAMzE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CASxE;AAKD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAc7D"}

package/dist/types/features/chat/composer/state/attachments.d.ts

@@ -1,26 +1,46 @@
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
 /**
- * Pending image attachments staged in the composer.
+ * Files the visitor staged for the next message. Each one uploads at once
+ * (reserve → PUT → finalize, `hooks/useAttachmentUpload.ts`); only `ready`
+ * files with a server id are sent. A removed or never-sent file needs no
+ * call: its server row expires after 24h and the cleanup sweep deletes it.
  *
- * Frontend-only state for now. The backend `send` mutation accepts a
- * single `content: string` — image upload + persistence (Convex storage,
- * message-level attachment array, agent vision-input wiring) is a
- * follow-up. When that lands, replace `previewUrl` with the uploaded
- * `storageId` and pass the array in `send(...)`.
- *
- * `previewUrl` is an `URL.createObjectURL(file)` blob — callers MUST
- * revoke it via `removeAttachedImage` / `clearAttachedImages` to avoid
- * leaking memory.
+ * `previewUrl` is a blob URL for images only; `removeStaged` /
+ * `clearStagedFiles` revoke it.
  */
-export interface AttachedImage {
+export type StagedStatus = 'uploading' | 'ready' | 'failed';
+export interface StagedFile {
     id: string;
     file: File;
-    previewUrl: string;
+    /** Images only. */
+    previewUrl: string | null;
+    status: StagedStatus;
+    attachmentId: Id<'conversationAttachments'> | null;
+    errorCode: string | null;
 }
-export declare const attachedImages: import("@preact/signals").Signal<AttachedImage[]>;
-/** Appends image files (after size + count guards) and creates blob preview URLs. */
-export declare function addAttachedImages(files: FileList | File[]): void;
-/** Removes one staged image by id and revokes its blob URL. */
-export declare function removeAttachedImage(id: string): void;
-/** Revokes every staged blob URL and resets the list. Call after send + on unmount. */
-export declare function clearAttachedImages(): void;
+export declare const stagedFiles: import("@preact/signals").Signal<StagedFile[]>;
+/**
+ * Splits picked files into those to upload and a rejected count: the
+ * extension decides the type (the server re-checks the bytes), a file must
+ * be 1 byte to 10 MB, and at most the room left in the message is taken.
+ */
+export declare function acceptFiles(files: readonly File[], alreadyStaged: number): {
+    accepted: File[];
+    rejected: number;
+};
+/** Adds a file in `uploading` state and returns it. */
+export declare function stageFile(file: File): StagedFile;
+export declare function updateStaged(id: string, patch: Partial<Pick<StagedFile, 'status' | 'attachmentId' | 'errorCode'>>): void;
+export declare function removeStaged(id: string): void;
+export declare function clearStagedFiles(): void;
+export declare function readyAttachmentIds(): Array<Id<'conversationAttachments'>>;
+export declare function hasUploading(): boolean;
+/** The server's error code, when the throw carries one (ConvexError data). */
+export declare function errorCodeOf(err: unknown): string | null;
+/**
+ * A send the server refused because of its files: the one file it names
+ * (`ATTACHMENT_NOT_FOUND` carries its id) turns failed, the others stay
+ * ready; a chat that no longer takes files fails every file that went out.
+ */
+export declare function markRefusedFiles(err: unknown, sentIds: ReadonlyArray<Id<'conversationAttachments'>>): void;
 //# sourceMappingURL=attachments.d.ts.map

package/dist/types/features/chat/composer/state/attachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/state/attachments.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,cAAc,mDAA8B,CAAA;AAyBzD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAgBhE;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/state/attachments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AA0BnE;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,mBAAmB;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,EAAE,EAAE,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAA;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,gDAA2B,CAAA;AAOnD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAUjH;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAWhD;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC,GACxE,IAAI,CAEN;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM7C;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAED,wBAAgB,kBAAkB,IAAI,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAEzE;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,GAAG,IAAI,CAY1G"}

package/dist/types/features/chat/composer/state/index.d.ts

@@ -5,7 +5,7 @@
  *   - rate-limit.ts   → rateLimitedUntilMs + nowMs ticker
  *   - sending.ts      → sendPending flag (in-flight guard, shared by all sends)
  *   - privacy.ts      → explicit-consent gate (shared by all send origins)
- *   - attachments.ts  → staged image attachments + blob-URL hygiene
+ *   - attachments.ts  → staged visitor files + blob-URL hygiene
  *
  * Consumers inside `composer/` should import from `../state`. The
  * outer composer barrel (`composer/index.ts`) re-exports only what is
@@ -16,5 +16,5 @@ export { draftMessage, replyingTo, setReplyTarget, composerFocusRequest, truncat
 export { rateLimitedUntilMs, nowMs } from './rate-limit';
 export { sendPending } from './sending';
 export { privacyAcknowledged, privacyGateOpen, pendingSendContent, requiresPrivacyAck, openPrivacyGate, acknowledgePrivacy, resetPrivacyGate, } from './privacy';
-export { attachedImages, addAttachedImages, removeAttachedImage, clearAttachedImages, type AttachedImage, } from './attachments';
+export { stagedFiles, acceptFiles, stageFile, updateStaged, removeStaged, clearStagedFiles, readyAttachmentIds, hasUploading, errorCodeOf, markRefusedFiles, type StagedFile, type StagedStatus, } from './attachments';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/features/chat/composer/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAC5H,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/composer/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAC5H,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA"}

package/dist/types/features/chat/hooks/useAvailability.d.ts

@@ -2,7 +2,7 @@ export type Availability = {
     anyOnline: boolean;
     anyAway: boolean;
 };
-export declare function useAvailability(orgSlug: string | null): {
+export declare function useAvailability(orgSlug: string | null, projSlug?: string): {
     anyOnline: boolean;
     anyAway: boolean;
 } | undefined;