research-agent-ui 0.1.0

package/dist/lib/cdn-loader.d.ts

@@ -0,0 +1,2 @@
+export declare function loadJsPDF(): Promise<any>;
+export declare function loadDocx(): Promise<any>;

package/dist/lib/export.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Convert HTML content to Markdown
+ */
+export declare function exportAsMarkdown(title: string, htmlContent: string): Promise<void>;
+/**
+ * Export content as DOCX using docx library (loaded from CDN)
+ */
+export declare function exportAsDocx(title: string, htmlContent: string): Promise<void>;
+/**
+ * Export content as PDF
+ */
+export declare function exportAsPdf(title: string, htmlContent: string): Promise<void>;
+/**
+ * Export to Google Docs
+ * Opens a new Google Docs document with the content copied to clipboard
+ */
+export declare function exportToGoogleDocs(title: string, htmlContent: string): Promise<void>;

package/dist/lib/guest.d.ts

@@ -0,0 +1,19 @@
+import { Message } from "../components/ChatConversation/ChatWindow";
+import type { ChatFile as File } from "../types/chat";
+export interface GuestChat {
+    id: string;
+    title: string;
+    createdAt: string;
+    focusMode: string;
+    files?: File[];
+    messages: Message[];
+}
+export declare function getGuestChats(): GuestChat[];
+export declare function getGuestChat(chatId: string): GuestChat | null;
+export declare function saveGuestChat(chat: GuestChat): void;
+export declare function deleteGuestChat(chatId: string): void;
+export declare function clearAllGuestChats(): void;
+export declare function addMessageToGuestChat(chatId: string, message: Message): void;
+export declare function createGuestChat(chatId: string, title: string, focusMode: string, files?: File[]): GuestChat;
+export declare function updateGuestChatTitle(chatId: string, title: string): void;
+export declare function updateGuestChatFiles(chatId: string, files: File[]): void;

package/dist/lib/suggestions.d.ts

@@ -0,0 +1,2 @@
+import { Message } from "../components/ChatConversation/ChatWindow";
+export declare const getSuggestions: (chatHistory: Message[]) => Promise<string[]>;

package/dist/lib/url-autolink.d.ts

@@ -0,0 +1,21 @@
+/**
+ * URL Auto-linking Utility
+ *
+ * Detects plain URLs (with or without protocol) and converts them to markdown links.
+ * Handles patterns like:
+ * - github.com/kubet/mk-blog
+ * - https://github.com/kubet/mk-blog
+ * - www.example.com
+ * - example.com/path
+ */
+/**
+ * Auto-links plain URLs in text by converting them to markdown links
+ *
+ * @param text - The text to process
+ * @returns Text with plain URLs converted to markdown links
+ *
+ * @example
+ * autoLinkUrls("Check out github.com/kubet/mk-blog")
+ * // Returns: "Check out [github.com/kubet/mk-blog](https://github.com/kubet/mk-blog)"
+ */
+export declare function autoLinkUrls(text: string): string;

package/dist/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export declare const formatTimeDifference: (date1: Date | string, date2: Date | string) => string;

package/dist/rolldown-runtime-CMqjfN_6.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/dist/types/chat.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Type definitions for the chat system.
+ * Contains interfaces and types used across all chat-related modules.
+ * @module components/ResearchAgent/state/chat/types
+ */
+import { AssistantMessage, ChatTurn, Message, SearchingMessage, SourceMessage, UserMessage } from "../components/ChatConversation/ChatWindow";
+/**
+ * Represents a section of the chat UI, grouping related messages together.
+ * Each section contains a user message and its corresponding AI response,
+ * sources, and follow-up suggestions.
+ */
+export type Section = {
+    /** The user's input message */
+    userMessage: UserMessage;
+    /** The AI assistant's response, if available */
+    assistantMessage: AssistantMessage | undefined;
+    /** The processed message content with citations and formatting applied */
+    parsedAssistantMessage: string | undefined;
+    /** The message content optimized for text-to-speech */
+    speechMessage: string | undefined;
+    /** Sources/references used to generate the response */
+    sourceMessage: SourceMessage | undefined;
+    /** Live search progress (queries + statuses) while the agent is running */
+    searchingMessage: SearchingMessage | undefined;
+    /** Whether the AI has finished its reasoning/thinking phase */
+    thinkingEnded: boolean;
+    /** Follow-up question suggestions for the user */
+    suggestions?: string[];
+};
+/**
+ * Represents an uploaded file attached to a chat.
+ */
+export interface ChatFile {
+    /** The original name of the file */
+    fileName: string;
+    /** The file extension (e.g., 'pdf', 'txt') */
+    fileExtension: string;
+    /** Unique identifier for the uploaded file */
+    fileId: string;
+}
+/**
+ * Configuration for the chat model provider.
+ * Determines which AI model and provider to use for generating responses.
+ */
+export interface ChatModelProvider {
+    /** The specific model key (e.g., 'llama-3.1-70b') */
+    key: string;
+    /** The provider identifier (e.g., 'groq', 'openai') */
+    providerId: string;
+}
+/**
+ * The complete context type for the chat system.
+ * Contains all state values and action functions available to chat consumers.
+ */
+export type ChatContextType = {
+    /** All messages in the current chat */
+    messages: Message[];
+    /** Filtered list containing only user and assistant messages */
+    chatTurns: ChatTurn[];
+    /** Parsed sections for UI rendering */
+    sections: Section[];
+    /** History of conversation turns as [role, content] pairs */
+    chatHistory: [string, string][];
+    /** Files attached to the chat */
+    files: ChatFile[];
+    /** IDs of attached files */
+    fileIds: string[];
+    /** Current search/focus mode (e.g., 'webSearch', 'academic') */
+    focusMode: string;
+    /** Current category for the search */
+    category: string;
+    /** Unique identifier for the current chat session */
+    chatId: string | undefined;
+    /** Optimization mode (e.g., 'speed', 'quality') */
+    optimizationMode: string;
+    /** Whether messages have been loaded from storage/API */
+    isMessagesLoaded: boolean;
+    /** Whether a message is currently being sent/streamed */
+    loading: boolean;
+    /** Whether the requested chat was not found */
+    notFound: boolean;
+    /** Whether the AI response has started appearing */
+    messageAppeared: boolean;
+    /** Whether the chat system is fully initialized and ready */
+    isReady: boolean;
+    /** Whether an error occurred during initialization */
+    hasError: boolean;
+    /** Current chat model provider configuration */
+    chatModelProvider: ChatModelProvider;
+    /**
+     * Sets the optimization mode for responses.
+     * @param mode - The optimization mode to use
+     */
+    setOptimizationMode: (mode: string) => void;
+    /**
+     * Sets the search/focus mode.
+     * @param mode - The focus mode to use
+     */
+    setFocusMode: (mode: string) => void;
+    /**
+     * Sets the search category.
+     * @param category - The category to use
+     */
+    setCategory: (category: string) => void;
+    /**
+     * Sets the attached files.
+     * @param files - Array of chat files
+     */
+    setFiles: (files: ChatFile[]) => void;
+    /**
+     * Sets the file IDs for attached files.
+     * @param fileIds - Array of file IDs
+     */
+    setFileIds: (fileIds: string[]) => void;
+    /**
+     * Sends a message to the chat.
+     * @param message - The message content to send
+     * @param messageId - Optional custom message ID
+     * @param rewrite - Whether this is a rewrite of a previous message
+     */
+    sendMessage: (message: string, messageId?: string, rewrite?: boolean) => Promise<void>;
+    /**
+     * Rewrites a previous AI response.
+     * @param messageId - The ID of the message to rewrite
+     */
+    rewrite: (messageId: string) => void;
+    /**
+     * Updates the chat model provider configuration.
+     * @param provider - The new provider configuration
+     */
+    setChatModelProvider: (provider: ChatModelProvider) => void;
+};

package/dist/types/research.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Type definitions used by the ResearchAgent area of the ResearchAgent feature.
+ */
+import { ChatFile, ChatModelProvider } from "./chat";
+export type { ChatModelProvider };
+export interface Article {
+    html?: string;
+    cite?: string;
+    title?: string;
+    url?: string;
+    author?: string;
+    author_cite?: string;
+    author_short?: string;
+    author_type?: string;
+    date?: string;
+    source?: string;
+    word_count?: number;
+    followUpQuestions?: string[];
+    qaHistory?: Array<{
+        question: string;
+        answer: string;
+    }>;
+}
+export type SearchCategory = "general" | "news" | "videos" | "images" | "science" | "tech" | "files";
+export interface CategoryTab {
+    code: SearchCategory;
+    name: string;
+    icon: string;
+}
+export interface SearchParams {
+    q: string;
+    cat: SearchCategory;
+    page: number;
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet?: string;
+    score: number;
+    date?: string;
+    source?: string;
+    domain?: string;
+    favicon?: string;
+    thumbnail?: string;
+    content?: string;
+    img_src?: string;
+    iframe_src?: string;
+}
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+    time: string;
+}
+export interface ArticleExtractPanelProps {
+    isOpen?: boolean;
+    onClose?: () => void;
+    url?: string;
+    searchText?: string;
+}
+export interface AttachedFile {
+    id: string;
+    file: File;
+    type: string;
+    preview: string | null;
+    uploadStatus: string;
+    content?: string;
+}
+export interface PastedContent {
+    id: string;
+    content: string;
+    timestamp: Date;
+}
+export interface Chat {
+    id: string;
+    title: string;
+    createdAt: string;
+    focusMode: string;
+    userId?: string | null;
+    files?: ChatFile[];
+    messageCount?: number;
+}

package/dist/ui/Loader.d.ts

@@ -0,0 +1,2 @@
+declare const Loader: () => import("react").JSX.Element;
+export default Loader;

package/dist/ui/badge.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const badgeVariants: (props?: {
+    variant?: "default" | "destructive" | "secondary" | "outline" | "new" | "beta" | "highlight";
+} & import("class-variance-authority/types").ClassProp) => string;
+declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Badge, badgeVariants };

package/dist/ui/button.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const buttonVariants: (props?: {
+    variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost";
+    size?: "default" | "icon" | "sm" | "lg";
+} & import("class-variance-authority/types").ClassProp) => string;
+export interface ButtonProps extends React.ComponentProps<"button">, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare function Button({ className, variant, size, asChild, ...props }: ButtonProps): React.JSX.Element;
+export { Button, buttonVariants };

package/dist/ui/dialog.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+declare function Dialog({ ...props }: React.ComponentProps<typeof DialogPrimitive.Root>): React.JSX.Element;
+declare function DialogTrigger({ ...props }: React.ComponentProps<typeof DialogPrimitive.Trigger>): React.JSX.Element;
+declare function DialogPortal({ ...props }: React.ComponentProps<typeof DialogPrimitive.Portal>): React.JSX.Element;
+declare function DialogClose({ ...props }: React.ComponentProps<typeof DialogPrimitive.Close>): React.JSX.Element;
+declare function DialogOverlay({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Overlay>): React.JSX.Element;
+declare function DialogContent({ className, children, hideCloseButton, ...props }: React.ComponentProps<typeof DialogPrimitive.Content> & {
+    hideCloseButton?: boolean;
+}): React.JSX.Element;
+declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DialogFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DialogTitle({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Title>): React.JSX.Element;
+declare function DialogDescription({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Description>): React.JSX.Element;
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

package/dist/ui/dropdown-menu.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): React.JSX.Element;
+declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): React.JSX.Element;
+declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): React.JSX.Element;
+declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): React.JSX.Element;
+declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): React.JSX.Element;
+declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.JSX.Element;
+declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): React.JSX.Element;
+declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): React.JSX.Element;
+declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): React.JSX.Element;
+declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): React.JSX.Element;
+declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): React.JSX.Element;
+declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): React.JSX.Element;
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };

package/dist/ui/glowing-effect.d.ts

@@ -0,0 +1,14 @@
+interface GlowingEffectProps {
+    blur?: number;
+    inactiveZone?: number;
+    proximity?: number;
+    spread?: number;
+    variant?: "default" | "white";
+    glow?: boolean;
+    className?: string;
+    disabled?: boolean;
+    movementDuration?: number;
+    borderWidth?: number;
+}
+declare const GlowingEffect: import("react").MemoExoticComponent<({ blur, inactiveZone, proximity, spread, variant, glow, className, movementDuration, borderWidth, disabled, }: GlowingEffectProps) => import("react").JSX.Element>;
+export { GlowingEffect };

package/dist/ui/gradient-blur.d.ts

@@ -0,0 +1,9 @@
+interface GradientBlurProps {
+    radius?: number;
+    opacityDecay?: number;
+    backgroundColor?: string;
+    color?: [number, number, number];
+    colorGenerator?: () => [number, number, number];
+}
+export declare function GradientBlur({ radius, opacityDecay, backgroundColor, color, colorGenerator, }: GradientBlurProps): import("react").JSX.Element;
+export {};

package/dist/ui/live-waveform.d.ts

@@ -0,0 +1,23 @@
+import { type HTMLAttributes } from "react";
+export interface LiveWaveformProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onError'> {
+    active?: boolean;
+    processing?: boolean;
+    barWidth?: number;
+    barHeight?: number;
+    barGap?: number;
+    barRadius?: number;
+    barColor?: string;
+    fadeEdges?: boolean;
+    fadeWidth?: number;
+    height?: string | number;
+    sensitivity?: number;
+    smoothingTimeConstant?: number;
+    fftSize?: number;
+    historySize?: number;
+    updateRate?: number;
+    mode?: "scrolling" | "static";
+    onError?: (error: Error) => void;
+    onStreamReady?: (stream: MediaStream) => void;
+    onStreamEnd?: () => void;
+}
+export declare const LiveWaveform: import("react").ForwardRefExoticComponent<LiveWaveformProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/ui/popover.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+declare function Popover({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Root>): React.JSX.Element;
+declare function PopoverTrigger({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Trigger>): React.JSX.Element;
+declare function PopoverContent({ className, align, sideOffset, container, ...props }: React.ComponentProps<typeof PopoverPrimitive.Content> & {
+    container?: HTMLElement;
+}): React.JSX.Element;
+declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Anchor>): React.JSX.Element;
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };

package/dist/ui/tooltip.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof TooltipPrimitive.Provider>): React.JSX.Element;
+declare function Tooltip({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Root>): React.JSX.Element;
+declare function TooltipTrigger({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Trigger>): React.JSX.Element;
+declare function TooltipContent({ className, sideOffset, children, ...props }: React.ComponentProps<typeof TooltipPrimitive.Content>): React.JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/ui/visually-hidden.d.ts

@@ -0,0 +1,2 @@
+import * as React from "react";
+export declare const VisuallyHidden: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "research-agent-ui",
+  "description": "Chat research agent UI: conversation window, article reader, search config, file uploads, and chat history",
+  "version": "0.1.0",
+  "author": "vtempest",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenSourceAGI/qwksearch-research-agent.git",
+    "directory": "packages/research-agent-ui"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.mjs",
+      "require": "./dist/api.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "vite build && (tsc --project tsconfig.build.json || true)",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "chat",
+    "research-agent",
+    "search",
+    "article-reader",
+    "shadcn",
+    "react"
+  ],
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.8.1",
+    "@radix-ui/react-dialog": "^1.1.16",
+    "@radix-ui/react-dropdown-menu": "^2.1.17",
+    "@radix-ui/react-popover": "^1.1.16",
+    "@radix-ui/react-slot": "^1.2.5",
+    "@radix-ui/react-tooltip": "^1.2.9",
+    "@ricky0123/vad-web": "^0.0.30",
+    "chat-agent-toolkit": "^1.2.18",
+    "domain-rank": "^0.1.7",
+    "drizzle-orm": "^0.45.2",
+    "fuse.js": "^7.1.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dompurify": "^3.4.9",
+    "extract-webpage": "^1.2.20",
+    "framer-motion": "^12.40.0",
+    "grab-url": "^1.6.22",
+    "html2canvas": "^1.4.1",
+    "lucide-react": "^1.17.0",
+    "markdown-to-jsx": "^9.8.2",
+    "motion": "^12.40.0",
+    "quantum-sphere-loading-icon": "^1.0.3",
+    "react-icons": "^5.6.0",
+    "react-textarea-autosize": "^8.5.9",
+    "sonner": "^2.0.7",
+    "streamdown": "^2.5.0",
+    "tailwind-merge": "^3.6.0",
+    "turndown": "^7.2.4"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/turndown": "^5.0.5",
+    "@vitejs/plugin-react": "^6.0.3",
+    "next": "^16.2.10",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.7.2",
+    "vite": "^8.1.3"
+  }
+}