@jazzmine-ui/react 0.1.4 → 0.1.7

package/README.md

@@ -17,6 +17,14 @@ Peer dependencies:
 
 - react
 - react-dom
+- react-markdown
+- remark-gfm
+
+If your project does not already include peer dependencies, install everything together:
+
+```bash
+npm install @jazzmine-ui/react react react-dom react-markdown remark-gfm
+```
 
 ## Styles
 
@@ -35,6 +43,7 @@ Components:
 - MessageList
 - FloatingChatWidget
 - JazzmineChat
+- SearchModal
 
 Types:
 
@@ -43,6 +52,7 @@ Types:
 - MessageListProps
 - FloatingChatWidgetProps
 - JazzmineChatProps
+- SearchModalProps
 - IJazzmineClient
 - Message
 - Chat
@@ -56,6 +66,7 @@ import {
 	MessageList,
 	FloatingChatWidget,
 	JazzmineChat,
+	SearchModal,
 } from '@jazzmine-ui/react';
 
 import type {
@@ -64,6 +75,7 @@ import type {
 	MessageListProps,
 	FloatingChatWidgetProps,
 	JazzmineChatProps,
+	SearchModalProps,
 	IJazzmineClient,
 	Message,
 	Chat,
@@ -77,8 +89,11 @@ It manages:
 
 - conversation creation
 - message sending
+- explicit context forwarding
 - loading state
 - conversation deletion
+- conversation search modal (live search)
+- message history loading on conversation selection
 - basic error fallback behavior
 
 You provide a client that matches IJazzmineClient.
@@ -112,6 +127,7 @@ export function App() {
 JazzmineChatProps:
 
 - client: IJazzmineClient (required)
+- userId: string (default: 'user')
 - assistantName: string
 - placeholder: string
 - className: string
@@ -204,7 +220,12 @@ ChatInterfaceProps:
 - onSend: (text: string, contexts?: Context[]) => void
 - onNewChat: () => void
 - onSelectChat: (chatId: string) => void
+- onRenameChat: (chatId: string, newTitle?: string) => void
 - onDeleteChat: (chatId: string) => void
+- onSearchClick: () => void
+- onLoadMore: () => void
+- hasMore: boolean
+- isLoadingChats: boolean
 - loadingText: string
 - loadingVariant: text-and-dots | dots-only
 - isLoading: boolean
@@ -290,9 +311,16 @@ SidebarProps:
 - chatActions: ChatAction[]
 - onNewChat: () => void
 - onSelectChat: (chatId: string) => void
-- onRenameChat: (chatId: string) => void
+- onRenameChat: (chatId: string, newTitle?: string) => void
 - onDeleteChat: (chatId: string) => void
 - onArchiveChat: (chatId: string) => void
+- onSearchClick: () => void
+- onLoadMore: () => void
+- hasMore: boolean
+- isLoadingChats: boolean
+- isSearchOpen: boolean
+- searchQuery: string
+- onSearchQueryChange: (query: string) => void
 - className: string
 - collapsed: boolean
 - onToggleCollapse: (value?: boolean) => void
@@ -329,6 +357,45 @@ MessageListProps:
 - onAddContext: (context: Context) => void
 - scrollRef: ref object or callback ref
 
+## 6) SearchModal
+
+SearchModal is exported for standalone usage when you want a full-overlay
+conversation picker.
+
+```tsx
+import React from 'react';
+import { SearchModal } from '@jazzmine-ui/react';
+import type { Chat } from '@jazzmine-ui/react';
+
+export function SearchModalDemo() {
+	const [isOpen, setIsOpen] = React.useState(true);
+	const [query, setQuery] = React.useState('');
+	const [results, setResults] = React.useState<Chat[]>([]);
+
+	return (
+		<SearchModal
+			isOpen={isOpen}
+			onClose={() => setIsOpen(false)}
+			onSelectConversation={(conversationId) => console.log(conversationId)}
+			searchQuery={query}
+			onSearchQueryChange={setQuery}
+			results={results}
+			isSearching={false}
+		/>
+	);
+}
+```
+
+SearchModalProps:
+
+- isOpen: boolean
+- onClose: () => void
+- onSelectConversation: (conversationId: string) => void
+- searchQuery: string
+- onSearchQueryChange: (query: string) => void
+- results: Chat[]
+- isSearching: boolean
+
 ## Exported Core Types
 
 Message:
@@ -370,6 +437,7 @@ interface IJazzmineClient {
 			conversationId?: string;
 			autoCreateConversation?: boolean;
 			conversationTitle?: string;
+			explicitContext?: string[];
 		}
 	): Promise<{
 		response: {
@@ -393,6 +461,66 @@ interface IJazzmineClient {
 		deleted: boolean;
 	}>;
 
+	listConversations(params: {
+		userId: string;
+		limit?: number;
+		offset?: number;
+	}): Promise<{
+		conversations: Array<{
+			conversation_id: string;
+			title: string;
+			last_updated_at: number;
+		}>;
+		total: number;
+		hasMore: boolean;
+		offset: number;
+		limit: number;
+	}>;
+
+	searchConversations(params: {
+		userId: string;
+		query: string;
+		limit?: number;
+		offset?: number;
+	}): Promise<{
+		conversations: Array<{
+			conversation_id: string;
+			title: string;
+			last_updated_at: number;
+		}>;
+		total: number;
+		hasMore: boolean;
+		offset: number;
+		limit: number;
+		query?: string;
+	}>;
+
+	updateConversation(
+		conversationId: string,
+		payload: { title: string }
+	): Promise<{
+		conversation_id: string;
+		title: string;
+		last_updated_at: number;
+	}>;
+
+	getConversationMessages(params: {
+		conversationId: string;
+		limit?: number;
+		offset?: number;
+	}): Promise<{
+		conversation_id: string;
+		messages: Array<{
+			id: string;
+			role: 'user' | 'assistant' | 'colleague_assistant' | 'system';
+			original_content: string;
+			enhanced_message: string;
+			timestamp: number;
+		}>;
+		total: number;
+		hasMore: boolean;
+	}>;
+
 	getHealth(): Promise<{
 		status: string;
 		agent_name: string;
@@ -405,6 +533,7 @@ interface IJazzmineClient {
 - This package does not import from @jazzmine-ui/sdk directly.
 - Any SDK client that structurally matches IJazzmineClient works.
 - JazzmineChat is a client-side component and includes a use client directive.
+- react-markdown and remark-gfm are externalized and must be present in the consuming app.
 
 ## Development
 

package/dist/components/ChatInterface/types.d.ts

@@ -8,7 +8,15 @@ export interface ChatInterfaceProps {
     onSend: (text: string, contexts?: Context[]) => void;
     onNewChat: () => void;
     onSelectChat: (chatId: string) => void;
+    onRenameChat?: (chatId: string, newTitle?: string) => void;
     onDeleteChat?: (chatId: string) => void;
+    onSearchClick?: () => void;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    isLoadingChats?: boolean;
+    isSearchOpen?: boolean;
+    searchQuery?: string;
+    onSearchQueryChange?: (query: string) => void;
     loadingText?: string;
     loadingVariant?: "text-and-dots" | "dots-only";
     isLoading?: boolean;

package/dist/components/JazzmineChat/types.d.ts

@@ -2,6 +2,8 @@ import type { IJazzmineClient } from '../../types/client';
 export interface JazzmineChatProps {
     /** A JazzmineClient instance from @jazzmine-ui/sdk */
     client: IJazzmineClient;
+    /** User identifier used for listing and searching conversations. Default: 'user' */
+    userId?: string;
     /** Displayed as the assistant's name in the UI. Default: agent name from /health */
     assistantName?: string;
     /** Placeholder text for the message input */

package/dist/components/SearchModal/SearchModal.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { SearchModalProps } from './types';
+export declare const SearchModal: React.FC<SearchModalProps>;

package/dist/components/SearchModal/index.d.ts

@@ -0,0 +1,2 @@
+export { SearchModal } from './SearchModal';
+export type { SearchModalProps } from './types';

package/dist/components/SearchModal/types.d.ts

@@ -0,0 +1,10 @@
+import type { Chat } from '../../types';
+export interface SearchModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSelectConversation: (conversationId: string) => void;
+    searchQuery: string;
+    onSearchQueryChange: (query: string) => void;
+    results: Chat[];
+    isSearching: boolean;
+}

package/dist/components/Sidebar/types.d.ts

@@ -14,9 +14,23 @@ export interface SidebarProps {
     chatActions?: ChatAction[];
     onNewChat: () => void;
     onSelectChat: (chatId: string) => void;
-    onRenameChat?: (chatId: string) => void;
+    onRenameChat?: (chatId: string, newTitle?: string) => void;
     onDeleteChat?: (chatId: string) => void;
     onArchiveChat?: (chatId: string) => void;
+    /** Called when the search button is clicked */
+    onSearchClick?: () => void;
+    /** Called when user scrolls to the bottom of the chat list (infinite scroll) */
+    onLoadMore?: () => void;
+    /** Whether more conversations are available to load */
+    hasMore?: boolean;
+    /** Whether conversations are currently being loaded */
+    isLoadingChats?: boolean;
+    /** Whether conversation search input is visible */
+    isSearchOpen?: boolean;
+    /** Current conversation search query */
+    searchQuery?: string;
+    /** Called when search query changes */
+    onSearchQueryChange?: (query: string) => void;
     className?: string;
     collapsed?: boolean;
     onToggleCollapse?: (value?: boolean) => void;

package/dist/index.d.ts

@@ -3,10 +3,12 @@ export { Sidebar } from './components/Sidebar';
 export { MessageList } from './components/MessageList';
 export { FloatingChatWidget } from './components/FloatingChatWidget';
 export { JazzmineChat } from './components/JazzmineChat';
+export { SearchModal } from './components/SearchModal';
 export type { ChatInterfaceProps } from './components/ChatInterface';
 export type { SidebarProps } from './components/Sidebar';
 export type { MessageListProps } from './components/MessageList';
 export type { FloatingChatWidgetProps } from './components/FloatingChatWidget';
 export type { JazzmineChatProps } from './components/JazzmineChat';
+export type { SearchModalProps } from './components/SearchModal';
 export type { IJazzmineClient } from './types/client';
 export type { Message, Chat } from './types';