nduka 1.0.0

package/dist/media/queue-admin.js

@@ -0,0 +1,47 @@
+import { DatabaseManager } from '../database/index.js';
+import { boundedMediaQueueLimit, cleanQueueText, mapMediaQueueRow, MAX_MEDIA_QUEUE_ERROR_LENGTH } from './queue-utils.js';
+export class MediaQueueAdmin {
+    db = DatabaseManager.getInstance();
+    get(id) {
+        const row = this.db.getDb().prepare(`${selectSql()} WHERE id = ?`).get(id);
+        return row ? mapMediaQueueRow(row) : null;
+    }
+    recent(limit = 20) {
+        return this.db.getDb().prepare(`${selectSql()} ORDER BY updated_at DESC, id DESC LIMIT ?`)
+            .all(boundedMediaQueueLimit(limit))
+            .map((row) => mapMediaQueueRow(row));
+    }
+    byStatus(status, limit = 20) {
+        return this.db.getDb().prepare(`${selectSql()} WHERE status = ? ORDER BY updated_at DESC, id DESC LIMIT ?`)
+            .all(status, boundedMediaQueueLimit(limit))
+            .map((row) => mapMediaQueueRow(row));
+    }
+    moveToQueued(id, from, now = Date.now()) {
+        if (from.length === 0)
+            return false;
+        const placeholders = from.map(() => '?').join(', ');
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'QUEUED', available_at = ?, started_at = NULL, completed_at = NULL, updated_at = ?, error_code = NULL, error_message = NULL
+      WHERE id = ? AND status IN (${placeholders})
+    `).run(now, now, id, ...from);
+        return result.changes > 0;
+    }
+    markSkipped(id, reason, now = Date.now()) {
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'CANCELLED', updated_at = ?, error_code = 'SKIPPED_BY_ADMIN', error_message = ?
+      WHERE id = ? AND status IN ('QUEUED', 'FAILED', 'OWNER_REVIEW')
+    `).run(now, cleanQueueText(reason || 'Skipped by admin.', MAX_MEDIA_QUEUE_ERROR_LENGTH), id);
+        return result.changes > 0;
+    }
+}
+function selectSql() {
+    return `
+    SELECT id, dedupe_key, chat_jid, message_id, media_id, sha256, file_path, mime_type, file_name, file_size,
+      task, profile_json, status, attempts, max_attempts, available_at, created_at, updated_at,
+      started_at, completed_at, error_code, error_message, result_text
+    FROM media_queue
+  `;
+}
+//# sourceMappingURL=queue-admin.js.map

package/dist/media/queue-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-admin.js","sourceRoot":"","sources":["../../src/media/queue-admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAE1H,MAAM,OAAO,eAAe;IAClB,EAAE,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;IAE3C,GAAG,CAAC,EAAU;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,CAA8B,CAAC;QACxG,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QACf,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,4CAA4C,CAAC;aACvF,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;aAClC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAoB,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,MAAwB,EAAE,KAAK,GAAG,EAAE;QAC3C,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,6DAA6D,CAAC;aACxG,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;aAC1C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAoB,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,YAAY,CAAC,EAAU,EAAE,IAAwB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACjE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;oCAGP,YAAY;KAC3C,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,EAAU,EAAE,MAAc,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;;KAItC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,IAAI,mBAAmB,EAAE,4BAA4B,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7F,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,SAAS,SAAS;IAChB,OAAO;;;;;GAKN,CAAC;AACJ,CAAC"}

package/dist/media/queue-runner.d.ts

@@ -0,0 +1,28 @@
+import type { OcrResult } from '../llm/ocr-types.js';
+import { MediaQueueStore, type MediaQueueItem } from './queue-store.js';
+export interface MediaQueueRunResult {
+    due: number;
+    completed: number;
+    retried: number;
+    failed: number;
+    ownerReview: number;
+}
+export type MediaQueueProcessor = (item: MediaQueueItem) => Promise<OcrResult>;
+export interface MediaQueueRunnerOptions {
+    store?: MediaQueueStore;
+    processor?: MediaQueueProcessor;
+    now?: () => number;
+    baseRetryDelayMs?: number;
+    maxRetryDelayMs?: number;
+}
+export declare class MediaQueueRunner {
+    private store;
+    private processor;
+    private now;
+    private baseRetryDelayMs;
+    private maxRetryDelayMs;
+    constructor(options?: MediaQueueRunnerOptions);
+    tick(limit?: number): Promise<MediaQueueRunResult>;
+    private retryDelay;
+}
+//# sourceMappingURL=queue-runner.d.ts.map

package/dist/media/queue-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-runner.d.ts","sourceRoot":"","sources":["../../src/media/queue-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,GAAE,uBAA4B;IAQ3C,IAAI,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsCnD,OAAO,CAAC,UAAU;CAInB"}

package/dist/media/queue-runner.js

@@ -0,0 +1,71 @@
+import { OcrClient } from '../llm/ocr-client.js';
+import { MediaQueueStore } from './queue-store.js';
+const DEFAULT_BASE_RETRY_DELAY_MS = 30_000;
+const DEFAULT_MAX_RETRY_DELAY_MS = 15 * 60_000;
+export class MediaQueueRunner {
+    store;
+    processor;
+    now;
+    baseRetryDelayMs;
+    maxRetryDelayMs;
+    constructor(options = {}) {
+        this.store = options.store || new MediaQueueStore();
+        this.processor = options.processor || defaultProcessor;
+        this.now = options.now || Date.now;
+        this.baseRetryDelayMs = options.baseRetryDelayMs || DEFAULT_BASE_RETRY_DELAY_MS;
+        this.maxRetryDelayMs = options.maxRetryDelayMs || DEFAULT_MAX_RETRY_DELAY_MS;
+    }
+    async tick(limit = 5) {
+        const items = this.store.claimNext(this.now(), limit);
+        const result = { due: items.length, completed: 0, retried: 0, failed: 0, ownerReview: 0 };
+        for (const item of items) {
+            try {
+                const ocr = await this.processor(item);
+                if (ocr.ok) {
+                    if (this.store.markCompleted(item.id, ocr.text))
+                        result.completed += 1;
+                    continue;
+                }
+                if (ocr.errorCode === 'OWNER_REVIEW') {
+                    if (this.store.markOwnerReview(item.id, ocr.errorMessage))
+                        result.ownerReview += 1;
+                    continue;
+                }
+                if (ocr.retryable && item.attempts < item.maxAttempts) {
+                    const availableAt = this.now() + this.retryDelay(item.attempts);
+                    if (this.store.requeue(item.id, { availableAt, errorCode: ocr.errorCode, errorMessage: ocr.errorMessage }))
+                        result.retried += 1;
+                    continue;
+                }
+                if (this.store.markFailed(item.id, ocr.errorCode, ocr.errorMessage))
+                    result.failed += 1;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unexpected media queue processor error.';
+                if (item.attempts < item.maxAttempts) {
+                    const availableAt = this.now() + this.retryDelay(item.attempts);
+                    if (this.store.requeue(item.id, { availableAt, errorCode: 'PROCESSOR_ERROR', errorMessage: message }))
+                        result.retried += 1;
+                }
+                else if (this.store.markFailed(item.id, 'PROCESSOR_ERROR', message)) {
+                    result.failed += 1;
+                }
+            }
+        }
+        return result;
+    }
+    retryDelay(attempts) {
+        const multiplier = 2 ** Math.max(0, attempts - 1);
+        return Math.min(this.maxRetryDelayMs, this.baseRetryDelayMs * multiplier);
+    }
+}
+async function defaultProcessor(item) {
+    return new OcrClient().run({
+        task: item.task,
+        filePath: item.filePath || undefined,
+        mimeType: item.mimeType || undefined,
+        fileName: item.fileName || undefined,
+        profile: item.profile,
+    });
+}
+//# sourceMappingURL=queue-runner.js.map

package/dist/media/queue-runner.js.map

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

package/dist/media/queue-store.d.ts

@@ -0,0 +1,27 @@
+import type { EnqueueMediaInput, EnqueueResult, MediaQueueItem, MediaQueueStatus } from './queue-types.js';
+export declare class MediaQueueStore {
+    private db;
+    private initialized;
+    constructor();
+    private init;
+    enqueue(input: EnqueueMediaInput): EnqueueResult;
+    enqueueOwnerReview(input: EnqueueMediaInput, reason: string): EnqueueResult;
+    get(id: number): MediaQueueItem | null;
+    findByDedupeKey(dedupeKey: string): MediaQueueItem | null;
+    listByStatus(status: MediaQueueStatus, limit?: number): MediaQueueItem[];
+    listForChat(chatJid: string, limit?: number): MediaQueueItem[];
+    claimNext(now?: number, limit?: number): MediaQueueItem[];
+    requeue(id: number, input: {
+        availableAt: number;
+        errorCode?: string | null;
+        errorMessage?: string | null;
+    }): boolean;
+    markCompleted(id: number, resultText: string): boolean;
+    markFailed(id: number, errorCode: string, errorMessage: string): boolean;
+    markOwnerReview(id: number, reason: string): boolean;
+    cancel(id: number): boolean;
+    private insert;
+}
+export type { EnqueueMediaInput, EnqueueResult, MediaQueueItem, MediaQueueStatus } from './queue-types.js';
+export { buildMediaQueueDedupeKey } from './queue-utils.js';
+//# sourceMappingURL=queue-store.d.ts.map

package/dist/media/queue-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-store.d.ts","sourceRoot":"","sources":["../../src/media/queue-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAiB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAW1H,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,WAAW,CAAS;;IAM5B,OAAO,CAAC,IAAI;IAkCZ,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa;IAIhD,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAI3E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKtC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKzD,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAMpE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAM1D,SAAS,CAAC,GAAG,SAAa,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAgBzD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO;IAUrH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAUtD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAUxE,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAUpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAM3B,OAAO,CAAC,MAAM;CAiCf;AAWD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/media/queue-store.js

@@ -0,0 +1,147 @@
+import { DatabaseManager } from '../database/index.js';
+import { boundedMediaQueueLimit, buildMediaQueueDedupeKey, cleanQueueText, mapMediaQueueRow, MAX_MEDIA_QUEUE_ERROR_LENGTH, MAX_MEDIA_QUEUE_RESULT_LENGTH, requireMediaQueueChatJid, } from './queue-utils.js';
+export class MediaQueueStore {
+    db = DatabaseManager.getInstance();
+    initialized = false;
+    constructor() {
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS media_queue (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        dedupe_key TEXT UNIQUE NOT NULL,
+        chat_jid TEXT NOT NULL,
+        message_id TEXT,
+        media_id TEXT,
+        sha256 TEXT,
+        file_path TEXT,
+        mime_type TEXT,
+        file_name TEXT,
+        file_size INTEGER,
+        task TEXT NOT NULL,
+        profile_json TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'QUEUED',
+        attempts INTEGER NOT NULL DEFAULT 0,
+        max_attempts INTEGER NOT NULL DEFAULT 3,
+        available_at INTEGER NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        started_at INTEGER,
+        completed_at INTEGER,
+        error_code TEXT,
+        error_message TEXT,
+        result_text TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_media_queue_due ON media_queue(status, available_at, id);
+      CREATE INDEX IF NOT EXISTS idx_media_queue_chat ON media_queue(chat_jid, status);
+    `);
+        this.initialized = true;
+    }
+    enqueue(input) {
+        return this.insert(input, 'QUEUED');
+    }
+    enqueueOwnerReview(input, reason) {
+        return this.insert(input, 'OWNER_REVIEW', 'OWNER_REVIEW', reason);
+    }
+    get(id) {
+        const row = this.db.getDb().prepare(`${selectSql()} WHERE id = ?`).get(id);
+        return row ? mapMediaQueueRow(row) : null;
+    }
+    findByDedupeKey(dedupeKey) {
+        const row = this.db.getDb().prepare(`${selectSql()} WHERE dedupe_key = ?`).get(dedupeKey);
+        return row ? mapMediaQueueRow(row) : null;
+    }
+    listByStatus(status, limit = 20) {
+        return this.db.getDb().prepare(`${selectSql()} WHERE status = ? ORDER BY available_at ASC, id ASC LIMIT ?`)
+            .all(status, boundedMediaQueueLimit(limit))
+            .map((row) => mapMediaQueueRow(row));
+    }
+    listForChat(chatJid, limit = 20) {
+        return this.db.getDb().prepare(`${selectSql()} WHERE chat_jid = ? ORDER BY created_at DESC, id DESC LIMIT ?`)
+            .all(chatJid, boundedMediaQueueLimit(limit))
+            .map((row) => mapMediaQueueRow(row));
+    }
+    claimNext(now = Date.now(), limit = 10) {
+        const rows = this.db.getDb().prepare(`${selectSql()} WHERE status = 'QUEUED' AND available_at <= ? ORDER BY available_at ASC, id ASC LIMIT ?`)
+            .all(now, boundedMediaQueueLimit(limit));
+        const claimed = [];
+        const update = this.db.getDb().prepare(`UPDATE media_queue SET status = 'PROCESSING', attempts = attempts + 1, started_at = ?, updated_at = ? WHERE id = ? AND status = 'QUEUED'`);
+        for (const row of rows) {
+            const result = update.run(now, now, row.id);
+            if (result.changes > 0) {
+                const item = this.get(row.id);
+                if (item)
+                    claimed.push(item);
+            }
+        }
+        return claimed;
+    }
+    requeue(id, input) {
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'QUEUED', available_at = ?, started_at = NULL, updated_at = ?, error_code = ?, error_message = ?
+      WHERE id = ? AND status = 'PROCESSING'
+    `).run(input.availableAt, now, cleanQueueText(input.errorCode), cleanQueueText(input.errorMessage, MAX_MEDIA_QUEUE_ERROR_LENGTH), id);
+        return result.changes > 0;
+    }
+    markCompleted(id, resultText) {
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'COMPLETED', completed_at = ?, updated_at = ?, error_code = NULL, error_message = NULL, result_text = ?
+      WHERE id = ? AND status IN ('QUEUED', 'PROCESSING')
+    `).run(now, now, cleanQueueText(resultText, MAX_MEDIA_QUEUE_RESULT_LENGTH), id);
+        return result.changes > 0;
+    }
+    markFailed(id, errorCode, errorMessage) {
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'FAILED', completed_at = ?, updated_at = ?, error_code = ?, error_message = ?
+      WHERE id = ? AND status IN ('QUEUED', 'PROCESSING')
+    `).run(now, now, cleanQueueText(errorCode), cleanQueueText(errorMessage, MAX_MEDIA_QUEUE_ERROR_LENGTH), id);
+        return result.changes > 0;
+    }
+    markOwnerReview(id, reason) {
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`
+      UPDATE media_queue
+      SET status = 'OWNER_REVIEW', updated_at = ?, error_code = 'OWNER_REVIEW', error_message = ?
+      WHERE id = ? AND status IN ('QUEUED', 'PROCESSING', 'FAILED')
+    `).run(now, cleanQueueText(reason, MAX_MEDIA_QUEUE_ERROR_LENGTH), id);
+        return result.changes > 0;
+    }
+    cancel(id) {
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`UPDATE media_queue SET status = 'CANCELLED', updated_at = ? WHERE id = ? AND status IN ('QUEUED', 'PROCESSING', 'OWNER_REVIEW')`).run(now, id);
+        return result.changes > 0;
+    }
+    insert(input, status, errorCode, errorMessage) {
+        const dedupeKey = buildMediaQueueDedupeKey(input);
+        const now = Date.now();
+        const result = this.db.getDb().prepare(`
+      INSERT OR IGNORE INTO media_queue (
+        dedupe_key, chat_jid, message_id, media_id, sha256, file_path, mime_type, file_name, file_size,
+        task, profile_json, status, attempts, max_attempts, available_at, created_at, updated_at, error_code, error_message
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?, ?, ?, ?, ?)
+    `).run(dedupeKey, requireMediaQueueChatJid(input.chatJid), cleanQueueText(input.messageId), cleanQueueText(input.mediaId), cleanQueueText(input.sha256), cleanQueueText(input.filePath), cleanQueueText(input.mimeType), cleanQueueText(input.fileName, 240), input.fileSize ?? null, input.task, JSON.stringify(input.profile), status, Math.max(1, Math.min(input.maxAttempts || 3, 10)), input.availableAt || now, now, now, cleanQueueText(errorCode), cleanQueueText(errorMessage, MAX_MEDIA_QUEUE_ERROR_LENGTH));
+        const item = this.findByDedupeKey(dedupeKey);
+        if (!item)
+            throw new Error('Failed to enqueue media item.');
+        return { item, created: result.changes > 0 };
+    }
+}
+function selectSql() {
+    return `
+    SELECT id, dedupe_key, chat_jid, message_id, media_id, sha256, file_path, mime_type, file_name, file_size,
+      task, profile_json, status, attempts, max_attempts, available_at, created_at, updated_at,
+      started_at, completed_at, error_code, error_message, result_text
+    FROM media_queue
+  `;
+}
+export { buildMediaQueueDedupeKey } from './queue-utils.js';
+//# sourceMappingURL=queue-store.js.map

package/dist/media/queue-store.js.map

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

package/dist/media/queue-types.d.ts

@@ -0,0 +1,71 @@
+import type { OcrModelProfile, OcrTask } from '../llm/ocr-registry.js';
+export type MediaQueueStatus = 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'OWNER_REVIEW' | 'CANCELLED';
+export interface MediaQueueItem {
+    id: number;
+    dedupeKey: string;
+    chatJid: string;
+    messageId: string | null;
+    mediaId: string | null;
+    sha256: string | null;
+    filePath: string | null;
+    mimeType: string | null;
+    fileName: string | null;
+    fileSize: number | null;
+    task: OcrTask;
+    profile: OcrModelProfile;
+    status: MediaQueueStatus;
+    attempts: number;
+    maxAttempts: number;
+    availableAt: number;
+    createdAt: number;
+    updatedAt: number;
+    startedAt: number | null;
+    completedAt: number | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    resultText: string | null;
+}
+export interface EnqueueMediaInput {
+    chatJid: string;
+    messageId?: string | null;
+    mediaId?: string | null;
+    sha256?: string | null;
+    filePath?: string | null;
+    mimeType?: string | null;
+    fileName?: string | null;
+    fileSize?: number | null;
+    task: OcrTask;
+    profile: OcrModelProfile;
+    maxAttempts?: number;
+    availableAt?: number;
+}
+export interface EnqueueResult {
+    item: MediaQueueItem;
+    created: boolean;
+}
+export type MediaQueueRow = {
+    id: number;
+    dedupe_key: string;
+    chat_jid: string;
+    message_id: string | null;
+    media_id: string | null;
+    sha256: string | null;
+    file_path: string | null;
+    mime_type: string | null;
+    file_name: string | null;
+    file_size: number | null;
+    task: OcrTask;
+    profile_json: string;
+    status: MediaQueueStatus;
+    attempts: number;
+    max_attempts: number;
+    available_at: number;
+    created_at: number;
+    updated_at: number;
+    started_at: number | null;
+    completed_at: number | null;
+    error_code: string | null;
+    error_message: string | null;
+    result_text: string | null;
+};
+//# sourceMappingURL=queue-types.d.ts.map

package/dist/media/queue-types.d.ts.map

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

package/dist/media/queue-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-types.js.map

package/dist/media/queue-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-types.js","sourceRoot":"","sources":["../../src/media/queue-types.ts"],"names":[],"mappings":""}

package/dist/media/queue-utils.d.ts

@@ -0,0 +1,9 @@
+import type { EnqueueMediaInput, MediaQueueItem, MediaQueueRow } from './queue-types.js';
+export declare const MAX_MEDIA_QUEUE_ERROR_LENGTH = 1000;
+export declare const MAX_MEDIA_QUEUE_RESULT_LENGTH = 100000;
+export declare function buildMediaQueueDedupeKey(input: Pick<EnqueueMediaInput, 'mediaId' | 'sha256'>): string;
+export declare function requireMediaQueueChatJid(value: string): string;
+export declare function cleanQueueText(value?: string | null, maxLength?: number): string | null;
+export declare function boundedMediaQueueLimit(limit: number): number;
+export declare function mapMediaQueueRow(row: MediaQueueRow): MediaQueueItem;
+//# sourceMappingURL=queue-utils.d.ts.map

package/dist/media/queue-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-utils.d.ts","sourceRoot":"","sources":["../../src/media/queue-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzF,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG,MAAM,CAMrG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,SAAM,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA0BnE"}

package/dist/media/queue-utils.js

@@ -0,0 +1,52 @@
+export const MAX_MEDIA_QUEUE_ERROR_LENGTH = 1000;
+export const MAX_MEDIA_QUEUE_RESULT_LENGTH = 100_000;
+export function buildMediaQueueDedupeKey(input) {
+    const sha256 = cleanQueueText(input.sha256);
+    if (sha256)
+        return `sha256:${sha256.toLowerCase()}`;
+    const mediaId = cleanQueueText(input.mediaId);
+    if (mediaId)
+        return `media:${mediaId}`;
+    throw new Error('Media queue item requires mediaId or sha256 for deduplication.');
+}
+export function requireMediaQueueChatJid(value) {
+    const cleanValue = cleanQueueText(value);
+    if (!cleanValue || !cleanValue.includes('@'))
+        throw new Error('Media queue item requires a chat JID.');
+    return cleanValue;
+}
+export function cleanQueueText(value, maxLength = 500) {
+    const trimmed = (value || '').replace(/\s+/g, ' ').trim();
+    return trimmed ? trimmed.slice(0, maxLength) : null;
+}
+export function boundedMediaQueueLimit(limit) {
+    return Math.max(1, Math.min(limit, 100));
+}
+export function mapMediaQueueRow(row) {
+    return {
+        id: row.id,
+        dedupeKey: row.dedupe_key,
+        chatJid: row.chat_jid,
+        messageId: row.message_id,
+        mediaId: row.media_id,
+        sha256: row.sha256,
+        filePath: row.file_path,
+        mimeType: row.mime_type,
+        fileName: row.file_name,
+        fileSize: row.file_size,
+        task: row.task,
+        profile: JSON.parse(row.profile_json),
+        status: row.status,
+        attempts: row.attempts,
+        maxAttempts: row.max_attempts,
+        availableAt: row.available_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        startedAt: row.started_at,
+        completedAt: row.completed_at,
+        errorCode: row.error_code,
+        errorMessage: row.error_message,
+        resultText: row.result_text,
+    };
+}
+//# sourceMappingURL=queue-utils.js.map

package/dist/media/queue-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-utils.js","sourceRoot":"","sources":["../../src/media/queue-utils.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAErD,MAAM,UAAU,wBAAwB,CAAC,KAAoD;IAC3F,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,OAAO,UAAU,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO;QAAE,OAAO,SAAS,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACvG,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAqB,EAAE,SAAS,GAAG,GAAG;IACnE,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAoB;QACxD,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,UAAU,EAAE,GAAG,CAAC,WAAW;KAC5B,CAAC;AACJ,CAAC"}

package/dist/media/queue-worker.d.ts

@@ -0,0 +1,31 @@
+import { MediaQueueRunner, type MediaQueueRunResult } from './queue-runner.js';
+export interface MediaQueueWorkerOptions {
+    runner?: MediaQueueRunner;
+    intervalMs?: number;
+    limit?: number;
+    enabled?: boolean;
+    onResult?: (result: MediaQueueRunResult) => void;
+    onError?: (error: Error) => void;
+    setIntervalFn?: typeof setInterval;
+    clearIntervalFn?: typeof clearInterval;
+}
+export declare class MediaQueueWorker {
+    private runner;
+    private intervalMs;
+    private limit;
+    private enabled;
+    private onResult?;
+    private onError?;
+    private setIntervalFn;
+    private clearIntervalFn;
+    private timer;
+    private running;
+    constructor(options?: MediaQueueWorkerOptions);
+    isEnabled(): boolean;
+    isRunning(): boolean;
+    isStarted(): boolean;
+    tickOnce(): Promise<MediaQueueRunResult | null>;
+    start(): boolean;
+    stop(): boolean;
+}
+//# sourceMappingURL=queue-worker.d.ts.map

package/dist/media/queue-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-worker.d.ts","sourceRoot":"","sources":["../../src/media/queue-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,WAAW,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,aAAa,CAAC;CACxC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAwC;IACzD,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,uBAA4B;IAWjD,SAAS,IAAI,OAAO;IACpB,SAAS,IAAI,OAAO;IACpB,SAAS,IAAI,OAAO;IAEd,QAAQ,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAgBrD,KAAK,IAAI,OAAO;IAMhB,IAAI,IAAI,OAAO;CAMhB"}

package/dist/media/queue-worker.js

@@ -0,0 +1,58 @@
+import { MediaQueueRunner } from './queue-runner.js';
+export class MediaQueueWorker {
+    runner;
+    intervalMs;
+    limit;
+    enabled;
+    onResult;
+    onError;
+    setIntervalFn;
+    clearIntervalFn;
+    timer = null;
+    running = false;
+    constructor(options = {}) {
+        this.runner = options.runner || new MediaQueueRunner();
+        this.intervalMs = Math.max(1000, options.intervalMs || Number(process.env.MEDIA_QUEUE_WORKER_INTERVAL_MS || 15_000));
+        this.limit = Math.max(1, Math.min(options.limit || Number(process.env.MEDIA_QUEUE_WORKER_LIMIT || 5), 25));
+        this.enabled = options.enabled ?? process.env.MEDIA_QUEUE_WORKER_ENABLED === 'true';
+        this.onResult = options.onResult;
+        this.onError = options.onError;
+        this.setIntervalFn = options.setIntervalFn || setInterval;
+        this.clearIntervalFn = options.clearIntervalFn || clearInterval;
+    }
+    isEnabled() { return this.enabled; }
+    isRunning() { return this.running; }
+    isStarted() { return this.timer !== null; }
+    async tickOnce() {
+        if (!this.enabled || this.running)
+            return null;
+        this.running = true;
+        try {
+            const result = await this.runner.tick(this.limit);
+            this.onResult?.(result);
+            return result;
+        }
+        catch (error) {
+            const normalized = error instanceof Error ? error : new Error('Unexpected media queue worker error.');
+            this.onError?.(normalized);
+            return null;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    start() {
+        if (!this.enabled || this.timer)
+            return false;
+        this.timer = this.setIntervalFn(() => { void this.tickOnce(); }, this.intervalMs);
+        return true;
+    }
+    stop() {
+        if (!this.timer)
+            return false;
+        this.clearIntervalFn(this.timer);
+        this.timer = null;
+        return true;
+    }
+}
+//# sourceMappingURL=queue-worker.js.map

package/dist/media/queue-worker.js.map

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