dsh-web-search-pro 0.1.0

package/lib/store.js

@@ -0,0 +1,223 @@
+/**
+ * SQLite persistence for web-search-pro (node:sqlite, zero dependencies).
+ * Stores search queries + results, fetched page snapshots, and user-extended
+ * extraction rules (userscript-style). All methods are synchronous; writes are
+ * small and batched per call.
+ * @module web-search-pro/store
+ */
+import { DatabaseSync } from 'node:sqlite';
+import fs from 'node:fs';
+import path from 'node:path';
+import { uid } from "./util.js";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS queries (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL,
+  query TEXT,
+  engine TEXT,
+  platform TEXT,
+  url TEXT,
+  status TEXT NOT NULL,
+  ts TEXT NOT NULL,
+  detail TEXT
+);
+CREATE TABLE IF NOT EXISTS results (
+  id TEXT PRIMARY KEY,
+  query_id TEXT NOT NULL,
+  rank INTEGER NOT NULL,
+  url TEXT NOT NULL,
+  title TEXT,
+  snippet TEXT,
+  published TEXT,
+  engine TEXT,
+  extra TEXT
+);
+CREATE TABLE IF NOT EXISTS pages (
+  id TEXT PRIMARY KEY,
+  url TEXT UNIQUE NOT NULL,
+  title TEXT,
+  text TEXT,
+  html_path TEXT,
+  screenshot_path TEXT,
+  status INTEGER,
+  fetched_at TEXT NOT NULL,
+  source TEXT
+);
+CREATE TABLE IF NOT EXISTS rules (
+  hostname TEXT PRIMARY KEY,
+  content TEXT NOT NULL,
+  remove TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_results_query ON results(query_id);
+CREATE INDEX IF NOT EXISTS idx_queries_ts ON queries(ts);
+CREATE INDEX IF NOT EXISTS idx_queries_kind ON queries(kind);
+CREATE INDEX IF NOT EXISTS idx_pages_url ON pages(url);
+`;
+export class Store {
+    dbPath;
+    db;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+        fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        this.db = new DatabaseSync(dbPath);
+        this.db.exec('PRAGMA journal_mode = WAL');
+        this.db.exec(SCHEMA);
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch { /* already closed */ }
+    }
+    /** Record one operation (search / fetch / platform / snapshot). Returns its id. */
+    recordQuery(input) {
+        const id = input.id ?? uid();
+        const ts = new Date().toISOString();
+        this.db.prepare('INSERT OR REPLACE INTO queries (id, kind, query, engine, platform, url, status, ts, detail) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)').run(id, input.kind, input.query ?? null, input.engine ?? null, input.platform ?? null, input.url ?? null, input.status, ts, input.detail ?? null);
+        return id;
+    }
+    /** Look up a fresh cached search by (engine, normalized query). */
+    getCachedSearch(engine, normQuery, ttlSeconds) {
+        const row = this.db.prepare(`SELECT id, detail FROM queries
+       WHERE kind = 'search' AND engine = ? AND query = ? AND status = 'ok'
+         AND ts > ? ORDER BY ts DESC LIMIT 1`).get(engine, normQuery, new Date(Date.now() - ttlSeconds * 1000).toISOString());
+        if (!row)
+            return undefined;
+        return { id: row.id, ...row.detail != null ? { detail: row.detail } : {} };
+    }
+    recordResults(queryId, sources, engine) {
+        const stmt = this.db.prepare('INSERT OR REPLACE INTO results (id, query_id, rank, url, title, snippet, published, engine, extra) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)');
+        sources.forEach((s, i) => {
+            stmt.run(uid(), queryId, i, s.url, s.title ?? null, s.snippet ?? null, s.publishedAt ?? null, engine, s.extra ?? null);
+        });
+    }
+    resultsForQuery(queryId) {
+        return this.db.prepare('SELECT * FROM results WHERE query_id = ? ORDER BY rank ASC').all(queryId);
+    }
+    /** Fresh page snapshot by URL, or undefined. */
+    getPage(url, ttlSeconds) {
+        const row = this.db.prepare(`SELECT * FROM pages WHERE url = ? AND fetched_at > ? ORDER BY fetched_at DESC LIMIT 1`).get(url, new Date(Date.now() - ttlSeconds * 1000).toISOString());
+        return row;
+    }
+    savePage(input) {
+        this.db.prepare(`INSERT OR REPLACE INTO pages (id, url, title, text, html_path, screenshot_path, status, fetched_at, source)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(uid(), input.url, input.title ?? null, input.text ?? null, input.htmlPath ?? null, input.screenshotPath ?? null, input.status ?? null, new Date().toISOString(), input.source ?? null);
+    }
+    listQueries(opts) {
+        const limit = Math.min(Math.max(opts.limit ?? 20, 1), 200);
+        const clauses = [];
+        const params = [];
+        const kind = opts.kind;
+        if (kind) {
+            clauses.push('kind = ?');
+            params.push(kind);
+        }
+        const q = opts.query;
+        if (q) {
+            clauses.push('(query LIKE ? OR url LIKE ?)');
+            params.push(`%${q}%`, `%${q}%`);
+        }
+        const engine = opts.engine;
+        if (engine) {
+            clauses.push('engine = ?');
+            params.push(engine);
+        }
+        const platform = opts.platform;
+        if (platform) {
+            clauses.push('platform = ?');
+            params.push(platform);
+        }
+        const where = clauses.length ? 'WHERE ' + clauses.join(' AND ') : '';
+        return this.db.prepare(`SELECT * FROM queries ${where} ORDER BY ts DESC LIMIT ${limit}`).all(...params);
+    }
+    clearCache(opts) {
+        const cutoff = opts.olderThanDays
+            ? new Date(Date.now() - opts.olderThanDays * 86400_000).toISOString()
+            : undefined;
+        let removed = { queries: 0, results: 0, pages: 0 };
+        if (opts.olderThanDays === undefined) {
+            const engine = opts.engine;
+            if (engine) {
+                const ids = this.db.prepare(`SELECT id FROM queries WHERE engine = ?`).all(engine);
+                for (const r of ids)
+                    this.removeQuery(r.id);
+                removed.queries = ids.length;
+            }
+            else {
+                const q = this.db.prepare('SELECT COUNT(*) AS c FROM queries').get();
+                const r = this.db.prepare('SELECT COUNT(*) AS c FROM results').get();
+                const p = this.db.prepare('SELECT COUNT(*) AS c FROM pages').get();
+                this.db.exec('DELETE FROM results; DELETE FROM queries; DELETE FROM pages');
+                removed = { queries: q.c, results: r.c, pages: p.c };
+            }
+        }
+        else {
+            const engine = opts.engine;
+            const since = cutoff ?? new Date(0).toISOString();
+            const rows = engine
+                ? this.db.prepare(`SELECT id FROM queries WHERE ts < ? AND engine = ?`).all(since, engine)
+                : this.db.prepare(`SELECT id FROM queries WHERE ts < ?`).all(since);
+            for (const row of rows)
+                this.removeQuery(row.id);
+            const p = this.db.prepare(`SELECT COUNT(*) AS c FROM pages WHERE fetched_at < ?`).get(since);
+            this.db.prepare('DELETE FROM pages WHERE fetched_at < ?').run(since);
+            removed = { queries: rows.length, results: rows.length, pages: p.c };
+        }
+        return removed;
+    }
+    removeQuery(id) {
+        this.db.prepare('DELETE FROM results WHERE query_id = ?').run(id);
+        this.db.prepare('DELETE FROM queries WHERE id = ?').run(id);
+    }
+    /** Delete one query and its results; returns whether it existed. */
+    deleteQuery(id) {
+        const row = this.db.prepare('SELECT id FROM queries WHERE id = ?').get(id);
+        if (!row)
+            return false;
+        this.removeQuery(id);
+        return true;
+    }
+    /** Most-used engines, desc. */
+    topEngines(limit = 8) {
+        return this.db.prepare('SELECT engine, COUNT(*) AS count FROM queries WHERE engine IS NOT NULL GROUP BY engine ORDER BY count DESC LIMIT ?').all(limit);
+    }
+    /** Most-frequent queries, desc. */
+    topQueries(limit = 8) {
+        return this.db.prepare('SELECT query, COUNT(*) AS count FROM queries WHERE query IS NOT NULL GROUP BY query ORDER BY count DESC LIMIT ?').all(limit);
+    }
+    /** Per-kind record counts. */
+    kindCounts() {
+        return this.db.prepare('SELECT kind, COUNT(*) AS count FROM queries GROUP BY kind ORDER BY count DESC').all();
+    }
+    stats() {
+        const count = (sql) => this.db.prepare(sql).get().c;
+        let dbSizeBytes = 0;
+        try {
+            dbSizeBytes = fs.statSync(this.dbPath).size;
+        }
+        catch { /* not on disk (memory) */ }
+        return {
+            dbSizeBytes,
+            queries: count('SELECT COUNT(*) AS c FROM queries'),
+            results: count('SELECT COUNT(*) AS c FROM results'),
+            pages: count('SELECT COUNT(*) AS c FROM pages'),
+            rules: count('SELECT COUNT(*) AS c FROM rules'),
+        };
+    }
+    listRules() {
+        return this.db.prepare('SELECT * FROM rules ORDER BY hostname ASC').all();
+    }
+    upsertRule(hostname, content, remove) {
+        const now = new Date().toISOString();
+        this.db.prepare(`INSERT INTO rules (hostname, content, remove, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(hostname) DO UPDATE SET content = excluded.content, remove = excluded.remove, updated_at = excluded.updated_at`).run(hostname.toLowerCase(), content, remove ?? null, now, now);
+    }
+    removeRule(hostname) {
+        const res = this.db.prepare('DELETE FROM rules WHERE hostname = ?').run(hostname.toLowerCase());
+        return res.changes > 0;
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

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

package/lib/tools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool definitions for web-search-pro: 8 model-facing tools over the router,
+ * fetch service, store, and playwright manager.
+ * @module web-search-pro/tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SearchRouter } from './router.ts';
+import type { FetchService } from './fetch.ts';
+import type { Store } from './store.ts';
+import type { BrowserService } from './browser-service.ts';
+import type { ResolvedConfig } from './config.ts';
+export interface ToolDeps {
+    ctx: Context;
+    config: ResolvedConfig;
+    /** Hot-reloadable config source (settings.yaml overlay). */
+    dynamic: () => ResolvedConfig;
+    store: Store;
+    router: SearchRouter;
+    fetch: FetchService;
+    browser: BrowserService;
+}
+export declare function formatSources(sources: {
+    url: string;
+    title?: string;
+    snippet?: string;
+    publishedAt?: string;
+}[]): string;
+export declare function registerTools(deps: ToolDeps): void;