@rimori/client 2.5.26-next.1 → 2.5.26-next.3

package/dist/cli/scripts/release/release-prompts-upload.d.ts

@@ -0,0 +1,8 @@
+import { Config } from './release';
+/**
+ * Read and send the prompts configuration to the release endpoint.
+ * Mirrors the pattern of release-db-update.ts.
+ * @param config - Configuration object
+ * @param release_id - The release ID
+ */
+export default function promptsUpload(config: Config, release_id: string): Promise<void>;

package/dist/cli/scripts/release/release-prompts-upload.js

@@ -0,0 +1,88 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import fs from 'fs';
+import path from 'path';
+import ts from 'typescript';
+/**
+ * Read and send the prompts configuration to the release endpoint.
+ * Mirrors the pattern of release-db-update.ts.
+ * @param config - Configuration object
+ * @param release_id - The release ID
+ */
+export default function promptsUpload(config, release_id) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const promptsConfigPath = path.resolve('./rimori/prompts.config.ts');
+        // Check if prompts config file exists — optional, skip if not present
+        try {
+            yield fs.promises.access(promptsConfigPath);
+        }
+        catch (e) {
+            return; // No prompts.config.ts — silently skip
+        }
+        try {
+            // Use TypeScript compiler to transpile and load
+            const promptsContent = yield fs.promises.readFile(promptsConfigPath, 'utf8');
+            // Transpile TypeScript to JavaScript
+            const result = ts.transpile(promptsContent, {
+                target: ts.ScriptTarget.ES2020,
+                module: ts.ModuleKind.ES2020,
+            });
+            // Create a temporary file to import the transpiled code
+            const tempFile = path.join(process.cwd(), 'temp_prompts_config.js');
+            yield fs.promises.writeFile(tempFile, result);
+            let prompts;
+            try {
+                const promptsModule = yield import(`file://${tempFile}`);
+                // Collect all named exports as individual prompt definitions
+                prompts = Object.values(promptsModule);
+                yield fs.promises.unlink(tempFile);
+            }
+            catch (error) {
+                try {
+                    yield fs.promises.unlink(tempFile);
+                }
+                catch (e) { }
+                throw error;
+            }
+            if (!Array.isArray(prompts) || prompts.length === 0) {
+                console.warn('⚠️ prompts.config.ts has no exports. Skipping.');
+                return;
+            }
+            console.log(`📝 Sending ${prompts.length} prompt definitions...`);
+            const requestBody = {
+                prompts,
+                version: config.version,
+                release_channel: config.release_channel,
+                plugin_id: config.plugin_id,
+            };
+            const response = yield fetch(`${config.domain}/release/${release_id}/prompts`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.token}`,
+                },
+                body: JSON.stringify(requestBody),
+            });
+            if (response.ok) {
+                const data = yield response.json();
+                console.log(`✅ Prompts uploaded: ${(_b = (_a = data.prompt_names) === null || _a === void 0 ? void 0 : _a.join(', ')) !== null && _b !== void 0 ? _b : 'ok'}`);
+            }
+            else {
+                const text = yield response.text().catch(() => 'unknown error');
+                throw new Error(`Failed to upload prompts: ${text}`);
+            }
+        }
+        catch (error) {
+            console.error('❌ Error uploading prompts:', error.message);
+            throw error;
+        }
+    });
+}

package/dist/cli/scripts/release/release.js

@@ -23,6 +23,7 @@ import 'dotenv/config';
 import fs from 'fs';
 import path from 'path';
 import dbUpdate from './release-db-update.js';
+import promptsUpload from './release-prompts-upload.js';
 import { uploadDirectory } from './release-file-upload.js';
 import { releasePlugin, sendConfiguration } from './release-config-upload.js';
 // Read version from package.json
@@ -60,8 +61,11 @@ function releaseProcess() {
     return __awaiter(this, void 0, void 0, function* () {
         try {
             console.log(`🚀 Releasing ${config.plugin_id} to ${config.release_channel}...`);
+            console.log(`📡 Deploying to: ${config.domain}`);
             // First send the configuration
             const release_id = yield sendConfiguration(config);
+            // Upload prompts (if prompts.config.ts exists)
+            yield promptsUpload(config, release_id);
             yield dbUpdate(config, release_id);
             // Then upload the files
             yield uploadDirectory(config, release_id);

package/dist/cli/types/DatabaseTypes.d.ts

@@ -8,7 +8,15 @@
  *  2. Add an `updated_at` trigger so the image-sync cron can detect recently
  *     modified entries. The cron derives which columns to scan from release.db_schema.
  */
-type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid' | 'markdown';
+/**
+ * 'vector' is stored as `vector(1536)` in the database (pgvector).
+ * Marking a column as 'vector' causes the migration system to:
+ *  1. Create the column as `vector(1536)` with nullable constraint.
+ *  2. Create an IVFFlat index for cosine similarity search.
+ *  3. The column MUST be named 'embedding' and only one per table is allowed.
+ *  4. Requires `source_column` — the column whose content is embedded async on insert.
+ */
+type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid' | 'markdown' | 'vector';
 /**
  * Foreign key relationship configuration with cascade delete support.
  * Defines a relationship where the source record is deleted when the destination record is deleted.
@@ -22,11 +30,11 @@ interface ForeignKeyRelation {
     on_delete_cascade: boolean;
 }
 /**
- * Database column definition with support for types, constraints, and relationships.
+ * Regular (non-vector) database column definition with support for types, constraints, and relationships.
  */
-export interface DbColumnDefinition {
+interface DbRegularColumnDefinition {
     /** The data type of the column */
-    type: DbColumnType;
+    type: Exclude<DbColumnType, 'vector'>;
     /** Human-readable description of the column's purpose */
     description: string;
     /** Whether the column can contain null values */
@@ -36,6 +44,8 @@ export interface DbColumnDefinition {
     /** Default value for the column. can also use sql functions like now(), auth.uid() or gen_random_uuid() */
     default_value?: string | number | boolean;
     /** Array of allowed values for enumerated columns */
+    /** Not allowed on non-vector columns */
+    source_column?: never;
     /** Foreign key relationship configuration */
     foreign_key?: ForeignKeyRelation;
     /** The name of the column before it was renamed. */
@@ -55,6 +65,39 @@ export interface DbColumnDefinition {
         lang_moderator?: Partial<Omit<DbPermissionDefinition, 'delete'>>;
     };
 }
+/**
+ * Vector column definition for semantic search via pgvector.
+ * The column MUST be named 'embedding' and only one per table is allowed.
+ * The backend generates embeddings asynchronously from the source_column content.
+ */
+interface DbVectorColumnDefinition {
+    /** Must be 'vector' */
+    type: 'vector';
+    /** Human-readable description of the column's purpose */
+    description: string;
+    /** Vector columns must be nullable (embeddings are generated asynchronously) */
+    nullable: true;
+    /** The column whose content is embedded. Must reference an existing column in the same table. */
+    source_column: string;
+    /** Not applicable to vector columns */
+    unique?: never;
+    /** Not applicable to vector columns */
+    default_value?: never;
+    /** Not applicable to vector columns */
+    foreign_key?: never;
+    /** Not applicable to vector columns */
+    old_name?: never;
+    /** Not applicable to vector columns */
+    deprecated?: never;
+    /** Not applicable to vector columns */
+    restrict?: never;
+}
+/**
+ * Database column definition — discriminated union on `type`.
+ * Use `type: 'vector'` for embedding columns (enforces `nullable: true` and requires `source_column`).
+ * All other types forbid `source_column`.
+ */
+export type DbColumnDefinition = DbRegularColumnDefinition | DbVectorColumnDefinition;
 /**
  * Base table structure that all database tables inherit.
  * Includes standard audit fields for tracking creation and ownership.

package/dist/cli/types/PromptTypes.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Formatting options for string array variables when rendered into prompts.
+ */
+export type StringArrayFormat = 'numberedList' | 'bulletpointList' | 'commaList' | 'newlineList';
+/**
+ * Enum variable resolved server-side from a fixed set of values.
+ * Supports conditional prompt text per value.
+ */
+export interface EnumVariable {
+    type: 'enum';
+    values: string[];
+    conditions?: Record<string, string>;
+}
+/**
+ * Numeric variable with min/max bounds.
+ * Supports conditional prompt text per value.
+ */
+export interface NumberVariable {
+    type: 'number';
+    min: number;
+    max: number;
+    conditions?: Record<string, string>;
+}
+/**
+ * Free-text string variable with optional prefix/suffix wrappers.
+ */
+export interface StringVariable {
+    type: 'string';
+    pre?: string;
+    after?: string;
+}
+/**
+ * Array-of-strings variable with optional formatting and prefix/suffix wrappers.
+ */
+export interface StringArrayVariable {
+    type: 'string[]';
+    format?: StringArrayFormat;
+    pre?: string;
+    after?: string;
+}
+/**
+ * UUID variable referencing a backend entity by ID.
+ * The backend resolves the UUID to a formatted string via a registered resolver.
+ * Safe in system instructions because the resolved content is backend-controlled.
+ */
+export interface UuidVariable {
+    type: 'uuid';
+    /** The resolver name that tells the backend how to look up and format this UUID. */
+    resolver: string;
+    pre?: string;
+    after?: string;
+}
+/**
+ * Variables allowed in system instruction blocks.
+ */
+export type SystemVariable = EnumVariable | NumberVariable | UuidVariable;
+/**
+ * Variables allowed in user instruction blocks (superset of system variables).
+ */
+export type UserVariable = SystemVariable | StringVariable | StringArrayVariable;
+/**
+ * A block of prompt text with typed template variables.
+ */
+export interface InstructionBlock<V> {
+    prompt: string;
+    variables?: Record<string, V>;
+}
+/**
+ * A complete prompt definition uploaded to the backend during release.
+ */
+export interface PromptDefinition {
+    name: string;
+    systemInstructions?: InstructionBlock<SystemVariable>;
+    userInstructions?: InstructionBlock<UserVariable>;
+    schema?: Record<string, any>;
+    tools?: any[];
+    model?: string;
+}

package/dist/cli/types/PromptTypes.js

@@ -0,0 +1,3 @@
+// Prompt configuration type definitions
+// Used by plugins in their rimori/prompts.config.ts files
+export {};

package/dist/controller/TranslationController.js

@@ -161,15 +161,13 @@ export class Translator {
                 if (!this.ai || this.currentLanguage === 'en')
                     return text;
                 const response = yield this.ai.getObject({
-                    systemPrompt: 'You are a translation engine. Return only the translated text.' + additionalInstructions,
-                    userPrompt: `Translate the following text into ${this.currentLanguage}: ${text}`,
-                    cache: true,
-                    responseSchema: {
-                        translation: {
-                            type: 'string',
-                            description: `The translation of the input text into ${this.currentLanguage}.`,
-                        },
+                    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) {

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './plugin/RimoriClient';
 export * from './fromRimori/PluginTypes';
 export * from './plugin/StandaloneClient';
 export * from './cli/types/DatabaseTypes';
+export * from './cli/types/PromptTypes';
 export * from './plugin/TTS/MessageSender';
 export * from './utils/difficultyConverter';
 export * from './plugin/CommunicationHandler';

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './plugin/RimoriClient';
 export * from './fromRimori/PluginTypes';
 export * from './plugin/StandaloneClient';
 export * from './cli/types/DatabaseTypes';
+export * from './cli/types/PromptTypes';
 export * from './plugin/TTS/MessageSender';
 export * from './utils/difficultyConverter';
 export * from './plugin/CommunicationHandler';

package/dist/plugin/RimoriClient.js

@@ -31,7 +31,7 @@ export class RimoriClient {
         };
         this.rimoriInfo = info;
         this.sharedContent = new SharedContentController(supabase, this);
-        this.ai = new AIModule(info.backendUrl, () => this.rimoriInfo.token);
+        this.ai = new AIModule(info.backendUrl, () => this.rimoriInfo.token, info.pluginId);
         this.ai.setOnRateLimited((exercisesRemaining) => {
             EventBus.emit(info.pluginId, 'global.quota.triggerExceeded', { exercises_remaining: exercisesRemaining });
         });

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

@@ -44,11 +44,13 @@ export interface ObjectRequest {
      * High level instructions for the AI to follow. Behaviour, tone, restrictions, etc.
      * Example: "Act like a recipe writer."
      */
+    /** @deprecated Use server-side prompt definitions (prompt + variables) instead of building requests client-side. */
     behaviour?: string;
     /**
      * The specific instruction for the AI to follow.
      * Example: "Generate a recipe using chicken, rice and vegetables."
      */
+    /** @deprecated Use server-side prompt definitions (prompt + variables) instead of building requests client-side. */
     instructions: string;
 }
 /**
@@ -58,9 +60,16 @@ export interface ObjectRequest {
 export declare class AIModule {
     private getToken;
     private backendUrl;
+    private pluginId;
     private sessionTokenId;
     private onRateLimitedCb?;
-    constructor(backendUrl: string, getToken: () => string);
+    constructor(backendUrl: string, getToken: () => string, pluginId?: string);
+    /**
+     * Resolves a prompt name following the event naming convention:
+     * - 2-segment names (e.g. 'storytelling.story') get prefixed with pluginId → '<pluginId>.storytelling.story'
+     * - 3+ segment names starting with 'global.' (e.g. 'global.translator.translate') are sent as-is
+     */
+    private resolvePromptName;
     /** Exercise session management. */
     readonly session: {
         /** Returns the current exercise session token ID (null if no active session). */
@@ -94,7 +103,9 @@ export declare class AIModule {
      * @param cache Whether to cache the result (default: false).
      * @param model The model to use for generation.
      */
-    getSteamedText(messages: Message[], onMessage: OnLLMResponse, tools?: Tool[], cache?: boolean, model?: string, knowledgeId?: string): Promise<string>;
+    getSteamedText(messages: Message[], onMessage: OnLLMResponse, tools?: Tool[], cache?: boolean, model?: string, 
+    /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
+    knowledgeId?: string, prompt?: string, variables?: Record<string, any>): Promise<string>;
     /**
      * Generate voice audio from text using AI.
      * @param text The text to convert to voice.
@@ -112,48 +123,56 @@ export declare class AIModule {
      * @returns The transcribed text.
      */
     getTextFromVoice(file: Blob, language?: Language): Promise<string>;
+    /** @deprecated Used by legacy client-side prompt path. Will be removed once all plugins migrate to server-side prompt definitions. */
     private getChatMessage;
     /**
      * Generate a structured object from a request using AI.
-     * @param request The object generation request.
-     * @param request.systemPrompt The system prompt to use for generation.
-     * @param request.responseSchema The response schema to use for generation.
-     * @param request.userPrompt The user prompt to use for generation.
      * @param request.cache Whether to cache the result (default: false).
      * @param request.tools The tools to use for generation.
      * @param request.model The model to use for generation.
+     * @param request.prompt Server-side prompt name (e.g. 'writing.analysis').
+     * @param request.variables Variables for the server-side prompt template.
      * @returns The generated object.
      */
     getObject<T = any>(params: {
-        systemPrompt: string;
-        responseSchema: AIObjectTool;
+        /** @deprecated Use prompt + variables instead of client-side system prompts. */
+        systemPrompt?: string;
+        /** @deprecated Use prompt + variables instead. Schema is loaded server-side from the prompt definition. */
+        responseSchema?: AIObjectTool;
+        /** @deprecated Use prompt + variables instead of client-side user prompts. */
         userPrompt?: string;
         cache?: boolean;
         tools?: Tool[];
         model?: string;
+        /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
         knowledgeId?: string;
+        prompt?: string;
+        variables?: Record<string, any>;
     }): Promise<T>;
     /**
      * Generate a streamed structured object from a request using AI.
-     * @param request The object generation request.
-     * @param request.systemPrompt The system prompt to use for generation.
-     * @param request.responseSchema The response schema to use for generation.
-     * @param request.userPrompt The user prompt to use for generation.
      * @param request.onResult Callback for each result chunk.
      * @param request.cache Whether to cache the result (default: false).
      * @param request.tools The tools to use for generation.
      * @param request.model The model to use for generation.
-     * @param request.knowledgeId Optional knowledge entry ID to ground AI content in real facts.
+     * @param request.prompt Server-side prompt name (e.g. 'writing.analysis').
+     * @param request.variables Variables for the server-side prompt template.
      */
     getStreamedObject<T = any>(params: {
-        systemPrompt: string;
-        responseSchema: AIObjectTool;
+        /** @deprecated Use prompt + variables instead of client-side system prompts. */
+        systemPrompt?: string;
+        /** @deprecated Use prompt + variables instead. Schema is loaded server-side from the prompt definition. */
+        responseSchema?: AIObjectTool;
+        /** @deprecated Use prompt + variables instead of client-side user prompts. */
         userPrompt?: string;
         onResult: OnStreamedObjectResult<T>;
         cache?: boolean;
         tools?: Tool[];
         model?: string;
+        /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
         knowledgeId?: string;
+        prompt?: string;
+        variables?: Record<string, any>;
     }): Promise<T>;
     private streamObject;
     private sendToolResult;

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) {
+    constructor(backendUrl, getToken, pluginId) {
         this.sessionTokenId = null;
         /** Exercise session management. */
         this.session = {
@@ -53,6 +53,21 @@ export class AIModule {
         };
         this.backendUrl = backendUrl;
         this.getToken = getToken;
+        this.pluginId = pluginId;
+    }
+    /**
+     * Resolves a prompt name following the event naming convention:
+     * - 2-segment names (e.g. 'storytelling.story') get prefixed with pluginId → '<pluginId>.storytelling.story'
+     * - 3+ segment names starting with 'global.' (e.g. 'global.translator.translate') are sent as-is
+     */
+    resolvePromptName(name) {
+        if (name.startsWith('global.'))
+            return name;
+        const segments = name.split('.');
+        if (segments.length === 2 && this.pluginId) {
+            return `${this.pluginId}.${name}`;
+        }
+        return name;
     }
     /** Registers a callback invoked whenever a 429 rate-limit response is received. */
     setOnRateLimited(cb) {
@@ -73,11 +88,6 @@ export class AIModule {
                 tools,
                 model,
                 messages,
-                responseSchema: {
-                    result: {
-                        type: 'string',
-                    },
-                },
             });
             return result;
         });
@@ -91,7 +101,9 @@ export class AIModule {
      * @param model The model to use for generation.
      */
     getSteamedText(messages_1, onMessage_1, tools_1) {
-        return __awaiter(this, arguments, void 0, function* (messages, onMessage, tools, cache = false, model, knowledgeId) {
+        return __awaiter(this, arguments, void 0, function* (messages, onMessage, tools, cache = false, model, 
+        /** @deprecated Use uuid variable with resolver 'knowledgeEntry' in prompt definitions instead. */
+        knowledgeId, prompt, variables) {
             const messageId = Math.random().toString(36).substring(3);
             const { result } = yield this.streamObject({
                 cache,
@@ -99,11 +111,8 @@ export class AIModule {
                 model,
                 messages,
                 knowledgeId,
-                responseSchema: {
-                    result: {
-                        type: 'string',
-                    },
-                },
+                prompt,
+                variables,
                 onResult: ({ result }) => onMessage(messageId, result, false),
             });
             onMessage(messageId, result, true);
@@ -129,7 +138,15 @@ export class AIModule {
                     'Content-Type': 'application/json',
                     Authorization: `Bearer ${this.getToken()}`,
                 },
-                body: JSON.stringify({ input: text, voice, speed, language, cache, instructions, session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined }),
+                body: JSON.stringify({
+                    input: text,
+                    voice,
+                    speed,
+                    language,
+                    cache,
+                    instructions,
+                    session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined,
+                }),
             }).then((r) => r.blob());
         });
     }
@@ -162,6 +179,7 @@ export class AIModule {
             });
         });
     }
+    /** @deprecated Used by legacy client-side prompt path. Will be removed once all plugins migrate to server-side prompt definitions. */
     getChatMessage(systemPrompt, userPrompt) {
         const messages = [{ role: 'system', content: systemPrompt }];
         if (userPrompt) {
@@ -171,70 +189,75 @@ export class AIModule {
     }
     /**
      * Generate a structured object from a request using AI.
-     * @param request The object generation request.
-     * @param request.systemPrompt The system prompt to use for generation.
-     * @param request.responseSchema The response schema to use for generation.
-     * @param request.userPrompt The user prompt to use for generation.
      * @param request.cache Whether to cache the result (default: false).
      * @param request.tools The tools to use for generation.
      * @param request.model The model to use for generation.
+     * @param request.prompt Server-side prompt name (e.g. 'writing.analysis').
+     * @param request.variables Variables for the server-side prompt template.
      * @returns The generated object.
      */
     getObject(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { systemPrompt, responseSchema, userPrompt, cache = false, tools = [], model = undefined, knowledgeId, } = params;
+            const { systemPrompt, responseSchema, userPrompt, cache = false, tools = [], model = undefined, knowledgeId, prompt, variables, } = params;
             return yield this.streamObject({
                 responseSchema,
-                messages: this.getChatMessage(systemPrompt, userPrompt),
+                messages: systemPrompt ? this.getChatMessage(systemPrompt, userPrompt) : [],
                 cache,
                 tools,
                 model,
                 knowledgeId,
+                prompt,
+                variables,
             });
         });
     }
     /**
      * Generate a streamed structured object from a request using AI.
-     * @param request The object generation request.
-     * @param request.systemPrompt The system prompt to use for generation.
-     * @param request.responseSchema The response schema to use for generation.
-     * @param request.userPrompt The user prompt to use for generation.
      * @param request.onResult Callback for each result chunk.
      * @param request.cache Whether to cache the result (default: false).
      * @param request.tools The tools to use for generation.
      * @param request.model The model to use for generation.
-     * @param request.knowledgeId Optional knowledge entry ID to ground AI content in real facts.
+     * @param request.prompt Server-side prompt name (e.g. 'writing.analysis').
+     * @param request.variables Variables for the server-side prompt template.
      */
     getStreamedObject(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { systemPrompt, responseSchema, userPrompt, onResult, cache = false, tools = [], model = undefined, knowledgeId, } = params;
+            const { systemPrompt, responseSchema, userPrompt, onResult, cache = false, tools = [], model = undefined, knowledgeId, prompt, variables, } = params;
             return yield this.streamObject({
                 responseSchema,
-                messages: this.getChatMessage(systemPrompt, userPrompt),
+                messages: systemPrompt ? this.getChatMessage(systemPrompt, userPrompt) : [],
                 onResult,
                 cache,
                 tools,
                 model,
                 knowledgeId,
+                prompt,
+                variables,
             });
         });
     }
     streamObject(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e;
-            const { messages, responseSchema, onResult = () => null, cache = false, tools = [], model = undefined, knowledgeId, } = params;
+            const { messages, responseSchema, onResult = () => null, cache = false, tools = [], model = undefined, knowledgeId, prompt, variables, } = params;
             const chatMessages = messages.map((message, index) => (Object.assign(Object.assign({}, message), { id: `${index + 1}` })));
+            const payload = {
+                cache,
+                tools,
+                stream: true,
+                messages: chatMessages,
+                model,
+                knowledge_id: knowledgeId,
+                session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined,
+            };
+            if (prompt) {
+                payload.prompt = { name: this.resolvePromptName(prompt), variables: variables !== null && variables !== void 0 ? variables : {} };
+            }
+            if (responseSchema) {
+                payload.responseSchema = responseSchema;
+            }
             const response = yield fetch(`${this.backendUrl}/ai/llm`, {
-                body: JSON.stringify({
-                    cache,
-                    tools,
-                    stream: true,
-                    responseSchema,
-                    messages: chatMessages,
-                    model,
-                    knowledge_id: knowledgeId,
-                    session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined,
-                }),
+                body: JSON.stringify(payload),
                 method: 'POST',
                 headers: { Authorization: `Bearer ${this.getToken()}`, 'Content-Type': 'application/json' },
             });
@@ -300,6 +323,21 @@ export class AIModule {
                         }
                         continue;
                     }
+                    // Handle debug: line (prompt resolution debug info, dev/local only)
+                    if (line.startsWith('debug:')) {
+                        try {
+                            const debug = JSON.parse(line.slice(6).trim());
+                            console.group(`[Rimori Prompt] ${debug.promptName}`);
+                            console.log('System prompt:\n', debug.system);
+                            console.log('User prompt:\n', debug.user);
+                            console.log('Variables:', debug.variables);
+                            console.groupEnd();
+                        }
+                        catch (_g) {
+                            // Ignore malformed debug lines
+                        }
+                        continue;
+                    }
                     const command = line.substring(0, 5);
                     const dataStr = line.substring(5).trim();
                     if (dataStr === '[DONE]') {

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

@@ -25,6 +25,21 @@ export type PublicityLevel = 'own' | 'guild' | 'lang';
  * Database module for plugin database operations.
  * Provides access to plugin tables with automatic prefixing and schema management.
  */
+export interface VectorSearchParams {
+    /** Table name without plugin prefix (e.g. 'pages') */
+    tableName: string;
+    /** The text query to search for */
+    query: string;
+    /** Maximum number of results (default: 5) */
+    limit?: number;
+    /** Similarity threshold 0-1 (default: 0.5) */
+    threshold?: number;
+    /** Which columns to return (default: all) */
+    selectColumns?: string[];
+}
+export type VectorSearchResult<T = Record<string, unknown>> = Array<T & {
+    similarity: number;
+}>;
 export declare class DbModule {
     private supabase;
     private rimoriInfo;
@@ -63,5 +78,12 @@ export declare class DbModule {
      * @param publicity The desired publicity level
      */
     setPublicity(table: string, entryId: string, publicity: PublicityLevel): Promise<void>;
+    /**
+     * Search a plugin table using vector similarity (cosine distance).
+     * The table must have a vector column named 'embedding' defined in db.config.ts.
+     * @param params Search parameters
+     * @returns Matching rows sorted by similarity
+     */
+    vectorSearch<T = Record<string, unknown>>(params: VectorSearchParams): Promise<VectorSearchResult<T>>;
 }
 export {};

package/dist/plugin/module/DbModule.js

@@ -7,10 +7,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-/**
- * Database module for plugin database operations.
- * Provides access to plugin tables with automatic prefixing and schema management.
- */
 export class DbModule {
     constructor(supabase, communicationHandler, info) {
         this.supabase = supabase;
@@ -86,4 +82,26 @@ export class DbModule {
             });
         });
     }
+    /**
+     * Search a plugin table using vector similarity (cosine distance).
+     * The table must have a vector column named 'embedding' defined in db.config.ts.
+     * @param params Search parameters
+     * @returns Matching rows sorted by similarity
+     */
+    vectorSearch(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield fetch(`${this.rimoriInfo.backendUrl}/plugin-search/vector-search`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.rimoriInfo.token}`,
+                },
+                body: JSON.stringify(params),
+            });
+            if (!response.ok) {
+                throw new Error(`Vector search failed: ${response.statusText}`);
+            }
+            return yield response.json();
+        });
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/client",
-  "version": "2.5.26-next.1",
+  "version": "2.5.26-next.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
@@ -31,7 +31,7 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc -w  --preserveWatchOutput",
+    "dev": "git pull && tsc -w  --preserveWatchOutput",
     "lint": "eslint . --fix",
     "format": "prettier --write ."
   },