LibreChat/api/server/routes/prompts.js
Atef Bellaaj 3c90cde7d8
🔗 feat: use LibreChat prompt groups as agent instructions (#16686)
* 🔗 feat(agents): use LibreChat prompt groups as agent instructions

Agents can link a prompt group revision or Production as their instructions. The link resolves at the start of each turn through a cached resolver. The cache clears on promote and delete. Editors without VIEW on the group see a restricted placeholder.

* fix: remove duplicate logger import from agent initialization tests

* fix: honor prompt management capabilities for linked agent instructions

* test: seed prompt manager capabilities in authorization fixtures

* fix: clear acknowledged linked prompt edits before version restore

* test: adapt merged chain coverage to prompt-aware payload helper

---------

Co-authored-by: Lia <lia@librechat.ai>
2026-10-04 21:27:26 -04:00

117 lines
3.2 KiB
JavaScript

const express = require('express');
const {
generateCheckAccess,
createPromptService,
createPromptHandlers,
invalidateLinkedPrompt,
} = require('@librechat/api');
const {
CacheKeys,
Permissions,
PermissionBits,
PermissionTypes,
} = require('librechat-data-provider');
const {
canAccessPromptGroupResource,
canAccessPromptViaGroup,
promptUsageLimiter,
requireJwtAuth,
configMiddleware,
} = require('~/server/middleware');
const { getEffectivePermissions, grantPermission } = require('~/server/services/PermissionService');
const { getLogStores } = require('~/cache');
const db = require('~/models');
const { getRoleByName } = db;
const router = express.Router();
const linkedInstructionsCache = getLogStores(CacheKeys.AGENT_LINKED_INSTRUCTIONS);
const handlers = createPromptHandlers({
service: createPromptService({ db, grantPermission }),
getPromptGroupAccessContext: db.getPromptGroupAccessContext,
getEffectivePermissions,
invalidateLinkedPrompt: (groupId, promptIds) =>
invalidateLinkedPrompt(linkedInstructionsCache, groupId, promptIds),
});
const checkPromptAccess = generateCheckAccess({
permissionType: PermissionTypes.PROMPTS,
permissions: [Permissions.USE],
getRoleByName,
});
const checkPromptCreate = generateCheckAccess({
permissionType: PermissionTypes.PROMPTS,
permissions: [Permissions.USE, Permissions.CREATE],
getRoleByName,
});
router.use(requireJwtAuth);
router.use(checkPromptAccess);
router.get(
'/groups/:groupId',
canAccessPromptGroupResource({ requiredPermission: PermissionBits.VIEW }),
configMiddleware,
handlers.getPromptGroup,
);
router.get('/all', configMiddleware, handlers.listAllPromptGroups);
router.get('/groups', configMiddleware, handlers.listPromptGroups);
router.post('/', checkPromptCreate, configMiddleware, handlers.createPromptGroup);
router.post(
'/groups/:groupId/prompts',
checkPromptAccess,
canAccessPromptGroupResource({ requiredPermission: PermissionBits.EDIT }),
configMiddleware,
handlers.savePrompt,
);
router.post(
'/groups/:groupId/use',
promptUsageLimiter,
canAccessPromptGroupResource({ requiredPermission: PermissionBits.VIEW }),
handlers.recordPromptUsage,
);
router.patch(
'/groups/:groupId',
checkPromptCreate,
canAccessPromptGroupResource({ requiredPermission: PermissionBits.EDIT }),
configMiddleware,
handlers.updatePromptGroup,
);
router.patch(
'/:promptId/tags/production',
checkPromptCreate,
canAccessPromptViaGroup({ requiredPermission: PermissionBits.EDIT, resourceIdParam: 'promptId' }),
configMiddleware,
handlers.makePromptProduction,
);
router.get(
'/:promptId',
canAccessPromptViaGroup({ requiredPermission: PermissionBits.VIEW, resourceIdParam: 'promptId' }),
configMiddleware,
handlers.getPrompt,
);
router.get('/', configMiddleware, handlers.getPrompts);
router.delete(
'/:promptId',
checkPromptCreate,
canAccessPromptViaGroup({
requiredPermission: PermissionBits.DELETE,
resourceIdParam: 'promptId',
}),
configMiddleware,
handlers.deletePrompt,
);
router.delete(
'/groups/:groupId',
checkPromptCreate,
canAccessPromptGroupResource({ requiredPermission: PermissionBits.DELETE }),
configMiddleware,
handlers.deletePromptGroup,
);
module.exports = router;