@cntyclub/agent-react 0.17.0 → 0.18.0

package/dist/index.js

@@ -1,4 +1,4 @@
-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 { 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, 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, CopyIcon, Maximize2Icon, ListChecksIcon, ChevronDownIcon, ShieldAlertIcon, CheckCheckIcon, UploadCloudIcon, HistoryIcon, SquarePenIcon, Minimize2Icon, ChevronsRightIcon, SparklesIcon, DownloadIcon, CodeIcon } from 'lucide-react';
 import * as React12 from 'react';
 import { AnimatePresence, motion } from 'motion/react';
@@ -6,6 +6,22 @@ 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
@@ -1558,6 +1783,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,
@@ -1675,6 +1906,33 @@ function AgentPanel({
             ] })
           ] }),
           /* @__PURE__ */ jsxs(ChatHeaderActions, { children: [
+            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,
@@ -1896,6 +2154,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) => ({
@@ -1914,6 +2209,8 @@ function buildOptimisticUserMessage(text, files) {
 }
 function useAgentChat(config) {
   const client = React12.useMemo(() => new AgentApiClient(config), [config]);
+  const configRef = React12.useRef(config);
+  configRef.current = config;
   const [agentInfo, setAgentInfo] = React12.useState(null);
   const [conversationId, setConversationId] = React12.useState(null);
   const [conversationEpoch, setConversationEpoch] = React12.useState(0);
@@ -1923,6 +2220,12 @@ function useAgentChat(config) {
   const [sending, setSending] = React12.useState(false);
   const [resolvingApprovalId, setResolvingApprovalId] = React12.useState(null);
   const [error, setError] = React12.useState(null);
+  const [currentConversation, setCurrentConversation] = React12.useState(null);
+  const [contextMeter, setContextMeter] = React12.useState(null);
+  const [participants, setParticipants] = React12.useState([]);
+  const [myState, setMyState] = React12.useState(null);
+  const [typingUsers, setTypingUsers] = React12.useState({});
+  const [realtimeStatus, setRealtimeStatus] = React12.useState("idle");
   React12.useEffect(() => {
     let cancelled = false;
     client.getConfig().then((info) => {
@@ -2045,6 +2348,62 @@ function useAgentChat(config) {
     },
     []
   );
+  const applyRealtime = React12.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;
+  React12.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(
     async (text, files) => {
@@ -2053,21 +2412,29 @@ function useAgentChat(config) {
       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);
@@ -2118,6 +2485,11 @@ function useAgentChat(config) {
     setMessages([]);
     setPendingApprovals([]);
     setError(null);
+    setCurrentConversation(null);
+    setContextMeter(null);
+    setParticipants([]);
+    setMyState(null);
+    setTypingUsers({});
     setConversationEpoch((e) => e + 1);
   }, []);
   const refreshConversations = React12.useCallback(async () => {
@@ -2138,6 +2510,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);
@@ -2161,21 +2550,27 @@ function useAgentChat(config) {
   return {
     agentInfo,
     clearError,
+    contextMeter,
     conversationId,
     conversationEpoch,
     conversations,
+    currentConversation,
     deleteConversation,
     error,
     messages,
+    myState,
     newChat,
     openConversation,
+    participants,
     pendingApprovals,
+    realtimeStatus,
     refreshConversations,
     resolveApproval,
     resolvingApprovalId,
     send,
     sending,
-    transcribe
+    transcribe,
+    typingUsers
   };
 }
 var STORAGE_PREFIX = "cc-agent-always-approve:";
@@ -2543,6 +2938,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, 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