libre-webui 0.21.3 → 0.22.0

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

@@ -0,0 +1,166 @@
+import type Database from 'better-sqlite3';
+import { type DurableCancellationCode, type DurableChatCancellationDecision, type DurableChatCompletionMessage, type DurableJobActorFilter, type DurableJobCancellationSummary, type DurableJobAttemptMetadata, type DurableJobLease, type DurableJobListOptions, type DurableJobMetadata, type DurableResourceDeletionOccurrence, type DurableJobState } from './durableJobTypes.js';
+export interface StoredDurablePayload {
+    format: 'encrypted' | 'reference';
+    data: string;
+}
+export interface PreparedDurableJobEnqueue {
+    id: string;
+    jobType: string;
+    actorUserId: string;
+    payload: StoredDurablePayload;
+    idempotencyScope: string;
+    idempotencyKeyHash: string;
+    requestFingerprint: string;
+    maxAttempts: number;
+    priority: number;
+    availableAt: number;
+}
+export interface PreparedDurableEventAppend {
+    eventId: string;
+    requestFingerprint: string;
+    streamId: string;
+    eventType: string;
+    subjectId: string;
+    actorUserId: string | null;
+    payload: StoredDurablePayload;
+    occurredAt: number;
+}
+export interface PreparedDurableChatCompletion {
+    lease: {
+        jobId: string;
+        workerId: string;
+        leaseToken: number;
+    };
+    actorUserId: string;
+    sessionId: string;
+    expectedJobType: string;
+    expectedIdempotencyScope: string;
+    expectedIdempotencyKeyHash: string;
+    cancellationEventId: string;
+    message: DurableChatCompletionMessage;
+    event: PreparedDurableEventAppend;
+    beforeCommit?: () => void | Promise<void>;
+}
+export interface PreparedDurableChatCancellation {
+    actorUserId: string;
+    idempotencyScope: string;
+    idempotencyKeyHash: string;
+    doneEventId: string;
+    event: PreparedDurableEventAppend;
+}
+export interface StoredDurableEventRow {
+    cursor: number;
+    event_id: string;
+    request_fingerprint: string;
+    stream_id: string;
+    stream_sequence: number;
+    event_type: string;
+    subject_id: string;
+    actor_user_id: string | null;
+    payload_format: StoredDurablePayload['format'];
+    payload: string;
+    occurred_at: number;
+}
+export interface DurableHeartbeatResult {
+    owned: boolean;
+    cancellationRequested: boolean;
+}
+export interface StoredLifecycleRecoveryCandidate {
+    id: string;
+    jobType: string;
+    actorUserId: string;
+    payload: StoredDurablePayload;
+    priority: number;
+    updatedAt: number;
+}
+export interface DurableJobClaimResult {
+    lease: DurableJobLease | null;
+    terminalLifecycleJobIds: string[];
+}
+/**
+ * SQLite implementation of the durable job and event-log repository.
+ *
+ * Every state mutation and its event are committed by one IMMEDIATE
+ * transaction. Lease tokens only increase, so a reclaimed worker cannot later
+ * heartbeat or complete a job with a stale token.
+ */
+export declare class SQLiteDurableJobRepository {
+    private readonly database;
+    private readonly now;
+    constructor(database: Database.Database, now?: () => number);
+    private immediate;
+    private findRow;
+    private appendEventInTransaction;
+    private appendJobEvent;
+    enqueue(input: PreparedDurableJobEnqueue): DurableJobMetadata;
+    appendEvent(input: PreparedDurableEventAppend): number;
+    requestChatCancellation(input: PreparedDurableChatCancellation): DurableChatCancellationDecision;
+    /**
+     * Linearize the assistant row and its terminal event under the durable job
+     * fence. A worker crash can therefore expose both effects or neither.
+     */
+    publishChatCompletion(input: PreparedDurableChatCompletion): number;
+    private finishAttempt;
+    private reapExpired;
+    claimWithLifecycleRecovery(workerId: string, leaseMs: number): DurableJobClaimResult;
+    claim(workerId: string, leaseMs: number): DurableJobLease | null;
+    heartbeat(lease: DurableJobLease, leaseMs: number): DurableHeartbeatResult;
+    /**
+     * Read-only ownership and cancellation check. Unlike heartbeat this never
+     * extends the lease and never writes, so hot paths can call it per side
+     * effect without paying a transaction commit.
+     */
+    inspectLease(lease: DurableJobLease): DurableHeartbeatResult;
+    /**
+     * `global_cursor` is autoincrement and `occurred_at` comes from the same
+     * clock that orders appends, so the oldest row by cursor is also the oldest
+     * by time. The probe keeps an idle sweep at one row read instead of a scan.
+     */
+    private oldestEventOccurredAt;
+    private deleteOldestEvents;
+    /**
+     * Bounded removal of aged history. Chat stream chunks are transient live
+     * catch-up transport and dominate volume, so they get their own shorter
+     * window. Deletion-lifecycle job types are excluded: their terminal rows
+     * feed cleanup recovery and are reconciled by their own path.
+     */
+    pruneHistory(input: {
+        chatStreamEventCutoff: number;
+        eventCutoff: number;
+        jobCutoff: number;
+        limit: number;
+    }): {
+        chatStreamEvents: number;
+        events: number;
+        jobs: number;
+    };
+    /** Remove one finished stream and its head; events cascade with the head. */
+    deleteEventStream(streamId: string): number;
+    updateProgress(lease: DurableJobLease, current: number, total: number, message: string | null): void;
+    complete(lease: DurableJobLease, resultReference: string | null): void;
+    fail(lease: DurableJobLease, retryable: boolean, errorCode: string, errorSummary: string, nextAvailableAt: number): DurableJobState;
+    abandon(lease: DurableJobLease): DurableJobState;
+    private requestCancellationInTransaction;
+    requestCancellation(id: string, actorUserId: string, reason: DurableCancellationCode): DurableJobMetadata;
+    requestActorCancellation(actorUserId: string, reason: DurableCancellationCode, filter?: DurableJobActorFilter): DurableJobCancellationSummary;
+    countActiveForActor(actorUserId: string, filter?: DurableJobActorFilter): number;
+    countNonSucceededForActor(actorUserId: string, filter?: DurableJobActorFilter): number;
+    getMetadata(id: string): DurableJobMetadata | null;
+    listDeletionLifecycleRecoveryCandidates(afterId: string, limit: number): StoredLifecycleRecoveryCandidate[];
+    getDeletionLifecycleRecoveryCandidate(id: string): StoredLifecycleRecoveryCandidate | null;
+    markDeletionLifecycleRecoveryHandled(id: string, resultReference: string): void;
+    isPendingResourceDeletion(input: DurableResourceDeletionOccurrence): boolean;
+    isOwnerCleanupRequired(targetUserId: string): boolean;
+    getByIdempotency(actorUserId: string, idempotencyScope: string, idempotencyKeyHash: string): DurableJobMetadata | null;
+    listJobs(options: DurableJobListOptions): DurableJobMetadata[];
+    getStoredPayload(lease: DurableJobLease): StoredDurablePayload;
+    listAttempts(id: string): DurableJobAttemptMetadata[];
+    getStoredEvent(eventId: string): StoredDurableEventRow | null;
+    latestStoredEventCursor(streamId: string): number;
+    replayStoredEvents(afterCursor: number, limit: number, options?: {
+        streamId?: string;
+        subjectId?: string;
+    }): StoredDurableEventRow[];
+}
+//# sourceMappingURL=sqliteDurableJobRepository.d.ts.map

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

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