Loading files
This file is pinned to the selected release. Download the original to open it in your design tool.
efddeb4edThis file is pinned to the selected release. Download the original to open it in your design tool.
/**
* Is the `sqlite3` CLI present?
*
* Four engines keep their conversations in SQLite rather than in a transcript file and are read by
* shelling out to `sqlite3` (`engines/{opencode,kilo,hermes,devin}/reader.ts`), as is one branch of
* session repair. macOS ships `/usr/bin/sqlite3` in the base system, so this has never had to be
* checked; a stock `ubuntu:24.04` does NOT ship it (measured), and neither does a slim Node image, so
* on Linux those four engines silently mirror nothing until the user installs it.
*
* Resolved from PATH directly rather than by spawning: this runs on the startup path and the answer is
* only used for one advisory log line.
*/
import { binaryOnPath } from './binaryOnPath.js'
/** Engines that cannot be mirrored without the CLI. Keep in sync with the readers listed above. */
export const SQLITE_BACKED_ENGINES = ['opencode', 'kilo', 'hermes', 'devin'] as const
let cached: boolean | null = null
export function hasSqliteCli(): boolean {
if (cached !== null) return cached
cached = binaryOnPath('sqlite3')
return cached
}
/** One advisory line at startup. Says what is affected and exactly how to fix it — never throws. */
export function sqlitePreflightMessage(): string | null {
if (hasSqliteCli()) return null
const install = process.platform === 'linux'
? 'sudo apt install sqlite3 (or your distro\'s equivalent)'
: 'install the sqlite3 CLI and make sure it is on PATH'
return `[preflight] sqlite3 CLI not found on PATH — ${SQLITE_BACKED_ENGINES.join(', ')}`
+ ` agents cannot be mirrored. Every other engine is unaffected. Fix: ${install}`
}
/** Test seam: forget the cached answer. */
export function resetSqliteAvailabilityCache(): void { cached = null }