@rimori/client 2.5.31 → 2.5.32-next.0

package/dist/controller/TranslationController.d.ts

@@ -11,6 +11,7 @@ export declare class Translator {
     private translationUrl;
     private ai;
     private aiTranslationCache;
+    private aiTranslationPending;
     constructor(initialLanguage: string, translationUrl: string, ai: AIModule);
     /**
      * Initialize translator with user's language

package/dist/controller/TranslationController.js

@@ -14,6 +14,7 @@ import { createInstance } from 'i18next';
 export class Translator {
     constructor(initialLanguage, translationUrl, ai) {
         this.aiTranslationCache = new Map();
+        this.aiTranslationPending = new Map();
         this.currentLanguage = initialLanguage;
         this.initializationState = 'not-inited';
         this.initializationPromise = null;
@@ -158,29 +159,38 @@ export class Translator {
             const cached = this.aiTranslationCache.get(text);
             if (cached)
                 return cached;
-            try {
-                // If the current language is English, don't translate
-                if (!this.ai || this.currentLanguage === 'en')
-                    return text;
-                const response = yield this.ai.getObject({
-                    prompt: 'global.translator.translate',
-                    variables: {
-                        additionalInstructions: additionalInstructions !== null && additionalInstructions !== void 0 ? additionalInstructions : '',
-                        language: this.currentLanguage,
-                        text,
-                    },
-                    cache: true,
-                });
-                const translation = response === null || response === void 0 ? void 0 : response.translation;
-                if (translation) {
-                    this.aiTranslationCache.set(text, translation);
-                    return translation;
+            const pending = this.aiTranslationPending.get(text);
+            if (pending)
+                return pending;
+            if (!this.ai || this.currentLanguage === 'en')
+                return text;
+            const promise = (() => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const response = yield this.ai.getObject({
+                        prompt: 'global.translator.translate',
+                        variables: {
+                            additionalInstructions: additionalInstructions !== null && additionalInstructions !== void 0 ? additionalInstructions : '',
+                            language: this.currentLanguage,
+                            text,
+                        },
+                        cache: true,
+                    });
+                    const translation = response === null || response === void 0 ? void 0 : response.translation;
+                    if (translation) {
+                        this.aiTranslationCache.set(text, translation);
+                        return translation;
+                    }
                 }
-            }
-            catch (error) {
-                console.warn('Failed to translate freeform text:', { text, error });
-            }
-            return text;
+                catch (error) {
+                    console.warn('Failed to translate freeform text:', { text, error });
+                }
+                finally {
+                    this.aiTranslationPending.delete(text);
+                }
+                return text;
+            }))();
+            this.aiTranslationPending.set(text, promise);
+            return promise;
         });
     }
 }

package/dist/plugin/CommunicationHandler.d.ts

@@ -46,11 +46,11 @@ export interface RimoriInfo {
     ttsEnabled: boolean;
 }
 export declare class RimoriCommunicationHandler {
+    readonly pluginId: string;
     private port;
     private queryParams;
     private supabase;
     private rimoriInfo;
-    private pluginId;
     private isMessageChannelReady;
     private pendingRequests;
     private updateCallbacks;
@@ -76,4 +76,14 @@ export declare class RimoriCommunicationHandler {
      * @returns Cleanup function to unregister the callback
      */
     onUpdate(callback: (info: RimoriInfo) => void): () => void;
+    /**
+     * Makes an authenticated fetch request to the Rimori backend.
+     * Automatically adds Authorization and plugin-id headers.
+     * Content-Type defaults to application/json when the body is a JSON string.
+     * Content-Type is omitted for FormData bodies so the browser sets the multipart boundary.
+     * Callers can override Content-Type by passing it in options.headers.
+     * @param url Path relative to the backend URL (e.g. '/ai/llm')
+     * @param options Standard RequestInit options (headers are merged, not replaced)
+     */
+    fetchBackend(url: string, options?: RequestInit): Promise<Response>;
 }

package/dist/plugin/CommunicationHandler.js

@@ -11,6 +11,7 @@ import { PostgrestClient } from '@supabase/postgrest-js';
 import { EventBus } from '../fromRimori/EventBus';
 export class RimoriCommunicationHandler {
     constructor(pluginId, standalone) {
+        this.pluginId = pluginId;
         this.port = null;
         this.queryParams = {};
         this.supabase = null;
@@ -18,7 +19,6 @@ export class RimoriCommunicationHandler {
         this.isMessageChannelReady = false;
         this.pendingRequests = [];
         this.updateCallbacks = new Set();
-        this.pluginId = pluginId;
         this.getClient = this.getClient.bind(this);
         //no need to forward messages to parent in standalone mode or worker context
         if (standalone)
@@ -135,6 +135,7 @@ export class RimoriCommunicationHandler {
             headers: {
                 apikey: key,
                 Authorization: `Bearer ${token}`,
+                'plugin-id': this.pluginId,
             },
         });
     }
@@ -238,4 +239,25 @@ export class RimoriCommunicationHandler {
             this.updateCallbacks.delete(callback);
         };
     }
+    /**
+     * Makes an authenticated fetch request to the Rimori backend.
+     * Automatically adds Authorization and plugin-id headers.
+     * Content-Type defaults to application/json when the body is a JSON string.
+     * Content-Type is omitted for FormData bodies so the browser sets the multipart boundary.
+     * Callers can override Content-Type by passing it in options.headers.
+     * @param url Path relative to the backend URL (e.g. '/ai/llm')
+     * @param options Standard RequestInit options (headers are merged, not replaced)
+     */
+    fetchBackend(url, options = {}) {
+        if (!this.rimoriInfo) {
+            throw new Error(`[CommunicationHandler:${this.pluginId}] fetchBackend called before rimoriInfo was initialized`);
+        }
+        const { token, backendUrl } = this.rimoriInfo;
+        const defaultContentType = {};
+        if (typeof options.body === 'string') {
+            defaultContentType['Content-Type'] = 'application/json';
+        }
+        const headers = Object.assign(Object.assign(Object.assign({}, defaultContentType), options.headers), { Authorization: `Bearer ${token}`, 'plugin-id': this.pluginId });
+        return fetch(backendUrl + url, Object.assign(Object.assign({}, options), { headers }));
+    }
 }

package/dist/plugin/RimoriClient.d.ts

@@ -9,6 +9,7 @@ import { StorageModule } from './module/StorageModule';
 import { EventBusHandler } from '../fromRimori/EventBus';
 export declare class RimoriClient {
     private static instance;
+    private controller;
     sharedContent: SharedContentController;
     db: DbModule;
     event: EventModule;
@@ -17,7 +18,6 @@ export declare class RimoriClient {
     exercise: ExerciseModule;
     /** Upload and manage images stored in Supabase via the backend. */
     storage: StorageModule;
-    private rimoriInfo;
     /** The EventBus instance used by this client. In federation mode this is a per-plugin instance. */
     eventBus: EventBusHandler;
     private constructor();
@@ -32,6 +32,6 @@ export declare class RimoriClient {
         toDashboard: () => void;
     };
     runtime: {
-        fetchBackend: (url: string, options: RequestInit) => Promise<Response>;
+        fetchBackend: (url: string, options?: RequestInit) => Promise<Response>;
     };
 }

package/dist/plugin/RimoriClient.js

@@ -26,25 +26,20 @@ export class RimoriClient {
             },
         };
         this.runtime = {
-            fetchBackend: (url, options) => __awaiter(this, void 0, void 0, function* () {
-                return fetch(this.rimoriInfo.backendUrl + url, Object.assign(Object.assign({}, options), { headers: Object.assign(Object.assign({}, options.headers), { Authorization: `Bearer ${this.rimoriInfo.token}` }) }));
-            }),
+            fetchBackend: (url, options = {}) => this.controller.fetchBackend(url, options),
         };
-        this.rimoriInfo = info;
+        this.controller = controller;
         this.eventBus = eventBus !== null && eventBus !== void 0 ? eventBus : EventBus;
         this.sharedContent = new SharedContentController(supabase, this);
-        this.ai = new AIModule(info.backendUrl, () => this.rimoriInfo.token, info.pluginId);
+        this.ai = new AIModule(controller);
         this.ai.setOnRateLimited((exercisesRemaining) => {
             this.eventBus.emit(info.pluginId, 'global.quota.triggerExceeded', { exercises_remaining: exercisesRemaining });
         });
-        this.event = new EventModule(info.pluginId, info.backendUrl, () => this.rimoriInfo.token, this.ai, this.eventBus);
+        this.event = new EventModule(info.pluginId, this.ai, this.eventBus);
         this.db = new DbModule(supabase, controller, info);
         this.plugin = new PluginModule(supabase, controller, info, this.ai);
         this.exercise = new ExerciseModule(supabase, controller, info, this.event);
-        this.storage = new StorageModule(info.backendUrl, () => this.rimoriInfo.token);
-        controller.onUpdate((updatedInfo) => {
-            this.rimoriInfo = updatedInfo;
-        });
+        this.storage = new StorageModule(controller);
         //only init logger in workers and on main plugin pages
         if (this.plugin.applicationMode !== 'sidebar') {
             Logger.getInstance(this);
@@ -58,11 +53,13 @@ export class RimoriClient {
     static createWithInfo(info) {
         const eventBus = EventBusHandler.create('Plugin EventBus ' + info.pluginId);
         const controller = new RimoriCommunicationHandler(info.pluginId, true);
+        controller.handleRimoriInfoUpdate(info);
         const supabase = new PostgrestClient(`${info.url}/rest/v1`, {
             schema: info.dbSchema,
             headers: {
                 apikey: info.key,
                 Authorization: `Bearer ${info.token}`,
+                'plugin-id': info.pluginId,
             },
         });
         const client = new RimoriClient(controller, supabase, info, eventBus);

package/dist/plugin/module/AIModule.d.ts

@@ -1,5 +1,6 @@
 import { Language } from './PluginModule';
 import { Tool } from '../../fromRimori/PluginTypes';
+import { RimoriCommunicationHandler } from '../CommunicationHandler';
 export type OnStreamedObjectResult<T = any> = (result: T, isLoading: boolean) => void;
 type PrimitiveType = 'string' | 'number' | 'boolean';
 type ObjectToolParameterType = PrimitiveType | {
@@ -40,12 +41,10 @@ export type OnLLMResponse = (id: string, response: string, finished: boolean, to
  * Provides access to text generation, voice synthesis, and object generation.
  */
 export declare class AIModule {
-    private getToken;
-    private backendUrl;
-    private pluginId;
+    private controller;
     private sessionTokenId;
     private onRateLimitedCb?;
-    constructor(backendUrl: string, getToken: () => string, pluginId?: string);
+    constructor(controller: RimoriCommunicationHandler);
     /**
      * Resolves a prompt name following the event naming convention:
      * - 2-segment names (e.g. 'storytelling.story') get prefixed with pluginId → '<pluginId>.storytelling.story'
@@ -60,11 +59,6 @@ export declare class AIModule {
         set: (id: string) => void;
         /** Clears the stored session token. */
         clear: () => void;
-        /**
-         * Ensures a session token exists, creating one from the backend if needed.
-         * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
-         */
-        ensure: () => Promise<void>;
     };
     /** Registers a callback invoked whenever a 429 rate-limit response is received. */
     setOnRateLimited(cb: (exercisesRemaining: number) => void): void;
@@ -109,6 +103,11 @@ export declare class AIModule {
      * @param language Optional language for the voice.
      * @param cache Whether to cache the result (default: false).
      * @returns The generated audio as a Blob.
+     *
+     * **Empty input:** If `text` is empty or whitespace-only, no network request is
+     * made and an empty `Blob` is returned immediately. This prevents a 400 error
+     * from the TTS backend while keeping the caller's workflow intact.
+     * A warning is logged to the console in this case.
      */
     getVoice(text: string, voice?: string, speed?: number, language?: string, cache?: boolean, instructions?: string): Promise<Blob>;
     /**

package/dist/plugin/module/AIModule.js

@@ -12,7 +12,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  * Provides access to text generation, voice synthesis, and object generation.
  */
 export class AIModule {
-    constructor(backendUrl, getToken, pluginId) {
+    constructor(controller) {
         this.sessionTokenId = null;
         /** Exercise session management. */
         this.session = {
@@ -26,34 +26,8 @@ export class AIModule {
             clear: () => {
                 this.sessionTokenId = null;
             },
-            /**
-             * Ensures a session token exists, creating one from the backend if needed.
-             * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
-             */
-            ensure: () => __awaiter(this, void 0, void 0, function* () {
-                var _a, _b, _c;
-                if (this.sessionTokenId)
-                    return;
-                const response = yield fetch(`${this.backendUrl}/ai/session`, {
-                    method: 'POST',
-                    headers: { Authorization: `Bearer ${this.getToken()}` },
-                });
-                if (!response.ok) {
-                    if (response.status === 429) {
-                        const body = yield response.json().catch(() => ({}));
-                        const remaining = (_a = body.exercises_remaining) !== null && _a !== void 0 ? _a : 0;
-                        (_b = this.onRateLimitedCb) === null || _b === void 0 ? void 0 : _b.call(this, remaining);
-                        throw new Error(`Rate limit exceeded: ${(_c = body.error) !== null && _c !== void 0 ? _c : 'Daily exercise limit reached'}. exercises_remaining: ${remaining}`);
-                    }
-                    throw new Error(`Failed to create session: ${response.status} ${response.statusText}`);
-                }
-                const { session_token_id } = yield response.json();
-                this.sessionTokenId = session_token_id;
-            }),
         };
-        this.backendUrl = backendUrl;
-        this.getToken = getToken;
-        this.pluginId = pluginId;
+        this.controller = controller;
     }
     /**
      * Resolves a prompt name following the event naming convention:
@@ -64,8 +38,8 @@ export class AIModule {
         if (name.startsWith('global.'))
             return name;
         const segments = name.split('.');
-        if (segments.length === 2 && this.pluginId) {
-            return `${this.pluginId}.${name}`;
+        if (segments.length === 2 && this.controller.pluginId) {
+            return `${this.controller.pluginId}.${name}`;
         }
         return name;
     }
@@ -128,17 +102,21 @@ export class AIModule {
      * @param language Optional language for the voice.
      * @param cache Whether to cache the result (default: false).
      * @returns The generated audio as a Blob.
+     *
+     * **Empty input:** If `text` is empty or whitespace-only, no network request is
+     * made and an empty `Blob` is returned immediately. This prevents a 400 error
+     * from the TTS backend while keeping the caller's workflow intact.
+     * A warning is logged to the console in this case.
      */
     getVoice(text_1) {
         return __awaiter(this, arguments, void 0, function* (text, voice = 'alloy', speed = 1, language, cache = false, instructions) {
             var _a;
-            yield this.session.ensure();
-            return yield fetch(`${this.backendUrl}/voice/tts`, {
+            if (!text.trim().length) {
+                console.warn('[rimori-client] getVoice called with empty text — skipping TTS request and returning empty Blob.');
+                return new Blob([], { type: 'audio/mpeg' });
+            }
+            return yield this.controller.fetchBackend('/voice/tts', {
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.getToken()}`,
-                },
                 body: JSON.stringify({
                     input: text,
                     voice,
@@ -159,7 +137,6 @@ export class AIModule {
      */
     getTextFromVoice(file, language) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.session.ensure();
             const formData = new FormData();
             formData.append('file', file);
             if (language) {
@@ -168,9 +145,8 @@ export class AIModule {
             if (this.sessionTokenId) {
                 formData.append('session_token_id', this.sessionTokenId);
             }
-            return yield fetch(`${this.backendUrl}/voice/stt`, {
+            return yield this.controller.fetchBackend('/voice/stt', {
                 method: 'POST',
-                headers: { Authorization: `Bearer ${this.getToken()}` },
                 body: formData,
             })
                 .then((r) => r.json())
@@ -236,10 +212,9 @@ export class AIModule {
             if (prompt) {
                 payload.prompt = { name: this.resolvePromptName(prompt), variables: variables !== null && variables !== void 0 ? variables : {} };
             }
-            const response = yield fetch(`${this.backendUrl}/ai/llm`, {
-                body: JSON.stringify(payload),
+            const response = yield this.controller.fetchBackend('/ai/llm', {
                 method: 'POST',
-                headers: { Authorization: `Bearer ${this.getToken()}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
             });
             if (!response.ok) {
                 if (response.status === 429) {
@@ -361,13 +336,9 @@ export class AIModule {
     }
     sendToolResult(toolCallId, result) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield fetch(`${this.backendUrl}/ai/llm/tool_result`, {
+            yield this.controller.fetchBackend('/ai/llm/tool_result', {
                 method: 'POST',
-                body: JSON.stringify({
-                    toolCallId,
-                    result: result !== null && result !== void 0 ? result : '[DONE]',
-                }),
-                headers: { Authorization: `Bearer ${this.getToken()} `, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ toolCallId, result: result !== null && result !== void 0 ? result : '[DONE]' }),
             });
         });
     }

package/dist/plugin/module/DbModule.d.ts

@@ -42,7 +42,7 @@ export type VectorSearchResult<T = Record<string, unknown>> = Array<T & {
 }>;
 export declare class DbModule {
     private supabase;
-    private rimoriInfo;
+    private communicationHandler;
     tablePrefix: string;
     schema: string;
     constructor(supabase: SupabaseClient, communicationHandler: RimoriCommunicationHandler, info: RimoriInfo);

package/dist/plugin/module/DbModule.js

@@ -10,11 +10,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 export class DbModule {
     constructor(supabase, communicationHandler, info) {
         this.supabase = supabase;
-        this.rimoriInfo = info;
+        this.communicationHandler = communicationHandler;
         this.tablePrefix = info.tablePrefix;
         this.schema = info.dbSchema;
         communicationHandler.onUpdate((updatedInfo) => {
-            this.rimoriInfo = updatedInfo;
             this.tablePrefix = updatedInfo.tablePrefix;
             this.schema = updatedInfo.dbSchema;
         });
@@ -37,7 +36,7 @@ export class DbModule {
         if (relation.startsWith('global_')) {
             return this.supabase.schema('public').from(tableName);
         }
-        return this.supabase.schema(this.rimoriInfo.dbSchema).from(tableName);
+        return this.supabase.schema(this.schema).from(tableName);
     }
     /**
      * Get the table name for a given plugin table.
@@ -67,15 +66,11 @@ export class DbModule {
     setPublicity(table, entryId, publicity) {
         return __awaiter(this, void 0, void 0, function* () {
             const tableName = this.getTableName(table);
-            yield fetch(`${this.rimoriInfo.backendUrl}/db-entry/publicity`, {
+            yield this.communicationHandler.fetchBackend('/db-entry/publicity', {
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.rimoriInfo.token}`,
-                },
                 body: JSON.stringify({
                     table_name: tableName,
-                    schema: this.rimoriInfo.dbSchema,
+                    schema: this.schema,
                     entry_id: entryId,
                     publicity,
                 }),
@@ -90,12 +85,8 @@ export class DbModule {
      */
     vectorSearch(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield fetch(`${this.rimoriInfo.backendUrl}/plugin-search/vector-search`, {
+            const response = yield this.communicationHandler.fetchBackend('/plugin-search/vector-search', {
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.rimoriInfo.token}`,
-                },
                 body: JSON.stringify(params),
             });
             if (!response.ok) {

package/dist/plugin/module/EventModule.d.ts

@@ -10,10 +10,8 @@ export declare class EventModule {
     private pluginId;
     private accomplishmentController;
     private aiModule;
-    private backendUrl;
-    private getToken;
     private eventBus;
-    constructor(pluginId: string, backendUrl: string, getToken: () => string, aiModule: AIModule, eventBus?: EventBusHandler);
+    constructor(pluginId: string, aiModule: AIModule, eventBus?: EventBusHandler);
     getGlobalEventTopic(preliminaryTopic: string): string;
     /**
      * Emit an event to Rimori or a plugin.

package/dist/plugin/module/EventModule.js

@@ -14,13 +14,23 @@ import { EventBus } from '../../fromRimori/EventBus';
  * Provides methods for emitting, listening to, and responding to events.
  */
 export class EventModule {
-    constructor(pluginId, backendUrl, getToken, aiModule, eventBus) {
+    constructor(pluginId, aiModule, eventBus) {
         this.pluginId = pluginId;
-        this.backendUrl = backendUrl;
-        this.getToken = getToken;
         this.aiModule = aiModule;
         this.eventBus = eventBus !== null && eventBus !== void 0 ? eventBus : EventBus;
         this.accomplishmentController = new AccomplishmentController(pluginId, this.eventBus);
+        // Listen for session token broadcasts from rimori-main (ExerciseSessionManager).
+        // When an exercise starts: adopt the exercise token unconditionally.
+        // When an exercise ends (session_token: null): clear the current token.
+        // This runs on the raw eventBus to bypass the per-plugin token-gating in on().
+        this.eventBus.on(['global.session.triggerUpdate'], (event) => {
+            if (event.data.session_token) {
+                this.aiModule.session.set(event.data.session_token);
+            }
+            else {
+                this.aiModule.session.clear();
+            }
+        });
     }
     getGlobalEventTopic(preliminaryTopic) {
         var _a;
@@ -67,7 +77,6 @@ export class EventModule {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
             const globalTopic = this.getGlobalEventTopic(topic);
-            yield this.aiModule.session.ensure();
             const sessionToken = (_a = this.aiModule.session.get()) !== null && _a !== void 0 ? _a : undefined;
             return this.eventBus.request(this.pluginId, globalTopic, data, sessionToken);
         });
@@ -133,21 +142,6 @@ export class EventModule {
      */
     emitAccomplishment(payload) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (payload.type === 'macro') {
-                const sessionId = this.aiModule.session.get();
-                if (sessionId) {
-                    try {
-                        yield fetch(`${this.backendUrl}/ai/session/${sessionId}/complete`, {
-                            method: 'PATCH',
-                            headers: { Authorization: `Bearer ${this.getToken()}` },
-                        });
-                    }
-                    catch (_a) {
-                        // non-fatal — session will expire naturally
-                    }
-                    this.aiModule.session.clear();
-                }
-            }
             this.accomplishmentController.emitAccomplishment(payload);
         });
     }
@@ -235,6 +229,9 @@ export class EventModule {
         });
         console.log('[EventModule] onSidePanelAction: emitting action.requestSidebar for', this.pluginId);
         this.emit('action.requestSidebar');
+        // Bridge is connected at this point — request current session token in case
+        // an exercise was already active before this sidebar plugin mounted.
+        this.eventBus.emit(this.pluginId, 'global.session.requestCurrent', {});
         return listener;
     }
 }

package/dist/plugin/module/ExerciseModule.d.ts

@@ -35,9 +35,7 @@ export declare class ExerciseModule {
     private supabase;
     private communicationHandler;
     private eventModule;
-    private backendUrl;
-    private token;
-    constructor(supabase: SupabaseClient, communicationHandler: RimoriCommunicationHandler, info: RimoriInfo, eventModule: EventModule);
+    constructor(supabase: SupabaseClient, communicationHandler: RimoriCommunicationHandler, _info: RimoriInfo, eventModule: EventModule);
     /**
      * Fetches weekly exercises from the weekly_exercises view.
      * Shows exercises for the current week that haven't expired.
@@ -52,6 +50,22 @@ export declare class ExerciseModule {
      * @returns Created exercise objects.
      */
     add(params: CreateExerciseParams | CreateExerciseParams[]): Promise<Exercise[]>;
+    /**
+     * Requests a new exercise session token from rimori-main.
+     * Use this for self-initiated exercises (user navigated to plugin via navbar and clicked Start).
+     * For dashboard-triggered exercises (onMainPanelAction), the token is provided automatically.
+     *
+     * Emits `global.exercise.triggerStart` and waits for rimori-main to respond with the
+     * session token via `global.session.triggerUpdate`. The token is then automatically
+     * available for AI calls.
+     *
+     * @param params.actionKey The action key identifying this exercise type.
+     * @param params.knowledgeId Optional knowledge ID for tracking what was studied.
+     */
+    start(params: {
+        actionKey: string;
+        knowledgeId?: string;
+    }): Promise<void>;
     /**
      * Deletes an exercise via the backend API.
      * @param id The exercise ID to delete.

package/dist/plugin/module/ExerciseModule.js

@@ -12,15 +12,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  * Provides access to weekly exercises and exercise management.
  */
 export class ExerciseModule {
-    constructor(supabase, communicationHandler, info, eventModule) {
+    constructor(supabase, communicationHandler, _info, eventModule) {
         this.supabase = supabase;
         this.communicationHandler = communicationHandler;
         this.eventModule = eventModule;
-        this.token = info.token;
-        this.backendUrl = info.backendUrl;
-        this.communicationHandler.onUpdate((updatedInfo) => {
-            this.token = updatedInfo.token;
-        });
     }
     /**
      * Fetches weekly exercises from the weekly_exercises view.
@@ -46,12 +41,8 @@ export class ExerciseModule {
     add(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const exercises = Array.isArray(params) ? params : [params];
-            const response = yield fetch(`${this.backendUrl}/exercises`, {
+            const response = yield this.communicationHandler.fetchBackend('/exercises', {
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.token}`,
-                },
                 body: JSON.stringify({ exercises }),
             });
             if (!response.ok) {
@@ -63,6 +54,36 @@ export class ExerciseModule {
             return data;
         });
     }
+    /**
+     * Requests a new exercise session token from rimori-main.
+     * Use this for self-initiated exercises (user navigated to plugin via navbar and clicked Start).
+     * For dashboard-triggered exercises (onMainPanelAction), the token is provided automatically.
+     *
+     * Emits `global.exercise.triggerStart` and waits for rimori-main to respond with the
+     * session token via `global.session.triggerUpdate`. The token is then automatically
+     * available for AI calls.
+     *
+     * @param params.actionKey The action key identifying this exercise type.
+     * @param params.knowledgeId Optional knowledge ID for tracking what was studied.
+     */
+    start(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    listener.off();
+                    reject(new Error('Exercise start timed out: rimori-main did not respond within 5s'));
+                }, 5000);
+                const listener = this.eventModule.on('global.session.triggerUpdate', ({ data }) => {
+                    if (data.session_token) {
+                        clearTimeout(timeout);
+                        listener.off();
+                        resolve();
+                    }
+                });
+                this.eventModule.emit('global.exercise.triggerStart', params);
+            });
+        });
+    }
     /**
      * Deletes an exercise via the backend API.
      * @param id The exercise ID to delete.
@@ -70,11 +91,8 @@ export class ExerciseModule {
      */
     delete(id) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield fetch(`${this.backendUrl}/exercises/${id}`, {
+            const response = yield this.communicationHandler.fetchBackend(`/exercises/${id}`, {
                 method: 'DELETE',
-                headers: {
-                    Authorization: `Bearer ${this.token}`,
-                },
             });
             if (!response.ok) {
                 const errorText = yield response.text();

package/dist/plugin/module/SharedContentController.js

@@ -34,7 +34,6 @@ export class SharedContentController {
             // Generate new content via backend endpoint
             const response = yield this.rimoriClient.runtime.fetchBackend('/shared-content/generate', {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     tableName: params.table,
                     skillType: params.skillType,
@@ -67,7 +66,6 @@ export class SharedContentController {
         return __awaiter(this, arguments, void 0, function* (tableName, topic, limit = 10) {
             const response = yield this.rimoriClient.runtime.fetchBackend('/shared-content/get-by-topic', {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     tableName,
                     limit,
@@ -285,7 +283,6 @@ export class SharedContentController {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield this.rimoriClient.runtime.fetchBackend('/shared-content/update', {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     tableName,
                     contentId,
@@ -311,7 +308,6 @@ export class SharedContentController {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield this.rimoriClient.runtime.fetchBackend('/shared-content/validate', {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     tableName,
                     contentId,

package/dist/plugin/module/StorageModule.d.ts

@@ -8,10 +8,10 @@
  * confirms images found in content, and deletes orphaned ones. No plugin-side
  * confirm or delete calls are needed.
  */
+import { RimoriCommunicationHandler } from '../CommunicationHandler';
 export declare class StorageModule {
-    private readonly backendUrl;
-    private readonly getToken;
-    constructor(backendUrl: string, getToken: () => string);
+    private readonly controller;
+    constructor(controller: RimoriCommunicationHandler);
     /**
      * Upload a PNG image blob to Supabase storage via the backend.
      *

package/dist/plugin/module/StorageModule.js

@@ -7,20 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-/**
- * Storage module for plugin image operations.
- *
- * Handles uploading images to Supabase storage via the backend.
- *
- * Images are tracked automatically: the backend cron scans markdown columns
- * (declared via `type: 'markdown'` in db.config.ts) every 30 minutes,
- * confirms images found in content, and deletes orphaned ones. No plugin-side
- * confirm or delete calls are needed.
- */
 export class StorageModule {
-    constructor(backendUrl, getToken) {
-        this.backendUrl = backendUrl;
-        this.getToken = getToken;
+    constructor(controller) {
+        this.controller = controller;
     }
     /**
      * Upload a PNG image blob to Supabase storage via the backend.
@@ -37,9 +26,8 @@ export class StorageModule {
             const formData = new FormData();
             formData.append('file', pngBlob, 'image.png');
             try {
-                const response = yield fetch(`${this.backendUrl}/plugin-images/upload`, {
+                const response = yield this.controller.fetchBackend('/plugin-images/upload', {
                     method: 'POST',
-                    headers: { Authorization: `Bearer ${this.getToken()}` },
                     body: formData,
                 });
                 if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/client",
-  "version": "2.5.31",
+  "version": "2.5.32-next.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {