desktop/src-tauri/crates/core/src/adapters/openclaw/common.rs

Comment 1, line 1

//! OpenClaw-specific shared helpers under the independent adapter-directory convention:

//! - Read-only database helpers copied from `adapters/kilo/common.rs`; each Agent keeps

//!   its own module with product-specific prefixes and comments.

//! - Read-only schema/ownership checks inspect columns and primary metadata, without transcripts.

//!

//! References and checks: A09, official docs.openclaw.ai, checked 2026-09-24.

//! - Store: one `~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite` per Agent,

//!   with session rows and append-only transcripts; legacy `sessions/` and

//!   `sessions/sessions.json` are migration/archive inputs not imported at Gateway startup.

//! - Schema 24, official 2026.9.8 installation and real CLI samples checked; full rules:

//!   docs/design/desktop-usage/openclaw-runtime.md.

/// Read-only source access; busy-like probe failures switch to a staging snapshot.

/// SQLite busy/locked/CANTOPEN errors prevent a successful consistency probe.

/// Staging limits follow the kilo/hermes convention.

// More means pages were copied; count those pages toward the size limit.

// Busy/Locked or other non-exhaustive results retry without progress, within the timeout.

// 2026-09-30 fix: retries previously added pages and raced the timeout, causing

// platform-specific false size-limit failures (Linux CI hit the page cap before timeout).

/// Check structure/ownership only; database schema does not identify historical client versions.