@rimori/react-client 0.4.17-next.2 → 0.4.17-next.3

package/dist/components/ai/Avatar.d.ts

@@ -9,13 +9,10 @@ interface Props {
     children?: React.ReactNode;
     autoStartConversation?: FirstMessages;
     className?: string;
-    knowledgeId?: string;
     /** Server-side prompt name (e.g. 'studyplan.reflection'). When set, the backend resolves the system prompt. */
     prompt?: string;
     /** Variables for the server-side prompt template. */
     promptVariables?: Record<string, any>;
-    /** Set to true to disable automatic dialect TTS from userInfo. Default: false (dialect enabled). */
-    disableDialect?: boolean;
 }
-export declare function Avatar({ avatarImageUrl, voiceId, agentTools, autoStartConversation, children, circleSize, className, cache, knowledgeId, prompt, promptVariables, disableDialect, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function Avatar({ avatarImageUrl, voiceId, agentTools, autoStartConversation, children, circleSize, className, cache, prompt, promptVariables, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ai/Avatar.js

@@ -7,18 +7,19 @@ import { useChat } from '../../hooks/UseChatHook';
 import { useRimori } from '../../providers/PluginProvider';
 import { getFirstMessages } from './utils';
 import { useTheme } from '../../hooks/ThemeSetter';
-export function Avatar({ avatarImageUrl, voiceId, agentTools, autoStartConversation, children, circleSize = '300px', className, cache = false, knowledgeId, prompt, promptVariables, disableDialect = false, }) {
+export function Avatar({ avatarImageUrl, voiceId, agentTools, autoStartConversation, children, circleSize = '300px', className, cache = false, prompt, promptVariables, }) {
     const { ai, event, plugin, userInfo } = useRimori();
     const { isDark: isDarkThemeValue } = useTheme(plugin.theme);
     const [agentReplying, setAgentReplying] = useState(false);
     const [isProcessingMessage, setIsProcessingMessage] = useState(false);
-    const dialectTtsInstruction = !disableDialect && (userInfo === null || userInfo === void 0 ? void 0 : userInfo.dialect) ? `Speak with a ${userInfo.dialect} accent and pronunciation.` : undefined;
+    const dialectTtsInstruction = (userInfo === null || userInfo === void 0 ? void 0 : userInfo.dialect)
+        ? `Speak with a ${userInfo.dialect} accent and pronunciation.`
+        : undefined;
     const sender = useMemo(() => new MessageSender((...args) => ai.getVoice(...args), voiceId, cache), [voiceId, ai, cache]);
     useEffect(() => {
         sender.setInstructions(dialectTtsInstruction);
     }, [sender, dialectTtsInstruction]);
     const { messages, append, isLoading, lastMessage, setMessages } = useChat(agentTools, {
-        knowledgeId,
         prompt,
         promptVariables,
     });

package/dist/components/ai/BuddyAssistant.d.ts

@@ -7,10 +7,8 @@ export interface BuddyAssistantAutoStart {
     userMessage?: string;
 }
 export interface BuddyAssistantProps {
-    /** @deprecated Use `prompt` + `promptVariables` instead of building system prompts client-side. */
-    systemPrompt?: string;
-    /** Server-side prompt name (e.g. 'studyplan.goalSummary'). When set, the backend resolves the system prompt. */
-    prompt?: string;
+    /** Server-side prompt name (e.g. 'studyplan.goalSummary'). The backend resolves the system prompt. */
+    prompt: string;
     /** Variables for the server-side prompt template. */
     promptVariables?: Record<string, any>;
     autoStartConversation?: BuddyAssistantAutoStart;
@@ -20,9 +18,7 @@ export interface BuddyAssistantProps {
     className?: string;
     voiceSpeed?: number;
     tools?: Tool[];
-    /** Set to true to disable automatic dialect from userInfo. Default: false (dialect enabled). */
-    disableDialect?: boolean;
     /** Show the buddy name below the avatar. Default: false. */
     showName?: boolean;
 }
-export declare function BuddyAssistant({ systemPrompt, prompt, promptVariables, autoStartConversation, circleSize, chatPlaceholder, bottomAction, className, voiceSpeed, tools, disableDialect, showName, }: BuddyAssistantProps): JSX.Element;
+export declare function BuddyAssistant({ prompt, promptVariables, autoStartConversation, circleSize, chatPlaceholder, bottomAction, className, voiceSpeed, tools, showName, }: BuddyAssistantProps): JSX.Element;

package/dist/components/ai/BuddyAssistant.js

@@ -8,15 +8,12 @@ import { useTheme } from '../../hooks/ThemeSetter';
 import { BiSolidRightArrow } from 'react-icons/bi';
 let idCounter = 0;
 const genId = () => `ba-${++idCounter}`;
-export function BuddyAssistant({ systemPrompt, prompt, promptVariables, autoStartConversation, circleSize = '160px', chatPlaceholder, bottomAction, className, voiceSpeed = 1, tools, disableDialect = false, showName = false, }) {
+export function BuddyAssistant({ prompt, promptVariables, autoStartConversation, circleSize = '160px', chatPlaceholder, bottomAction, className, voiceSpeed = 1, tools, showName = false, }) {
     const { ai, event, plugin, userInfo } = useRimori();
     const ttsEnabled = plugin.ttsEnabled;
     const { isDark } = useTheme(plugin.theme);
     const buddy = userInfo.study_buddy;
-    const dialect = !disableDialect ? userInfo === null || userInfo === void 0 ? void 0 : userInfo.dialect : undefined;
-    const dialectSystemSuffix = dialect
-        ? `\n\nThe user is learning the regional ${dialect} dialect. Occasionally use typical regional vocabulary and expressions from this dialect to help them learn local language naturally.`
-        : '';
+    const dialect = userInfo === null || userInfo === void 0 ? void 0 : userInfo.dialect;
     const dialectTtsInstruction = dialect ? `Speak with a ${dialect} accent and pronunciation.` : undefined;
     const [chatInput, setChatInput] = useState('');
     const [messages, setMessages] = useState([]);
@@ -42,32 +39,33 @@ export function BuddyAssistant({ systemPrompt, prompt, promptVariables, autoStar
         sender.setOnEndOfSpeech(() => setIsSpeaking(false));
         return () => sender.cleanup();
     }, [sender]);
-    // Build full API message list — when using server-side prompt, skip the client-side system message
     const buildApiMessages = (history) => {
-        const msgs = history.map((m) => ({ role: m.role, content: m.content }));
-        if (!prompt && systemPrompt) {
-            return [{ role: 'system', content: systemPrompt + dialectSystemSuffix }, ...msgs];
-        }
-        return msgs;
+        return history.map((m) => ({ role: m.role, content: m.content }));
     };
     const triggerAI = (history) => {
         setIsLoading(true);
-        void ai.getSteamedText(buildApiMessages(history), (id, partial, finished) => {
-            setIsLoading(!finished);
-            const assistantId = `ai-${id}`;
-            setMessages((prev) => {
-                const last = prev[prev.length - 1];
-                if ((last === null || last === void 0 ? void 0 : last.id) === assistantId) {
-                    return [...prev.slice(0, -1), Object.assign(Object.assign({}, last), { content: partial })];
+        void ai.getStreamedText({
+            messages: buildApiMessages(history),
+            onMessage: (id, partial, finished) => {
+                setIsLoading(!finished);
+                const assistantId = `ai-${id}`;
+                setMessages((prev) => {
+                    const last = prev[prev.length - 1];
+                    if ((last === null || last === void 0 ? void 0 : last.id) === assistantId) {
+                        return [...prev.slice(0, -1), Object.assign(Object.assign({}, last), { content: partial })];
+                    }
+                    return [...prev, { id: assistantId, role: 'assistant', content: partial }];
+                });
+                if (ttsEnabledRef.current) {
+                    void sender.handleNewText(partial, !finished);
+                    if (partial)
+                        setIsSpeaking(true);
                 }
-                return [...prev, { id: assistantId, role: 'assistant', content: partial }];
-            });
-            if (ttsEnabledRef.current) {
-                void sender.handleNewText(partial, !finished);
-                if (partial)
-                    setIsSpeaking(true);
-            }
-        }, tools, false, undefined, undefined, prompt, promptVariables);
+            },
+            tools,
+            prompt,
+            variables: promptVariables,
+        });
     };
     // Auto-start conversation on mount
     const autoStartedRef = useRef(false);

package/dist/components/ai/utils.d.ts

@@ -1,8 +1,5 @@
-/** @deprecated Use server-side prompt definitions (prompt + variables) instead of building messages client-side. */
 export interface FirstMessages {
-    instructions?: string;
     userMessage?: string;
     assistantMessage?: string;
 }
-/** @deprecated Use server-side prompt definitions (prompt + variables) instead of building messages client-side. */
-export declare function getFirstMessages(instructions: FirstMessages): any[];
+export declare function getFirstMessages(config: FirstMessages): any[];

package/dist/components/ai/utils.js

@@ -1,14 +1,10 @@
-/** @deprecated Use server-side prompt definitions (prompt + variables) instead of building messages client-side. */
-export function getFirstMessages(instructions) {
+export function getFirstMessages(config) {
     const messages = [];
-    if (instructions.instructions) {
-        messages.push({ id: '1', role: 'system', content: instructions.instructions });
+    if (config.userMessage) {
+        messages.push({ id: '1', role: 'user', content: config.userMessage });
     }
-    if (instructions.userMessage) {
-        messages.push({ id: '2', role: 'user', content: instructions.userMessage });
-    }
-    if (instructions.assistantMessage) {
-        messages.push({ id: '3', role: 'assistant', content: instructions.assistantMessage });
+    if (config.assistantMessage) {
+        messages.push({ id: '2', role: 'assistant', content: config.assistantMessage });
     }
     return messages;
 }

package/dist/components/editor/MarkdownEditor.js

@@ -250,16 +250,11 @@ export const MarkdownEditor = ({ content, editable, className, onUpdate, labels,
             return;
         const selectedText = editor.state.doc.textBetween(from, to, '\n');
         setIsTransforming(true);
-        const transformed = yield ai.getText([
-            {
-                role: 'system',
-                content: 'You are a text editor assistant. Transform the provided text according to the user instruction. Return only the transformed text, no explanations. If formattation is wished, use markdown syntax in the output.',
-            },
-            {
-                role: 'user',
-                content: `Instruction: ${prompt}\n\nText:\n${selectedText}`,
-            },
-        ]);
+        const transformed = yield ai.getText({
+            messages: [],
+            prompt: 'global.editor.transform-text',
+            variables: { instruction: prompt, text: selectedText },
+        });
         setIsTransforming(false);
         if (!transformed)
             return;

package/dist/hooks/UseChatHook.d.ts

@@ -8,8 +8,6 @@ export interface UseChatConfig {
     promptVariables?: Record<string, any>;
 }
 export declare function useChat(tools?: Tool[], options?: {
-    /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
-    knowledgeId?: string;
     /** Server-side prompt name (e.g. 'storytelling.story'). When set, the backend resolves the system prompt. */
     prompt?: string;
     /** Variables for the server-side prompt template. */

package/dist/hooks/UseChatHook.js

@@ -21,19 +21,24 @@ export function useChat(tools, options) {
         const allMessages = [...messages, ...appendMessages];
         setMessages(allMessages);
         setIsLoading(true);
-        const knowledgeId = options === null || options === void 0 ? void 0 : options.knowledgeId;
         const promptVariables = (_a = configRef.current.promptVariables) !== null && _a !== void 0 ? _a : options === null || options === void 0 ? void 0 : options.promptVariables;
         const prompt = (_b = configRef.current.prompt) !== null && _b !== void 0 ? _b : options === null || options === void 0 ? void 0 : options.prompt;
-        void ai.getSteamedText(allMessages, (id, message, finished, toolInvocations) => {
-            setIsLoading(!finished);
-            setMessages((prev) => {
-                const last = prev[prev.length - 1];
-                if ((last === null || last === void 0 ? void 0 : last.id) === id) {
-                    return [...prev.slice(0, -1), Object.assign(Object.assign({}, last), { content: message, toolCalls: toolInvocations })];
-                }
-                return [...prev, { id, role: 'assistant', content: message, toolCalls: toolInvocations }];
-            });
-        }, tools, false, undefined, knowledgeId, prompt, promptVariables);
+        void ai.getStreamedText({
+            messages: allMessages,
+            onMessage: (id, message, finished, toolInvocations) => {
+                setIsLoading(!finished);
+                setMessages((prev) => {
+                    const last = prev[prev.length - 1];
+                    if ((last === null || last === void 0 ? void 0 : last.id) === id) {
+                        return [...prev.slice(0, -1), Object.assign(Object.assign({}, last), { content: message, toolCalls: toolInvocations })];
+                    }
+                    return [...prev, { id, role: 'assistant', content: message, toolCalls: toolInvocations }];
+                });
+            },
+            tools,
+            prompt,
+            variables: promptVariables,
+        });
     };
     return {
         messages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/react-client",
-  "version": "0.4.17-next.2",
+  "version": "0.4.17-next.3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
     "format": "prettier --write ."
   },
   "peerDependencies": {
-    "@rimori/client": "2.5.28-next.5",
+    "@rimori/client": "2.5.28-next.7",
     "react": "^18.1.0",
     "react-dom": "^18.1.0"
   },
@@ -49,7 +49,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.37.0",
-    "@rimori/client": "2.5.28-next.5",
+    "@rimori/client": "2.5.28-next.7",
     "@types/react": "^18.3.21",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",

package/src/components/ai/Avatar.tsx

@@ -18,13 +18,10 @@ interface Props {
   children?: React.ReactNode;
   autoStartConversation?: FirstMessages;
   className?: string;
-  knowledgeId?: string;
   /** Server-side prompt name (e.g. 'studyplan.reflection'). When set, the backend resolves the system prompt. */
   prompt?: string;
   /** Variables for the server-side prompt template. */
   promptVariables?: Record<string, any>;
-  /** Set to true to disable automatic dialect TTS from userInfo. Default: false (dialect enabled). */
-  disableDialect?: boolean;
 }
 
 export function Avatar({
@@ -36,17 +33,16 @@ export function Avatar({
   circleSize = '300px',
   className,
   cache = false,
-  knowledgeId,
   prompt,
   promptVariables,
-  disableDialect = false,
 }: Props) {
   const { ai, event, plugin, userInfo } = useRimori();
   const { isDark: isDarkThemeValue } = useTheme(plugin.theme);
   const [agentReplying, setAgentReplying] = useState(false);
   const [isProcessingMessage, setIsProcessingMessage] = useState(false);
-  const dialectTtsInstruction =
-    !disableDialect && userInfo?.dialect ? `Speak with a ${userInfo.dialect} accent and pronunciation.` : undefined;
+  const dialectTtsInstruction = userInfo?.dialect
+    ? `Speak with a ${userInfo.dialect} accent and pronunciation.`
+    : undefined;
   const sender = useMemo(
     () => new MessageSender((...args) => ai.getVoice(...args), voiceId, cache),
     [voiceId, ai, cache],
@@ -56,7 +52,6 @@ export function Avatar({
     sender.setInstructions(dialectTtsInstruction);
   }, [sender, dialectTtsInstruction]);
   const { messages, append, isLoading, lastMessage, setMessages } = useChat(agentTools, {
-    knowledgeId,
     prompt,
     promptVariables,
   });

package/src/components/ai/BuddyAssistant.tsx

@@ -16,10 +16,8 @@ export interface BuddyAssistantAutoStart {
 }
 
 export interface BuddyAssistantProps {
-  /** @deprecated Use `prompt` + `promptVariables` instead of building system prompts client-side. */
-  systemPrompt?: string;
-  /** Server-side prompt name (e.g. 'studyplan.goalSummary'). When set, the backend resolves the system prompt. */
-  prompt?: string;
+  /** Server-side prompt name (e.g. 'studyplan.goalSummary'). The backend resolves the system prompt. */
+  prompt: string;
   /** Variables for the server-side prompt template. */
   promptVariables?: Record<string, any>;
   autoStartConversation?: BuddyAssistantAutoStart;
@@ -29,8 +27,6 @@ export interface BuddyAssistantProps {
   className?: string;
   voiceSpeed?: number;
   tools?: Tool[];
-  /** Set to true to disable automatic dialect from userInfo. Default: false (dialect enabled). */
-  disableDialect?: boolean;
   /** Show the buddy name below the avatar. Default: false. */
   showName?: boolean;
 }
@@ -39,7 +35,6 @@ let idCounter = 0;
 const genId = () => `ba-${++idCounter}`;
 
 export function BuddyAssistant({
-  systemPrompt,
   prompt,
   promptVariables,
   autoStartConversation,
@@ -49,17 +44,13 @@ export function BuddyAssistant({
   className,
   voiceSpeed = 1,
   tools,
-  disableDialect = false,
   showName = false,
 }: BuddyAssistantProps): JSX.Element {
   const { ai, event, plugin, userInfo } = useRimori();
   const ttsEnabled = plugin.ttsEnabled;
   const { isDark } = useTheme(plugin.theme);
   const buddy = userInfo.study_buddy;
-  const dialect = !disableDialect ? userInfo?.dialect : undefined;
-  const dialectSystemSuffix = dialect
-    ? `\n\nThe user is learning the regional ${dialect} dialect. Occasionally use typical regional vocabulary and expressions from this dialect to help them learn local language naturally.`
-    : '';
+  const dialect = userInfo?.dialect;
   const dialectTtsInstruction = dialect ? `Speak with a ${dialect} accent and pronunciation.` : undefined;
   const [chatInput, setChatInput] = useState('');
   const [messages, setMessages] = useState<ChatMessage[]>([]);
@@ -93,20 +84,15 @@ export function BuddyAssistant({
     return () => sender.cleanup();
   }, [sender]);
 
-  // Build full API message list — when using server-side prompt, skip the client-side system message
   const buildApiMessages = (history: ChatMessage[]) => {
-    const msgs = history.map((m) => ({ role: m.role, content: m.content }));
-    if (!prompt && systemPrompt) {
-      return [{ role: 'system' as const, content: systemPrompt + dialectSystemSuffix }, ...msgs];
-    }
-    return msgs;
+    return history.map((m) => ({ role: m.role, content: m.content }));
   };
 
   const triggerAI = (history: ChatMessage[]) => {
     setIsLoading(true);
-    void ai.getSteamedText(
-      buildApiMessages(history),
-      (id: string, partial: string, finished: boolean) => {
+    void ai.getStreamedText({
+      messages: buildApiMessages(history),
+      onMessage: (id: string, partial: string, finished: boolean) => {
         setIsLoading(!finished);
         const assistantId = `ai-${id}`;
         setMessages((prev) => {
@@ -122,12 +108,9 @@ export function BuddyAssistant({
         }
       },
       tools,
-      false,
-      undefined,
-      undefined,
       prompt,
-      promptVariables,
-    );
+      variables: promptVariables,
+    });
   };
 
   // Auto-start conversation on mount

package/src/components/ai/utils.ts

@@ -1,22 +1,16 @@
-/** @deprecated Use server-side prompt definitions (prompt + variables) instead of building messages client-side. */
 export interface FirstMessages {
-  instructions?: string;
   userMessage?: string;
   assistantMessage?: string;
 }
 
-/** @deprecated Use server-side prompt definitions (prompt + variables) instead of building messages client-side. */
-export function getFirstMessages(instructions: FirstMessages): any[] {
+export function getFirstMessages(config: FirstMessages): any[] {
   const messages = [];
 
-  if (instructions.instructions) {
-    messages.push({ id: '1', role: 'system', content: instructions.instructions });
+  if (config.userMessage) {
+    messages.push({ id: '1', role: 'user', content: config.userMessage });
   }
-  if (instructions.userMessage) {
-    messages.push({ id: '2', role: 'user', content: instructions.userMessage });
-  }
-  if (instructions.assistantMessage) {
-    messages.push({ id: '3', role: 'assistant', content: instructions.assistantMessage });
+  if (config.assistantMessage) {
+    messages.push({ id: '2', role: 'assistant', content: config.assistantMessage });
   }
 
   return messages;

package/src/components/editor/MarkdownEditor.tsx

@@ -717,17 +717,11 @@ export const MarkdownEditor = ({
       if (from === to) return;
       const selectedText = editor.state.doc.textBetween(from, to, '\n');
       setIsTransforming(true);
-      const transformed = await ai.getText([
-        {
-          role: 'system',
-          content:
-            'You are a text editor assistant. Transform the provided text according to the user instruction. Return only the transformed text, no explanations. If formattation is wished, use markdown syntax in the output.',
-        },
-        {
-          role: 'user',
-          content: `Instruction: ${prompt}\n\nText:\n${selectedText}`,
-        },
-      ]);
+      const transformed = await ai.getText({
+        messages: [],
+        prompt: 'global.editor.transform-text',
+        variables: { instruction: prompt, text: selectedText },
+      });
       setIsTransforming(false);
       if (!transformed) return;
       editor.chain().focus().deleteRange({ from, to }).insertContentAt(from, transformed).run();

package/src/hooks/UseChatHook.ts

@@ -13,8 +13,6 @@ export interface UseChatConfig {
 export function useChat(
   tools?: Tool[],
   options?: {
-    /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
-    knowledgeId?: string;
     /** Server-side prompt name (e.g. 'storytelling.story'). When set, the backend resolves the system prompt. */
     prompt?: string;
     /** Variables for the server-side prompt template. */
@@ -42,13 +40,12 @@ export function useChat(
     const allMessages = [...messages, ...appendMessages];
     setMessages(allMessages);
     setIsLoading(true);
-    const knowledgeId = options?.knowledgeId;
     const promptVariables = configRef.current.promptVariables ?? options?.promptVariables;
     const prompt = configRef.current.prompt ?? options?.prompt;
 
-    void ai.getSteamedText(
-      allMessages,
-      (id, message, finished: boolean, toolInvocations?: ToolInvocation[]) => {
+    void ai.getStreamedText({
+      messages: allMessages,
+      onMessage: (id, message, finished: boolean, toolInvocations?: ToolInvocation[]) => {
         setIsLoading(!finished);
         setMessages((prev) => {
           const last = prev[prev.length - 1];
@@ -59,12 +56,9 @@ export function useChat(
         });
       },
       tools,
-      false,
-      undefined,
-      knowledgeId,
       prompt,
-      promptVariables,
-    );
+      variables: promptVariables,
+    });
   };
 
   return {