@rimori/client 1.3.1 → 1.4.3

package/src/plugin/PluginController.ts

@@ -2,7 +2,7 @@ import { createClient, SupabaseClient } from '@supabase/supabase-js';
 import { UserInfo } from '../core/controller/SettingsController';
 import { EventBus, EventBusMessage } from '../fromRimori/EventBus';
 import { ActivePlugin, Plugin } from '../fromRimori/PluginTypes';
-import { RimoriClient } from "./RimoriClient";
+import { RimoriClient } from './RimoriClient';
 import { StandaloneClient } from './StandaloneClient';
 import { setTheme } from './ThemeSetter';
 import { Logger } from './Logger';
@@ -10,18 +10,25 @@ import { Logger } from './Logger';
 // Add declaration for WorkerGlobalScope
 declare const WorkerGlobalScope: any;
 
+export interface Guild {
+  id: string;
+  longTermGoalOverride: string;
+  allowUserPluginSettings: boolean;
+}
+
 export interface RimoriInfo {
-  url: string,
-  key: string,
-  backendUrl: string,
-  token: string,
-  expiration: Date,
-  tablePrefix: string,
-  pluginId: string
-  installedPlugins: Plugin[]
-  profile: UserInfo
-  mainPanelPlugin?: ActivePlugin
-  sidePanelPlugin?: ActivePlugin
+  url: string;
+  key: string;
+  backendUrl: string;
+  token: string;
+  expiration: Date;
+  tablePrefix: string;
+  pluginId: string;
+  guild: Guild;
+  installedPlugins: Plugin[];
+  profile: UserInfo;
+  mainPanelPlugin?: ActivePlugin;
+  sidePanelPlugin?: ActivePlugin;
 }
 
 export class PluginController {
@@ -54,12 +61,16 @@ export class PluginController {
 
   private initMessageChannel(worker: boolean = false) {
     const listener = (event: MessageEvent) => {
-      console.log("[PluginController] window message", { origin: event.origin, data: event.data });
+      console.log('[PluginController] window message', { origin: event.origin, data: event.data });
       const { type, pluginId, queryParams, rimoriInfo } = event.data || {};
       const [transferredPort] = event.ports || [];
 
-      if (type !== "rimori:init" || !transferredPort || pluginId !== this.pluginId) {
-        console.log("[PluginController] message ignored (not init or wrong plugin)", { type, pluginId, hasPort: !!transferredPort });
+      if (type !== 'rimori:init' || !transferredPort || pluginId !== this.pluginId) {
+        console.log('[PluginController] message ignored (not init or wrong plugin)', {
+          type,
+          pluginId,
+          hasPort: !!transferredPort,
+        });
         return;
       }
 
@@ -70,7 +81,7 @@ export class PluginController {
       if (rimoriInfo) {
         this.rimoriInfo = rimoriInfo;
         this.supabase = createClient(rimoriInfo.url, rimoriInfo.key, {
-          accessToken: () => Promise.resolve(rimoriInfo.token)
+          accessToken: () => Promise.resolve(rimoriInfo.token),
         });
       }
 
@@ -98,8 +109,8 @@ export class PluginController {
       }
 
       // Forward plugin events to parent (only after MessageChannel is ready)
-      EventBus.on("*", (ev) => {
-        if (ev.sender === this.pluginId && !ev.topic.startsWith("self.")) {
+      EventBus.on('*', (ev) => {
+        if (ev.sender === this.pluginId && !ev.topic.startsWith('self.')) {
           this.port?.postMessage({ event: ev });
         }
       });
@@ -108,27 +119,27 @@ export class PluginController {
       this.isMessageChannelReady = true;
 
       // Process any pending requests
-      this.pendingRequests.forEach(request => request());
+      this.pendingRequests.forEach((request) => request());
       this.pendingRequests = [];
     };
     if (worker) {
       self.onmessage = listener;
     } else {
-      window.addEventListener("message", listener);
+      window.addEventListener('message', listener);
     }
     this.sendHello(worker);
   }
 
   private sendHello(isWorker: boolean = false) {
     try {
-      const payload = { type: "rimori:hello", pluginId: this.pluginId };
+      const payload = { type: 'rimori:hello', pluginId: this.pluginId };
       if (isWorker) {
         self.postMessage(payload);
       } else {
-        window.parent.postMessage(payload, "*");
+        window.parent.postMessage(payload, '*');
       }
     } catch (e) {
-      console.error("[PluginController] Error sending hello:", e);
+      console.error('[PluginController] Error sending hello:', e);
     }
   }
 
@@ -141,7 +152,7 @@ export class PluginController {
       PluginController.client = await RimoriClient.getInstance(PluginController.instance);
 
       //only init logger in workers and on main plugin pages
-      if (PluginController.instance.getQueryParam("applicationMode") !== "sidebar") {
+      if (PluginController.instance.getQueryParam('applicationMode') !== 'sidebar') {
         Logger.getInstance(PluginController.client);
       }
     }
@@ -152,7 +163,7 @@ export class PluginController {
     return this.queryParams[key] || null;
   }
 
-  public async getClient(): Promise<{ supabase: SupabaseClient, info: RimoriInfo }> {
+  public async getClient(): Promise<{ supabase: SupabaseClient; info: RimoriInfo }> {
     // Return cached client if valid
     if (this.supabase && this.rimoriInfo && this.rimoriInfo.expiration > new Date()) {
       return { supabase: this.supabase, info: this.rimoriInfo };
@@ -160,7 +171,7 @@ export class PluginController {
 
     // If MessageChannel is not ready yet, queue the request
     if (!this.isMessageChannelReady) {
-      return new Promise<{ supabase: SupabaseClient, info: RimoriInfo }>((resolve) => {
+      return new Promise<{ supabase: SupabaseClient; info: RimoriInfo }>((resolve) => {
         this.pendingRequests.push(async () => {
           const result = await this.getClient();
           resolve(result);
@@ -185,18 +196,18 @@ export class PluginController {
             sender: this.pluginId,
             topic: 'global.supabase.requestAccess',
             data: {},
-            debug: false
-          }
+            debug: false,
+          },
         };
 
-        return new Promise<{ supabase: SupabaseClient, info: RimoriInfo }>((resolve) => {
+        return new Promise<{ supabase: SupabaseClient; info: RimoriInfo }>((resolve) => {
           // Listen for the response
           const originalOnMessage = self.onmessage;
           self.onmessage = (event) => {
             if (event.data?.topic === 'global.supabase.requestAccess' && event.data?.eventId === eventId) {
               this.rimoriInfo = event.data.data;
               this.supabase = createClient(this.rimoriInfo!.url, this.rimoriInfo!.key, {
-                accessToken: () => Promise.resolve(this.getToken())
+                accessToken: () => Promise.resolve(this.getToken()),
               });
               self.onmessage = originalOnMessage; // Restore original handler
               resolve({ supabase: this.supabase, info: this.rimoriInfo! });
@@ -210,10 +221,11 @@ export class PluginController {
         });
       } else {
         // In main thread context, use EventBus
-        const { data } = await EventBus.request<RimoriInfo>(this.pluginId, "global.supabase.requestAccess");
+        const { data } = await EventBus.request<RimoriInfo>(this.pluginId, 'global.supabase.requestAccess');
+        console.log({ data });
         this.rimoriInfo = data;
         this.supabase = createClient(this.rimoriInfo.url, this.rimoriInfo.key, {
-          accessToken: () => Promise.resolve(this.getToken())
+          accessToken: () => Promise.resolve(this.getToken()),
         });
       }
     }
@@ -228,13 +240,16 @@ export class PluginController {
 
     // If we don't have rimoriInfo, request it
     if (!this.rimoriInfo) {
-      const { data } = await EventBus.request<RimoriInfo>(this.pluginId, "global.supabase.requestAccess");
+      const { data } = await EventBus.request<RimoriInfo>(this.pluginId, 'global.supabase.requestAccess');
       this.rimoriInfo = data;
       return this.rimoriInfo.token;
     }
 
     // If token is expired, request fresh access
-    const { data } = await EventBus.request<{ token: string, expiration: Date }>(this.pluginId, "global.supabase.requestAccess");
+    const { data } = await EventBus.request<{ token: string; expiration: Date }>(
+      this.pluginId,
+      'global.supabase.requestAccess',
+    );
     this.rimoriInfo.token = data.token;
     this.rimoriInfo.expiration = data.expiration;
 
@@ -248,7 +263,7 @@ export class PluginController {
    */
   public getSupabaseUrl() {
     if (!this.rimoriInfo) {
-      throw new Error("Supabase info not found");
+      throw new Error('Supabase info not found');
     }
 
     return this.rimoriInfo.url;
@@ -256,30 +271,31 @@ export class PluginController {
 
   public getBackendUrl() {
     if (!this.rimoriInfo) {
-      throw new Error("Rimori info not found");
+      throw new Error('Rimori info not found');
     }
     return this.rimoriInfo.backendUrl;
   }
 
   public getGlobalEventTopic(preliminaryTopic: string) {
-    if (preliminaryTopic.startsWith("global.")) {
+    if (preliminaryTopic.startsWith('global.')) {
       return preliminaryTopic;
     }
-    if (preliminaryTopic.startsWith("self.")) {
+    if (preliminaryTopic.startsWith('self.')) {
       return preliminaryTopic;
     }
-    const topicParts = preliminaryTopic.split(".");
+    const topicParts = preliminaryTopic.split('.');
     if (topicParts.length === 3) {
-      if (!topicParts[0].startsWith("pl") && topicParts[0] !== "global") {
+      if (!topicParts[0].startsWith('pl') && topicParts[0] !== 'global') {
         throw new Error("The event topic must start with the plugin id or 'global'.");
       }
       return preliminaryTopic;
     } else if (topicParts.length > 3) {
-      throw new Error(`The event topic must consist of 3 parts. <pluginId>.<topic area>.<action>. Received: ${preliminaryTopic}`);
+      throw new Error(
+        `The event topic must consist of 3 parts. <pluginId>.<topic area>.<action>. Received: ${preliminaryTopic}`,
+      );
     }
 
-    const topicRoot = this.rimoriInfo?.pluginId ?? "global";
+    const topicRoot = this.rimoriInfo?.pluginId ?? 'global';
     return `${topicRoot}.${preliminaryTopic}`;
   }
-
-}
+}

package/src/plugin/RimoriClient.ts

@@ -1,21 +1,30 @@
-import { PostgrestQueryBuilder } from "@supabase/postgrest-js";
-import { SupabaseClient } from "@supabase/supabase-js";
-import { GenericSchema } from "@supabase/supabase-js/dist/module/lib/types";
-import { generateText, Message, OnLLMResponse, streamChatGPT } from "../core/controller/AIController";
-import { generateObject, ObjectRequest } from "../core/controller/ObjectController";
-import { SettingsController, UserInfo } from "../core/controller/SettingsController";
-import { SharedContent, SharedContentController, SharedContentFilter, SharedContentObjectRequest } from "../core/controller/SharedContentController";
-import { getSTTResponse, getTTSResponse } from "../core/controller/VoiceController";
-import { EventBus, EventBusMessage, EventHandler, EventPayload } from "../fromRimori/EventBus";
-import { ActivePlugin, MainPanelAction, Plugin, Tool } from "../fromRimori/PluginTypes";
-import { AccomplishmentHandler, AccomplishmentPayload } from "./AccomplishmentHandler";
-import { PluginController, RimoriInfo } from "./PluginController";
-
+import { PostgrestQueryBuilder } from '@supabase/postgrest-js';
+import { SupabaseClient } from '@supabase/supabase-js';
+import { GenericSchema } from '@supabase/supabase-js/dist/module/lib/types';
+import { generateText, Message, OnLLMResponse, streamChatGPT } from '../core/controller/AIController';
+import { generateObject, ObjectRequest } from '../core/controller/ObjectController';
+import { SettingsController, UserInfo } from '../core/controller/SettingsController';
+import {
+  SharedContent,
+  SharedContentController,
+  SharedContentFilter,
+  SharedContentObjectRequest,
+} from '../core/controller/SharedContentController';
+import { getSTTResponse, getTTSResponse } from '../core/controller/VoiceController';
+import { ExerciseController, CreateExerciseParams } from '../core/controller/ExerciseController';
+import { EventBus, EventBusMessage, EventHandler, EventPayload } from '../fromRimori/EventBus';
+import { ActivePlugin, MainPanelAction, Plugin, Tool } from '../fromRimori/PluginTypes';
+import { AccomplishmentHandler, AccomplishmentPayload } from './AccomplishmentHandler';
+import { PluginController, RimoriInfo } from './PluginController';
 
 interface Db {
   from: {
-    <TableName extends string & keyof GenericSchema['Tables'], Table extends GenericSchema['Tables'][TableName]>(relation: TableName): PostgrestQueryBuilder<GenericSchema, Table, TableName>;
-    <ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(relation: ViewName): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
+    <TableName extends string & keyof GenericSchema['Tables'], Table extends GenericSchema['Tables'][TableName]>(
+      relation: TableName,
+    ): PostgrestQueryBuilder<GenericSchema, Table, TableName>;
+    <ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(
+      relation: ViewName,
+    ): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
   };
   // storage: SupabaseClient["storage"];
 
@@ -40,7 +49,7 @@ interface PluginInterface {
    * Get the settings for the plugin. T can be any type of settings, UserSettings or SystemSettings.
    * @param defaultSettings The default settings to use if no settings are found.
    * @param genericSettings The type of settings to get.
-   * @returns The settings for the plugin. 
+   * @returns The settings for the plugin.
    */
   getSettings: <T extends object>(defaultSettings: T) => Promise<T>;
   /**
@@ -53,15 +62,15 @@ interface PluginInterface {
     /**
      * All installed plugins.
      */
-    installedPlugins: Plugin[],
+    installedPlugins: Plugin[];
     /**
      * The plugin that is loaded in the main panel.
      */
-    mainPanelPlugin?: ActivePlugin,
+    mainPanelPlugin?: ActivePlugin;
     /**
      * The plugin that is loaded in the side panel.
      */
-    sidePanelPlugin?: ActivePlugin,
+    sidePanelPlugin?: ActivePlugin;
   };
   getUserInfo: () => UserInfo;
 }
@@ -72,6 +81,7 @@ export class RimoriClient {
   private pluginController: PluginController;
   private settingsController: SettingsController;
   private sharedContentController: SharedContentController;
+  private exerciseController: ExerciseController;
   private accomplishmentHandler: AccomplishmentHandler;
   private rimoriInfo: RimoriInfo;
   public plugin: PluginInterface;
@@ -81,19 +91,21 @@ export class RimoriClient {
     this.rimoriInfo = info;
     this.superbase = supabase;
     this.pluginController = pluginController;
-    this.settingsController = new SettingsController(supabase, info.pluginId);
+    this.settingsController = new SettingsController(supabase, info.pluginId, info.guild);
     this.sharedContentController = new SharedContentController(this.superbase, this);
+    this.exerciseController = new ExerciseController(supabase, pluginController);
     this.accomplishmentHandler = new AccomplishmentHandler(info.pluginId);
 
     this.from = this.from.bind(this);
+    this.getTableName = this.getTableName.bind(this);
 
     this.db = {
       from: this.from,
       // storage: this.superbase.storage,
       // functions: this.superbase.functions,
       tablePrefix: info.tablePrefix,
-      getTableName: this.getTableName.bind(this),
-    }
+      getTableName: this.getTableName,
+    };
     this.plugin = {
       pluginId: info.pluginId,
       setSettings: async (settings: any) => {
@@ -110,14 +122,14 @@ export class RimoriClient {
           installedPlugins: this.rimoriInfo.installedPlugins,
           mainPanelPlugin: this.rimoriInfo.mainPanelPlugin,
           sidePanelPlugin: this.rimoriInfo.sidePanelPlugin,
-        }
-      }
-    }
+        };
+      },
+    };
   }
 
   public event = {
     /**
-     * Emit an event to Rimori or a plugin. 
+     * Emit an event to Rimori or a plugin.
      * The topic schema is:
      * {pluginId}.{eventId}
      * Check out the event bus documentation for more information.
@@ -148,7 +160,10 @@ export class RimoriClient {
      */
     on: <T = EventPayload>(topic: string | string[], callback: EventHandler<T>) => {
       const topics = Array.isArray(topic) ? topic : [topic];
-      return EventBus.on<T>(topics.map(t => this.pluginController.getGlobalEventTopic(t)), callback);
+      return EventBus.on<T>(
+        topics.map((t) => this.pluginController.getGlobalEventTopic(t)),
+        callback,
+      );
     },
     /**
      * Subscribe to an event once.
@@ -163,9 +178,16 @@ export class RimoriClient {
      * @param topic The topic to respond to.
      * @param data The data to respond with.
      */
-    respond: <T = EventPayload>(topic: string | string[], data: EventPayload | ((data: EventBusMessage<T>) => EventPayload | Promise<EventPayload>)) => {
+    respond: <T = EventPayload>(
+      topic: string | string[],
+      data: EventPayload | ((data: EventBusMessage<T>) => EventPayload | Promise<EventPayload>),
+    ) => {
       const topics = Array.isArray(topic) ? topic : [topic];
-      EventBus.respond(this.plugin.pluginId, topics.map(t => this.pluginController.getGlobalEventTopic(t)), data);
+      EventBus.respond(
+        this.plugin.pluginId,
+        topics.map((t) => this.pluginController.getGlobalEventTopic(t)),
+        data,
+      );
     },
     /**
      * Emit an accomplishment.
@@ -179,7 +201,10 @@ export class RimoriClient {
      * @param accomplishmentTopic The topic to subscribe to.
      * @param callback The callback to call when the accomplishment is emitted.
      */
-    onAccomplishment: (accomplishmentTopic: string, callback: (payload: EventBusMessage<AccomplishmentPayload>) => void) => {
+    onAccomplishment: (
+      accomplishmentTopic: string,
+      callback: (payload: EventBusMessage<AccomplishmentPayload>) => void,
+    ) => {
       this.accomplishmentHandler.subscribe(accomplishmentTopic, callback);
     },
     /**
@@ -189,21 +214,21 @@ export class RimoriClient {
      * @param text Optional text to be used for the action like for example text that the translator would look up.
      */
     emitSidebarAction: (pluginId: string, actionKey: string, text?: string) => {
-      this.event.emit("global.sidebar.triggerAction", { plugin_id: pluginId, action_key: actionKey, text });
+      this.event.emit('global.sidebar.triggerAction', { plugin_id: pluginId, action_key: actionKey, text });
     },
 
     onMainPanelAction: (callback: (data: MainPanelAction) => void) => {
       // this needs to be a emit and on because the main panel action is triggered by the user and not by the plugin
-      this.event.emit("action.requestMain")
-      this.event.on<MainPanelAction>("action.requestMain", ({ data }) => callback(data));
-    }
-  }
+      this.event.emit('action.requestMain');
+      this.event.on<MainPanelAction>('action.requestMain', ({ data }) => callback(data));
+    },
+  };
 
   public navigation = {
     toDashboard: () => {
-      this.event.emit("global.navigation.triggerToDashboard");
-    }
-  }
+      this.event.emit('global.navigation.triggerToDashboard');
+    },
+  };
 
   /**
    * Get a query parameter value that was passed via MessageChannel
@@ -224,36 +249,37 @@ export class RimoriClient {
 
   private from<
     TableName extends string & keyof GenericSchema['Tables'],
-    Table extends GenericSchema['Tables'][TableName]
-  >(relation: TableName): PostgrestQueryBuilder<GenericSchema, Table, TableName>
-  private from<
-    ViewName extends string & keyof GenericSchema['Views'],
-    View extends GenericSchema['Views'][ViewName]
-  >(relation: ViewName): PostgrestQueryBuilder<GenericSchema, View, ViewName>
+    Table extends GenericSchema['Tables'][TableName],
+  >(relation: TableName): PostgrestQueryBuilder<GenericSchema, Table, TableName>;
+  private from<ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(
+    relation: ViewName,
+  ): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
   private from(relation: string): PostgrestQueryBuilder<GenericSchema, any, any> {
     return this.superbase.from(this.getTableName(relation));
   }
 
   private getTableName(table: string) {
     if (/[A-Z]/.test(table)) {
-      throw new Error("Table name cannot include uppercase letters. Please use snake_case for table names.");
+      throw new Error('Table name cannot include uppercase letters. Please use snake_case for table names.');
     }
-    if (table.startsWith("global_")) {
-      return table.replace("global_", "");
+    if (table.startsWith('global_')) {
+      return table.replace('global_', '');
     }
-    return this.db.tablePrefix + "_" + table;
+    return this.db.tablePrefix + '_' + table;
   }
 
   public ai = {
     getText: async (messages: Message[], tools?: Tool[]): Promise<string> => {
       const token = await this.pluginController.getToken();
-      return generateText(this.pluginController.getBackendUrl(), messages, tools || [], token).then(({ messages }) => messages[0].content[0].text);
+      return generateText(this.pluginController.getBackendUrl(), messages, tools || [], token).then(
+        ({ messages }) => messages[0].content[0].text,
+      );
     },
     getSteamedText: async (messages: Message[], onMessage: OnLLMResponse, tools?: Tool[]) => {
       const token = await this.pluginController.getToken();
       streamChatGPT(this.pluginController.getBackendUrl(), messages, tools || [], onMessage, token);
     },
-    getVoice: async (text: string, voice = "alloy", speed = 1, language?: string): Promise<Blob> => {
+    getVoice: async (text: string, voice = 'alloy', speed = 1, language?: string): Promise<Blob> => {
       const token = await this.pluginController.getToken();
       return getTTSResponse(this.pluginController.getBackendUrl(), { input: text, voice, speed, language }, token);
     },
@@ -266,7 +292,7 @@ export class RimoriClient {
       return generateObject(this.pluginController.getBackendUrl(), request, token);
     },
     // getSteamedObject: this.generateObjectStream,
-  }
+  };
 
   public runtime = {
     fetchBackend: async (url: string, options: RequestInit) => {
@@ -275,11 +301,11 @@ export class RimoriClient {
         ...options,
         headers: {
           ...options.headers,
-          'Authorization': `Bearer ${token}`
-        }
+          Authorization: `Bearer ${token}`,
+        },
       });
-    }
-  }
+    },
+  };
 
   public community = {
     /**
@@ -304,7 +330,11 @@ export class RimoriClient {
        * @param limit The optional limit for the number of results.
        * @returns The list of shared content items.
        */
-      getList: async <T = any>(contentType: string, filter?: SharedContentFilter, limit?: number): Promise<SharedContent<T>[]> => {
+      getList: async <T = any>(
+        contentType: string,
+        filter?: SharedContentFilter,
+        limit?: number,
+      ): Promise<SharedContent<T>[]> => {
         return await this.sharedContentController.getSharedContentList(contentType, filter, limit);
       },
       /**
@@ -325,7 +355,12 @@ export class RimoriClient {
         filter?: SharedContentFilter,
         options?: { privateTopic?: boolean; skipDbSave?: boolean; alwaysGenerateNew?: boolean; excludeIds?: string[] },
       ): Promise<SharedContent<T>> => {
-        return await this.sharedContentController.getNewSharedContent(contentType, generatorInstructions, filter, options);
+        return await this.sharedContentController.getNewSharedContent(
+          contentType,
+          generatorInstructions,
+          filter,
+          options,
+        );
       },
       /**
        * Create a new shared content item.
@@ -345,10 +380,10 @@ export class RimoriClient {
         return await this.sharedContentController.updateSharedContent(id, content);
       },
       /**
-        * Complete a shared content item.
-        * @param contentType The type of shared content to complete. E.g. assignments, exercises, etc.
-        * @param assignmentId The id of the shared content item to complete.
-        */
+       * Complete a shared content item.
+       * @param contentType The type of shared content to complete. E.g. assignments, exercises, etc.
+       * @param assignmentId The id of the shared content item to complete.
+       */
       complete: async (contentType: string, assignmentId: string) => {
         return await this.sharedContentController.completeSharedContent(contentType, assignmentId);
       },
@@ -358,11 +393,11 @@ export class RimoriClient {
         * Useful for marking content as completed, ongoing, hidden, liked, disliked, or bookmarked.
         */
       updateState: async (params: {
-        contentType: string
-        id: string
-        state?: 'completed' | 'ongoing' | 'hidden'
-        reaction?: 'liked' | 'disliked' | null
-        bookmarked?: boolean
+        contentType: string;
+        id: string;
+        state?: 'completed' | 'ongoing' | 'hidden';
+        reaction?: 'liked' | 'disliked' | null;
+        bookmarked?: boolean;
       }): Promise<void> => {
         return await this.sharedContentController.updateSharedContentState(params);
       },
@@ -373,7 +408,36 @@ export class RimoriClient {
        */
       remove: async (id: string): Promise<SharedContent<any>> => {
         return await this.sharedContentController.removeSharedContent(id);
-      }
-    }
-  }
+      },
+    },
+  };
+
+  public exercise = {
+    /**
+     * Fetches weekly exercises from the weekly_exercises view.
+     * Shows exercises for the current week that haven't expired.
+     * @returns Array of exercise objects.
+     */
+    view: async () => {
+      return this.exerciseController.viewWeeklyExercises();
+    },
+
+    /**
+     * Creates a new exercise via the backend API.
+     * @param params Exercise creation parameters.
+     * @returns Created exercise object.
+     */
+    add: async (params: CreateExerciseParams) => {
+      return this.exerciseController.addExercise(params);
+    },
+
+    /**
+     * Deletes an exercise via the backend API.
+     * @param id The exercise ID to delete.
+     * @returns Success status.
+     */
+    delete: async (id: string) => {
+      return this.exerciseController.deleteExercise(id);
+    },
+  };
 }