briyah 1.1.3 → 1.1.5

package/README.md

@@ -1,6 +1,19 @@
 # Briyah SDK
 
-The Briyah SDK provides a clean, easy-to-use interface for integrating the Briyah multi-agent AI system into your applications without requiring NestJS dependency injection setup.
+Briyah is an SDK for AI agents, multi-agent rooms, and interactive stories. It wraps the Briyah runtime as a single class with per-user data isolation and balance tracking, and supports Anthropic, OpenAI, Google, Grok, DeepSeek, Together, and Fal as LLM providers.
+
+What's in the package:
+
+- **Agents.** AI agents with a system prompt, persistent conversation history, attached documents, and per-call cost and token tracking. Histories can be summarized/compacted or cleared.
+- **Rooms.** Multi-agent conversations with a shared goal. Agents exchange messages at different visibility levels (speak, whisper, think, shout), draft and approve shared artifacts, and a moderator can route turns.
+- **Stories.** Text-based interactive fiction with a narrator, AI-played characters, and a human player. Stories progress through chapters and can introduce new characters mid-game. Story events (state updates, character suggestions, chapter transitions, errors) are delivered through an emitter the host app subscribes to.
+- **Text processing.** One-shot `processText` for non-conversational use, with cost and token counts on the result.
+- **File attachments.** Attach documents to agents as context. Supported file types vary by LLM provider.
+- **Per-user data.** Agents, rooms, stories, attached files, balances, and transactions are scoped to a userId the host controls. Per-user directories keep state isolated.
+- **Balances and transactions.** Track per-user balances against usage cost. Record pending, succeeded, failed, or cancelled transactions when integrating with a payment provider, credit balances on webhook confirmation, and resume stories that paused on insufficient funds. Briyah does not process payments itself.
+- **Real-time event emitters.** Story-state and balance updates can be forwarded to SSE or websockets.
+
+State is persisted as JSON files under a configurable data path; no external database is required.
 
 ## Installation
 

package/data/common/config/image_models.json

@@ -11,5 +11,11 @@
     "description": "Mediocre quality; some character consistency",
     "service": "OpenAI",
     "model": "gpt-image-1-mini"
+  },
+  {
+    "name": "No images",
+    "description": "Disable image generation (no real API calls)",
+    "service": "",
+    "model": ""
   }
 ]

package/data/common/config/markup

@@ -1 +1 @@
-1.6219859999999993
+11.330019880000021

package/data/common/config/story_models.json

@@ -26,6 +26,13 @@
     "service": "Grok",
     "model": "grok-4.20-0309-reasoning",
     "cost": "300"
+  },
+  {
+    "name": "Mock",
+    "description": "Mock LLM for testing (no real API calls)",
+    "service": "Mock",
+    "model": "mock-fast-v1",
+    "cost": "0"
   }
 
 ]

package/dist-sdk/server/src/ai/LLM/anthropic.service.js

@@ -155,11 +155,14 @@ let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.Base
         const systemBlocks = [];
         if (instructionText)
             systemBlocks.push({ type: 'text', text: instructionText });
-        systemBlocks.push({
+        const identityBlock = {
             type: 'text',
             text: `Your agent identity is ${agent.agentName}: ${agent.description}`,
-            cache_control: cacheConfig,
-        });
+        };
+        if (cacheConfig) {
+            identityBlock.cache_control = cacheConfig;
+        }
+        systemBlocks.push(identityBlock);
         const messageHistory = agent.history.map((msg) => ({
             role: msg.role,
             content: [{ type: 'text', text: msg.content }],

package/dist-sdk/server/src/ai/LLM/base-ai.service.js

@@ -151,7 +151,8 @@ let BaseAiService = class BaseAiService {
         if (!agentName) {
             throw new Error('Agent name is required');
         }
-        if (!(0, model_prices_1.isKnownModel)(modelName, this.getModelPricePrefix())) {
+        if (this.getServiceName() !== 'Mock' &&
+            !(0, model_prices_1.isKnownModel)(modelName, this.getModelPricePrefix())) {
             throw new Error(`Model '${modelName}' is not listed in model_prices.json for ${this.getServiceName()}. ` +
                 `Add a pricing entry before using this model.`);
         }

package/dist-sdk/server/src/app.controller.d.ts

@@ -4,13 +4,15 @@ import { Observable } from 'rxjs';
 import { UserServiceManager } from './app/user-service-manager';
 import { PublishedAgentsService } from './ai/published-agents.service';
 import { PublishedRoomsService } from './room/published-rooms.service';
-import { AgentInfo, CreateAgentResponse, UpdateAgentRequest, RoomInfo, RoomDetails, CreateRoomResponse, AgentMessagesResponse, RoomMessagesResponse, FileList, PromptFileContent, PromptFoldersResponse, PromptFilesResponse, PromptScope, CreatePromptFolderRequest, CreatePromptFileRequest, UpdatePromptFileRequest, ProcessTextResponse, PreparedPromptResponse, AttachDocumentResponse, StoryInfo, StoryState, Character, ModelInfo, StoryModelDefaults, ChapterInfo, StoryIdea } from '../../shared/types/app.types';
+import { LibraryService } from './library/library.service';
+import { AgentInfo, CreateAgentResponse, UpdateAgentRequest, RoomInfo, RoomDetails, CreateRoomResponse, AgentMessagesResponse, RoomMessagesResponse, FileList, PromptFileContent, PromptFoldersResponse, PromptFilesResponse, PromptScope, CreatePromptFolderRequest, CreatePromptFileRequest, UpdatePromptFileRequest, ProcessTextResponse, PreparedPromptResponse, AttachDocumentResponse, StoryInfo, StoryState, Character, ModelInfo, StoryModelDefaults, ChapterInfo, StoryIdea, LibraryPromptsResponse, LibraryFilesResponse, LibraryFileContent, LibraryDefaultUrlResponse, CopyFromLibraryRequest } from '../../shared/types/app.types';
 import { RoomMessage } from './room/message';
 export declare class AppController {
     private readonly userServiceManager;
     private readonly publishedAgentsService;
     private readonly publishedRoomsService;
-    constructor(userServiceManager: UserServiceManager, publishedAgentsService: PublishedAgentsService, publishedRoomsService: PublishedRoomsService);
+    private readonly libraryService;
+    constructor(userServiceManager: UserServiceManager, publishedAgentsService: PublishedAgentsService, publishedRoomsService: PublishedRoomsService, libraryService: LibraryService);
     private getAppService;
     listServices(req: ExpressRequest): string[];
     listModels(req: ExpressRequest, aiServiceName: string): Promise<ModelInfo[]>;
@@ -44,6 +46,13 @@ export declare class AppController {
     createPromptFile(req: ExpressRequest, folderName: string, body: CreatePromptFileRequest): Promise<void>;
     updatePromptFile(req: ExpressRequest, folderName: string, fileName: string, body: UpdatePromptFileRequest): Promise<void>;
     deletePromptFile(req: ExpressRequest, folderName: string, fileName: string): Promise<void>;
+    listLibraryPrompts(): LibraryPromptsResponse;
+    listLibraryFiles(folder: string): LibraryFilesResponse;
+    getLibraryFile(folder: string, file: string): LibraryFileContent;
+    getLibraryDefaultUrl(): LibraryDefaultUrlResponse;
+    proxyListRemote(url: string): Promise<LibraryPromptsResponse>;
+    proxyPreviewRemote(url: string, folder: string): Promise<LibraryFileContent>;
+    copyPromptFromLibrary(req: ExpressRequest, body: CopyFromLibraryRequest): Promise<void>;
     listPromptFolders(req: ExpressRequest): string[];
     listPrompts(req: ExpressRequest, agentId: string): string[];
     runPreparedPrompt(req: ExpressRequest, agentId: string, promptName: string, body: {

package/dist-sdk/server/src/app.controller.js

@@ -50,11 +50,13 @@ const common_1 = require("@nestjs/common");
 const platform_express_1 = require("@nestjs/platform-express");
 const rxjs_1 = require("rxjs");
 const jwt_auth_guard_1 = require("./auth/jwt-auth.guard");
+const public_decorator_1 = require("./auth/public.decorator");
 const agent_access_decorator_1 = require("./auth/agent-access.decorator");
 const room_access_decorator_1 = require("./auth/room-access.decorator");
 const user_service_manager_1 = require("./app/user-service-manager");
 const published_agents_service_1 = require("./ai/published-agents.service");
 const published_rooms_service_1 = require("./room/published-rooms.service");
+const library_service_1 = require("./library/library.service");
 const errors_1 = require("./common/errors");
 const path = __importStar(require("path"));
 const logger_1 = require("./common/logger");
@@ -62,10 +64,12 @@ let AppController = class AppController {
     userServiceManager;
     publishedAgentsService;
     publishedRoomsService;
-    constructor(userServiceManager, publishedAgentsService, publishedRoomsService) {
+    libraryService;
+    constructor(userServiceManager, publishedAgentsService, publishedRoomsService, libraryService) {
         this.userServiceManager = userServiceManager;
         this.publishedAgentsService = publishedAgentsService;
         this.publishedRoomsService = publishedRoomsService;
+        this.libraryService = libraryService;
     }
     getAppService(req, agentId, roomId) {
         let userId;
@@ -345,6 +349,105 @@ let AppController = class AppController {
             throw new common_1.HttpException('Failed to delete prompt file', common_1.HttpStatus.INTERNAL_SERVER_ERROR);
         }
     }
+    listLibraryPrompts() {
+        return { prompts: this.libraryService.listLocalPrompts() };
+    }
+    listLibraryFiles(folder) {
+        try {
+            return { files: this.libraryService.listLocalFiles(folder) };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            if (error instanceof errors_1.NotFoundError) {
+                throw new common_1.NotFoundException(error.message);
+            }
+            throw error;
+        }
+    }
+    getLibraryFile(folder, file) {
+        try {
+            return { content: this.libraryService.getLocalFileContent(folder, file) };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            if (error instanceof errors_1.NotFoundError) {
+                throw new common_1.NotFoundException(error.message);
+            }
+            throw error;
+        }
+    }
+    getLibraryDefaultUrl() {
+        return { url: process.env.WEB_URL ?? '' };
+    }
+    async proxyListRemote(url) {
+        if (!url)
+            throw new common_1.BadRequestException('url query param is required');
+        try {
+            return { prompts: await this.libraryService.listRemotePrompts(url) };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            if (error instanceof errors_1.NotFoundError) {
+                throw new common_1.NotFoundException(error.message);
+            }
+            if (error instanceof errors_1.RemoteFetchError) {
+                throw new common_1.HttpException(error.message, common_1.HttpStatus.BAD_GATEWAY);
+            }
+            throw error;
+        }
+    }
+    async proxyPreviewRemote(url, folder) {
+        if (!url)
+            throw new common_1.BadRequestException('url query param is required');
+        try {
+            return {
+                content: await this.libraryService.getRemoteFileContent(url, folder, 'system_instruction.prompt'),
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            if (error instanceof errors_1.NotFoundError) {
+                throw new common_1.NotFoundException(error.message);
+            }
+            if (error instanceof errors_1.RemoteFetchError) {
+                throw new common_1.HttpException(error.message, common_1.HttpStatus.BAD_GATEWAY);
+            }
+            throw error;
+        }
+    }
+    async copyPromptFromLibrary(req, body) {
+        if (!body?.url || !body?.folder) {
+            throw new common_1.BadRequestException('url and folder are required');
+        }
+        const appService = this.getAppService(req);
+        try {
+            await this.libraryService.copyFromRemote(body.url, body.folder, appService.getUserPromptsDir());
+        }
+        catch (error) {
+            logger_1.logger.error(`[${req.user?.sub}] Error copying library prompt ${body.folder} from ${body.url}:`, error);
+            if (error instanceof errors_1.ValidationError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            if (error instanceof errors_1.NotFoundError) {
+                throw new common_1.NotFoundException(error.message);
+            }
+            if (error instanceof errors_1.RemoteFetchError) {
+                throw new common_1.HttpException(error.message, common_1.HttpStatus.BAD_GATEWAY);
+            }
+            if (error instanceof errors_1.OperationFailedError) {
+                throw new common_1.HttpException(error.message, common_1.HttpStatus.CONFLICT);
+            }
+            throw error;
+        }
+    }
     listPromptFolders(req) {
         try {
             const appService = this.getAppService(req);
@@ -556,6 +659,9 @@ let AppController = class AppController {
         if (!body.publishedAgentName) {
             throw new common_1.BadRequestException('publishedAgentName field is required');
         }
+        if (body.publishedAgentName.length > 200) {
+            throw new common_1.BadRequestException('publishedAgentName too long (max 200 characters)');
+        }
         try {
             const appService = this.getAppService(req);
             const result = await appService.publishAgentInstance(agentId, body.publishedAgentName);
@@ -875,6 +981,9 @@ let AppController = class AppController {
         }
     }
     async publishRoom(req, templateId, body) {
+        if (body.publishedName && body.publishedName.length > 200) {
+            throw new common_1.BadRequestException('publishedName too long (max 200 characters)');
+        }
         try {
             const appService = this.getAppService(req);
             const userId = req.user.sub;
@@ -1493,7 +1602,7 @@ let AppController = class AppController {
         if (!roomDetails) {
             throw new common_1.NotFoundException(`Room ${roomId} not found`);
         }
-        appService.ensureRoomStateCallback(roomId);
+        await appService.ensureRoomStateCallback(roomId);
         const emitter = appService.getRoomMessageEmitter(roomId);
         return new rxjs_1.Observable((subscriber) => {
             const updateHandler = (data) => {
@@ -1834,6 +1943,60 @@ __decorate([
     __metadata("design:paramtypes", [Object, String, String]),
     __metadata("design:returntype", Promise)
 ], AppController.prototype, "deletePromptFile", null);
+__decorate([
+    (0, common_1.Get)('library/prompts'),
+    (0, public_decorator_1.Public)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], AppController.prototype, "listLibraryPrompts", null);
+__decorate([
+    (0, common_1.Get)('library/prompts/:folder/files'),
+    (0, public_decorator_1.Public)(),
+    __param(0, (0, common_1.Param)('folder')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Object)
+], AppController.prototype, "listLibraryFiles", null);
+__decorate([
+    (0, common_1.Get)('library/prompts/:folder/files/:file'),
+    (0, public_decorator_1.Public)(),
+    __param(0, (0, common_1.Param)('folder')),
+    __param(1, (0, common_1.Param)('file')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Object)
+], AppController.prototype, "getLibraryFile", null);
+__decorate([
+    (0, common_1.Get)('library/default-url'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], AppController.prototype, "getLibraryDefaultUrl", null);
+__decorate([
+    (0, common_1.Get)('library/proxy/prompts'),
+    __param(0, (0, common_1.Query)('url')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AppController.prototype, "proxyListRemote", null);
+__decorate([
+    (0, common_1.Get)('library/proxy/prompts/:folder/preview'),
+    __param(0, (0, common_1.Query)('url')),
+    __param(1, (0, common_1.Param)('folder')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], AppController.prototype, "proxyPreviewRemote", null);
+__decorate([
+    (0, common_1.Post)('prompts/from-library'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.CREATED),
+    __param(0, (0, common_1.Request)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AppController.prototype, "copyPromptFromLibrary", null);
 __decorate([
     (0, common_1.Get)('list-prompt-folders'),
     __param(0, (0, common_1.Request)()),
@@ -2578,5 +2741,6 @@ exports.AppController = AppController = __decorate([
     (0, common_1.UseGuards)(jwt_auth_guard_1.JwtAuthGuard),
     __metadata("design:paramtypes", [user_service_manager_1.UserServiceManager,
         published_agents_service_1.PublishedAgentsService,
-        published_rooms_service_1.PublishedRoomsService])
+        published_rooms_service_1.PublishedRoomsService,
+        library_service_1.LibraryService])
 ], AppController);

package/dist-sdk/server/src/app.service.d.ts

@@ -95,6 +95,7 @@ export declare class AppService {
         artifacts: any[];
     }>;
     publishArtifact(roomId: string, name: string, creator: string, body: string, viewers?: string[]): Promise<void>;
+    getUserPromptsDir(): string;
     createPromptFolder(folderName: string): void;
     deletePromptFolder(folderName: string): void;
     updateAgent(agentId: string, updates: {

package/dist-sdk/server/src/app.service.js

@@ -271,9 +271,7 @@ class AppService {
         if (!agent) {
             throw new errors_1.NotFoundError(`Agent with ID ${agentId} not found`);
         }
-        const serviceName = agent.serviceName;
-        let service = this.getAiServiceFromServiceName(serviceName);
-        const result = await service.preparedPrompt(agent, promptName, variables || {}, true);
+        const result = await agent.preparedPrompt(promptName, variables || {}, true);
         return { result };
     }
     async listAgents() {
@@ -780,6 +778,9 @@ class AppService {
             throw new errors_1.OperationFailedError('Artifact name is required');
         room.publishArtifact(name, creator, body, viewers);
     }
+    getUserPromptsDir() {
+        return this.configService.getUserPromptsDir();
+    }
     createPromptFolder(folderName) {
         const targetDir = path.join(this.configService.getUserPromptsDir(), folderName);
         if (fs.existsSync(targetDir)) {
@@ -1033,7 +1034,7 @@ class AppService {
             logger_1.logger.warn('Cannot set up SSE callback for room without ID');
             return;
         }
-        room.setOnStateChange(() => {
+        room.setOnStateChange('app-service', () => {
             const messages = room.getLatestRoomMessages(0, false);
             const latestMessage = messages.length > 0 ? messages[messages.length - 1] : undefined;
             const totalCost = room
@@ -1222,18 +1223,29 @@ class AppService {
     async convertLargePdfInBackground(artifactId, name, pdfDoc) {
         const pageCount = pdfDoc.getPageCount();
         logger_1.logger.log(`Converting large PDF with ${pageCount} pages concurrently for artifact ${artifactId}`);
+        const perPageTimeoutMs = Number(process.env.PDF_CONVERT_PAGE_TIMEOUT_MS) || 2 * 60 * 1000;
         try {
             const conversionPromises = Array.from({ length: pageCount }, (_, pageIndex) => {
                 const pageNum = pageIndex + 1;
                 logger_1.logger.log(`Starting conversion for page ${pageNum}/${pageCount} for artifact ${artifactId}`);
-                return this.convertSinglePagePDF(pdfDoc, pageIndex)
-                    .then((pageResponse) => ({
-                    pageNum,
-                    success: true,
-                    cost: pageResponse.cost,
-                    content: `**[Page ${pageNum}]**  \n${pageResponse.markdownContent}  \n`,
-                }))
+                let timeoutHandle;
+                const timeoutPromise = new Promise((_, reject) => {
+                    timeoutHandle = setTimeout(() => {
+                        reject(new Error(`Timed out after ${perPageTimeoutMs}ms waiting for page ${pageNum}`));
+                    }, perPageTimeoutMs);
+                });
+                return Promise.race([this.convertSinglePagePDF(pdfDoc, pageIndex), timeoutPromise])
+                    .then((pageResponse) => {
+                    clearTimeout(timeoutHandle);
+                    return {
+                        pageNum,
+                        success: true,
+                        cost: pageResponse.cost,
+                        content: `**[Page ${pageNum}]**  \n${pageResponse.markdownContent}  \n`,
+                    };
+                })
                     .catch((pageError) => {
+                    clearTimeout(timeoutHandle);
                     logger_1.logger.error(`Error converting page ${pageNum}:`, pageError);
                     return {
                         pageNum,

package/dist-sdk/server/src/auth/users.service.js

@@ -46,7 +46,7 @@ exports.UsersService = void 0;
 const common_1 = require("@nestjs/common");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const uuid_1 = require("uuid");
+const crypto_1 = require("crypto");
 const logger_1 = require("../common/logger");
 let UsersService = class UsersService {
     usersFilePath;
@@ -80,7 +80,7 @@ let UsersService = class UsersService {
         fs.writeFileSync(this.usersFilePath, JSON.stringify(users, null, 2), 'utf-8');
     }
     generateUserId() {
-        return (0, uuid_1.v4)();
+        return (0, crypto_1.randomUUID)();
     }
     createUser(phoneNumber) {
         const users = this.loadUsers();

package/dist-sdk/server/src/common/errors.d.ts

@@ -7,6 +7,9 @@ export declare class ValidationError extends Error {
 export declare class OperationFailedError extends Error {
     constructor(message: string);
 }
+export declare class RemoteFetchError extends Error {
+    constructor(message: string);
+}
 export declare class InsufficientBalanceError extends Error {
     constructor(message: string);
 }

package/dist-sdk/server/src/common/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InsufficientBalanceError = exports.OperationFailedError = exports.ValidationError = exports.NotFoundError = void 0;
+exports.InsufficientBalanceError = exports.RemoteFetchError = exports.OperationFailedError = exports.ValidationError = exports.NotFoundError = void 0;
 class NotFoundError extends Error {
     constructor(message) {
         super(message);
@@ -31,6 +31,16 @@ class OperationFailedError extends Error {
     }
 }
 exports.OperationFailedError = OperationFailedError;
+class RemoteFetchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RemoteFetchError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RemoteFetchError);
+        }
+    }
+}
+exports.RemoteFetchError = RemoteFetchError;
 class InsufficientBalanceError extends Error {
     constructor(message) {
         super(message);

package/dist-sdk/server/src/config/configuration.service.d.ts

@@ -2,6 +2,7 @@ export declare class ConfigurationService {
     private dataDir;
     private promptsDir;
     private commonPromptsDir;
+    private commonLibraryDir;
     private userPromptsDir;
     private uploadDir;
     private userConfigDir;
@@ -19,6 +20,7 @@ export declare class ConfigurationService {
     exists(configName: string): boolean;
     getCommonPromptsDir(): string;
     getUserPromptsDir(): string;
+    getCommonLibraryDir(): string;
     getUserDataDir(): string;
     getUserId(): string;
 }

package/dist-sdk/server/src/config/configuration.service.js

@@ -40,6 +40,7 @@ class ConfigurationService {
     dataDir;
     promptsDir;
     commonPromptsDir;
+    commonLibraryDir;
     userPromptsDir;
     uploadDir;
     userConfigDir;
@@ -62,6 +63,10 @@ class ConfigurationService {
         if (!fs.existsSync(this.commonPromptsDir)) {
             fs.mkdirSync(this.commonPromptsDir, { recursive: true });
         }
+        this.commonLibraryDir = path.resolve(commonDir, 'library');
+        if (!fs.existsSync(this.commonLibraryDir)) {
+            fs.mkdirSync(this.commonLibraryDir, { recursive: true });
+        }
         this.userDataDir = path.resolve(this.dataDir, 'user', this.userId);
         this.userPromptsDir = path.resolve(this.userDataDir, 'prompts');
         if (!fs.existsSync(this.userPromptsDir)) {
@@ -113,6 +118,9 @@ class ConfigurationService {
     getUserPromptsDir() {
         return this.userPromptsDir;
     }
+    getCommonLibraryDir() {
+        return this.commonLibraryDir;
+    }
     getUserDataDir() {
         return this.userDataDir;
     }

package/dist-sdk/server/src/library/library.service.d.ts

@@ -0,0 +1,14 @@
+import { LibraryFile, LibraryPrompt } from '../../../shared/types/app.types';
+export declare class LibraryService {
+    private getLibraryDir;
+    private assertSafeName;
+    private normalizeBaseUrl;
+    listLocalPrompts(): LibraryPrompt[];
+    listLocalFiles(folder: string): LibraryFile[];
+    getLocalFileContent(folder: string, file: string): string;
+    private fetchJson;
+    listRemotePrompts(baseUrl: string): Promise<LibraryPrompt[]>;
+    listRemoteFiles(baseUrl: string, folder: string): Promise<LibraryFile[]>;
+    getRemoteFileContent(baseUrl: string, folder: string, file: string): Promise<string>;
+    copyFromRemote(baseUrl: string, folder: string, userPromptsDir: string): Promise<void>;
+}