@jazzmine-ui/react 0.1.5 → 0.1.7

package/README.md

@@ -18,11 +18,12 @@ 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
+npm install @jazzmine-ui/react react react-dom react-markdown remark-gfm
 ```
 
 ## Styles
@@ -42,6 +43,7 @@ Components:
 - MessageList
 - FloatingChatWidget
 - JazzmineChat
+- SearchModal
 
 Types:
 
@@ -50,6 +52,7 @@ Types:
 - MessageListProps
 - FloatingChatWidgetProps
 - JazzmineChatProps
+- SearchModalProps
 - IJazzmineClient
 - Message
 - Chat
@@ -63,6 +66,7 @@ import {
 	MessageList,
 	FloatingChatWidget,
 	JazzmineChat,
+	SearchModal,
 } from '@jazzmine-ui/react';
 
 import type {
@@ -71,6 +75,7 @@ import type {
 	MessageListProps,
 	FloatingChatWidgetProps,
 	JazzmineChatProps,
+	SearchModalProps,
 	IJazzmineClient,
 	Message,
 	Chat,
@@ -84,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.
@@ -119,6 +127,7 @@ export function App() {
 JazzmineChatProps:
 
 - client: IJazzmineClient (required)
+- userId: string (default: 'user')
 - assistantName: string
 - placeholder: string
 - className: string
@@ -211,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
@@ -297,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
@@ -336,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:
@@ -377,6 +437,7 @@ interface IJazzmineClient {
 			conversationId?: string;
 			autoCreateConversation?: boolean;
 			conversationTitle?: string;
+			explicitContext?: string[];
 		}
 	): Promise<{
 		response: {
@@ -400,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;
@@ -412,7 +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 is externalized and must be present in the consuming app.
+- react-markdown and remark-gfm are externalized and must be present in the consuming app.
 
 ## Development