@cntyclub/agent-react 0.17.0 → 0.19.0

package/dist/index.js

@@ -1,11 +1,27 @@
-import { cn, Button, ThinkingOrb, Tooltip, TooltipTrigger, TooltipContent, ChatMessage, ChatMessageBubble, Markdown, AuroraText, Spinner, Checkbox, Collapsible, CollapsibleTrigger, ChatToolChip, CollapsiblePanel, ChatToolCard, ChatToolCardHeader, ChatToolCardActions, Group, Menu, MenuTrigger, MenuPopup, MenuItem, ChatHeader, ChatHeaderAvatar, ChatHeaderTitle, ChatHeaderActions, Chat, ChatEmptyState, ChatEmptyStateIcon, ChatEmptyStateTitle, ChatEmptyStateDescription, ChatSuggestions, ChatSuggestion, useMediaQuery, TooltipProvider, DataTablePaged } from '@cntyclub/ui-react';
-import { XIcon, Trash2Icon, SquareIcon, PauseIcon, PlayIcon, CheckIcon, FileTextIcon, PaperclipIcon, MicIcon, ArrowUpIcon, CopyIcon, Maximize2Icon, ListChecksIcon, ChevronDownIcon, ShieldAlertIcon, CheckCheckIcon, UploadCloudIcon, HistoryIcon, SquarePenIcon, Minimize2Icon, ChevronsRightIcon, SparklesIcon, DownloadIcon, CodeIcon } from 'lucide-react';
-import * as React12 from 'react';
+import { cn, Button, ThinkingOrb, Tooltip, TooltipTrigger, TooltipContent, Popover, PopoverTrigger, PopoverPopup, ChatMessage, ChatMessageBubble, Markdown, AuroraText, Spinner, Checkbox, Collapsible, CollapsibleTrigger, ChatToolChip, CollapsiblePanel, ChatToolCard, ChatToolCardHeader, ChatToolCardActions, Group, Menu, MenuTrigger, MenuPopup, MenuItem, ChatHeader, ChatHeaderAvatar, ChatHeaderTitle, AvatarGroup, ChatHeaderActions, ContextMeter, Chat, ChatEmptyState, ChatEmptyStateIcon, ChatEmptyStateTitle, ChatEmptyStateDescription, ChatSuggestions, ChatSuggestion, useMediaQuery, TooltipProvider, DataTablePaged } from '@cntyclub/ui-react';
+import { XIcon, Trash2Icon, SquareIcon, PauseIcon, PlayIcon, CheckIcon, FileTextIcon, PaperclipIcon, MicIcon, ArrowUpIcon, UsersIcon, LockIcon, GlobeIcon, CopyIcon, Maximize2Icon, ListChecksIcon, ChevronDownIcon, ShieldAlertIcon, CheckCheckIcon, UploadCloudIcon, HistoryIcon, SquarePenIcon, Minimize2Icon, ChevronsRightIcon, SparklesIcon, DownloadIcon, CodeIcon } from 'lucide-react';
+import * as React13 from 'react';
 import { AnimatePresence, motion } from 'motion/react';
 import { createPortal } from 'react-dom';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/api-client.ts
+function collabBody(options) {
+  if (!options) return {};
+  const body = {};
+  if (options.idempotencyKey) body.idempotency_key = options.idempotencyKey;
+  if (options.replyToId) body.reply_to_id = options.replyToId;
+  if (options.threadRootId) body.thread_root_id = options.threadRootId;
+  if (options.mentionUserIds?.length) body.mention_user_ids = options.mentionUserIds;
+  return body;
+}
+function appendCollab(form, options) {
+  if (!options) return;
+  if (options.idempotencyKey) form.append("idempotency_key", options.idempotencyKey);
+  if (options.replyToId) form.append("reply_to_id", options.replyToId);
+  if (options.threadRootId) form.append("thread_root_id", options.threadRootId);
+  for (const id of options.mentionUserIds ?? []) form.append("mention_user_ids", id);
+}
 var AgentApiError = class extends Error {
   status;
   constructor(message, status) {
@@ -65,20 +81,22 @@ var AgentApiClient = class {
       method: "POST"
     });
   }
-  sendMessage(message, conversationId, files) {
+  sendMessage(message, conversationId, files, options) {
     if (files && files.length > 0) {
       const form = new FormData();
       form.append("client_id", this.config.clientId);
       form.append("message", message);
       if (conversationId) form.append("conversation_id", conversationId);
       for (const file of files) form.append("files", file, file.name);
+      appendCollab(form, options);
       return this.request("/agent-mode/chat/", { body: form, method: "POST" });
     }
     return this.request("/agent-mode/chat/", {
       body: {
         client_id: this.config.clientId,
         conversation_id: conversationId ?? null,
-        message
+        message,
+        ...collabBody(options)
       },
       method: "POST"
     });
@@ -91,7 +109,7 @@ var AgentApiClient = class {
   }
   // ------------------------------------------------------------- streaming
   /** POST a chat turn and yield parsed SSE events as they stream in. */
-  async streamMessage(message, conversationId, files, onEvent, signal) {
+  async streamMessage(message, conversationId, files, onEvent, signal, options) {
     let body;
     const headers = await this.streamHeaders();
     if (files && files.length > 0) {
@@ -100,13 +118,15 @@ var AgentApiClient = class {
       form.append("message", message);
       if (conversationId) form.append("conversation_id", conversationId);
       for (const file of files) form.append("files", file, file.name);
+      appendCollab(form, options);
       body = form;
     } else {
       headers["Content-Type"] = "application/json";
       body = JSON.stringify({
         client_id: this.config.clientId,
         conversation_id: conversationId ?? null,
-        message
+        message,
+        ...collabBody(options)
       });
     }
     await this.consumeStream("/agent-mode/chat/stream/", { body, headers, signal }, onEvent);
@@ -184,14 +204,219 @@ var AgentApiClient = class {
   listConversations() {
     return this.request("/agent-mode/conversations/");
   }
-  getConversation(conversationId) {
-    return this.request(`/agent-mode/conversations/${conversationId}/`);
+  getConversation(conversationId, options) {
+    const qs = new URLSearchParams();
+    if (options?.beforeSeq != null) qs.set("before_seq", String(options.beforeSeq));
+    if (options?.limit != null) qs.set("limit", String(options.limit));
+    const suffix = qs.toString() ? `?${qs.toString()}` : "";
+    return this.request(`/agent-mode/conversations/${conversationId}/${suffix}`);
   }
+  /** Soft-delete (creator/admin) or leave (member). Never a hard delete. */
   deleteConversation(conversationId) {
     return this.request(`/agent-mode/conversations/${conversationId}/`, {
       method: "DELETE"
     });
   }
+  // ------------------------------------------------------------- collaboration
+  setVisibility(conversationId, visibility, scope) {
+    return this.request(`/agent-mode/conversations/${conversationId}/visibility/`, {
+      method: "POST",
+      body: {
+        client_id: this.config.clientId,
+        visibility,
+        scope_type: scope?.scopeType ?? "none",
+        scope_event_id: scope?.scopeEventId
+      }
+    });
+  }
+  listParticipants(conversationId) {
+    return this.request(`/agent-mode/conversations/${conversationId}/participants/`);
+  }
+  markRead(conversationId, seq) {
+    return this.request(`/agent-mode/conversations/${conversationId}/read/`, {
+      method: "POST",
+      body: { client_id: this.config.clientId, seq }
+    });
+  }
+  saveDraft(conversationId, text) {
+    return this.request(`/agent-mode/conversations/${conversationId}/draft/`, {
+      method: "POST",
+      body: { client_id: this.config.clientId, text }
+    });
+  }
+  setFlags(conversationId, flags) {
+    return this.request(`/agent-mode/conversations/${conversationId}/flags/`, {
+      method: "POST",
+      body: { client_id: this.config.clientId, ...flags }
+    });
+  }
+  listFiles(conversationId) {
+    return this.request(`/agent-mode/conversations/${conversationId}/files/`);
+  }
+  summarize(conversationId) {
+    return this.request(`/agent-mode/conversations/${conversationId}/summarize/`, {
+      method: "POST",
+      body: { client_id: this.config.clientId }
+    });
+  }
+  listContext(conversationId) {
+    return this.request(`/agent-mode/conversations/${conversationId}/context/`);
+  }
+  pinContext(conversationId, item) {
+    return this.request(`/agent-mode/conversations/${conversationId}/context/`, {
+      method: "POST",
+      body: {
+        client_id: this.config.clientId,
+        kind: item.kind,
+        label: item.label,
+        ref_type: item.refType,
+        ref_id: item.refId
+      }
+    });
+  }
+  editMessage(conversationId, messageId, message) {
+    return this.request(`/agent-mode/conversations/${conversationId}/messages/${messageId}/`, {
+      method: "PATCH",
+      body: { client_id: this.config.clientId, message }
+    });
+  }
+  deleteMessage(conversationId, messageId) {
+    return this.request(`/agent-mode/conversations/${conversationId}/messages/${messageId}/`, {
+      method: "DELETE"
+    });
+  }
+  search(query, limit = 20) {
+    const qs = new URLSearchParams({ query, limit: String(limit) });
+    return this.request(`/agent-mode/search/?${qs.toString()}`);
+  }
+  getToolTrust() {
+    return this.request("/agent-mode/tool-trust/");
+  }
+  setToolTrust(toolName, trusted) {
+    return this.request("/agent-mode/tool-trust/", {
+      method: "POST",
+      body: { client_id: this.config.clientId, tool_name: toolName, trusted }
+    });
+  }
+};
+
+// src/realtime-client.ts
+var AgentRealtimeClient = class {
+  config;
+  conversationId;
+  handlers;
+  socket = null;
+  lastSeq = 0;
+  closed = false;
+  retries = 0;
+  reconnectTimer = null;
+  constructor(config, conversationId, handlers, lastSeq = 0) {
+    this.config = config;
+    this.conversationId = conversationId;
+    this.handlers = handlers;
+    this.lastSeq = lastSeq;
+  }
+  async connect() {
+    if (this.closed || typeof WebSocket === "undefined") return;
+    const url = await this.buildUrl();
+    if (!url) return;
+    this.handlers.onStatus?.("connecting");
+    let socket;
+    try {
+      socket = new WebSocket(url);
+    } catch {
+      this.scheduleReconnect();
+      return;
+    }
+    this.socket = socket;
+    socket.onopen = () => {
+      this.retries = 0;
+      this.handlers.onStatus?.("open");
+      this.send({ action: "sync", last_seq: this.lastSeq });
+    };
+    socket.onmessage = (raw) => {
+      let event;
+      try {
+        event = JSON.parse(raw.data);
+      } catch {
+        return;
+      }
+      this.trackSeq(event);
+      this.handlers.onEvent(event);
+    };
+    socket.onclose = () => {
+      this.handlers.onStatus?.("closed");
+      if (!this.closed) this.scheduleReconnect();
+    };
+    socket.onerror = () => {
+      try {
+        socket.close();
+      } catch {
+      }
+    };
+  }
+  /** Advance the local high-water mark so a reconnect replays only the true gap. */
+  trackSeq(event) {
+    if (event.type === "sync") {
+      if (typeof event.last_seq === "number") this.lastSeq = Math.max(this.lastSeq, event.last_seq);
+    } else if (event.type === "message" || event.type === "message_edited") {
+      const seq = event.message?.seq;
+      if (typeof seq === "number") this.lastSeq = Math.max(this.lastSeq, seq);
+    }
+  }
+  setLastSeq(seq) {
+    if (seq > this.lastSeq) this.lastSeq = seq;
+  }
+  sendTyping(isTyping) {
+    this.send({ action: "typing", is_typing: isTyping });
+  }
+  markRead(seq) {
+    this.setLastSeq(seq);
+    this.send({ action: "read", seq });
+  }
+  requestSync() {
+    this.send({ action: "sync", last_seq: this.lastSeq });
+  }
+  close() {
+    this.closed = true;
+    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+    this.reconnectTimer = null;
+    if (this.socket) {
+      try {
+        this.socket.close();
+      } catch {
+      }
+      this.socket = null;
+    }
+  }
+  send(payload) {
+    if (this.socket && this.socket.readyState === WebSocket.OPEN) {
+      try {
+        this.socket.send(JSON.stringify(payload));
+      } catch {
+      }
+    }
+  }
+  scheduleReconnect() {
+    if (this.closed || this.reconnectTimer) return;
+    this.retries += 1;
+    const delay = Math.min(3e4, 1e3 * 2 ** Math.min(this.retries, 5));
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      void this.connect();
+    }, delay);
+  }
+  async buildUrl() {
+    const token = await this.config.getAccessToken();
+    if (!token) return null;
+    const base = (this.config.realtime?.baseUrl ?? this.config.apiBaseUrl).replace(/\/$/, "").replace(/^http/, "ws");
+    const params = new URLSearchParams({
+      client_id: this.config.clientId,
+      token,
+      last_seq: String(this.lastSeq)
+    });
+    return `${base}/ws/agent-mode/conversations/${this.conversationId}/?${params.toString()}`;
+  }
 };
 
 // src/file-support.ts
@@ -259,7 +484,7 @@ function formatBytes(bytes) {
   return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
 function AgentImageLightbox({ src, alt, onClose }) {
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (!src) return;
     const onKey = (event) => {
       if (event.key === "Escape") onClose();
@@ -329,24 +554,24 @@ function pickMimeType() {
   return "";
 }
 function AgentVoiceRecorder({ maxSeconds, transcribe, onDone, onCancel, onError }) {
-  const [phase, setPhase] = React12.useState("recording");
-  const [elapsed, setElapsed] = React12.useState(0);
-  const [playing, setPlaying] = React12.useState(false);
-  const recorderRef = React12.useRef(null);
-  const streamRef = React12.useRef(null);
-  const chunksRef = React12.useRef([]);
-  const blobRef = React12.useRef(null);
-  const audioUrlRef = React12.useRef(null);
-  const audioRef = React12.useRef(null);
-  const timerRef = React12.useRef(null);
-  const canvasRef = React12.useRef(null);
-  const audioContextRef = React12.useRef(null);
-  const analyserRef = React12.useRef(null);
-  const rafRef = React12.useRef(null);
-  const levelsRef = React12.useRef(new Array(MAX_BARS).fill(0));
-  const onErrorRef = React12.useRef(onError);
+  const [phase, setPhase] = React13.useState("recording");
+  const [elapsed, setElapsed] = React13.useState(0);
+  const [playing, setPlaying] = React13.useState(false);
+  const recorderRef = React13.useRef(null);
+  const streamRef = React13.useRef(null);
+  const chunksRef = React13.useRef([]);
+  const blobRef = React13.useRef(null);
+  const audioUrlRef = React13.useRef(null);
+  const audioRef = React13.useRef(null);
+  const timerRef = React13.useRef(null);
+  const canvasRef = React13.useRef(null);
+  const audioContextRef = React13.useRef(null);
+  const analyserRef = React13.useRef(null);
+  const rafRef = React13.useRef(null);
+  const levelsRef = React13.useRef(new Array(MAX_BARS).fill(0));
+  const onErrorRef = React13.useRef(onError);
   onErrorRef.current = onError;
-  const stopMeter = React12.useCallback(() => {
+  const stopMeter = React13.useCallback(() => {
     if (rafRef.current != null) {
       cancelAnimationFrame(rafRef.current);
       rafRef.current = null;
@@ -357,7 +582,7 @@ function AgentVoiceRecorder({ maxSeconds, transcribe, onDone, onCancel, onError
     if (ctx && ctx.state !== "closed") void ctx.close().catch(() => {
     });
   }, []);
-  const stopTracks = React12.useCallback(() => {
+  const stopTracks = React13.useCallback(() => {
     streamRef.current?.getTracks().forEach((track) => track.stop());
     streamRef.current = null;
     if (timerRef.current) {
@@ -366,7 +591,7 @@ function AgentVoiceRecorder({ maxSeconds, transcribe, onDone, onCancel, onError
     }
     stopMeter();
   }, [stopMeter]);
-  const startMeter = React12.useCallback((stream) => {
+  const startMeter = React13.useCallback((stream) => {
     const Ctor = typeof window === "undefined" ? void 0 : window.AudioContext ?? window.webkitAudioContext;
     if (!Ctor) return;
     let context;
@@ -436,7 +661,7 @@ function AgentVoiceRecorder({ maxSeconds, transcribe, onDone, onCancel, onError
     };
     rafRef.current = requestAnimationFrame(draw);
   }, []);
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     let cancelled = false;
     void (async () => {
       if (typeof navigator === "undefined" || !navigator.mediaDevices?.getUserMedia) {
@@ -589,40 +814,40 @@ function AgentComposer({
   voiceEnabled,
   voiceMaxSeconds = 600
 }) {
-  const textareaRef = React12.useRef(null);
-  const inputRef = React12.useRef(null);
-  const [recording, setRecording] = React12.useState(false);
-  const [lightboxSrc, setLightboxSrc] = React12.useState(null);
+  const textareaRef = React13.useRef(null);
+  const inputRef = React13.useRef(null);
+  const [recording, setRecording] = React13.useState(false);
+  const [lightboxSrc, setLightboxSrc] = React13.useState(null);
   const canSubmit = !disabled && !busy && (value.trim().length > 0 || files.length > 0);
   const voiceAvailable = Boolean(voiceEnabled && onTranscribe);
-  const submit = React12.useCallback(() => {
+  const submit = React13.useCallback(() => {
     if (!canSubmit) return;
     onSubmit(value.trim());
     textareaRef.current?.focus();
   }, [canSubmit, onSubmit, value]);
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (!disabled) textareaRef.current?.focus();
   }, [disabled]);
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     const textarea = textareaRef.current;
     if (!textarea) return;
     textarea.style.height = "auto";
     textarea.style.height = `${Math.min(textarea.scrollHeight, 144)}px`;
   }, [value]);
-  const previews = React12.useMemo(
+  const previews = React13.useMemo(
     () => files.map((file, originalIndex) => {
       const image = isImageFile(file);
       return { file, image, originalIndex, url: image ? URL.createObjectURL(file) : null };
     }),
     [files]
   );
-  React12.useEffect(
+  React13.useEffect(
     () => () => {
       previews.forEach((preview) => preview.url && URL.revokeObjectURL(preview.url));
     },
     [previews]
   );
-  const ordered = React12.useMemo(
+  const ordered = React13.useMemo(
     () => [...previews].sort((a, b) => Number(b.image) - Number(a.image)),
     [previews]
   );
@@ -866,16 +1091,114 @@ function groupMessages(messages) {
   flush();
   return items;
 }
+function audienceLabel(scope) {
+  return scope === "event" ? "this event's organizers" : "your team";
+}
+function AgentVisibilityControl({ config, conversation, onSetVisibility }) {
+  const [open, setOpen] = React13.useState(false);
+  const collab = config.collaboration;
+  const scope = collab?.scope;
+  const isPublic = conversation.visibility === "public";
+  if (collab?.enabled === false) return null;
+  if (!conversation.can_toggle_visibility) {
+    if (!isPublic) return null;
+    return /* @__PURE__ */ jsxs(Tooltip, { children: [
+      /* @__PURE__ */ jsx(
+        TooltipTrigger,
+        {
+          render: /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-primary/10 px-2 py-0.5 text-primary text-xs", children: [
+            /* @__PURE__ */ jsx(UsersIcon, { className: "size-3" }),
+            "Shared"
+          ] })
+        }
+      ),
+      /* @__PURE__ */ jsxs(TooltipContent, { children: [
+        "Shared with ",
+        audienceLabel(scope)
+      ] })
+    ] });
+  }
+  const eventId = scope === "event" ? collab?.getEventId?.() ?? null : null;
+  const missingEvent = scope === "event" && !eventId;
+  const makePublic = () => {
+    onSetVisibility("public", eventId ? { scopeEventId: eventId } : void 0);
+    setOpen(false);
+  };
+  const makePrivate = () => {
+    onSetVisibility("private");
+    setOpen(false);
+  };
+  return /* @__PURE__ */ jsxs(Popover, { onOpenChange: setOpen, open, children: [
+    /* @__PURE__ */ jsxs(Tooltip, { children: [
+      /* @__PURE__ */ jsx(
+        TooltipTrigger,
+        {
+          render: /* @__PURE__ */ jsx(
+            PopoverTrigger,
+            {
+              render: /* @__PURE__ */ jsx(
+                Button,
+                {
+                  "aria-label": isPublic ? "Shared conversation" : "Private conversation",
+                  size: "icon-sm",
+                  variant: "ghost",
+                  children: isPublic ? /* @__PURE__ */ jsx(UsersIcon, { className: "text-primary" }) : /* @__PURE__ */ jsx(LockIcon, {})
+                }
+              )
+            }
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx(TooltipContent, { children: isPublic ? "Shared \u2014 manage access" : "Private \u2014 share" })
+    ] }),
+    /* @__PURE__ */ jsx(PopoverPopup, { className: "w-72 p-3", children: isPublic ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 font-medium text-sm", children: [
+        /* @__PURE__ */ jsx(GlobeIcon, { className: "size-4 text-primary" }),
+        "Shared conversation"
+      ] }),
+      /* @__PURE__ */ jsxs("p", { className: "text-muted-foreground text-xs", children: [
+        "Everyone in ",
+        audienceLabel(scope),
+        " can see this conversation and everything in it."
+      ] }),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          className: "mt-1 w-full",
+          disabled: !conversation.can_go_private,
+          onClick: makePrivate,
+          size: "sm",
+          variant: "outline",
+          children: "Make private"
+        }
+      ),
+      !conversation.can_go_private ? /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-xs", children: "Others have already taken part, so this can no longer be made private." }) : null
+    ] }) : /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 font-medium text-sm", children: [
+        /* @__PURE__ */ jsx(UsersIcon, { className: "size-4" }),
+        "Share this conversation"
+      ] }),
+      /* @__PURE__ */ jsxs("p", { className: "text-muted-foreground text-xs", children: [
+        audienceLabel(scope),
+        " will be able to see this conversation",
+        /* @__PURE__ */ jsx("strong", { children: " and its full history" }),
+        ", and take part in it."
+      ] }),
+      missingEvent ? /* @__PURE__ */ jsx("p", { className: "text-destructive text-xs", children: "Open an event first \u2014 a shared conversation is tied to a specific event." }) : null,
+      /* @__PURE__ */ jsx(Button, { className: "mt-1 w-full", disabled: missingEvent, onClick: makePublic, size: "sm", children: "Make public" })
+    ] }) })
+  ] });
+}
 function ChatScroller({ children, className, ...props }) {
-  const viewportRef = React12.useRef(null);
-  const pinnedRef = React12.useRef(true);
-  const handleScroll = React12.useCallback(() => {
+  const viewportRef = React13.useRef(null);
+  const pinnedRef = React13.useRef(true);
+  const handleScroll = React13.useCallback(() => {
     const viewport = viewportRef.current;
     if (!viewport) return;
     const distanceFromBottom = viewport.scrollHeight - viewport.scrollTop - viewport.clientHeight;
     pinnedRef.current = distanceFromBottom < 64;
   }, []);
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     const viewport = viewportRef.current;
     if (!viewport || !pinnedRef.current) return;
     viewport.scrollTop = viewport.scrollHeight;
@@ -895,10 +1218,10 @@ function ChatScroller({ children, className, ...props }) {
 var MIN_CHARS_PER_FRAME = 2;
 var CATCH_UP = 0.22;
 function usePrefersReducedMotion() {
-  const [reduced, setReduced] = React12.useState(
+  const [reduced, setReduced] = React13.useState(
     () => typeof matchMedia !== "undefined" && matchMedia("(prefers-reduced-motion: reduce)").matches
   );
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (typeof matchMedia === "undefined") return;
     const mq = matchMedia("(prefers-reduced-motion: reduce)");
     const onChange = (event) => setReduced(event.matches);
@@ -910,12 +1233,12 @@ function usePrefersReducedMotion() {
 function useSmoothText(target, animate) {
   const prefersReduced = usePrefersReducedMotion();
   const enabled = animate && !prefersReduced;
-  const [count, setCount] = React12.useState(() => enabled ? 0 : target.length);
-  const countRef = React12.useRef(count);
+  const [count, setCount] = React13.useState(() => enabled ? 0 : target.length);
+  const countRef = React13.useRef(count);
   countRef.current = count;
-  const everEnabled = React12.useRef(enabled);
+  const everEnabled = React13.useRef(enabled);
   if (enabled) everEnabled.current = true;
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (!everEnabled.current) {
       if (countRef.current !== target.length) setCount(target.length);
       return;
@@ -944,14 +1267,14 @@ function useSmoothText(target, animate) {
   return everEnabled.current ? target.slice(0, Math.floor(count)) : target;
 }
 function CopyButton({ className, text }) {
-  const [copied, setCopied] = React12.useState(false);
-  const timerRef = React12.useRef(null);
-  React12.useEffect(() => {
+  const [copied, setCopied] = React13.useState(false);
+  const timerRef = React13.useRef(null);
+  React13.useEffect(() => {
     return () => {
       if (timerRef.current) clearTimeout(timerRef.current);
     };
   }, []);
-  const copy = React12.useCallback(async () => {
+  const copy = React13.useCallback(async () => {
     try {
       await navigator.clipboard.writeText(text);
     } catch {
@@ -984,7 +1307,7 @@ function CopyButton({ className, text }) {
 }
 var isImageAttachment = (format) => IMAGE_ACCEPT.includes(`.${format.toLowerCase()}`);
 function MessageItem({ animate = false, message }) {
-  const [lightboxSrc, setLightboxSrc] = React12.useState(null);
+  const [lightboxSrc, setLightboxSrc] = React13.useState(null);
   const displayed = useSmoothText(message.content ?? "", animate && message.role === "assistant");
   if (message.role === "user") {
     const attachments = message.attachments ?? [];
@@ -1069,8 +1392,8 @@ var DEFAULT_PHRASES = [
 ];
 function ThinkingIndicator({ className, intervalMs = 1800, phrases }) {
   const words = phrases && phrases.length ? phrases : DEFAULT_PHRASES;
-  const [index, setIndex] = React12.useState(0);
-  React12.useEffect(() => {
+  const [index, setIndex] = React13.useState(0);
+  React13.useEffect(() => {
     setIndex(0);
     const timer = setInterval(() => {
       setIndex((current) => (current + 1) % words.length);
@@ -1318,7 +1641,7 @@ function DownloadButton({ block, size = "sm" }) {
   );
 }
 function DocumentViewer({ block, onClose }) {
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     const onKey = (event) => event.key === "Escape" && onClose();
     window.addEventListener("keydown", onKey);
     return () => window.removeEventListener("keydown", onKey);
@@ -1343,7 +1666,7 @@ function DocumentViewer({ block, onClose }) {
   ] });
 }
 function DocumentCard({ block }) {
-  const [open, setOpen] = React12.useState(false);
+  const [open, setOpen] = React13.useState(false);
   const previewLines = (block.preview || "").split("\n").slice(0, 6).join("\n");
   return /* @__PURE__ */ jsxs("div", { className: "w-full max-w-full overflow-hidden rounded-xl border border-border bg-card shadow-xs", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-border/72 border-b px-3 py-2", children: [
@@ -1465,7 +1788,7 @@ function StepDetail({
   ] });
 }
 function ToolActivityGroup({ describeToolCall, steps }) {
-  const [open, setOpen] = React12.useState(false);
+  const [open, setOpen] = React13.useState(false);
   if (steps.length === 0) return null;
   const last = steps[steps.length - 1];
   const anyRunning = steps.some((step) => step.status === "running");
@@ -1558,6 +1881,12 @@ function ToolApprovalCard({
     ] })
   ] });
 }
+function contextMeterLabel(meter) {
+  const pct = Math.round(meter.pct * 100);
+  if (meter.state === "full") return `Context full (${pct}%) \u2014 start a new chat to continue`;
+  if (meter.state === "summarizing") return `Context ${pct}% \u2014 summarizing older messages`;
+  return `Context ${pct}% used`;
+}
 function AgentPanel({
   agentMode,
   canToggleAgentMode,
@@ -1570,12 +1899,12 @@ function AgentPanel({
   onClose,
   onToggleAgentMode
 }) {
-  const [draft, setDraft] = React12.useState("");
-  const [view, setView] = React12.useState("chat");
-  const [files, setFiles] = React12.useState([]);
-  const [uploadError, setUploadError] = React12.useState(null);
-  const [dragging, setDragging] = React12.useState(false);
-  const dragDepth = React12.useRef(0);
+  const [draft, setDraft] = React13.useState("");
+  const [view, setView] = React13.useState("chat");
+  const [files, setFiles] = React13.useState([]);
+  const [uploadError, setUploadError] = React13.useState(null);
+  const [dragging, setDragging] = React13.useState(false);
+  const dragDepth = React13.useRef(0);
   const agentName = config.agentName ?? chat.agentInfo?.name ?? "Assistant";
   const caps = {
     visionEnabled: chat.agentInfo?.vision_enabled,
@@ -1586,7 +1915,25 @@ function AgentPanel({
     "What can you help me with?",
     "Give me a quick summary of my data."
   ];
-  const addFiles = React12.useCallback(
+  const typingLabel = React13.useMemo(() => {
+    const names = Object.values(chat.typingUsers);
+    if (!names.length) return null;
+    if (names.length === 1) return `${names[0]} is typing\u2026`;
+    if (names.length === 2) return `${names[0]} and ${names[1]} are typing\u2026`;
+    return `${names.length} people are typing\u2026`;
+  }, [chat.typingUsers]);
+  const draftEpochRef = React13.useRef(-1);
+  React13.useEffect(() => {
+    if (draftEpochRef.current === chat.conversationEpoch) return;
+    draftEpochRef.current = chat.conversationEpoch;
+    setDraft(chat.myState?.draft_text ?? "");
+  }, [chat.conversationEpoch, chat.myState?.draft_text]);
+  React13.useEffect(() => {
+    if (!chat.conversationId) return;
+    const handle = setTimeout(() => chat.saveDraft(draft), 600);
+    return () => clearTimeout(handle);
+  }, [draft, chat.conversationId, chat.saveDraft]);
+  const addFiles = React13.useCallback(
     (incoming) => {
       const accepted = [];
       let rejection = null;
@@ -1603,10 +1950,10 @@ function AgentPanel({
     },
     [config, caps.visionEnabled, caps.visionMaxMb]
   );
-  const removeFile = React12.useCallback((index) => {
+  const removeFile = React13.useCallback((index) => {
     setFiles((current) => current.filter((_, i) => i !== index));
   }, []);
-  const handleSubmit = React12.useCallback(
+  const handleSubmit = React13.useCallback(
     (text) => {
       const staged = files;
       setDraft("");
@@ -1616,7 +1963,7 @@ function AgentPanel({
     },
     [chat, files]
   );
-  const onDragEnter = React12.useCallback(
+  const onDragEnter = React13.useCallback(
     (event) => {
       if (!uploadEnabled || !event.dataTransfer?.types?.includes("Files")) return;
       dragDepth.current += 1;
@@ -1624,12 +1971,12 @@ function AgentPanel({
     },
     [uploadEnabled]
   );
-  const onDragLeave = React12.useCallback((event) => {
+  const onDragLeave = React13.useCallback((event) => {
     if (!event.dataTransfer?.types?.includes("Files")) return;
     dragDepth.current = Math.max(0, dragDepth.current - 1);
     if (dragDepth.current === 0) setDragging(false);
   }, []);
-  const onDrop = React12.useCallback(
+  const onDrop = React13.useCallback(
     (event) => {
       if (!uploadEnabled) return;
       event.preventDefault();
@@ -1640,7 +1987,7 @@ function AgentPanel({
     },
     [addFiles, uploadEnabled]
   );
-  const openHistory = React12.useCallback(() => {
+  const openHistory = React13.useCallback(() => {
     setView("history");
     void chat.refreshConversations();
   }, [chat]);
@@ -1671,10 +2018,59 @@ function AgentPanel({
             /* @__PURE__ */ jsx(ChatHeaderAvatar, {}),
             /* @__PURE__ */ jsxs(ChatHeaderTitle, { children: [
               /* @__PURE__ */ jsx("div", { className: "truncate font-medium text-sm", children: agentName }),
-              config.tagline ? /* @__PURE__ */ jsx("div", { className: "truncate text-muted-foreground text-xs", children: config.tagline }) : null
-            ] })
+              typingLabel ? /* @__PURE__ */ jsx("div", { className: "truncate text-primary text-xs", children: typingLabel }) : config.tagline ? /* @__PURE__ */ jsx("div", { className: "truncate text-muted-foreground text-xs", children: config.tagline }) : null
+            ] }),
+            chat.participants.length > 1 ? /* @__PURE__ */ jsx(
+              AvatarGroup,
+              {
+                className: "ml-0.5",
+                items: chat.participants.map((participant) => ({
+                  alt: participant.name,
+                  name: participant.name,
+                  src: participant.avatar_url ?? void 0
+                })),
+                max: 4,
+                showNameOnHover: true,
+                size: "sm"
+              }
+            ) : null
           ] }),
           /* @__PURE__ */ jsxs(ChatHeaderActions, { children: [
+            chat.currentConversation ? /* @__PURE__ */ jsx(
+              AgentVisibilityControl,
+              {
+                config,
+                conversation: chat.currentConversation,
+                onSetVisibility: chat.setVisibility
+              }
+            ) : null,
+            chat.contextMeter && chat.contextMeter.pct > 0 ? /* @__PURE__ */ jsxs(Tooltip, { children: [
+              /* @__PURE__ */ jsx(
+                TooltipTrigger,
+                {
+                  render: /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      "aria-label": contextMeterLabel(chat.contextMeter),
+                      className: "mr-0.5 inline-flex cursor-default items-center rounded-full outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                      type: "button",
+                      children: /* @__PURE__ */ jsx(
+                        ContextMeter,
+                        {
+                          lockAt: chat.contextMeter.lock_at,
+                          pct: chat.contextMeter.pct,
+                          size: 18,
+                          state: chat.contextMeter.state,
+                          summarizeAt: chat.contextMeter.summarize_at,
+                          warnAt: chat.contextMeter.warn_at
+                        }
+                      )
+                    }
+                  )
+                }
+              ),
+              /* @__PURE__ */ jsx(TooltipContent, { children: contextMeterLabel(chat.contextMeter) })
+            ] }) : null,
             /* @__PURE__ */ jsxs(Tooltip, { children: [
               /* @__PURE__ */ jsx(
                 TooltipTrigger,
@@ -1813,7 +2209,7 @@ function AgentPanel({
                   }
                 }
               }
-              return grouped.map((item) => /* @__PURE__ */ jsxs(React12.Fragment, { children: [
+              return grouped.map((item) => /* @__PURE__ */ jsxs(React13.Fragment, { children: [
                 item.key === anchorKey ? /* @__PURE__ */ jsx(NewMessagesDivider, {}) : null,
                 /* @__PURE__ */ jsx(
                   motion.div,
@@ -1896,6 +2292,43 @@ var OPTIMISTIC_ID_PREFIX = "optimistic-";
 var STREAMING_ID_PREFIX = "streaming-";
 var optimisticCounter = 0;
 var streamingCounter = 0;
+function newIdempotencyKey() {
+  try {
+    if (typeof crypto !== "undefined" && "randomUUID" in crypto) return crypto.randomUUID();
+  } catch {
+  }
+  return `idem-${Date.now()}-${Math.floor(Math.random() * 1e9)}`;
+}
+function mergeMessages(current, incoming) {
+  if (!incoming?.length) return current;
+  const settledIds = new Set(
+    current.filter((m) => !m.id.startsWith(OPTIMISTIC_ID_PREFIX)).map((m) => m.id)
+  );
+  const additions = incoming.filter((m) => m.id && !settledIds.has(m.id));
+  if (!additions.length) return current;
+  let base = current;
+  const optimistic = current.filter((m) => m.id.startsWith(OPTIMISTIC_ID_PREFIX));
+  const placeholder = optimistic[optimistic.length - 1];
+  if (placeholder) {
+    const echoIndex = additions.findIndex(
+      (m) => m.role === "user" && (m.content ?? "") === (placeholder.content ?? "")
+    );
+    if (echoIndex !== -1) {
+      base = current.filter((m) => m.id !== placeholder.id);
+      additions[echoIndex] = {
+        ...additions[echoIndex],
+        client_key: placeholder.client_key ?? placeholder.id
+      };
+    }
+  }
+  const merged = [...base, ...additions];
+  merged.sort((a, b) => {
+    const sa = typeof a.seq === "number" ? a.seq : Number.MAX_SAFE_INTEGER;
+    const sb = typeof b.seq === "number" ? b.seq : Number.MAX_SAFE_INTEGER;
+    return sa - sb;
+  });
+  return merged;
+}
 function buildOptimisticUserMessage(text, files) {
   optimisticCounter += 1;
   const attachments = (files ?? []).map((file, index) => ({
@@ -1913,17 +2346,25 @@ function buildOptimisticUserMessage(text, files) {
   };
 }
 function useAgentChat(config) {
-  const client = React12.useMemo(() => new AgentApiClient(config), [config]);
-  const [agentInfo, setAgentInfo] = React12.useState(null);
-  const [conversationId, setConversationId] = React12.useState(null);
-  const [conversationEpoch, setConversationEpoch] = React12.useState(0);
-  const [conversations, setConversations] = React12.useState([]);
-  const [messages, setMessages] = React12.useState([]);
-  const [pendingApprovals, setPendingApprovals] = React12.useState([]);
-  const [sending, setSending] = React12.useState(false);
-  const [resolvingApprovalId, setResolvingApprovalId] = React12.useState(null);
-  const [error, setError] = React12.useState(null);
-  React12.useEffect(() => {
+  const client = React13.useMemo(() => new AgentApiClient(config), [config]);
+  const configRef = React13.useRef(config);
+  configRef.current = config;
+  const [agentInfo, setAgentInfo] = React13.useState(null);
+  const [conversationId, setConversationId] = React13.useState(null);
+  const [conversationEpoch, setConversationEpoch] = React13.useState(0);
+  const [conversations, setConversations] = React13.useState([]);
+  const [messages, setMessages] = React13.useState([]);
+  const [pendingApprovals, setPendingApprovals] = React13.useState([]);
+  const [sending, setSending] = React13.useState(false);
+  const [resolvingApprovalId, setResolvingApprovalId] = React13.useState(null);
+  const [error, setError] = React13.useState(null);
+  const [currentConversation, setCurrentConversation] = React13.useState(null);
+  const [contextMeter, setContextMeter] = React13.useState(null);
+  const [participants, setParticipants] = React13.useState([]);
+  const [myState, setMyState] = React13.useState(null);
+  const [typingUsers, setTypingUsers] = React13.useState({});
+  const [realtimeStatus, setRealtimeStatus] = React13.useState("idle");
+  React13.useEffect(() => {
     let cancelled = false;
     client.getConfig().then((info) => {
       if (!cancelled) setAgentInfo(info);
@@ -1933,11 +2374,11 @@ function useAgentChat(config) {
       cancelled = true;
     };
   }, [client]);
-  const handleFailure = React12.useCallback((err) => {
+  const handleFailure = React13.useCallback((err) => {
     const message = err instanceof AgentApiError ? err.message : "Something went wrong. Please try again.";
     setError(message);
   }, []);
-  const applyResponse = React12.useCallback(
+  const applyResponse = React13.useCallback(
     (response) => {
       if (response.status === "error" && !response.messages?.length) {
         setError(response.message ?? "The assistant could not answer.");
@@ -1967,7 +2408,7 @@ function useAgentChat(config) {
     },
     []
   );
-  const handleStreamEvent = React12.useCallback(
+  const handleStreamEvent = React13.useCallback(
     (event, ctx) => {
       switch (event.type) {
         case "conversation":
@@ -2045,29 +2486,93 @@ function useAgentChat(config) {
     },
     []
   );
+  const applyRealtime = React13.useCallback((event) => {
+    switch (event.type) {
+      case "sync":
+        setMessages((current) => mergeMessages(current, event.messages ?? []));
+        break;
+      case "message":
+        setMessages((current) => mergeMessages(current, [event.message]));
+        break;
+      case "message_edited":
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === event.message.id ? { ...event.message, client_key: message.client_key ?? message.id } : message
+          )
+        );
+        break;
+      case "message_deleted":
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === event.message_id ? { ...message, deleted: true, content: "" } : message
+          )
+        );
+        break;
+      case "typing":
+        setTypingUsers((current) => {
+          const next = { ...current };
+          if (event.is_typing) next[event.user_id] = event.name;
+          else delete next[event.user_id];
+          return next;
+        });
+        break;
+      case "visibility_changed":
+        setCurrentConversation(
+          (current) => current ? { ...current, visibility: event.visibility } : current
+        );
+        break;
+    }
+  }, []);
+  const realtimeEnabled = config.realtime?.enabled !== false;
+  const isPublic = currentConversation?.visibility === "public";
+  const baselineSeq = currentConversation?.last_seq ?? 0;
+  React13.useEffect(() => {
+    if (!realtimeEnabled || !conversationId || !isPublic) {
+      setRealtimeStatus("idle");
+      return;
+    }
+    const rt = new AgentRealtimeClient(
+      configRef.current,
+      conversationId,
+      { onEvent: applyRealtime, onStatus: setRealtimeStatus },
+      baselineSeq
+    );
+    void rt.connect();
+    return () => {
+      rt.close();
+    };
+  }, [applyRealtime, baselineSeq, conversationId, isPublic, realtimeEnabled]);
   const streamingEnabled = config.streaming !== false && typeof ReadableStream !== "undefined";
-  const send = React12.useCallback(
+  const send = React13.useCallback(
     async (text, files) => {
       if (sending) return;
       if (!text.trim() && !(files && files.length)) return;
       setSending(true);
       setError(null);
       setMessages((current) => [...current, buildOptimisticUserMessage(text, files)]);
+      const idempotencyKey = newIdempotencyKey();
       try {
         if (streamingEnabled) {
           const ctx = { streamingId: null };
           let started = false;
           try {
-            await client.streamMessage(text, conversationId, files, (event) => {
-              started = true;
-              handleStreamEvent(event, ctx);
-            });
+            await client.streamMessage(
+              text,
+              conversationId,
+              files,
+              (event) => {
+                started = true;
+                handleStreamEvent(event, ctx);
+              },
+              void 0,
+              { idempotencyKey }
+            );
             return;
           } catch (err) {
             if (started) throw err;
           }
         }
-        const response = await client.sendMessage(text, conversationId, files);
+        const response = await client.sendMessage(text, conversationId, files, { idempotencyKey });
         applyResponse(response);
       } catch (err) {
         handleFailure(err);
@@ -2077,14 +2582,14 @@ function useAgentChat(config) {
     },
     [applyResponse, client, conversationId, handleFailure, handleStreamEvent, sending, streamingEnabled]
   );
-  const transcribe = React12.useCallback(
+  const transcribe = React13.useCallback(
     async (audio) => {
       const { text } = await client.transcribe(audio);
       return text;
     },
     [client]
   );
-  const resolveApproval = React12.useCallback(
+  const resolveApproval = React13.useCallback(
     async (callId, approve) => {
       if (resolvingApprovalId) return;
       setResolvingApprovalId(callId);
@@ -2113,14 +2618,19 @@ function useAgentChat(config) {
     },
     [applyResponse, client, handleFailure, handleStreamEvent, resolvingApprovalId, streamingEnabled]
   );
-  const newChat = React12.useCallback(() => {
+  const newChat = React13.useCallback(() => {
     setConversationId(null);
     setMessages([]);
     setPendingApprovals([]);
     setError(null);
+    setCurrentConversation(null);
+    setContextMeter(null);
+    setParticipants([]);
+    setMyState(null);
+    setTypingUsers({});
     setConversationEpoch((e) => e + 1);
   }, []);
-  const refreshConversations = React12.useCallback(async () => {
+  const refreshConversations = React13.useCallback(async () => {
     try {
       const { conversations: list } = await client.listConversations();
       setConversations(list);
@@ -2130,7 +2640,7 @@ function useAgentChat(config) {
       return [];
     }
   }, [client, handleFailure]);
-  const openConversation = React12.useCallback(
+  const openConversation = React13.useCallback(
     async (id) => {
       setError(null);
       try {
@@ -2138,6 +2648,23 @@ function useAgentChat(config) {
         setConversationId(id);
         setMessages(payload.messages ?? []);
         setPendingApprovals(payload.pending_approvals ?? []);
+        const convo = payload.conversation;
+        setCurrentConversation(
+          convo ? {
+            id: convo.id,
+            title: convo.title,
+            visibility: convo.visibility,
+            scope_type: convo.scope_type,
+            last_seq: convo.last_seq,
+            is_creator: convo.is_creator,
+            can_toggle_visibility: convo.can_toggle_visibility,
+            can_go_private: convo.can_go_private
+          } : null
+        );
+        setContextMeter(payload.context_meter ?? null);
+        setParticipants(payload.participants ?? []);
+        setMyState(payload.my_state ?? null);
+        setTypingUsers({});
         setConversationEpoch((e) => e + 1);
       } catch (err) {
         handleFailure(err);
@@ -2145,7 +2672,7 @@ function useAgentChat(config) {
     },
     [client, handleFailure]
   );
-  const deleteConversation = React12.useCallback(
+  const deleteConversation = React13.useCallback(
     async (id) => {
       try {
         await client.deleteConversation(id);
@@ -2157,25 +2684,91 @@ function useAgentChat(config) {
     },
     [client, conversationId, handleFailure, newChat]
   );
-  const clearError = React12.useCallback(() => setError(null), []);
+  const setVisibility = React13.useCallback(
+    async (visibility, opts) => {
+      if (!conversationId) return;
+      setError(null);
+      try {
+        const scope = configRef.current.collaboration?.scope;
+        const res = await client.setVisibility(
+          conversationId,
+          visibility,
+          visibility === "public" ? { scopeType: scope, scopeEventId: opts?.scopeEventId } : void 0
+        );
+        if (res.status === "error") {
+          setError(res.message ?? "Could not change the conversation's visibility.");
+          return;
+        }
+        setCurrentConversation(
+          (current) => current ? { ...current, visibility, can_go_private: Boolean(res.can_go_private) } : current
+        );
+        void client.listParticipants(conversationId).then((p) => setParticipants(p.participants ?? [])).catch(() => {
+        });
+      } catch (err) {
+        handleFailure(err);
+      }
+    },
+    [client, conversationId, handleFailure]
+  );
+  const markRead = React13.useCallback(
+    (seq) => {
+      if (!conversationId || seq <= 0) return;
+      setMyState(
+        (current) => current && seq > current.last_read_seq ? { ...current, last_read_seq: seq } : current
+      );
+      void client.markRead(conversationId, seq).catch(() => {
+      });
+    },
+    [client, conversationId]
+  );
+  const saveDraft = React13.useCallback(
+    (text) => {
+      if (!conversationId) return;
+      void client.saveDraft(conversationId, text).catch(() => {
+      });
+    },
+    [client, conversationId]
+  );
+  const summarize = React13.useCallback(async () => {
+    if (!conversationId) return;
+    setError(null);
+    try {
+      await client.summarize(conversationId);
+      const detail = await client.getConversation(conversationId);
+      setContextMeter(detail.context_meter ?? null);
+    } catch (err) {
+      handleFailure(err);
+    }
+  }, [client, conversationId, handleFailure]);
+  const clearError = React13.useCallback(() => setError(null), []);
   return {
     agentInfo,
     clearError,
+    contextMeter,
     conversationId,
     conversationEpoch,
     conversations,
+    currentConversation,
     deleteConversation,
     error,
+    markRead,
     messages,
+    myState,
     newChat,
     openConversation,
+    participants,
     pendingApprovals,
+    realtimeStatus,
     refreshConversations,
     resolveApproval,
     resolvingApprovalId,
+    saveDraft,
     send,
     sending,
-    transcribe
+    setVisibility,
+    summarize,
+    transcribe,
+    typingUsers
   };
 }
 var STORAGE_PREFIX = "cc-agent-always-approve:";
@@ -2194,11 +2787,11 @@ function readStored(clientId) {
   }
 }
 function useAlwaysApprove(clientId) {
-  const [approved, setApproved] = React12.useState(() => /* @__PURE__ */ new Set());
-  React12.useEffect(() => {
+  const [approved, setApproved] = React13.useState(() => /* @__PURE__ */ new Set());
+  React13.useEffect(() => {
     setApproved(readStored(clientId));
   }, [clientId]);
-  const persist = React12.useCallback(
+  const persist = React13.useCallback(
     (next) => {
       setApproved(next);
       if (typeof window === "undefined") return;
@@ -2209,8 +2802,8 @@ function useAlwaysApprove(clientId) {
     },
     [clientId]
   );
-  const isAlwaysApproved = React12.useCallback((toolName) => approved.has(toolName), [approved]);
-  const setAlwaysApprove = React12.useCallback(
+  const isAlwaysApproved = React13.useCallback((toolName) => approved.has(toolName), [approved]);
+  const setAlwaysApprove = React13.useCallback(
     (toolName) => {
       if (approved.has(toolName)) return;
       const next = new Set(approved);
@@ -2219,7 +2812,7 @@ function useAlwaysApprove(clientId) {
     },
     [approved, persist]
   );
-  const clearAlwaysApprove = React12.useCallback(
+  const clearAlwaysApprove = React13.useCallback(
     (toolName) => {
       if (!approved.has(toolName)) return;
       const next = new Set(approved);
@@ -2245,10 +2838,10 @@ function AgentWidget({
   const isControlled = controlledOpen !== void 0;
   const isDocked = presentation === "docked";
   const storageKey2 = `cc-agent-open:${config.clientId}`;
-  const [uncontrolledOpen, setUncontrolledOpen] = React12.useState(false);
+  const [uncontrolledOpen, setUncontrolledOpen] = React13.useState(false);
   const open = controlledOpen ?? uncontrolledOpen;
-  const [bootstrapDone, setBootstrapDone] = React12.useState(isControlled);
-  const persist = React12.useCallback(
+  const [bootstrapDone, setBootstrapDone] = React13.useState(isControlled);
+  const persist = React13.useCallback(
     (next) => {
       if (isControlled || !behavior.persistOpenState) return;
       try {
@@ -2258,7 +2851,7 @@ function AgentWidget({
     },
     [behavior.persistOpenState, isControlled, storageKey2]
   );
-  const setOpen = React12.useCallback(
+  const setOpen = React13.useCallback(
     (next) => {
       setUncontrolledOpen(next);
       persist(next);
@@ -2266,14 +2859,14 @@ function AgentWidget({
     },
     [onOpenChange, persist]
   );
-  const [agentMode, setAgentMode] = React12.useState(false);
+  const [agentMode, setAgentMode] = React13.useState(false);
   const isDesktop = useMediaQuery("(min-width: 640px)", { defaultSSRValue: true, ssr: true });
   const fullscreen = !isDesktop || agentMode;
   const chat = useAgentChat(config);
   const alwaysApprove = useAlwaysApprove(config.clientId);
   const { messages, pendingApprovals, resolveApproval, resolvingApprovalId, sending } = chat;
-  const bootRef = React12.useRef(false);
-  React12.useEffect(() => {
+  const bootRef = React13.useRef(false);
+  React13.useEffect(() => {
     if (bootRef.current) return;
     if (isControlled && !isDocked) return;
     bootRef.current = true;
@@ -2305,15 +2898,15 @@ function AgentWidget({
       cancelled = true;
     };
   }, []);
-  const seenCountRef = React12.useRef(0);
-  const [baselined, setBaselined] = React12.useState(false);
-  const [anchorId, setAnchorId] = React12.useState(null);
-  React12.useEffect(() => {
+  const seenCountRef = React13.useRef(0);
+  const [baselined, setBaselined] = React13.useState(false);
+  const [anchorId, setAnchorId] = React13.useState(null);
+  React13.useEffect(() => {
     if (baselined || !bootstrapDone) return;
     seenCountRef.current = messages.length;
     setBaselined(true);
   }, [baselined, bootstrapDone, messages.length]);
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (open) {
       if (messages.length > seenCountRef.current) {
         const firstUnread = messages[seenCountRef.current];
@@ -2323,7 +2916,7 @@ function AgentWidget({
     }
   }, [open, messages]);
   const unreadCount = open || !baselined ? 0 : messages.slice(seenCountRef.current).filter(isUnreadable).length;
-  const workLabel = React12.useMemo(() => {
+  const workLabel = React13.useMemo(() => {
     if (!sending) return null;
     const last = messages[messages.length - 1];
     if (last?.role === "tool") return "Calling tools\u2026";
@@ -2332,14 +2925,14 @@ function AgentWidget({
   }, [sending, messages]);
   const approvalWaiting = pendingApprovals.length > 0;
   const { isAlwaysApproved } = alwaysApprove;
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (resolvingApprovalId) return;
     const target = pendingApprovals.find((approval) => isAlwaysApproved(approval.tool_name));
     if (target) void resolveApproval(target.id, true);
   }, [pendingApprovals, resolvingApprovalId, isAlwaysApproved, resolveApproval]);
-  const firedWriteIds = React12.useRef(/* @__PURE__ */ new Set());
+  const firedWriteIds = React13.useRef(/* @__PURE__ */ new Set());
   const { onWriteSuccess } = config;
-  React12.useEffect(() => {
+  React13.useEffect(() => {
     if (!onWriteSuccess) return;
     for (const message of messages) {
       if (message.role !== "tool" || !message.is_write || message.tool_status !== "success") continue;
@@ -2349,9 +2942,9 @@ function AgentWidget({
       onWriteSuccess({ arguments: args, toolName: message.tool_name ?? "" });
     }
   }, [messages, onWriteSuccess]);
-  const lastNavigatedMessageId = React12.useRef(null);
-  const navEpochRef = React12.useRef(-1);
-  React12.useEffect(() => {
+  const lastNavigatedMessageId = React13.useRef(null);
+  const navEpochRef = React13.useRef(-1);
+  React13.useEffect(() => {
     if (!open || fullscreen || !config.navigate || !config.pages?.length) return;
     const toolMessages = messages.filter((message) => message.role === "tool");
     const latest = toolMessages[toolMessages.length - 1];
@@ -2370,7 +2963,7 @@ function AgentWidget({
     const scrollTo = typeof mapping.scrollTo === "function" ? mapping.scrollTo(args) : mapping.scrollTo;
     config.navigate(path, { scrollTo: scrollTo ?? null });
   }, [chat.conversationEpoch, config, fullscreen, messages, open]);
-  const closePanel = React12.useCallback(() => {
+  const closePanel = React13.useCallback(() => {
     setOpen(false);
     setAgentMode(false);
   }, [setOpen]);
@@ -2543,6 +3136,6 @@ function defineAgentConfig(config) {
   return config;
 }
 
-export { AgentApiClient, AgentApiError, AgentComposer, AgentImageLightbox, AgentPanel, AgentVoiceRecorder, AgentWidget, ChatScroller, CopyButton, DEFAULT_ACCEPT, DocumentCard, IMAGE_ACCEPT, MessageItem, TaskChecklist, ThinkingIndicator, ToolActivityGroup, ToolApprovalCard, acceptAttribute, acceptedExtensions, attachmentsEnabled, defineAgentConfig, deriveDetails, fileUploadEnabled, formatBytes, groupMessages, humanizeToolName, isImageFile, resolveToolPresentation, textExtensions, useAgentChat, useAlwaysApprove, useSmoothText, validateFile };
+export { AgentApiClient, AgentApiError, AgentComposer, AgentImageLightbox, AgentPanel, AgentRealtimeClient, AgentVisibilityControl, AgentVoiceRecorder, AgentWidget, ChatScroller, CopyButton, DEFAULT_ACCEPT, DocumentCard, IMAGE_ACCEPT, MessageItem, TaskChecklist, ThinkingIndicator, ToolActivityGroup, ToolApprovalCard, acceptAttribute, acceptedExtensions, attachmentsEnabled, defineAgentConfig, deriveDetails, fileUploadEnabled, formatBytes, groupMessages, humanizeToolName, isImageFile, resolveToolPresentation, textExtensions, useAgentChat, useAlwaysApprove, useSmoothText, validateFile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map