@jini-ai/sqlite 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+## Unreleased
+
+### BREAKING
+
+- Remove 18 server-owned root names (backend configuration/types, legacy acquisition/bootstrap and project CRUD/status helpers). Import their server concern subpaths directly; sqlite no longer depends on server.
+- Keep the immutable old surface snapshot as migration evidence; current runtime/declaration assertions explicitly check the remaining surface.
+
+
+## 0.5.0 — 2026-10-02
+
+### BREAKING
+
+- Deprecated database compatibility facade retains its runtime exports for one release while publishing only release/runtime artifacts.
+- Distribution includes runtime output, release documentation and required assets only. Process records and per-job neutrality checks are no longer part of the package surface.
+
+- Align packed runtime and declaration fixtures with the injected object arguments of the relocated stores.
+
+# Changelog
+
+## 0.4.0 — final compatibility release
+- Re-exported all 65 old public names, including erased types, from concern-owned packages.
+- Removed driver autoload. Resource-opening signatures now require a borrowed connection or host opener.
+- Replaced the obsolete j04 renamed-package manifest assertion with the final old-name shim contract.

package/README.md

@@ -1,110 +1,23 @@
-# `@jini-ai/sqlite`
-
-The durable SQLite adapter layer for a Jini host. Its headline export is `createSqliteEventLog`, a
-real on-disk implementation of `@jini-ai/protocol`'s `EventLog` port (the dedupe-aware,
-gap-detecting run-event log that `@jini-ai/daemon` also implements in memory) — swap one for the
-other and runs survive a process restart. Alongside it sits the application schema and typed query
-helpers a chat/agent host needs: projects, conversations, messages, agent sessions, a searchable
-tool catalog, plus migration and integrity-inspection utilities. This package depends only on
-`@jini-ai/protocol` and `better-sqlite3`; it does **not** depend on `@jini-ai/daemon`.
-
-## Install
-
-```sh
-npm install @jini-ai/sqlite
-```
-
-`better-sqlite3` is a regular dependency (not an optional peer) because opening the database is this
-package's entire job. It is a **native compiled addon**, so it needs a prebuild matching the exact
-Node ABI it runs under — inside an Electron/Tauri shell that means an `electron-rebuild` step
-whenever the shell's bundled Node/Electron version changes, not just a plain install.
-
-## What you get
-
-**Durable event log** — `createSqliteEventLog(dbPath, { maxEntriesPerRun })` returning a
-`SqliteEventLog` (an `EventLog` plus its own close/lifecycle surface), and
-`DEFAULT_MAX_ENTRIES_PER_RUN` (2000). Unlike the in-memory reference log, a durable store defaults
-to a *bounded* retention window per run, because unbounded on-disk growth is a real unattended
-operational risk; pass an explicit cap (larger, smaller, or `0`) to own that tradeoff yourself.
-
-**Connection and migration** — `openDatabase(projectRoot, { dataDir })` (opens/creates
-`<dataDir ?? projectRoot/.jini>/app.sqlite` and memoizes the handle), `closeDatabase()`, and
-`migrate(db)`. Core types: `SqliteDb`, `DbRow`, `JsonObject`, `ChatSessionMode`.
-
-**Backend selection** — `resolveSqliteBackendConfig(env)` → `SqliteBackendConfig`
-(`kind: 'sqlite' | 'postgres'` plus Postgres resolution metadata a future adapter will read, with
-secrets deliberately never read through env at this layer), and `SqliteBackendConfigError`.
-
-**Application queries** — plain functions over a `SqliteDb`, grouped by table:
-- projects: `listProjects`, `getProject`, `insertProject`, `updateProject`, `deleteProject`, and the
-  run-status rollups (`listLatestRunStatuses`, `listLatestProjectRunStatuses`,
-  `listLatestConversationRunStatuses`, `listFirstConversationRunStatuses`,
-  `listProjectsAwaitingInput`, `listConversationsAwaitingInput`)
-- conversations: `listConversations`, `getConversation`, `insertConversation`, `updateConversation`,
-  `deleteConversation`, `normalizeConversationSessionMode`
-- messages: `listMessages`, `upsertMessage`, `deleteMessage`, `appendMessageStatusEvent`,
-  `appendMessageAgentEvent`, `getMessageTelemetryFinalizationState`, and
-  `MessageConversationMismatchError`
-- agent sessions: `getAgentSession`, `getAgentSessionRecord`, `upsertAgentSession`,
-  `clearAgentSession`, `updateAgentSessionStableHash`, `latestCompletedAssistantMessageId`
-
-**Tool catalog** — `ensureToolCatalogTables`, `reseedToolCatalog`, `getToolCatalogEntry`,
-`searchToolCatalog` (FTS-backed), with `ToolCatalogEntry` / `ToolCatalogSearchHit`.
-
-**Inspection** — `inspectSqliteDatabase({ db, file })` → `DaemonDbStatusReport` (table/row
-inventory) and `verifySqliteIntegrity(opts)` → `DbIntegrityReport` (`PRAGMA integrity_check` plus
-foreign-key violations).
-
-**Row utilities** — `row`, `rows`, `parseJsonOrUndef`.
-
-## Usage
-
-```ts
-import {
-  createSqliteEventLog,
-  openDatabase,
-  migrate,
-  listProjects,
-  searchToolCatalog,
-  verifySqliteIntegrity,
-} from '@jini-ai/sqlite';
-import type { EventLog } from '@jini-ai/protocol';
-
-// The durable EventLog port — drop-in for @jini-ai/daemon's in-memory log.
-const eventLog: EventLog = createSqliteEventLog('/var/lib/example/events.sqlite', {
-  maxEntriesPerRun: 5000,
-});
-
-await eventLog.append({ runId: 'run_123', event: 'stdout', data: { text: 'hello' } });
-const replay = await eventLog.replay('run_123', null);
-if (replay.kind === 'replay-gap') {
-  // The requested cursor was already evicted — resync rather than trusting a hole.
-}
-
-// The application database.
-const db = openDatabase('/srv/workspace');
-migrate(db);
-
-const projects = listProjects(db);
-const hits = searchToolCatalog(db, 'deploy', 5);
-const integrity = verifySqliteIntegrity({ db });
-```
-
-## What's swappable
-
-This package *is* an adapter — it implements `@jini-ai/protocol`'s `EventLog` so a host can bind
-either it or an in-memory log behind the same token. Going the other way, very little inside is
-injectable: `createSqliteEventLog` takes only a path plus the retention cap, and the query helpers
-take an already-open `SqliteDb` handle (so you control connection lifetime, and can pass a
-`:memory:` database in tests) but the SQL and schema themselves are fixed.
-`resolveSqliteBackendConfig` reads a caller-supplied `env` record rather than `process.env` directly.
-
-## Runtime
-
-`jini.runtime: "node"` — `better-sqlite3` plus `node:fs`/`node:path`.
-ESM only — ships `"type": "module"` with no CommonJS `require` build.
-
-## Provenance
-
-See [source-map.md](./source-map.md) for per-file provenance and scope decisions. Apache-2.0,
-inherited from Open Design — see the repo `NOTICE`.
+# @jini-ai/sqlite — deprecated compatibility release
+
+Version 0.5.0 is a deprecated compatibility surface for chat, daemon, registry and driver concerns,
+including their erased types. Server-owned composition is no longer forwarded by this package. Prefer `@jini-ai/chat/store/{sqlite,legacy/sqlite}`,
+`@jini-ai/daemon/store/{event-log/sqlite,agent-sessions/sqlite}`, `@jini-ai/registry/tool-catalog/sqlite`,
+`@jini-ai/db/{core,sqlite}`, and `@jini-ai/server/{storage,storage/legacy/sqlite,store/projects/sqlite}`.
+
+Pre-1.0 breaking acquisition change: Jini never autoloads a database driver. Use
+`createSqliteEventLog({ db }, options)` for a borrowed connection. Canonical owned acquisition is
+`openSqliteEventLog({ file, open }, options)` from the daemon concern entry. Server
+`openDatabase({ projectRoot, open }, { dataDir? })` likewise requires the host opener. Hosts may use `(file, options) => new Database(file, options)`.
+Borrowed event-log close never closes the host handle. Owned close is idempotent; failed setup
+closes the newly acquired handle. The remaining event/CRUD/cursor/schema semantics stay unchanged.
+
+This explicit re-export shim depends on concern owners. None depends on it. It eagerly loads
+several adapters and requires the db/Kysely SQL peers; lean consumers should use the concern subpaths.
+No driver is bundled, a hard dependency, dynamically imported, or obtained from a global registry.
+The unpublished sqlite-chat implementation directory is drained; no registry release is changed here.
+
+Backend config and types now come directly from `@jini-ai/server/storage`;
+`openDatabase`, `closeDatabase` and `migrate` from `@jini-ai/server/storage/legacy/sqlite`;
+project CRUD/status helpers from `@jini-ai/server/store/projects/sqlite`. This removes
+the sqlite-to-server dependency rather than adding a wrapper or duplicated implementation.

package/dist/index.d.ts

@@ -1,12 +1,20 @@
 /**
- * @module @jini-ai/sqlite
- *
- * The default durable store adapter behind `@jini-ai/daemon`'s ports (extraction-plan §8 task 8),
- * plus backend-selection and inspection helpers for `better-sqlite3`-backed daemons.
- * See `source-map.md` for full provenance and scope-decision notes.
+ * @deprecated Compatibility for the remaining 0.3.x storage names; prefer concern subpaths.
+ * Durable event-log adapters live in daemon, inspection/driver primitives in db.
+ * Backend selection, acquisition and project composition belong to the server shell;
+ * importing this facade must not pull that higher-level assembly into storage consumers.
+ * Inject host handles/openers. See docs/spec/api.spec.md for scope and migration targets.
  */
-export * from './event-log.js';
-export * from './backend-config.js';
-export * from './db-inspect.js';
-export * from './db/index.js';
+export { createSqliteEventLog, DEFAULT_MAX_ENTRIES_PER_RUN } from '@jini-ai/daemon/store/event-log/sqlite';
+export type { SqliteEventLog, SqliteEventLogOptions } from '@jini-ai/daemon/store/event-log/sqlite';
+export { inspectSqliteDatabase, verifySqliteIntegrity } from '@jini-ai/db/sqlite';
+export type { DaemonDbStatusReport, DaemonDbTableInfo, DbIntegrityIssue, DbIntegrityIssueKind, DbIntegrityReport, SqliteDb, VerifyDbOptions } from '@jini-ai/db/sqlite';
+export { parseJsonOrUndef, row, rows } from '@jini-ai/db/core';
+export type { DbRow, JsonObject } from '@jini-ai/db/core';
+export type { ChatSessionMode } from '@jini-ai/chat/store/legacy';
+export { CHAT_HISTORY_DDL, createChatHistoryMaintenance, createChatHistoryStore, ensureChatHistoryTables } from '@jini-ai/chat/store/sqlite';
+export type { ToolCatalogEntry, ToolCatalogSearchHit } from '@jini-ai/registry/tool-catalog';
+export { ensureToolCatalogTables, getToolCatalogEntry, reseedToolCatalog, searchToolCatalog } from '@jini-ai/registry/tool-catalog/sqlite';
+export { appendMessageAgentEvent, appendMessageStatusEvent, deleteConversation, deleteMessage, getConversation, getMessageTelemetryFinalizationState, insertConversation, listConversations, listMessages, normalizeConversationSessionMode, updateConversation, upsertMessage } from '@jini-ai/chat/store/legacy/sqlite';
+export { clearAgentSession, getAgentSession, getAgentSessionRecord, latestCompletedAssistantMessageId, updateAgentSessionStableHash, upsertAgentSession } from '@jini-ai/daemon/store/agent-sessions/sqlite';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,12 +1,15 @@
 /**
- * @module @jini-ai/sqlite
- *
- * The default durable store adapter behind `@jini-ai/daemon`'s ports (extraction-plan §8 task 8),
- * plus backend-selection and inspection helpers for `better-sqlite3`-backed daemons.
- * See `source-map.md` for full provenance and scope-decision notes.
+ * @deprecated Compatibility for the remaining 0.3.x storage names; prefer concern subpaths.
+ * Durable event-log adapters live in daemon, inspection/driver primitives in db.
+ * Backend selection, acquisition and project composition belong to the server shell;
+ * importing this facade must not pull that higher-level assembly into storage consumers.
+ * Inject host handles/openers. See docs/spec/api.spec.md for scope and migration targets.
  */
-export * from './event-log.js';
-export * from './backend-config.js';
-export * from './db-inspect.js';
-export * from './db/index.js';
+export { createSqliteEventLog, DEFAULT_MAX_ENTRIES_PER_RUN } from '@jini-ai/daemon/store/event-log/sqlite';
+export { inspectSqliteDatabase, verifySqliteIntegrity } from '@jini-ai/db/sqlite';
+export { parseJsonOrUndef, row, rows } from '@jini-ai/db/core';
+export { CHAT_HISTORY_DDL, createChatHistoryMaintenance, createChatHistoryStore, ensureChatHistoryTables } from '@jini-ai/chat/store/sqlite';
+export { ensureToolCatalogTables, getToolCatalogEntry, reseedToolCatalog, searchToolCatalog } from '@jini-ai/registry/tool-catalog/sqlite';
+export { appendMessageAgentEvent, appendMessageStatusEvent, deleteConversation, deleteMessage, getConversation, getMessageTelemetryFinalizationState, insertConversation, listConversations, listMessages, normalizeConversationSessionMode, updateConversation, upsertMessage } from '@jini-ai/chat/store/legacy/sqlite';
+export { clearAgentSession, getAgentSession, getAgentSessionRecord, latestCompletedAssistantMessageId, updateAgentSessionStableHash, upsertAgentSession } from '@jini-ai/daemon/store/agent-sessions/sqlite';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jini-ai/sqlite",
-  "version": "0.3.0",
-  "description": "better-sqlite3-backed persistence adapters for @jini-ai/daemon’s ports: durable event log, backend selection, schema migration, and database inspection.",
+  "version": "0.5.0",
+  "description": "Deprecated compatibility exports for chat, daemon, registry and database concerns; server composition is imported directly from server.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -26,23 +26,27 @@
   },
   "files": [
     "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
     "!dist/**/*.test.js.map",
     "!dist/**/*.test.d.ts.map",
-    "!dist/**/__tests__/**"
+    "!dist/**/__tests__/**",
+    "!dist/**/*.map"
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "better-sqlite3": "^13.0.0",
-    "@jini-ai/chat": "0.3.0",
-    "@jini-ai/protocol": "0.3.0"
+    "@jini-ai/chat": "0.5.0",
+    "@jini-ai/registry": "0.5.0",
+    "@jini-ai/db": "0.2.0",
+    "@jini-ai/daemon": "0.5.0"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.11",
     "@vitest/coverage-v8": "^2.1.9"
   },
   "scripts": {

package/dist/backend-config.d.ts

@@ -1,42 +0,0 @@
-/**
- * @module backend-config
- *
- * Resolves which SQL backend a host daemon should use from environment
- * variables. v1 ships local SQLite via `better-sqlite3` (see `./event-log.js`);
- * a `postgres` selection is recorded so a future adapter can read it, but
- * `resolveSqliteBackendConfig` never opens a connection itself — it only
- * pins the parameter surface (host/port/database/user/sslMode) so a
- * follow-up package can land the adapter without re-litigating the env-var
- * contract.
- */
-export type SqliteBackendKind = 'sqlite' | 'postgres';
-export interface SqliteBackendConfig {
-    kind: SqliteBackendKind;
-    /** Resolution metadata a future Postgres adapter will read. */
-    postgres?: {
-        host: string;
-        port: number;
-        database: string;
-        user: string;
-        /**
-         * Password / connection string are looked up at runtime from the
-         * caller's own secret manager; this layer never reads them through env.
-         */
-        sslMode?: 'disable' | 'require' | 'verify-full';
-    };
-}
-export declare class SqliteBackendConfigError extends Error {
-    constructor(message: string);
-}
-/**
- * Reads `JINI_SQLITE_BACKEND` (`'sqlite'` default, or `'postgres'`) and, for
- * `postgres`, `JINI_PG_HOST`/`JINI_PG_PORT`/`JINI_PG_DATABASE`/`JINI_PG_USER`/
- * `JINI_PG_SSL_MODE` from the given env map (defaults to `process.env`).
- *
- * @param env - Environment map to read from. Defaults to `process.env`.
- * @returns The resolved backend config.
- * @throws {SqliteBackendConfigError} When `kind` is unrecognized, or `postgres`
- *   is selected without the required host/database/user.
- */
-export declare function resolveSqliteBackendConfig(env?: Record<string, string | undefined>): SqliteBackendConfig;
-//# sourceMappingURL=backend-config.d.ts.map

package/dist/backend-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"backend-config.d.ts","sourceRoot":"","sources":["../src/backend-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb;;;WAGG;QACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;KACjD,CAAC;CACH;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,mBAAmB,CA+BxG"}

package/dist/backend-config.js

@@ -1,57 +0,0 @@
-/**
- * @module backend-config
- *
- * Resolves which SQL backend a host daemon should use from environment
- * variables. v1 ships local SQLite via `better-sqlite3` (see `./event-log.js`);
- * a `postgres` selection is recorded so a future adapter can read it, but
- * `resolveSqliteBackendConfig` never opens a connection itself — it only
- * pins the parameter surface (host/port/database/user/sslMode) so a
- * follow-up package can land the adapter without re-litigating the env-var
- * contract.
- */
-export class SqliteBackendConfigError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'SqliteBackendConfigError';
-    }
-}
-/**
- * Reads `JINI_SQLITE_BACKEND` (`'sqlite'` default, or `'postgres'`) and, for
- * `postgres`, `JINI_PG_HOST`/`JINI_PG_PORT`/`JINI_PG_DATABASE`/`JINI_PG_USER`/
- * `JINI_PG_SSL_MODE` from the given env map (defaults to `process.env`).
- *
- * @param env - Environment map to read from. Defaults to `process.env`.
- * @returns The resolved backend config.
- * @throws {SqliteBackendConfigError} When `kind` is unrecognized, or `postgres`
- *   is selected without the required host/database/user.
- */
-export function resolveSqliteBackendConfig(env) {
-    const e = env ?? process.env;
-    const kind = (e.JINI_SQLITE_BACKEND ?? 'sqlite').trim().toLowerCase();
-    if (kind === 'postgres') {
-        const host = e.JINI_PG_HOST ?? '';
-        const portStr = e.JINI_PG_PORT ?? '5432';
-        const database = e.JINI_PG_DATABASE ?? '';
-        const user = e.JINI_PG_USER ?? '';
-        const sslMode = e.JINI_PG_SSL_MODE === 'disable' || e.JINI_PG_SSL_MODE === 'verify-full' ? e.JINI_PG_SSL_MODE : 'require';
-        if (!host || !database || !user) {
-            throw new SqliteBackendConfigError('JINI_SQLITE_BACKEND=postgres requires JINI_PG_HOST, JINI_PG_DATABASE, JINI_PG_USER. ' +
-                'JINI_PG_PORT defaults to 5432; JINI_PG_SSL_MODE defaults to "require".');
-        }
-        return {
-            kind: 'postgres',
-            postgres: {
-                host,
-                port: Number.parseInt(portStr, 10) || 5432,
-                database,
-                user,
-                sslMode,
-            },
-        };
-    }
-    if (kind !== 'sqlite' && kind !== '') {
-        throw new SqliteBackendConfigError(`unknown JINI_SQLITE_BACKEND value '${kind}'. Accepted: 'sqlite' (default), 'postgres'.`);
-    }
-    return { kind: 'sqlite' };
-}
-//# sourceMappingURL=backend-config.js.map

package/dist/backend-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"backend-config.js","sourceRoot":"","sources":["../src/backend-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoBH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAwC;IACjF,MAAM,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,mBAAmB,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC;QACzC,MAAM,QAAQ,GAAG,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GACX,CAAC,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,CAAC,gBAAgB,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5G,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,wBAAwB,CAChC,sFAAsF;gBACpF,wEAAwE,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI;gBACJ,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,IAAI;gBAC1C,QAAQ;gBACR,IAAI;gBACJ,OAAO;aACR;SACF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,wBAAwB,CAAC,sCAAsC,IAAI,8CAA8C,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/db/agent-sessions/agent-sessions.d.ts

@@ -1,79 +0,0 @@
-/**
- * @module db/agent-sessions
- * Owns the per-(conversation, agent) upstream CLI session cache used by the resume identity guard.
- * Imports only the core/ kernel (types). No other db concern is imported.
- *
- * NOTE (neutral port): no OD-specific columns or logic — every field (session id, prompt hash,
- * model, cwd, last message id) is generic resume-identity bookkeeping already matched 1:1 by the
- * already-ported `schema/migrate.ts` `agent_sessions` table. Ported verbatim aside from
- * de-branding the module doc comment.
- */
-import type { SqliteDb } from '../core/index.js';
-/**
- * Returns the stored upstream CLI session id for a (conversation, agent) pair, or null if none exists.
- * Used as a quick existence check before the full record is needed.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to look up.
- */
-export declare function getAgentSession(db: SqliteDb, conversationId: string, agentId: string): string | null;
-/**
- * Creates or replaces the agent session record for a (conversation, agent) pair.
- * All nullable fields are stored as SQL NULL when omitted, preserving the resume guard's
- * ability to detect staleness via stablePromptHash and lastMessageId.
- * @param db - Open SQLite database handle.
- * @param input - Session fields to persist; conversationId, agentId, and sessionId are required.
- */
-export declare function upsertAgentSession(db: SqliteDb, input: {
-    conversationId: string;
-    agentId: string;
-    sessionId: string;
-    stablePromptHash?: string | null;
-    model?: string | null;
-    cwd?: string | null;
-    lastMessageId?: string | null;
-}): void;
-/**
- * Fetches the full agent session record for a (conversation, agent) pair, or null if absent.
- * Callers that need only the session id should use {@link getAgentSession} instead.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to retrieve.
- */
-export declare function getAgentSessionRecord(db: SqliteDb, conversationId: string, agentId: string): {
-    sessionId: string;
-    stablePromptHash: string | null;
-    model: string | null;
-    cwd: string | null;
-    lastMessageId: string | null;
-} | null;
-/**
- * Returns the conversation cursor used by the resume identity guard: the id of the most recent
- * completed (succeeded) assistant message, excluding the current in-flight placeholder.
- * See the inline comment above for the full invariant and the resumableMessageId exception.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation to inspect.
- * @param excludeMessageId - The in-flight run's own placeholder message id to skip.
- * @param resumableMessageId - Optional id of a transiently-failed session's last message, admitted through the succeeded-only filter.
- * @returns The matching message id, or null if no prior completed turn exists.
- */
-export declare function latestCompletedAssistantMessageId(db: SqliteDb, conversationId: string, excludeMessageId: string, resumableMessageId?: string | null): string | null;
-/**
- * Updates the stable prompt hash for an existing agent session without touching other fields.
- * Called after the resume path confirms the prompt context is still stable, recording the
- * current hash so future identity checks can compare against it.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to update.
- * @param stablePromptHash - The new prompt hash to record.
- */
-export declare function updateAgentSessionStableHash(db: SqliteDb, conversationId: string, agentId: string, stablePromptHash: string): void;
-/**
- * Deletes the agent session record for a (conversation, agent) pair.
- * Forces the next run to start a fresh upstream CLI session rather than attempting resume.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to clear.
- */
-export declare function clearAgentSession(db: SqliteDb, conversationId: string, agentId: string): void;
-//# sourceMappingURL=agent-sessions.d.ts.map

package/dist/db/agent-sessions/agent-sessions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-sessions.d.ts","sourceRoot":"","sources":["../../../src/db/agent-sessions/agent-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,kBAAkB,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE;IACL,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GACA,IAAI,CAsBN;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,IAAI,CAgBP;AAyBD;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,EACxB,kBAAkB,GAAE,MAAM,GAAG,IAAW,GACvC,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAKN;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,IAAI,CAIN"}

package/dist/db/agent-sessions/agent-sessions.js

@@ -1,121 +0,0 @@
-/**
- * Returns the stored upstream CLI session id for a (conversation, agent) pair, or null if none exists.
- * Used as a quick existence check before the full record is needed.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to look up.
- */
-export function getAgentSession(db, conversationId, agentId) {
-    const row = db
-        .prepare(`SELECT session_id FROM agent_sessions
-        WHERE conversation_id = ? AND agent_id = ?`)
-        .get(conversationId, agentId);
-    return row && typeof row.session_id === 'string' ? row.session_id : null;
-}
-/**
- * Creates or replaces the agent session record for a (conversation, agent) pair.
- * All nullable fields are stored as SQL NULL when omitted, preserving the resume guard's
- * ability to detect staleness via stablePromptHash and lastMessageId.
- * @param db - Open SQLite database handle.
- * @param input - Session fields to persist; conversationId, agentId, and sessionId are required.
- */
-export function upsertAgentSession(db, input) {
-    db.prepare(`INSERT INTO agent_sessions
-       (conversation_id, agent_id, session_id, stable_prompt_hash, model, cwd, last_message_id, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(conversation_id, agent_id)
-       DO UPDATE SET session_id = excluded.session_id,
-                     stable_prompt_hash = excluded.stable_prompt_hash,
-                     model = excluded.model,
-                     cwd = excluded.cwd,
-                     last_message_id = excluded.last_message_id,
-                     updated_at = excluded.updated_at`).run(input.conversationId, input.agentId, input.sessionId, input.stablePromptHash ?? null, input.model ?? null, input.cwd ?? null, input.lastMessageId ?? null, Date.now());
-}
-/**
- * Fetches the full agent session record for a (conversation, agent) pair, or null if absent.
- * Callers that need only the session id should use {@link getAgentSession} instead.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to retrieve.
- */
-export function getAgentSessionRecord(db, conversationId, agentId) {
-    const row = db
-        .prepare(`SELECT session_id, stable_prompt_hash, model, cwd, last_message_id FROM agent_sessions
-        WHERE conversation_id = ? AND agent_id = ?`)
-        .get(conversationId, agentId);
-    if (!row || typeof row.session_id !== 'string')
-        return null;
-    return {
-        sessionId: row.session_id,
-        stablePromptHash: typeof row.stable_prompt_hash === 'string' ? row.stable_prompt_hash : null,
-        model: typeof row.model === 'string' ? row.model : null,
-        cwd: typeof row.cwd === 'string' ? row.cwd : null,
-        lastMessageId: typeof row.last_message_id === 'string' ? row.last_message_id : null,
-    };
-}
-// Conversation cursor for the resume identity guard: the id of the latest
-// COMPLETED assistant message in the conversation, EXCLUDING the current run's
-// in-flight placeholder (`excludeMessageId`). At resolve time the session is in
-// sync iff this equals the assistant message the session last produced —
-// otherwise another agent completed a turn in between, or the session's own last
-// message was edited/removed, and the session is behind. Returns null when there
-// is no prior completed assistant turn.
-//
-// "Completed" means run_status = 'succeeded' — a run stamps its assistant
-// message with the terminal status on finish, so an intervening agent run that
-// FAILED or was CANCELED leaves a placeholder that produced no completed turn;
-// counting it as advancement would force a needless cold reseed (silently
-// disabling the resume perf path) even though the stored session is still the
-// latest completed turn. In-flight placeholders have a null run_status and are
-// likewise excluded.
-//
-// `resumableMessageId` is the one allowed exception: a resume-on-failure path
-// may persist a session whose own last assistant turn FAILED transiently (the
-// CLI session already committed a tool/artifact block and is resumable). That
-// stored id is admitted through the filter so the session it owns still matches
-// its cursor — while a DIFFERENT later failed/canceled turn (a different id)
-// stays excluded, so genuine advancement by a later succeeded turn is still
-// detected.
-/**
- * Returns the conversation cursor used by the resume identity guard: the id of the most recent
- * completed (succeeded) assistant message, excluding the current in-flight placeholder.
- * See the inline comment above for the full invariant and the resumableMessageId exception.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation to inspect.
- * @param excludeMessageId - The in-flight run's own placeholder message id to skip.
- * @param resumableMessageId - Optional id of a transiently-failed session's last message, admitted through the succeeded-only filter.
- * @returns The matching message id, or null if no prior completed turn exists.
- */
-export function latestCompletedAssistantMessageId(db, conversationId, excludeMessageId, resumableMessageId = null) {
-    const row = db
-        .prepare(`SELECT id FROM messages
-        WHERE conversation_id = ? AND role = 'assistant' AND id != ?
-          AND (run_status = 'succeeded' OR id = ?)
-        ORDER BY position DESC LIMIT 1`)
-        .get(conversationId, excludeMessageId, resumableMessageId);
-    return row && typeof row.id === 'string' ? row.id : null;
-}
-/**
- * Updates the stable prompt hash for an existing agent session without touching other fields.
- * Called after the resume path confirms the prompt context is still stable, recording the
- * current hash so future identity checks can compare against it.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to update.
- * @param stablePromptHash - The new prompt hash to record.
- */
-export function updateAgentSessionStableHash(db, conversationId, agentId, stablePromptHash) {
-    db.prepare(`UPDATE agent_sessions SET stable_prompt_hash = ?, updated_at = ?
-      WHERE conversation_id = ? AND agent_id = ?`).run(stablePromptHash, Date.now(), conversationId, agentId);
-}
-/**
- * Deletes the agent session record for a (conversation, agent) pair.
- * Forces the next run to start a fresh upstream CLI session rather than attempting resume.
- * @param db - Open SQLite database handle.
- * @param conversationId - Conversation scope for the session.
- * @param agentId - Agent whose session to clear.
- */
-export function clearAgentSession(db, conversationId, agentId) {
-    db.prepare(`DELETE FROM agent_sessions WHERE conversation_id = ? AND agent_id = ?`).run(conversationId, agentId);
-}
-//# sourceMappingURL=agent-sessions.js.map

package/dist/db/agent-sessions/agent-sessions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-sessions.js","sourceRoot":"","sources":["../../../src/db/agent-sessions/agent-sessions.ts"],"names":[],"mappings":"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"}

package/dist/db/agent-sessions/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * @module db/agent-sessions/index
- * Public barrel for the agent-sessions concern: re-exports the upstream CLI session cache API.
- */
-export * from './agent-sessions.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/db/agent-sessions/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/agent-sessions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,qBAAqB,CAAC"}

package/dist/db/agent-sessions/index.js

@@ -1,6 +0,0 @@
-/**
- * @module db/agent-sessions/index
- * Public barrel for the agent-sessions concern: re-exports the upstream CLI session cache API.
- */
-export * from './agent-sessions.js';
-//# sourceMappingURL=index.js.map

package/dist/db/agent-sessions/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/agent-sessions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,qBAAqB,CAAC"}