@xopcai/xopc 0.0.104 → 0.0.106

package/dist/src/notes/store.js

@@ -4,6 +4,7 @@ import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { buildNoteIndexMeta } from "./note-index-meta.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "../storage/sqlite/notes-repository.js";
+import { deleteNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveNoteHistoryDir, resolveNoteMediaDir } from "./paths.js";
 import { randomUUID } from "node:crypto";
@@ -46,6 +47,7 @@ var NotesStore = class {
 	async deleteNote(id) {
 		requireXopcDatabase();
 		if (!deleteNoteRecord(id)) return false;
+		deleteNoteAgentContextRecord(id);
 		await rm(resolveNoteMediaDir(id), {
 			recursive: true,
 			force: true

package/dist/src/notes/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      markdown: note.markdown,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.markdown ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files.filter((f) => f.endsWith('.json')).sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  deleteNoteAgentContextRecord,\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    deleteNoteAgentContextRecord(id);\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      markdown: note.markdown,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.markdown ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files.filter((f) => f.endsWith('.json')).sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":"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"}

package/dist/src/share/share-thumbnail.js

@@ -2,9 +2,9 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveStateDir } from "../config/paths-state.js";
 import { init_paths } from "../config/paths.js";
-import { loadPlaywrightCoreModule } from "../browser/providers/playwright-doctor.js";
 import { getShareStore } from "./share-store.js";
 import { getSiteShareStore } from "./site-share-store.js";
+import { loadPlaywrightCoreModule } from "../browser/providers/playwright-doctor.js";
 import { mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 //#region src/share/share-thumbnail.ts

package/dist/src/storage/sqlite/index.d.ts

@@ -11,5 +11,6 @@ export { deleteSessionRecord, ensureSessionRecord, getCurrentTranscriptId, getGl
 export { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreCompactionCheckpoint, } from './transcript-repository.js';
 export { appendCronRun, deleteCronRunsForJob, readAllCronRuns, readCronJobHistory, } from './cron-run-repository.js';
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
+export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';
 export { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -12,6 +12,7 @@ import { deleteSessionRecord, ensureSessionRecord, findSessionKeyByTranscriptId,
 import { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreCompactionCheckpoint } from "./transcript-repository.js";
 import { appendCronRun, deleteCronRunsForJob, readAllCronRuns, readCronJobHistory } from "./cron-run-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
+import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCronRun, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, deleteCronRunsForJob, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, extractRoutingFromSessionKey, findSessionKeyByTranscriptId, getCompactionCheckpointDetail, getCurrentTranscriptId, getGlobalSessionStats, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listCompactionCheckpoints, listNoteRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, parseSessionKeySource, patchSessionMetadata, readAllCronRuns, readCronJobHistory, readSchemaVersion, readSchemaVersionForTest, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveAgentIdFromSessionKey, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, sessionConfigRowToConfig, sessionRowToMetadata, setSessionConfig, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCronRun, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, deleteCronRunsForJob, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, extractRoutingFromSessionKey, findSessionKeyByTranscriptId, getCompactionCheckpointDetail, getCurrentTranscriptId, getGlobalSessionStats, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listCompactionCheckpoints, listNoteRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, parseSessionKeySource, patchSessionMetadata, readAllCronRuns, readCronJobHistory, readSchemaVersion, readSchemaVersionForTest, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveAgentIdFromSessionKey, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, sessionConfigRowToConfig, sessionRowToMetadata, setSessionConfig, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/migrations/005_add_note_agent_contexts.sql

@@ -0,0 +1,10 @@
+CREATE TABLE IF NOT EXISTS note_agent_contexts (
+  note_id TEXT PRIMARY KEY,
+  note_updated_at INTEGER NOT NULL,
+  context_version TEXT NOT NULL,
+  generated_at INTEGER NOT NULL,
+  payload_json TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_note_agent_contexts_generated
+  ON note_agent_contexts(generated_at DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 4;
+export declare const XOPC_DB_SCHEMA_VERSION = 5;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 4;
+const XOPC_DB_SCHEMA_VERSION = 5;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 4;
+	const targetVersion = options.targetVersion ?? 5;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 4;
+	const appVersion = options.targetVersion ?? 5;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 4;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 5;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 4;
+export const XOPC_DB_SCHEMA_VERSION = 5;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/note-agent-context-repository.d.ts

@@ -0,0 +1,10 @@
+export interface NoteAgentContextRecord<T = unknown> {
+    noteId: string;
+    noteUpdatedAt: number;
+    contextVersion: string;
+    generatedAt: number;
+    payload: T;
+}
+export declare function getNoteAgentContextRecord<T = unknown>(noteId: string): NoteAgentContextRecord<T> | null;
+export declare function upsertNoteAgentContextRecord(record: NoteAgentContextRecord): void;
+export declare function deleteNoteAgentContextRecord(noteId: string): void;

package/dist/src/storage/sqlite/note-agent-context-repository.js

@@ -0,0 +1,35 @@
+import { requireXopcDatabase } from "./connection.js";
+//#region src/storage/sqlite/note-agent-context-repository.ts
+function getNoteAgentContextRecord(noteId) {
+	const row = requireXopcDatabase().db.prepare(`
+    SELECT note_id, note_updated_at, context_version, generated_at, payload_json
+    FROM note_agent_contexts
+    WHERE note_id = ?
+  `).get(noteId);
+	if (!row) return null;
+	return {
+		noteId: row.note_id,
+		noteUpdatedAt: row.note_updated_at,
+		contextVersion: row.context_version,
+		generatedAt: row.generated_at,
+		payload: JSON.parse(row.payload_json)
+	};
+}
+function upsertNoteAgentContextRecord(record) {
+	requireXopcDatabase().db.prepare(`
+    INSERT INTO note_agent_contexts (note_id, note_updated_at, context_version, generated_at, payload_json)
+    VALUES (?, ?, ?, ?, ?)
+    ON CONFLICT(note_id) DO UPDATE SET
+      note_updated_at = excluded.note_updated_at,
+      context_version = excluded.context_version,
+      generated_at = excluded.generated_at,
+      payload_json = excluded.payload_json
+  `).run(record.noteId, record.noteUpdatedAt, record.contextVersion, record.generatedAt, JSON.stringify(record.payload));
+}
+function deleteNoteAgentContextRecord(noteId) {
+	requireXopcDatabase().db.prepare(`DELETE FROM note_agent_contexts WHERE note_id = ?`).run(noteId);
+}
+//#endregion
+export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord };
+
+//# sourceMappingURL=note-agent-context-repository.js.map

package/dist/src/storage/sqlite/note-agent-context-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-agent-context-repository.js","names":[],"sources":["../../../../src/storage/sqlite/note-agent-context-repository.ts"],"sourcesContent":["import { requireXopcDatabase } from './connection.js';\n\nexport interface NoteAgentContextRecord<T = unknown> {\n  noteId: string;\n  noteUpdatedAt: number;\n  contextVersion: string;\n  generatedAt: number;\n  payload: T;\n}\n\nexport function getNoteAgentContextRecord<T = unknown>(noteId: string): NoteAgentContextRecord<T> | null {\n  const db = requireXopcDatabase().db;\n  const row = db.prepare(`\n    SELECT note_id, note_updated_at, context_version, generated_at, payload_json\n    FROM note_agent_contexts\n    WHERE note_id = ?\n  `).get(noteId) as { note_id: string; note_updated_at: number; context_version: string; generated_at: number; payload_json: string } | undefined;\n  if (!row) return null;\n  return {\n    noteId: row.note_id,\n    noteUpdatedAt: row.note_updated_at,\n    contextVersion: row.context_version,\n    generatedAt: row.generated_at,\n    payload: JSON.parse(row.payload_json) as T,\n  };\n}\n\nexport function upsertNoteAgentContextRecord(record: NoteAgentContextRecord): void {\n  const db = requireXopcDatabase().db;\n  db.prepare(`\n    INSERT INTO note_agent_contexts (note_id, note_updated_at, context_version, generated_at, payload_json)\n    VALUES (?, ?, ?, ?, ?)\n    ON CONFLICT(note_id) DO UPDATE SET\n      note_updated_at = excluded.note_updated_at,\n      context_version = excluded.context_version,\n      generated_at = excluded.generated_at,\n      payload_json = excluded.payload_json\n  `).run(\n    record.noteId,\n    record.noteUpdatedAt,\n    record.contextVersion,\n    record.generatedAt,\n    JSON.stringify(record.payload),\n  );\n}\n\nexport function deleteNoteAgentContextRecord(noteId: string): void {\n  const db = requireXopcDatabase().db;\n  db.prepare(`DELETE FROM note_agent_contexts WHERE note_id = ?`).run(noteId);\n}\n"],"mappings":";;AAUA,SAAgB,0BAAuC,QAAkD;CAEvG,MAAM,MADK,qBAAqB,CAAC,GAClB,QAAQ;;;;IAIrB,CAAC,IAAI,OAAO;AACd,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,QAAQ,IAAI;EACZ,eAAe,IAAI;EACnB,gBAAgB,IAAI;EACpB,aAAa,IAAI;EACjB,SAAS,KAAK,MAAM,IAAI,aAAa;EACtC;;AAGH,SAAgB,6BAA6B,QAAsC;AACtE,sBAAqB,CAAC,GAC9B,QAAQ;;;;;;;;IAQT,CAAC,IACD,OAAO,QACP,OAAO,eACP,OAAO,gBACP,OAAO,aACP,KAAK,UAAU,OAAO,QAAQ,CAC/B;;AAGH,SAAgB,6BAA6B,QAAsB;AACtD,sBAAqB,CAAC,GAC9B,QAAQ,oDAAoD,CAAC,IAAI,OAAO"}

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 3;
 	}
-	applyPendingMigrations(db, { targetVersion: 4 });
+	applyPendingMigrations(db, { targetVersion: 5 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/dist/src/tui/tui-startup-resources.js

@@ -4,10 +4,10 @@ import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
-import { listConnectorInstances } from "../connectors/instances.js";
 import { loadSkills } from "../agent/skills/index.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
+import { listConnectorInstances } from "../connectors/instances.js";
 import { basename } from "node:path";
 //#region src/tui/tui-startup-resources.ts
 init_paths();

package/dist/src/voice/stt/availability.d.ts

@@ -1,2 +1,8 @@
 import type { STTConfig } from './types.js';
+/**
+ * Lightweight availability check for channel routing. Do not import the STT
+ * factory/provider registry here; channel plugins call this at startup and the
+ * provider registry pulls optional SDKs (e.g. openai) into Electron's dynamic
+ * extension runtime path.
+ */
 export declare function isSTTAvailable(config?: STTConfig): boolean;

package/dist/src/voice/stt/availability.js

@@ -1,12 +1,20 @@
-import { resolveSTTProviderChain } from "./factory.js";
 //#region src/voice/stt/availability.ts
+function providerHasConfig(config, providerId) {
+	const provider = config.providers?.[providerId];
+	if (provider && Object.keys(provider).length > 0) return true;
+	return [...config.models ?? [], ...config.sharedModels ?? []].some((entry) => entry.provider === providerId && entry.capabilities?.includes("audio"));
+}
+/**
+* Lightweight availability check for channel routing. Do not import the STT
+* factory/provider registry here; channel plugins call this at startup and the
+* provider registry pulls optional SDKs (e.g. openai) into Electron's dynamic
+* extension runtime path.
+*/
 function isSTTAvailable(config) {
 	if (!config?.enabled) return false;
-	try {
-		return resolveSTTProviderChain(config).length > 0;
-	} catch {
-		return false;
-	}
+	if (providerHasConfig(config, config.provider)) return true;
+	if (config.fallback?.enabled) return config.fallback.order.some((providerId) => providerHasConfig(config, providerId));
+	return false;
 }
 //#endregion
 export { isSTTAvailable };

package/dist/src/voice/stt/availability.js.map

@@ -1 +1 @@
-{"version":3,"file":"availability.js","names":[],"sources":["../../../../src/voice/stt/availability.ts"],"sourcesContent":["import type { STTConfig } from './types.js';\nimport { resolveSTTProviderChain } from './factory.js';\n\nexport function isSTTAvailable(config?: STTConfig): boolean {\n  if (!config?.enabled) {\n    return false;\n  }\n  try {\n    return resolveSTTProviderChain(config).length > 0;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;AAGA,SAAgB,eAAe,QAA6B;AAC1D,KAAI,CAAC,QAAQ,QACX,QAAO;AAET,KAAI;AACF,SAAO,wBAAwB,OAAO,CAAC,SAAS;SAC1C;AACN,SAAO"}
+{"version":3,"file":"availability.js","names":[],"sources":["../../../../src/voice/stt/availability.ts"],"sourcesContent":["import type { STTConfig } from './types.js';\n\nfunction providerHasConfig(config: STTConfig, providerId: string): boolean {\n  const provider = config.providers?.[providerId];\n  if (provider && Object.keys(provider).length > 0) return true;\n  return [...(config.models ?? []), ...(config.sharedModels ?? [])].some(\n    (entry) => entry.provider === providerId && entry.capabilities?.includes('audio'),\n  );\n}\n\n/**\n * Lightweight availability check for channel routing. Do not import the STT\n * factory/provider registry here; channel plugins call this at startup and the\n * provider registry pulls optional SDKs (e.g. openai) into Electron's dynamic\n * extension runtime path.\n */\nexport function isSTTAvailable(config?: STTConfig): boolean {\n  if (!config?.enabled) return false;\n  if (providerHasConfig(config, config.provider)) return true;\n  if (config.fallback?.enabled) {\n    return config.fallback.order.some((providerId) => providerHasConfig(config, providerId));\n  }\n  return false;\n}\n"],"mappings":";AAEA,SAAS,kBAAkB,QAAmB,YAA6B;CACzE,MAAM,WAAW,OAAO,YAAY;AACpC,KAAI,YAAY,OAAO,KAAK,SAAS,CAAC,SAAS,EAAG,QAAO;AACzD,QAAO,CAAC,GAAI,OAAO,UAAU,EAAE,EAAG,GAAI,OAAO,gBAAgB,EAAE,CAAE,CAAC,MAC/D,UAAU,MAAM,aAAa,cAAc,MAAM,cAAc,SAAS,QAAQ,CAClF;;;;;;;;AASH,SAAgB,eAAe,QAA6B;AAC1D,KAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,KAAI,kBAAkB,QAAQ,OAAO,SAAS,CAAE,QAAO;AACvD,KAAI,OAAO,UAAU,QACnB,QAAO,OAAO,SAAS,MAAM,MAAM,eAAe,kBAAkB,QAAQ,WAAW,CAAC;AAE1F,QAAO"}

package/dist/src/voice/stt/index.js

@@ -4,7 +4,8 @@ import "./providers/index.js";
 import { resolveSTTProviderChain, resolveSTTProviderConfig, resolveSTTProviderOrder } from "./factory.js";
 import { transcribe } from "./transcribe-core.js";
 import { isSTTAvailable } from "./availability.js";
-import { audioPreflightTranscribe, checkMentionInTranscription } from "./preflight.js";
+import { checkMentionInTranscription } from "./mention.js";
+import { audioPreflightTranscribe } from "./preflight.js";
 //#region src/voice/stt/index.ts
 /**
 * Single-provider transcription helper. Used by chat-commands /stt so a user

package/dist/src/voice/stt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/voice/stt/index.ts"],"sourcesContent":["/**\n * STT (Speech-to-Text) Module\n *\n * v2.0: providers implement MediaUnderstandingProvider; orchestration goes\n * through the media-understanding runner. The legacy `transcribe()` /\n * `isSTTAvailable()` API surface is preserved for channel adapters.\n */\n\nimport './providers/index.js'; // side-effect: register built-in STT providers\n\nimport type { STTConfig, STTOptions, STTResult } from './types.js';\nimport { transcribe } from './transcribe-core.js';\n\nexport { transcribe } from './transcribe-core.js';\nexport { isSTTAvailable } from './availability.js';\n\n/**\n * Single-provider transcription helper. Used by chat-commands /stt so a user\n * can force a specific provider regardless of fallback config.\n */\nexport async function transcribeWithProvider(\n  audioBuffer: Buffer,\n  providerName: string,\n  config: STTConfig,\n  options?: STTOptions,\n): Promise<STTResult> {\n  // Build a per-call config that pins primary to the requested provider and\n  // disables fallback. This routes through the same runner machinery without\n  // needing a separate single-provider code path.\n  const pinnedConfig: STTConfig = {\n    ...config,\n    provider: providerName,\n    fallback: { enabled: false, order: [providerName] },\n  };\n  const result = await transcribe(audioBuffer, pinnedConfig, options);\n  return {\n    text: result.text,\n    provider: result.provider,\n    ...(result.duration !== undefined ? { duration: result.duration } : {}),\n    ...(result.language ? { language: result.language } : {}),\n  };\n}\n\nexport type {\n  STTResult,\n  STTOptions,\n  STTConfig,\n  STTResultWithTracking,\n  STTProviderAttempt,\n  STTProviderFailureReason,\n} from './types.js';\n\nexport { openAiTranscriptionProvider, alibabaTranscriptionProvider } from './providers/index.js';\n\nexport {\n  resolveSTTProviderConfig,\n  resolveSTTProviderChain,\n  resolveSTTProviderOrder,\n} from './factory.js';\n\nexport { audioPreflightTranscribe, checkMentionInTranscription } from './preflight.js';\n"],"mappings":";;;;;;;;;;;;AAoBA,eAAsB,uBACpB,aACA,cACA,QACA,SACoB;CASpB,MAAM,SAAS,MAAM,WAAW,aAAa;EAJ3C,GAAG;EACH,UAAU;EACV,UAAU;GAAE,SAAS;GAAO,OAAO,CAAC,aAAa;GAAE;EAEI,EAAE,QAAQ;AACnE,QAAO;EACL,MAAM,OAAO;EACb,UAAU,OAAO;EACjB,GAAI,OAAO,aAAa,KAAA,IAAY,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACtE,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACzD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/voice/stt/index.ts"],"sourcesContent":["/**\n * STT (Speech-to-Text) Module\n *\n * v2.0: providers implement MediaUnderstandingProvider; orchestration goes\n * through the media-understanding runner. The legacy `transcribe()` /\n * `isSTTAvailable()` API surface is preserved for channel adapters.\n */\n\nimport './providers/index.js'; // side-effect: register built-in STT providers\n\nimport type { STTConfig, STTOptions, STTResult } from './types.js';\nimport { transcribe } from './transcribe-core.js';\n\nexport { transcribe } from './transcribe-core.js';\nexport { isSTTAvailable } from './availability.js';\n\n/**\n * Single-provider transcription helper. Used by chat-commands /stt so a user\n * can force a specific provider regardless of fallback config.\n */\nexport async function transcribeWithProvider(\n  audioBuffer: Buffer,\n  providerName: string,\n  config: STTConfig,\n  options?: STTOptions,\n): Promise<STTResult> {\n  // Build a per-call config that pins primary to the requested provider and\n  // disables fallback. This routes through the same runner machinery without\n  // needing a separate single-provider code path.\n  const pinnedConfig: STTConfig = {\n    ...config,\n    provider: providerName,\n    fallback: { enabled: false, order: [providerName] },\n  };\n  const result = await transcribe(audioBuffer, pinnedConfig, options);\n  return {\n    text: result.text,\n    provider: result.provider,\n    ...(result.duration !== undefined ? { duration: result.duration } : {}),\n    ...(result.language ? { language: result.language } : {}),\n  };\n}\n\nexport type {\n  STTResult,\n  STTOptions,\n  STTConfig,\n  STTResultWithTracking,\n  STTProviderAttempt,\n  STTProviderFailureReason,\n} from './types.js';\n\nexport { openAiTranscriptionProvider, alibabaTranscriptionProvider } from './providers/index.js';\n\nexport {\n  resolveSTTProviderConfig,\n  resolveSTTProviderChain,\n  resolveSTTProviderOrder,\n} from './factory.js';\n\nexport { audioPreflightTranscribe, checkMentionInTranscription } from './preflight.js';\n"],"mappings":";;;;;;;;;;;;;AAoBA,eAAsB,uBACpB,aACA,cACA,QACA,SACoB;CASpB,MAAM,SAAS,MAAM,WAAW,aAAa;EAJ3C,GAAG;EACH,UAAU;EACV,UAAU;GAAE,SAAS;GAAO,OAAO,CAAC,aAAa;GAAE;EAEI,EAAE,QAAQ;AACnE,QAAO;EACL,MAAM,OAAO;EACb,UAAU,OAAO;EACjB,GAAI,OAAO,aAAa,KAAA,IAAY,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACtE,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACzD"}

package/dist/src/voice/stt/mention.d.ts

@@ -0,0 +1,2 @@
+/** Spoken @bot variants ("at botname", "hey botname") for STT text. */
+export declare function checkMentionInTranscription(transcribedText: string, botNames: string[]): boolean;

package/dist/src/voice/stt/mention.js

@@ -0,0 +1,20 @@
+//#region src/voice/stt/mention.ts
+/** Spoken @bot variants ("at botname", "hey botname") for STT text. */
+function checkMentionInTranscription(transcribedText, botNames) {
+	const normalizedText = transcribedText.toLowerCase().trim();
+	for (const name of botNames) {
+		const normalizedName = name.toLowerCase().trim();
+		if (!normalizedName) continue;
+		if (normalizedText.includes(normalizedName)) return true;
+		if ([
+			`at ${normalizedName}`,
+			`hey ${normalizedName}`,
+			`hi ${normalizedName}`
+		].some((pattern) => normalizedText.includes(pattern))) return true;
+	}
+	return false;
+}
+//#endregion
+export { checkMentionInTranscription };
+
+//# sourceMappingURL=mention.js.map

package/dist/src/voice/stt/mention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.js","names":[],"sources":["../../../../src/voice/stt/mention.ts"],"sourcesContent":["/** Spoken @bot variants (\"at botname\", \"hey botname\") for STT text. */\nexport function checkMentionInTranscription(transcribedText: string, botNames: string[]): boolean {\n  const normalizedText = transcribedText.toLowerCase().trim();\n\n  for (const name of botNames) {\n    const normalizedName = name.toLowerCase().trim();\n    if (!normalizedName) continue;\n\n    if (normalizedText.includes(normalizedName)) return true;\n\n    const fuzzyPatterns = [`at ${normalizedName}`, `hey ${normalizedName}`, `hi ${normalizedName}`];\n    if (fuzzyPatterns.some((pattern) => normalizedText.includes(pattern))) return true;\n  }\n\n  return false;\n}\n"],"mappings":";;AACA,SAAgB,4BAA4B,iBAAyB,UAA6B;CAChG,MAAM,iBAAiB,gBAAgB,aAAa,CAAC,MAAM;AAE3D,MAAK,MAAM,QAAQ,UAAU;EAC3B,MAAM,iBAAiB,KAAK,aAAa,CAAC,MAAM;AAChD,MAAI,CAAC,eAAgB;AAErB,MAAI,eAAe,SAAS,eAAe,CAAE,QAAO;AAGpD,MAAI;GADmB,MAAM;GAAkB,OAAO;GAAkB,MAAM;GAC7D,CAAC,MAAM,YAAY,eAAe,SAAS,QAAQ,CAAC,CAAE,QAAO;;AAGhF,QAAO"}

package/dist/src/voice/stt/preflight.d.ts

@@ -1,4 +1,5 @@
 import type { STTConfig } from './types.js';
+export { checkMentionInTranscription } from './mention.js';
 export interface AudioPreflightInput {
     audioBuffer: Buffer;
     mimeType?: string;
@@ -16,7 +17,3 @@ export interface AudioPreflightResult {
  * Transcribe audio before mention routing (e.g. group voice → detect spoken @bot).
  */
 export declare function audioPreflightTranscribe(input: AudioPreflightInput): Promise<AudioPreflightResult>;
-/**
- * Spoken @bot variants ("at botname", "hey botname") for STT text.
- */
-export declare function checkMentionInTranscription(transcribedText: string, botNames: string[]): boolean;

package/dist/src/voice/stt/preflight.js

@@ -2,6 +2,7 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { transcribe } from "./transcribe-core.js";
 import { isSTTAvailable } from "./availability.js";
+import { checkMentionInTranscription } from "./mention.js";
 //#region src/voice/stt/preflight.ts
 init_logger();
 const log = createLogger("STT:Preflight");
@@ -59,24 +60,6 @@ async function audioPreflightTranscribe(input) {
 		};
 	}
 }
-/**
-* Spoken @bot variants ("at botname", "hey botname") for STT text.
-*/
-function checkMentionInTranscription(transcribedText, botNames) {
-	const normalizedText = transcribedText.toLowerCase().trim();
-	for (const name of botNames) {
-		const normalizedName = name.toLowerCase().trim();
-		if (!normalizedName) continue;
-		if (normalizedText.includes(normalizedName)) return true;
-		const fuzzyPatterns = [
-			`at ${normalizedName}`,
-			`hey ${normalizedName}`,
-			`hi ${normalizedName}`
-		];
-		for (const pattern of fuzzyPatterns) if (normalizedText.includes(pattern)) return true;
-	}
-	return false;
-}
 //#endregion
 export { audioPreflightTranscribe, checkMentionInTranscription };
 

package/dist/src/voice/stt/preflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflight.js","names":[],"sources":["../../../../src/voice/stt/preflight.ts"],"sourcesContent":["import type { STTConfig, STTResult } from './types.js';\nimport { transcribe } from './transcribe-core.js';\nimport { isSTTAvailable } from './availability.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('STT:Preflight');\n\nexport interface AudioPreflightInput {\n  audioBuffer: Buffer;\n  mimeType?: string;\n  sttConfig: STTConfig;\n  language?: string;\n}\n\nexport interface AudioPreflightResult {\n  success: boolean;\n  transcribedText?: string;\n  provider?: string;\n  duration?: number;\n  error?: string;\n}\n\n/**\n * Transcribe audio before mention routing (e.g. group voice → detect spoken @bot).\n */\nexport async function audioPreflightTranscribe(\n  input: AudioPreflightInput,\n): Promise<AudioPreflightResult> {\n  const { audioBuffer, sttConfig, language } = input;\n\n  if (!isSTTAvailable(sttConfig)) {\n    log.debug('STT not available, skipping preflight');\n    return { success: false, error: 'STT not available' };\n  }\n\n  if (!audioBuffer || audioBuffer.length === 0) {\n    return { success: false, error: 'Empty audio buffer' };\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const result: STTResult = await transcribe(audioBuffer, sttConfig, {\n      language,\n    });\n\n    const duration = (Date.now() - startTime) / 1000;\n\n    if (!result.text?.trim()) {\n      log.debug({ duration }, 'Preflight transcription returned empty text');\n      return {\n        success: false,\n        provider: result.provider,\n        duration,\n        error: 'Empty transcription result',\n      };\n    }\n\n    log.info(\n      {\n        provider: result.provider,\n        textLength: result.text.length,\n        duration,\n      },\n      'Audio preflight transcription completed',\n    );\n\n    return {\n      success: true,\n      transcribedText: result.text,\n      provider: result.provider,\n      duration,\n    };\n  } catch (error) {\n    const duration = (Date.now() - startTime) / 1000;\n    const errorMsg = error instanceof Error ? error.message : String(error);\n\n    log.warn({ errorMessage: errorMsg, duration }, 'Audio preflight transcription failed');\n\n    return {\n      success: false,\n      duration,\n      error: errorMsg,\n    };\n  }\n}\n\n/**\n * Spoken @bot variants (\"at botname\", \"hey botname\") for STT text.\n */\nexport function checkMentionInTranscription(transcribedText: string, botNames: string[]): boolean {\n  const normalizedText = transcribedText.toLowerCase().trim();\n\n  for (const name of botNames) {\n    const normalizedName = name.toLowerCase().trim();\n    if (!normalizedName) continue;\n\n    if (normalizedText.includes(normalizedName)) {\n      return true;\n    }\n\n    const fuzzyPatterns = [`at ${normalizedName}`, `hey ${normalizedName}`, `hi ${normalizedName}`];\n\n    for (const pattern of fuzzyPatterns) {\n      if (normalizedText.includes(pattern)) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n"],"mappings":";;;;;aAGqD;AAErD,MAAM,MAAM,aAAa,gBAAgB;;;;AAoBzC,eAAsB,yBACpB,OAC+B;CAC/B,MAAM,EAAE,aAAa,WAAW,aAAa;AAE7C,KAAI,CAAC,eAAe,UAAU,EAAE;AAC9B,MAAI,MAAM,wCAAwC;AAClD,SAAO;GAAE,SAAS;GAAO,OAAO;GAAqB;;AAGvD,KAAI,CAAC,eAAe,YAAY,WAAW,EACzC,QAAO;EAAE,SAAS;EAAO,OAAO;EAAsB;CAGxD,MAAM,YAAY,KAAK,KAAK;AAE5B,KAAI;EACF,MAAM,SAAoB,MAAM,WAAW,aAAa,WAAW,EACjE,UACD,CAAC;EAEF,MAAM,YAAY,KAAK,KAAK,GAAG,aAAa;AAE5C,MAAI,CAAC,OAAO,MAAM,MAAM,EAAE;AACxB,OAAI,MAAM,EAAE,UAAU,EAAE,8CAA8C;AACtE,UAAO;IACL,SAAS;IACT,UAAU,OAAO;IACjB;IACA,OAAO;IACR;;AAGH,MAAI,KACF;GACE,UAAU,OAAO;GACjB,YAAY,OAAO,KAAK;GACxB;GACD,EACD,0CACD;AAED,SAAO;GACL,SAAS;GACT,iBAAiB,OAAO;GACxB,UAAU,OAAO;GACjB;GACD;UACM,OAAO;EACd,MAAM,YAAY,KAAK,KAAK,GAAG,aAAa;EAC5C,MAAM,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAEvE,MAAI,KAAK;GAAE,cAAc;GAAU;GAAU,EAAE,uCAAuC;AAEtF,SAAO;GACL,SAAS;GACT;GACA,OAAO;GACR;;;;;;AAOL,SAAgB,4BAA4B,iBAAyB,UAA6B;CAChG,MAAM,iBAAiB,gBAAgB,aAAa,CAAC,MAAM;AAE3D,MAAK,MAAM,QAAQ,UAAU;EAC3B,MAAM,iBAAiB,KAAK,aAAa,CAAC,MAAM;AAChD,MAAI,CAAC,eAAgB;AAErB,MAAI,eAAe,SAAS,eAAe,CACzC,QAAO;EAGT,MAAM,gBAAgB;GAAC,MAAM;GAAkB,OAAO;GAAkB,MAAM;GAAiB;AAE/F,OAAK,MAAM,WAAW,cACpB,KAAI,eAAe,SAAS,QAAQ,CAClC,QAAO;;AAKb,QAAO"}
+{"version":3,"file":"preflight.js","names":[],"sources":["../../../../src/voice/stt/preflight.ts"],"sourcesContent":["import type { STTConfig, STTResult } from './types.js';\nimport { transcribe } from './transcribe-core.js';\nimport { isSTTAvailable } from './availability.js';\nexport { checkMentionInTranscription } from './mention.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('STT:Preflight');\n\nexport interface AudioPreflightInput {\n  audioBuffer: Buffer;\n  mimeType?: string;\n  sttConfig: STTConfig;\n  language?: string;\n}\n\nexport interface AudioPreflightResult {\n  success: boolean;\n  transcribedText?: string;\n  provider?: string;\n  duration?: number;\n  error?: string;\n}\n\n/**\n * Transcribe audio before mention routing (e.g. group voice → detect spoken @bot).\n */\nexport async function audioPreflightTranscribe(\n  input: AudioPreflightInput,\n): Promise<AudioPreflightResult> {\n  const { audioBuffer, sttConfig, language } = input;\n\n  if (!isSTTAvailable(sttConfig)) {\n    log.debug('STT not available, skipping preflight');\n    return { success: false, error: 'STT not available' };\n  }\n\n  if (!audioBuffer || audioBuffer.length === 0) {\n    return { success: false, error: 'Empty audio buffer' };\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const result: STTResult = await transcribe(audioBuffer, sttConfig, {\n      language,\n    });\n\n    const duration = (Date.now() - startTime) / 1000;\n\n    if (!result.text?.trim()) {\n      log.debug({ duration }, 'Preflight transcription returned empty text');\n      return {\n        success: false,\n        provider: result.provider,\n        duration,\n        error: 'Empty transcription result',\n      };\n    }\n\n    log.info(\n      {\n        provider: result.provider,\n        textLength: result.text.length,\n        duration,\n      },\n      'Audio preflight transcription completed',\n    );\n\n    return {\n      success: true,\n      transcribedText: result.text,\n      provider: result.provider,\n      duration,\n    };\n  } catch (error) {\n    const duration = (Date.now() - startTime) / 1000;\n    const errorMsg = error instanceof Error ? error.message : String(error);\n\n    log.warn({ errorMessage: errorMsg, duration }, 'Audio preflight transcription failed');\n\n    return {\n      success: false,\n      duration,\n      error: errorMsg,\n    };\n  }\n}\n\n"],"mappings":";;;;;;aAIqD;AAErD,MAAM,MAAM,aAAa,gBAAgB;;;;AAoBzC,eAAsB,yBACpB,OAC+B;CAC/B,MAAM,EAAE,aAAa,WAAW,aAAa;AAE7C,KAAI,CAAC,eAAe,UAAU,EAAE;AAC9B,MAAI,MAAM,wCAAwC;AAClD,SAAO;GAAE,SAAS;GAAO,OAAO;GAAqB;;AAGvD,KAAI,CAAC,eAAe,YAAY,WAAW,EACzC,QAAO;EAAE,SAAS;EAAO,OAAO;EAAsB;CAGxD,MAAM,YAAY,KAAK,KAAK;AAE5B,KAAI;EACF,MAAM,SAAoB,MAAM,WAAW,aAAa,WAAW,EACjE,UACD,CAAC;EAEF,MAAM,YAAY,KAAK,KAAK,GAAG,aAAa;AAE5C,MAAI,CAAC,OAAO,MAAM,MAAM,EAAE;AACxB,OAAI,MAAM,EAAE,UAAU,EAAE,8CAA8C;AACtE,UAAO;IACL,SAAS;IACT,UAAU,OAAO;IACjB;IACA,OAAO;IACR;;AAGH,MAAI,KACF;GACE,UAAU,OAAO;GACjB,YAAY,OAAO,KAAK;GACxB;GACD,EACD,0CACD;AAED,SAAO;GACL,SAAS;GACT,iBAAiB,OAAO;GACxB,UAAU,OAAO;GACjB;GACD;UACM,OAAO;EACd,MAAM,YAAY,KAAK,KAAK,GAAG,aAAa;EAC5C,MAAM,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAEvE,MAAI,KAAK;GAAE,cAAc;GAAU;GAAU,EAAE,uCAAuC;AAEtF,SAAO;GACL,SAAS;GACT;GACA,OAAO;GACR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.104",
+  "version": "0.0.106",
   "description": "Goal Loop OS for long-term AI work: a local-first multi-surface agent system with workflow automation, multi-agent routing, and extensibility via extensions/skills.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -100,7 +100,7 @@
     "semver": "^7.8.1",
     "silk-wasm": "^3.7.1",
     "thread-stream": "^4.2.0",
-    "undici": "^8.3.0",
+    "undici": "^8.5.0",
     "uuid": "^14.0.0",
     "ws": "^8.21.0",
     "zod": "^4.4.3"
@@ -118,7 +118,7 @@
     "@vitejs/plugin-react-swc": "^4.3.1",
     "cross-env": "^10.1.0",
     "dependency-cruiser": "^17.4.3",
-    "electron": "^41.7.1",
+    "electron": "^42.4.1",
     "electron-builder": "^26.12.1",
     "electron-vite": "^6.0.0-beta.1",
     "esbuild": "^0.28.1",
@@ -182,7 +182,7 @@
     "electron:server:build": "node scripts/build-electron-server.mjs",
     "electron:frpc:download": "node --import tsx/esm scripts/download-frpc-binaries.mjs",
     "electron:frpc:download:all": "node --import tsx/esm scripts/download-frpc-binaries.mjs --all",
-    "electron:build": "pnpm run electron:vite:build:package && pnpm run electron:server:build && pnpm run electron:package",
+    "electron:build": "pnpm run build:web && pnpm run electron:vite:build:package && pnpm run electron:server:build && pnpm run electron:package",
     "electron:preview": "cross-env ELECTRON_ENTRY=out/main/index.js electron-vite preview"
   }
 }