@useatlas/react 0.0.1 → 0.0.3

package/src/components/chat/managed-auth-card.tsx

@@ -61,7 +61,7 @@ export function ManagedAuthCard() {
               value={name}
               onChange={(e) => setName(e.target.value)}
               placeholder="Name (optional)"
-              className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus:border-blue-500 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
+              className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus-visible:border-blue-500 focus-visible:ring-[3px] focus-visible:ring-blue-500/30 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
             />
           )}
           <input
@@ -70,7 +70,7 @@ export function ManagedAuthCard() {
             onChange={(e) => setEmail(e.target.value)}
             placeholder="Email"
             required
-            className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus:border-blue-500 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
+            className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus-visible:border-blue-500 focus-visible:ring-[3px] focus-visible:ring-blue-500/30 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
           />
           <input
             type="password"
@@ -79,7 +79,7 @@ export function ManagedAuthCard() {
             placeholder="Password"
             required
             minLength={8}
-            className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus:border-blue-500 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
+            className="w-full rounded-lg border border-zinc-200 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 outline-none focus-visible:border-blue-500 focus-visible:ring-[3px] focus-visible:ring-blue-500/30 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-100 dark:placeholder-zinc-600"
           />
           {error && (
             <p className="text-xs text-red-600 dark:text-red-400">{error}</p>
@@ -87,7 +87,7 @@ export function ManagedAuthCard() {
           <button
             type="submit"
             disabled={loading}
-            className="w-full rounded-lg bg-blue-600 px-4 py-2 text-sm font-medium text-white transition-colors hover:bg-blue-500 disabled:opacity-40"
+            className="w-full rounded-lg bg-blue-600 px-4 py-2 text-sm font-medium text-white transition-colors hover:bg-blue-500 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-blue-500/50 disabled:opacity-40"
           >
             {loading ? "..." : view === "login" ? "Sign in" : "Create account"}
           </button>
@@ -97,14 +97,14 @@ export function ManagedAuthCard() {
           {view === "login" ? (
             <>
               No account?{" "}
-              <button onClick={() => { setView("signup"); setError(""); }} className="text-blue-600 hover:underline dark:text-blue-400">
+              <button onClick={() => { setView("signup"); setError(""); }} className="rounded text-blue-600 hover:underline focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-blue-500/50 dark:text-blue-400">
                 Create one
               </button>
             </>
           ) : (
             <>
               Already have an account?{" "}
-              <button onClick={() => { setView("login"); setError(""); }} className="text-blue-600 hover:underline dark:text-blue-400">
+              <button onClick={() => { setView("login"); setError(""); }} className="rounded text-blue-600 hover:underline focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-blue-500/50 dark:text-blue-400">
                 Sign in
               </button>
             </>

package/src/components/conversations/conversation-item.tsx

@@ -35,12 +35,13 @@ export function ConversationItem({
   conversation: Conversation;
   isActive: boolean;
   onSelect: () => void;
-  onDelete: () => Promise<boolean>;
-  onStar: (starred: boolean) => Promise<boolean>;
+  onDelete: () => Promise<void>;
+  onStar: (starred: boolean) => Promise<void>;
 }) {
   const [confirmDelete, setConfirmDelete] = useState(false);
   const [deleting, setDeleting] = useState(false);
   const [starPending, setStarPending] = useState(false);
+  const [error, setError] = useState<string | null>(null);
 
   if (confirmDelete) {
     return (
@@ -50,12 +51,11 @@ export function ConversationItem({
           onConfirm={async () => {
             setDeleting(true);
             try {
-              const success = await onDelete();
-              if (success) {
-                setConfirmDelete(false);
-              }
-            } catch (err) {
-              console.warn("Failed to delete conversation:", err);
+              await onDelete();
+              setConfirmDelete(false);
+            } catch {
+              setError("Failed to delete");
+              setTimeout(() => setError(null), 3000);
             } finally {
               setDeleting(false);
             }
@@ -76,7 +76,7 @@ export function ConversationItem({
           onSelect();
         }
       }}
-      className={`group flex w-full cursor-pointer items-center gap-2 rounded-lg px-3 py-2.5 text-left text-sm transition-colors ${
+      className={`group flex w-full cursor-pointer items-center gap-2 rounded-lg px-3 py-2.5 text-left text-sm transition-colors focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50 ${
         isActive
           ? "bg-blue-50 text-blue-700 dark:bg-blue-600/10 dark:text-blue-400"
           : "text-zinc-700 hover:bg-zinc-100 dark:text-zinc-300 dark:hover:bg-zinc-800"
@@ -86,9 +86,13 @@ export function ConversationItem({
         <p className="truncate text-sm font-medium">
           {conversation.title || "New conversation"}
         </p>
-        <p className="text-xs text-zinc-400 dark:text-zinc-500">
-          {relativeTime(conversation.updatedAt)}
-        </p>
+        {error ? (
+          <p className="text-xs text-red-500 dark:text-red-400">{error}</p>
+        ) : (
+          <p className="text-xs text-zinc-400 dark:text-zinc-500">
+            {relativeTime(conversation.updatedAt)}
+          </p>
+        )}
       </div>
       <div className="flex shrink-0 items-center gap-0.5">
         <Button
@@ -100,8 +104,9 @@ export function ConversationItem({
             setStarPending(true);
             try {
               await onStar(!conversation.starred);
-            } catch (err) {
-              console.warn("Failed to update star:", err);
+            } catch {
+              setError("Failed to update");
+              setTimeout(() => setError(null), 3000);
             } finally {
               setStarPending(false);
             }

package/src/components/conversations/conversation-list.tsx

@@ -15,14 +15,14 @@ export function ConversationList({
   conversations: Conversation[];
   selectedId: string | null;
   onSelect: (id: string) => void;
-  onDelete: (id: string) => Promise<boolean>;
-  onStar: (id: string, starred: boolean) => Promise<boolean>;
+  onDelete: (id: string) => Promise<void>;
+  onStar: (id: string, starred: boolean) => Promise<void>;
   showSections?: boolean;
   emptyMessage?: string;
 }) {
   if (conversations.length === 0) {
     return (
-      <div className="px-3 py-6 text-center text-xs text-zinc-400 dark:text-zinc-500">
+      <div className="px-3 py-6 text-center text-xs text-zinc-500 dark:text-zinc-400">
         {emptyMessage ?? "No conversations yet"}
       </div>
     );

package/src/components/conversations/conversation-sidebar.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useState } from "react";
+import { useState, useEffect } from "react";
 import { Star } from "lucide-react";
 import { ToggleGroup, ToggleGroupItem } from "../ui/toggle-group";
 import { Badge } from "../ui/badge";
@@ -24,13 +24,24 @@ export function ConversationSidebar({
   selectedId: string | null;
   loading: boolean;
   onSelect: (id: string) => void;
-  onDelete: (id: string) => Promise<boolean>;
-  onStar: (id: string, starred: boolean) => Promise<boolean>;
+  onDelete: (id: string) => Promise<void>;
+  onStar: (id: string, starred: boolean) => Promise<void>;
   onNewChat: () => void;
   mobileOpen: boolean;
   onMobileClose: () => void;
 }) {
   const [filter, setFilter] = useState<SidebarFilter>("all");
+
+  // Close mobile sidebar on Escape
+  useEffect(() => {
+    if (!mobileOpen) return;
+    function handleKeyDown(e: KeyboardEvent) {
+      if (e.key === "Escape") onMobileClose();
+    }
+    document.addEventListener("keydown", handleKeyDown);
+    return () => document.removeEventListener("keydown", handleKeyDown);
+  }, [mobileOpen, onMobileClose]);
+
   const starredConversations = conversations.filter((c) => c.starred);
   const filteredConversations = filter === "saved" ? starredConversations : conversations;
 
@@ -40,7 +51,7 @@ export function ConversationSidebar({
         <span className="text-sm font-medium text-zinc-700 dark:text-zinc-300">History</span>
         <button
           onClick={onNewChat}
-          className="rounded-lg border border-zinc-200 px-3 py-1.5 text-xs font-medium text-zinc-600 transition-colors hover:border-zinc-400 hover:text-zinc-900 dark:border-zinc-700 dark:text-zinc-400 dark:hover:border-zinc-500 dark:hover:text-zinc-200"
+          className="rounded-lg border border-zinc-200 px-3 py-1.5 text-xs font-medium text-zinc-600 transition-colors hover:border-zinc-400 hover:text-zinc-900 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50 dark:border-zinc-700 dark:text-zinc-400 dark:hover:border-zinc-500 dark:hover:text-zinc-200"
         >
           + New
         </button>

package/src/components/conversations/delete-confirmation.tsx

@@ -12,13 +12,13 @@ export function DeleteConfirmation({
       <span className="text-zinc-500 dark:text-zinc-400">Delete?</span>
       <button
         onClick={onCancel}
-        className="rounded px-2 py-0.5 text-zinc-500 transition-colors hover:text-zinc-800 dark:text-zinc-400 dark:hover:text-zinc-200"
+        className="rounded px-2 py-0.5 text-zinc-500 transition-colors hover:text-zinc-800 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50 dark:text-zinc-400 dark:hover:text-zinc-200"
       >
         Cancel
       </button>
       <button
         onClick={onConfirm}
-        className="rounded bg-red-600 px-2 py-0.5 text-white transition-colors hover:bg-red-500"
+        className="rounded bg-red-600 px-2 py-0.5 text-white transition-colors hover:bg-red-500 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-red-500/50 "
       >
         Delete
       </button>

package/src/components/error-boundary.tsx

@@ -0,0 +1,66 @@
+"use client";
+
+import { Component, type ReactNode, type ErrorInfo } from "react";
+import { Button } from "./ui/button";
+import { cn } from "../lib/utils";
+
+interface ErrorBoundaryProps {
+  children: ReactNode;
+  fallback?: ReactNode;
+  fallbackRender?: (error: Error, reset: () => void) => ReactNode;
+  onError?: (error: Error, errorInfo: ErrorInfo) => void;
+}
+
+interface ErrorBoundaryState {
+  error: Error | null;
+}
+
+export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+  constructor(props: ErrorBoundaryProps) {
+    super(props);
+    this.state = { error: null };
+  }
+
+  static getDerivedStateFromError(error: Error): ErrorBoundaryState {
+    return { error };
+  }
+
+  componentDidCatch(error: Error, info: ErrorInfo) {
+    console.error("[ErrorBoundary]", error, info.componentStack);
+    this.props.onError?.(error, info);
+  }
+
+  resetErrorBoundary = () => {
+    this.setState({ error: null });
+  };
+
+  render() {
+    const { error } = this.state;
+    if (!error) return this.props.children;
+
+    if (this.props.fallbackRender) {
+      return this.props.fallbackRender(error, this.resetErrorBoundary);
+    }
+
+    if (this.props.fallback) {
+      return this.props.fallback;
+    }
+
+    return (
+      <div
+        role="alert"
+        className={cn(
+          "flex flex-col items-center gap-3 rounded-lg border border-red-200 bg-red-50 p-4 text-center",
+          "dark:border-red-900/50 dark:bg-red-950/20",
+        )}
+      >
+        <p className="text-sm text-red-700 dark:text-red-400">
+          Something went wrong.
+        </p>
+        <Button variant="outline" size="sm" onClick={this.resetErrorBoundary}>
+          Try again
+        </Button>
+      </div>
+    );
+  }
+}

package/src/components/schema-explorer/schema-explorer.tsx

@@ -5,6 +5,7 @@ import { useAtlasConfig } from "../../context";
 import {
   Sheet,
   SheetContent,
+  SheetDescription,
   SheetHeader,
   SheetTitle,
 } from "../ui/sheet";
@@ -467,6 +468,9 @@ export function SchemaExplorer({
             <TableProperties className="size-4" />
             Schema Explorer
           </SheetTitle>
+          <SheetDescription className="sr-only">
+            Browse tables, columns, joins, and query patterns from the semantic layer
+          </SheetDescription>
         </SheetHeader>
 
         <Separator className="mt-3" />

package/src/env.d.ts

@@ -1,9 +1,11 @@
 /** Optional runtime dependency — dynamically imported for Excel export. */
-declare module "xlsx" {
-  const utils: {
-    json_to_sheet: (data: unknown[], opts?: { header?: string[] }) => unknown;
-    book_new: () => unknown;
-    book_append_sheet: (wb: unknown, ws: unknown, name: string) => void;
-  };
-  function write(wb: unknown, opts: { bookType: string; type: string }): ArrayBuffer;
+declare module "exceljs" {
+  export class Workbook {
+    addWorksheet(name: string): Worksheet;
+    xlsx: { writeBuffer(): Promise<ArrayBuffer> };
+  }
+  interface Worksheet {
+    columns: Array<{ header: string; key: string }>;
+    addRow(data: Record<string, unknown>): void;
+  }
 }

package/src/global.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Ambient type declarations for the Atlas widget script-tag API.
+ *
+ * These augment `window.Atlas` and the `Atlas` global so that embedders
+ * get full IDE autocomplete and type-checking.
+ *
+ * **Usage:** Add a triple-slash reference at the top of your script:
+ *
+ * ```ts
+ * /// <reference types="@useatlas/react/widget" />
+ *
+ * window.Atlas?.open();
+ * Atlas?.ask("How many users signed up today?");
+ * ```
+ */
+
+import type { AtlasWidget, AtlasWidgetCommand } from "./lib/widget-types";
+
+declare global {
+  interface Window {
+    /**
+     * Atlas widget API — available after the widget `<script>` tag loads.
+     *
+     * Before the script loads, this may be an array of queued commands
+     * (`AtlasWidgetCommand[]`) that are replayed once the widget initializes.
+     */
+    Atlas?: AtlasWidget | AtlasWidgetCommand[];
+  }
+
+  /**
+   * Atlas widget API — shorthand for `window.Atlas`.
+   *
+   * May be `undefined` if the widget script has not loaded yet.
+   */
+  var Atlas: AtlasWidget | AtlasWidgetCommand[] | undefined;
+}

package/src/hooks/__tests__/use-atlas-conversations.test.tsx

@@ -123,11 +123,9 @@ describe("useAtlasConversations", () => {
       Promise.resolve(new Response("", { status: 200 })),
     );
 
-    let deleted = false;
     await act(async () => {
-      deleted = await result.current.deleteConversation("conv-1");
+      await result.current.deleteConversation("conv-1");
     });
-    expect(deleted).toBe(true);
     expect(result.current.conversations).toHaveLength(0);
     expect(result.current.total).toBe(0);
   });
@@ -148,11 +146,11 @@ describe("useAtlasConversations", () => {
       Promise.resolve(new Response("", { status: 500 })),
     );
 
-    let starred = true;
     await act(async () => {
-      starred = await result.current.starConversation("conv-1", true);
+      await expect(
+        result.current.starConversation("conv-1", true),
+      ).rejects.toThrow("Failed to update star (HTTP 500)");
     });
-    expect(starred).toBe(false);
     // Should roll back to unstarred
     expect(result.current.conversations[0].starred).toBe(false);
   });

package/src/hooks/use-atlas-chat.ts

@@ -52,7 +52,7 @@ export function useAtlasChat(options: UseAtlasChatOptions = {}): UseAtlasChatRet
     if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
 
     return new DefaultChatTransport({
-      api: `${apiUrl}/api/chat`,
+      api: `${apiUrl}/api/v1/chat`,
       headers,
       credentials: isCrossOrigin ? "include" : undefined,
       body: () =>

package/src/hooks/use-atlas-conversations.ts

@@ -19,8 +19,8 @@ export interface UseAtlasConversationsReturn {
   setSelectedId: (id: string | null) => void;
   refresh: () => Promise<void>;
   loadConversation: (id: string) => Promise<UIMessage[] | null>;
-  deleteConversation: (id: string) => Promise<boolean>;
-  starConversation: (id: string, starred: boolean) => Promise<boolean>;
+  deleteConversation: (id: string) => Promise<void>;
+  starConversation: (id: string, starred: boolean) => Promise<void>;
 }
 
 /**

package/src/hooks/use-conversations.ts

@@ -9,6 +9,8 @@ export interface UseConversationsOptions {
   enabled: boolean;
   getHeaders: () => Record<string, string>;
   getCredentials: () => RequestCredentials;
+  /** Custom conversations API endpoint path. Defaults to "/api/v1/conversations". */
+  conversationsEndpoint?: string;
 }
 
 export interface UseConversationsReturn {
@@ -16,12 +18,13 @@ export interface UseConversationsReturn {
   total: number;
   loading: boolean;
   available: boolean;
+  fetchError: string | null;
   selectedId: string | null;
   setSelectedId: (id: string | null) => void;
   fetchList: () => Promise<void>;
-  loadConversation: (id: string) => Promise<UIMessage[] | null>;
-  deleteConversation: (id: string) => Promise<boolean>;
-  starConversation: (id: string, starred: boolean) => Promise<boolean>;
+  loadConversation: (id: string) => Promise<UIMessage[]>;
+  deleteConversation: (id: string) => Promise<void>;
+  starConversation: (id: string, starred: boolean) => Promise<void>;
   refresh: () => Promise<void>;
 }
 
@@ -29,14 +32,16 @@ export function transformMessages(messages: Message[]): UIMessage[] {
   return messages
     .filter((m) => m.role === "user" || m.role === "assistant")
     .map((m) => {
-      const content = typeof m.content === "string"
+      const parts: UIMessage["parts"] = Array.isArray(m.content)
         ? m.content
-        : JSON.stringify(m.content);
+            .filter((p: { type?: string }) => p.type === "text")
+            .map((p: { text?: string }) => ({ type: "text" as const, text: p.text ?? "" }))
+        : [{ type: "text" as const, text: String(m.content) }];
 
       return {
         id: m.id,
         role: m.role as "user" | "assistant",
-        parts: [{ type: "text" as const, text: content }],
+        parts,
       };
     });
 }
@@ -46,15 +51,17 @@ export function useConversations(opts: UseConversationsOptions): UseConversation
   const [total, setTotal] = useState(0);
   const [loading, setLoading] = useState(false);
   const [available, setAvailable] = useState(true);
+  const [fetchError, setFetchError] = useState<string | null>(null);
   const [selectedId, setSelectedId] = useState<string | null>(null);
   const fetchedRef = useRef(false);
-  const networkFailRef = useRef(0);
+  const baseEndpoint = opts.conversationsEndpoint ?? "/api/v1/conversations";
 
   const fetchList = useCallback(async () => {
     if (!opts.enabled || !available) return;
     setLoading(true);
+    setFetchError(null);
     try {
-      const res = await fetch(`${opts.apiUrl}/api/v1/conversations?limit=50`, {
+      const res = await fetch(`${opts.apiUrl}${baseEndpoint}?limit=50`, {
         headers: opts.getHeaders(),
         credentials: opts.getCredentials(),
       });
@@ -65,12 +72,14 @@ export function useConversations(opts: UseConversationsOptions): UseConversation
       }
 
       if (!res.ok) {
+        // intentionally ignored: response may not be JSON
         const errorBody = await res.json().catch(() => null);
         if (errorBody?.code === "not_available") {
           setAvailable(false);
           return;
         }
         console.warn(`fetchList: HTTP ${res.status}`, errorBody);
+        setFetchError("Failed to load conversations. Please reload the page to try again.");
         return;
       }
 
@@ -78,71 +87,55 @@ export function useConversations(opts: UseConversationsOptions): UseConversation
       setConversations(data.conversations ?? []);
       setTotal(data.total ?? 0);
       fetchedRef.current = true;
-    } catch (err) {
-      console.warn("fetchList error:", err);
-      // Network error before any successful fetch — disable temporarily.
-      // A subsequent explicit fetchList() call can retry.
-      if (!fetchedRef.current) {
-        networkFailRef.current += 1;
-        if (networkFailRef.current >= 3) setAvailable(false);
-      }
+    } catch (err: unknown) {
+      console.warn("fetchList error:", err instanceof Error ? err.message : String(err));
+      setFetchError("Failed to load conversations. Please reload the page to try again.");
     } finally {
       setLoading(false);
     }
-  }, [opts.apiUrl, opts.enabled, opts.getHeaders, opts.getCredentials, available]);
-
-  const loadConversation = useCallback(async (id: string): Promise<UIMessage[] | null> => {
-    try {
-      const res = await fetch(`${opts.apiUrl}/api/v1/conversations/${id}`, {
-        headers: opts.getHeaders(),
-        credentials: opts.getCredentials(),
-      });
+  }, [opts.apiUrl, opts.enabled, opts.getHeaders, opts.getCredentials, available, baseEndpoint]);
 
-      if (!res.ok) {
-        console.warn(`loadConversation: HTTP ${res.status} for ${id}`);
-        return null;
-      }
+  const loadConversation = useCallback(async (id: string): Promise<UIMessage[]> => {
+    const res = await fetch(`${opts.apiUrl}${baseEndpoint}/${id}`, {
+      headers: opts.getHeaders(),
+      credentials: opts.getCredentials(),
+    });
 
-      const data: ConversationWithMessages = await res.json();
-      return transformMessages(data.messages);
-    } catch (err) {
-      console.warn("loadConversation error:", err);
-      return null;
+    if (!res.ok) {
+      console.warn(`loadConversation: HTTP ${res.status} for ${id}`);
+      throw new Error(`Failed to load conversation (HTTP ${res.status})`);
     }
-  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials]);
 
-  const deleteConversation = useCallback(async (id: string): Promise<boolean> => {
-    try {
-      const res = await fetch(`${opts.apiUrl}/api/v1/conversations/${id}`, {
-        method: "DELETE",
-        headers: opts.getHeaders(),
-        credentials: opts.getCredentials(),
-      });
+    const data: ConversationWithMessages = await res.json();
+    return transformMessages(data.messages);
+  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials, baseEndpoint]);
 
-      if (!res.ok) {
-        console.warn(`deleteConversation: HTTP ${res.status} for ${id}`);
-        return false;
-      }
+  const deleteConversation = useCallback(async (id: string): Promise<void> => {
+    const res = await fetch(`${opts.apiUrl}${baseEndpoint}/${id}`, {
+      method: "DELETE",
+      headers: opts.getHeaders(),
+      credentials: opts.getCredentials(),
+    });
 
-      setConversations((prev) => prev.filter((c) => c.id !== id));
-      setTotal((prev) => Math.max(0, prev - 1));
+    if (!res.ok) {
+      console.warn(`deleteConversation: HTTP ${res.status} for ${id}`);
+      throw new Error(`Failed to delete conversation (HTTP ${res.status})`);
+    }
 
-      if (selectedId === id) setSelectedId(null);
+    setConversations((prev) => prev.filter((c) => c.id !== id));
+    setTotal((prev) => Math.max(0, prev - 1));
 
-      return true;
-    } catch (err) {
-      console.warn("deleteConversation error:", err);
-      return false;
-    }
-  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials, selectedId]);
+    if (selectedId === id) setSelectedId(null);
+  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials, selectedId, baseEndpoint]);
 
-  const starConversation = useCallback(async (id: string, starred: boolean): Promise<boolean> => {
+  const starConversation = useCallback(async (id: string, starred: boolean): Promise<void> => {
     // Optimistic update
     setConversations((prev) =>
       prev.map((c) => (c.id === id ? { ...c, starred } : c)),
     );
+    let rolledBack = false;
     try {
-      const res = await fetch(`${opts.apiUrl}/api/v1/conversations/${id}/star`, {
+      const res = await fetch(`${opts.apiUrl}${baseEndpoint}/${id}/star`, {
         method: "PATCH",
         headers: { ...opts.getHeaders(), "Content-Type": "application/json" },
         credentials: opts.getCredentials(),
@@ -151,23 +144,21 @@ export function useConversations(opts: UseConversationsOptions): UseConversation
 
       if (!res.ok) {
         console.warn(`starConversation: HTTP ${res.status} for ${id}`);
-        // Rollback
         setConversations((prev) =>
           prev.map((c) => (c.id === id ? { ...c, starred: !starred } : c)),
         );
-        return false;
+        rolledBack = true;
+        throw new Error(`Failed to update star (HTTP ${res.status})`);
       }
-
-      return true;
-    } catch (err) {
-      console.warn("starConversation error:", err);
-      // Rollback
-      setConversations((prev) =>
-        prev.map((c) => (c.id === id ? { ...c, starred: !starred } : c)),
-      );
-      return false;
+    } catch (err: unknown) {
+      if (!rolledBack) {
+        setConversations((prev) =>
+          prev.map((c) => (c.id === id ? { ...c, starred: !starred } : c)),
+        );
+      }
+      throw err;
     }
-  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials]);
+  }, [opts.apiUrl, opts.getHeaders, opts.getCredentials, baseEndpoint]);
 
   const refresh = useCallback(async () => {
     await fetchList();
@@ -178,6 +169,7 @@ export function useConversations(opts: UseConversationsOptions): UseConversation
     total,
     loading,
     available,
+    fetchError,
     selectedId,
     setSelectedId,
     fetchList,

package/src/index.ts

@@ -34,3 +34,11 @@ export type {
 // Hooks
 export { useConversations } from "./hooks/use-conversations";
 export type { UseConversationsOptions, UseConversationsReturn } from "./hooks/use-conversations";
+
+// Widget types (for script-tag embedders)
+export type {
+  AtlasWidget,
+  AtlasWidgetEventMap,
+  AtlasWidgetConfig,
+  AtlasWidgetCommand,
+} from "./lib/widget-types";

package/src/lib/action-types.ts

@@ -4,8 +4,8 @@ export {
   isActionToolResult,
 } from "@useatlas/types/action";
 export type {
-  ActionStatus,
-  ResolvedStatus,
+  ActionDisplayStatus,
+  ResolvedDisplayStatus,
   ActionToolResultShape,
   ActionApprovalResponse,
 } from "@useatlas/types/action";