libre-webui 0.24.0 → 0.25.0

package/backend/dist/routes/automations.js

@@ -0,0 +1,232 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import express from 'express';
+import automationService from '../services/automationService.js';
+import automationSchedulerService from '../services/automationSchedulerService.js';
+import { authenticate } from '../middleware/auth.js';
+import { ResourcePolicyError } from '../utils/resourceLimits.js';
+import { InvalidTriggerError, occurrencesBetween, } from '../utils/automationSchedule.js';
+const router = express.Router();
+router.use(authenticate);
+const userIdOf = (req) => req.user?.userId || 'default';
+/** Occurrence projections span at most 62 days per request. */
+const MAX_OCCURRENCE_RANGE_MS = 62 * 24 * 60 * 60 * 1000;
+function sendAutomationError(res, error, fallback) {
+    if (error instanceof ResourcePolicyError ||
+        error instanceof InvalidTriggerError) {
+        const statusCode = error instanceof ResourcePolicyError ? error.statusCode : 400;
+        res.status(statusCode).json({ success: false, error: error.message });
+        return;
+    }
+    res.status(500).json({
+        success: false,
+        error: error instanceof Error ? error.message : fallback,
+    });
+}
+function readEpoch(value, field) {
+    const parsed = typeof value === 'string' ? Number(value) : value;
+    if (typeof parsed !== 'number' ||
+        !Number.isSafeInteger(parsed) ||
+        parsed < 0) {
+        throw new ResourcePolicyError(`${field} must be an epoch-ms integer`, 400);
+    }
+    return parsed;
+}
+function readAutomationBody(body) {
+    const provider = typeof body.provider === 'string' && body.provider
+        ? body.provider
+        : undefined;
+    const model = typeof body.model === 'string' && body.model ? body.model : undefined;
+    return {
+        name: typeof body.name === 'string' ? body.name : '',
+        instructions: typeof body.instructions === 'string' ? body.instructions : '',
+        triggers: body.triggers,
+        ...(provider ? { provider } : {}),
+        ...(model ? { model } : {}),
+        notify: body.notify === 'off' ? 'off' : 'app',
+    };
+}
+router.get('/', async (req, res) => {
+    try {
+        res.json({
+            success: true,
+            data: await automationService.getAutomations(userIdOf(req)),
+        });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to load automations');
+    }
+});
+router.post('/', async (req, res) => {
+    try {
+        const automation = await automationService.createAutomation(readAutomationBody((req.body ?? {})), userIdOf(req));
+        res.json({ success: true, data: automation });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to create automation');
+    }
+});
+/** Upcoming computed occurrences across the caller's active automations. */
+router.get('/occurrences', async (req, res) => {
+    try {
+        const from = readEpoch(req.query.from, 'from');
+        const to = readEpoch(req.query.to, 'to');
+        if (to <= from || to - from > MAX_OCCURRENCE_RANGE_MS) {
+            throw new ResourcePolicyError('The requested range must be positive and span at most 62 days', 400);
+        }
+        const automations = await automationService.getAutomations(userIdOf(req));
+        const occurrences = automations
+            .filter(automation => automation.status === 'active')
+            .flatMap(automation => occurrencesBetween(automation.triggers, from, to, 200).map(at => ({
+            automationId: automation.id,
+            name: automation.name,
+            at,
+        })))
+            .sort((left, right) => left.at - right.at);
+        res.json({ success: true, data: occurrences });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to project occurrences');
+    }
+});
+router.get('/runs', async (req, res) => {
+    try {
+        const options = {};
+        if (typeof req.query.automationId === 'string') {
+            options.automationId = req.query.automationId;
+        }
+        if (req.query.from !== undefined) {
+            options.from = readEpoch(req.query.from, 'from');
+        }
+        if (req.query.to !== undefined) {
+            options.to = readEpoch(req.query.to, 'to');
+        }
+        res.json({
+            success: true,
+            data: await automationService.listRuns(userIdOf(req), options),
+        });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to load automation runs');
+    }
+});
+router.get('/runs/summary', async (req, res) => {
+    try {
+        res.json({
+            success: true,
+            data: await automationService.runsSummary(userIdOf(req)),
+        });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to load the run summary');
+    }
+});
+router.post('/runs/seen', async (req, res) => {
+    try {
+        const marked = await automationService.markRunsSeen(userIdOf(req));
+        res.json({ success: true, data: { marked } });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to mark runs as seen');
+    }
+});
+router.get('/:automationId', async (req, res) => {
+    try {
+        const automation = await automationService.getAutomation(req.params.automationId, userIdOf(req));
+        if (!automation) {
+            res.status(404).json({
+                success: false,
+                error: 'Automation not found',
+            });
+            return;
+        }
+        res.json({ success: true, data: automation });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to load the automation');
+    }
+});
+router.put('/:automationId', async (req, res) => {
+    try {
+        const automation = await automationService.updateAutomation(req.params.automationId, readAutomationBody((req.body ?? {})), userIdOf(req));
+        if (!automation) {
+            res.status(404).json({
+                success: false,
+                error: 'Automation not found',
+            });
+            return;
+        }
+        res.json({ success: true, data: automation });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to update the automation');
+    }
+});
+router.delete('/:automationId', async (req, res) => {
+    try {
+        const deleted = await automationService.deleteAutomation(req.params.automationId, userIdOf(req));
+        if (!deleted) {
+            res.status(404).json({
+                success: false,
+                error: 'Automation not found',
+            });
+            return;
+        }
+        res.json({ success: true, message: 'Automation deleted' });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to delete the automation');
+    }
+});
+const setStatus = async (req, res, status) => {
+    try {
+        const automation = await automationService.setAutomationStatus(req.params.automationId, userIdOf(req), status);
+        if (!automation) {
+            res.status(404).json({
+                success: false,
+                error: 'Automation not found',
+            });
+            return;
+        }
+        res.json({ success: true, data: automation });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to change the automation status');
+    }
+};
+router.post('/:automationId/pause', (req, res) => setStatus(req, res, 'paused'));
+router.post('/:automationId/resume', (req, res) => setStatus(req, res, 'active'));
+router.post('/:automationId/run', async (req, res) => {
+    try {
+        const userId = userIdOf(req);
+        const automation = await automationService.getAutomation(req.params.automationId, userId);
+        if (!automation) {
+            res.status(404).json({
+                success: false,
+                error: 'Automation not found',
+            });
+            return;
+        }
+        const runId = await automationSchedulerService.runNow(automation.id, userId);
+        res.status(202).json({ success: true, data: { runId } });
+    }
+    catch (error) {
+        sendAutomationError(res, error, 'Failed to start the automation run');
+    }
+});
+export default router;
+//# sourceMappingURL=automations.js.map

package/backend/dist/routes/automations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../src/routes/automations.ts"],"names":[],"mappings":"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"}

package/backend/dist/routes/calendar.d.ts

@@ -0,0 +1,3 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;
+//# sourceMappingURL=calendar.d.ts.map

package/backend/dist/routes/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/routes/calendar.ts"],"names":[],"mappings":"AAiCA,QAAA,MAAM,MAAM,4CAAmB,CAAC;eAqPjB,MAAM"}

package/backend/dist/routes/calendar.js

@@ -0,0 +1,206 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import express from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import storageService from '../storage.js';
+import { authenticate } from '../middleware/auth.js';
+import { MAX_CALENDAR_EVENT_NOTES_LENGTH, MAX_CALENDAR_EVENT_TITLE_LENGTH, ResourcePolicyError, } from '../utils/resourceLimits.js';
+import { InvalidTriggerError, occurrencesBetween, validateTriggers, } from '../utils/automationSchedule.js';
+const router = express.Router();
+router.use(authenticate);
+const userIdOf = (req) => req.user?.userId || 'default';
+/** A calendar range query may span at most 13 months. */
+const MAX_RANGE_MS = 13 * 32 * 24 * 60 * 60 * 1000;
+function sendCalendarError(res, error, fallback) {
+    if (error instanceof ResourcePolicyError ||
+        error instanceof InvalidTriggerError) {
+        const statusCode = error instanceof ResourcePolicyError ? error.statusCode : 400;
+        res.status(statusCode).json({ success: false, error: error.message });
+        return;
+    }
+    res.status(500).json({
+        success: false,
+        error: error instanceof Error ? error.message : fallback,
+    });
+}
+function readTextField(value, field, maximum, required) {
+    if (value === undefined || value === null || value === '') {
+        if (required) {
+            throw new ResourcePolicyError(`${field} is required`, 400);
+        }
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new ResourcePolicyError(`${field} must be a string`, 400);
+    }
+    if (value.length > maximum) {
+        throw new ResourcePolicyError(`${field} exceeds the maximum length of ${maximum} characters`, 400);
+    }
+    return value;
+}
+function readEpoch(value, field) {
+    const parsed = typeof value === 'string' ? Number(value) : value;
+    if (typeof parsed !== 'number' ||
+        !Number.isSafeInteger(parsed) ||
+        parsed < 0) {
+        throw new ResourcePolicyError(`${field} must be an epoch-ms integer`, 400);
+    }
+    return parsed;
+}
+function readRange(req) {
+    const from = readEpoch(req.query.from, 'from');
+    const to = readEpoch(req.query.to, 'to');
+    if (to <= from || to - from > MAX_RANGE_MS) {
+        throw new ResourcePolicyError('The requested range must be positive and span at most 13 months', 400);
+    }
+    return { from, to };
+}
+function readEventBody(body, existing) {
+    const title = readTextField(body.title, 'title', MAX_CALENDAR_EVENT_TITLE_LENGTH, existing === undefined) ??
+        existing?.title ??
+        '';
+    const notes = body.notes !== undefined
+        ? readTextField(body.notes, 'notes', MAX_CALENDAR_EVENT_NOTES_LENGTH, false)
+        : existing?.notes;
+    const startAt = body.startAt !== undefined
+        ? readEpoch(body.startAt, 'startAt')
+        : existing?.startAt;
+    if (startAt === undefined) {
+        throw new ResourcePolicyError('startAt is required', 400);
+    }
+    const endAt = body.endAt !== undefined && body.endAt !== null
+        ? readEpoch(body.endAt, 'endAt')
+        : body.endAt === null
+            ? undefined
+            : existing?.endAt;
+    if (endAt !== undefined && endAt < startAt) {
+        throw new ResourcePolicyError('endAt must not precede startAt', 400);
+    }
+    const allDay = body.allDay !== undefined
+        ? body.allDay === true
+        : (existing?.allDay ?? false);
+    const recurrence = body.recurrence !== undefined
+        ? body.recurrence === null
+            ? undefined
+            : validateTriggers([body.recurrence], 1)[0]
+        : existing?.recurrence;
+    return {
+        title,
+        ...(notes !== undefined ? { notes } : {}),
+        startAt,
+        ...(endAt !== undefined ? { endAt } : {}),
+        allDay,
+        ...(recurrence !== undefined ? { recurrence } : {}),
+    };
+}
+/** Project a recurring event's occurrences into [from, to). */
+function expandRecurring(event, from, to) {
+    if (!event.recurrence)
+        return [];
+    const duration = event.endAt !== undefined ? event.endAt - event.startAt : 0;
+    const effectiveFrom = Math.max(from, event.startAt);
+    if (effectiveFrom >= to)
+        return [];
+    return occurrencesBetween([event.recurrence], effectiveFrom, to)
+        .filter(occurrence => occurrence !== event.startAt)
+        .map(occurrence => ({
+        ...event,
+        id: `${event.id}:${occurrence}`,
+        baseEventId: event.id,
+        startAt: occurrence,
+        ...(event.endAt !== undefined ? { endAt: occurrence + duration } : {}),
+    }));
+}
+router.get('/events', async (req, res) => {
+    try {
+        const userId = userIdOf(req);
+        const { from, to } = readRange(req);
+        const [inRange, recurring] = await Promise.all([
+            storageService.getCalendarEventsBetween(from, to, userId),
+            storageService.getRecurringCalendarEvents(userId),
+        ]);
+        const seen = new Set(inRange.map(event => event.id));
+        const expanded = recurring.flatMap(event => expandRecurring(event, from, to).filter(occurrence => !seen.has(occurrence.id)));
+        const events = [...inRange, ...expanded].sort((left, right) => left.startAt - right.startAt);
+        res.json({ success: true, data: events });
+    }
+    catch (error) {
+        sendCalendarError(res, error, 'Failed to load calendar events');
+    }
+});
+router.post('/events', async (req, res) => {
+    try {
+        const now = Date.now();
+        const event = {
+            id: uuidv4(),
+            ...readEventBody((req.body ?? {})),
+            createdAt: now,
+            updatedAt: now,
+        };
+        await storageService.saveCalendarEvent(event, userIdOf(req));
+        res.json({ success: true, data: event });
+    }
+    catch (error) {
+        sendCalendarError(res, error, 'Failed to create calendar event');
+    }
+});
+router.put('/events/:eventId', async (req, res) => {
+    try {
+        const userId = userIdOf(req);
+        const existing = await storageService.getCalendarEvent(req.params.eventId, userId);
+        if (!existing) {
+            res.status(404).json({
+                success: false,
+                error: 'Calendar event not found',
+            });
+            return;
+        }
+        const event = {
+            ...existing,
+            ...readEventBody((req.body ?? {}), existing),
+            id: existing.id,
+            createdAt: existing.createdAt,
+            updatedAt: Date.now(),
+        };
+        await storageService.saveCalendarEvent(event, userId);
+        res.json({ success: true, data: event });
+    }
+    catch (error) {
+        sendCalendarError(res, error, 'Failed to update calendar event');
+    }
+});
+router.delete('/events/:eventId', async (req, res) => {
+    try {
+        const deleted = await storageService.deleteCalendarEvent(req.params.eventId, userIdOf(req));
+        if (!deleted) {
+            res.status(404).json({
+                success: false,
+                error: 'Calendar event not found',
+            });
+            return;
+        }
+        res.json({
+            success: true,
+            message: 'Calendar event deleted',
+        });
+    }
+    catch (error) {
+        sendCalendarError(res, error, 'Failed to delete calendar event');
+    }
+});
+export default router;
+//# sourceMappingURL=calendar.js.map

package/backend/dist/routes/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/routes/calendar.ts"],"names":[],"mappings":"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"}

package/backend/dist/routes/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AA8IA,QAAA,MAAM,MAAM,4CAAmB,CAAC;eAgtDjB,MAAM"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AA6IA,QAAA,MAAM,MAAM,4CAAmB,CAAC;eA+zDjB,MAAM"}

package/backend/dist/routes/chat.js

@@ -26,7 +26,8 @@ import { authenticate, requireAdmin, } from '../middleware/auth.js';
 import { getCompactionConfig, setCompactionConfig, } from '../services/contextCompactionService.js';
 import { extractStatistics } from '../utils/generationUtils.js';
 import agentCliService from '../services/agentCliService.js';
-import { buildWebSearchEnhancedContent, isWebSearchAvailable, userCanUseWebSearch, webSearch as runWebSearch, } from '../services/webSearchService.js';
+import { buildWebSearchEnhancedContent, isWebSearchAvailable, userCanUseWebSearch, } from '../services/webSearchService.js';
+import { runPlannedWebSearch } from '../services/webSearchPlanService.js';
 import { userModel } from '../models/userModel.js';
 import chatGenerationService from '../services/chatGenerationService.js';
 import preferencesService from '../services/preferencesService.js';
@@ -268,6 +269,34 @@ router.put('/sessions/:sessionId/messages/:messageId', async (req, res) => {
         });
     }
 });
+// Truncate a session at a message: drop it and everything after it
+// (edit-and-resend). The metadata PUT deliberately ignores `messages`,
+// so this is the only way a client can shorten the server-side history.
+router.post('/sessions/:sessionId/messages/:messageId/truncate', async (req, res) => {
+    try {
+        const sessionId = req.params.sessionId;
+        const messageId = req.params.messageId;
+        const userId = req.user?.userId || 'default';
+        const updatedSession = await chatService.truncateMessagesFrom(sessionId, messageId, userId);
+        if (!updatedSession) {
+            res.status(404).json({
+                success: false,
+                error: 'Session or message not found',
+            });
+            return;
+        }
+        res.json({
+            success: true,
+            data: updatedSession,
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            success: false,
+            error: getErrorMessage(error, 'Failed to truncate session'),
+        });
+    }
+});
 // Delete a chat session
 router.delete('/sessions/:sessionId', async (req, res) => {
     try {
@@ -410,7 +439,12 @@ router.post('/sessions/:sessionId/generate', async (req, res) => {
             (await isWebSearchAvailable()) &&
             (await userCanUseWebSearch(await userModel.getUserById(userId)))) {
             try {
-                const results = await runWebSearch(message, undefined, signal);
+                const { results } = await runPlannedWebSearch({
+                    message,
+                    session,
+                    userId,
+                    signal,
+                });
                 if (results.length > 0) {
                     enhancedContent = buildWebSearchEnhancedContent(enhancedContent, results, message);
                     hasRelevantContext = true;
@@ -429,7 +463,7 @@ router.post('/sessions/:sessionId/generate', async (req, res) => {
             session,
             userId,
             options,
-            persistedMessages: await chatService.getMessagesForContext(sessionId, userId),
+            persistedMessages: await chatService.getMessagesForContext(sessionId, userId, undefined, signal),
             content: message,
             hasRelevantContext,
             enhancedContent,
@@ -857,7 +891,12 @@ router.post('/sessions/:sessionId/generate/stream', async (req, res) => {
             (await userCanUseWebSearch(await userModel.getUserById(userId)))) {
             await emitDurable({ type: 'search', status: 'searching' });
             try {
-                const results = await runWebSearch(message, undefined, signal);
+                const { results } = await runPlannedWebSearch({
+                    message,
+                    session,
+                    userId,
+                    signal,
+                });
                 if (results.length > 0) {
                     searchEnhancedContent = buildWebSearchEnhancedContent(documentContext.enhancedContent, results, message);
                     webSearchSources = results.map(({ title, url }) => ({
@@ -897,7 +936,7 @@ router.post('/sessions/:sessionId/generate/stream', async (req, res) => {
             session,
             userId,
             options,
-            persistedMessages: await chatService.getMessagesForContext(sessionId, userId),
+            persistedMessages: await chatService.getMessagesForContext(sessionId, userId, undefined, signal),
             content: message,
             enhancedContent: searchEnhancedContent ?? documentContext.enhancedContent,
             hasRelevantContext: Boolean(searchEnhancedContent ?? documentContext.hasRelevantContext),
@@ -1423,8 +1462,61 @@ router.post('/sessions/:sessionId/messages/:messageId/branches', authenticate, c
         });
     }
 });
-/** Context compaction settings: readable by any user, set by admins. */
-router.get('/compaction-config', async (_req, res) => {
+/**
+ * Undo one compaction: the summary knows exactly which messages it replaced,
+ * so restoring is reactivating them and removing the summary.
+ */
+router.post('/sessions/:sessionId/compaction/:messageId/restore', authenticate, chatRateLimiter, async (req, res) => {
+    try {
+        const sessionId = req.params.sessionId;
+        const messageId = req.params.messageId;
+        const userId = req.user?.userId || 'default';
+        const session = await chatService.restoreCompaction(sessionId, userId, messageId);
+        if (!session) {
+            res.status(404).json({
+                success: false,
+                error: 'No restorable summary with that id in this session',
+            });
+            return;
+        }
+        res.json({ success: true, data: session });
+    }
+    catch (error) {
+        logger.error('Restore compaction error:', error);
+        res.status(500).json({
+            success: false,
+            error: getErrorMessage(error, 'Failed to restore compacted messages'),
+        });
+    }
+});
+/**
+ * The rolling window every conversation runs with, for any signed-in user:
+ * the context meter needs the real message count to mirror what is sent.
+ * Deliberately narrow — none of the admin compaction configuration (prompt,
+ * model, thresholds) leaves this endpoint.
+ */
+router.get('/context-policy', async (_req, res) => {
+    try {
+        const compaction = await getCompactionConfig();
+        res.json({
+            success: true,
+            data: {
+                windowMessages: compaction.enabled
+                    ? Math.max(10, compaction.keepRecentMessages)
+                    : 10,
+            },
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            success: false,
+            error: getErrorMessage(error, 'Failed to load context policy'),
+        });
+    }
+});
+/** Context compaction settings: admin-only in both directions — the custom
+ * summarizer prompt is administrator configuration, not user data. */
+router.get('/compaction-config', requireAdmin, async (_req, res) => {
     try {
         res.json({ success: true, data: await getCompactionConfig() });
     }