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

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/ThemeSetter.d.ts

@@ -1,5 +1,6 @@
 import { Theme } from '@rimori/client';
-export declare function useTheme(theme?: Theme): {
+export declare function useTheme(theme?: Theme, isDisabled?: boolean): {
     isDark: boolean;
     theme: Theme;
+    isDisabled: boolean;
 };

package/dist/hooks/ThemeSetter.js

@@ -1,12 +1,15 @@
-export function useTheme(theme = 'system') {
+export function useTheme(theme = 'system', isDisabled = false) {
     const isDark = theme === 'system' ? systenUsesDarkMode() : theme === 'dark';
+    if (isDisabled) {
+        return { isDark, theme, isDisabled };
+    }
     const dom = document.documentElement;
     dom.dataset.theme = isDark ? 'dark' : 'light';
     dom.style.colorScheme = isDark ? 'dark' : 'light';
     dom.classList[isDark ? 'add' : 'remove']('dark');
     const root = document.querySelector('#root');
     root.classList.add('dark:bg-gradient-to-br', 'dark:from-gray-900', 'dark:to-gray-800', 'dark:text-white', 'min-h-screen', 'bg-fixed');
-    return { isDark, theme };
+    return { isDark, theme, isDisabled };
 }
 function systenUsesDarkMode() {
     return window.matchMedia('(prefers-color-scheme: dark)').matches;

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/dist/providers/PluginProvider.d.ts

@@ -6,6 +6,12 @@ interface PluginProviderProps {
     pluginId: string;
     settings?: {
         disableContextMenu?: boolean;
+        disableThemeSetting?: boolean;
+        /**
+         * Skip the scrollbar detection that emits 'session.triggerScrollbarChange'.
+         * In federation mode, the host (FederatedPluginRenderer) handles this instead.
+         */
+        disableScrollbarDetection?: boolean;
     };
 }
 export declare const PluginProvider: React.FC<PluginProviderProps>;

package/dist/providers/PluginProvider.js

@@ -20,7 +20,7 @@ export const PluginProvider = ({ children, pluginId, settings }) => {
     const [applicationMode, setApplicationMode] = useState(null);
     const [theme, setTheme] = useState(undefined);
     const [userInfo, setUserInfo] = useState(null);
-    useTheme(theme);
+    useTheme(theme, settings === null || settings === void 0 ? void 0 : settings.disableThemeSetting);
     // Init PostHog once per plugin iframe
     useEffect(() => {
         if (!posthog.__loaded) {
@@ -94,6 +94,8 @@ export const PluginProvider = ({ children, pluginId, settings }) => {
     useEffect(() => {
         if (!client)
             return;
+        if (settings === null || settings === void 0 ? void 0 : settings.disableScrollbarDetection)
+            return;
         const checkScrollbar = () => {
             const hasScrollbar = document.documentElement.scrollHeight > window.innerHeight;
             client.event.emit('session.triggerScrollbarChange', { hasScrollbar });
@@ -109,7 +111,7 @@ export const PluginProvider = ({ children, pluginId, settings }) => {
             window.removeEventListener('resize', checkScrollbar);
             resizeObserver.disconnect();
         };
-    }, [client]);
+    }, [client, settings === null || settings === void 0 ? void 0 : settings.disableScrollbarDetection]);
     if (standaloneClient instanceof StandaloneClient) {
         return (_jsx(StandaloneAuth, { onLogin: (email, password) => __awaiter(void 0, void 0, void 0, function* () {
                 if (yield standaloneClient.login(email, password))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/react-client",
-  "version": "0.4.17-next.2",
+  "version": "0.4.17-next.4",
   "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/ThemeSetter.ts

@@ -1,8 +1,15 @@
 import { Theme } from '@rimori/client';
 
-export function useTheme(theme: Theme = 'system'): { isDark: boolean; theme: Theme } {
+export function useTheme(
+  theme: Theme = 'system',
+  isDisabled = false,
+): { isDark: boolean; theme: Theme; isDisabled: boolean } {
   const isDark = theme === 'system' ? systenUsesDarkMode() : theme === 'dark';
 
+  if (isDisabled) {
+    return { isDark, theme, isDisabled };
+  }
+
   const dom = document.documentElement;
   dom.dataset.theme = isDark ? 'dark' : 'light';
   dom.style.colorScheme = isDark ? 'dark' : 'light';
@@ -19,7 +26,7 @@ export function useTheme(theme: Theme = 'system'): { isDark: boolean; theme: The
     'bg-fixed',
   );
 
-  return { isDark, theme };
+  return { isDark, theme, isDisabled };
 }
 
 function systenUsesDarkMode(): boolean {

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 {

package/src/providers/PluginProvider.tsx

@@ -11,6 +11,12 @@ interface PluginProviderProps {
   pluginId: string;
   settings?: {
     disableContextMenu?: boolean;
+    disableThemeSetting?: boolean;
+    /**
+     * Skip the scrollbar detection that emits 'session.triggerScrollbarChange'.
+     * In federation mode, the host (FederatedPluginRenderer) handles this instead.
+     */
+    disableScrollbarDetection?: boolean;
   };
 }
 
@@ -28,7 +34,7 @@ export const PluginProvider: React.FC<PluginProviderProps> = ({ children, plugin
   const [theme, setTheme] = useState<Theme | undefined>(undefined);
   const [userInfo, setUserInfo] = useState<UserInfo | null>(null);
 
-  useTheme(theme);
+  useTheme(theme, settings?.disableThemeSetting);
 
   // Init PostHog once per plugin iframe
   useEffect(() => {
@@ -112,6 +118,7 @@ export const PluginProvider: React.FC<PluginProviderProps> = ({ children, plugin
 
   useEffect(() => {
     if (!client) return;
+    if (settings?.disableScrollbarDetection) return;
 
     const checkScrollbar = (): void => {
       const hasScrollbar = document.documentElement.scrollHeight > window.innerHeight;
@@ -133,7 +140,7 @@ export const PluginProvider: React.FC<PluginProviderProps> = ({ children, plugin
       window.removeEventListener('resize', checkScrollbar);
       resizeObserver.disconnect();
     };
-  }, [client]);
+  }, [client, settings?.disableScrollbarDetection]);
 
   if (standaloneClient instanceof StandaloneClient) {
     return (