@24klynx/core 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,345 @@
+import Database$1, { Database } from "better-sqlite3";
+
+//#region src/types.d.ts
+/**
+ * Core type definitions for the Lynx agent system.
+ * All other packages depend on these interfaces — keep them stable.
+ */
+/** Opaque session identifier (UUID v4). */
+type SessionId = string & {
+  readonly __brand: "SessionId";
+};
+/** Opaque message identifier (UUID v4). */
+type MessageId = string & {
+  readonly __brand: "MessageId";
+};
+/**
+ * Discriminated union of all content types an LLM can emit or receive.
+ * The `reasoning` variant captures chain-of-thought from models like
+ * DeepSeek R1 and OpenAI o1.
+ */
+type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ReasoningBlock;
+interface TextBlock {
+  type: "text";
+  /** Plain text content emitted by the LLM. */
+  text: string;
+}
+interface ToolUseBlock {
+  type: "tool_use";
+  /** Unique ID for matching tool results back to calls. */
+  id: string;
+  /** Name of the tool being invoked. */
+  name: string;
+  /** Arguments passed to the tool. */
+  input: Record<string, unknown>;
+}
+interface ToolResultBlock {
+  type: "tool_result";
+  /** Matches the `id` of the corresponding `tool_use` block. */
+  toolUseId: string;
+  /** Text or structured output from the tool execution. */
+  content: string;
+  /** Set to true when the tool execution failed. */
+  isError?: boolean;
+}
+interface ReasoningBlock {
+  type: "reasoning";
+  /** Chain-of-thought text (e.g. DeepSeek R1, OpenAI o1). */
+  text: string;
+}
+interface Message {
+  /** Unique identifier (UUID v4). */
+  id: MessageId;
+  /** Who sent this message — user, assistant, or system. */
+  role: "user" | "assistant" | "system";
+  /** Content blocks making up the message body. */
+  content: ContentBlock[];
+  /** Unix timestamp in milliseconds. */
+  timestamp: number;
+  /** Zero-based index within the session's message list. */
+  turnIndex: number;
+}
+/**
+ * Flexible metadata bag attached to every session.
+ * Keys are strings to allow extension without breaking DB rows.
+ */
+interface SessionMetadata {
+  /** Whether the last session run was interrupted (crash / SIGKILL). */
+  crashed?: boolean;
+  /** Model identifier used for this session (e.g. "deepseek-v3"). */
+  model?: string;
+  /** Active permission mode when the session was last saved. */
+  permissionMode?: string;
+  /** Additional entries injected by plugins or migrations. */
+  [key: string]: unknown;
+}
+interface Session {
+  /** Unique session identifier (UUID v4). */
+  id: SessionId;
+  /** User-visible label shown in the session picker. */
+  label: string;
+  /** Absolute path to the workspace directory. */
+  workspace: string;
+  /** Ordered message history. */
+  messages: Message[];
+  /** The session this one was forked from, if any. */
+  parentSessionId?: SessionId;
+  /** Message count at the time of fork. */
+  forkedFromMessageCount?: number;
+  /** Unix ms — set on create. */
+  createdAt: number;
+  /** Unix ms — bumped on every mutation. */
+  updatedAt: number;
+  /** Flexible metadata bag (model, permission mode, crash state, etc.). */
+  metadata: SessionMetadata;
+}
+/**
+ * Serializable record of a tool being invoked.
+ * The full tool descriptor lives in @lynx/tools; core only stores
+ * the invocation trace needed for session replay.
+ */
+interface ToolCall {
+  /** Matches the `id` in `ToolUseBlock`. */
+  id: string;
+  /** Name of the tool being invoked. */
+  name: string;
+  /** Arguments supplied by the LLM. */
+  input: Record<string, unknown>;
+  /** Unix ms when the tool started executing. */
+  startedAt: number;
+  /** Unix ms when the tool finished (undefined if still running). */
+  finishedAt?: number;
+}
+interface ToolResult {
+  /** Matches `ToolCall.id`. */
+  toolCallId: string;
+  /** Text or structured output from the tool. */
+  output: string;
+  /** Whether the tool execution ended in an error. */
+  isError: boolean;
+  /** Unix ms when execution completed. */
+  finishedAt: number;
+}
+/** Create a new SessionId from a UUID string. */
+declare function asSessionId(id: string): SessionId;
+/** Create a new MessageId from a UUID string. */
+declare function asMessageId(id: string): MessageId;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Layered error system for Lynx.
+ *
+ * Layer 1 — LynxError subclasses: typed, machine‑actionable errors
+ *   each carries recoverable / retryable / userVisible / diagnosticHint.
+ * Layer 2 — ErrorEnvelope: cross‑boundary wrapper with category + severity.
+ * Layer 3 — Top‑level catch in lynx‑cli/entry.ts formats and routes.
+ */
+/**
+ * Which subsystem raised the error.
+ * Used by error reporters and /doctor to route diagnostics.
+ */
+type ErrorCategory = "tool" | "llm" | "session" | "plugin" | "channel" | "config" | "storage";
+/**
+ * Severity level for log routing and user notification.
+ * "debug"/"info" are suppressed in production; "fatal" triggers process exit.
+ */
+type ErrorSeverity = "debug" | "info" | "warn" | "error" | "fatal";
+/** Configuration for constructing a LynxError. */
+interface LynxErrorOptions {
+  /** Which subsystem raised this error. */
+  category: ErrorCategory;
+  /** Whether the system can recover without user intervention. */
+  recoverable?: boolean;
+  /** Whether retrying the same operation might succeed. */
+  retryable?: boolean;
+  /** Whether the message should be shown to the user. */
+  userVisible?: boolean;
+  /** Pointer to a /doctor check (e.g. "storage_migration_failed"). */
+  diagnosticHint?: string;
+}
+declare class LynxError extends Error {
+  /** Which subsystem raised this error. */
+  readonly category: ErrorCategory;
+  /** Whether the system can recover without user intervention. */
+  readonly recoverable: boolean;
+  /** Whether retrying the same operation might succeed. */
+  readonly retryable: boolean;
+  /** Whether the message should be shown to the user. */
+  readonly userVisible: boolean;
+  /** Pointer to a /doctor check (e.g. "storage_migration_failed"). */
+  readonly diagnosticHint: string | undefined;
+  constructor(message: string, opts: LynxErrorOptions);
+}
+declare class ToolError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class ToolTimeoutError extends ToolError {
+  constructor(message?: string);
+}
+declare class ToolAbortedError extends ToolError {
+  constructor(message?: string);
+}
+declare class ToolPermissionError extends ToolError {
+  constructor(message?: string);
+}
+declare class LlmError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class LlmRateLimitError extends LlmError {
+  /** HTTP status code (429 for rate limit, 529 for overload). */
+  status: number;
+  constructor(message?: string, status?: number);
+}
+declare class LlmAuthError extends LlmError {
+  constructor(message?: string);
+}
+declare class LlmContextOverflowError extends LlmError {
+  constructor(message?: string);
+}
+declare class SessionError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class SessionNotFoundError extends SessionError {
+  constructor(sessionId: string);
+}
+declare class SessionLockedError extends SessionError {
+  constructor(sessionId: string);
+}
+declare class AgentError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class PluginError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class PluginLoadError extends PluginError {
+  constructor(pluginName: string, cause?: unknown);
+}
+declare class PluginHookError extends PluginError {
+  constructor(hookName: string, cause?: unknown);
+}
+declare class ChannelError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class ConfigError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class StorageError extends LynxError {
+  constructor(message: string, opts?: Partial<LynxErrorOptions>);
+}
+declare class StorageCorruptedError extends StorageError {
+  constructor(message?: string);
+}
+declare class StorageFullError extends StorageError {
+  constructor(message?: string);
+}
+interface ErrorEnvelope {
+  category: ErrorCategory;
+  severity: ErrorSeverity;
+  recoverable: boolean;
+  retryable: boolean;
+  /** Machine‑readable error code, e.g. "LLM_RATE_LIMIT". */
+  code: string;
+  /** Human‑readable message. */
+  message: string;
+  /** Chained cause, if this error wraps another. */
+  cause?: ErrorEnvelope;
+  /** Opaque trace id for correlating logs with user reports. */
+  traceId?: string;
+  /** Current operation span (agent_loop / tool_exec / model_call). */
+  spanId?: string;
+  /** Session this error occurred in, if applicable. */
+  sessionId?: string;
+  /** Unix ms when the error was captured. */
+  wallTime?: number;
+}
+/** Lift any Error into a safe ErrorEnvelope for cross‑boundary transport. */
+declare function toErrorEnvelope(err: unknown, overrides?: Partial<ErrorEnvelope>): ErrorEnvelope;
+/**
+ * Throw this when a function body is intentionally not implemented yet.
+ * CI detects remaining `NotImplementedError` throws and fails the Phase gate.
+ */
+declare class NotImplementedError extends Error {
+  constructor(feature: string);
+}
+//#endregion
+//#region src/paths.d.ts
+/**
+ * Centralised path resolution for all Lynx data directories.
+ *
+ * Default root is `~/.lynx` (or `%USERPROFILE%/.lynx` on Windows).
+ * Every sub‑directory can be overridden individually via environment variables
+ * so that state, logs, config, and skills can live on separate volumes.
+ */
+interface LynxPaths {
+  /** Root data directory (~/.lynx or $LYNX_HOME). */
+  home: string;
+  /** Main JSON configuration file. */
+  configFile: string;
+  /** User preference file (theme, keybinds). */
+  settingsFile: string;
+  /** TUI‑specific preferences (survive across projects). */
+  tuiFile: string;
+  /** SQLite state database path. */
+  stateDb: string;
+  /** Directory holding per‑session JSON files. */
+  sessionsDir: string;
+  /** Log output directory. */
+  logDir: string;
+  /** Security audit log (JSONL). */
+  auditLog: string;
+  /** Capacity memory records. */
+  memoryDir: string;
+  /** Workspace snapshots (git side‑repo). */
+  snapshotsDir: string;
+  /** User‑level skills. */
+  skillsDir: string;
+  /** Shell completion cache. */
+  completionsDir: string;
+  /** Input history file. */
+  composerHistory: string;
+  /** Ctrl+S stash file. */
+  composerStash: string;
+  /** Update concurrency lock file. */
+  updateLock: string;
+}
+/**
+ * Resolve every data path from environment variables.
+ * Called once at startup; result is immutable for the lifetime of the process.
+ */
+declare function resolvePaths(env?: NodeJS.ProcessEnv): LynxPaths;
+//#endregion
+//#region src/db.d.ts
+interface DbConfig {
+  /** Absolute path to the .db file. */
+  dbPath: string;
+  /** If true (default), journal_mode = WAL. */
+  walMode?: boolean;
+}
+/**
+ * Open (or create) the Lynx state database with WAL mode enabled.
+ * Call this once per process in the bootstrap phase.
+ */
+declare function openDatabase(config: DbConfig): Database$1.Database;
+//#endregion
+//#region src/migrate.d.ts
+interface Migration {
+  /** Monotonically‑increasing schema version. */
+  version: number;
+  /** Human‑readable summary of what this migration does. */
+  description: string;
+  /** SQL statements executed inside a transaction. */
+  sql: string;
+  /** Optional rollback SQL. If omitted, a failed migration leaves the DB dirty. */
+  rollback?: string;
+}
+declare const MIGRATIONS: Migration[];
+/** The schema version this build of Lynx expects. */
+declare const EXPECTED_VERSION: number;
+/**
+ * Apply any pending migrations to bring `db` up to EXPECTED_VERSION.
+ * Safe to call on every startup — no‑op if already current.
+ */
+declare function migrate(db: Database$1.Database): void;
+//#endregion
+export { AgentError, ChannelError, ConfigError, type ContentBlock, type Database, type DbConfig, EXPECTED_VERSION, type ErrorCategory, type ErrorEnvelope, type ErrorSeverity, LlmAuthError, LlmContextOverflowError, LlmError, LlmRateLimitError, LynxError, type LynxPaths, MIGRATIONS, type Message, type MessageId, type Migration, NotImplementedError, PluginError, PluginHookError, PluginLoadError, type ReasoningBlock, type Session, SessionError, type SessionId, SessionLockedError, type SessionMetadata, SessionNotFoundError, StorageCorruptedError, StorageError, StorageFullError, type TextBlock, ToolAbortedError, type ToolCall, ToolError, ToolPermissionError, type ToolResult, type ToolResultBlock, ToolTimeoutError, type ToolUseBlock, asMessageId, asSessionId, migrate, openDatabase, resolvePaths, toErrorEnvelope };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/paths.ts","../src/db.ts","../src/migrate.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,452 @@
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+//#region src/types.ts
+/** Create a new SessionId from a UUID string. */
+function asSessionId(id) {
+	return id;
+}
+/** Create a new MessageId from a UUID string. */
+function asMessageId(id) {
+	return id;
+}
+//#endregion
+//#region src/errors.ts
+var LynxError = class extends Error {
+	/** Which subsystem raised this error. */
+	category;
+	/** Whether the system can recover without user intervention. */
+	recoverable;
+	/** Whether retrying the same operation might succeed. */
+	retryable;
+	/** Whether the message should be shown to the user. */
+	userVisible;
+	/** Pointer to a /doctor check (e.g. "storage_migration_failed"). */
+	diagnosticHint;
+	constructor(message, opts) {
+		super(message);
+		this.name = "LynxError";
+		this.category = opts.category;
+		this.recoverable = opts.recoverable ?? false;
+		this.retryable = opts.retryable ?? false;
+		this.userVisible = opts.userVisible ?? true;
+		this.diagnosticHint = opts.diagnosticHint;
+	}
+};
+var ToolError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "tool",
+			recoverable: false,
+			retryable: false,
+			...opts
+		});
+		this.name = "ToolError";
+	}
+};
+var ToolTimeoutError = class extends ToolError {
+	constructor(message = "Tool execution timed out (60s)") {
+		super(message, {
+			userVisible: false,
+			diagnosticHint: "tool_timeout"
+		});
+		this.name = "ToolTimeoutError";
+	}
+};
+var ToolAbortedError = class extends ToolError {
+	constructor(message = "Tool execution was cancelled") {
+		super(message, { userVisible: true });
+		this.name = "ToolAbortedError";
+	}
+};
+var ToolPermissionError = class extends ToolError {
+	constructor(message = "Permission denied for tool execution") {
+		super(message, { userVisible: true });
+		this.name = "ToolPermissionError";
+	}
+};
+var LlmError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "llm",
+			recoverable: true,
+			retryable: true,
+			...opts
+		});
+		this.name = "LlmError";
+	}
+};
+var LlmRateLimitError = class extends LlmError {
+	/** HTTP status code (429 for rate limit, 529 for overload). */
+	status;
+	constructor(message = "LLM rate limited (429 / 529)", status = 429) {
+		super(message, { diagnosticHint: "llm_rate_limit" });
+		this.name = "LlmRateLimitError";
+		this.status = status;
+	}
+};
+var LlmAuthError = class extends LlmError {
+	constructor(message = "LLM authentication failed (401 / 403)") {
+		super(message, {
+			recoverable: true,
+			retryable: false,
+			diagnosticHint: "llm_auth"
+		});
+		this.name = "LlmAuthError";
+	}
+};
+var LlmContextOverflowError = class extends LlmError {
+	constructor(message = "Prompt exceeds model context window") {
+		super(message, {
+			recoverable: true,
+			retryable: true,
+			diagnosticHint: "llm_context_overflow"
+		});
+		this.name = "LlmContextOverflowError";
+	}
+};
+var SessionError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "session",
+			recoverable: false,
+			retryable: false,
+			...opts
+		});
+		this.name = "SessionError";
+	}
+};
+var SessionNotFoundError = class extends SessionError {
+	constructor(sessionId) {
+		super(`Session not found: ${sessionId}`, { userVisible: true });
+		this.name = "SessionNotFoundError";
+	}
+};
+var SessionLockedError = class extends SessionError {
+	constructor(sessionId) {
+		super(`Session locked (concurrent write): ${sessionId}`, {
+			recoverable: true,
+			retryable: true
+		});
+		this.name = "SessionLockedError";
+	}
+};
+var AgentError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "llm",
+			recoverable: true,
+			retryable: false,
+			...opts
+		});
+		this.name = "AgentError";
+	}
+};
+var PluginError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "plugin",
+			recoverable: true,
+			retryable: false,
+			...opts
+		});
+		this.name = "PluginError";
+	}
+};
+var PluginLoadError = class extends PluginError {
+	constructor(pluginName, cause) {
+		super(`Plugin "${pluginName}" failed to load: ${String(cause)}`, { userVisible: true });
+		this.name = "PluginLoadError";
+	}
+};
+var PluginHookError = class extends PluginError {
+	constructor(hookName, cause) {
+		super(`Hook "${hookName}" threw: ${String(cause)}`, { userVisible: false });
+		this.name = "PluginHookError";
+	}
+};
+var ChannelError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "channel",
+			recoverable: true,
+			retryable: true,
+			...opts
+		});
+		this.name = "ChannelError";
+	}
+};
+var ConfigError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "config",
+			recoverable: false,
+			retryable: false,
+			...opts
+		});
+		this.name = "ConfigError";
+	}
+};
+var StorageError = class extends LynxError {
+	constructor(message, opts) {
+		super(message, {
+			category: "storage",
+			recoverable: false,
+			retryable: false,
+			...opts
+		});
+		this.name = "StorageError";
+	}
+};
+var StorageCorruptedError = class extends StorageError {
+	constructor(message = "Database file is corrupted") {
+		super(message, { diagnosticHint: "storage_corrupted" });
+		this.name = "StorageCorruptedError";
+	}
+};
+var StorageFullError = class extends StorageError {
+	constructor(message = "Disk full — cannot write to storage") {
+		super(message, {
+			userVisible: true,
+			diagnosticHint: "storage_full"
+		});
+		this.name = "StorageFullError";
+	}
+};
+/** Lift any Error into a safe ErrorEnvelope for cross‑boundary transport. */
+function toErrorEnvelope(err, overrides) {
+	if (err instanceof LynxError) return {
+		category: err.category,
+		severity: "error",
+		recoverable: err.recoverable,
+		retryable: err.retryable,
+		code: err.name.toUpperCase(),
+		message: err.message,
+		wallTime: Date.now(),
+		...overrides
+	};
+	if (err instanceof Error) return {
+		category: "storage",
+		severity: "error",
+		recoverable: false,
+		retryable: false,
+		code: "UNKNOWN",
+		message: err.message,
+		wallTime: Date.now(),
+		...overrides
+	};
+	return {
+		category: "storage",
+		severity: "fatal",
+		recoverable: false,
+		retryable: false,
+		code: "UNKNOWN",
+		message: String(err),
+		wallTime: Date.now(),
+		...overrides
+	};
+}
+/**
+* Throw this when a function body is intentionally not implemented yet.
+* CI detects remaining `NotImplementedError` throws and fails the Phase gate.
+*/
+var NotImplementedError = class extends Error {
+	constructor(feature) {
+		super(`Not implemented: ${feature}`);
+		this.name = "NotImplementedError";
+	}
+};
+//#endregion
+//#region src/paths.ts
+/**
+* Centralised path resolution for all Lynx data directories.
+*
+* Default root is `~/.lynx` (or `%USERPROFILE%/.lynx` on Windows).
+* Every sub‑directory can be overridden individually via environment variables
+* so that state, logs, config, and skills can live on separate volumes.
+*/
+/**
+* Normalise path separators to forward slashes.
+* Node.js on Windows accepts both `C:\Users` and `C:/Users`,
+* but we want consistent POSIX‑style paths across the codebase.
+*/
+function posix(p) {
+	return p.replace(/\\/g, "/");
+}
+/** Default data root. */
+const DEFAULT_HOME = posix(join(homedir(), ".lynx"));
+/**
+* Resolve every data path from environment variables.
+* Called once at startup; result is immutable for the lifetime of the process.
+*/
+function resolvePaths(env = process.env) {
+	const home = env.LYNX_HOME ?? DEFAULT_HOME;
+	const stateDir = env.LYNX_STATE_DIR ?? posix(join(home, "sessions"));
+	const logDir = env.LYNX_LOG_DIR ?? posix(join(home, "logs"));
+	return {
+		home,
+		configFile: env.LYNX_CONFIG_PATH ?? posix(join(home, "config.json")),
+		settingsFile: posix(join(home, "settings.json")),
+		tuiFile: posix(join(home, "tui.json")),
+		stateDb: posix(join(home, "state.db")),
+		sessionsDir: stateDir,
+		logDir,
+		auditLog: posix(join(home, "audit.log")),
+		memoryDir: posix(join(home, "memory")),
+		snapshotsDir: posix(join(home, "snapshots")),
+		skillsDir: posix(join(home, "skills")),
+		completionsDir: posix(join(home, "completions")),
+		composerHistory: posix(join(home, "composer_history.txt")),
+		composerStash: posix(join(home, "composer_stash.jsonl")),
+		updateLock: posix(join(home, ".update.lock"))
+	};
+}
+//#endregion
+//#region src/db.ts
+/**
+* Single entry‑point for opening the Lynx SQLite database.
+*
+* Every WAL‑mode pragma is set here so that all consumers (SessionManager,
+* PluginRegistry, TaskManager) share the same connection settings without
+* repeating the configuration.
+*/
+/** Wait up to 5 seconds when a write lock is contended. */
+const BUSY_TIMEOUT_MS = 5e3;
+/** Maximum WAL file size before auto‑checkpoint (64 MiB). */
+const JOURNAL_SIZE_LIMIT_BYTES = 67108864;
+/** Page cache size in KB. Negative value = KB, so -8000 = 8 MiB. */
+const CACHE_SIZE_KB = -8e3;
+/** Memory‑mapped I/O window (256 MiB). */
+const MMAP_SIZE_BYTES = 268435456;
+/** Trigger passive checkpoint every N write operations. */
+const WAL_AUTOCHECKPOINT = 1e3;
+/**
+* Open (or create) the Lynx state database with WAL mode enabled.
+* Call this once per process in the bootstrap phase.
+*/
+function openDatabase(config) {
+	mkdirSync(dirname(config.dbPath), {
+		mode: 448,
+		recursive: true
+	});
+	const db = new Database(config.dbPath);
+	if (config.walMode !== false) db.pragma("journal_mode = WAL");
+	db.pragma("synchronous = NORMAL");
+	db.pragma("foreign_keys = ON");
+	db.pragma(`busy_timeout = ${BUSY_TIMEOUT_MS}`);
+	db.pragma(`journal_size_limit = ${JOURNAL_SIZE_LIMIT_BYTES}`);
+	db.pragma(`cache_size = ${CACHE_SIZE_KB}`);
+	db.pragma(`mmap_size = ${MMAP_SIZE_BYTES}`);
+	db.pragma(`wal_autocheckpoint = ${WAL_AUTOCHECKPOINT}`);
+	return db;
+}
+//#endregion
+//#region src/migrate.ts
+const MIGRATIONS = [
+	{
+		version: 1,
+		description: "Initial schema: sessions",
+		sql: `
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        label TEXT NOT NULL,
+        workspace TEXT NOT NULL,
+        parent_id TEXT,
+        forked_from_message_count INTEGER,
+        message_count INTEGER DEFAULT 0,
+        metadata TEXT NOT NULL DEFAULT '{}',
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        FOREIGN KEY (parent_id) REFERENCES sessions(id) ON DELETE SET NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sessions_updated_at
+        ON sessions(updated_at DESC);
+
+      CREATE INDEX IF NOT EXISTS idx_sessions_parent_id
+        ON sessions(parent_id);
+    `
+	},
+	{
+		version: 2,
+		description: "Draft auto‑save table",
+		sql: `
+      CREATE TABLE IF NOT EXISTS drafts (
+        session_id TEXT PRIMARY KEY,
+        messages_json TEXT NOT NULL,
+        updated_at INTEGER NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+    `,
+		rollback: "DROP TABLE IF EXISTS drafts;"
+	},
+	{
+		version: 3,
+		description: "Messages persistence table",
+		sql: `
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system')),
+        content_json TEXT NOT NULL,
+        turn_index INTEGER NOT NULL DEFAULT 0,
+        timestamp INTEGER NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_messages_session_id
+        ON messages(session_id);
+
+      CREATE INDEX IF NOT EXISTS idx_messages_session_turn
+        ON messages(session_id, turn_index);
+    `,
+		rollback: "DROP TABLE IF EXISTS messages;"
+	}
+];
+/** The schema version this build of Lynx expects. */
+const EXPECTED_VERSION = MIGRATIONS[MIGRATIONS.length - 1].version;
+/**
+* Apply any pending migrations to bring `db` up to EXPECTED_VERSION.
+* Safe to call on every startup — no‑op if already current.
+*/
+function migrate(db) {
+	runMigrations(db, MIGRATIONS, EXPECTED_VERSION);
+}
+/**
+* Run migrations with an explicit list and target version.
+* Exported for testability — production code should use `migrate()`.
+*/
+function runMigrations(db, migrations, expectedVersion) {
+	const currentVersion = db.pragma("user_version", { simple: true });
+	if (currentVersion > expectedVersion) throw new StorageError(`Database schema v${currentVersion} is newer than this Lynx build expects (v${expectedVersion}). Please upgrade Lynx to the latest version.`, {
+		recoverable: false,
+		retryable: false,
+		userVisible: true
+	});
+	if (currentVersion === expectedVersion) return;
+	const pending = migrations.filter((m) => m.version > currentVersion);
+	for (const migration of pending) {
+		const apply = db.transaction(() => {
+			db.exec(migration.sql);
+			db.pragma(`user_version = ${migration.version}`);
+		});
+		try {
+			apply();
+		} catch (err) {
+			if (migration.rollback) try {
+				db.exec(migration.rollback);
+			} catch {}
+			throw new StorageError(`Migration v${migration.version} (${migration.description}) failed: ${err.message}`, {
+				recoverable: false,
+				retryable: false,
+				userVisible: true,
+				diagnosticHint: "storage_migration_failed"
+			});
+		}
+	}
+}
+//#endregion
+export { AgentError, ChannelError, ConfigError, EXPECTED_VERSION, LlmAuthError, LlmContextOverflowError, LlmError, LlmRateLimitError, LynxError, MIGRATIONS, NotImplementedError, PluginError, PluginHookError, PluginLoadError, SessionError, SessionLockedError, SessionNotFoundError, StorageCorruptedError, StorageError, StorageFullError, ToolAbortedError, ToolError, ToolPermissionError, ToolTimeoutError, asMessageId, asSessionId, migrate, openDatabase, resolvePaths, toErrorEnvelope };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/types.ts","../src/errors.ts","../src/paths.ts","../src/db.ts","../src/migrate.ts"],"sourcesContent":["/**\n * Core type definitions for the Lynx agent system.\n * All other packages depend on these interfaces — keep them stable.\n */\n\n// ── Identifiers ────────────────────────────────────\n\n/** Opaque session identifier (UUID v4). */\nexport type SessionId = string & { readonly __brand: \"SessionId\" };\n\n/** Opaque message identifier (UUID v4). */\nexport type MessageId = string & { readonly __brand: \"MessageId\" };\n\n// ── Content blocks ─────────────────────────────────\n\n/**\n * Discriminated union of all content types an LLM can emit or receive.\n * The `reasoning` variant captures chain-of-thought from models like\n * DeepSeek R1 and OpenAI o1.\n */\nexport type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ReasoningBlock;\n\nexport interface TextBlock {\n  type: \"text\";\n  /** Plain text content emitted by the LLM. */\n  text: string;\n}\n\nexport interface ToolUseBlock {\n  type: \"tool_use\";\n  /** Unique ID for matching tool results back to calls. */\n  id: string;\n  /** Name of the tool being invoked. */\n  name: string;\n  /** Arguments passed to the tool. */\n  input: Record<string, unknown>;\n}\n\nexport interface ToolResultBlock {\n  type: \"tool_result\";\n  /** Matches the `id` of the corresponding `tool_use` block. */\n  toolUseId: string;\n  /** Text or structured output from the tool execution. */\n  content: string;\n  /** Set to true when the tool execution failed. */\n  isError?: boolean;\n}\n\nexport interface ReasoningBlock {\n  type: \"reasoning\";\n  /** Chain-of-thought text (e.g. DeepSeek R1, OpenAI o1). */\n  text: string;\n}\n\n// ── Messages ───────────────────────────────────────\n\nexport interface Message {\n  /** Unique identifier (UUID v4). */\n  id: MessageId;\n  /** Who sent this message — user, assistant, or system. */\n  role: \"user\" | \"assistant\" | \"system\";\n  /** Content blocks making up the message body. */\n  content: ContentBlock[];\n  /** Unix timestamp in milliseconds. */\n  timestamp: number;\n  /** Zero-based index within the session's message list. */\n  turnIndex: number;\n}\n\n// ── Sessions ───────────────────────────────────────\n\n/**\n * Flexible metadata bag attached to every session.\n * Keys are strings to allow extension without breaking DB rows.\n */\nexport interface SessionMetadata {\n  /** Whether the last session run was interrupted (crash / SIGKILL). */\n  crashed?: boolean;\n  /** Model identifier used for this session (e.g. \"deepseek-v3\"). */\n  model?: string;\n  /** Active permission mode when the session was last saved. */\n  permissionMode?: string;\n  /** Additional entries injected by plugins or migrations. */\n  [key: string]: unknown;\n}\n\nexport interface Session {\n  /** Unique session identifier (UUID v4). */\n  id: SessionId;\n  /** User-visible label shown in the session picker. */\n  label: string;\n  /** Absolute path to the workspace directory. */\n  workspace: string;\n  /** Ordered message history. */\n  messages: Message[];\n  /** The session this one was forked from, if any. */\n  parentSessionId?: SessionId;\n  /** Message count at the time of fork. */\n  forkedFromMessageCount?: number;\n  /** Unix ms — set on create. */\n  createdAt: number;\n  /** Unix ms — bumped on every mutation. */\n  updatedAt: number;\n  /** Flexible metadata bag (model, permission mode, crash state, etc.). */\n  metadata: SessionMetadata;\n}\n\n// ── Tool invocation (minimal forward-declaration) ───\n\n/**\n * Serializable record of a tool being invoked.\n * The full tool descriptor lives in @lynx/tools; core only stores\n * the invocation trace needed for session replay.\n */\nexport interface ToolCall {\n  /** Matches the `id` in `ToolUseBlock`. */\n  id: string;\n  /** Name of the tool being invoked. */\n  name: string;\n  /** Arguments supplied by the LLM. */\n  input: Record<string, unknown>;\n  /** Unix ms when the tool started executing. */\n  startedAt: number;\n  /** Unix ms when the tool finished (undefined if still running). */\n  finishedAt?: number;\n}\n\nexport interface ToolResult {\n  /** Matches `ToolCall.id`. */\n  toolCallId: string;\n  /** Text or structured output from the tool. */\n  output: string;\n  /** Whether the tool execution ended in an error. */\n  isError: boolean;\n  /** Unix ms when execution completed. */\n  finishedAt: number;\n}\n\n// ── Convenience helpers ────────────────────────────\n\n/** Create a new SessionId from a UUID string. */\nexport function asSessionId(id: string): SessionId {\n  return id as SessionId;\n}\n\n/** Create a new MessageId from a UUID string. */\nexport function asMessageId(id: string): MessageId {\n  return id as MessageId;\n}\n","/* oxlint-disable max-classes-per-file — error taxonomy by design */\n/**\n * Layered error system for Lynx.\n *\n * Layer 1 — LynxError subclasses: typed, machine‑actionable errors\n *   each carries recoverable / retryable / userVisible / diagnosticHint.\n * Layer 2 — ErrorEnvelope: cross‑boundary wrapper with category + severity.\n * Layer 3 — Top‑level catch in lynx‑cli/entry.ts formats and routes.\n */\n\n// ── Error categories ───────────────────────────────\n\n/**\n * Which subsystem raised the error.\n * Used by error reporters and /doctor to route diagnostics.\n */\nexport type ErrorCategory =\n  | \"tool\"\n  | \"llm\"\n  | \"session\"\n  | \"plugin\"\n  | \"channel\"\n  | \"config\"\n  | \"storage\";\n\n/**\n * Severity level for log routing and user notification.\n * \"debug\"/\"info\" are suppressed in production; \"fatal\" triggers process exit.\n */\nexport type ErrorSeverity = \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\n// ── Layer 1: LynxError base ────────────────────────\n\n/** Configuration for constructing a LynxError. */\nexport interface LynxErrorOptions {\n  /** Which subsystem raised this error. */\n  category: ErrorCategory;\n  /** Whether the system can recover without user intervention. */\n  recoverable?: boolean;\n  /** Whether retrying the same operation might succeed. */\n  retryable?: boolean;\n  /** Whether the message should be shown to the user. */\n  userVisible?: boolean;\n  /** Pointer to a /doctor check (e.g. \"storage_migration_failed\"). */\n  diagnosticHint?: string;\n}\n\nexport class LynxError extends Error {\n  /** Which subsystem raised this error. */\n  readonly category: ErrorCategory;\n  /** Whether the system can recover without user intervention. */\n  readonly recoverable: boolean;\n  /** Whether retrying the same operation might succeed. */\n  readonly retryable: boolean;\n  /** Whether the message should be shown to the user. */\n  readonly userVisible: boolean;\n  /** Pointer to a /doctor check (e.g. \"storage_migration_failed\"). */\n  readonly diagnosticHint: string | undefined;\n\n  constructor(message: string, opts: LynxErrorOptions) {\n    super(message);\n    this.name = \"LynxError\";\n    this.category = opts.category;\n    this.recoverable = opts.recoverable ?? false;\n    this.retryable = opts.retryable ?? false;\n    this.userVisible = opts.userVisible ?? true;\n    this.diagnosticHint = opts.diagnosticHint;\n  }\n}\n\n// ── Layer 1: Subclasses ────────────────────────────\n\nexport class ToolError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"tool\", recoverable: false, retryable: false, ...opts });\n    this.name = \"ToolError\";\n  }\n}\n\nexport class ToolTimeoutError extends ToolError {\n  constructor(message = \"Tool execution timed out (60s)\") {\n    super(message, { userVisible: false, diagnosticHint: \"tool_timeout\" });\n    this.name = \"ToolTimeoutError\";\n  }\n}\n\nexport class ToolAbortedError extends ToolError {\n  constructor(message = \"Tool execution was cancelled\") {\n    super(message, { userVisible: true });\n    this.name = \"ToolAbortedError\";\n  }\n}\n\nexport class ToolPermissionError extends ToolError {\n  constructor(message = \"Permission denied for tool execution\") {\n    super(message, { userVisible: true });\n    this.name = \"ToolPermissionError\";\n  }\n}\n\nexport class LlmError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"llm\", recoverable: true, retryable: true, ...opts });\n    this.name = \"LlmError\";\n  }\n}\n\nexport class LlmRateLimitError extends LlmError {\n  /** HTTP status code (429 for rate limit, 529 for overload). */\n  status: number;\n\n  constructor(message = \"LLM rate limited (429 / 529)\", status = 429) {\n    super(message, { diagnosticHint: \"llm_rate_limit\" });\n    this.name = \"LlmRateLimitError\";\n    this.status = status;\n  }\n}\n\nexport class LlmAuthError extends LlmError {\n  constructor(message = \"LLM authentication failed (401 / 403)\") {\n    super(message, { recoverable: true, retryable: false, diagnosticHint: \"llm_auth\" });\n    this.name = \"LlmAuthError\";\n  }\n}\n\nexport class LlmContextOverflowError extends LlmError {\n  constructor(message = \"Prompt exceeds model context window\") {\n    super(message, { recoverable: true, retryable: true, diagnosticHint: \"llm_context_overflow\" });\n    this.name = \"LlmContextOverflowError\";\n  }\n}\n\nexport class SessionError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"session\", recoverable: false, retryable: false, ...opts });\n    this.name = \"SessionError\";\n  }\n}\n\nexport class SessionNotFoundError extends SessionError {\n  constructor(sessionId: string) {\n    super(`Session not found: ${sessionId}`, { userVisible: true });\n    this.name = \"SessionNotFoundError\";\n  }\n}\n\nexport class SessionLockedError extends SessionError {\n  constructor(sessionId: string) {\n    super(`Session locked (concurrent write): ${sessionId}`, {\n      recoverable: true,\n      retryable: true,\n    });\n    this.name = \"SessionLockedError\";\n  }\n}\n\nexport class AgentError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"llm\", recoverable: true, retryable: false, ...opts });\n    this.name = \"AgentError\";\n  }\n}\n\nexport class PluginError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"plugin\", recoverable: true, retryable: false, ...opts });\n    this.name = \"PluginError\";\n  }\n}\n\nexport class PluginLoadError extends PluginError {\n  constructor(pluginName: string, cause?: unknown) {\n    super(`Plugin \"${pluginName}\" failed to load: ${String(cause)}`, { userVisible: true });\n    this.name = \"PluginLoadError\";\n  }\n}\n\nexport class PluginHookError extends PluginError {\n  constructor(hookName: string, cause?: unknown) {\n    super(`Hook \"${hookName}\" threw: ${String(cause)}`, { userVisible: false });\n    this.name = \"PluginHookError\";\n  }\n}\n\nexport class ChannelError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"channel\", recoverable: true, retryable: true, ...opts });\n    this.name = \"ChannelError\";\n  }\n}\n\nexport class ConfigError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"config\", recoverable: false, retryable: false, ...opts });\n    this.name = \"ConfigError\";\n  }\n}\n\nexport class StorageError extends LynxError {\n  constructor(message: string, opts?: Partial<LynxErrorOptions>) {\n    super(message, { category: \"storage\", recoverable: false, retryable: false, ...opts });\n    this.name = \"StorageError\";\n  }\n}\n\nexport class StorageCorruptedError extends StorageError {\n  constructor(message = \"Database file is corrupted\") {\n    super(message, { diagnosticHint: \"storage_corrupted\" });\n    this.name = \"StorageCorruptedError\";\n  }\n}\n\nexport class StorageFullError extends StorageError {\n  constructor(message = \"Disk full — cannot write to storage\") {\n    super(message, { userVisible: true, diagnosticHint: \"storage_full\" });\n    this.name = \"StorageFullError\";\n  }\n}\n\n// ── Layer 2: ErrorEnvelope ─────────────────────────\n\nexport interface ErrorEnvelope {\n  category: ErrorCategory;\n  severity: ErrorSeverity;\n  recoverable: boolean;\n  retryable: boolean;\n  /** Machine‑readable error code, e.g. \"LLM_RATE_LIMIT\". */\n  code: string;\n  /** Human‑readable message. */\n  message: string;\n  /** Chained cause, if this error wraps another. */\n  cause?: ErrorEnvelope;\n  /** Opaque trace id for correlating logs with user reports. */\n  traceId?: string;\n  /** Current operation span (agent_loop / tool_exec / model_call). */\n  spanId?: string;\n  /** Session this error occurred in, if applicable. */\n  sessionId?: string;\n  /** Unix ms when the error was captured. */\n  wallTime?: number;\n}\n\n/** Lift any Error into a safe ErrorEnvelope for cross‑boundary transport. */\nexport function toErrorEnvelope(err: unknown, overrides?: Partial<ErrorEnvelope>): ErrorEnvelope {\n  if (err instanceof LynxError) {\n    return {\n      category: err.category,\n      severity: \"error\",\n      recoverable: err.recoverable,\n      retryable: err.retryable,\n      code: err.name.toUpperCase(),\n      message: err.message,\n      wallTime: Date.now(),\n      ...overrides,\n    };\n  }\n\n  if (err instanceof Error) {\n    return {\n      category: \"storage\",\n      severity: \"error\",\n      recoverable: false,\n      retryable: false,\n      code: \"UNKNOWN\",\n      message: err.message,\n      wallTime: Date.now(),\n      ...overrides,\n    };\n  }\n\n  return {\n    category: \"storage\",\n    severity: \"fatal\",\n    recoverable: false,\n    retryable: false,\n    code: \"UNKNOWN\",\n    message: String(err),\n    wallTime: Date.now(),\n    ...overrides,\n  };\n}\n\n// ── Development‑only marker ────────────────────────\n\n/**\n * Throw this when a function body is intentionally not implemented yet.\n * CI detects remaining `NotImplementedError` throws and fails the Phase gate.\n */\nexport class NotImplementedError extends Error {\n  constructor(feature: string) {\n    super(`Not implemented: ${feature}`);\n    this.name = \"NotImplementedError\";\n  }\n}\n","/**\n * Centralised path resolution for all Lynx data directories.\n *\n * Default root is `~/.lynx` (or `%USERPROFILE%/.lynx` on Windows).\n * Every sub‑directory can be overridden individually via environment variables\n * so that state, logs, config, and skills can live on separate volumes.\n */\n\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n// ── Helpers ────────────────────────────────────────\n\n/**\n * Normalise path separators to forward slashes.\n * Node.js on Windows accepts both `C:\\Users` and `C:/Users`,\n * but we want consistent POSIX‑style paths across the codebase.\n */\nfunction posix(p: string): string {\n  return p.replace(/\\\\/g, \"/\");\n}\n\n/** Default data root. */\nconst DEFAULT_HOME = posix(join(homedir(), \".lynx\"));\n\n// ── Public API ──────────────────────────────────────\n\nexport interface LynxPaths {\n  /** Root data directory (~/.lynx or $LYNX_HOME). */\n  home: string;\n  /** Main JSON configuration file. */\n  configFile: string;\n  /** User preference file (theme, keybinds). */\n  settingsFile: string;\n  /** TUI‑specific preferences (survive across projects). */\n  tuiFile: string;\n  /** SQLite state database path. */\n  stateDb: string;\n  /** Directory holding per‑session JSON files. */\n  sessionsDir: string;\n  /** Log output directory. */\n  logDir: string;\n  /** Security audit log (JSONL). */\n  auditLog: string;\n  /** Capacity memory records. */\n  memoryDir: string;\n  /** Workspace snapshots (git side‑repo). */\n  snapshotsDir: string;\n  /** User‑level skills. */\n  skillsDir: string;\n  /** Shell completion cache. */\n  completionsDir: string;\n  /** Input history file. */\n  composerHistory: string;\n  /** Ctrl+S stash file. */\n  composerStash: string;\n  /** Update concurrency lock file. */\n  updateLock: string;\n}\n\n/**\n * Resolve every data path from environment variables.\n * Called once at startup; result is immutable for the lifetime of the process.\n */\nexport function resolvePaths(env: NodeJS.ProcessEnv = process.env): LynxPaths {\n  const home = env.LYNX_HOME ?? DEFAULT_HOME;\n  const stateDir = env.LYNX_STATE_DIR ?? posix(join(home, \"sessions\"));\n  const logDir = env.LYNX_LOG_DIR ?? posix(join(home, \"logs\"));\n\n  return {\n    home,\n    configFile: env.LYNX_CONFIG_PATH ?? posix(join(home, \"config.json\")),\n    settingsFile: posix(join(home, \"settings.json\")),\n    tuiFile: posix(join(home, \"tui.json\")),\n    stateDb: posix(join(home, \"state.db\")),\n    sessionsDir: stateDir,\n    logDir,\n    auditLog: posix(join(home, \"audit.log\")),\n    memoryDir: posix(join(home, \"memory\")),\n    snapshotsDir: posix(join(home, \"snapshots\")),\n    skillsDir: posix(join(home, \"skills\")),\n    completionsDir: posix(join(home, \"completions\")),\n    composerHistory: posix(join(home, \"composer_history.txt\")),\n    composerStash: posix(join(home, \"composer_stash.jsonl\")),\n    updateLock: posix(join(home, \".update.lock\")),\n  };\n}\n","/**\n * Single entry‑point for opening the Lynx SQLite database.\n *\n * Every WAL‑mode pragma is set here so that all consumers (SessionManager,\n * PluginRegistry, TaskManager) share the same connection settings without\n * repeating the configuration.\n */\n\nimport Database from \"better-sqlite3\";\nimport { mkdirSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\n// ── Constants ──────────────────────────────────────\n\n/** Wait up to 5 seconds when a write lock is contended. */\nconst BUSY_TIMEOUT_MS = 5_000;\n\n/** Maximum WAL file size before auto‑checkpoint (64 MiB). */\nconst JOURNAL_SIZE_LIMIT_BYTES = 67_108_864;\n\n/** Page cache size in KB. Negative value = KB, so -8000 = 8 MiB. */\nconst CACHE_SIZE_KB = -8_000;\n\n/** Memory‑mapped I/O window (256 MiB). */\nconst MMAP_SIZE_BYTES = 268_435_456;\n\n/** Trigger passive checkpoint every N write operations. */\nconst WAL_AUTOCHECKPOINT = 1000;\n\n// ── Configuration ──────────────────────────────────\n\nexport interface DbConfig {\n  /** Absolute path to the .db file. */\n  dbPath: string;\n  /** If true (default), journal_mode = WAL. */\n  walMode?: boolean;\n}\n\n// ── Public API ─────────────────────────────────────\n\n/**\n * Open (or create) the Lynx state database with WAL mode enabled.\n * Call this once per process in the bootstrap phase.\n */\nexport function openDatabase(config: DbConfig): Database.Database {\n  // Ensure parent directory exists with restricted permissions\n  const dir = dirname(config.dbPath);\n  mkdirSync(dir, { mode: 0o700, recursive: true });\n\n  const db = new Database(config.dbPath);\n\n  // Enable WAL by default — critical for concurrent read/write workloads\n  // (e.g. draft auto‑save doesn't block the TUI session list)\n  if (config.walMode !== false) {\n    db.pragma(\"journal_mode = WAL\");\n  }\n\n  db.pragma(\"synchronous = NORMAL\");\n  db.pragma(\"foreign_keys = ON\");\n  db.pragma(`busy_timeout = ${BUSY_TIMEOUT_MS}`);\n  db.pragma(`journal_size_limit = ${JOURNAL_SIZE_LIMIT_BYTES}`);\n  db.pragma(`cache_size = ${CACHE_SIZE_KB}`);\n  db.pragma(`mmap_size = ${MMAP_SIZE_BYTES}`);\n  db.pragma(`wal_autocheckpoint = ${WAL_AUTOCHECKPOINT}`);\n\n  return db;\n}\n","/**\n * Forward‑only schema migration system for Lynx's SQLite database.\n *\n * Each migration runs inside its own transaction. The `user_version` pragma\n * tracks which version the database is at. If the on‑disk version is newer\n * than the code expects, we throw — the user must upgrade Lynx.\n */\n\nimport type Database from \"better-sqlite3\";\nimport { StorageError } from \"./errors.js\";\n\n// ── Types ──────────────────────────────────────────\n\nexport interface Migration {\n  /** Monotonically‑increasing schema version. */\n  version: number;\n  /** Human‑readable summary of what this migration does. */\n  description: string;\n  /** SQL statements executed inside a transaction. */\n  sql: string;\n  /** Optional rollback SQL. If omitted, a failed migration leaves the DB dirty. */\n  rollback?: string;\n}\n\n// ── Migration registry ─────────────────────────────\n\nexport const MIGRATIONS: Migration[] = [\n  {\n    version: 1,\n    description: \"Initial schema: sessions\",\n    sql: `\n      CREATE TABLE IF NOT EXISTS sessions (\n        id TEXT PRIMARY KEY,\n        label TEXT NOT NULL,\n        workspace TEXT NOT NULL,\n        parent_id TEXT,\n        forked_from_message_count INTEGER,\n        message_count INTEGER DEFAULT 0,\n        metadata TEXT NOT NULL DEFAULT '{}',\n        created_at INTEGER NOT NULL,\n        updated_at INTEGER NOT NULL,\n        FOREIGN KEY (parent_id) REFERENCES sessions(id) ON DELETE SET NULL\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_sessions_updated_at\n        ON sessions(updated_at DESC);\n\n      CREATE INDEX IF NOT EXISTS idx_sessions_parent_id\n        ON sessions(parent_id);\n    `,\n  },\n  {\n    version: 2,\n    description: \"Draft auto‑save table\",\n    sql: `\n      CREATE TABLE IF NOT EXISTS drafts (\n        session_id TEXT PRIMARY KEY,\n        messages_json TEXT NOT NULL,\n        updated_at INTEGER NOT NULL,\n        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n      );\n    `,\n    rollback: \"DROP TABLE IF EXISTS drafts;\",\n  },\n  {\n    version: 3,\n    description: \"Messages persistence table\",\n    sql: `\n      CREATE TABLE IF NOT EXISTS messages (\n        id TEXT PRIMARY KEY,\n        session_id TEXT NOT NULL,\n        role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system')),\n        content_json TEXT NOT NULL,\n        turn_index INTEGER NOT NULL DEFAULT 0,\n        timestamp INTEGER NOT NULL,\n        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_messages_session_id\n        ON messages(session_id);\n\n      CREATE INDEX IF NOT EXISTS idx_messages_session_turn\n        ON messages(session_id, turn_index);\n    `,\n    rollback: \"DROP TABLE IF EXISTS messages;\",\n  },\n];\n\n/** The schema version this build of Lynx expects. */\nexport const EXPECTED_VERSION: number = MIGRATIONS[MIGRATIONS.length - 1].version;\n\n// ── Migration runner ───────────────────────────────\n\n/**\n * Apply any pending migrations to bring `db` up to EXPECTED_VERSION.\n * Safe to call on every startup — no‑op if already current.\n */\nexport function migrate(db: Database.Database): void {\n  runMigrations(db, MIGRATIONS, EXPECTED_VERSION);\n}\n\n/**\n * Run migrations with an explicit list and target version.\n * Exported for testability — production code should use `migrate()`.\n */\nexport function runMigrations(\n  db: Database.Database,\n  migrations: Migration[],\n  expectedVersion: number,\n): void {\n  const currentVersion = db.pragma(\"user_version\", { simple: true }) as number;\n\n  if (currentVersion > expectedVersion) {\n    throw new StorageError(\n      `Database schema v${currentVersion} is newer than this Lynx build expects (v${expectedVersion}). ` +\n        \"Please upgrade Lynx to the latest version.\",\n      { recoverable: false, retryable: false, userVisible: true },\n    );\n  }\n\n  if (currentVersion === expectedVersion) {\n    return;\n  }\n\n  const pending = migrations.filter((m) => m.version > currentVersion);\n\n  for (const migration of pending) {\n    const apply = db.transaction(() => {\n      db.exec(migration.sql);\n      db.pragma(`user_version = ${migration.version}`);\n    });\n\n    try {\n      apply();\n    } catch (err) {\n      // Best‑effort rollback\n      if (migration.rollback) {\n        try {\n          db.exec(migration.rollback);\n        } catch {\n          // Rollback itself failed — DB may be in an inconsistent state.\n          // The user should restore from the pre‑migration backup.\n        }\n      }\n      throw new StorageError(\n        `Migration v${migration.version} (${migration.description}) failed: ${(err as Error).message}`,\n        {\n          recoverable: false,\n          retryable: false,\n          userVisible: true,\n          diagnosticHint: \"storage_migration_failed\",\n        },\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@24klynx/core",
+  "version": "0.1.0",
+  "description": "Shared types and error infrastructure — zero dependencies",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.10.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.9.1"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader tsx",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsgo --noEmit"
+  }
+}