@xopcai/xopc 0.0.95 → 0.0.96

package/dist/src/storage/sqlite/row-mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-mappers.js","names":["msg"],"sources":["../../../../src/storage/sqlite/row-mappers.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { SessionAgentConfig } from '../../session/config-types.js';\nimport {\n  isTranscriptContextEntry,\n  type TranscriptStoredRow,\n  type XopcTranscriptContextEntry,\n} from '../../session/session-context-for-llm.js';\nimport { SessionStatus, type GlobalSessionStats, type SessionMetadata } from '../../session/types.js';\nimport {\n  buildDefaultSessionMetadata,\n  parseSessionKeySource,\n  resolveAgentIdFromSessionKey,\n} from './session-metadata.js';\n\nexport type SessionRow = {\n  session_key: string;\n  agent_id: string;\n  current_transcript_id: string;\n  status: string;\n  name: string | null;\n  tags_json: string;\n  created_at: number;\n  updated_at: number;\n  last_accessed_at: number;\n  session_started_at: number | null;\n  last_interaction_at: number | null;\n  source_channel: string;\n  source_chat_id: string;\n  session_type: string | null;\n  routing_json: string | null;\n  custom_data_json: string | null;\n  abort_cutoff_timestamp: number | null;\n  message_count: number;\n  estimated_tokens: number;\n  compacted_count: number;\n  thinking_level: string | null;\n  verbose_level: string | null;\n};\n\nexport type TranscriptEntryRow = {\n  entry_id: string;\n  transcript_id: string;\n  seq: number;\n  entry_kind: string;\n  role: string | null;\n  payload_json: string;\n  created_at: number;\n};\n\nexport type SessionConfigRow = {\n  session_key: string;\n  thinking_level: string | null;\n  reasoning_level: string | null;\n  verbose_level: string | null;\n  elevated_mode: string | null;\n  model_override: string | null;\n  provider_override: string | null;\n  working_directory_override: string | null;\n  updated_at: number;\n};\n\nfunction parseJson<T>(raw: string | null | undefined): T | undefined {\n  if (!raw?.trim()) {\n    return undefined;\n  }\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isoFromMs(ms: number | null | undefined): string | undefined {\n  if (ms == null || !Number.isFinite(ms)) {\n    return undefined;\n  }\n  return new Date(ms).toISOString();\n}\n\nexport function sessionRowToMetadata(sessionKey: string, row: SessionRow): SessionMetadata {\n  const defaults = buildDefaultSessionMetadata(sessionKey);\n  const { channel: keySource, chatId: keyChatId } = parseSessionKeySource(sessionKey);\n  const routing = parseJson<SessionMetadata['routing']>(row.routing_json) ?? defaults.routing;\n  const customData = parseJson<Record<string, unknown>>(row.custom_data_json) ?? defaults.customData;\n  const tags = parseJson<string[]>(row.tags_json) ?? [];\n  const createdAt = isoFromMs(row.created_at) ?? defaults.createdAt;\n  const updatedAt = isoFromMs(row.updated_at) ?? defaults.updatedAt;\n  const lastAccessedAt = isoFromMs(row.last_accessed_at) ?? defaults.lastAccessedAt;\n  const diskSc = row.source_channel?.trim() ?? '';\n  const diskChat = row.source_chat_id?.trim() ?? '';\n\n  return {\n    ...defaults,\n    key: sessionKey,\n    status: row.status as SessionStatus,\n    name: row.name ?? undefined,\n    tags,\n    createdAt,\n    updatedAt,\n    lastAccessedAt,\n    sessionStartedAt: isoFromMs(row.session_started_at),\n    lastInteractionAt: isoFromMs(row.last_interaction_at),\n    sourceChannel: diskSc || keySource,\n    sourceChatId: diskChat || keyChatId,\n    sessionType: row.session_type ?? defaults.sessionType,\n    routing,\n    customData,\n    abortCutoffTimestamp: row.abort_cutoff_timestamp ?? undefined,\n    messageCount: row.message_count,\n    estimatedTokens: row.estimated_tokens,\n    compactedCount: row.compacted_count,\n    transcriptId: row.current_transcript_id,\n    stats: {\n      messageCount: row.message_count,\n      tokenCount: row.estimated_tokens,\n      lastTurnAt: row.last_interaction_at ?? undefined,\n    },\n  };\n}\n\nexport function metadataToSessionInsert(\n  sessionKey: string,\n  transcriptId: string,\n  metadata: SessionMetadata,\n  thinkingLevel?: string | null,\n  verboseLevel?: string | null,\n): {\n  sessionKey: string;\n  agentId: string;\n  transcriptId: string;\n  status: string;\n  name: string | null;\n  tagsJson: string;\n  createdAt: number;\n  updatedAt: number;\n  lastAccessedAt: number;\n  sessionStartedAt: number | null;\n  lastInteractionAt: number | null;\n  sourceChannel: string;\n  sourceChatId: string;\n  sessionType: string | null;\n  routingJson: string | null;\n  customDataJson: string | null;\n  abortCutoffTimestamp: number | null;\n  messageCount: number;\n  estimatedTokens: number;\n  compactedCount: number;\n  thinkingLevel: string | null;\n  verboseLevel: string | null;\n} {\n  const now = Date.now();\n  return {\n    sessionKey,\n    agentId: resolveAgentIdFromSessionKey(sessionKey),\n    transcriptId,\n    status: metadata.status,\n    name: metadata.name ?? null,\n    tagsJson: JSON.stringify(metadata.tags ?? []),\n    createdAt: Date.parse(metadata.createdAt) || now,\n    updatedAt: Date.parse(metadata.updatedAt) || now,\n    lastAccessedAt: Date.parse(metadata.lastAccessedAt) || now,\n    sessionStartedAt: metadata.sessionStartedAt ? Date.parse(metadata.sessionStartedAt) : now,\n    lastInteractionAt: metadata.lastInteractionAt ? Date.parse(metadata.lastInteractionAt) : null,\n    sourceChannel: metadata.sourceChannel,\n    sourceChatId: metadata.sourceChatId,\n    sessionType: metadata.sessionType ?? null,\n    routingJson: metadata.routing ? JSON.stringify(metadata.routing) : null,\n    customDataJson: metadata.customData ? JSON.stringify(metadata.customData) : null,\n    abortCutoffTimestamp: metadata.abortCutoffTimestamp ?? null,\n    messageCount: metadata.messageCount,\n    estimatedTokens: metadata.estimatedTokens,\n    compactedCount: metadata.compactedCount,\n    thinkingLevel: thinkingLevel ?? null,\n    verboseLevel: verboseLevel ?? null,\n  };\n}\n\nexport function sessionConfigRowToConfig(row: SessionConfigRow): SessionAgentConfig {\n  return {\n    ...(row.thinking_level ? { thinkingLevel: row.thinking_level as SessionAgentConfig['thinkingLevel'] } : {}),\n    ...(row.reasoning_level ? { reasoningLevel: row.reasoning_level as SessionAgentConfig['reasoningLevel'] } : {}),\n    ...(row.verbose_level ? { verboseLevel: row.verbose_level as SessionAgentConfig['verboseLevel'] } : {}),\n    ...(row.elevated_mode ? { elevatedMode: row.elevated_mode as SessionAgentConfig['elevatedMode'] } : {}),\n    ...(row.model_override ? { modelOverride: row.model_override } : {}),\n    ...(row.provider_override ? { providerOverride: row.provider_override } : {}),\n    ...(row.working_directory_override ? { workingDirectoryOverride: row.working_directory_override } : {}),\n    updatedAt: row.updated_at,\n  };\n}\n\nexport function transcriptEntryRowToStoredRow(row: TranscriptEntryRow): TranscriptStoredRow {\n  const payload = JSON.parse(row.payload_json) as TranscriptStoredRow;\n  return payload;\n}\n\nexport function classifyStoredRow(row: TranscriptStoredRow): {\n  entryKind: 'message' | 'context' | 'compaction';\n  role: string | null;\n} {\n  if (isTranscriptContextEntry(row)) {\n    return { entryKind: 'context', role: null };\n  }\n  const record = row as AgentMessage & { type?: string };\n  if (record.type === 'compaction' || (row as { kind?: string }).kind === 'compaction') {\n    return { entryKind: 'compaction', role: null };\n  }\n  return { entryKind: 'message', role: record.role ?? null };\n}\n\nexport function extractFtsContent(row: TranscriptStoredRow): string {\n  if (isTranscriptContextEntry(row)) {\n    const ctx = row as XopcTranscriptContextEntry;\n    return [ctx.text, ctx.id].filter(Boolean).join(' ');\n  }\n  const msg = row as AgentMessage;\n  return extractTextFromMessageContent((msg as { content?: unknown }).content);\n}\n\nfunction extractTextFromMessageContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const block of content) {\n    if (!block || typeof block !== 'object') {\n      continue;\n    }\n    const type = (block as { type?: string }).type;\n    if (type === 'text' && typeof (block as { text?: string }).text === 'string') {\n      parts.push((block as { text: string }).text);\n    }\n  }\n  return parts.join('\\n');\n}\n\nexport function estimateTokensFromMessages(messages: AgentMessage[]): number {\n  let total = 0;\n  for (const msg of messages) {\n    const content = (msg as { content?: unknown }).content;\n    const text = extractTextFromMessageContent(content);\n    total += Math.ceil(text.length / 4);\n  }\n  return total;\n}\n\nexport function buildGlobalSessionStats(sessions: SessionMetadata[]): GlobalSessionStats {\n  const byChannel: Record<string, number> = {};\n  for (const session of sessions) {\n    byChannel[session.sourceChannel] = (byChannel[session.sourceChannel] || 0) + 1;\n  }\n  let oldestSession: string | undefined;\n  let newestSession: string | undefined;\n  if (sessions.length > 0) {\n    const sorted = [...sessions].sort((a, b) => a.createdAt.localeCompare(b.createdAt));\n    oldestSession = sorted[0]!.createdAt;\n    newestSession = sorted[sorted.length - 1]!.createdAt;\n  }\n  return {\n    totalSessions: sessions.length,\n    activeSessions: sessions.filter(\n      (s) => s.status === SessionStatus.ACTIVE || s.status === SessionStatus.IDLE,\n    ).length,\n    archivedSessions: sessions.filter((s) => s.status === SessionStatus.ARCHIVED).length,\n    pinnedSessions: sessions.filter((s) => s.status === SessionStatus.PINNED).length,\n    totalMessages: sessions.reduce((sum, s) => sum + s.messageCount, 0),\n    totalTokens: sessions.reduce((sum, s) => sum + s.estimatedTokens, 0),\n    oldestSession,\n    newestSession,\n    byChannel,\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare const XOPC_DB_SCHEMA_VERSION = 1;
+export declare const SCHEMA_META_SCHEMA_VERSION_KEY = "schema_version";
+export declare function ensureXopcDatabaseSchema(db: DatabaseSync): void;
+export declare function readSchemaVersionForTest(db: DatabaseSync): number;

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

@@ -0,0 +1,43 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/storage/sqlite/schema.ts
+const XOPC_DB_SCHEMA_VERSION = 1;
+const SCHEMA_META_SCHEMA_VERSION_KEY = "schema_version";
+const SCHEMA_DIR = dirname(fileURLToPath(import.meta.url));
+function readSchemaSql() {
+	return readFileSync(join(SCHEMA_DIR, "schema.sql"), "utf8");
+}
+function ensureXopcDatabaseSchema(db) {
+	db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_meta (
+      key   TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+  `);
+	const currentVersion = readSchemaVersion(db);
+	if (currentVersion === 0) {
+		db.exec(readSchemaSql());
+		setSchemaVersion(db, 1);
+		return;
+	}
+	if (currentVersion !== 1) throw new Error(`Unsupported xopc database schema version ${currentVersion} (expected 1)`);
+}
+function readSchemaVersion(db) {
+	const row = db.prepare(`SELECT value FROM schema_meta WHERE key = ?`).get(SCHEMA_META_SCHEMA_VERSION_KEY);
+	if (!row?.value) return 0;
+	const parsed = Number.parseInt(row.value, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+function setSchemaVersion(db, version) {
+	db.prepare(`INSERT INTO schema_meta (key, value) VALUES (?, ?)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(SCHEMA_META_SCHEMA_VERSION_KEY, String(version));
+}
+function readSchemaVersionForTest(db) {
+	if (db.prepare(`PRAGMA table_info(schema_meta)`).all().length === 0) return 0;
+	return readSchemaVersion(db);
+}
+//#endregion
+export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_SCHEMA_VERSION, ensureXopcDatabaseSchema, readSchemaVersionForTest };
+
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../../src/storage/sqlite/schema.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nexport const XOPC_DB_SCHEMA_VERSION = 1;\n\nexport const SCHEMA_META_SCHEMA_VERSION_KEY = 'schema_version';\n\ntype TableInfoRow = {\n  name: string;\n};\n\nconst SCHEMA_DIR = dirname(fileURLToPath(import.meta.url));\n\nfunction readSchemaSql(): string {\n  return readFileSync(join(SCHEMA_DIR, 'schema.sql'), 'utf8');\n}\n\nexport function ensureXopcDatabaseSchema(db: DatabaseSync): void {\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS schema_meta (\n      key   TEXT PRIMARY KEY,\n      value TEXT NOT NULL\n    );\n  `);\n\n  const currentVersion = readSchemaVersion(db);\n  if (currentVersion === 0) {\n    db.exec(readSchemaSql());\n    setSchemaVersion(db, XOPC_DB_SCHEMA_VERSION);\n    return;\n  }\n\n  if (currentVersion !== XOPC_DB_SCHEMA_VERSION) {\n    throw new Error(\n      `Unsupported xopc database schema version ${currentVersion} (expected ${XOPC_DB_SCHEMA_VERSION})`,\n    );\n  }\n}\n\nfunction readSchemaVersion(db: DatabaseSync): number {\n  const row = db\n    .prepare(`SELECT value FROM schema_meta WHERE key = ?`)\n    .get(SCHEMA_META_SCHEMA_VERSION_KEY) as { value?: string } | undefined;\n  if (!row?.value) {\n    return 0;\n  }\n  const parsed = Number.parseInt(row.value, 10);\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;\n}\n\nfunction setSchemaVersion(db: DatabaseSync, version: number): void {\n  db.prepare(\n    `INSERT INTO schema_meta (key, value) VALUES (?, ?)\n     ON CONFLICT(key) DO UPDATE SET value = excluded.value`,\n  ).run(SCHEMA_META_SCHEMA_VERSION_KEY, String(version));\n}\n\nexport function readSchemaVersionForTest(db: DatabaseSync): number {\n  const rows = db.prepare(`PRAGMA table_info(schema_meta)`).all() as TableInfoRow[];\n  if (rows.length === 0) {\n    return 0;\n  }\n  return readSchemaVersion(db);\n}\n"],"mappings":";;;;AAMA,MAAa,yBAAyB;AAEtC,MAAa,iCAAiC;AAM9C,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAS,gBAAwB;AAC/B,QAAO,aAAa,KAAK,YAAY,aAAa,EAAE,OAAO;;AAG7D,SAAgB,yBAAyB,IAAwB;AAC/D,IAAG,KAAK;;;;;IAKN;CAEF,MAAM,iBAAiB,kBAAkB,GAAG;AAC5C,KAAI,mBAAmB,GAAG;AACxB,KAAG,KAAK,eAAe,CAAC;AACxB,mBAAiB,IAAA,EAA2B;AAC5C;;AAGF,KAAI,mBAAA,EACF,OAAM,IAAI,MACR,4CAA4C,eAAe,eAC5D;;AAIL,SAAS,kBAAkB,IAA0B;CACnD,MAAM,MAAM,GACT,QAAQ,8CAA8C,CACtD,IAAI,+BAA+B;AACtC,KAAI,CAAC,KAAK,MACR,QAAO;CAET,MAAM,SAAS,OAAO,SAAS,IAAI,OAAO,GAAG;AAC7C,QAAO,OAAO,UAAU,OAAO,IAAI,SAAS,IAAI,SAAS;;AAG3D,SAAS,iBAAiB,IAAkB,SAAuB;AACjE,IAAG,QACD;4DAED,CAAC,IAAI,gCAAgC,OAAO,QAAQ,CAAC;;AAGxD,SAAgB,yBAAyB,IAA0B;AAEjE,KADa,GAAG,QAAQ,iCAAiC,CAAC,KAClD,CAAC,WAAW,EAClB,QAAO;AAET,QAAO,kBAAkB,GAAG"}

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

@@ -0,0 +1,195 @@
+-- xopc SQLite schema: sessions, transcripts, cron, notes, memory, FTS
+
+CREATE TABLE IF NOT EXISTS sessions (
+  session_key              TEXT PRIMARY KEY,
+  agent_id                 TEXT NOT NULL,
+  current_transcript_id    TEXT NOT NULL UNIQUE,
+  status                   TEXT NOT NULL DEFAULT 'active',
+  name                     TEXT,
+  tags_json                TEXT NOT NULL DEFAULT '[]',
+  created_at               INTEGER NOT NULL,
+  updated_at               INTEGER NOT NULL,
+  last_accessed_at         INTEGER NOT NULL,
+  session_started_at       INTEGER,
+  last_interaction_at      INTEGER,
+  source_channel           TEXT NOT NULL DEFAULT '',
+  source_chat_id           TEXT NOT NULL DEFAULT '',
+  session_type             TEXT,
+  routing_json             TEXT,
+  custom_data_json         TEXT,
+  abort_cutoff_timestamp   INTEGER,
+  message_count            INTEGER NOT NULL DEFAULT 0,
+  estimated_tokens         INTEGER NOT NULL DEFAULT 0,
+  compacted_count          INTEGER NOT NULL DEFAULT 0,
+  thinking_level           TEXT,
+  verbose_level            TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_agent_updated
+  ON sessions(agent_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_sessions_status
+  ON sessions(status);
+CREATE INDEX IF NOT EXISTS idx_sessions_source_channel
+  ON sessions(source_channel);
+CREATE INDEX IF NOT EXISTS idx_sessions_last_interaction
+  ON sessions(last_interaction_at DESC);
+
+CREATE TABLE IF NOT EXISTS session_config (
+  session_key                  TEXT PRIMARY KEY,
+  thinking_level               TEXT,
+  reasoning_level              TEXT,
+  verbose_level                TEXT,
+  elevated_mode                TEXT,
+  model_override               TEXT,
+  provider_override            TEXT,
+  working_directory_override   TEXT,
+  updated_at                   INTEGER NOT NULL,
+  FOREIGN KEY (session_key) REFERENCES sessions(session_key) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS transcripts (
+  transcript_id    TEXT PRIMARY KEY,
+  session_key        TEXT NOT NULL,
+  status             TEXT NOT NULL DEFAULT 'active',
+  archive_reason     TEXT,
+  created_at         INTEGER NOT NULL,
+  archived_at        INTEGER,
+  cwd                TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_transcripts_session
+  ON transcripts(session_key, status);
+
+CREATE TABLE IF NOT EXISTS transcript_entries (
+  entry_id        TEXT PRIMARY KEY,
+  transcript_id   TEXT NOT NULL,
+  seq             INTEGER NOT NULL,
+  entry_kind      TEXT NOT NULL,
+  role            TEXT,
+  payload_json    TEXT NOT NULL,
+  created_at      INTEGER NOT NULL,
+  UNIQUE(transcript_id, seq),
+  FOREIGN KEY (transcript_id) REFERENCES transcripts(transcript_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entries_transcript_seq
+  ON transcript_entries(transcript_id, seq);
+CREATE INDEX IF NOT EXISTS idx_entries_kind
+  ON transcript_entries(transcript_id, entry_kind);
+
+CREATE TABLE IF NOT EXISTS compaction_checkpoints (
+  checkpoint_id    TEXT PRIMARY KEY,
+  transcript_id    TEXT NOT NULL,
+  session_key      TEXT NOT NULL,
+  created_at       INTEGER NOT NULL,
+  message_count    INTEGER NOT NULL,
+  size_bytes       INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS checkpoint_entries (
+  checkpoint_id   TEXT NOT NULL,
+  seq             INTEGER NOT NULL,
+  entry_kind      TEXT NOT NULL,
+  role            TEXT,
+  payload_json    TEXT NOT NULL,
+  PRIMARY KEY (checkpoint_id, seq),
+  FOREIGN KEY (checkpoint_id) REFERENCES compaction_checkpoints(checkpoint_id) ON DELETE CASCADE
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS transcript_fts USING fts5(
+  content,
+  session_key UNINDEXED,
+  transcript_id UNINDEXED,
+  entry_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+CREATE TABLE IF NOT EXISTS cron_runs (
+  run_id            TEXT PRIMARY KEY,
+  job_id            TEXT NOT NULL,
+  status            TEXT NOT NULL,
+  started_at        INTEGER NOT NULL,
+  ended_at          INTEGER,
+  duration_ms       INTEGER,
+  error             TEXT,
+  output            TEXT,
+  retry_count       INTEGER NOT NULL DEFAULT 0,
+  summary           TEXT,
+  session_id        TEXT,
+  session_key       TEXT,
+  session_type      TEXT,
+  model             TEXT,
+  provider          TEXT,
+  usage_json        TEXT,
+  workflow_run_id   TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_cron_runs_job_started
+  ON cron_runs(job_id, started_at DESC);
+CREATE INDEX IF NOT EXISTS idx_cron_runs_started
+  ON cron_runs(started_at DESC);
+
+CREATE TABLE IF NOT EXISTS notes (
+  note_id               TEXT PRIMARY KEY,
+  title                 TEXT,
+  kind                  TEXT NOT NULL,
+  status                TEXT NOT NULL,
+  payload_json          TEXT NOT NULL,
+  created_at            INTEGER NOT NULL,
+  updated_at            INTEGER NOT NULL,
+  pinned                INTEGER NOT NULL DEFAULT 0,
+  tags_json             TEXT NOT NULL DEFAULT '[]',
+  snippet               TEXT,
+  cover_attachment_id   TEXT,
+  voice_attachment_id   TEXT,
+  voice_duration_sec    REAL,
+  attachment_names_json TEXT,
+  group_id              TEXT,
+  last_opened_at        INTEGER,
+  task_done             INTEGER,
+  task_due_at           INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_notes_status_updated
+  ON notes(status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_notes_kind
+  ON notes(kind);
+CREATE INDEX IF NOT EXISTS idx_notes_group
+  ON notes(group_id);
+
+CREATE TABLE IF NOT EXISTS memory_files (
+  file_id       TEXT PRIMARY KEY,
+  agent_id      TEXT NOT NULL,
+  path          TEXT NOT NULL,
+  mtime_ms      INTEGER NOT NULL,
+  content_hash  TEXT NOT NULL,
+  UNIQUE(agent_id, path)
+);
+
+CREATE TABLE IF NOT EXISTS memory_chunks (
+  chunk_id    TEXT PRIMARY KEY,
+  file_id     TEXT NOT NULL,
+  start_line  INTEGER NOT NULL,
+  end_line    INTEGER NOT NULL,
+  content     TEXT NOT NULL,
+  FOREIGN KEY (file_id) REFERENCES memory_files(file_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_chunks_file
+  ON memory_chunks(file_id, start_line);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS notes_fts USING fts5(
+  content,
+  note_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+  content,
+  chunk_id UNINDEXED,
+  agent_id UNINDEXED,
+  path UNINDEXED,
+  start_line UNINDEXED,
+  end_line UNINDEXED,
+  tokenize='unicode61'
+);

package/dist/src/storage/sqlite/session-metadata.d.ts

@@ -0,0 +1,8 @@
+import { type SessionMetadata } from '../../session/types.js';
+export declare function resolveAgentIdFromSessionKey(sessionKey: string): string;
+export declare function parseSessionKeySource(key: string): {
+    channel: string;
+    chatId: string;
+};
+export declare function extractRoutingFromSessionKey(key: string): SessionMetadata['routing'];
+export declare function buildDefaultSessionMetadata(sessionKey: string): SessionMetadata;

package/dist/src/storage/sqlite/session-metadata.js

@@ -0,0 +1,83 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
+import "../../session/types.js";
+//#region src/storage/sqlite/session-metadata.ts
+init_session_key();
+function resolveAgentIdFromSessionKey(sessionKey) {
+	return parseSessionKey(sessionKey)?.agentId?.toLowerCase() || "main";
+}
+function parseSessionKeySource(key) {
+	const parts = key.split(":");
+	if (parts.length >= 2 && parts[0] === "heartbeat") return {
+		channel: "heartbeat",
+		chatId: parts.slice(1).join(":")
+	};
+	const parsed = parseSessionKey(key);
+	if (parsed) {
+		if (parsed.source === "cron") return {
+			channel: "cron",
+			chatId: parsed.peerId
+		};
+		return {
+			channel: parsed.source,
+			chatId: [
+				parsed.accountId,
+				parsed.peerKind,
+				parsed.peerId
+			].join(":")
+		};
+	}
+	return {
+		channel: "unknown",
+		chatId: key
+	};
+}
+function extractRoutingFromSessionKey(key) {
+	const parsed = parseSessionKey(key);
+	if (!parsed) return;
+	return {
+		agentId: parsed.agentId?.toLowerCase() || "main",
+		source: parsed.source?.toLowerCase() || "unknown",
+		accountId: parsed.accountId?.toLowerCase() || "default",
+		peerKind: parsed.peerKind?.toLowerCase() || "dm",
+		peerId: parsed.peerId?.toLowerCase() || "unknown",
+		threadId: parsed.threadId,
+		scopeId: parsed.scopeId
+	};
+}
+function buildDefaultSessionMetadata(sessionKey) {
+	const { channel, chatId } = parseSessionKeySource(sessionKey);
+	const routing = extractRoutingFromSessionKey(sessionKey);
+	const isCronSession = channel === "cron";
+	const isHeartbeatSession = channel === "heartbeat";
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	return {
+		key: sessionKey,
+		status: "active",
+		tags: [],
+		createdAt: now,
+		updatedAt: now,
+		lastAccessedAt: now,
+		messageCount: 0,
+		estimatedTokens: 0,
+		compactedCount: 0,
+		sourceChannel: channel,
+		sourceChatId: chatId,
+		routing,
+		...isCronSession ? {
+			sessionType: "cron",
+			customData: { cronJobId: chatId }
+		} : {},
+		...isHeartbeatSession ? {
+			sessionType: "heartbeat",
+			customData: { heartbeatTarget: chatId }
+		} : {},
+		stats: {
+			messageCount: 0,
+			tokenCount: 0
+		}
+	};
+}
+//#endregion
+export { buildDefaultSessionMetadata, extractRoutingFromSessionKey, parseSessionKeySource, resolveAgentIdFromSessionKey };
+
+//# sourceMappingURL=session-metadata.js.map

package/dist/src/storage/sqlite/session-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-metadata.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/storage/sqlite/session-metadata.ts"],"sourcesContent":["import { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport { SessionStatus, type SessionMetadata } from '../../session/types.js';\n\nexport function resolveAgentIdFromSessionKey(sessionKey: string): string {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  return parsed?.agentId?.toLowerCase() || 'main';\n}\n\nexport function parseSessionKeySource(key: string): { channel: string; chatId: string } {\n  const parts = key.split(':');\n  if (parts.length >= 2 && parts[0] === 'heartbeat') {\n    return { channel: 'heartbeat', chatId: parts.slice(1).join(':') };\n  }\n  const parsed = parseRoutingSessionKey(key);\n  if (parsed) {\n    if (parsed.source === 'cron') {\n      return { channel: 'cron', chatId: parsed.peerId };\n    }\n    return {\n      channel: parsed.source,\n      chatId: [parsed.accountId, parsed.peerKind, parsed.peerId].join(':'),\n    };\n  }\n  return { channel: 'unknown', chatId: key };\n}\n\nexport function extractRoutingFromSessionKey(key: string): SessionMetadata['routing'] {\n  const parsed = parseRoutingSessionKey(key);\n  if (!parsed) {\n    return undefined;\n  }\n  return {\n    agentId: parsed.agentId?.toLowerCase() || 'main',\n    source: parsed.source?.toLowerCase() || 'unknown',\n    accountId: parsed.accountId?.toLowerCase() || 'default',\n    peerKind: parsed.peerKind?.toLowerCase() || 'dm',\n    peerId: parsed.peerId?.toLowerCase() || 'unknown',\n    threadId: parsed.threadId,\n    scopeId: parsed.scopeId,\n  };\n}\n\nexport function buildDefaultSessionMetadata(sessionKey: string): SessionMetadata {\n  const { channel, chatId } = parseSessionKeySource(sessionKey);\n  const routing = extractRoutingFromSessionKey(sessionKey);\n  const isCronSession = channel === 'cron';\n  const isHeartbeatSession = channel === 'heartbeat';\n  const now = new Date().toISOString();\n  return {\n    key: sessionKey,\n    status: SessionStatus.ACTIVE,\n    tags: [],\n    createdAt: now,\n    updatedAt: now,\n    lastAccessedAt: now,\n    messageCount: 0,\n    estimatedTokens: 0,\n    compactedCount: 0,\n    sourceChannel: channel,\n    sourceChatId: chatId,\n    routing,\n    ...(isCronSession ? { sessionType: 'cron', customData: { cronJobId: chatId } } : {}),\n    ...(isHeartbeatSession ? { sessionType: 'heartbeat', customData: { heartbeatTarget: chatId } } : {}),\n    stats: { messageCount: 0, tokenCount: 0 },\n  };\n}\n"],"mappings":";;;kBAAyF;AAGzF,SAAgB,6BAA6B,YAA4B;AAEvE,QADeA,gBAAuB,WACzB,EAAE,SAAS,aAAa,IAAI;;AAG3C,SAAgB,sBAAsB,KAAkD;CACtF,MAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,KAAI,MAAM,UAAU,KAAK,MAAM,OAAO,YACpC,QAAO;EAAE,SAAS;EAAa,QAAQ,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI;EAAE;CAEnE,MAAM,SAASA,gBAAuB,IAAI;AAC1C,KAAI,QAAQ;AACV,MAAI,OAAO,WAAW,OACpB,QAAO;GAAE,SAAS;GAAQ,QAAQ,OAAO;GAAQ;AAEnD,SAAO;GACL,SAAS,OAAO;GAChB,QAAQ;IAAC,OAAO;IAAW,OAAO;IAAU,OAAO;IAAO,CAAC,KAAK,IAAI;GACrE;;AAEH,QAAO;EAAE,SAAS;EAAW,QAAQ;EAAK;;AAG5C,SAAgB,6BAA6B,KAAyC;CACpF,MAAM,SAASA,gBAAuB,IAAI;AAC1C,KAAI,CAAC,OACH;AAEF,QAAO;EACL,SAAS,OAAO,SAAS,aAAa,IAAI;EAC1C,QAAQ,OAAO,QAAQ,aAAa,IAAI;EACxC,WAAW,OAAO,WAAW,aAAa,IAAI;EAC9C,UAAU,OAAO,UAAU,aAAa,IAAI;EAC5C,QAAQ,OAAO,QAAQ,aAAa,IAAI;EACxC,UAAU,OAAO;EACjB,SAAS,OAAO;EACjB;;AAGH,SAAgB,4BAA4B,YAAqC;CAC/E,MAAM,EAAE,SAAS,WAAW,sBAAsB,WAAW;CAC7D,MAAM,UAAU,6BAA6B,WAAW;CACxD,MAAM,gBAAgB,YAAY;CAClC,MAAM,qBAAqB,YAAY;CACvC,MAAM,uBAAM,IAAI,MAAM,EAAC,aAAa;AACpC,QAAO;EACL,KAAK;EACL,QAAA;EACA,MAAM,EAAE;EACR,WAAW;EACX,WAAW;EACX,gBAAgB;EAChB,cAAc;EACd,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EACf,cAAc;EACd;EACA,GAAI,gBAAgB;GAAE,aAAa;GAAQ,YAAY,EAAE,WAAW,QAAQ;GAAE,GAAG,EAAE;EACnF,GAAI,qBAAqB;GAAE,aAAa;GAAa,YAAY,EAAE,iBAAiB,QAAQ;GAAE,GAAG,EAAE;EACnG,OAAO;GAAE,cAAc;GAAG,YAAY;GAAG;EAC1C"}

package/dist/src/storage/sqlite/session-repository.d.ts

@@ -0,0 +1,29 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { SessionListQuery, SessionMetadata, PaginatedResult } from '../../session/types.js';
+import { buildGlobalSessionStats } from './row-mappers.js';
+export declare function ensureSessionInTransaction(db: DatabaseSync, sessionKey: string, cwd: string): SessionMetadata;
+export declare function ensureSessionRecord(sessionKey: string, cwd: string): SessionMetadata;
+export declare function readCurrentTranscriptId(db: DatabaseSync, sessionKey: string): string | null;
+export declare function getSessionMetadata(sessionKey: string): SessionMetadata | null;
+export declare function getCurrentTranscriptId(sessionKey: string): string | null;
+export declare function listSessionMetadata(query?: SessionListQuery): PaginatedResult<SessionMetadata>;
+export declare function patchSessionMetadata(sessionKey: string, updates: Partial<SessionMetadata>): SessionMetadata;
+export declare function updateSessionStats(sessionKey: string, stats: {
+    messageCount: number;
+    estimatedTokens: number;
+    lastInteractionAt?: number;
+}): void;
+export declare function incrementSessionStatsOnAppend(sessionKey: string, tokenDelta?: number): void;
+export declare function resetSessionRecord(sessionKey: string, cwd: string): {
+    sessionId: string;
+    previousSessionId: string;
+} | null;
+export declare function deleteSessionRecord(sessionKey: string): boolean;
+export declare function listSessionsByAgent(agentId: string): SessionMetadata[];
+export declare function getSessionPersistedLevels(sessionKey: string): {
+    thinkingLevel: string | null;
+    verboseLevel: string | null;
+} | null;
+export declare function findSessionKeyByTranscriptId(transcriptId: string): string | null;
+export declare function getGlobalSessionStats(): ReturnType<typeof buildGlobalSessionStats>;
+export declare function resolveSessionAgentId(sessionKey: string): string;