@hasna/mementos 0.14.86 → 0.14.87

package/dist/db/memories.d.ts

@@ -0,0 +1,199 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { CreateMemoryInput, DedupeMode, Memory, MemoryFilter, MemoryVersion, UpdateMemoryInput } from "../types/index.js";
+export declare function parseMemoryRow(row: Record<string, unknown>): Memory;
+/**
+ * Return a rejection message when `agentId` is a reserved placeholder, or
+ * null when it is acceptable. Matching is case- and whitespace-insensitive,
+ * mirroring how registerAgent normalizes names (trim().toLowerCase()).
+ */
+export declare function reservedAgentIdViolation(agentId: string | null | undefined): string | null;
+export declare function createMemory(input: CreateMemoryInput, dedupeMode?: DedupeMode, db?: Database): Memory;
+export interface BulkUpsertResult {
+    inserted: number;
+    /** Rows the store already had (id or unique-key conflict) — a benign no-op. */
+    skipped: number;
+    /**
+     * Rows the store REFUSED (bad enum, failed CHECK/FK, missing key). These did
+     * NOT persist. Kept separate from `skipped` so a caller can never read a
+     * dropped row as an idempotent no-op; every rejection also has a line in
+     * `errors`. `inserted + skipped + rejected === total`.
+     */
+    rejected: number;
+    errors: string[];
+    total: number;
+}
+/**
+ * Faithful, idempotent bulk restore of memories into the current store.
+ *
+ * Unlike {@link createMemory}, this primitive:
+ *  - PRESERVES the original `id` (does not regenerate a UUID);
+ *  - PRESERVES `status` (archived stays archived — never resurrected to active);
+ *  - PRESERVES timestamps, `version`, `pinned`, `access_count` and scope fields;
+ *  - does NOT dedupe by key/scope/agent and does NOT fire hooks / entity
+ *    extraction / embedding work (those run asynchronously elsewhere).
+ *
+ * Idempotency is by conflict, not by suppression: the statement carries an
+ * explicit bare `ON CONFLICT DO NOTHING`, which SQLite and Postgres both read
+ * as "ignore a uniqueness conflict (primary-key `id` or the unique key index)".
+ * A row already present is therefore left untouched and re-runs never create
+ * duplicates. This is the cross-machine → cloud backfill path for the fleet
+ * self-host cutover: a machine's local memories are shipped to the cloud store
+ * verbatim without mutating rows that are already present.
+ *
+ * It deliberately does NOT use `INSERT OR IGNORE`: on SQLite that swallows
+ * *every* constraint failure, so a row refused by the `category`/`scope`/
+ * `source`/`status` CHECK vanished with `changes === 0` and was counted as an
+ * idempotent `skipped` — a cloud write that did not persist reporting success.
+ * With a bare `ON CONFLICT DO NOTHING` a CHECK/FK/NOT NULL violation still
+ * throws into the catch below and lands in `rejected` + `errors`. Enum values
+ * are additionally pre-validated per row so the reason names the field and the
+ * accepted set instead of quoting raw constraint SQL.
+ *
+ * FK-referenced agent/project/session/machine rows are stubbed via
+ * {@link ensureMemoryReferences} so cross-machine authorship ids never fail the
+ * write. Values and summaries are still passed through {@link redactSecrets}.
+ */
+export declare function bulkUpsertMemories(memories: Array<Record<string, unknown>>, db?: Database): BulkUpsertResult;
+export declare function getMemory(id: string, db?: Database): Memory | null;
+export declare function getMemoryByKey(key: string, scope?: string, agentId?: string, projectId?: string, sessionId?: string, db?: Database, as_of?: string): Memory | null;
+/**
+ * Return ALL active memories matching a key (across scopes/agents/projects).
+ * Optional filters narrow the result set.
+ */
+export declare function getMemoriesByKey(key: string, scope?: string, agentId?: string, projectId?: string, db?: Database): Memory[];
+export interface MemoryListPage {
+    rows: Memory[];
+    /**
+     * true = more rows exist beyond this page; false = the end was reached;
+     * undefined = the server did not say (an older server without the
+     * pagination contract — callers fall back to a short-page heuristic).
+     */
+    has_more: boolean | undefined;
+    next_cursor: number | null;
+}
+/**
+ * One bounded page of the memories list surface.
+ *
+ * The server caps every single response at 1000 rows and answers with
+ * `has_more` / `next_cursor`, so a caller that wants more than one page (or
+ * the full population) walks pages. A bare `listMemories()` keeps returning
+ * exactly one page for its existing callers.
+ */
+export declare function listMemoriesPage(filter?: MemoryFilter, db?: Database): MemoryListPage;
+export declare function listMemories(filter?: MemoryFilter, db?: Database): Memory[];
+export interface MemoryListBounded {
+    rows: Memory[];
+    has_more: boolean;
+    next_cursor: number | null;
+}
+/**
+ * Collect the memories list surface across bounded pages (BUG 2796806b).
+ *
+ * The server caps every single response at 1000 rows, so a caller that wants
+ * more than one page — or the full population — must walk. Mirrors the CLI
+ * page-walk guards: cursor-cycle detection and a bounded page count. `target`
+ * is the maximum number of rows to return; undefined returns the full
+ * population. Termination: the server's `has_more: false`, or a page shorter
+ * than requested when the server carries no signal, or `target` rows collected.
+ */
+export declare function listMemoriesBounded(filter: MemoryFilter | undefined, target: number | undefined, db?: Database): MemoryListBounded;
+/**
+ * Total rows matching the list filter (limit/offset ignored). Local-store
+ * count; the server route computes it so API consumers never need it.
+ */
+export declare function countMemories(filter?: MemoryFilter, db?: Database): number;
+export interface MemoryBriefingResult {
+    new: Memory[];
+    updated: Memory[];
+    expired: Memory[];
+}
+/**
+ * Delta briefing: memories created / updated / expired since a timestamp,
+ * scoped by machine visibility. Transport-aware: in API mode the whole
+ * computation runs on the self-hosted server (the client has no DB).
+ *
+ * `visible_machine_id`: a resolved value (the caller resolves its own current
+ * machine). `null`/`undefined` restricts to machine-agnostic memories; a string
+ * also includes memories local to that machine.
+ */
+export declare function getMemoryBriefing(opts: {
+    since: string;
+    scope?: string;
+    project_id?: string;
+    visible_machine_id?: string | null;
+    limit?: number;
+}, db?: Database): MemoryBriefingResult;
+/**
+ * Low-trust memories (trust_score below a threshold) for poisoning review.
+ * Transport-aware: API mode reads from the self-hosted server.
+ */
+export declare function listLowTrustMemories(opts?: {
+    threshold?: number;
+    project_id?: string;
+    limit?: number;
+    offset?: number;
+}, db?: Database): Memory[];
+/**
+ * List memories ordered by most-recently-accessed (the `history` surface).
+ * Only returns memories that have been accessed at least once.
+ */
+export interface MemoryHistoryPage {
+    rows: Memory[];
+    has_more: boolean | undefined;
+    next_cursor: number | null;
+}
+/**
+ * One bounded page of the history surface (most-recently-accessed memories).
+ * Same pagination contract as the list surface.
+ */
+export declare function listMemoryHistoryPage(opts?: {
+    limit?: number;
+    offset?: number;
+}, db?: Database): MemoryHistoryPage;
+/**
+ * List memories ordered by most-recently-accessed (the `history` surface).
+ * Only returns memories that have been accessed at least once.
+ */
+export declare function listMemoryHistory(opts?: {
+    limit?: number;
+    offset?: number;
+}, db?: Database): Memory[];
+/** Total accessed memories (the history surface population). */
+export declare function countMemoryHistory(db?: Database): number;
+export declare function getMemoryChain(sequenceGroup: string, projectId?: string, db?: Database): Memory[];
+/**
+ * Load stored embeddings for a set of memory ids, for in-process re-ranking.
+ * API mode has no local embeddings table (the cloud store owns embeddings and
+ * ranks server-side), so it returns an empty map and callers gracefully fall
+ * back to importance/recency ordering.
+ */
+export declare function getMemoryEmbeddings(ids: string[], db?: Database): Map<string, number[]>;
+export declare function updateMemory(id: string, input: UpdateMemoryInput, db?: Database): Memory;
+export declare function deleteMemory(id: string, db?: Database): boolean;
+export declare function bulkDeleteMemories(ids: string[], db?: Database): number;
+export declare function touchMemory(id: string, db?: Database): void;
+export declare function incrementRecallCount(id: string, db?: Database): void;
+export declare function cleanExpiredMemories(db?: Database): number;
+export declare function getMemoryVersions(memoryId: string, db?: Database): MemoryVersion[];
+export interface SemanticSearchResult {
+    memory: Memory;
+    score: number;
+}
+/**
+ * Store or update the embedding for a memory. Called asynchronously after saves.
+ * Non-blocking: failures are silently ignored.
+ */
+export declare function indexMemoryEmbedding(memoryId: string, text: string, db?: Database): Promise<void>;
+/**
+ * Semantic search across memories using cosine similarity.
+ * Falls back gracefully if no embeddings exist yet.
+ */
+export declare function semanticSearch(queryText: string, options?: {
+    threshold?: number;
+    limit?: number;
+    scope?: string;
+    agent_id?: string;
+    project_id?: string;
+    index_missing?: boolean;
+}, db?: Database): Promise<SemanticSearchResult[]>;
+//# sourceMappingURL=memories.d.ts.map

package/dist/db/memories.d.ts.map

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

package/dist/db/memory-links.d.ts

@@ -0,0 +1,21 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export type MemoryLinkRelation = "summarizes" | "merged_from" | "promotes" | "reflects_on" | "supersedes" | "related_to";
+export interface MemoryLink {
+    id: string;
+    source_memory_id: string;
+    target_memory_id: string;
+    relation_type: MemoryLinkRelation;
+    run_id: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export declare function createMemoryLink(input: {
+    source_memory_id: string;
+    target_memory_id: string;
+    relation_type: MemoryLinkRelation;
+    run_id?: string | null;
+    metadata?: Record<string, unknown>;
+}, db?: Database): MemoryLink;
+export declare function getMemoryLinks(memoryId: string, relationType?: MemoryLinkRelation, db?: Database): MemoryLink[];
+export declare function getMemoryBacklinks(memoryId: string, relationType?: MemoryLinkRelation, db?: Database): MemoryLink[];
+//# sourceMappingURL=memory-links.d.ts.map

package/dist/db/memory-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-links.d.ts","sourceRoot":"","sources":["../../src/db/memory-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK1D,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,aAAa,GACb,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IACL,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,UAAU,CAoCZ;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,kBAAkB,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,UAAU,EAAE,CAad;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,kBAAkB,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,UAAU,EAAE,CAad"}

package/dist/db/memory-project-link.d.ts

@@ -0,0 +1,13 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { MemoryProjectLinkReceipt, MemoryProjectLinkRequest, MemoryProjectLinkResult, MemoryProjectLinkRollbackRequest, ProjectAuthorityIdentity } from "../types/index.js";
+export type MemoryProjectLinkErrorCode = "MEMORY_PROJECT_LINK_INVALID_INPUT" | "MEMORY_PROJECT_LINK_AUTHORITY_MISMATCH" | "MEMORY_PROJECT_LINK_MEMORY_NOT_FOUND" | "MEMORY_PROJECT_LINK_PROJECT_NOT_FOUND" | "MEMORY_PROJECT_LINK_STALE_MEMORY" | "MEMORY_PROJECT_LINK_STALE_PROJECT" | "MEMORY_PROJECT_LINK_COLLISION" | "MEMORY_PROJECT_LINK_IDEMPOTENCY_MISMATCH" | "MEMORY_PROJECT_LINK_RECEIPT_NOT_FOUND" | "MEMORY_PROJECT_LINK_RECEIPT_NOT_ROLLBACKABLE" | "MEMORY_PROJECT_LINK_ACCEPTED_TARGET_DRIFTED";
+export declare class MemoryProjectLinkError extends Error {
+    readonly code: MemoryProjectLinkErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: MemoryProjectLinkErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function previewMemoryProjectLink(memoryId: string, request: MemoryProjectLinkRequest, db?: Database): MemoryProjectLinkResult;
+export declare function applyMemoryProjectLink(memoryId: string, request: MemoryProjectLinkRequest, db?: Database): MemoryProjectLinkResult;
+export declare function rollbackMemoryProjectLink(memoryId: string, request: MemoryProjectLinkRollbackRequest, db?: Database): MemoryProjectLinkResult;
+export declare function getMemoryProjectLinkReceipt(memoryId: string, receiptId: string, identity?: ProjectAuthorityIdentity, db?: Database): MemoryProjectLinkReceipt;
+//# sourceMappingURL=memory-project-link.d.ts.map

package/dist/db/memory-project-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-project-link.d.ts","sourceRoot":"","sources":["../../src/db/memory-project-link.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,IAAI,QAAQ,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAGhC,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAW3B,MAAM,MAAM,0BAA0B,GAClC,mCAAmC,GACnC,wCAAwC,GACxC,sCAAsC,GACtC,uCAAuC,GACvC,kCAAkC,GAClC,mCAAmC,GACnC,+BAA+B,GAC/B,0CAA0C,GAC1C,uCAAuC,GACvC,8CAA8C,GAC9C,6CAA6C,CAAC;AAElD,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,0BAA0B;aAEhC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFhC,IAAI,EAAE,0BAA0B,EAChD,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxD;AA6iBD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,uBAAuB,CAsCzB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,uBAAuB,CA4HzB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gCAAgC,EACzC,EAAE,CAAC,EAAE,QAAQ,GACZ,uBAAuB,CA8HzB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,wBAA0C,EACpD,EAAE,CAAC,EAAE,QAAQ,GACZ,wBAAwB,CAqB1B"}

package/dist/db/migrations.d.ts

@@ -0,0 +1,3 @@
+export declare const MEMORY_VERSION_SNAPSHOT_TRIGGER = "\nCREATE TRIGGER IF NOT EXISTS memories_version_snapshot\nBEFORE UPDATE ON memories\nWHEN NEW.version > OLD.version\nBEGIN\n  INSERT OR IGNORE INTO memory_versions (\n    id, memory_id, version, value, importance, scope, category, tags,\n    summary, pinned, status, when_to_use, created_at\n  ) VALUES (\n    lower(hex(randomblob(4))) || '-' || lower(hex(randomblob(2))) || '-' ||\n      lower(hex(randomblob(2))) || '-' || lower(hex(randomblob(2))) || '-' ||\n      lower(hex(randomblob(6))),\n    OLD.id, OLD.version, OLD.value, OLD.importance, OLD.scope, OLD.category,\n    OLD.tags, OLD.summary, OLD.pinned, OLD.status, OLD.when_to_use,\n    OLD.updated_at\n  );\nEND;\n";
+export declare const MIGRATIONS: string[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,+BAA+B,wqBAiB3C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,EA0iC9B,CAAC"}

package/dist/db/pg-migrate.d.ts

@@ -0,0 +1,27 @@
+export interface PgMigrationResult {
+    applied: number[];
+    alreadyApplied: number[];
+    errors: string[];
+    totalMigrations: number;
+}
+export interface PgMigrationDiagnostics {
+    ok: boolean;
+    target: "postgres-rds-compatible";
+    configured: boolean;
+    redacted_connection_string: string | null;
+    total_migrations: number;
+    mutates_remote_on_apply: true;
+    requires_approval_for_live_run: true;
+    no_network: true;
+    issues: string[];
+    warnings: string[];
+}
+export declare function getPgMigrationDiagnostics(connectionString?: string): PgMigrationDiagnostics;
+/**
+ * Apply all pending PostgreSQL migrations to the given database.
+ *
+ * @param connectionString - PostgreSQL connection string
+ * @returns Summary of which migrations were applied / skipped / errored.
+ */
+export declare function applyPgMigrations(connectionString: string): Promise<PgMigrationResult>;
+//# sourceMappingURL=pg-migrate.d.ts.map

package/dist/db/pg-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-migrate.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrate.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,IAAI,CAAC;IAC9B,8BAA8B,EAAE,IAAI,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,yBAAyB,CACvC,gBAAgB,CAAC,EAAE,MAAM,GACxB,sBAAsB,CAkCxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA8D5B"}

package/dist/db/pg-migrations.d.ts

@@ -0,0 +1,2 @@
+export declare const PG_MIGRATIONS: string[];
+//# sourceMappingURL=pg-migrations.d.ts.map

package/dist/db/pg-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-migrations.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrations.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa,EAAE,MAAM,EA+1BjC,CAAC"}

package/dist/db/projects.d.ts

@@ -0,0 +1,27 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Project, ProjectAuthorityIdentity, ProjectGuardedRollbackRequest, ProjectGuardedUpdateRequest, ProjectGuardedUpdateResult, ProjectUpdateReceipt, UpdateProjectInput } from "../types/index.js";
+export declare class ProjectCollisionError extends Error {
+    readonly field: "name" | "path";
+    readonly value: string;
+    constructor(field: "name" | "path", value: string);
+}
+export type ProjectGuardedUpdateErrorCode = "PROJECT_UPDATE_INVALID_INPUT" | "PROJECT_UPDATE_AUTHORITY_MISMATCH" | "PROJECT_UPDATE_NOT_FOUND" | "PROJECT_UPDATE_STALE_REVISION" | "PROJECT_UPDATE_COLLISION" | "PROJECT_UPDATE_IDEMPOTENCY_MISMATCH" | "PROJECT_UPDATE_RECEIPT_NOT_FOUND" | "PROJECT_UPDATE_ACCEPTED_TARGET_DRIFTED";
+export declare class ProjectGuardedUpdateError extends Error {
+    readonly code: ProjectGuardedUpdateErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: ProjectGuardedUpdateErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function registerProject(name: string, path: string, description?: string, memoryPrefix?: string, db?: Database): Project;
+export declare function getProject(idOrPath: string, db?: Database): Project | null;
+export declare function listProjects(db?: Database): Project[];
+export declare function previewProjectUpdate(id: string, request: ProjectGuardedUpdateRequest, db?: Database, expectedIdentity?: ProjectAuthorityIdentity): ProjectGuardedUpdateResult;
+export declare function applyProjectUpdate(id: string, request: ProjectGuardedUpdateRequest, db?: Database, expectedIdentity?: ProjectAuthorityIdentity, resultDigestForProject?: (project: Project) => string): ProjectGuardedUpdateResult;
+export declare function rollbackProjectUpdate(id: string, request: ProjectGuardedRollbackRequest, db?: Database, expectedIdentity?: ProjectAuthorityIdentity, resultDigestForProject?: (project: Project) => string): ProjectGuardedUpdateResult;
+export declare function getProjectUpdateReceipt(id: string, receiptId: string, identity?: ProjectAuthorityIdentity, db?: Database, expectedIdentity?: ProjectAuthorityIdentity): ProjectUpdateReceipt;
+/**
+ * Package-internal compatibility helper for old tests and migrations.
+ * Public callers use applyProjectUpdate so every mutation is CAS-guarded and
+ * receipt-backed; this helper is intentionally not exported from src/index.ts.
+ */
+export declare function updateProject(id: string, input: UpdateProjectInput, db?: Database): Project | null;
+//# sourceMappingURL=projects.d.ts.map

package/dist/db/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/db/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EACV,OAAO,EACP,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAsB3B,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,KAAK,EAAE,MAAM,GAAG,MAAM;aACtB,KAAK,EAAE,MAAM;gBADb,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,KAAK,EAAE,MAAM;CAKhC;AAED,MAAM,MAAM,6BAA6B,GACrC,8BAA8B,GAC9B,mCAAmC,GACnC,0BAA0B,GAC1B,+BAA+B,GAC/B,0BAA0B,GAC1B,qCAAqC,GACrC,kCAAkC,GAClC,wCAAwC,CAAC;AAE7C,qBAAa,yBAA0B,SAAQ,KAAK;aAEhC,IAAI,EAAE,6BAA6B;aAEnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFhC,IAAI,EAAE,6BAA6B,EACnD,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxD;AA8TD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAkCT;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,GAAG,IAAI,CAyBhB;AAED,wBAAgB,YAAY,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,EAAE,CAUrD;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,2BAA2B,EACpC,EAAE,CAAC,EAAE,QAAQ,EACb,gBAAgB,GAAE,wBAAmD,GACpE,0BAA0B,CAiC5B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,2BAA2B,EACpC,EAAE,CAAC,EAAE,QAAQ,EACb,gBAAgB,GAAE,wBAAmD,EACrE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GACpD,0BAA0B,CA4F5B;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,6BAA6B,EACtC,EAAE,CAAC,EAAE,QAAQ,EACb,gBAAgB,GAAE,wBAAmD,EACrE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GACpD,0BAA0B,CAuG5B;AAED,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,wBAAmD,EAC7D,EAAE,CAAC,EAAE,QAAQ,EACb,gBAAgB,GAAE,wBAAmD,GACpE,oBAAoB,CAmBtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,GAAG,IAAI,CAkFhB"}

package/dist/db/ratings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Memory ratings — usefulness feedback for memories.
+ */
+import { SqliteAdapter as Database } from "../storage.js";
+export interface MemoryRating {
+    id: string;
+    memory_id: string;
+    agent_id: string | null;
+    useful: boolean;
+    context: string | null;
+    created_at: string;
+}
+export interface RatingsSummary {
+    memory_id: string;
+    total: number;
+    useful_count: number;
+    not_useful_count: number;
+    usefulness_ratio: number;
+}
+export declare function rateMemory(memoryId: string, useful: boolean, agentId?: string, context?: string, db?: Database): MemoryRating;
+export declare function listRatingsForMemory(memoryId: string, db?: Database): MemoryRating[];
+export declare function getRatingsSummary(memoryId: string, db?: Database): RatingsSummary;
+//# sourceMappingURL=ratings.d.ts.map

package/dist/db/ratings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings.d.ts","sourceRoot":"","sources":["../../src/db/ratings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAO1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,CAmBd;AAMD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAOhB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,cAAc,CAqBhB"}

package/dist/db/relations.d.ts

@@ -0,0 +1,49 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Entity, Relation, CreateRelationInput, RelationType } from "../types/index.js";
+export declare function parseRelationRow(row: Record<string, unknown>): Relation;
+export declare function parseEntityRow(row: Record<string, unknown>): Entity;
+export declare function createRelation(input: CreateRelationInput, db?: Database): Relation;
+export declare function getRelation(id: string, db?: Database): Relation;
+export declare function listRelations(filter: {
+    entity_id?: string;
+    relation_type?: RelationType;
+    direction?: "outgoing" | "incoming" | "both";
+}, db?: Database): Relation[];
+export declare function deleteRelation(id: string, db?: Database): void;
+/**
+ * Get direct neighbors (1-hop) of an entity.
+ */
+export declare function getRelatedEntities(entityId: string, relationType?: RelationType, db?: Database): Entity[];
+/**
+ * Recursive CTE graph traversal. Collect all entities and relations within N hops.
+ * Traverses BOTH directions (source->target and target->source).
+ */
+export declare function getEntityGraph(entityId: string, depth?: number, db?: Database): {
+    entities: Entity[];
+    relations: Relation[];
+};
+/**
+ * BFS shortest path using recursive CTE. Return ordered entity list or null if no path.
+ */
+export declare function findPath(fromEntityId: string, toEntityId: string, maxDepth?: number, db?: Database): Entity[] | null;
+export interface GraphStats {
+    entities: {
+        total: number;
+        by_type: Record<string, number>;
+    };
+    relations: {
+        total: number;
+        by_type: Record<string, number>;
+    };
+    memory_links: number;
+    orphan_entities: number;
+    avg_degree: number;
+    most_connected: {
+        id: string;
+        name: string;
+        type: string;
+        degree: number;
+    }[];
+}
+export declare function getGraphStats(db?: Database): GraphStats;
+//# sourceMappingURL=relations.d.ts.map

package/dist/db/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/db/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAO7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAUvE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWnE;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAuClF;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAU/D;AAMD,wBAAgB,aAAa,CAC3B,MAAM,EAAE;IACN,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;CAC9C,EACD,EAAE,CAAC,EAAE,QAAQ,GACZ,QAAQ,EAAE,CAwCZ;AAMD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAS9D;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,EAC3B,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CAqCV;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,EACjB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,CA6C/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAU,EACpB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,GAAG,IAAI,CAsCjB;AAMD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC7D,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9E;AAED,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,UAAU,CAyCvD"}

package/dist/db/session-jobs.d.ts

@@ -0,0 +1,67 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export type SessionJobSource = "claude-code" | "codex" | "manual" | "open-sessions";
+export type SessionJobStatus = "pending" | "processing" | "completed" | "failed";
+export interface SessionMemoryJob {
+    id: string;
+    session_id: string;
+    agent_id: string | null;
+    project_id: string | null;
+    source: SessionJobSource;
+    status: SessionJobStatus;
+    transcript: string;
+    chunk_count: number;
+    memories_extracted: number;
+    error: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface CreateSessionJobInput {
+    session_id: string;
+    transcript: string;
+    source?: SessionJobSource;
+    agent_id?: string;
+    project_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionJobFilter {
+    agent_id?: string;
+    project_id?: string;
+    status?: SessionJobStatus;
+    session_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface UpdateSessionJobInput {
+    status?: SessionJobStatus;
+    chunk_count?: number;
+    memories_extracted?: number;
+    error?: string | null;
+    started_at?: string | null;
+    completed_at?: string | null;
+}
+export declare function createSessionJob(input: CreateSessionJobInput, db?: Database): SessionMemoryJob;
+export declare function getSessionJob(id: string, db?: Database): SessionMemoryJob | null;
+export declare function listSessionJobs(filter?: SessionJobFilter, db?: Database): SessionMemoryJob[];
+export declare function updateSessionJob(id: string, updates: UpdateSessionJobInput, db?: Database): SessionMemoryJob | null;
+export declare function getNextPendingJob(db?: Database): SessionMemoryJob | null;
+/**
+ * Atomically claim a pending job for processing.
+ * Single-statement compare-and-swap: only a `pending` row transitions to
+ * `processing`, so concurrent workers (server poll, CLI, MCP, route) can never
+ * claim the same job twice. Returns the number of rows changed (1 = claimed,
+ * 0 = already claimed, not pending, or missing).
+ */
+export declare function claimSessionJob(id: string, db?: Database): number;
+/**
+ * Requeue jobs stranded in `processing` by a crashed processor.
+ * Resets rows whose claim started before the cutoff back to `pending` so the
+ * poll re-picks them up. The cutoff is a JS-computed ISO-8601 timestamp
+ * (matching the `started_at` written by claimSessionJob / updateSessionJob);
+ * SQLite's `datetime('now')` must NOT be used here — its format differs from
+ * the ISO-8601 stored by `now()` and would compare lexically wrong. Returns
+ * the number of rows recovered.
+ */
+export declare function recoverStaleProcessingJobs(maxAgeMs: number, db?: Database): number;
+//# sourceMappingURL=session-jobs.d.ts.map

package/dist/db/session-jobs.d.ts.map

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

package/dist/db/store-backend.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The transport that reads and writes will actually use.
+ *
+ * - `local-sqlite`   — the on-disk SQLite file at `db_path` is authoritative.
+ * - `cloud-api`      — authed HTTPS to the server (the shared store).
+ * - `cloud-postgres` — a direct Postgres DSN; server-only, never a client.
+ */
+export type StoreBackend = "local-sqlite" | "cloud-api" | "cloud-postgres";
+export interface StoreBackendReport {
+    /** Machine-readable contract for scripts and test guards. */
+    schema: "mementos.store_backend.v1";
+    backend: StoreBackend;
+    /** True when the HTTPS client transport is engaged (client reads AND writes). */
+    api_mode: boolean;
+    /** The server data backend (sqlite | postgresql) — reported for diagnosis, NOT the client answer. */
+    server_backend: string;
+    /** The SQLite path that WOULD be used. Meaningful only for `local-sqlite`. */
+    db_path: string;
+    /**
+     * Cloud endpoint origin + prefix as CONFIGURED, not necessarily as used: it
+     * is still reported when an explicit DB_PATH has outranked it, because the
+     * operator needs to see what was set as well as what won. Read `backend` /
+     * `api_mode` for what is actually in force, and `selected_by` for why.
+     * Not a secret; the key is never included.
+     */
+    api_endpoint: string | null;
+    /**
+     * Whether an API key is CONFIGURED in the environment — again independent of
+     * whether it won. The value is never read or reported.
+     */
+    api_key_present: boolean;
+    /** Env key NAMES that produced this backend, or `"default"`. Names only. */
+    selected_by: string;
+}
+/**
+ * Resolve the effective store backend from the environment.
+ *
+ * Pure with respect to storage: touches no database, makes no network call, and
+ * never places a credential value in the returned report.
+ */
+export declare function resolveStoreBackend(): StoreBackendReport;
+//# sourceMappingURL=store-backend.d.ts.map

package/dist/db/store-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-backend.d.ts","sourceRoot":"","sources":["../../src/db/store-backend.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,qGAAqG;IACrG,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CAiDxD"}

package/dist/db/subscriptions.d.ts

@@ -0,0 +1,24 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export interface Subscription {
+    id: string;
+    agent_id: string;
+    key_pattern: string | null;
+    tag_pattern: string | null;
+    scope: string | null;
+}
+export interface CreateSubscriptionInput {
+    agent_id: string;
+    key_pattern?: string | null;
+    tag_pattern?: string | null;
+    scope?: string | null;
+}
+export declare function createSubscription(input: CreateSubscriptionInput, db?: Database): Subscription;
+export declare function deleteSubscription(id: string, db?: Database): boolean;
+/**
+ * Compute human-readable change notifications for an agent: recently changed
+ * memories (last 10 minutes) matching that agent's subscriptions, excluding the
+ * agent's own writes. Encapsulates the whole two-query workflow so callers
+ * (memory_inject) never touch SQLite directly.
+ */
+export declare function getSubscriptionNotifications(agentId: string, db?: Database): string[];
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/db/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/db/subscriptions.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,CAmB9F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAqCrF"}