libre-webui 0.36.0 → 0.37.1

package/backend/dist/cordis/dsh/native-provider-protocol.js

@@ -0,0 +1,325 @@
+/*
+ * 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.
+ */
+export const MAX_REQUEST_BYTES = 8 * 1024 * 1024;
+export const MAX_CHUNK_BYTES = 16 * 1024 * 1024;
+export const MAX_RESPONSE_BYTES = 256 * 1024 * 1024;
+export const NATIVE_PROVIDER_INSTANCE_HEADER = 'x-native-provider-instance';
+export class NativeProviderProtocolError extends Error {
+    constructor(message, status = 400) {
+        super(message);
+        this.status = status;
+        this.name = 'NativeProviderProtocolError';
+    }
+}
+function fail(label) {
+    throw new NativeProviderProtocolError(`Invalid native provider ${label}.`);
+}
+function record(value, label) {
+    if (!value ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        (Object.getPrototypeOf(value) !== Object.prototype &&
+            Object.getPrototypeOf(value) !== null))
+        fail(label);
+    return value;
+}
+function keys(value, required, optional, label) {
+    if (required.some(key => !Object.prototype.hasOwnProperty.call(value, key)) ||
+        Object.keys(value).some(key => !required.includes(key) && !optional.includes(key)))
+        fail(label);
+}
+function text(value, label, maximum = 2048, empty = false) {
+    if (typeof value !== 'string' ||
+        (!empty && !value.trim()) ||
+        value.length > maximum)
+        fail(label);
+}
+function integer(value, label, minimum = 0) {
+    if (typeof value !== 'number' ||
+        !Number.isSafeInteger(value) ||
+        value < minimum)
+        fail(label);
+}
+function optionalInteger(value, key, minimum = 0) {
+    if (value[key] !== undefined)
+        integer(value[key], key, minimum);
+}
+/** Reject non-JSON inputs and bound arbitrary schemas/replay data as well as text. */
+function json(value, limit) {
+    let nodes = 0;
+    const visit = (item, depth) => {
+        if (++nodes > 100000 || depth > 32)
+            fail('JSON complexity');
+        if (item === null || typeof item === 'string' || typeof item === 'boolean')
+            return;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return;
+        if (Array.isArray(item)) {
+            item.forEach(child => visit(child, depth + 1));
+            return;
+        }
+        const object = record(item, 'JSON value');
+        Object.values(object).forEach(child => visit(child, depth + 1));
+    };
+    visit(value, 0);
+    if (Buffer.byteLength(JSON.stringify(value)) > limit) {
+        throw new NativeProviderProtocolError('Native provider message exceeds its byte limit.', 413);
+    }
+}
+function block(value) {
+    const data = record(value, 'content block');
+    switch (data.type) {
+        case 'text':
+        case 'reasoning':
+            keys(data, ['type', 'text'], [], 'text block');
+            text(data.text, 'text', MAX_CHUNK_BYTES, true);
+            return;
+        case 'tool-call':
+            keys(data, ['type', 'id', 'name', 'arguments'], [], 'tool call');
+            text(data.id, 'tool call ID');
+            text(data.name, 'tool name');
+            text(data.arguments, 'tool arguments', MAX_REQUEST_BYTES, true);
+            return;
+        case 'tool-result':
+            keys(data, ['type', 'toolCallId', 'content'], ['isError'], 'tool result');
+            text(data.toolCallId, 'tool result ID');
+            blocks(data.content);
+            if (data.isError !== undefined && typeof data.isError !== 'boolean')
+                fail('tool result outcome');
+            return;
+        default:
+            // Native file/image references are capabilities, not transferable text.
+            fail('content block type');
+    }
+}
+function blocks(value) {
+    if (!Array.isArray(value) || value.length > 2048)
+        fail('message content');
+    value.forEach(block);
+}
+function message(value) {
+    const data = record(value, 'message');
+    keys(data, ['id', 'role', 'content', 'source'], [], 'message');
+    text(data.id, 'message ID');
+    if (!['system', 'user', 'assistant'].includes(String(data.role)))
+        fail('message role');
+    blocks(data.content);
+    const source = record(data.source, 'message source');
+    switch (source.kind) {
+        case 'user':
+            keys(source, ['kind'], [], 'user source');
+            break;
+        case 'plugin':
+            keys(source, ['kind', 'plugin'], [], 'plugin source');
+            text(source.plugin, 'plugin source ID');
+            break;
+        case 'tool':
+            keys(source, ['kind', 'callId'], [], 'tool source');
+            text(source.callId, 'tool source ID');
+            break;
+        case 'model':
+            keys(source, ['kind', 'provider', 'model'], ['replayState'], 'model source');
+            text(source.provider, 'source provider');
+            text(source.model, 'source model');
+            break;
+        default:
+            fail('message source kind');
+    }
+    if (data.role === 'system' && source.kind !== 'plugin')
+        fail('system source');
+    if (source.kind === 'tool') {
+        const content = data.content;
+        if (data.role !== 'user' ||
+            content.length !== 1 ||
+            content[0].type !== 'tool-result' ||
+            content[0].toolCallId !== source.callId)
+            fail('tool result correlation');
+    }
+}
+export function parseNativeProviderRequest(value) {
+    json(value, MAX_REQUEST_BYTES);
+    const data = record(value, 'request');
+    keys(data, ['provider', 'model', 'messages'], [
+        'instanceId',
+        'system',
+        'tools',
+        'temperature',
+        'maxTokens',
+        'stop',
+        'reasoningEffort',
+        'purpose',
+    ], 'request');
+    text(data.provider, 'provider');
+    text(data.model, 'model');
+    if (data.instanceId !== undefined)
+        text(data.instanceId, 'instance ID', 128);
+    if (data.reasoningEffort !== undefined)
+        text(data.reasoningEffort, 'reasoning effort');
+    if (data.purpose !== undefined &&
+        !['session-title', 'compaction'].includes(String(data.purpose)))
+        fail('request purpose');
+    if (data.system !== undefined)
+        text(data.system, 'system prompt', MAX_REQUEST_BYTES, true);
+    if (!Array.isArray(data.messages) || data.messages.length > 2048)
+        fail('messages');
+    data.messages.forEach(message);
+    optionalInteger(data, 'maxTokens', 1);
+    if (data.temperature !== undefined &&
+        (typeof data.temperature !== 'number' ||
+            !Number.isFinite(data.temperature) ||
+            data.temperature < 0 ||
+            data.temperature > 2))
+        fail('temperature');
+    if (data.stop !== undefined) {
+        if (!Array.isArray(data.stop) || data.stop.length > 64)
+            fail('stop sequences');
+        data.stop.forEach(item => text(item, 'stop sequence'));
+    }
+    if (data.tools !== undefined) {
+        if (!Array.isArray(data.tools) || data.tools.length > 256)
+            fail('tools');
+        const names = new Set();
+        for (const item of data.tools) {
+            const tool = record(item, 'tool schema');
+            keys(tool, ['name', 'description', 'parameters'], [], 'tool schema');
+            text(tool.name, 'tool name');
+            text(tool.description, 'tool description', MAX_REQUEST_BYTES, true);
+            record(tool.parameters, 'tool parameters');
+            if (names.has(tool.name))
+                fail('duplicate tool name');
+            names.add(tool.name);
+        }
+    }
+    return data;
+}
+export function parseNativeProviderCatalog(value) {
+    json(value, MAX_CHUNK_BYTES);
+    const data = record(value, 'catalog');
+    keys(data, ['instanceId', 'models'], [], 'catalog');
+    text(data.instanceId, 'instance ID', 128);
+    if (!Array.isArray(data.models) || data.models.length > 10000)
+        fail('catalog models');
+    const seen = new Set();
+    for (const entry of data.models) {
+        const model = record(entry, 'catalog model');
+        keys(model, ['providerId', 'model', 'name', 'providerName'], ['contextWindow', 'defaultMaxTokens', 'reasoning'], 'catalog model');
+        for (const key of ['providerId', 'model', 'name', 'providerName'])
+            text(model[key], `catalog ${key}`, 4096);
+        const identity = JSON.stringify([model.providerId, model.model]);
+        if (seen.has(identity))
+            fail('duplicate catalog model');
+        seen.add(identity);
+        optionalInteger(model, 'contextWindow', 1);
+        optionalInteger(model, 'defaultMaxTokens', 1);
+        if (model.reasoning !== undefined) {
+            const reasoning = record(model.reasoning, 'reasoning catalog');
+            keys(reasoning, ['efforts'], ['defaultEffort'], 'reasoning catalog');
+            if (!Array.isArray(reasoning.efforts) || reasoning.efforts.length > 64)
+                fail('reasoning efforts');
+            const efforts = new Set();
+            for (const entry of reasoning.efforts) {
+                const effort = record(entry, 'reasoning effort');
+                keys(effort, ['id', 'name'], ['description'], 'reasoning effort');
+                text(effort.id, 'reasoning effort ID');
+                text(effort.name, 'reasoning effort name');
+                if (effort.description !== undefined)
+                    text(effort.description, 'reasoning effort description', 16384, true);
+                if (efforts.has(effort.id))
+                    fail('duplicate reasoning effort');
+                efforts.add(effort.id);
+            }
+            if (reasoning.defaultEffort !== undefined &&
+                !efforts.has(String(reasoning.defaultEffort)))
+                fail('default reasoning effort');
+        }
+    }
+    return data;
+}
+export function parseNativeProviderChunk(value) {
+    json(value, MAX_CHUNK_BYTES);
+    const data = record(value, 'stream chunk');
+    switch (data.type) {
+        case 'block-start':
+            keys(data, ['type', 'index', 'blockType'], [], 'block start');
+            integer(data.index, 'block index');
+            if (!['text', 'reasoning', 'tool-call'].includes(String(data.blockType)))
+                fail('stream block type');
+            break;
+        case 'text-delta':
+        case 'reasoning-delta':
+            keys(data, ['type', 'index', 'text'], [], 'text delta');
+            integer(data.index, 'block index');
+            text(data.text, 'text delta', MAX_CHUNK_BYTES, true);
+            break;
+        case 'tool-call-delta':
+            keys(data, ['type', 'index', 'id', 'argumentsDelta'], ['name'], 'tool delta');
+            integer(data.index, 'block index');
+            text(data.id, 'tool call ID');
+            text(data.argumentsDelta, 'tool arguments delta', MAX_CHUNK_BYTES, true);
+            if (data.name !== undefined)
+                text(data.name, 'tool name');
+            break;
+        case 'block-end':
+            keys(data, ['type', 'index', 'block'], [], 'block end');
+            integer(data.index, 'block index');
+            block(data.block);
+            break;
+        case 'usage': {
+            keys(data, ['type', 'usage'], [], 'usage chunk');
+            const usage = record(data.usage, 'usage');
+            keys(usage, ['inputTokens', 'outputTokens'], [
+                'totalTokens',
+                'cacheReadTokens',
+                'cacheWriteTokens',
+                'reasoningTokens',
+            ], 'usage');
+            Object.values(usage).forEach(value => integer(value, 'token usage'));
+            break;
+        }
+        case 'finish': {
+            keys(data, ['type', 'reason'], ['replayState'], 'finish chunk');
+            const reason = record(data.reason, 'finish reason');
+            if (reason.kind === 'error' || reason.kind === 'aborted') {
+                keys(reason, ['kind', 'failure'], [], 'failure reason');
+                const failure = record(reason.failure, 'failure');
+                keys(failure, ['message', 'code'], ['status', 'providerRetryAfterMs', 'requestId', 'offloadImages'], 'failure');
+                text(failure.message, 'failure message', MAX_CHUNK_BYTES, true);
+                text(failure.code, 'failure code');
+                for (const key of ['status', 'providerRetryAfterMs', 'offloadImages'])
+                    optionalInteger(failure, key);
+                if (failure.requestId !== undefined)
+                    text(failure.requestId, 'provider request ID');
+            }
+            else {
+                keys(reason, ['kind'], [], 'finish reason');
+                if (!['stop', 'tool-calls', 'max-tokens'].includes(String(reason.kind)))
+                    fail('finish reason kind');
+            }
+            if (data.replayState !== undefined) {
+                const replay = record(data.replayState, 'replay state');
+                keys(replay, ['response'], ['blocks'], 'replay state');
+                if (replay.blocks !== undefined && !Array.isArray(replay.blocks))
+                    fail('replay blocks');
+            }
+            break;
+        }
+        default:
+            fail('stream chunk type');
+    }
+    return data;
+}
+//# sourceMappingURL=native-provider-protocol.js.map

package/backend/dist/cordis/dsh/native-provider-protocol.js.map

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

package/backend/dist/cordis/dsh/provider-handler.d.ts

@@ -0,0 +1,36 @@
+import type { GenerationOptions } from '../../types/index.js';
+import { type BridgeCall, type BridgeModel, type LibreWebUiProviderHandler } from './librewebui-llm-adapter.js';
+/** An engine picker catalog, independently of Chat persona selection/prompts. */
+export declare function getCordisModelCatalog(userId: string): Promise<{
+    models: readonly BridgeModel[];
+    defaultModel?: string;
+}>;
+/**
+ * The model the engine should request when its own configuration names none.
+ *
+ * Read live from preferences so changing the default in the UI changes what the
+ * engine uses, rather than pinning a copy in the engine's settings document.
+ * @returns the model identifier, or undefined when the deployment has none.
+ */
+export declare function resolveEngineDefaultModel(userId?: string): Promise<string | undefined>;
+/** Resolve a text-only task through the same provider as an engine request. */
+export declare function resolveCordisProviderTarget(requestedModel: string, requestedUserId: string): Promise<{
+    model: string;
+    providerType: 'ollama' | 'plugin' | 'dsh';
+    providerId: string | null;
+}>;
+/**
+ * The options object the providers read for sampling controls.
+ *
+ * Exported for its regression test: the tool shape it produces is only
+ * observable at this boundary, because the engine normalises tool declarations
+ * before they reach the adapter that calls it.
+ * @param call - the engine's request.
+ * @returns options for Libre WebUI's provider layer.
+ */
+export declare function toGenerationOptions(call: BridgeCall): GenerationOptions;
+/** The handler the engine's adapter delegates to. */
+export declare const libreWebUiProviderHandler: LibreWebUiProviderHandler;
+/** Install a capability without borrowing an administrator's credentials. */
+export declare function installLibreWebUiProvider(): Promise<LibreWebUiProviderHandler>;
+//# sourceMappingURL=provider-handler.d.ts.map

package/backend/dist/cordis/dsh/provider-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-handler.d.ts","sourceRoot":"","sources":["../../../src/cordis/dsh/provider-handler.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAgB9B,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,WAAW,EAEhB,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AAiGrC,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,CAWD;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AA0DD,+EAA+E;AAC/E,wBAAsB,2BAA2B,CAC/C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAmBD;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAqBvE;AA6CD,qDAAqD;AACrD,eAAO,MAAM,yBAAyB,EAAE,yBA4TvC,CAAC;AAEF,6EAA6E;AAC7E,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAGpF"}