mcpscraper-memory-db 1.0.0

package/dist/db/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/notes.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\nimport { removeDocument } from '../rag/index-pipeline'\nimport { EMBED_DIM } from '../rag/embedder'\nimport { INDEX_NAME } from '../rag/vector-store'\n\nconst EMBED_BYTES_PER_CHUNK = EMBED_DIM * 4\n\nexport type NoteKind = 'note' | 'library' | 'capture' | 'decision' | 'message'\n\nexport type NoteProps = Record<string, unknown>\n\nexport interface NoteRecord {\n  id: string\n  vault: string\n  path: string\n  title: string\n  content: string\n  kind: NoteKind\n  source: string\n  props: NoteProps\n  capturedAt: string\n  createdAt: string\n  updatedAt: string\n  revision: number\n  updatedBy: string | null\n}\n\nexport interface RawNoteRow {\n  id: string\n  vault: string\n  path: string\n  title: string\n  content: string\n  kind: string\n  source: string\n  props: unknown\n  captured_at: string\n  created_at: string\n  updated_at: string\n  revision: number\n  updated_by: string | null\n}\n\nexport function noteId(vault: string, path: string): string {\n  return `${vault}::${path}`\n}\n\nexport function mapNote(r: RawNoteRow): NoteRecord {\n  return {\n    id: r.id,\n    vault: r.vault,\n    path: r.path,\n    title: r.title,\n    content: r.content,\n    kind: r.kind as NoteKind,\n    source: r.source,\n    props: (r.props && typeof r.props === 'object' ? (r.props as NoteProps) : {}),\n    capturedAt: r.captured_at,\n    createdAt: r.created_at,\n    updatedAt: r.updated_at,\n    revision: r.revision,\n    updatedBy: r.updated_by,\n  }\n}\n\nexport const NOTE_COLUMNS = 'id, vault, path, title, content, kind, source, props, captured_at, created_at, updated_at, revision, updated_by'\n\nexport interface PutNoteArgs {\n  vault: string\n  path: string\n  title?: string\n  content: string\n  kind?: NoteKind\n  source?: string\n  props?: NoteProps\n  capturedAt?: string\n  updatedBy?: string\n}\n\nexport async function putNoteRow(args: PutNoteArgs): Promise<NoteRecord> {\n  await ensureSchema()\n  const id = noteId(args.vault, args.path)\n  const res = await query<RawNoteRow>(\n    `INSERT INTO mem_notes (id, vault, path, title, content, kind, source, props, captured_at, updated_at, revision, updated_by)\n     VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, COALESCE($9::timestamptz, now()), now(), 1, $10)\n     ON CONFLICT (vault, path) DO UPDATE SET\n       title = EXCLUDED.title, content = EXCLUDED.content, kind = EXCLUDED.kind,\n       source = EXCLUDED.source, props = EXCLUDED.props, captured_at = EXCLUDED.captured_at,\n       updated_at = now(), revision = mem_notes.revision + 1, updated_by = EXCLUDED.updated_by\n     RETURNING ${NOTE_COLUMNS}`,\n    [id, args.vault, args.path, args.title ?? args.path, args.content, args.kind ?? 'note', args.source ?? '', JSON.stringify(args.props ?? {}), args.capturedAt ?? null, args.updatedBy ?? null],\n  )\n  return mapNote(res.rows[0])\n}\n\nexport type PutNoteCheckedResult = { ok: true; note: NoteRecord } | { ok: false; conflict: true; current: NoteRecord }\n\nexport async function putNoteRowChecked(args: PutNoteArgs & { baseRevision: number }): Promise<PutNoteCheckedResult> {\n  await ensureSchema()\n  const id = noteId(args.vault, args.path)\n  const res = await query<RawNoteRow>(\n    `INSERT INTO mem_notes (id, vault, path, title, content, kind, source, props, captured_at, updated_at, revision, updated_by)\n     VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, COALESCE($9::timestamptz, now()), now(), 1, $10)\n     ON CONFLICT (vault, path) DO UPDATE SET\n       title = EXCLUDED.title, content = EXCLUDED.content, kind = EXCLUDED.kind,\n       source = EXCLUDED.source, props = EXCLUDED.props, captured_at = EXCLUDED.captured_at,\n       updated_at = now(), revision = mem_notes.revision + 1, updated_by = EXCLUDED.updated_by\n     WHERE mem_notes.revision = $11\n     RETURNING ${NOTE_COLUMNS}`,\n    [id, args.vault, args.path, args.title ?? args.path, args.content, args.kind ?? 'note', args.source ?? '', JSON.stringify(args.props ?? {}), args.capturedAt ?? null, args.updatedBy ?? null, args.baseRevision],\n  )\n  if (res.rows[0]) return { ok: true, note: mapNote(res.rows[0]) }\n  const current = await getNoteRow(args.vault, args.path)\n  if (!current) return { ok: true, note: await putNoteRow(args) }\n  return { ok: false, conflict: true, current }\n}\n\nexport async function getNoteRow(vault: string, path: string): Promise<NoteRecord | null> {\n  await ensureSchema()\n  const res = await query<RawNoteRow>(\n    `SELECT ${NOTE_COLUMNS} FROM mem_notes WHERE vault = $1 AND path = $2 LIMIT 1`,\n    [vault, path],\n  )\n  return res.rows[0] ? mapNote(res.rows[0]) : null\n}\n\nexport async function getNoteById(id: string): Promise<NoteRecord | null> {\n  await ensureSchema()\n  const res = await query<RawNoteRow>(`SELECT ${NOTE_COLUMNS} FROM mem_notes WHERE id = $1 LIMIT 1`, [id])\n  return res.rows[0] ? mapNote(res.rows[0]) : null\n}\n\nexport async function listNoteRows(vault: string, kind?: NoteKind, tags?: string[]): Promise<NoteRecord[]> {\n  await ensureSchema()\n  const params: unknown[] = [vault]\n  let where = 'vault = $1'\n  if (kind) {\n    params.push(kind)\n    where += ` AND kind = $${params.length}`\n  }\n  if (tags && tags.length > 0) {\n    params.push(JSON.stringify(tags))\n    where += ` AND (props->'tags')::jsonb ?| ARRAY(SELECT jsonb_array_elements_text($${params.length}::jsonb))`\n  }\n  const res = await query<RawNoteRow>(\n    `SELECT ${NOTE_COLUMNS}\n     FROM mem_notes WHERE ${where} ORDER BY updated_at DESC`,\n    params,\n  )\n  return res.rows.map(mapNote)\n}\n\nexport async function listAllNoteRows(): Promise<NoteRecord[]> {\n  await ensureSchema()\n  const res = await query<RawNoteRow>(\n    `SELECT ${NOTE_COLUMNS} FROM mem_notes ORDER BY vault ASC, updated_at DESC`,\n  )\n  return res.rows.map(mapNote)\n}\n\nexport async function resolveNoteRefs(vault: string, refs: string[]): Promise<Map<string, NoteRecord>> {\n  const notes = await listNoteRows(vault)\n  const byPath = new Map(notes.map(n => [n.path, n]))\n  const byTitle = new Map(notes.map(n => [n.title.toLowerCase(), n]))\n  const resolved = new Map<string, NoteRecord>()\n  for (const ref of refs) {\n    const note = byPath.get(ref) ?? byTitle.get(ref.toLowerCase())\n    if (note) resolved.set(ref, note)\n  }\n  return resolved\n}\n\nexport async function exportVaultRows(vault: string): Promise<NoteRecord[]> {\n  return listNoteRows(vault)\n}\n\nexport async function captureRow(args: { vault: string; content: string; source: string; capturedAt?: string; title?: string; folder?: string; props?: NoteProps }): Promise<NoteRecord> {\n  const stamp = args.capturedAt ?? new Date().toISOString()\n  const base = `captures/${stamp.replace(/[:.]/g, '-')}`\n  const path = args.folder ? `${args.folder}/${base}` : base\n  return putNoteRow({\n    vault: args.vault,\n    path,\n    title: args.title ?? `Capture ${stamp}`,\n    content: args.content,\n    kind: 'capture',\n    source: args.source,\n    props: args.props,\n    capturedAt: stamp,\n  })\n}\n\nexport async function deleteNoteRow(vault: string, path: string): Promise<{ deleted: boolean }> {\n  await ensureSchema()\n  const res = await query(`DELETE FROM mem_notes WHERE vault = $1 AND path = $2`, [vault, path])\n  const deleted = (res.rowCount ?? 0) > 0\n  if (deleted) {\n    try {\n      await removeDocument({ vault, id: noteId(vault, path) })\n    } catch {\n      void 0\n    }\n  }\n  return { deleted }\n}\n\nexport type DeleteNoteCheckedResult = { ok: true; deleted: boolean } | { ok: false; conflict: true; current: NoteRecord }\n\nexport async function deleteNoteRowChecked(vault: string, path: string, baseRevision: number): Promise<DeleteNoteCheckedResult> {\n  await ensureSchema()\n  const res = await query(`DELETE FROM mem_notes WHERE vault = $1 AND path = $2 AND revision = $3`, [vault, path, baseRevision])\n  if ((res.rowCount ?? 0) > 0) {\n    try {\n      await removeDocument({ vault, id: noteId(vault, path) })\n    } catch {\n      void 0\n    }\n    return { ok: true, deleted: true }\n  }\n  const current = await getNoteRow(vault, path)\n  if (!current) return { ok: true, deleted: false }\n  return { ok: false, conflict: true, current }\n}\n\nexport async function deleteNotesForVault(vault: string): Promise<number> {\n  await ensureSchema()\n  const res = await query(`DELETE FROM mem_notes WHERE vault = $1`, [vault])\n  return res.rowCount ?? 0\n}\n\nexport interface VaultStorageResult {\n  perVault: { vault: string; bytes: number; notes: number }[]\n  totalBytes: number\n}\n\nexport async function vaultStorage(vaults?: string[]): Promise<VaultStorageResult> {\n  if (vaults && vaults.length === 0) return { perVault: [], totalBytes: 0 }\n  await ensureSchema()\n  const params: unknown[] = []\n  let where = ''\n  if (vaults && vaults.length > 0) {\n    params.push(vaults)\n    where = `WHERE vault = ANY($1)`\n  }\n  const res = await query<{ vault: string; notes: string; bytes: string }>(\n    `SELECT vault, COUNT(*)::int AS notes, COALESCE(SUM(octet_length(content)), 0)::bigint AS bytes\n     FROM mem_notes ${where} GROUP BY vault ORDER BY vault ASC`,\n    params,\n  )\n  const embedChunks = await embedChunksByVault(vaults)\n  const perVault = res.rows.map(r => {\n    const contentBytes = Number(r.bytes)\n    const embedBytes = (embedChunks.get(r.vault) ?? 0) * EMBED_BYTES_PER_CHUNK\n    return { vault: r.vault, bytes: contentBytes + embedBytes, notes: Number(r.notes) }\n  })\n  const totalBytes = perVault.reduce((sum, v) => sum + v.bytes, 0)\n  return { perVault, totalBytes }\n}\n\nasync function embedChunksByVault(vaults?: string[]): Promise<Map<string, number>> {\n  const out = new Map<string, number>()\n  if (vaults && vaults.length === 0) return out\n  const params: unknown[] = []\n  let where = ''\n  if (vaults && vaults.length > 0) {\n    params.push(vaults)\n    where = `WHERE metadata->>'vault' = ANY($1)`\n  }\n  try {\n    const res = await query<{ vault: string; chunks: string }>(\n      `SELECT metadata->>'vault' AS vault, COUNT(*)::bigint AS chunks\n       FROM \"${INDEX_NAME}\" ${where} GROUP BY 1`,\n      params,\n    )\n    for (const r of res.rows) if (r.vault) out.set(r.vault, Number(r.chunks))\n  } catch {\n    return out\n  }\n  return out\n}\n\nexport async function listCapturesInRange(args: { vault: string; from: string; to: string }): Promise<NoteRecord[]> {\n  await ensureSchema()\n  const res = await query<RawNoteRow>(\n    `SELECT ${NOTE_COLUMNS}\n     FROM mem_notes\n     WHERE vault = $1 AND captured_at >= $2::timestamptz AND captured_at <= $3::timestamptz\n     ORDER BY captured_at DESC`,\n    [args.vault, args.from, args.to],\n  )\n  return res.rows.map(mapNote)\n}\n\nexport interface SuggestHit {\n  vault: string\n  path: string\n  title: string\n  kind: NoteKind\n}\n\nexport async function suggestNotesAcrossVaults(vaults: string[], prefix: string, limit: number): Promise<SuggestHit[]> {\n  await ensureSchema()\n  if (vaults.length === 0 || !prefix.trim()) return []\n  const res = await query<{ vault: string; path: string; title: string; kind: string; rank: number }>(\n    `SELECT vault, path, title, kind,\n       CASE WHEN title ILIKE $2 || '%' THEN 0 ELSE 1 END AS rank\n     FROM mem_notes\n     WHERE vault = ANY($1) AND kind != 'message' AND title ILIKE '%' || $2 || '%'\n     ORDER BY rank ASC, updated_at DESC\n     LIMIT $3`,\n    [vaults, prefix.trim(), limit],\n  )\n  return res.rows.map(r => ({ vault: r.vault, path: r.path, title: r.title, kind: r.kind as NoteKind }))\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AACpC,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,MAAM,wBAAwB,YAAY;AAsCnC,SAAS,OAAO,OAAe,MAAsB;AAC1D,SAAO,GAAG,KAAK,KAAK,IAAI;AAC1B;AAEO,SAAS,QAAQ,GAA2B;AACjD,SAAO;AAAA,IACL,IAAI,EAAE;AAAA,IACN,OAAO,EAAE;AAAA,IACT,MAAM,EAAE;AAAA,IACR,OAAO,EAAE;AAAA,IACT,SAAS,EAAE;AAAA,IACX,MAAM,EAAE;AAAA,IACR,QAAQ,EAAE;AAAA,IACV,OAAQ,EAAE,SAAS,OAAO,EAAE,UAAU,WAAY,EAAE,QAAsB,CAAC;AAAA,IAC3E,YAAY,EAAE;AAAA,IACd,WAAW,EAAE;AAAA,IACb,WAAW,EAAE;AAAA,IACb,UAAU,EAAE;AAAA,IACZ,WAAW,EAAE;AAAA,EACf;AACF;AAEO,MAAM,eAAe;AAc5B,eAAsB,WAAW,MAAwC;AACvE,QAAM,aAAa;AACnB,QAAM,KAAK,OAAO,KAAK,OAAO,KAAK,IAAI;AACvC,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAMa,YAAY;AAAA,IACzB,CAAC,IAAI,KAAK,OAAO,KAAK,MAAM,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,KAAK,QAAQ,QAAQ,KAAK,UAAU,IAAI,KAAK,UAAU,KAAK,SAAS,CAAC,CAAC,GAAG,KAAK,cAAc,MAAM,KAAK,aAAa,IAAI;AAAA,EAC9L;AACA,SAAO,QAAQ,IAAI,KAAK,CAAC,CAAC;AAC5B;AAIA,eAAsB,kBAAkB,MAA6E;AACnH,QAAM,aAAa;AACnB,QAAM,KAAK,OAAO,KAAK,OAAO,KAAK,IAAI;AACvC,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAOa,YAAY;AAAA,IACzB,CAAC,IAAI,KAAK,OAAO,KAAK,MAAM,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,KAAK,QAAQ,QAAQ,KAAK,UAAU,IAAI,KAAK,UAAU,KAAK,SAAS,CAAC,CAAC,GAAG,KAAK,cAAc,MAAM,KAAK,aAAa,MAAM,KAAK,YAAY;AAAA,EACjN;AACA,MAAI,IAAI,KAAK,CAAC,EAAG,QAAO,EAAE,IAAI,MAAM,MAAM,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE;AAC/D,QAAM,UAAU,MAAM,WAAW,KAAK,OAAO,KAAK,IAAI;AACtD,MAAI,CAAC,QAAS,QAAO,EAAE,IAAI,MAAM,MAAM,MAAM,WAAW,IAAI,EAAE;AAC9D,SAAO,EAAE,IAAI,OAAO,UAAU,MAAM,QAAQ;AAC9C;AAEA,eAAsB,WAAW,OAAe,MAA0C;AACxF,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB,UAAU,YAAY;AAAA,IACtB,CAAC,OAAO,IAAI;AAAA,EACd;AACA,SAAO,IAAI,KAAK,CAAC,IAAI,QAAQ,IAAI,KAAK,CAAC,CAAC,IAAI;AAC9C;AAEA,eAAsB,YAAY,IAAwC;AACxE,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM,MAAkB,UAAU,YAAY,yCAAyC,CAAC,EAAE,CAAC;AACvG,SAAO,IAAI,KAAK,CAAC,IAAI,QAAQ,IAAI,KAAK,CAAC,CAAC,IAAI;AAC9C;AAEA,eAAsB,aAAa,OAAe,MAAiB,MAAwC;AACzG,QAAM,aAAa;AACnB,QAAM,SAAoB,CAAC,KAAK;AAChC,MAAI,QAAQ;AACZ,MAAI,MAAM;AACR,WAAO,KAAK,IAAI;AAChB,aAAS,gBAAgB,OAAO,MAAM;AAAA,EACxC;AACA,MAAI,QAAQ,KAAK,SAAS,GAAG;AAC3B,WAAO,KAAK,KAAK,UAAU,IAAI,CAAC;AAChC,aAAS,0EAA0E,OAAO,MAAM;AAAA,EAClG;AACA,QAAM,MAAM,MAAM;AAAA,IAChB,UAAU,YAAY;AAAA,4BACE,KAAK;AAAA,IAC7B;AAAA,EACF;AACA,SAAO,IAAI,KAAK,IAAI,OAAO;AAC7B;AAEA,eAAsB,kBAAyC;AAC7D,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB,UAAU,YAAY;AAAA,EACxB;AACA,SAAO,IAAI,KAAK,IAAI,OAAO;AAC7B;AAEA,eAAsB,gBAAgB,OAAe,MAAkD;AACrG,QAAM,QAAQ,MAAM,aAAa,KAAK;AACtC,QAAM,SAAS,IAAI,IAAI,MAAM,IAAI,OAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,QAAM,UAAU,IAAI,IAAI,MAAM,IAAI,OAAK,CAAC,EAAE,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC;AAClE,QAAM,WAAW,oBAAI,IAAwB;AAC7C,aAAW,OAAO,MAAM;AACtB,UAAM,OAAO,OAAO,IAAI,GAAG,KAAK,QAAQ,IAAI,IAAI,YAAY,CAAC;AAC7D,QAAI,KAAM,UAAS,IAAI,KAAK,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAEA,eAAsB,gBAAgB,OAAsC;AAC1E,SAAO,aAAa,KAAK;AAC3B;AAEA,eAAsB,WAAW,MAAwJ;AACvL,QAAM,QAAQ,KAAK,eAAc,oBAAI,KAAK,GAAE,YAAY;AACxD,QAAM,OAAO,YAAY,MAAM,QAAQ,SAAS,GAAG,CAAC;AACpD,QAAM,OAAO,KAAK,SAAS,GAAG,KAAK,MAAM,IAAI,IAAI,KAAK;AACtD,SAAO,WAAW;AAAA,IAChB,OAAO,KAAK;AAAA,IACZ;AAAA,IACA,OAAO,KAAK,SAAS,WAAW,KAAK;AAAA,IACrC,SAAS,KAAK;AAAA,IACd,MAAM;AAAA,IACN,QAAQ,KAAK;AAAA,IACb,OAAO,KAAK;AAAA,IACZ,YAAY;AAAA,EACd,CAAC;AACH;AAEA,eAAsB,cAAc,OAAe,MAA6C;AAC9F,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM,MAAM,wDAAwD,CAAC,OAAO,IAAI,CAAC;AAC7F,QAAM,WAAW,IAAI,YAAY,KAAK;AACtC,MAAI,SAAS;AACX,QAAI;AACF,YAAM,eAAe,EAAE,OAAO,IAAI,OAAO,OAAO,IAAI,EAAE,CAAC;AAAA,IACzD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,EAAE,QAAQ;AACnB;AAIA,eAAsB,qBAAqB,OAAe,MAAc,cAAwD;AAC9H,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM,MAAM,0EAA0E,CAAC,OAAO,MAAM,YAAY,CAAC;AAC7H,OAAK,IAAI,YAAY,KAAK,GAAG;AAC3B,QAAI;AACF,YAAM,eAAe,EAAE,OAAO,IAAI,OAAO,OAAO,IAAI,EAAE,CAAC;AAAA,IACzD,QAAQ;AAAA,IAER;AACA,WAAO,EAAE,IAAI,MAAM,SAAS,KAAK;AAAA,EACnC;AACA,QAAM,UAAU,MAAM,WAAW,OAAO,IAAI;AAC5C,MAAI,CAAC,QAAS,QAAO,EAAE,IAAI,MAAM,SAAS,MAAM;AAChD,SAAO,EAAE,IAAI,OAAO,UAAU,MAAM,QAAQ;AAC9C;AAEA,eAAsB,oBAAoB,OAAgC;AACxE,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM,MAAM,0CAA0C,CAAC,KAAK,CAAC;AACzE,SAAO,IAAI,YAAY;AACzB;AAOA,eAAsB,aAAa,QAAgD;AACjF,MAAI,UAAU,OAAO,WAAW,EAAG,QAAO,EAAE,UAAU,CAAC,GAAG,YAAY,EAAE;AACxE,QAAM,aAAa;AACnB,QAAM,SAAoB,CAAC;AAC3B,MAAI,QAAQ;AACZ,MAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,WAAO,KAAK,MAAM;AAClB,YAAQ;AAAA,EACV;AACA,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA,sBACkB,KAAK;AAAA,IACvB;AAAA,EACF;AACA,QAAM,cAAc,MAAM,mBAAmB,MAAM;AACnD,QAAM,WAAW,IAAI,KAAK,IAAI,OAAK;AACjC,UAAM,eAAe,OAAO,EAAE,KAAK;AACnC,UAAM,cAAc,YAAY,IAAI,EAAE,KAAK,KAAK,KAAK;AACrD,WAAO,EAAE,OAAO,EAAE,OAAO,OAAO,eAAe,YAAY,OAAO,OAAO,EAAE,KAAK,EAAE;AAAA,EACpF,CAAC;AACD,QAAM,aAAa,SAAS,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,OAAO,CAAC;AAC/D,SAAO,EAAE,UAAU,WAAW;AAChC;AAEA,eAAe,mBAAmB,QAAiD;AACjF,QAAM,MAAM,oBAAI,IAAoB;AACpC,MAAI,UAAU,OAAO,WAAW,EAAG,QAAO;AAC1C,QAAM,SAAoB,CAAC;AAC3B,MAAI,QAAQ;AACZ,MAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,WAAO,KAAK,MAAM;AAClB,YAAQ;AAAA,EACV;AACA,MAAI;AACF,UAAM,MAAM,MAAM;AAAA,MAChB;AAAA,eACS,UAAU,KAAK,KAAK;AAAA,MAC7B;AAAA,IACF;AACA,eAAW,KAAK,IAAI,KAAM,KAAI,EAAE,MAAO,KAAI,IAAI,EAAE,OAAO,OAAO,EAAE,MAAM,CAAC;AAAA,EAC1E,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,eAAsB,oBAAoB,MAA0E;AAClH,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB,UAAU,YAAY;AAAA;AAAA;AAAA;AAAA,IAItB,CAAC,KAAK,OAAO,KAAK,MAAM,KAAK,EAAE;AAAA,EACjC;AACA,SAAO,IAAI,KAAK,IAAI,OAAO;AAC7B;AASA,eAAsB,yBAAyB,QAAkB,QAAgB,OAAsC;AACrH,QAAM,aAAa;AACnB,MAAI,OAAO,WAAW,KAAK,CAAC,OAAO,KAAK,EAAG,QAAO,CAAC;AACnD,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,CAAC,QAAQ,OAAO,KAAK,GAAG,KAAK;AAAA,EAC/B;AACA,SAAO,IAAI,KAAK,IAAI,QAAM,EAAE,OAAO,EAAE,OAAO,MAAM,EAAE,MAAM,OAAO,EAAE,OAAO,MAAM,EAAE,KAAiB,EAAE;AACvG;","names":[]}

package/dist/db/pool.d.ts

@@ -0,0 +1,7 @@
+import pg from 'pg';
+
+declare function getPool(): pg.Pool;
+declare function query<T extends pg.QueryResultRow = pg.QueryResultRow>(text: string, params?: ReadonlyArray<unknown>): Promise<pg.QueryResult<T>>;
+declare function ensureSchema(): Promise<void>;
+
+export { ensureSchema, getPool, query };

package/dist/db/pool.js

@@ -0,0 +1,37 @@
+import pg from "pg";
+pg.types.setTypeParser(1184, (value) => value);
+pg.types.setTypeParser(1114, (value) => value);
+pg.types.setTypeParser(1082, (value) => value);
+let poolSingleton = null;
+function getPool() {
+  if (poolSingleton) return poolSingleton;
+  const connectionString = process.env.DATABASE_URL;
+  if (!connectionString) {
+    throw new Error("DATABASE_URL is not set. mcp-memory requires an external Neon/Postgres connection string.");
+  }
+  poolSingleton = new pg.Pool({
+    connectionString,
+    max: 5,
+    ssl: connectionString.includes("localhost") ? void 0 : { rejectUnauthorized: false }
+  });
+  return poolSingleton;
+}
+async function query(text, params = []) {
+  const pool = getPool();
+  return pool.query(text, params);
+}
+let schemaReady = null;
+function ensureSchema() {
+  if (schemaReady) return schemaReady;
+  schemaReady = (async () => {
+    const { schemaSql } = await import("./schema");
+    await query(schemaSql);
+  })();
+  return schemaReady;
+}
+export {
+  ensureSchema,
+  getPool,
+  query
+};
+//# sourceMappingURL=pool.js.map

package/dist/db/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/pool.ts"],"sourcesContent":["import pg from 'pg'\n\npg.types.setTypeParser(1184, (value: string) => value)\npg.types.setTypeParser(1114, (value: string) => value)\npg.types.setTypeParser(1082, (value: string) => value)\n\nlet poolSingleton: pg.Pool | null = null\n\nexport function getPool(): pg.Pool {\n  if (poolSingleton) return poolSingleton\n  const connectionString = process.env.DATABASE_URL\n  if (!connectionString) {\n    throw new Error('DATABASE_URL is not set. mcp-memory requires an external Neon/Postgres connection string.')\n  }\n  poolSingleton = new pg.Pool({\n    connectionString,\n    max: 5,\n    ssl: connectionString.includes('localhost') ? undefined : { rejectUnauthorized: false },\n  })\n  return poolSingleton\n}\n\nexport async function query<T extends pg.QueryResultRow = pg.QueryResultRow>(\n  text: string,\n  params: ReadonlyArray<unknown> = [],\n): Promise<pg.QueryResult<T>> {\n  const pool = getPool()\n  return pool.query<T>(text, params as unknown[])\n}\n\nlet schemaReady: Promise<void> | null = null\n\nexport function ensureSchema(): Promise<void> {\n  if (schemaReady) return schemaReady\n  schemaReady = (async () => {\n    const { schemaSql } = await import('./schema')\n    await query(schemaSql)\n  })()\n  return schemaReady\n}\n"],"mappings":"AAAA,OAAO,QAAQ;AAEf,GAAG,MAAM,cAAc,MAAM,CAAC,UAAkB,KAAK;AACrD,GAAG,MAAM,cAAc,MAAM,CAAC,UAAkB,KAAK;AACrD,GAAG,MAAM,cAAc,MAAM,CAAC,UAAkB,KAAK;AAErD,IAAI,gBAAgC;AAE7B,SAAS,UAAmB;AACjC,MAAI,cAAe,QAAO;AAC1B,QAAM,mBAAmB,QAAQ,IAAI;AACrC,MAAI,CAAC,kBAAkB;AACrB,UAAM,IAAI,MAAM,2FAA2F;AAAA,EAC7G;AACA,kBAAgB,IAAI,GAAG,KAAK;AAAA,IAC1B;AAAA,IACA,KAAK;AAAA,IACL,KAAK,iBAAiB,SAAS,WAAW,IAAI,SAAY,EAAE,oBAAoB,MAAM;AAAA,EACxF,CAAC;AACD,SAAO;AACT;AAEA,eAAsB,MACpB,MACA,SAAiC,CAAC,GACN;AAC5B,QAAM,OAAO,QAAQ;AACrB,SAAO,KAAK,MAAS,MAAM,MAAmB;AAChD;AAEA,IAAI,cAAoC;AAEjC,SAAS,eAA8B;AAC5C,MAAI,YAAa,QAAO;AACxB,iBAAe,YAAY;AACzB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,UAAU;AAC7C,UAAM,MAAM,SAAS;AAAA,EACvB,GAAG;AACH,SAAO;AACT;","names":[]}

package/dist/db/presence.d.ts

@@ -0,0 +1,4 @@
+declare function touchPresence(noteId: string, identity: string): Promise<void>;
+declare function othersPresent(noteId: string, identity: string): Promise<string[]>;
+
+export { othersPresent, touchPresence };

package/dist/db/presence.js

@@ -0,0 +1,25 @@
+import { ensureSchema, query } from "./pool";
+const PRESENCE_TTL_SECONDS = 120;
+async function touchPresence(noteId, identity) {
+  await ensureSchema();
+  await query(
+    `INSERT INTO mem_note_presence (note_id, identity, heartbeat_at)
+     VALUES ($1, $2, now())
+     ON CONFLICT (note_id, identity) DO UPDATE SET heartbeat_at = now()`,
+    [noteId, identity]
+  );
+}
+async function othersPresent(noteId, identity) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT identity FROM mem_note_presence
+     WHERE note_id = $1 AND identity != $2 AND heartbeat_at > now() - interval '${PRESENCE_TTL_SECONDS} seconds'`,
+    [noteId, identity]
+  );
+  return res.rows.map((r) => r.identity);
+}
+export {
+  othersPresent,
+  touchPresence
+};
+//# sourceMappingURL=presence.js.map

package/dist/db/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/presence.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\n\nconst PRESENCE_TTL_SECONDS = 120\n\nexport async function touchPresence(noteId: string, identity: string): Promise<void> {\n  await ensureSchema()\n  await query(\n    `INSERT INTO mem_note_presence (note_id, identity, heartbeat_at)\n     VALUES ($1, $2, now())\n     ON CONFLICT (note_id, identity) DO UPDATE SET heartbeat_at = now()`,\n    [noteId, identity],\n  )\n}\n\nexport async function othersPresent(noteId: string, identity: string): Promise<string[]> {\n  await ensureSchema()\n  const res = await query<{ identity: string }>(\n    `SELECT identity FROM mem_note_presence\n     WHERE note_id = $1 AND identity != $2 AND heartbeat_at > now() - interval '${PRESENCE_TTL_SECONDS} seconds'`,\n    [noteId, identity],\n  )\n  return res.rows.map(r => r.identity)\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AAEpC,MAAM,uBAAuB;AAE7B,eAAsB,cAAc,QAAgB,UAAiC;AACnF,QAAM,aAAa;AACnB,QAAM;AAAA,IACJ;AAAA;AAAA;AAAA,IAGA,CAAC,QAAQ,QAAQ;AAAA,EACnB;AACF;AAEA,eAAsB,cAAc,QAAgB,UAAqC;AACvF,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA,kFAC8E,oBAAoB;AAAA,IAClG,CAAC,QAAQ,QAAQ;AAAA,EACnB;AACA,SAAO,IAAI,KAAK,IAAI,OAAK,EAAE,QAAQ;AACrC;","names":[]}

package/dist/db/props-snapshots.d.ts

@@ -0,0 +1,18 @@
+interface PropsSnapshotRecord {
+    id: number;
+    vault: string;
+    path: string;
+    prevProps: Record<string, unknown>;
+    runId: string | null;
+    createdAt: string;
+}
+declare function snapshotProps(args: {
+    vault: string;
+    path: string;
+    prevProps: Record<string, unknown>;
+    runId?: string;
+}): Promise<void>;
+declare function listPropsSnapshots(vault: string, path: string, limit?: number): Promise<PropsSnapshotRecord[]>;
+declare function pruneOldPropsSnapshots(retentionDays?: number): Promise<number>;
+
+export { type PropsSnapshotRecord, listPropsSnapshots, pruneOldPropsSnapshots, snapshotProps };

package/dist/db/props-snapshots.js

@@ -0,0 +1,37 @@
+import { ensureSchema, query } from "./pool";
+function mapRow(r) {
+  return {
+    id: r.id,
+    vault: r.vault,
+    path: r.path,
+    prevProps: r.prev_props && typeof r.prev_props === "object" ? r.prev_props : {},
+    runId: r.run_id,
+    createdAt: r.created_at
+  };
+}
+async function snapshotProps(args) {
+  await ensureSchema();
+  await query(
+    `INSERT INTO mem_props_snapshots (vault, path, prev_props, run_id) VALUES ($1, $2, $3, $4)`,
+    [args.vault, args.path, JSON.stringify(args.prevProps ?? {}), args.runId ?? null]
+  );
+}
+async function listPropsSnapshots(vault, path, limit = 20) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT id, vault, path, prev_props, run_id, created_at FROM mem_props_snapshots WHERE vault = $1 AND path = $2 ORDER BY created_at DESC LIMIT $3`,
+    [vault, path, limit]
+  );
+  return res.rows.map(mapRow);
+}
+async function pruneOldPropsSnapshots(retentionDays = 30) {
+  await ensureSchema();
+  const res = await query(`DELETE FROM mem_props_snapshots WHERE created_at < now() - ($1 || ' days')::interval`, [retentionDays]);
+  return res.rowCount ?? 0;
+}
+export {
+  listPropsSnapshots,
+  pruneOldPropsSnapshots,
+  snapshotProps
+};
+//# sourceMappingURL=props-snapshots.js.map

package/dist/db/props-snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/props-snapshots.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\n\nexport interface PropsSnapshotRecord {\n  id: number\n  vault: string\n  path: string\n  prevProps: Record<string, unknown>\n  runId: string | null\n  createdAt: string\n}\n\ninterface RawRow {\n  id: number\n  vault: string\n  path: string\n  prev_props: unknown\n  run_id: string | null\n  created_at: string\n}\n\nfunction mapRow(r: RawRow): PropsSnapshotRecord {\n  return {\n    id: r.id,\n    vault: r.vault,\n    path: r.path,\n    prevProps: r.prev_props && typeof r.prev_props === 'object' ? (r.prev_props as Record<string, unknown>) : {},\n    runId: r.run_id,\n    createdAt: r.created_at,\n  }\n}\n\nexport async function snapshotProps(args: {\n  vault: string\n  path: string\n  prevProps: Record<string, unknown>\n  runId?: string\n}): Promise<void> {\n  await ensureSchema()\n  await query(\n    `INSERT INTO mem_props_snapshots (vault, path, prev_props, run_id) VALUES ($1, $2, $3, $4)`,\n    [args.vault, args.path, JSON.stringify(args.prevProps ?? {}), args.runId ?? null],\n  )\n}\n\nexport async function listPropsSnapshots(vault: string, path: string, limit = 20): Promise<PropsSnapshotRecord[]> {\n  await ensureSchema()\n  const res = await query<RawRow>(\n    `SELECT id, vault, path, prev_props, run_id, created_at FROM mem_props_snapshots WHERE vault = $1 AND path = $2 ORDER BY created_at DESC LIMIT $3`,\n    [vault, path, limit],\n  )\n  return res.rows.map(mapRow)\n}\n\nexport async function pruneOldPropsSnapshots(retentionDays = 30): Promise<number> {\n  await ensureSchema()\n  const res = await query(`DELETE FROM mem_props_snapshots WHERE created_at < now() - ($1 || ' days')::interval`, [retentionDays])\n  return res.rowCount ?? 0\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AAoBpC,SAAS,OAAO,GAAgC;AAC9C,SAAO;AAAA,IACL,IAAI,EAAE;AAAA,IACN,OAAO,EAAE;AAAA,IACT,MAAM,EAAE;AAAA,IACR,WAAW,EAAE,cAAc,OAAO,EAAE,eAAe,WAAY,EAAE,aAAyC,CAAC;AAAA,IAC3G,OAAO,EAAE;AAAA,IACT,WAAW,EAAE;AAAA,EACf;AACF;AAEA,eAAsB,cAAc,MAKlB;AAChB,QAAM,aAAa;AACnB,QAAM;AAAA,IACJ;AAAA,IACA,CAAC,KAAK,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,aAAa,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI;AAAA,EAClF;AACF;AAEA,eAAsB,mBAAmB,OAAe,MAAc,QAAQ,IAAoC;AAChH,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA,IACA,CAAC,OAAO,MAAM,KAAK;AAAA,EACrB;AACA,SAAO,IAAI,KAAK,IAAI,MAAM;AAC5B;AAEA,eAAsB,uBAAuB,gBAAgB,IAAqB;AAChF,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM,MAAM,wFAAwF,CAAC,aAAa,CAAC;AAC/H,SAAO,IAAI,YAAY;AACzB;","names":[]}

package/dist/db/provenance.d.ts

@@ -0,0 +1,26 @@
+interface ProvenanceEntry {
+    keyId: string | null;
+    identity: string;
+    session: string | null;
+    op: string;
+    target?: string;
+    detail?: Record<string, unknown>;
+}
+declare function logProvenance(entry: ProvenanceEntry): Promise<void>;
+interface ProvenanceRow {
+    id: string;
+    keyId: string | null;
+    identity: string;
+    session: string | null;
+    op: string;
+    target: string | null;
+    detail: Record<string, unknown>;
+    ts: string;
+}
+declare function listProvenance(filter: {
+    identity?: string;
+    op?: string;
+    limit?: number;
+}): Promise<ProvenanceRow[]>;
+
+export { type ProvenanceEntry, type ProvenanceRow, listProvenance, logProvenance };

package/dist/db/provenance.js

@@ -0,0 +1,43 @@
+import { ensureSchema, query } from "./pool";
+async function logProvenance(entry) {
+  await ensureSchema();
+  await query(
+    `INSERT INTO mem_provenance (key_id, identity, session, op, target, detail)
+     VALUES ($1, $2, $3, $4, $5, $6::jsonb)`,
+    [entry.keyId, entry.identity, entry.session ?? null, entry.op, entry.target ?? null, JSON.stringify(entry.detail ?? {})]
+  );
+}
+async function listProvenance(filter) {
+  await ensureSchema();
+  const clauses = [];
+  const params = [];
+  if (filter.identity) {
+    params.push(filter.identity);
+    clauses.push(`identity = $${params.length}`);
+  }
+  if (filter.op) {
+    params.push(filter.op);
+    clauses.push(`op = $${params.length}`);
+  }
+  const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+  params.push(Math.min(filter.limit ?? 100, 1e3));
+  const res = await query(
+    `SELECT id, key_id, identity, session, op, target, detail, ts FROM mem_provenance ${where} ORDER BY ts DESC LIMIT $${params.length}`,
+    params
+  );
+  return res.rows.map((r) => ({
+    id: String(r.id),
+    keyId: r.key_id,
+    identity: r.identity,
+    session: r.session,
+    op: r.op,
+    target: r.target,
+    detail: r.detail,
+    ts: r.ts
+  }));
+}
+export {
+  listProvenance,
+  logProvenance
+};
+//# sourceMappingURL=provenance.js.map

package/dist/db/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/provenance.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\n\nexport interface ProvenanceEntry {\n  keyId: string | null\n  identity: string\n  session: string | null\n  op: string\n  target?: string\n  detail?: Record<string, unknown>\n}\n\nexport async function logProvenance(entry: ProvenanceEntry): Promise<void> {\n  await ensureSchema()\n  await query(\n    `INSERT INTO mem_provenance (key_id, identity, session, op, target, detail)\n     VALUES ($1, $2, $3, $4, $5, $6::jsonb)`,\n    [entry.keyId, entry.identity, entry.session ?? null, entry.op, entry.target ?? null, JSON.stringify(entry.detail ?? {})],\n  )\n}\n\nexport interface ProvenanceRow {\n  id: string\n  keyId: string | null\n  identity: string\n  session: string | null\n  op: string\n  target: string | null\n  detail: Record<string, unknown>\n  ts: string\n}\n\ninterface RawProvRow {\n  id: string\n  key_id: string | null\n  identity: string\n  session: string | null\n  op: string\n  target: string | null\n  detail: Record<string, unknown>\n  ts: string\n}\n\nexport async function listProvenance(filter: { identity?: string; op?: string; limit?: number }): Promise<ProvenanceRow[]> {\n  await ensureSchema()\n  const clauses: string[] = []\n  const params: unknown[] = []\n  if (filter.identity) {\n    params.push(filter.identity)\n    clauses.push(`identity = $${params.length}`)\n  }\n  if (filter.op) {\n    params.push(filter.op)\n    clauses.push(`op = $${params.length}`)\n  }\n  const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : ''\n  params.push(Math.min(filter.limit ?? 100, 1000))\n  const res = await query<RawProvRow>(\n    `SELECT id, key_id, identity, session, op, target, detail, ts FROM mem_provenance ${where} ORDER BY ts DESC LIMIT $${params.length}`,\n    params,\n  )\n  return res.rows.map(r => ({\n    id: String(r.id),\n    keyId: r.key_id,\n    identity: r.identity,\n    session: r.session,\n    op: r.op,\n    target: r.target,\n    detail: r.detail,\n    ts: r.ts,\n  }))\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AAWpC,eAAsB,cAAc,OAAuC;AACzE,QAAM,aAAa;AACnB,QAAM;AAAA,IACJ;AAAA;AAAA,IAEA,CAAC,MAAM,OAAO,MAAM,UAAU,MAAM,WAAW,MAAM,MAAM,IAAI,MAAM,UAAU,MAAM,KAAK,UAAU,MAAM,UAAU,CAAC,CAAC,CAAC;AAAA,EACzH;AACF;AAwBA,eAAsB,eAAe,QAAsF;AACzH,QAAM,aAAa;AACnB,QAAM,UAAoB,CAAC;AAC3B,QAAM,SAAoB,CAAC;AAC3B,MAAI,OAAO,UAAU;AACnB,WAAO,KAAK,OAAO,QAAQ;AAC3B,YAAQ,KAAK,eAAe,OAAO,MAAM,EAAE;AAAA,EAC7C;AACA,MAAI,OAAO,IAAI;AACb,WAAO,KAAK,OAAO,EAAE;AACrB,YAAQ,KAAK,SAAS,OAAO,MAAM,EAAE;AAAA,EACvC;AACA,QAAM,QAAQ,QAAQ,SAAS,SAAS,QAAQ,KAAK,OAAO,CAAC,KAAK;AAClE,SAAO,KAAK,KAAK,IAAI,OAAO,SAAS,KAAK,GAAI,CAAC;AAC/C,QAAM,MAAM,MAAM;AAAA,IAChB,oFAAoF,KAAK,4BAA4B,OAAO,MAAM;AAAA,IAClI;AAAA,EACF;AACA,SAAO,IAAI,KAAK,IAAI,QAAM;AAAA,IACxB,IAAI,OAAO,EAAE,EAAE;AAAA,IACf,OAAO,EAAE;AAAA,IACT,UAAU,EAAE;AAAA,IACZ,SAAS,EAAE;AAAA,IACX,IAAI,EAAE;AAAA,IACN,QAAQ,EAAE;AAAA,IACV,QAAQ,EAAE;AAAA,IACV,IAAI,EAAE;AAAA,EACR,EAAE;AACJ;","names":[]}

package/dist/db/schedule-entitlements.d.ts

@@ -0,0 +1,24 @@
+interface ScheduleEntitlement {
+    identity: string;
+    enabled: boolean;
+    quotaPerPeriod: number;
+    usedThisPeriod: number;
+    periodStart: string;
+}
+declare function getEntitlement(identity: string): Promise<ScheduleEntitlement | null>;
+declare function setEntitlement(args: {
+    identity: string;
+    enabled: boolean;
+    quotaPerPeriod?: number;
+    scraperApiKey?: string;
+}): Promise<void>;
+declare function getScraperApiKey(identity: string): Promise<string | null>;
+type ConsumeQuotaResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'not_enabled' | 'quota_exceeded';
+};
+declare function tryConsumeQuota(identity: string): Promise<ConsumeQuotaResult>;
+
+export { type ConsumeQuotaResult, type ScheduleEntitlement, getEntitlement, getScraperApiKey, setEntitlement, tryConsumeQuota };

package/dist/db/schedule-entitlements.js

@@ -0,0 +1,70 @@
+import { ensureSchema, query } from "./pool";
+import { encryptSecret, decryptSecret } from "../lib/secret-crypto";
+function mapRow(r) {
+  return {
+    identity: r.identity,
+    enabled: r.enabled,
+    quotaPerPeriod: r.quota_per_period,
+    usedThisPeriod: r.used_this_period,
+    periodStart: r.period_start
+  };
+}
+async function rollPeriodIfNeeded(identity) {
+  await query(
+    `UPDATE mem_schedule_entitlements
+     SET used_this_period = 0, period_start = date_trunc('month', now())::date, updated_at = now()
+     WHERE identity = $1 AND period_start < date_trunc('month', now())::date`,
+    [identity]
+  );
+}
+async function getEntitlement(identity) {
+  await ensureSchema();
+  await rollPeriodIfNeeded(identity);
+  const res = await query(`SELECT * FROM mem_schedule_entitlements WHERE identity = $1 LIMIT 1`, [identity]);
+  return res.rows[0] ? mapRow(res.rows[0]) : null;
+}
+async function setEntitlement(args) {
+  await ensureSchema();
+  const scraperApiKeyEnc = args.scraperApiKey ? encryptSecret(args.scraperApiKey) : null;
+  await query(
+    `INSERT INTO mem_schedule_entitlements (identity, enabled, quota_per_period, used_this_period, period_start, scraper_api_key_enc)
+     VALUES ($1, $2, $3, 0, date_trunc('month', now())::date, $4)
+     ON CONFLICT (identity) DO UPDATE SET
+       enabled = EXCLUDED.enabled,
+       quota_per_period = COALESCE($3, mem_schedule_entitlements.quota_per_period),
+       scraper_api_key_enc = COALESCE($4, mem_schedule_entitlements.scraper_api_key_enc),
+       updated_at = now()`,
+    [args.identity, args.enabled, args.quotaPerPeriod ?? 1e3, scraperApiKeyEnc]
+  );
+}
+async function getScraperApiKey(identity) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT scraper_api_key_enc FROM mem_schedule_entitlements WHERE identity = $1 LIMIT 1`,
+    [identity]
+  );
+  const enc = res.rows[0]?.scraper_api_key_enc;
+  return enc ? decryptSecret(enc) : null;
+}
+async function tryConsumeQuota(identity) {
+  await ensureSchema();
+  await rollPeriodIfNeeded(identity);
+  const res = await query(
+    `UPDATE mem_schedule_entitlements
+     SET used_this_period = used_this_period + 1, updated_at = now()
+     WHERE identity = $1 AND enabled = true AND used_this_period < quota_per_period
+     RETURNING used_this_period`,
+    [identity]
+  );
+  if ((res.rowCount ?? 0) > 0) return { ok: true };
+  const current = await getEntitlement(identity);
+  if (!current || !current.enabled) return { ok: false, reason: "not_enabled" };
+  return { ok: false, reason: "quota_exceeded" };
+}
+export {
+  getEntitlement,
+  getScraperApiKey,
+  setEntitlement,
+  tryConsumeQuota
+};
+//# sourceMappingURL=schedule-entitlements.js.map

package/dist/db/schedule-entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/schedule-entitlements.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\nimport { encryptSecret, decryptSecret } from '../lib/secret-crypto'\n\nexport interface ScheduleEntitlement {\n  identity: string\n  enabled: boolean\n  quotaPerPeriod: number\n  usedThisPeriod: number\n  periodStart: string\n}\n\ninterface RawRow {\n  identity: string\n  enabled: boolean\n  quota_per_period: number\n  used_this_period: number\n  period_start: string\n  scraper_api_key_enc: string | null\n}\n\nfunction mapRow(r: RawRow): ScheduleEntitlement {\n  return {\n    identity: r.identity,\n    enabled: r.enabled,\n    quotaPerPeriod: r.quota_per_period,\n    usedThisPeriod: r.used_this_period,\n    periodStart: r.period_start,\n  }\n}\n\nasync function rollPeriodIfNeeded(identity: string): Promise<void> {\n  await query(\n    `UPDATE mem_schedule_entitlements\n     SET used_this_period = 0, period_start = date_trunc('month', now())::date, updated_at = now()\n     WHERE identity = $1 AND period_start < date_trunc('month', now())::date`,\n    [identity],\n  )\n}\n\nexport async function getEntitlement(identity: string): Promise<ScheduleEntitlement | null> {\n  await ensureSchema()\n  await rollPeriodIfNeeded(identity)\n  const res = await query<RawRow>(`SELECT * FROM mem_schedule_entitlements WHERE identity = $1 LIMIT 1`, [identity])\n  return res.rows[0] ? mapRow(res.rows[0]) : null\n}\n\nexport async function setEntitlement(args: {\n  identity: string\n  enabled: boolean\n  quotaPerPeriod?: number\n  scraperApiKey?: string\n}): Promise<void> {\n  await ensureSchema()\n  const scraperApiKeyEnc = args.scraperApiKey ? encryptSecret(args.scraperApiKey) : null\n  await query(\n    `INSERT INTO mem_schedule_entitlements (identity, enabled, quota_per_period, used_this_period, period_start, scraper_api_key_enc)\n     VALUES ($1, $2, $3, 0, date_trunc('month', now())::date, $4)\n     ON CONFLICT (identity) DO UPDATE SET\n       enabled = EXCLUDED.enabled,\n       quota_per_period = COALESCE($3, mem_schedule_entitlements.quota_per_period),\n       scraper_api_key_enc = COALESCE($4, mem_schedule_entitlements.scraper_api_key_enc),\n       updated_at = now()`,\n    [args.identity, args.enabled, args.quotaPerPeriod ?? 1000, scraperApiKeyEnc],\n  )\n}\n\nexport async function getScraperApiKey(identity: string): Promise<string | null> {\n  await ensureSchema()\n  const res = await query<{ scraper_api_key_enc: string | null }>(\n    `SELECT scraper_api_key_enc FROM mem_schedule_entitlements WHERE identity = $1 LIMIT 1`,\n    [identity],\n  )\n  const enc = res.rows[0]?.scraper_api_key_enc\n  return enc ? decryptSecret(enc) : null\n}\n\nexport type ConsumeQuotaResult = { ok: true } | { ok: false; reason: 'not_enabled' | 'quota_exceeded' }\n\nexport async function tryConsumeQuota(identity: string): Promise<ConsumeQuotaResult> {\n  await ensureSchema()\n  await rollPeriodIfNeeded(identity)\n  const res = await query<{ used_this_period: number }>(\n    `UPDATE mem_schedule_entitlements\n     SET used_this_period = used_this_period + 1, updated_at = now()\n     WHERE identity = $1 AND enabled = true AND used_this_period < quota_per_period\n     RETURNING used_this_period`,\n    [identity],\n  )\n  if ((res.rowCount ?? 0) > 0) return { ok: true }\n  const current = await getEntitlement(identity)\n  if (!current || !current.enabled) return { ok: false, reason: 'not_enabled' }\n  return { ok: false, reason: 'quota_exceeded' }\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AACpC,SAAS,eAAe,qBAAqB;AAmB7C,SAAS,OAAO,GAAgC;AAC9C,SAAO;AAAA,IACL,UAAU,EAAE;AAAA,IACZ,SAAS,EAAE;AAAA,IACX,gBAAgB,EAAE;AAAA,IAClB,gBAAgB,EAAE;AAAA,IAClB,aAAa,EAAE;AAAA,EACjB;AACF;AAEA,eAAe,mBAAmB,UAAiC;AACjE,QAAM;AAAA,IACJ;AAAA;AAAA;AAAA,IAGA,CAAC,QAAQ;AAAA,EACX;AACF;AAEA,eAAsB,eAAe,UAAuD;AAC1F,QAAM,aAAa;AACnB,QAAM,mBAAmB,QAAQ;AACjC,QAAM,MAAM,MAAM,MAAc,uEAAuE,CAAC,QAAQ,CAAC;AACjH,SAAO,IAAI,KAAK,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,IAAI;AAC7C;AAEA,eAAsB,eAAe,MAKnB;AAChB,QAAM,aAAa;AACnB,QAAM,mBAAmB,KAAK,gBAAgB,cAAc,KAAK,aAAa,IAAI;AAClF,QAAM;AAAA,IACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,CAAC,KAAK,UAAU,KAAK,SAAS,KAAK,kBAAkB,KAAM,gBAAgB;AAAA,EAC7E;AACF;AAEA,eAAsB,iBAAiB,UAA0C;AAC/E,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AACA,QAAM,MAAM,IAAI,KAAK,CAAC,GAAG;AACzB,SAAO,MAAM,cAAc,GAAG,IAAI;AACpC;AAIA,eAAsB,gBAAgB,UAA+C;AACnF,QAAM,aAAa;AACnB,QAAM,mBAAmB,QAAQ;AACjC,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA;AAAA;AAAA;AAAA,IAIA,CAAC,QAAQ;AAAA,EACX;AACA,OAAK,IAAI,YAAY,KAAK,EAAG,QAAO,EAAE,IAAI,KAAK;AAC/C,QAAM,UAAU,MAAM,eAAe,QAAQ;AAC7C,MAAI,CAAC,WAAW,CAAC,QAAQ,QAAS,QAAO,EAAE,IAAI,OAAO,QAAQ,cAAc;AAC5E,SAAO,EAAE,IAAI,OAAO,QAAQ,iBAAiB;AAC/C;","names":[]}

package/dist/db/schedule-link.d.ts

@@ -0,0 +1,7 @@
+declare function getOrCreateScheduleLinkSecret(identity: string): Promise<string>;
+declare class ScheduleLinkSecretNotRetrievable extends Error {
+    constructor();
+}
+declare function revokeScheduleLink(identity: string): Promise<boolean>;
+
+export { ScheduleLinkSecretNotRetrievable, getOrCreateScheduleLinkSecret, revokeScheduleLink };

package/dist/db/schedule-link.js

@@ -0,0 +1,50 @@
+import { ensureSchema, query } from "./pool";
+import { issueKeyRow, revokeKeyRow, getKeyById } from "./keys";
+import { fullScope } from "../lib/auth";
+async function getScheduleLinkKeyId(identity) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT schedule_link_key_id FROM mem_settings WHERE identity = $1 LIMIT 1`,
+    [identity]
+  );
+  return res.rows[0]?.schedule_link_key_id ?? null;
+}
+async function setScheduleLinkKeyId(identity, keyId) {
+  await ensureSchema();
+  await query(
+    `INSERT INTO mem_settings (identity, schedule_link_key_id, updated_at)
+     VALUES ($1, $2, now())
+     ON CONFLICT (identity) DO UPDATE SET schedule_link_key_id = EXCLUDED.schedule_link_key_id, updated_at = now()`,
+    [identity, keyId]
+  );
+}
+async function getOrCreateScheduleLinkSecret(identity) {
+  const existingId = await getScheduleLinkKeyId(identity);
+  if (existingId) {
+    const existing = await getKeyById(existingId);
+    if (existing && !existing.revoked) {
+      throw new ScheduleLinkSecretNotRetrievable();
+    }
+  }
+  const issued = await issueKeyRow({ identity, vaults: [], scope: fullScope(), plan: "free", expiresAt: null });
+  await setScheduleLinkKeyId(identity, issued.keyId);
+  return issued.secret;
+}
+class ScheduleLinkSecretNotRetrievable extends Error {
+  constructor() {
+    super("A schedule link already exists for this identity; its secret cannot be re-displayed (only revoked and reissued).");
+  }
+}
+async function revokeScheduleLink(identity) {
+  const existingId = await getScheduleLinkKeyId(identity);
+  if (!existingId) return false;
+  await revokeKeyRow(existingId);
+  await setScheduleLinkKeyId(identity, null);
+  return true;
+}
+export {
+  ScheduleLinkSecretNotRetrievable,
+  getOrCreateScheduleLinkSecret,
+  revokeScheduleLink
+};
+//# sourceMappingURL=schedule-link.js.map

package/dist/db/schedule-link.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/schedule-link.ts"],"sourcesContent":["import { ensureSchema, query } from './pool'\nimport { issueKeyRow, revokeKeyRow, getKeyById } from './keys'\nimport { fullScope } from '../lib/auth'\n\nasync function getScheduleLinkKeyId(identity: string): Promise<string | null> {\n  await ensureSchema()\n  const res = await query<{ schedule_link_key_id: string | null }>(\n    `SELECT schedule_link_key_id FROM mem_settings WHERE identity = $1 LIMIT 1`,\n    [identity],\n  )\n  return res.rows[0]?.schedule_link_key_id ?? null\n}\n\nasync function setScheduleLinkKeyId(identity: string, keyId: string | null): Promise<void> {\n  await ensureSchema()\n  await query(\n    `INSERT INTO mem_settings (identity, schedule_link_key_id, updated_at)\n     VALUES ($1, $2, now())\n     ON CONFLICT (identity) DO UPDATE SET schedule_link_key_id = EXCLUDED.schedule_link_key_id, updated_at = now()`,\n    [identity, keyId],\n  )\n}\n\nexport async function getOrCreateScheduleLinkSecret(identity: string): Promise<string> {\n  const existingId = await getScheduleLinkKeyId(identity)\n  if (existingId) {\n    const existing = await getKeyById(existingId)\n    if (existing && !existing.revoked) {\n      throw new ScheduleLinkSecretNotRetrievable()\n    }\n  }\n  const issued = await issueKeyRow({ identity, vaults: [], scope: fullScope(), plan: 'free', expiresAt: null })\n  await setScheduleLinkKeyId(identity, issued.keyId)\n  return issued.secret\n}\n\nexport class ScheduleLinkSecretNotRetrievable extends Error {\n  constructor() {\n    super('A schedule link already exists for this identity; its secret cannot be re-displayed (only revoked and reissued).')\n  }\n}\n\nexport async function revokeScheduleLink(identity: string): Promise<boolean> {\n  const existingId = await getScheduleLinkKeyId(identity)\n  if (!existingId) return false\n  await revokeKeyRow(existingId)\n  await setScheduleLinkKeyId(identity, null)\n  return true\n}\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AACpC,SAAS,aAAa,cAAc,kBAAkB;AACtD,SAAS,iBAAiB;AAE1B,eAAe,qBAAqB,UAA0C;AAC5E,QAAM,aAAa;AACnB,QAAM,MAAM,MAAM;AAAA,IAChB;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AACA,SAAO,IAAI,KAAK,CAAC,GAAG,wBAAwB;AAC9C;AAEA,eAAe,qBAAqB,UAAkB,OAAqC;AACzF,QAAM,aAAa;AACnB,QAAM;AAAA,IACJ;AAAA;AAAA;AAAA,IAGA,CAAC,UAAU,KAAK;AAAA,EAClB;AACF;AAEA,eAAsB,8BAA8B,UAAmC;AACrF,QAAM,aAAa,MAAM,qBAAqB,QAAQ;AACtD,MAAI,YAAY;AACd,UAAM,WAAW,MAAM,WAAW,UAAU;AAC5C,QAAI,YAAY,CAAC,SAAS,SAAS;AACjC,YAAM,IAAI,iCAAiC;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,SAAS,MAAM,YAAY,EAAE,UAAU,QAAQ,CAAC,GAAG,OAAO,UAAU,GAAG,MAAM,QAAQ,WAAW,KAAK,CAAC;AAC5G,QAAM,qBAAqB,UAAU,OAAO,KAAK;AACjD,SAAO,OAAO;AAChB;AAEO,MAAM,yCAAyC,MAAM;AAAA,EAC1D,cAAc;AACZ,UAAM,kHAAkH;AAAA,EAC1H;AACF;AAEA,eAAsB,mBAAmB,UAAoC;AAC3E,QAAM,aAAa,MAAM,qBAAqB,QAAQ;AACtD,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,aAAa,UAAU;AAC7B,QAAM,qBAAqB,UAAU,IAAI;AACzC,SAAO;AACT;","names":[]}

package/dist/db/scheduled-actions.d.ts

@@ -0,0 +1,58 @@
+import { ScheduleCadence } from '../lib/schedule-cadence.js';
+
+type ScheduledActionStatus = 'active' | 'paused' | 'deleted' | 'completed';
+interface ScheduledActionRecord {
+    id: string;
+    identity: string;
+    description: string;
+    vault: string;
+    cadence: ScheduleCadence;
+    timeOfDay: string | null;
+    timezone: string;
+    status: ScheduledActionStatus;
+    nextRunAt: string;
+    lastRunAt: string | null;
+    lastRunStatus: string | null;
+    createdAt: string;
+    updatedAt: string;
+    system: string | null;
+}
+declare function createScheduledAction(args: {
+    identity: string;
+    description: string;
+    vault: string;
+    cadence: ScheduleCadence;
+    timeOfDay?: string | null;
+    timezone?: string | null;
+    nextRunAt: string;
+    system?: string | null;
+}): Promise<ScheduledActionRecord>;
+declare function getSystemScheduledAction(identity: string, system: string): Promise<ScheduledActionRecord | null>;
+declare function getScheduledAction(id: string, identity: string): Promise<ScheduledActionRecord | null>;
+declare function listScheduledActionsForIdentity(identity: string): Promise<ScheduledActionRecord[]>;
+declare function patchScheduledAction(args: {
+    id: string;
+    identity: string;
+    status?: 'active' | 'paused';
+    description?: string;
+    cadence?: ScheduleCadence;
+    timeOfDay?: string | null;
+    timezone?: string | null;
+    nextRunAt?: string;
+}): Promise<ScheduledActionRecord | null>;
+type DeleteScheduledActionResult = {
+    deleted: true;
+} | {
+    deleted: false;
+    reason: 'not_found' | 'system';
+};
+declare function deleteScheduledAction(id: string, identity: string): Promise<DeleteScheduledActionResult>;
+declare function listDueScheduledActions(nowIso: string, limit: number): Promise<ScheduledActionRecord[]>;
+declare function markScheduledActionRan(id: string, args: {
+    lastRunAt: string;
+    nextRunAt: string;
+    lastRunStatus: string;
+    status?: ScheduledActionStatus;
+}): Promise<void>;
+
+export { type DeleteScheduledActionResult, type ScheduledActionRecord, type ScheduledActionStatus, createScheduledAction, deleteScheduledAction, getScheduledAction, getSystemScheduledAction, listDueScheduledActions, listScheduledActionsForIdentity, markScheduledActionRan, patchScheduledAction };

package/dist/db/scheduled-actions.js

@@ -0,0 +1,139 @@
+import { randomUUID } from "node:crypto";
+import { ensureSchema, query } from "./pool";
+function mapRow(r) {
+  return {
+    id: r.id,
+    identity: r.identity,
+    description: r.description,
+    vault: r.vault,
+    cadence: r.cadence,
+    timeOfDay: r.time_of_day,
+    timezone: r.timezone,
+    status: r.status,
+    nextRunAt: r.next_run_at,
+    lastRunAt: r.last_run_at,
+    lastRunStatus: r.last_run_status,
+    createdAt: r.created_at,
+    updatedAt: r.updated_at,
+    system: r.system
+  };
+}
+const COLUMNS = "id, identity, description, vault, cadence, time_of_day, timezone, status, next_run_at, last_run_at, last_run_status, created_at, updated_at, system";
+async function createScheduledAction(args) {
+  await ensureSchema();
+  const id = randomUUID();
+  const res = await query(
+    `INSERT INTO mem_scheduled_actions (id, identity, description, vault, cadence, time_of_day, timezone, status, next_run_at, system)
+     VALUES ($1, $2, $3, $4, $5, $6, $7, 'active', $8, $9)
+     RETURNING ${COLUMNS}`,
+    [id, args.identity, args.description, args.vault, args.cadence, args.timeOfDay ?? null, args.timezone ?? "UTC", args.nextRunAt, args.system ?? null]
+  );
+  return mapRow(res.rows[0]);
+}
+async function getSystemScheduledAction(identity, system) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT ${COLUMNS} FROM mem_scheduled_actions WHERE identity = $1 AND system = $2 AND status != 'deleted' LIMIT 1`,
+    [identity, system]
+  );
+  return res.rows[0] ? mapRow(res.rows[0]) : null;
+}
+async function getScheduledAction(id, identity) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT ${COLUMNS} FROM mem_scheduled_actions WHERE id = $1 AND identity = $2 AND status != 'deleted' LIMIT 1`,
+    [id, identity]
+  );
+  return res.rows[0] ? mapRow(res.rows[0]) : null;
+}
+async function listScheduledActionsForIdentity(identity) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT ${COLUMNS} FROM mem_scheduled_actions WHERE identity = $1 AND status != 'deleted' ORDER BY created_at DESC`,
+    [identity]
+  );
+  return res.rows.map(mapRow);
+}
+async function patchScheduledAction(args) {
+  await ensureSchema();
+  const sets = [];
+  const params = [];
+  if (args.status !== void 0) {
+    params.push(args.status);
+    sets.push(`status = $${params.length}`);
+  }
+  if (args.description !== void 0) {
+    params.push(args.description);
+    sets.push(`description = $${params.length}`);
+  }
+  if (args.cadence !== void 0) {
+    params.push(args.cadence);
+    sets.push(`cadence = $${params.length}`);
+  }
+  if (args.timeOfDay !== void 0) {
+    params.push(args.timeOfDay);
+    sets.push(`time_of_day = $${params.length}`);
+  }
+  if (args.timezone !== void 0) {
+    params.push(args.timezone);
+    sets.push(`timezone = $${params.length}`);
+  }
+  if (args.nextRunAt !== void 0) {
+    params.push(args.nextRunAt);
+    sets.push(`next_run_at = $${params.length}`);
+  }
+  if (sets.length === 0) return getScheduledAction(args.id, args.identity);
+  sets.push("updated_at = now()");
+  params.push(args.id, args.identity);
+  const res = await query(
+    `UPDATE mem_scheduled_actions SET ${sets.join(", ")}
+     WHERE id = $${params.length - 1} AND identity = $${params.length} AND status != 'deleted'
+     RETURNING ${COLUMNS}`,
+    params
+  );
+  return res.rows[0] ? mapRow(res.rows[0]) : null;
+}
+async function deleteScheduledAction(id, identity) {
+  await ensureSchema();
+  const existing = await getScheduledAction(id, identity);
+  if (!existing) return { deleted: false, reason: "not_found" };
+  if (existing.system) return { deleted: false, reason: "system" };
+  const res = await query(
+    `UPDATE mem_scheduled_actions SET status = 'deleted', updated_at = now() WHERE id = $1 AND identity = $2 AND status != 'deleted'`,
+    [id, identity]
+  );
+  return (res.rowCount ?? 0) > 0 ? { deleted: true } : { deleted: false, reason: "not_found" };
+}
+async function listDueScheduledActions(nowIso, limit) {
+  await ensureSchema();
+  const res = await query(
+    `SELECT ${COLUMNS} FROM mem_scheduled_actions WHERE status = 'active' AND next_run_at <= $1 ORDER BY next_run_at ASC LIMIT $2`,
+    [nowIso, limit]
+  );
+  return res.rows.map(mapRow);
+}
+async function markScheduledActionRan(id, args) {
+  await ensureSchema();
+  if (args.status !== void 0) {
+    await query(
+      `UPDATE mem_scheduled_actions SET last_run_at = $2, next_run_at = $3, last_run_status = $4, status = $5, updated_at = now() WHERE id = $1`,
+      [id, args.lastRunAt, args.nextRunAt, args.lastRunStatus, args.status]
+    );
+    return;
+  }
+  await query(
+    `UPDATE mem_scheduled_actions SET last_run_at = $2, next_run_at = $3, last_run_status = $4, updated_at = now() WHERE id = $1`,
+    [id, args.lastRunAt, args.nextRunAt, args.lastRunStatus]
+  );
+}
+export {
+  createScheduledAction,
+  deleteScheduledAction,
+  getScheduledAction,
+  getSystemScheduledAction,
+  listDueScheduledActions,
+  listScheduledActionsForIdentity,
+  markScheduledActionRan,
+  patchScheduledAction
+};
+//# sourceMappingURL=scheduled-actions.js.map