ai-hist 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# ai-hist (TypeScript SDK)
+
+Thin TypeScript SDK for the [ai-hist](../README.md) SQLite database. Reads the same file the Python `ai-hist sync` tool writes — this package never writes, sync stays the Python tool's job.
+
+Built to let Electron / Node consumers (e.g. the `pear` desktop app) render a Codex/Claude-style "previous conversations" list backed by your local ai-hist history.
+
+## Install
+
+```bash
+npm install ai-hist
+```
+
+`better-sqlite3` is a native dep — when bundling into an Electron app, run `electron-rebuild` (or your bundler's equivalent) after install.
+
+## Quick start
+
+```ts
+import { AiHist, resumeCommand } from 'ai-hist';
+
+const hist = new AiHist();              // uses $AI_HIST_DB or ~/.local/share/ai-hist/ai-history.db
+try {
+  const sessions = hist.listSessions({ limit: 20 });
+  for (const s of sessions) {
+    console.log(`[${s.source}] ${s.firstPrompt.slice(0, 60)} (${s.promptCount} prompts)`);
+    console.log('  resume:', resumeCommand(s));
+  }
+} finally {
+  hist.close();
+}
+```
+
+## API
+
+```ts
+new AiHist(opts?: { dbPath?: string })       // readonly open
+hist.close()
+hist.dbPath: string
+
+hist.recent(opts?): HistoryEntry[]            // newest prompts first
+hist.listSessions(opts?): SessionSummary[]    // grouped by session_id, last-activity DESC
+hist.getSession(sessionId): HistoryEntry[]    // all prompts in a session, oldest first
+hist.search(query, opts?): HistoryEntry[]     // FTS5 query, recent matches first
+hist.stats(): Stats                           // counts + date range
+```
+
+All list-style methods accept `{ source?, project?, limit?, beforeMs? }`. `beforeMs` is the cursor for paginating older results.
+
+```ts
+resumeCommand(entry): string | null           // shell command per source; null for relay
+defaultDbPath(): string                       // resolve env / OS default
+```
+
+## Schema (canonical, owned by the Python tool)
+
+```sql
+CREATE TABLE history (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source TEXT NOT NULL,         -- 'claude' | 'codex' | 'cursor' | 'relay'
+  session_id TEXT,
+  project TEXT,
+  prompt TEXT NOT NULL,
+  timestamp_ms INTEGER NOT NULL,
+  UNIQUE(source, timestamp_ms, prompt)
+);
+
+CREATE VIRTUAL TABLE history_fts USING fts5(prompt, project, content='history', content_rowid='id');
+```
+
+If the Python sync tool's schema changes, bump this SDK's major version. Consumers pin the SDK version they were built against.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * TypeScript SDK for reading the ai-hist SQLite database.
+ *
+ * Backed by sql.js (WASM SQLite) so the package has zero native build
+ * requirements — works in Electron, Node, and browser contexts without
+ * needing electron-rebuild. The SDK reads the same file the Python CLI
+ * maintains (default `~/.local/share/ai-hist/ai-history.db`, or
+ * `$AI_HIST_DB`); the Python tool stays the canonical sync engine.
+ *
+ * Trade-off vs better-sqlite3: sql.js loads the whole DB file into
+ * memory. Fine for the ai-hist scale (tens of thousands of rows, MBs
+ * of data); revisit if anyone hits millions.
+ */
+import { type Database } from 'sql.js';
+export type Source = 'claude' | 'codex' | 'cursor' | 'relay';
+export interface HistoryEntry {
+    id: number;
+    source: Source;
+    sessionId: string | null;
+    project: string | null;
+    prompt: string;
+    timestampMs: number;
+}
+export interface SessionSummary {
+    sessionId: string;
+    source: Source;
+    project: string | null;
+    firstPrompt: string;
+    lastActivityMs: number;
+    firstActivityMs: number;
+    promptCount: number;
+}
+export interface ListOptions {
+    source?: Source;
+    project?: string;
+    /** Default 50. */
+    limit?: number;
+    /**
+     * Paginate older than this timestamp (exclusive). Use the
+     * `lastActivityMs` / `timestampMs` of the last item from the previous page.
+     */
+    beforeMs?: number;
+}
+export type SearchOptions = ListOptions;
+export interface Stats {
+    total: number;
+    bySource: Partial<Record<Source, number>>;
+    byProject: Array<{
+        project: string;
+        count: number;
+    }>;
+    firstTimestampMs: number | null;
+    lastTimestampMs: number | null;
+}
+/** Resolve the SQLite path the Python CLI writes to. */
+export declare function defaultDbPath(): string;
+/**
+ * Open an `AiHist` reader. Async because sql.js initializes its WASM
+ * runtime lazily. Each call reads the DB file from disk; the resulting
+ * instance is a snapshot — to see new prompts written by the Python sync,
+ * call `reload()` (or open a fresh instance).
+ */
+export declare function openAiHist(opts?: {
+    dbPath?: string;
+}): Promise<AiHist>;
+export declare class AiHist {
+    private readonly db;
+    private readonly _dbPath;
+    private closed;
+    /** @internal — use `openAiHist({ dbPath })` to construct. */
+    constructor(db: Database, dbPath: string);
+    get dbPath(): string;
+    close(): void;
+    /** Most recent prompts, newest first. */
+    recent(opts?: ListOptions): HistoryEntry[];
+    /**
+     * Group history into sessions, ordered by last activity (newest first).
+     * Sessions without a `session_id` are skipped.
+     */
+    listSessions(opts?: ListOptions): SessionSummary[];
+    /** All prompts in a session, ordered oldest → newest. */
+    getSession(sessionId: string): HistoryEntry[];
+    /**
+     * Substring search across prompt + project, case-insensitive, recent
+     * matches first. The Python CLI uses FTS5; this SDK uses LIKE because
+     * sql.js's default WASM build doesn't ship the FTS5 module. Plenty fast
+     * for the ai-hist scale (~tens of thousands of rows); revisit if a
+     * future consumer needs phrase/boolean queries.
+     *
+     * The query is matched literally — `%` and `_` are escaped so users can
+     * search for them. Empty queries return an empty array.
+     */
+    search(query: string, opts?: SearchOptions): HistoryEntry[];
+    /** Counts + date range, mirroring `ai-hist stats`. */
+    stats(): Stats;
+}
+/**
+ * Resume command for an entry/session, matching what `ai-hist show` prints.
+ * Returns `null` for sources that don't have a resume affordance (relay).
+ */
+export declare function resumeCommand(entry: Pick<HistoryEntry, 'source' | 'sessionId' | 'project'>): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAkB,EAAE,KAAK,QAAQ,EAAoB,MAAM,QAAQ,CAAC;AAKpE,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wDAAwD;AACxD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAUD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBhF;AAyDD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB,6DAA6D;gBACjD,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IAKxC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAMb,yCAAyC;IACzC,MAAM,CAAC,IAAI,GAAE,WAAgB,GAAG,YAAY,EAAE;IAc9C;;;OAGG;IACH,YAAY,CAAC,IAAI,GAAE,WAAgB,GAAG,cAAc,EAAE;IAsDtD,yDAAyD;IACzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAW7C;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,EAAE;IAiC/D,sDAAsD;IACtD,KAAK,IAAI,KAAK;CAgCf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC,GAC5D,MAAM,GAAG,IAAI,CAkBf"}

package/dist/index.js

@@ -0,0 +1,267 @@
+/**
+ * TypeScript SDK for reading the ai-hist SQLite database.
+ *
+ * Backed by sql.js (WASM SQLite) so the package has zero native build
+ * requirements — works in Electron, Node, and browser contexts without
+ * needing electron-rebuild. The SDK reads the same file the Python CLI
+ * maintains (default `~/.local/share/ai-hist/ai-history.db`, or
+ * `$AI_HIST_DB`); the Python tool stays the canonical sync engine.
+ *
+ * Trade-off vs better-sqlite3: sql.js loads the whole DB file into
+ * memory. Fine for the ai-hist scale (tens of thousands of rows, MBs
+ * of data); revisit if anyone hits millions.
+ */
+import initSqlJs from 'sql.js';
+import { readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Resolve the SQLite path the Python CLI writes to. */
+export function defaultDbPath() {
+    const fromEnv = process.env.AI_HIST_DB;
+    if (fromEnv && fromEnv.trim().length > 0)
+        return fromEnv;
+    return join(homedir(), '.local', 'share', 'ai-hist', 'ai-history.db');
+}
+let _sqlPromise = null;
+function getSqlJs() {
+    if (!_sqlPromise) {
+        _sqlPromise = initSqlJs();
+    }
+    return _sqlPromise;
+}
+/**
+ * Open an `AiHist` reader. Async because sql.js initializes its WASM
+ * runtime lazily. Each call reads the DB file from disk; the resulting
+ * instance is a snapshot — to see new prompts written by the Python sync,
+ * call `reload()` (or open a fresh instance).
+ */
+export async function openAiHist(opts = {}) {
+    const dbPath = opts.dbPath ?? defaultDbPath();
+    // Surface a clearer error than sql.js's bare "file not found" when the
+    // user hasn't run the Python sync at least once yet.
+    try {
+        statSync(dbPath);
+    }
+    catch {
+        throw new Error(`ai-hist database not found at ${dbPath}. Run \`ai-hist sync\` first ` +
+            `(see https://github.com/khaliqgant/ai-hist).`);
+    }
+    const SQL = await getSqlJs();
+    const fileBuffer = readFileSync(dbPath);
+    const db = new SQL.Database(fileBuffer);
+    return new AiHist(db, dbPath);
+}
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        source: row.source,
+        sessionId: row.session_id,
+        project: row.project,
+        prompt: row.prompt,
+        timestampMs: row.timestamp_ms,
+    };
+}
+function buildFilters(opts) {
+    const clauses = [];
+    const params = [];
+    if (opts.source) {
+        clauses.push('source = ?');
+        params.push(opts.source);
+    }
+    if (opts.project) {
+        clauses.push('project = ?');
+        params.push(opts.project);
+    }
+    if (typeof opts.beforeMs === 'number') {
+        clauses.push('timestamp_ms < ?');
+        params.push(opts.beforeMs);
+    }
+    return {
+        sql: clauses.length > 0 ? ` AND ${clauses.join(' AND ')}` : '',
+        params,
+    };
+}
+function runQuery(db, sql, params) {
+    const stmt = db.prepare(sql);
+    try {
+        stmt.bind(params);
+        const rows = [];
+        while (stmt.step()) {
+            rows.push(stmt.getAsObject());
+        }
+        return rows;
+    }
+    finally {
+        stmt.free();
+    }
+}
+export class AiHist {
+    db;
+    _dbPath;
+    closed = false;
+    /** @internal — use `openAiHist({ dbPath })` to construct. */
+    constructor(db, dbPath) {
+        this.db = db;
+        this._dbPath = dbPath;
+    }
+    get dbPath() {
+        return this._dbPath;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.db.close();
+        this.closed = true;
+    }
+    /** Most recent prompts, newest first. */
+    recent(opts = {}) {
+        const limit = opts.limit ?? 50;
+        const { sql, params } = buildFilters(opts);
+        return runQuery(this.db, `SELECT id, source, session_id, project, prompt, timestamp_ms
+       FROM history
+       WHERE 1=1${sql}
+       ORDER BY timestamp_ms DESC
+       LIMIT ?`, [...params, limit]).map(rowToEntry);
+    }
+    /**
+     * Group history into sessions, ordered by last activity (newest first).
+     * Sessions without a `session_id` are skipped.
+     */
+    listSessions(opts = {}) {
+        const limit = opts.limit ?? 50;
+        const { sql, params } = buildFilters(opts);
+        const rows = runQuery(this.db, `WITH filtered AS (
+        SELECT id, source, session_id, project, prompt, timestamp_ms
+        FROM history
+        WHERE session_id IS NOT NULL AND session_id != ''${sql}
+      )
+      SELECT
+        session_id,
+        source,
+        project,
+        prompt_count,
+        first_activity_ms,
+        last_activity_ms,
+        (SELECT prompt FROM filtered f2
+         WHERE f2.session_id = grouped.session_id
+         ORDER BY f2.timestamp_ms ASC LIMIT 1) AS first_prompt
+      FROM (
+        SELECT
+          session_id,
+          source,
+          project,
+          COUNT(*) AS prompt_count,
+          MIN(timestamp_ms) AS first_activity_ms,
+          MAX(timestamp_ms) AS last_activity_ms
+        FROM filtered
+        GROUP BY session_id, source, project
+      ) AS grouped
+      ORDER BY last_activity_ms DESC
+      LIMIT ?`, [...params, limit]);
+        return rows.map((row) => ({
+            sessionId: row.session_id,
+            source: row.source,
+            project: row.project,
+            firstPrompt: row.first_prompt,
+            lastActivityMs: row.last_activity_ms,
+            firstActivityMs: row.first_activity_ms,
+            promptCount: row.prompt_count,
+        }));
+    }
+    /** All prompts in a session, ordered oldest → newest. */
+    getSession(sessionId) {
+        return runQuery(this.db, `SELECT id, source, session_id, project, prompt, timestamp_ms
+       FROM history
+       WHERE session_id = ?
+       ORDER BY timestamp_ms ASC`, [sessionId]).map(rowToEntry);
+    }
+    /**
+     * Substring search across prompt + project, case-insensitive, recent
+     * matches first. The Python CLI uses FTS5; this SDK uses LIKE because
+     * sql.js's default WASM build doesn't ship the FTS5 module. Plenty fast
+     * for the ai-hist scale (~tens of thousands of rows); revisit if a
+     * future consumer needs phrase/boolean queries.
+     *
+     * The query is matched literally — `%` and `_` are escaped so users can
+     * search for them. Empty queries return an empty array.
+     */
+    search(query, opts = {}) {
+        const trimmed = query.trim();
+        if (!trimmed)
+            return [];
+        const limit = opts.limit ?? 50;
+        const escaped = trimmed.replace(/\\/g, '\\\\').replace(/%/g, '\\%').replace(/_/g, '\\_');
+        const pattern = `%${escaped}%`;
+        const clauses = [
+            `(LOWER(prompt) LIKE LOWER(?) ESCAPE '\\' OR LOWER(COALESCE(project, '')) LIKE LOWER(?) ESCAPE '\\')`,
+        ];
+        const params = [pattern, pattern];
+        if (opts.source) {
+            clauses.push('source = ?');
+            params.push(opts.source);
+        }
+        if (opts.project) {
+            clauses.push('project = ?');
+            params.push(opts.project);
+        }
+        if (typeof opts.beforeMs === 'number') {
+            clauses.push('timestamp_ms < ?');
+            params.push(opts.beforeMs);
+        }
+        return runQuery(this.db, `SELECT id, source, session_id, project, prompt, timestamp_ms
+       FROM history
+       WHERE ${clauses.join(' AND ')}
+       ORDER BY timestamp_ms DESC
+       LIMIT ?`, [...params, limit]).map(rowToEntry);
+    }
+    /** Counts + date range, mirroring `ai-hist stats`. */
+    stats() {
+        const total = runQuery(this.db, 'SELECT COUNT(*) AS c FROM history', [])[0]?.c ?? 0;
+        const bySourceRows = runQuery(this.db, 'SELECT source, COUNT(*) AS c FROM history GROUP BY source', []);
+        const bySource = {};
+        for (const row of bySourceRows) {
+            bySource[row.source] = row.c;
+        }
+        const byProject = runQuery(this.db, `SELECT project, COUNT(*) AS c FROM history
+       WHERE project IS NOT NULL AND project != ''
+       GROUP BY project ORDER BY c DESC LIMIT 10`, []).map((row) => ({ project: row.project, count: row.c }));
+        const range = runQuery(this.db, 'SELECT MIN(timestamp_ms) AS mn, MAX(timestamp_ms) AS mx FROM history', [])[0];
+        return {
+            total,
+            bySource,
+            byProject,
+            firstTimestampMs: range?.mn ?? null,
+            lastTimestampMs: range?.mx ?? null,
+        };
+    }
+}
+/**
+ * Resume command for an entry/session, matching what `ai-hist show` prints.
+ * Returns `null` for sources that don't have a resume affordance (relay).
+ */
+export function resumeCommand(entry) {
+    if (!entry.sessionId)
+        return null;
+    switch (entry.source) {
+        case 'claude':
+            return entry.project
+                ? `cd ${shellQuote(entry.project)} && claude --resume ${shellQuote(entry.sessionId)}`
+                : `claude --resume ${shellQuote(entry.sessionId)}`;
+        case 'codex':
+            return `codex resume ${shellQuote(entry.sessionId)}`;
+        case 'cursor':
+            return entry.project
+                ? `cd ${shellQuote(entry.project)} && cursor-agent --resume=${shellQuote(entry.sessionId)}`
+                : `cursor-agent --resume=${shellQuote(entry.sessionId)}`;
+        case 'relay':
+            return null;
+        default:
+            return null;
+    }
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_\-./]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "ai-hist",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for reading the ai-hist SQLite database (recent prompts, sessions, search).",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/ai-hist",
+    "directory": "sdk-ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test dist/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "sql.js": "^1.13.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.0",
+    "@types/sql.js": "^1.4.9",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}