libre-webui 0.37.1 → 0.38.0

package/backend/dist/strands/catalog.js

@@ -0,0 +1,241 @@
+/*
+ * 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 pluginService from '../services/pluginService.js';
+import ollamaService from '../services/ollamaService.js';
+import { getOllamaRuntimeSettings } from '../services/ollamaSettingsService.js';
+import preferencesService, { instanceDefaultModel, } from '../services/preferencesService.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('strands-catalog');
+/** Chat selector for the engine's default model. */
+export const STRANDS_AGENT_ID = 'strands';
+const STRANDS_SELECTOR_PREFIX = `${STRANDS_AGENT_ID}:`;
+export class StrandsModelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StrandsModelError';
+    }
+}
+export function strandsModelRouteId(route) {
+    return route.type === 'ollama'
+        ? `ollama:${encodeURIComponent(route.model)}`
+        : `plugin:${encodeURIComponent(route.pluginId)}:${encodeURIComponent(route.model)}`;
+}
+/** Parse a route id. Returns undefined for a bare model name. */
+export function parseStrandsModelRoute(id) {
+    const parts = id.split(':');
+    try {
+        if (parts[0] === 'ollama' && parts.length === 2 && parts[1]) {
+            return { type: 'ollama', model: decodeURIComponent(parts[1]) };
+        }
+        if (parts[0] === 'plugin' && parts.length === 3 && parts[1] && parts[2]) {
+            return {
+                type: 'plugin',
+                pluginId: decodeURIComponent(parts[1]),
+                model: decodeURIComponent(parts[2]),
+            };
+        }
+    }
+    catch {
+        throw new StrandsModelError('The Strands model route is invalid.');
+    }
+    if (parts[0] === 'ollama' || parts[0] === 'plugin') {
+        throw new StrandsModelError('The Strands model route is invalid.');
+    }
+    return undefined;
+}
+/**
+ * Strip the chat selector prefix. `strands` alone means the engine default;
+ * `strands:<route>` pins a model. Anything else is returned as given.
+ */
+export function strandsSelectorModel(selector) {
+    const value = selector.trim();
+    if (value === STRANDS_AGENT_ID)
+        return undefined;
+    if (value.startsWith(STRANDS_SELECTOR_PREFIX)) {
+        const model = value.slice(STRANDS_SELECTOR_PREFIX.length).trim();
+        return model || undefined;
+    }
+    return value || undefined;
+}
+function isEmbeddingModel(id) {
+    const name = id.toLowerCase();
+    return (name.includes('embed') ||
+        name.includes('minilm') ||
+        name.includes('bge-') ||
+        name.includes('rerank'));
+}
+function isChatModelId(id) {
+    return (typeof id === 'string' &&
+        id.trim().length > 0 &&
+        id.length <= 512 &&
+        // eslint-disable-next-line no-control-regex
+        !/[\u0000-\u001f\u007f]/.test(id) &&
+        !id.startsWith('persona:') &&
+        !id.startsWith(STRANDS_SELECTOR_PREFIX) &&
+        !isEmbeddingModel(id));
+}
+async function requirePluginRoute(route, userId) {
+    let plugin;
+    try {
+        plugin = await pluginService.getActivePluginForModel(route.model, userId, route.pluginId);
+    }
+    catch {
+        plugin = null;
+    }
+    if (!plugin || (plugin.type !== 'chat' && plugin.type !== 'completion')) {
+        throw new StrandsModelError('The selected Strands provider is unavailable.');
+    }
+    return plugin;
+}
+async function requireOllamaEnabled() {
+    if (!(await getOllamaRuntimeSettings()).enabled) {
+        throw new StrandsModelError('Ollama is disabled. Choose a plugin model for the Strands engine.');
+    }
+}
+/** Every chat model the engine may drive for this account. */
+export async function listStrandsModels(userId) {
+    const models = new Map();
+    try {
+        const local = (await getOllamaRuntimeSettings()).enabled
+            ? await ollamaService.getModels()
+            : [];
+        for (const model of local) {
+            if (!isChatModelId(model.name))
+                continue;
+            const id = strandsModelRouteId({ type: 'ollama', model: model.name });
+            models.set(id, {
+                id,
+                name: model.name,
+                providerType: 'ollama',
+                providerId: null,
+                providerName: 'Ollama',
+            });
+        }
+    }
+    catch (error) {
+        logger.debug('Ollama models are unavailable to the Strands engine', {
+            error,
+        });
+    }
+    try {
+        const statuses = await pluginService.getPluginStatus(userId);
+        for (const plugin of await pluginService.getActivePlugins(userId)) {
+            if ((plugin.type !== 'completion' && plugin.type !== 'chat') ||
+                !statuses.some(status => status.id === plugin.id && status.available)) {
+                continue;
+            }
+            for (const model of plugin.model_map) {
+                if (!isChatModelId(model))
+                    continue;
+                const id = strandsModelRouteId({
+                    type: 'plugin',
+                    model,
+                    pluginId: plugin.id,
+                });
+                models.set(id, {
+                    id,
+                    name: model,
+                    providerType: 'plugin',
+                    providerId: plugin.id,
+                    providerName: plugin.name,
+                });
+            }
+        }
+    }
+    catch (error) {
+        logger.debug('Plugin models are unavailable to the Strands engine', {
+            error,
+        });
+    }
+    return [...models.values()];
+}
+/**
+ * Resolve a model selection to a concrete provider route. Accepts a route id,
+ * a chat selector (`strands`, `strands:<route>`), a bare model name, or
+ * nothing, in which case the account's default chat model is used.
+ */
+export async function resolveStrandsRoute(requested, userId) {
+    const selected = requested ? strandsSelectorModel(requested) : undefined;
+    const preferences = await preferencesService
+        .getPreferences(userId)
+        .catch(() => undefined);
+    const model = selected ??
+        (preferences?.defaultProviderType === 'agent'
+            ? undefined
+            : preferences?.defaultModel || instanceDefaultModel() || undefined);
+    if (model) {
+        const qualified = parseStrandsModelRoute(model);
+        if (qualified) {
+            if (!isChatModelId(qualified.model)) {
+                throw new StrandsModelError('Choose a chat model for Strands.');
+            }
+            if (qualified.type === 'plugin') {
+                const plugin = await requirePluginRoute(qualified, userId);
+                return { id: strandsModelRouteId(qualified), route: qualified, plugin };
+            }
+            await requireOllamaEnabled();
+            return { id: strandsModelRouteId(qualified), route: qualified };
+        }
+        if (!isChatModelId(model)) {
+            throw new StrandsModelError('Choose a provider chat model for Strands; personas and agent selectors cannot be used.');
+        }
+        const preferred = preferences?.defaultModel === model;
+        if (preferred &&
+            preferences?.defaultProviderType === 'plugin' &&
+            preferences.defaultProviderId) {
+            const route = {
+                type: 'plugin',
+                model,
+                pluginId: preferences.defaultProviderId,
+            };
+            const plugin = await requirePluginRoute(route, userId);
+            return { id: strandsModelRouteId(route), route, plugin };
+        }
+        const ollamaEnabled = (await getOllamaRuntimeSettings()).enabled;
+        if (ollamaEnabled) {
+            const local = await ollamaService.getModels().catch(() => []);
+            if ((preferred && preferences?.defaultProviderType === 'ollama') ||
+                local.some(candidate => candidate.name === model)) {
+                const route = { type: 'ollama', model };
+                return { id: strandsModelRouteId(route), route };
+            }
+        }
+        const plugin = await pluginService
+            .getActivePluginForModel(model, userId)
+            .catch(() => null);
+        if (plugin && (plugin.type === 'chat' || plugin.type === 'completion')) {
+            const route = { type: 'plugin', model, pluginId: plugin.id };
+            return { id: strandsModelRouteId(route), route, plugin };
+        }
+        if (selected) {
+            throw new StrandsModelError(`The model "${model}" is not available to the Strands engine.`);
+        }
+    }
+    const first = (await listStrandsModels(userId))[0];
+    if (!first) {
+        throw new StrandsModelError('No chat model is available to the Strands engine. Enable Ollama or a chat plugin first.');
+    }
+    return resolveStrandsRoute(first.id, userId);
+}
+/** Plain text target for titles and summaries, with no agent loop. */
+export async function resolveStrandsProviderTarget(requested, userId) {
+    const { route } = await resolveStrandsRoute(requested, userId);
+    return route.type === 'plugin'
+        ? { model: route.model, providerType: 'plugin', providerId: route.pluginId }
+        : { model: route.model, providerType: 'ollama', providerId: null };
+}
+//# sourceMappingURL=catalog.js.map

package/backend/dist/strands/catalog.js.map

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

package/backend/dist/strands/engine.d.ts

@@ -0,0 +1,131 @@
+import type { Agent, MessageData } from '@strands-agents/sdk';
+import type { ChatMessage } from '../types/index.js';
+import { type ResolvedStrandsRoute } from './catalog.js';
+export declare const STRANDS_MAX_TURNS = 24;
+export declare const STRANDS_MAX_SESSIONS_PER_USER = 200;
+export declare const STRANDS_MAX_PROMPT_CHARS = 32000;
+export declare const STRANDS_INSTRUCTIONS = "You are the Strands agent inside Libre WebUI.\nYou have a private workspace at /workspace. File tools take absolute paths under /workspace; nothing outside it exists for you.\nYou cannot run shell commands or reach the network. Plan multi-step work with the todo tool, keep answers concise, and say plainly when something is outside what you can do.";
+export type StrandsTurnEvent = {
+    type: 'turn-start';
+    sessionId: string;
+    messageId: string;
+} | {
+    type: 'text';
+    text: string;
+} | {
+    type: 'reasoning';
+    text: string;
+} | {
+    type: 'tool-start';
+    toolUseId: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'tool-result';
+    toolUseId: string;
+    status: 'success' | 'error';
+    output: string;
+} | {
+    type: 'done';
+    stopReason: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+} | {
+    type: 'error';
+    message: string;
+};
+export interface StrandsToolTrace {
+    id: string;
+    name: string;
+    input: unknown;
+    status?: 'success' | 'error';
+    output?: string;
+}
+export interface StrandsTranscriptEntry {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    thinking?: string;
+    tools?: StrandsToolTrace[];
+    stopReason?: string;
+    error?: string;
+    createdAt: number;
+}
+export interface StrandsSessionSummary {
+    id: string;
+    title: string;
+    model: string | null;
+    createdAt: number;
+    updatedAt: number;
+    messageCount: number;
+}
+export declare class StrandsEngineError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+export declare function strandsDataDirectory(): string;
+interface AgentOptions {
+    userId: string;
+    target: ResolvedStrandsRoute;
+    workspace: string;
+    session?: {
+        id: string;
+        dir: string;
+    };
+    messages?: MessageData[];
+    instructions?: string;
+}
+/** Build a harness agent with Libre WebUI's locked-down defaults. */
+export declare function createStrandsAgent(options: AgentOptions): Promise<Agent>;
+/**
+ * Run one agent invocation and translate the Strands stream into the
+ * engine's event vocabulary. Returns the stop reason.
+ */
+export declare function streamAgentTurn(agent: Agent, prompt: string, signal?: AbortSignal): AsyncGenerator<StrandsTurnEvent, void, undefined>;
+/** Fold engine events into a transcript entry as they stream. */
+export declare function applyTurnEvent(entry: StrandsTranscriptEntry, event: StrandsTurnEvent): void;
+export declare class StrandsEngine {
+    private readonly agents;
+    private readonly active;
+    private readonly locks;
+    /** Serialize registry writes per account. */
+    private withUserLock;
+    private registryFile;
+    private transcriptFile;
+    private workspaceDirectory;
+    private snapshotDirectory;
+    private registry;
+    listSessions(userId: string): Promise<StrandsSessionSummary[]>;
+    getSession(userId: string, sessionId: string): Promise<StrandsSessionSummary>;
+    createSession(userId: string, input?: {
+        title?: string;
+        model?: string | null;
+    }): Promise<StrandsSessionSummary>;
+    updateSession(userId: string, sessionId: string, input: {
+        title?: string;
+        model?: string | null;
+    }): Promise<StrandsSessionSummary>;
+    deleteSession(userId: string, sessionId: string): Promise<void>;
+    transcript(userId: string, sessionId: string): Promise<StrandsTranscriptEntry[]>;
+    isRunning(userId: string, sessionId: string): boolean;
+    cancel(userId: string, sessionId: string): boolean;
+    private evictIdle;
+    private sessionAgent;
+    /** Send one message to a session and stream the turn. */
+    sendMessage(userId: string, sessionId: string, text: string, signal?: AbortSignal): AsyncGenerator<StrandsTurnEvent, void, undefined>;
+    /**
+     * One Chat turn. Chat owns its transcript, so the agent is rebuilt from it
+     * each time with no snapshot, and files land in a per-account scratch
+     * workspace.
+     */
+    chatTurn(userId: string, messages: readonly ChatMessage[], options?: {
+        model?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<StrandsTurnEvent, void, undefined>;
+    stop(): Promise<void>;
+}
+export declare const strandsEngine: StrandsEngine;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/backend/dist/strands/engine.d.ts.map

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