@hasna/mementos 0.14.86 → 0.14.88

package/dist/server/openapi.d.ts

@@ -0,0 +1,2 @@
+export declare function buildOpenApiDocument(version: string): Record<string, unknown>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/server/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAeA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+N7E"}

package/dist/server/router.d.ts

@@ -0,0 +1,17 @@
+export type RouteHandler = (req: Request, url: URL, params: Record<string, string>) => Promise<Response> | Response;
+export interface Route {
+    method: string;
+    path: string;
+    pattern: RegExp;
+    paramNames: string[];
+    specificity: number;
+    order: number;
+    handler: RouteHandler;
+}
+export declare const routes: Route[];
+export declare function addRoute(method: string, path: string, handler: RouteHandler): void;
+export declare function matchRoute(method: string, pathname: string): {
+    handler: RouteHandler;
+    params: Record<string, string>;
+} | null;
+//# sourceMappingURL=router.d.ts.map

package/dist/server/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/server/router.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,EAAO,CAAC;AAUlC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,IAAI,CAeN;AAWD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAiClE"}

package/dist/server/routes/agents.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agents.d.ts.map

package/dist/server/routes/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/server/routes/agents.ts"],"names":[],"mappings":""}

package/dist/server/routes/entities.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entities.d.ts.map

package/dist/server/routes/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/server/routes/entities.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-bulk.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-bulk.d.ts.map

package/dist/server/routes/memories-bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-bulk.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-bulk.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-crud.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-crud.d.ts.map

package/dist/server/routes/memories-crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-crud.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-crud.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-io.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-io.d.ts.map

package/dist/server/routes/memories-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-io.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-io.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-misc.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-misc.d.ts.map

package/dist/server/routes/memories-misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-misc.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-misc.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-search.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-search.d.ts.map

package/dist/server/routes/memories-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-search.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-search.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories-stats.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memories-stats.d.ts.map

package/dist/server/routes/memories-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories-stats.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories-stats.ts"],"names":[],"mappings":""}

package/dist/server/routes/memories.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory routes have been split into separate modules:
+ * - memories-crud.ts: list, get, create, update, delete, versions
+ * - memories-stats.ts: stats, metrics, activity, stale, report
+ * - memories-search.ts: search, hybrid, bm25
+ * - memories-bulk.ts: bulk-forget, bulk-update
+ * - memories-io.ts: export, import
+ * - memories-misc.ts: health, extract, clean, inject
+ *
+ * This stub remains for backwards compatibility.
+ */
+import "./memories-crud.js";
+import "./memories-stats.js";
+import "./memories-search.js";
+import "./memories-bulk.js";
+import "./memories-io.js";
+import "./memories-misc.js";
+import "./memory-project-link.js";
+//# sourceMappingURL=memories.d.ts.map

package/dist/server/routes/memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,0BAA0B,CAAC"}

package/dist/server/routes/memory-project-link.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-project-link.d.ts.map

package/dist/server/routes/memory-project-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-project-link.d.ts","sourceRoot":"","sources":["../../../src/server/routes/memory-project-link.ts"],"names":[],"mappings":""}

package/dist/server/routes/project-registration.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-registration.d.ts.map

package/dist/server/routes/project-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registration.d.ts","sourceRoot":"","sources":["../../../src/server/routes/project-registration.ts"],"names":[],"mappings":""}

package/dist/server/routes/projects.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.d.ts.map

package/dist/server/routes/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/server/routes/projects.ts"],"names":[],"mappings":""}

package/dist/server/routes/system-auto-memory.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemAutoMemoryRoutes(): void;
+//# sourceMappingURL=system-auto-memory.d.ts.map

package/dist/server/routes/system-auto-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-auto-memory.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-auto-memory.ts"],"names":[],"mappings":"AASA,wBAAgB,8BAA8B,IAAI,IAAI,CA0DrD"}

package/dist/server/routes/system-chain.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemChainRoutes(): void;
+//# sourceMappingURL=system-chain.d.ts.map

package/dist/server/routes/system-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-chain.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-chain.ts"],"names":[],"mappings":"AAKA,wBAAgB,yBAAyB,IAAI,IAAI,CAOhD"}

package/dist/server/routes/system-consolidation.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemConsolidationRoutes(): void;
+//# sourceMappingURL=system-consolidation.d.ts.map

package/dist/server/routes/system-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-consolidation.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-consolidation.ts"],"names":[],"mappings":"AAYA,wBAAgB,iCAAiC,IAAI,IAAI,CA+CxD"}

package/dist/server/routes/system-hooks.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemHookRoutes(): void;
+//# sourceMappingURL=system-hooks.d.ts.map

package/dist/server/routes/system-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-hooks.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-hooks.ts"],"names":[],"mappings":"AAYA,wBAAgB,wBAAwB,IAAI,IAAI,CAyE/C"}

package/dist/server/routes/system-sessions.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemSessionRoutes(): void;
+//# sourceMappingURL=system-sessions.d.ts.map

package/dist/server/routes/system-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-sessions.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-sessions.ts"],"names":[],"mappings":"AAMA,wBAAgB,2BAA2B,IAAI,IAAI,CA2ClD"}

package/dist/server/routes/system-subscriptions.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemSubscriptionRoutes(): void;
+//# sourceMappingURL=system-subscriptions.d.ts.map

package/dist/server/routes/system-subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-subscriptions.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-subscriptions.ts"],"names":[],"mappings":"AASA,wBAAgB,gCAAgC,IAAI,IAAI,CAmCvD"}

package/dist/server/routes/system-synthesis.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemSynthesisRoutes(): void;
+//# sourceMappingURL=system-synthesis.d.ts.map

package/dist/server/routes/system-synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-synthesis.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-synthesis.ts"],"names":[],"mappings":"AAMA,wBAAgB,6BAA6B,IAAI,IAAI,CA6DpD"}

package/dist/server/routes/system-tools.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSystemToolRoutes(): void;
+//# sourceMappingURL=system-tools.d.ts.map

package/dist/server/routes/system-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system-tools.ts"],"names":[],"mappings":"AAOA,wBAAgB,wBAAwB,IAAI,IAAI,CAkE/C"}

package/dist/server/routes/system.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=system.d.ts.map

package/dist/server/routes/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/server/routes/system.ts"],"names":[],"mappings":""}

package/dist/server/routes/tasks.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/server/routes/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/server/routes/tasks.ts"],"names":[],"mappings":""}

package/dist/storage.d.ts

@@ -0,0 +1,298 @@
+import { Database } from "bun:sqlite";
+import type { Pool, PoolClient } from "pg";
+import { type ServerDataBackend } from "./generated/storage-kit/backend.js";
+/** Called once by the mementos-serve entrypoint; enables the server-only DSN path. */
+export declare function markServerContext(): void;
+export declare function resetServerContextForTests(): void;
+/** True only inside the `mementos-serve` server process. */
+export declare function isServerContext(): boolean;
+export interface RunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+export interface PreparedStatement {
+    run(...params: any[]): RunResult;
+    get(...params: any[]): any;
+    all(...params: any[]): any[];
+    finalize(): void;
+}
+export interface DbAdapter {
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    prepare(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+}
+export declare class SqliteAdapter implements DbAdapter {
+    private readonly db;
+    constructor(path: string);
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    query(sql: string): import("bun:sqlite").Statement<unknown, import("bun:sqlite").SQLQueryBindings[] | [null] | [string] | [number] | [bigint] | [false] | [true] | [Uint8Array<ArrayBufferLike>] | [Uint8ClampedArray<ArrayBufferLike>] | [Uint16Array<ArrayBufferLike>] | [Uint32Array<ArrayBufferLike>] | [Int8Array<ArrayBufferLike>] | [Int16Array<ArrayBufferLike>] | [Int32Array<ArrayBufferLike>] | [BigUint64Array<ArrayBufferLike>] | [BigInt64Array<ArrayBufferLike>] | [Float16Array<ArrayBufferLike>] | [Float32Array<ArrayBufferLike>] | [Float64Array<ArrayBufferLike>] | [Record<string, string | number | bigint | boolean | NodeJS.TypedArray<ArrayBufferLike> | null>]>;
+    prepare(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+    get raw(): Database;
+}
+export declare function translateSql(sql: string): string;
+export declare function shouldUsePgSsl(connectionString: string): boolean;
+/** Build a pg Pool with adapter-controlled SSL from a connection string. */
+export declare function makePool(connectionString: string): Pool;
+interface SyncQueryResult {
+    rows: any[];
+    rowCount: number;
+}
+/**
+ * Synchronous Postgres access backed by a worker thread (see
+ * `pg-sync-worker.ts`). The worker owns one long-lived `pg.Client` and runs
+ * queries on its own event loop; the main thread blocks on `Atomics.wait`
+ * against a SharedArrayBuffer until the worker writes the response. This is the
+ * only way to expose a truly synchronous API (which the entire mementos data
+ * layer requires) over async pg I/O without deadlocking the main event loop.
+ *
+ * Every query carries a monotonic generation that the worker echoes back in
+ * the status word when the response is ready. When a query times out it is
+ * ABANDONED, not cancelled — the worker still finishes it and writes its
+ * response later — and the generation is what lets the caller tell that late
+ * response apart from the response to the query currently waiting, so a stale
+ * payload can never be consumed by a newer query (todos 027d17e9).
+ */
+export declare class PgSyncPool {
+    private readonly worker;
+    private readonly status;
+    private readonly data;
+    private closed;
+    private lastError;
+    private generation;
+    private static readonly DATA_BYTES;
+    /**
+     * Per-query timeout in milliseconds, overridable via
+     * `MEMENTOS_PGSYNC_QUERY_TIMEOUT_MS` (default 60_000). Read on every query()
+     * call so tests can shrink it without import-order games — the regression
+     * test in `pg-sync-race.test.ts` relies on this being a live read.
+     */
+    private static queryTimeoutMs;
+    /**
+     * Resolve the worker entry file. `storage` is bundled into several entry
+     * points at different depths (dist/cli, dist/mcp, dist/server) as well as run
+     * directly from source, so probe candidate locations relative to this module.
+     */
+    private static resolveWorkerPath;
+    constructor(connectionString: string, workerPath?: string);
+    query(sql: string, params: any[]): SyncQueryResult;
+    end(): void;
+}
+export declare class PgAdapter implements DbAdapter {
+    private readonly pool;
+    constructor(connectionString: string);
+    constructor(pool: PgSyncPool);
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    prepare(sql: string): PreparedStatement;
+    /**
+     * Bun-sqlite-style `query()` shim so the CLI/MCP/server call sites that do
+     * `db.query(sql).get(...)` / `.all(...)` / `.run(...)` work unchanged against
+     * Postgres in the postgresql backend. Behaves like {@link prepare}.
+     */
+    query(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+    get raw(): PgSyncPool;
+}
+export declare class PgAdapterAsync {
+    private readonly pool;
+    constructor(connectionString: string);
+    constructor(pool: Pool);
+    run(sql: string, ...params: any[]): Promise<RunResult>;
+    get(sql: string, ...params: any[]): Promise<any>;
+    all(sql: string, ...params: any[]): Promise<any[]>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+    transaction<T>(fn: (client: PoolClient) => Promise<T>): Promise<T>;
+    get raw(): Pool;
+}
+export declare const MEMENTOS_STORAGE_TABLES: readonly ["projects", "agents", "machines", "sessions", "entities", "memories", "relations", "entity_memories", "memory_tags", "memory_versions", "memory_embeddings", "tool_events", "resource_locks", "memory_ratings"];
+export declare const STORAGE_TABLES: readonly ["projects", "agents", "machines", "sessions", "entities", "memories", "relations", "entity_memories", "memory_tags", "memory_versions", "memory_embeddings", "tool_events", "resource_locks", "memory_ratings"];
+export type MementosStorageTable = (typeof MEMENTOS_STORAGE_TABLES)[number];
+export declare const MEMENTOS_STORAGE_ENV: {
+    readonly databaseUrl: "HASNA_MEMENTOS_DATABASE_URL";
+};
+export declare const MEMENTOS_STORAGE_FALLBACK_ENV: {
+    readonly databaseUrl: "MEMENTOS_DATABASE_URL";
+};
+export interface StorageConfig {
+    rds: {
+        host: string;
+        port: number;
+        username: string;
+        password_env: string;
+        ssl: boolean;
+    };
+    auto_sync_interval_minutes: number;
+    feedback_endpoint: string;
+    sync: {
+        schedule_minutes: number;
+    };
+}
+export interface StorageEnv {
+    name: string;
+    deprecated: boolean;
+}
+export interface StorageEnvStatus {
+    name: string;
+    active_name: string;
+    configured: boolean;
+}
+/** The server data backend, from the shared storage kit: `sqlite | postgresql`. */
+export type StorageRuntimeKind = ServerDataBackend;
+export interface StorageRuntimeContract {
+    contract: "mementos-storage-runtime-v1";
+    kind: StorageRuntimeKind;
+    fail_closed: boolean;
+    local: {
+        adapter: "sqlite";
+        primary_runtime: boolean;
+        data_dir: string;
+        config_path: string;
+        local_file_sync: {
+            supported: false;
+            reason: string;
+        };
+    };
+    backend: {
+        adapter: "sqlite" | "postgres";
+        requested: boolean;
+        configured: boolean;
+        source: "env" | "config-file" | "none";
+        env_name: string | null;
+        redacted_url: string | null;
+        rds_compatible: boolean;
+        fail_closed: boolean;
+        missing: string[];
+    };
+    migrations: {
+        target: "postgres-rds-compatible";
+        command: "mementos storage migrate";
+        dry_run_command: "mementos storage migrate --dry-run";
+        configured: boolean;
+        mutates_remote_on_apply: true;
+        requires_approval_for_live_run: true;
+    };
+}
+export interface SafeStorageConfigSummary {
+    auto_sync_interval_minutes: number;
+    feedback_endpoint_configured: boolean;
+    sync: StorageConfig["sync"];
+    rds: {
+        host_configured: boolean;
+        port: number;
+        username_configured: boolean;
+        password_env: string;
+        password_configured: boolean;
+        ssl: boolean;
+    };
+}
+export interface NativeStorageStatus {
+    ok: boolean;
+    service: "mementos";
+    backend: StorageRuntimeKind;
+    local_default: boolean;
+    runtime: StorageRuntimeContract;
+    database: {
+        configured: boolean;
+        redacted_url: string | null;
+        source: "env" | "config-file" | "none";
+        env_name: string | null;
+        rds_compatible: boolean;
+    };
+    tables: readonly MementosStorageTable[];
+    env: {
+        databaseUrl: StorageEnvStatus;
+    };
+    issues: string[];
+    warnings: string[];
+    no_network: true;
+}
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function getStorageDatabaseEnv(): StorageEnv | null;
+export declare function getStorageDatabaseUrl(): string | null;
+export declare function getStorageDatabaseEnvName(): string;
+/**
+ * The server data backend selected by the environment: `postgresql` when
+ * HASNA_MEMENTOS_DATABASE_URL is set, `sqlite` otherwise. Runs the fail-loud
+ * ratchet first, so a retired storage-mode variable throws here rather than
+ * being silently ignored. Delegated to the vendored storage kit so the key
+ * spec and the ratchet cannot drift from the shared contract.
+ */
+export declare function getStorageBackend(env?: NodeJS.ProcessEnv): ServerDataBackend;
+/** The database URL for the selected server backend, or `null` when sqlite. */
+export declare function getStorageBackendDatabaseUrl(env?: NodeJS.ProcessEnv): string | null;
+export declare function getStorageConfig(): StorageConfig;
+export declare function redactDatabaseUrl(value: string | null): string | null;
+export interface PostgresConnectionStringValidation {
+    ok: boolean;
+    redacted_url: string | null;
+    issues: string[];
+}
+export declare function validatePostgresConnectionString(value: string | null): PostgresConnectionStringValidation;
+export declare function getSafeStorageConfigSummary(config?: StorageConfig): SafeStorageConfigSummary;
+export declare function getStorageStatus(): NativeStorageStatus;
+export declare const getMementosStorageStatus: typeof getStorageStatus;
+export declare function saveStorageConfig(config: StorageConfig): void;
+export declare function getStorageConnectionString(dbName?: string): string;
+/**
+ * Operator-only DSN resolution for the migrate commands.
+ *
+ * `storage migrate` / `migrate-pg` are deliberately-invoked operator commands
+ * (docs/CUTOVER-RUNBOOK.md §3): they run from an approved, database-reachable
+ * administrative environment — on this fleet, the ECS one-shot migrate task
+ * that holds the DSN via Secrets Manager as HASNA_MEMENTOS_DATABASE_URL, the
+ * same credential the serve task uses. The explicit `--connection-string` form
+ * was already sanctioned; this resolves the SAME configured DSN for the
+ * operator verb without forcing the value onto the command line.
+ *
+ * This is NOT the client data path. Every read/write surface (getDatabase,
+ * getCloudDatabase, storage-sync, MCP data tools) keeps the fail-closed guard
+ * in {@link getStorageConnectionString}. Only the migrate operator surfaces
+ * call this, and only they may: a DSN must already be present on the machine
+ * for the env/config form to resolve, so this adds no exfiltration surface.
+ */
+export declare function getStorageConnectionStringForOperator(dbName?: string): string;
+export declare const SYNC_EXCLUDED_TABLE_PATTERNS: RegExp[];
+export declare function isSyncExcludedTable(table: string): boolean;
+export declare function listSqliteTables(db: DbAdapter): string[];
+export interface IncrementalSyncStats {
+    table: string;
+    total_rows: number;
+    synced_rows: number;
+    skipped_rows: number;
+    errors: string[];
+    first_sync: boolean;
+}
+export interface SyncMeta {
+    table_name: string;
+    last_synced_at: string;
+    last_synced_row_count: number;
+    direction: "push" | "pull";
+}
+export interface IncrementalSyncOptions {
+    primaryKey?: string;
+    conflictColumn?: string;
+    batchSize?: number;
+}
+export declare function ensureSyncMetaTable(db: DbAdapter): void;
+export declare function incrementalSyncPush(local: DbAdapter, remote: DbAdapter, tables: string[], options?: IncrementalSyncOptions): IncrementalSyncStats[];
+export declare function incrementalSyncPull(remote: DbAdapter, local: DbAdapter, tables: string[], options?: IncrementalSyncOptions): IncrementalSyncStats[];
+export declare function getSyncMetaAll(db: DbAdapter): SyncMeta[];
+export declare function getSyncMetaForTable(db: DbAdapter, table: string): SyncMeta | null;
+export declare function resetSyncMeta(db: DbAdapter, table: string): void;
+export declare function resetAllSyncMeta(db: DbAdapter): void;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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