@jini-ai/integrations 0.1.0

package/dist/media-providers/sqlite-task-store.js

@@ -0,0 +1,234 @@
+const VALID_STATUSES = new Set([
+    'queued',
+    'running',
+    'done',
+    'failed',
+    'interrupted',
+]);
+const TERMINAL_STATUSES = new Set(['done', 'failed', 'interrupted']);
+// Mirrors task-store.ts's own ALLOWED_TRANSITIONS exactly (CR-013: enum
+// membership alone doesn't prove a transition is legal, e.g. done -> running).
+const ALLOWED_TRANSITIONS = {
+    queued: new Set(['queued', 'running', 'done', 'failed', 'interrupted']),
+    running: new Set(['running', 'done', 'failed', 'interrupted']),
+    done: new Set(['done']),
+    failed: new Set(['failed']),
+    interrupted: new Set(['interrupted']),
+};
+const INTERRUPTED_ERROR = {
+    message: 'media task interrupted by daemon restart',
+    code: 'DAEMON_RESTART',
+};
+function assertValidStatus(status) {
+    if (!VALID_STATUSES.has(status)) {
+        throw new RangeError(`Invalid media task status: "${status}"`);
+    }
+}
+/**
+ * Reconstructs a `MediaTask` from a stored row. `surface`/`model` are
+ * conditionally spread — matching `task-store.ts`'s own in-memory adapter,
+ * which never assigns `undefined` to an optional field (this package's
+ * `exactOptionalPropertyTypes: true` tsconfig would reject that) — a task
+ * created without a `surface`/`model` has no key at all, not a key set to
+ * `undefined`.
+ */
+function rowToTask(row) {
+    return {
+        id: row.id,
+        ownerRef: row.owner_ref,
+        status: row.status,
+        progress: JSON.parse(row.progress),
+        file: row.file === null ? null : JSON.parse(row.file),
+        error: row.error === null ? null : JSON.parse(row.error),
+        startedAt: row.started_at,
+        endedAt: row.ended_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        ...(row.surface !== null ? { surface: row.surface } : {}),
+        ...(row.model !== null ? { model: row.model } : {}),
+    };
+}
+/**
+ * Opens (creating if absent) a `better-sqlite3` database at `dbPath` and
+ * returns a `MediaTaskStore` backed by it. Pass `':memory:'` for a
+ * non-durable in-process database (useful in tests that want SQL semantics
+ * without a file). Schema creation is idempotent (`CREATE TABLE IF NOT
+ * EXISTS`), so re-opening the same file resumes from whatever was durably
+ * committed — this is what makes an in-flight job's state survive a
+ * process restart: a fresh `createSqliteMediaTaskStore(dbPath)` call after
+ * the process comes back up sees every task exactly as it was left, and
+ * `reconcileOnBoot` can then mark anything still `queued`/`running` as
+ * `interrupted`.
+ *
+ * `better-sqlite3` (a native compiled addon) is dynamically imported here
+ * rather than statically at module scope (mirroring `@jini-ai/daemon`'s
+ * `loadRealSpawnPty`/`node-pty` pattern) — this package's root barrel
+ * re-exports this module unconditionally, so a static top-level import would
+ * force every consumer of `@jini-ai/integrations/media-providers`, even one wanting only
+ * `renderStub`, to load the native binary at module-evaluation time. Now
+ * only an actual `createSqliteMediaTaskStore` call pays that cost, and it
+ * fails cleanly (a rejected promise) rather than crashing unrelated imports
+ * if the platform/environment lacks a usable prebuild.
+ */
+export async function createSqliteMediaTaskStore(dbPath) {
+    const { default: Database } = await import('better-sqlite3');
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS jini_media_tasks (
+      id TEXT PRIMARY KEY,
+      owner_ref TEXT NOT NULL,
+      status TEXT NOT NULL,
+      surface TEXT,
+      model TEXT,
+      progress TEXT NOT NULL,
+      file TEXT,
+      error TEXT,
+      started_at INTEGER NOT NULL,
+      ended_at INTEGER,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_jini_media_tasks_owner
+      ON jini_media_tasks (owner_ref, status);
+  `);
+    const getStmt = db.prepare('SELECT * FROM jini_media_tasks WHERE id = ?');
+    const insertStmt = db.prepare(`
+    INSERT INTO jini_media_tasks
+      (id, owner_ref, status, surface, model, progress, file, error, started_at, ended_at, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const updateStmt = db.prepare(`
+    UPDATE jini_media_tasks
+    SET status = ?, surface = ?, model = ?, progress = ?, file = ?, error = ?, ended_at = ?, updated_at = ?
+    WHERE id = ?
+  `);
+    const deleteStmt = db.prepare('DELETE FROM jini_media_tasks WHERE id = ?');
+    const listAllForOwnerStmt = db.prepare('SELECT * FROM jini_media_tasks WHERE owner_ref = ? ORDER BY started_at DESC');
+    const listInFlightForOwnerStmt = db.prepare(`SELECT * FROM jini_media_tasks WHERE owner_ref = ? AND status NOT IN ('done', 'failed', 'interrupted') ORDER BY started_at DESC`);
+    const selectAllStmt = db.prepare('SELECT * FROM jini_media_tasks');
+    function writeRow(task, isInsert) {
+        const progressJson = JSON.stringify(task.progress);
+        const fileJson = task.file == null ? null : JSON.stringify(task.file);
+        const errorJson = task.error == null ? null : JSON.stringify(task.error);
+        const surface = task.surface ?? null;
+        const model = task.model ?? null;
+        if (isInsert) {
+            insertStmt.run(task.id, task.ownerRef, task.status, surface, model, progressJson, fileJson, errorJson, task.startedAt, task.endedAt, task.createdAt, task.updatedAt);
+        }
+        else {
+            updateStmt.run(task.status, surface, model, progressJson, fileJson, errorJson, task.endedAt, task.updatedAt, task.id);
+        }
+    }
+    const createTxn = db.transaction((input) => {
+        if (getStmt.get(input.id)) {
+            throw new Error(`media task "${input.id}" already exists`);
+        }
+        const status = input.status ?? 'queued';
+        assertValidStatus(status);
+        const now = Date.now();
+        const startedAt = input.startedAt ?? now;
+        const task = {
+            id: input.id,
+            ownerRef: input.ownerRef,
+            status,
+            progress: input.progress ? [...input.progress] : [],
+            file: input.file == null ? null : structuredClone(input.file),
+            error: input.error == null ? null : { ...input.error },
+            startedAt,
+            endedAt: null,
+            createdAt: now,
+            updatedAt: now,
+            ...(input.surface !== undefined ? { surface: input.surface } : {}),
+            ...(input.model !== undefined ? { model: input.model } : {}),
+        };
+        writeRow(task, true);
+        return task;
+    });
+    const updateTxn = db.transaction((id, patch) => {
+        const row = getStmt.get(id);
+        if (!row)
+            return null;
+        const existing = rowToTask(row);
+        const status = patch.status ?? existing.status;
+        assertValidStatus(status);
+        if (!ALLOWED_TRANSITIONS[existing.status].has(status)) {
+            throw new RangeError(`Invalid media task transition: "${existing.status}" -> "${status}"`);
+        }
+        const surface = 'surface' in patch ? (patch.surface ?? undefined) : existing.surface;
+        const model = 'model' in patch ? (patch.model ?? undefined) : existing.model;
+        const next = {
+            id: existing.id,
+            ownerRef: existing.ownerRef,
+            status,
+            progress: patch.progress ? [...patch.progress] : existing.progress,
+            file: 'file' in patch ? (patch.file == null ? null : structuredClone(patch.file)) : existing.file,
+            error: 'error' in patch ? (patch.error == null ? null : { ...patch.error }) : existing.error,
+            startedAt: existing.startedAt,
+            endedAt: 'endedAt' in patch ? (patch.endedAt ?? null) : existing.endedAt,
+            createdAt: existing.createdAt,
+            updatedAt: Date.now(),
+            ...(surface !== undefined ? { surface } : {}),
+            ...(model !== undefined ? { model } : {}),
+        };
+        writeRow(next, false);
+        return next;
+    });
+    const reconcileTxn = db.transaction((options) => {
+        const now = options.now ?? Date.now();
+        const cutoff = now - options.terminalTtlMs;
+        let interrupted = 0;
+        let deleted = 0;
+        for (const row of selectAllStmt.all()) {
+            const task = rowToTask(row);
+            if (task.status === 'queued' || task.status === 'running') {
+                const next = {
+                    ...task,
+                    status: 'interrupted',
+                    error: INTERRUPTED_ERROR,
+                    endedAt: task.endedAt ?? now,
+                    updatedAt: now,
+                };
+                writeRow(next, false);
+                interrupted += 1;
+                continue;
+            }
+            if (TERMINAL_STATUSES.has(task.status) && (task.endedAt ?? task.updatedAt) < cutoff) {
+                deleteStmt.run(task.id);
+                deleted += 1;
+            }
+        }
+        return { interrupted, deleted };
+    });
+    return {
+        async create(input) {
+            return createTxn(input);
+        },
+        async get(id) {
+            const row = getStmt.get(id);
+            return row ? rowToTask(row) : null;
+        },
+        async update(id, patch) {
+            return updateTxn(id, patch);
+        },
+        async listByOwner(ownerRef, options = {}) {
+            const includeTerminal = options.includeTerminal === true;
+            const rows = includeTerminal ? listAllForOwnerStmt.all(ownerRef) : listInFlightForOwnerStmt.all(ownerRef);
+            return rows.map(rowToTask);
+        },
+        async delete(id) {
+            deleteStmt.run(id);
+        },
+        async reconcileOnBoot(options) {
+            if (!Number.isFinite(options.terminalTtlMs) || options.terminalTtlMs < 0) {
+                throw new RangeError(`Invalid terminalTtlMs: ${options.terminalTtlMs} must be a non-negative finite number`);
+            }
+            return reconcileTxn(options);
+        },
+        async close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=sqlite-task-store.js.map

package/dist/media-providers/sqlite-task-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-task-store.js","sourceRoot":"","sources":["../../src/media-providers/sqlite-task-store.ts"],"names":[],"mappings":"AAsDA,MAAM,cAAc,GAAiC,IAAI,GAAG,CAAC;IAC3D,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,aAAa;CACd,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAiC,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AAEnG,wEAAwE;AACxE,+EAA+E;AAC/E,MAAM,mBAAmB,GAAoE;IAC3F,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,iBAAiB,GAAmB;IACxC,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,gBAAgB;CACvB,CAAC;AAEF,SAAS,iBAAiB,CAAC,MAAuB;IAChD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAiBD;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,MAAM,EAAE,GAAG,CAAC,MAAyB;QACrC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAsB;QACvD,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAa;QAClE,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAoB;QAC5E,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAAc;IAC7D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC7D,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;GAkBP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAoB,6CAA6C,CAAC,CAAC;IAC7F,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAE3B;;;;GAID,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAE3B;;;;GAID,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAW,2CAA2C,CAAC,CAAC;IACrF,MAAM,mBAAmB,GAAG,EAAE,CAAC,OAAO,CACpC,6EAA6E,CAC9E,CAAC;IACF,MAAM,wBAAwB,GAAG,EAAE,CAAC,OAAO,CACzC,iIAAiI,CAClI,CAAC;IACF,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAc,gCAAgC,CAAC,CAAC;IAEhF,SAAS,QAAQ,CAAC,IAAe,EAAE,QAAiB;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,CAAC,GAAG,CACZ,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,EACX,OAAO,EACP,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,CACf,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,KAA2B,EAAa,EAAE;QAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC;QACxC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC;QACzC,MAAM,IAAI,GAAc;YACtB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM;YACN,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACnD,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAa;YAC1E,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;YACtD,SAAS;YACT,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,EAAU,EAAE,KAAqB,EAAoB,EAAE;QACvF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;QAC/C,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,mCAAmC,QAAQ,CAAC,MAAM,SAAS,MAAM,GAAG,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrF,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC7E,MAAM,IAAI,GAAc;YACtB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM;YACN,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;YAClE,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;YAC9G,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;YAC5F,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;YACxE,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,OAAkC,EAA4B,EAAE;QACnG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1D,MAAM,IAAI,GAAc;oBACtB,GAAG,IAAI;oBACP,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,iBAAiB;oBACxB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,GAAG;oBAC5B,SAAS,EAAE,GAAG;iBACf,CAAC;gBACF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtB,WAAW,IAAI,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,CAAC;gBACpF,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAA2B;YACtC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,EAAU;YAClB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAqB;YAC5C,OAAO,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,UAAgC,EAAE;YACpE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC;YACzD,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC1G,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU;YACrB,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,OAAkC;YACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBACzE,MAAM,IAAI,UAAU,CAAC,0BAA0B,OAAO,CAAC,aAAa,uCAAuC,CAAC,CAAC;YAC/G,CAAC;YACD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,CAAC,KAAK;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/media-providers/staging.d.ts

@@ -0,0 +1,29 @@
+export interface AttachmentStagingOptions {
+    /** Directory name created under `cwd` to hold staged copies. Defaults to `.media-attachments`. Must be a single safe path component (no separators, no `..`). */
+    readonly stagingDirName?: string;
+    /** Max age (ms) a staged file is retained before opportunistic pruning removes it. Defaults to 24h. */
+    readonly maxAgeMs?: number;
+    /** Max number of paths accepted per `stage()` call. Defaults to 50. */
+    readonly maxItems?: number;
+    /** Max bytes copied for a single staged file. Defaults to 100 MiB. */
+    readonly maxBytesPerFile?: number;
+}
+/**
+ * Stages a host-supplied list of local file paths for submission: a path
+ * already inside `cwd` is used as-is; a path outside `cwd` is copied into a
+ * `.media-attachments`-style staging directory under `cwd` with a random
+ * prefix, avoiding collisions and leaving the original untouched, but ONLY
+ * when it also resolves inside the caller-supplied `uploadRoot` — copying a
+ * file from outside `cwd` with no `uploadRoot` (or an `uploadRoot` that
+ * fails to resolve) throws rather than silently disabling the containment
+ * check, since that would let a caller stage an arbitrary host-readable file
+ * (SEC-RB-003). Malformed or missing paths are silently skipped —
+ * attachments are advisory input, not a validated contract. Opportunistically
+ * prunes staged files older than `maxAgeMs` on each call.
+ */
+export interface AttachmentStaging {
+    stage(imagePaths: readonly string[], uploadRoot?: string | null): Promise<string[]>;
+}
+/** Creates a filesystem-backed `AttachmentStaging` rooted at `cwd`. */
+export declare function createFsAttachmentStaging(cwd: string, options?: AttachmentStagingOptions): AttachmentStaging;
+//# sourceMappingURL=staging.d.ts.map

package/dist/media-providers/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../../src/media-providers/staging.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,wBAAwB;IACvC,iKAAiK;IACjK,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACrF;AAiDD,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CA6EhH"}

package/dist/media-providers/staging.js

@@ -0,0 +1,141 @@
+/**
+ * Attachment staging — a generic "temp-store a local file before it's
+ * submitted to a remote generation request" port. Generalized from Open
+ * Design's `apps/daemon/src/media/amr-image-staging.ts`. Despite the
+ * origin's AMR/vela-vendor-specific filename and its narrow "image paths for
+ * an agent turn" framing, its actual logic carries zero OD/vendor coupling —
+ * root-containment checks, copy-into-a-staging-dir, and TTL-based pruning
+ * are all generic filesystem concerns. Ported as a real, testable port +
+ * reference implementation (not just an interface) per the task brief,
+ * mirroring this package's other port/in-memory-or-fs-reference pairs.
+ */
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_STAGING_DIRNAME = '.media-attachments';
+const DEFAULT_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_MAX_ITEMS = 50;
+const DEFAULT_MAX_BYTES_PER_FILE = 100 * 1024 * 1024;
+function isWithinRoot(root, candidate) {
+    const relativePath = path.relative(root, candidate);
+    return relativePath === '' || (relativePath.length > 0 && !relativePath.startsWith('..') && !path.isAbsolute(relativePath));
+}
+function assertSafeStagingDirName(stagingDirName) {
+    if (stagingDirName.length === 0 ||
+        path.isAbsolute(stagingDirName) ||
+        stagingDirName === '.' ||
+        stagingDirName === '..' ||
+        stagingDirName.includes('/') ||
+        stagingDirName.includes('\\')) {
+        throw new Error(`attachment staging: stagingDirName must be a single safe path component, got ${JSON.stringify(stagingDirName)}`);
+    }
+}
+async function pruneStagedAttachments(stagingDir, maxAgeMs) {
+    let entries;
+    try {
+        entries = await fs.promises.readdir(stagingDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const cutoff = Date.now() - maxAgeMs;
+    await Promise.all(entries.map(async (entry) => {
+        if (!entry.isFile())
+            return;
+        const filePath = path.join(stagingDir, entry.name);
+        try {
+            const stat = await fs.promises.stat(filePath);
+            if (stat.mtimeMs < cutoff) {
+                await fs.promises.rm(filePath, { force: true });
+            }
+        }
+        catch {
+            // Best-effort cleanup only.
+        }
+    }));
+}
+/** Creates a filesystem-backed `AttachmentStaging` rooted at `cwd`. */
+export function createFsAttachmentStaging(cwd, options = {}) {
+    const stagingDirName = options.stagingDirName ?? DEFAULT_STAGING_DIRNAME;
+    assertSafeStagingDirName(stagingDirName);
+    const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+    const maxItems = options.maxItems ?? DEFAULT_MAX_ITEMS;
+    const maxBytesPerFile = options.maxBytesPerFile ?? DEFAULT_MAX_BYTES_PER_FILE;
+    const root = path.resolve(cwd);
+    const stagingDir = path.join(root, stagingDirName);
+    return {
+        async stage(imagePaths, uploadRoot) {
+            if (!Array.isArray(imagePaths) || imagePaths.length === 0)
+                return [];
+            if (imagePaths.length > maxItems) {
+                throw new Error(`attachment staging: ${imagePaths.length} paths exceeds the ${maxItems}-item limit`);
+            }
+            // Fail closed, not open: an explicitly-supplied uploadRoot that doesn't
+            // resolve is a caller configuration error, not an "unrestricted" signal
+            // (SEC-RB-003 — the prior behavior collapsed "no uploadRoot" and
+            // "unresolvable uploadRoot" into the same no-restriction case, letting
+            // any host-readable file be staged when uploadRoot merely failed to
+            // resolve). Omitting uploadRoot entirely is still allowed, but then only
+            // paths already inside `cwd` can be staged — nothing outside `cwd` can
+            // be copied in without a resolvable uploadRoot to authorize it.
+            let uploadRootReal = null;
+            if (uploadRoot != null) {
+                try {
+                    uploadRootReal = await fs.promises.realpath(uploadRoot);
+                }
+                catch (error) {
+                    throw new Error(`attachment staging: uploadRoot ${JSON.stringify(uploadRoot)} could not be resolved: ${error.message}`);
+                }
+            }
+            await fs.promises.mkdir(stagingDir, { recursive: true });
+            // The staging directory is a destination this component writes into
+            // and later prunes/deletes from — refuse to operate through a symlink
+            // here, since a pre-planted symlink would redirect writes/deletes
+            // outside `root` (SEC-RB-003).
+            const stagingDirLstat = await fs.promises.lstat(stagingDir);
+            if (stagingDirLstat.isSymbolicLink()) {
+                throw new Error(`attachment staging: staging directory ${stagingDir} is a symlink, refusing to use it`);
+            }
+            await pruneStagedAttachments(stagingDir, maxAgeMs);
+            // `root` is guaranteed to exist at this point (the recursive mkdir above
+            // created it if it didn't already). Resolve its real path once so the
+            // "already inside cwd" check below compares like-for-like against
+            // `real` (itself always realpath'd) — comparing a realpath'd candidate
+            // against a raw `root` misfires whenever `cwd` sits under a symlinked
+            // prefix (e.g. macOS's /tmp -> /private/tmp, /var -> /private/var),
+            // causing an unnecessary copy instead of returning the path as-is.
+            const rootReal = await fs.promises.realpath(root).catch(() => root);
+            const staged = [];
+            for (const inputPath of imagePaths) {
+                if (typeof inputPath !== 'string' || inputPath.trim().length === 0)
+                    continue;
+                try {
+                    const resolved = path.resolve(inputPath);
+                    const real = await fs.promises.realpath(resolved);
+                    const stat = await fs.promises.stat(real);
+                    if (!stat.isFile())
+                        continue;
+                    if (isWithinRoot(rootReal, real)) {
+                        staged.push(real);
+                        continue;
+                    }
+                    // Outside cwd: this is the "copy an external file into staging"
+                    // path, which requires an authorized uploadRoot — deny by default.
+                    if (uploadRootReal == null || !isWithinRoot(uploadRootReal, real))
+                        continue;
+                    if (stat.size > maxBytesPerFile)
+                        continue;
+                    const basename = path.basename(real);
+                    const destination = path.join(stagingDir, `${randomUUID()}-${basename}`);
+                    await fs.promises.copyFile(real, destination);
+                    staged.push(destination);
+                }
+                catch {
+                    // Ignore malformed or missing files; attachments are advisory input.
+                }
+            }
+            return staged;
+        },
+    };
+}
+//# sourceMappingURL=staging.js.map

package/dist/media-providers/staging.js.map

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

package/dist/media-providers/task-store.d.ts

@@ -0,0 +1,94 @@
+/**
+ * `MediaTaskStore` — the async task-tracking port for request-now,
+ * poll-later media generation. Generalized from OD's
+ * `apps/daemon/src/media/tasks.ts`, which is a `better-sqlite3`-coupled,
+ * synchronous CRUD module keyed on `projectId` (an OD domain noun) with a
+ * hardcoded SQL schema. Per extraction-plan.md §2.6 ("ports are async-only
+ * from day one") and the pattern already established by
+ * `@jini-ai/daemon`'s `EventLog` (see `packages/daemon/src/event-log.ts`), this
+ * is a from-scratch storage-agnostic port + in-memory reference
+ * implementation — not a lift — reproducing the same lifecycle semantics
+ * (queued → running → done|failed|interrupted, boot-time reconciliation of
+ * orphaned in-flight tasks, TTL-based terminal-task pruning) without a SQL
+ * schema or an OD project reference. A durable adapter (a future
+ * `@jini-ai/sqlite` addition) implements the same interface — see
+ * `source-map.md`.
+ */
+export type MediaTaskStatus = 'queued' | 'running' | 'done' | 'failed' | 'interrupted';
+export interface MediaTaskError {
+    readonly message: string;
+    readonly status?: number;
+    readonly code?: string;
+}
+/** One tracked media-generation task. `ownerRef` is an opaque host-supplied scoping key (e.g. a run id) — never an OD `projectId`. */
+export interface MediaTask {
+    readonly id: string;
+    readonly ownerRef: string;
+    readonly status: MediaTaskStatus;
+    readonly surface?: string;
+    readonly model?: string;
+    readonly progress: readonly string[];
+    readonly file: unknown | null;
+    readonly error: MediaTaskError | null;
+    readonly startedAt: number;
+    readonly endedAt: number | null;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export interface MediaTaskCreateInput {
+    readonly id: string;
+    readonly ownerRef: string;
+    readonly status?: MediaTaskStatus;
+    readonly surface?: string;
+    readonly model?: string;
+    readonly progress?: readonly string[];
+    readonly file?: unknown | null;
+    readonly error?: MediaTaskError | null;
+    readonly startedAt?: number;
+}
+export interface MediaTaskPatch {
+    readonly status?: MediaTaskStatus;
+    readonly surface?: string | null;
+    readonly model?: string | null;
+    readonly progress?: readonly string[];
+    readonly file?: unknown | null;
+    readonly error?: MediaTaskError | null;
+    readonly endedAt?: number | null;
+}
+export interface MediaTaskListOptions {
+    /** Include terminal (done/failed/interrupted) tasks. Defaults to `false` (in-flight only). */
+    readonly includeTerminal?: boolean;
+}
+export interface MediaTaskReconcileOptions {
+    /** How long a terminal task is retained before `reconcileOnBoot` deletes it. */
+    readonly terminalTtlMs: number;
+    /** Injectable clock for deterministic tests; defaults to `Date.now()`. */
+    readonly now?: number;
+}
+export interface MediaTaskReconcileResult {
+    readonly interrupted: number;
+    readonly deleted: number;
+}
+/**
+ * A replayable, ownerRef-scoped store for async media-generation tasks.
+ * `@jini-ai/integrations/media-providers` ships `createInMemoryMediaTaskStore` as the reference
+ * implementation; a durable adapter implements the same interface.
+ */
+export interface MediaTaskStore {
+    create(input: MediaTaskCreateInput): Promise<MediaTask>;
+    get(id: string): Promise<MediaTask | null>;
+    /** Applies `patch` to an existing task and returns the updated row, or `null` if `id` is unknown. */
+    update(id: string, patch: MediaTaskPatch): Promise<MediaTask | null>;
+    listByOwner(ownerRef: string, options?: MediaTaskListOptions): Promise<MediaTask[]>;
+    delete(id: string): Promise<void>;
+    /**
+     * Boot-time reconciliation: marks every still-`queued`/`running` task
+     * `'interrupted'` (a restart mid-flight has no way to resume it) and
+     * deletes terminal tasks older than `terminalTtlMs`. Mirrors the origin's
+     * `reconcileMediaTasksOnBoot`.
+     */
+    reconcileOnBoot(options: MediaTaskReconcileOptions): Promise<MediaTaskReconcileResult>;
+}
+/** Creates the in-memory reference `MediaTaskStore`. No persistence — state is lost on process exit. */
+export declare function createInMemoryMediaTaskStore(): MediaTaskStore;
+//# sourceMappingURL=task-store.d.ts.map

package/dist/media-providers/task-store.d.ts.map

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