libre-webui 0.21.3 → 0.22.0

package/backend/dist/platform/events/durableEventGateway.js

@@ -0,0 +1,262 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+import { SHARED_COORDINATION_OPERATION_TIMEOUT_MS, withCoordinationTimeout, } from '../coordination/sharedAdmission.js';
+const WAKE_TOPIC = 'platform.events.available';
+const DEFAULT_POLL_INTERVAL_MS = 1000;
+const DEFAULT_BATCH_SIZE = 100;
+/**
+ * Ordered, replayable event fan-out.
+ *
+ * Redis is only a wake-up hint. Every subscriber resumes from the canonical
+ * SQL cursor, so a lost pub/sub message or replica restart cannot create an
+ * event gap. Handlers are awaited one at a time, which provides bounded
+ * backpressure instead of buffering an unbounded websocket/SSE queue.
+ */
+export class DurableEventGateway {
+    constructor(service, coordinator, coordinationTimeoutMs = SHARED_COORDINATION_OPERATION_TIMEOUT_MS) {
+        this.service = service;
+        this.coordinator = coordinator;
+        this.coordinationTimeoutMs = coordinationTimeoutMs;
+        this.closing = false;
+        this.subscriptions = new Set();
+    }
+    async append(input) {
+        if (this.closing)
+            throw new Error('Durable event gateway is closing.');
+        const cursor = await this.service.appendEvent(input);
+        return {
+            cursor,
+            fanoutNotified: await this.notify(cursor),
+        };
+    }
+    /**
+     * Best-effort wake after a transaction that appended one or more events.
+     * Failure never rolls back or hides the committed SQL event; polling is the
+     * recovery path and callers must not retry an external side effect merely
+     * because Redis was unavailable.
+     */
+    async notify(cursor) {
+        try {
+            await withCoordinationTimeout(this.coordinator.publish(WAKE_TOPIC, {
+                ...(cursor === undefined ? {} : { cursor }),
+            }), this.coordinationTimeoutMs);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Return the latest committed global cursor for one stream without replaying it. */
+    async latestCursor(streamId) {
+        if (this.closing)
+            throw new Error('Durable event gateway is closing.');
+        if (!streamId)
+            throw new Error('Event stream ID is required.');
+        return this.service.latestEventCursor(streamId);
+    }
+    async subscribe(options) {
+        if (this.closing)
+            throw new Error('Durable event gateway is closing.');
+        if (!Number.isSafeInteger(options.afterCursor) || options.afterCursor < 0) {
+            throw new Error('Event replay cursor must be a non-negative integer.');
+        }
+        const batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+        if (!Number.isSafeInteger(batchSize) || batchSize < 1 || batchSize > 500) {
+            throw new Error('Event replay batch size must be between 1 and 500.');
+        }
+        const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        if (!Number.isSafeInteger(pollIntervalMs) ||
+            pollIntervalMs < 100 ||
+            pollIntervalMs > 60000) {
+            throw new Error('Event polling interval must be between 100 and 60000 ms.');
+        }
+        const maxReplayEvents = options.maxReplayEvents ?? 10000;
+        if (!Number.isSafeInteger(maxReplayEvents) ||
+            maxReplayEvents < 1 ||
+            maxReplayEvents > 100000) {
+            throw new Error('Event replay bound must be between 1 and 100000.');
+        }
+        let cursor = options.afterCursor;
+        let replayed = 0;
+        let initialReplay = true;
+        let closed = false;
+        let draining;
+        let rerun = false;
+        let unsubscribe;
+        let timer;
+        let closePromise;
+        const safeErrors = new WeakMap();
+        const reportedErrors = new WeakSet();
+        const safeError = (error) => {
+            if (error !== null && typeof error === 'object') {
+                const cached = safeErrors.get(error);
+                if (cached)
+                    return cached;
+                const safe = error instanceof Error
+                    ? new Error(error.message || 'Durable event delivery failed.')
+                    : new Error('Durable event delivery failed.');
+                safeErrors.set(error, safe);
+                return safe;
+            }
+            return new Error('Durable event delivery failed.');
+        };
+        const report = (error) => {
+            const safe = safeError(error);
+            if (reportedErrors.has(safe))
+                return safe;
+            reportedErrors.add(safe);
+            try {
+                options.onError?.(safe);
+            }
+            catch {
+                // Error observers cannot replace the delivery failure or prevent
+                // deterministic subscription cleanup.
+            }
+            return safe;
+        };
+        const drain = async () => {
+            if (closed || options.signal?.aborted)
+                return;
+            if (draining) {
+                rerun = true;
+                return draining;
+            }
+            const operation = (async () => {
+                do {
+                    rerun = false;
+                    while (!closed && !options.signal?.aborted) {
+                        const events = await this.service.replayEvents(cursor, {
+                            limit: batchSize,
+                            ...(options.streamId ? { streamId: options.streamId } : {}),
+                            ...(options.subjectId ? { subjectId: options.subjectId } : {}),
+                        });
+                        if (events.length === 0)
+                            break;
+                        for (const event of events) {
+                            if (closed || options.signal?.aborted)
+                                return;
+                            if (options.authorize && !(await options.authorize())) {
+                                throw new Error('Durable event subscription authorization was revoked.');
+                            }
+                            if (closed || options.signal?.aborted)
+                                return;
+                            if (initialReplay)
+                                replayed += 1;
+                            if (initialReplay && replayed > maxReplayEvents) {
+                                throw new Error('Durable event replay exceeded the configured delivery bound.');
+                            }
+                            await options.onEvent(event);
+                            cursor = event.cursor;
+                        }
+                        if (events.length < batchSize)
+                            break;
+                    }
+                } while (rerun && !closed && !options.signal?.aborted);
+            })().finally(() => {
+                if (draining === operation)
+                    draining = undefined;
+            });
+            draining = operation;
+            return draining;
+        };
+        const close = async () => {
+            if (closePromise)
+                return closePromise;
+            closed = true;
+            closePromise = (async () => {
+                if (timer)
+                    clearInterval(timer);
+                timer = undefined;
+                options.signal?.removeEventListener('abort', closeOnAbort);
+                if (unsubscribe) {
+                    await withCoordinationTimeout(unsubscribe(), this.coordinationTimeoutMs).catch(report);
+                }
+                unsubscribe = undefined;
+                // The operation that initiated shutdown reports its own delivery
+                // failure. Waiting here must not report that same rejection twice.
+                await draining?.catch(() => undefined);
+                this.subscriptions.delete(close);
+            })();
+            return closePromise;
+        };
+        const closeOnAbort = () => void close();
+        const drainLive = () => drain().catch(error => {
+            report(error);
+        });
+        // Make an in-flight subscription setup visible to gateway shutdown and
+        // request cancellation before awaiting Redis. If the generic coordinator
+        // resolves after our deadline, tear down that late handler as well.
+        options.signal?.addEventListener('abort', closeOnAbort, { once: true });
+        this.subscriptions.add(close);
+        if (this.closing || options.signal?.aborted) {
+            await close();
+            if (options.signal?.aborted) {
+                throw options.signal.reason ?? new Error('Subscription cancelled.');
+            }
+            throw new Error('Durable event gateway is closing.');
+        }
+        // Subscribe before the initial SQL replay. A commit between these two
+        // operations produces a wake and/or is observed by the replay itself.
+        const pendingSubscribe = this.coordinator.subscribe(WAKE_TOPIC, drainLive);
+        try {
+            const candidate = await withCoordinationTimeout(pendingSubscribe, this.coordinationTimeoutMs);
+            if (closed || this.closing || options.signal?.aborted) {
+                await withCoordinationTimeout(candidate(), this.coordinationTimeoutMs).catch(report);
+            }
+            else {
+                unsubscribe = candidate;
+            }
+        }
+        catch {
+            // Redis fan-out is only a wake optimization. SQL polling below remains
+            // authoritative when subscription setup is unavailable or stalls.
+            unsubscribe = undefined;
+            void pendingSubscribe
+                .then(lateUnsubscribe => withCoordinationTimeout(lateUnsubscribe(), this.coordinationTimeoutMs).catch(report))
+                .catch(() => undefined);
+        }
+        if (closed || this.closing || options.signal?.aborted) {
+            await close();
+            if (options.signal?.aborted) {
+                throw options.signal.reason ?? new Error('Subscription cancelled.');
+            }
+            throw new Error('Durable event gateway is closing.');
+        }
+        timer = setInterval(() => void drainLive(), pollIntervalMs);
+        timer.unref?.();
+        try {
+            await drain();
+        }
+        catch (error) {
+            const safe = report(error);
+            await close();
+            throw safe;
+        }
+        if (closed || this.closing || options.signal?.aborted) {
+            await close();
+            if (options.signal?.aborted) {
+                throw options.signal.reason ?? new Error('Subscription cancelled.');
+            }
+            throw new Error('Durable event gateway is closing.');
+        }
+        initialReplay = false;
+        return {
+            get cursor() {
+                return cursor;
+            },
+            close,
+        };
+    }
+    async close() {
+        if (this.closing)
+            return;
+        this.closing = true;
+        await Promise.allSettled([...this.subscriptions].map(close => close()));
+        this.subscriptions.clear();
+    }
+}
+//# sourceMappingURL=durableEventGateway.js.map

package/backend/dist/platform/events/durableEventGateway.js.map

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

package/backend/dist/platform/events/index.d.ts

@@ -0,0 +1,3 @@
+export * from './durableEventGateway.js';
+export * from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/backend/dist/platform/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/events/index.ts"],"names":[],"mappings":"AAMA,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}

package/backend/dist/platform/events/index.js

@@ -0,0 +1,8 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+export * from './durableEventGateway.js';
+export * from './service.js';
+//# sourceMappingURL=index.js.map

package/backend/dist/platform/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platform/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC"}

package/backend/dist/platform/events/service.d.ts

@@ -0,0 +1,8 @@
+import type { Coordinator } from '../coordination/index.js';
+import type { DurableJobRuntimeService } from '../jobs/durableJobRuntime.js';
+import { DurableEventGateway } from './durableEventGateway.js';
+export declare const initializeDurableEventGateway: (service: DurableJobRuntimeService, coordinator: Coordinator) => DurableEventGateway;
+export declare const getDurableEventGateway: () => DurableEventGateway;
+export declare const getDurableEventGatewayIfInitialized: () => DurableEventGateway | undefined;
+export declare const closeDurableEventGateway: () => Promise<void>;
+//# sourceMappingURL=service.d.ts.map

package/backend/dist/platform/events/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/platform/events/service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D,eAAO,MAAM,6BAA6B,YAC/B,wBAAwB,eACpB,WAAW,KACvB,mBAIF,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,mBAGzC,CAAC;AAEF,eAAO,MAAM,mCAAmC,QAC9C,mBAAmB,GAAG,SAAoB,CAAC;AAE7C,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CAI7D,CAAC"}

package/backend/dist/platform/events/service.js

@@ -0,0 +1,25 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+import { DurableEventGateway } from './durableEventGateway.js';
+let gateway;
+export const initializeDurableEventGateway = (service, coordinator) => {
+    if (gateway)
+        throw new Error('Durable event gateway is already initialized.');
+    gateway = new DurableEventGateway(service, coordinator);
+    return gateway;
+};
+export const getDurableEventGateway = () => {
+    if (!gateway)
+        throw new Error('Durable event gateway is not initialized.');
+    return gateway;
+};
+export const getDurableEventGatewayIfInitialized = () => gateway;
+export const closeDurableEventGateway = async () => {
+    const current = gateway;
+    gateway = undefined;
+    await current?.close();
+};
+//# sourceMappingURL=service.js.map

package/backend/dist/platform/events/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/platform/events/service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,IAAI,OAAwC,CAAC;AAE7C,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,OAAiC,EACjC,WAAwB,EACH,EAAE;IACvB,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC9E,OAAO,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAwB,EAAE;IAC9D,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mCAAmC,GAAG,GACjB,EAAE,CAAC,OAAO,CAAC;AAE7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,IAAmB,EAAE;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC;IACxB,OAAO,GAAG,SAAS,CAAC;IACpB,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC,CAAC"}

package/backend/dist/platform/jobs/chatGenerationEnqueuer.d.ts

@@ -0,0 +1,3 @@
+import type { ChatGenerationEnqueuer } from '../../persistence/chatGenerationTypes.js';
+export declare const transactionalChatGenerationEnqueuer: ChatGenerationEnqueuer;
+//# sourceMappingURL=chatGenerationEnqueuer.d.ts.map

package/backend/dist/platform/jobs/chatGenerationEnqueuer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatGenerationEnqueuer.d.ts","sourceRoot":"","sources":["../../../src/platform/jobs/chatGenerationEnqueuer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,0CAA0C,CAAC;AAiClD,eAAO,MAAM,mCAAmC,EAAE,sBAsCjD,CAAC"}

package/backend/dist/platform/jobs/chatGenerationEnqueuer.js

@@ -0,0 +1,55 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+import { assertSelectedSQLiteTransaction } from '../../persistence/index.js';
+import { CHAT_GENERATE_JOB_TYPE, chatGenerationIdempotencyScope, } from './domainJobContracts.js';
+import { getDurableJobRuntime } from './durableJobRuntime.js';
+import { PostgresDurableJobService } from './postgresDurableJobService.js';
+import { durableEventId } from './durableEventIdentity.js';
+const durableInput = (input) => ({
+    jobType: CHAT_GENERATE_JOB_TYPE,
+    actorUserId: input.actorUserId,
+    idempotencyScope: chatGenerationIdempotencyScope(input.sessionId),
+    idempotencyKey: input.assistantMessageId,
+    payload: { mode: 'encrypted', value: input },
+    // Permit exactly one reclaim after worker death without blocking later
+    // prompts behind a long sequence of provider retries.
+    maxAttempts: 2,
+});
+const cancellationIdentity = (input) => ({
+    eventId: durableEventId('chat', input.sessionId, input.assistantMessageId, 'cancel-requested', input.actorUserId),
+    streamId: `chat:${input.sessionId}`,
+    subjectId: input.assistantMessageId,
+    actorUserId: input.actorUserId,
+});
+export const transactionalChatGenerationEnqueuer = {
+    enqueueSQLite(_executor, input) {
+        assertSelectedSQLiteTransaction();
+        const service = getDurableJobRuntime().service;
+        if (service instanceof PostgresDurableJobService) {
+            throw new Error('Selected durable job service is not SQLite.');
+        }
+        const cancellation = cancellationIdentity(input);
+        const cancellationCommitted = service.getEvent(cancellation.eventId);
+        const existing = service.getByIdempotency(input.actorUserId, chatGenerationIdempotencyScope(input.sessionId), input.assistantMessageId);
+        const job = service.enqueue(durableInput(input));
+        if (cancellationCommitted?.streamId === cancellation.streamId &&
+            cancellationCommitted.eventType === 'chat.cancel-requested.v1' &&
+            cancellationCommitted.subjectId === cancellation.subjectId &&
+            cancellationCommitted.actorUserId === cancellation.actorUserId) {
+            service.cancel(job.id, input.actorUserId, 'user-requested');
+        }
+        return { created: existing === null };
+    },
+    async enqueuePostgres(executor, input) {
+        const service = getDurableJobRuntime().service;
+        if (!(service instanceof PostgresDurableJobService)) {
+            throw new Error('Selected durable job service is not PostgreSQL.');
+        }
+        const enqueue = await service.enqueueChatGenerationWithExecutor(executor, durableInput(input), cancellationIdentity(input));
+        return { created: enqueue.created };
+    },
+};
+//# sourceMappingURL=chatGenerationEnqueuer.js.map

package/backend/dist/platform/jobs/chatGenerationEnqueuer.js.map

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

package/backend/dist/platform/jobs/documentIngestionEnqueuer.d.ts

@@ -0,0 +1,3 @@
+import type { TransactionalDocumentIngestionEnqueuer } from '../storage/platformDomainRepositories.js';
+export declare const transactionalDocumentIngestionEnqueuer: TransactionalDocumentIngestionEnqueuer;
+//# sourceMappingURL=documentIngestionEnqueuer.d.ts.map

package/backend/dist/platform/jobs/documentIngestionEnqueuer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentIngestionEnqueuer.d.ts","sourceRoot":"","sources":["../../../src/platform/jobs/documentIngestionEnqueuer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,sCAAsC,EAEvC,MAAM,0CAA0C,CAAC;AAoBlD,eAAO,MAAM,sCAAsC,EAAE,sCAkBlD,CAAC"}

package/backend/dist/platform/jobs/documentIngestionEnqueuer.js

@@ -0,0 +1,38 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+import { assertSelectedSQLiteTransaction } from '../../persistence/index.js';
+import { DOCUMENT_INGEST_IDEMPOTENCY_SCOPE, DOCUMENT_INGEST_JOB_TYPE, } from './domainJobContracts.js';
+import { getDurableJobRuntime } from './durableJobRuntime.js';
+import { PostgresDurableJobService } from './postgresDurableJobService.js';
+const durableInput = (input) => ({
+    jobType: DOCUMENT_INGEST_JOB_TYPE,
+    actorUserId: input.ownerUserId,
+    idempotencyScope: DOCUMENT_INGEST_IDEMPOTENCY_SCOPE,
+    idempotencyKey: input.documentId,
+    payload: {
+        mode: 'encrypted',
+        value: { documentId: input.documentId },
+    },
+    maxAttempts: 5,
+});
+export const transactionalDocumentIngestionEnqueuer = {
+    enqueueSQLite(_executor, input) {
+        assertSelectedSQLiteTransaction();
+        const service = getDurableJobRuntime().service;
+        if (service instanceof PostgresDurableJobService) {
+            throw new Error('Selected durable job service is not SQLite.');
+        }
+        service.enqueue(durableInput(input));
+    },
+    async enqueuePostgres(executor, input) {
+        const service = getDurableJobRuntime().service;
+        if (!(service instanceof PostgresDurableJobService)) {
+            throw new Error('Selected durable job service is not PostgreSQL.');
+        }
+        await service.enqueueWithExecutor(executor, durableInput(input));
+    },
+};
+//# sourceMappingURL=documentIngestionEnqueuer.js.map

package/backend/dist/platform/jobs/documentIngestionEnqueuer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentIngestionEnqueuer.js","sourceRoot":"","sources":["../../../src/platform/jobs/documentIngestionEnqueuer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAK7E,OAAO,EACL,iCAAiC,EACjC,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,YAAY,GAAG,CAAC,KAA0C,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,EAAE,wBAAwB;IACjC,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,gBAAgB,EAAE,iCAAiC;IACnD,cAAc,EAAE,KAAK,CAAC,UAAU;IAChC,OAAO,EAAE;QACP,IAAI,EAAE,WAAoB;QAC1B,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;KACxC;IACD,WAAW,EAAE,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sCAAsC,GACjD;IACE,aAAa,CAAC,SAAS,EAAE,KAAK;QAC5B,+BAA+B,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC,OAAO,CAAC;QAC/C,IAAI,OAAO,YAAY,yBAAyB,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK;QACnC,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC,OAAO,CAAC;QAC/C,IAAI,CAAC,CAAC,OAAO,YAAY,yBAAyB,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;CACF,CAAC"}

package/backend/dist/platform/jobs/domainJobContracts.d.ts

@@ -0,0 +1,30 @@
+export declare const VIDEO_RESUME_JOB_TYPE = "media.video.resume.v1";
+export declare const VIDEO_RESUME_IDEMPOTENCY_SCOPE = "media.video.resume.v1";
+export declare const VIDEO_SUBMIT_JOB_TYPE = "media.video.submit.v1";
+export declare const VIDEO_SUBMIT_IDEMPOTENCY_SCOPE = "media.video.submit.v1";
+export declare const RESOURCE_DELETE_JOB_TYPE = "resource.delete.v1";
+export declare const RESOURCE_DELETE_IDEMPOTENCY_SCOPE = "resource.delete.v1";
+export declare const RESOURCE_DELETE_RECOVERY_IDEMPOTENCY_SCOPE = "resource.delete.v1:recovery";
+export declare const DOCUMENT_INGEST_JOB_TYPE = "document.extract-embed.v1";
+export declare const DOCUMENT_INGEST_IDEMPOTENCY_SCOPE = "document.extract-embed.v1";
+export declare const CHAT_GENERATE_JOB_TYPE = "chat.generate.v1";
+export declare const CHAT_GENERATE_IDEMPOTENCY_SCOPE = "chat.generate.v1";
+export declare const chatGenerationIdempotencyScope: (sessionId: string) => string;
+export declare const chatEventStreamId: (sessionId: string) => string;
+export declare const OWNER_DELETE_CONTENT_JOB_TYPE = "owner.delete-content.v1";
+export declare const OWNER_DELETE_CONTENT_IDEMPOTENCY_SCOPE = "owner.delete-content.v1";
+export declare const OWNER_DELETE_CONTENT_RECOVERY_IDEMPOTENCY_SCOPE = "owner.delete-content.v1:recovery";
+export declare const DELETION_LIFECYCLE_RECOVERY_REFERENCE_PREFIX = "lifecycle-recovery:";
+export declare const DELETION_LIFECYCLE_RECOVERY_NOT_REQUIRED_REFERENCE = "lifecycle-recovery:not-required";
+export declare const WORK_EXECUTE_JOB_TYPE = "work.execute.v1";
+export declare const WORK_EXECUTE_IDEMPOTENCY_SCOPE = "work.execute.v1";
+/**
+ * Only failures produced after a lifecycle payload was authenticated and its
+ * cleanup handler reached a retryable boundary may receive a successor job.
+ * Corrupt payloads, revoked actors, and unsupported handlers remain terminal.
+ */
+export declare const RESOURCE_DELETE_RECOVERABLE_ERROR_CODES: readonly string[];
+export declare const OWNER_DELETE_CONTENT_RECOVERABLE_ERROR_CODES: readonly string[];
+/** A successor never becomes claimable in the same outage hot loop. */
+export declare const DELETION_LIFECYCLE_RECOVERY_DELAY_MS = 60000;
+//# sourceMappingURL=domainJobContracts.d.ts.map

package/backend/dist/platform/jobs/domainJobContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainJobContracts.d.ts","sourceRoot":"","sources":["../../../src/platform/jobs/domainJobContracts.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AACtE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AACtE,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,eAAO,MAAM,iCAAiC,uBAAuB,CAAC;AACtE,eAAO,MAAM,0CAA0C,gCACxB,CAAC;AAChC,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AACpE,eAAO,MAAM,iCAAiC,8BAA8B,CAAC;AAC7E,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,+BAA+B,qBAAqB,CAAC;AAClE,eAAO,MAAM,8BAA8B,cAAe,MAAM,KAAG,MAChB,CAAC;AACpD,eAAO,MAAM,iBAAiB,cAAe,MAAM,KAAG,MACjC,CAAC;AACtB,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AACvE,eAAO,MAAM,sCAAsC,4BAA4B,CAAC;AAChF,eAAO,MAAM,+CAA+C,qCACxB,CAAC;AACrC,eAAO,MAAM,4CAA4C,wBAClC,CAAC;AACxB,eAAO,MAAM,kDAAkD,oCAAgE,CAAC;AAChI,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,8BAA8B,oBAAoB,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,mBAUlD,CAAC;AACH,eAAO,MAAM,4CAA4C,mBAQvD,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,QAAS,CAAC"}

package/backend/dist/platform/jobs/domainJobContracts.js

@@ -0,0 +1,53 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ */
+export const VIDEO_RESUME_JOB_TYPE = 'media.video.resume.v1';
+export const VIDEO_RESUME_IDEMPOTENCY_SCOPE = 'media.video.resume.v1';
+export const VIDEO_SUBMIT_JOB_TYPE = 'media.video.submit.v1';
+export const VIDEO_SUBMIT_IDEMPOTENCY_SCOPE = 'media.video.submit.v1';
+export const RESOURCE_DELETE_JOB_TYPE = 'resource.delete.v1';
+export const RESOURCE_DELETE_IDEMPOTENCY_SCOPE = 'resource.delete.v1';
+export const RESOURCE_DELETE_RECOVERY_IDEMPOTENCY_SCOPE = 'resource.delete.v1:recovery';
+export const DOCUMENT_INGEST_JOB_TYPE = 'document.extract-embed.v1';
+export const DOCUMENT_INGEST_IDEMPOTENCY_SCOPE = 'document.extract-embed.v1';
+export const CHAT_GENERATE_JOB_TYPE = 'chat.generate.v1';
+export const CHAT_GENERATE_IDEMPOTENCY_SCOPE = 'chat.generate.v1';
+export const chatGenerationIdempotencyScope = (sessionId) => `${CHAT_GENERATE_IDEMPOTENCY_SCOPE}:${sessionId}`;
+export const chatEventStreamId = (sessionId) => `chat:${sessionId}`;
+export const OWNER_DELETE_CONTENT_JOB_TYPE = 'owner.delete-content.v1';
+export const OWNER_DELETE_CONTENT_IDEMPOTENCY_SCOPE = 'owner.delete-content.v1';
+export const OWNER_DELETE_CONTENT_RECOVERY_IDEMPOTENCY_SCOPE = 'owner.delete-content.v1:recovery';
+export const DELETION_LIFECYCLE_RECOVERY_REFERENCE_PREFIX = 'lifecycle-recovery:';
+export const DELETION_LIFECYCLE_RECOVERY_NOT_REQUIRED_REFERENCE = `${DELETION_LIFECYCLE_RECOVERY_REFERENCE_PREFIX}not-required`;
+export const WORK_EXECUTE_JOB_TYPE = 'work.execute.v1';
+export const WORK_EXECUTE_IDEMPOTENCY_SCOPE = 'work.execute.v1';
+/**
+ * Only failures produced after a lifecycle payload was authenticated and its
+ * cleanup handler reached a retryable boundary may receive a successor job.
+ * Corrupt payloads, revoked actors, and unsupported handlers remain terminal.
+ */
+export const RESOURCE_DELETE_RECOVERABLE_ERROR_CODES = Object.freeze([
+    'resource-busy',
+    'coordination-unavailable',
+    'resource-lease-lost',
+    'resource-work-draining',
+    'resource-cleanup-failed',
+    'cache-invalidation-failed',
+    'resource-tombstone-lost',
+    'lease-expired',
+    'worker-shutdown',
+]);
+export const OWNER_DELETE_CONTENT_RECOVERABLE_ERROR_CODES = Object.freeze([
+    'resource-busy',
+    'coordination-unavailable',
+    'resource-lease-lost',
+    'owner-jobs-draining',
+    'owner-cleanup-failed',
+    'lease-expired',
+    'worker-shutdown',
+]);
+/** A successor never becomes claimable in the same outage hot loop. */
+export const DELETION_LIFECYCLE_RECOVERY_DELAY_MS = 60000;
+//# sourceMappingURL=domainJobContracts.js.map

package/backend/dist/platform/jobs/domainJobContracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainJobContracts.js","sourceRoot":"","sources":["../../../src/platform/jobs/domainJobContracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;AACtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,oBAAoB,CAAC;AACtE,MAAM,CAAC,MAAM,0CAA0C,GACrD,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AACpE,MAAM,CAAC,MAAM,iCAAiC,GAAG,2BAA2B,CAAC;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AACzD,MAAM,CAAC,MAAM,+BAA+B,GAAG,kBAAkB,CAAC;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,SAAiB,EAAU,EAAE,CAC1E,GAAG,+BAA+B,IAAI,SAAS,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAC7D,QAAQ,SAAS,EAAE,CAAC;AACtB,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,sCAAsC,GAAG,yBAAyB,CAAC;AAChF,MAAM,CAAC,MAAM,+CAA+C,GAC1D,kCAAkC,CAAC;AACrC,MAAM,CAAC,MAAM,4CAA4C,GACvD,qBAAqB,CAAC;AACxB,MAAM,CAAC,MAAM,kDAAkD,GAAG,GAAG,4CAA4C,cAAc,CAAC;AAChI,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACvD,MAAM,CAAC,MAAM,8BAA8B,GAAG,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnE,eAAe;IACf,0BAA0B;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,yBAAyB;IACzB,2BAA2B;IAC3B,yBAAyB;IACzB,eAAe;IACf,iBAAiB;CAClB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,MAAM,CAAC,MAAM,CAAC;IACxE,eAAe;IACf,0BAA0B;IAC1B,qBAAqB;IACrB,qBAAqB;IACrB,sBAAsB;IACtB,eAAe;IACf,iBAAiB;CAClB,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,oCAAoC,GAAG,KAAM,CAAC"}

package/backend/dist/platform/jobs/domainJobHandlers.d.ts

@@ -0,0 +1,11 @@
+import type { Coordinator } from '../coordination/types.js';
+import type { DurableJobHandler } from './embeddedDurableJobWorker.js';
+import type { DurableJobExecutionContext } from './embeddedDurableJobWorker.js';
+export interface ResourceLeaseReservation {
+    readonly signal: AbortSignal;
+    extend(): Promise<boolean>;
+    release(): Promise<boolean>;
+}
+export declare const acquireResourceLease: (context: DurableJobExecutionContext, resourceType: string, resourceId: string, coordinator?: Coordinator, operationTimeoutMs?: number) => Promise<ResourceLeaseReservation>;
+export declare const createDomainDurableJobHandlers: () => ReadonlyMap<string, DurableJobHandler>;
+//# sourceMappingURL=domainJobHandlers.d.ts.map

package/backend/dist/platform/jobs/domainJobHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainJobHandlers.d.ts","sourceRoot":"","sources":["../../../src/platform/jobs/domainJobHandlers.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAcvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAqBhF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAsBD,eAAO,MAAM,oBAAoB,YACtB,0BAA0B,gBACrB,MAAM,cACR,MAAM,gBACL,WAAW,kCAEvB,OAAO,CAAC,wBAAwB,CAwGlC,CAAC;AAwuBF,eAAO,MAAM,8BAA8B,QAAO,WAAW,CAC3D,MAAM,EACN,iBAAiB,CAUf,CAAC"}