@hasna/mementos 0.14.86 → 0.14.88

package/dist/cli/register-all.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from "commander";
+/**
+ * Attach EVERY command group to `program`, in the order the CLI presents them.
+ *
+ * This is the single registration list. `index.tsx` calls it to build the real
+ * CLI, and `global-options.test.ts` calls it to walk the real option tables — so
+ * the structural short-flag guard cannot silently check a smaller tree than the
+ * one that ships.
+ *
+ * That drift was real: the guard originally re-listed 11 groups by hand while
+ * the CLI wired 15 sources, leaving `init`, `project-panel`, `brains` and the
+ * `@hasna/events` groups (`events`, `webhooks`) unwalked. Seven live `-j`
+ * collisions sat in that blind spot while the guard reported clean. Adding a
+ * command group here is now the only step required for it to be covered.
+ */
+export declare function registerAllCommands(program: Command): Command;
+//# sourceMappingURL=register-all.d.ts.map

package/dist/cli/register-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all.d.ts","sourceRoot":"","sources":["../../src/cli/register-all.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAiB7D"}

package/dist/cli/startup-side-effects.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+/**
+ * Mark a command as having no startup database access, and return it so it can
+ * be used inline at the end of a builder chain.
+ */
+export declare function withoutStartupDbAccess<T extends Command>(command: T): T;
+/** Whether the command about to run has opted out of the startup DB access. */
+export declare function skipsStartupDbAccess(command: Command | undefined): boolean;
+//# sourceMappingURL=startup-side-effects.d.ts.map

package/dist/cli/startup-side-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-side-effects.d.ts","sourceRoot":"","sources":["../../src/cli/startup-side-effects.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGvE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAE1E"}

package/dist/db/__fixtures__/fail-closed-stub-server.d.ts

@@ -0,0 +1,2 @@
+declare const server: Bun.Server<undefined>;
+//# sourceMappingURL=fail-closed-stub-server.d.ts.map

package/dist/db/__fixtures__/fail-closed-stub-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-closed-stub-server.d.ts","sourceRoot":"","sources":["../../../src/db/__fixtures__/fail-closed-stub-server.ts"],"names":[],"mappings":"AAqBA,QAAA,MAAM,MAAM,uBAyCV,CAAC"}

package/dist/db/__fixtures__/list-filter-capture-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-filter-capture-server.d.ts.map

package/dist/db/__fixtures__/list-filter-capture-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-filter-capture-server.d.ts","sourceRoot":"","sources":["../../../src/db/__fixtures__/list-filter-capture-server.ts"],"names":[],"mappings":""}

package/dist/db/__fixtures__/list-filter-client-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-filter-client-runner.d.ts.map

package/dist/db/__fixtures__/list-filter-client-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-filter-client-runner.d.ts","sourceRoot":"","sources":["../../../src/db/__fixtures__/list-filter-client-runner.ts"],"names":[],"mappings":""}

package/dist/db/acl.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Memory Access Control Lists (ACLs).
+ *
+ * Fine-grained permissions beyond scopes: read-only, read-write, admin
+ * per agent per key pattern. Default: no ACLs = full access (backward compat).
+ */
+import { SqliteAdapter as Database } from "../storage.js";
+export type AclPermission = "read" | "readwrite" | "admin";
+export interface MemoryAcl {
+    id: string;
+    agent_id: string;
+    key_pattern: string;
+    permission: AclPermission;
+    project_id: string | null;
+    created_at: string;
+}
+/**
+ * Set an ACL rule. Upserts by agent_id + key_pattern.
+ */
+export declare function setAcl(agentId: string, keyPattern: string, permission: AclPermission, projectId?: string, db?: Database): MemoryAcl;
+/**
+ * List ACLs for an agent.
+ */
+export declare function listAcls(agentId: string, db?: Database): MemoryAcl[];
+/**
+ * Remove an ACL rule.
+ */
+export declare function removeAcl(id: string, db?: Database): boolean;
+/**
+ * Check if an agent has the required permission for a memory key.
+ * Returns true if allowed (no ACLs = full access).
+ */
+export declare function checkPermission(agentId: string, memoryKey: string, requiredPermission: "read" | "write", db?: Database): boolean;
+//# sourceMappingURL=acl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acl.d.ts","sourceRoot":"","sources":["../../src/db/acl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,aAAa,EACzB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,CAeX;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAGpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAI5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GAAG,OAAO,EACpC,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAqBT"}

package/dist/db/agents.d.ts

@@ -0,0 +1,35 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Agent } from "../types/index.js";
+export interface AgentListFilter {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Resolve the NAME of the agent currently doing the writing, without any CLI
+ * flag. Sources, in order:
+ *
+ *   1. `MEMENTOS_AGENT` — this package's existing identity convention (already
+ *      consumed by `init` and the sessions connector).
+ *   2. `~/.hasna/conversations/agent-id` — the fleet's machine-level identity
+ *      surface, written by `conversations agents register`.
+ *
+ * Returns null when neither source yields a non-empty name. An unreadable or
+ * missing identity file is treated as absent — a write must never fail merely
+ * because the identity file was mid-write.
+ */
+export declare function resolveWritingAgentName(): string | null;
+export declare function registerAgent(name: string, sessionId?: string, description?: string, role?: string, projectId?: string, db?: Database): Agent;
+export declare function getAgent(idOrName: string, db?: Database): Agent | null;
+export declare function listAgents(db?: Database): Agent[];
+export declare function listAgents(filter: AgentListFilter, db?: Database): Agent[];
+export declare function touchAgent(idOrName: string, db?: Database): void;
+export declare function listAgentsByProject(projectId: string, db?: Database): Agent[];
+export declare function listAgentsByProject(projectId: string, filter: AgentListFilter, db?: Database): Agent[];
+export declare function updateAgent(id: string, updates: {
+    name?: string;
+    description?: string;
+    role?: string;
+    metadata?: Record<string, unknown>;
+    active_project_id?: string | null;
+}, db?: Database): Agent | null;
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAcvD;AAgBD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CA0EP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CA6Bd;AA+CD,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAAC;AACnD,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAAC;AAsB5E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAahE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAAC;AAC/E,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,EACvB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,EAAE,CAAC;AA0BX,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACtI,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAsDd"}

package/dist/db/analytics.d.ts

@@ -0,0 +1,124 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { MemoryScope, MemoryStats } from "../types/index.js";
+export declare function getMemoryStats(db?: Database): MemoryStats;
+export interface ActivityFilter {
+    days?: number;
+    scope?: MemoryScope;
+    agent_id?: string;
+    project_id?: string;
+}
+export interface ActivityRow {
+    date: string;
+    memories_created: number;
+    global_count?: number;
+    shared_count?: number;
+    private_count?: number;
+    avg_importance?: number;
+}
+export interface ActivityResult {
+    activity: ActivityRow[];
+    days: number;
+    total: number;
+}
+export declare function getMemoryActivity(filter?: ActivityFilter, db?: Database): ActivityResult;
+export interface ReportFilter {
+    days?: number;
+    project_id?: string;
+    agent_id?: string;
+}
+export interface MemoryReport {
+    total: number;
+    pinned: number;
+    days: number;
+    recent: {
+        total: number;
+        activity: {
+            date: string;
+            memories_created: number;
+        }[];
+    };
+    by_scope: Record<string, number>;
+    by_category: Record<string, number>;
+    top_memories: {
+        id: string;
+        key: string;
+        value: string;
+        importance: number;
+        scope: string;
+        category: string;
+    }[];
+    top_agents: {
+        agent_id: string;
+        c: number;
+    }[];
+}
+export declare function getMemoryReport(filter?: ReportFilter, db?: Database): MemoryReport;
+export interface StaleFilter {
+    days?: number;
+    project_id?: string;
+    agent_id?: string;
+    /** Scope the check to pinned rows (true) or unpinned rows (false). When
+     * undefined, pinned rows stay excluded — the pre-existing contract — so a
+     * caller must opt in to review the pinned subset. */
+    pinned?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface StaleMemory {
+    id: string;
+    key: string;
+    value: string;
+    importance: number;
+    scope: string;
+    category: string;
+    accessed_at: string | null;
+    access_count: number;
+    created_at?: string;
+}
+export interface StalePage {
+    rows: StaleMemory[];
+    /** True total of stale memories matching the filter — never the page length. */
+    total: number;
+    has_more: boolean | undefined;
+    next_cursor: number | null;
+}
+/**
+ * One bounded page of the stale surface, with the TRUE total and an explicit
+ * pagination signal. The server caps single responses and answers with
+ * `total` / `has_more` / `next_cursor`, so a page never silently truncates.
+ */
+export declare function getStaleMemoriesPage(filter?: StaleFilter, db?: Database): StalePage;
+export declare function getStaleMemories(filter?: StaleFilter, db?: Database): StaleMemory[];
+export interface HealthFilter {
+    stale_days?: number;
+    forgotten_days?: number;
+    project_id?: string;
+    agent_id?: string;
+    limit?: number;
+}
+export interface MemoryHealth {
+    stale: {
+        id: string;
+        key: string;
+        value: string;
+        importance: number;
+        scope: string;
+        created_at: string;
+    }[];
+    forgotten: {
+        id: string;
+        key: string;
+        value: string;
+        importance: number;
+        scope: string;
+        accessed_at: string | null;
+    }[];
+    dupes: {
+        key: string;
+        cnt: number;
+        latest: string;
+        oldest: string;
+    }[];
+}
+export declare function getMemoryHealth(filter?: HealthFilter, db?: Database): MemoryHealth;
+//# sourceMappingURL=analytics.d.ts.map

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

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

package/dist/db/api-mode.d.ts

@@ -0,0 +1,127 @@
+export interface ApiConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+export declare const API_URL_ENV_KEYS: readonly ["HASNA_MEMENTOS_API_URL", "MEMENTOS_API_URL"];
+export declare const API_KEY_ENV_KEYS: readonly ["HASNA_MEMENTOS_API_KEY", "MEMENTOS_API_KEY"];
+export declare const DATABASE_URL_ENV_KEYS: readonly ["HASNA_MEMENTOS_DATABASE_URL", "MEMENTOS_DATABASE_URL"];
+/**
+ * Which env keys currently select API mode, by name only — never the values.
+ * Used by the operator-facing mode report so a human can see *why* the client
+ * is pointed at the cloud without reading source or echoing a credential.
+ */
+export declare function getApiModeEnvSources(): {
+    urlKey: string | null;
+    keyKey: string | null;
+    databaseUrlKey: string | null;
+};
+/**
+ * What the environment CONFIGURES, regardless of which store finally wins.
+ *
+ * Distinct from {@link getApiConfig}, which answers "may I build a cloud
+ * request?" and returns null once an explicit DB_PATH outranks the credentials
+ * (precedence 1). An operator report needs both halves separately: conflating
+ * them prints "no API key configured" at someone whose key is configured and
+ * merely outranked, which points them at a credential problem they do not have.
+ *
+ * Never returns a credential value — the endpoint is not secret, the key is
+ * reported only as a boolean.
+ */
+export declare function getConfiguredApiEnv(): {
+    baseUrl: string | null;
+    apiKeyPresent: boolean;
+    dbPathKey: string | null;
+};
+/**
+ * Escape hatch for a test that genuinely must reach a non-loopback endpoint.
+ * Opt-in by design: the default has to be safe, because the failure it prevents
+ * is silent and lands in a shared store.
+ */
+export declare const ALLOW_REMOTE_API_IN_TESTS_ENV = "MEMENTOS_ALLOW_REMOTE_API_IN_TESTS";
+/** Resolve the API client config from env, or `null` when not configured. */
+/** The env keys that explicitly select the local SQLite store. */
+export declare const DB_PATH_ENV_KEYS: readonly ["HASNA_MEMENTOS_DB_PATH", "MEMENTOS_DB_PATH"];
+/** Raised when the environment does not unambiguously select one store. */
+export declare class MementosStoreConfigError extends Error {
+    readonly code = "MEMENTOS_STORE_CONFIG";
+    constructor(message: string);
+}
+/**
+ * Throw unless the environment unambiguously selects one store.
+ *
+ * AMBIGUOUS CONFIGURATION IS AN ERROR, NOT A DEFAULT. Half an API configuration
+ * used to resolve to `null`, which every caller read as "local SQLite" — so an
+ * operator whose API key failed to load silently got a different, usually stale,
+ * dataset with no error and no flag. From the caller's side that is
+ * indistinguishable from a store that is working.
+ *
+ * THIS FUNCTION ONLY ASSERTS. It returns `void`, so it cannot select anything —
+ * the precedence table below describes the RESOLVER, which is `getApiConfig()`
+ * immediately after it, and each early `return` here only suppresses the
+ * ambiguity error for a case that is already unambiguous. Steps 1 and 2 are
+ * therefore implemented in `getApiConfig()` and `isApiMode()` respectively, and
+ * the table is documented here because this is where the error text lives.
+ *
+ * Keeping the table honest about that is not cosmetic. Until 2026-08-03 step 1
+ * was implemented NOWHERE: the `return` below reads as a selection, and an
+ * operator who read it concluded that a scratch DB_PATH made them safe while a
+ * fully-configured environment still routed every read and write to the shared
+ * production store.
+ *
+ * Precedence, highest first:
+ *  0. A retired storage-mode variable (HASNA_MEMENTOS_STORAGE_MODE or any of
+ *     its aliases) throws via `assertNoLegacyStorageMode`, even when blank.
+ *     Deployment modes no longer exist; a stale variable is an error, never a
+ *     selector. ENFORCED HERE, before anything else.
+ *  1. An explicit SQLite path (`HASNA_MEMENTOS_DB_PATH` / `MEMENTOS_DB_PATH`) is
+ *     the narrowest, most specific signal and selects LOCAL, so local dev,
+ *     tooling and import/export keep working when a stray credential is exported
+ *     globally. ENFORCED in `getApiConfig()`, which returns null for it.
+ *  2. A client DSN present disables API mode. ENFORCED in `isApiMode()`. A DSN
+ *     on a client is forbidden and is tracked separately in database.ts.
+ *  3. Both API URL and API key present -> API mode.
+ *  4. Exactly ONE of them present -> ERROR naming the missing variable.
+ *  5. Neither present -> LOCAL. The documented single-operator default.
+ *
+ * Never reads, logs, or embeds a credential value — only variable NAMES.
+ */
+export declare function assertUnambiguousStoreEnv(env?: NodeJS.ProcessEnv): void;
+export declare function getApiConfig(): ApiConfig | null;
+/**
+ * True when the client should route memory operations to the cloud API.
+ * Fail-closed against a client-side DSN: if DATABASE_URL is present, API mode
+ * refuses to engage so the two transports never mix.
+ */
+export declare function isApiMode(): boolean;
+export declare class ApiRequestError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(message: string, status: number, body: string);
+}
+export interface ApiJsonOptions {
+    /**
+     * Treat `404` as a normal outcome and return `{status: 404, data: undefined}`
+     * instead of throwing. ONLY for callers where "absent" is a real answer —
+     * a GET of one record by id, a DELETE that tolerates an already-gone row, or
+     * a call that has an explicit fallback for a route an older server image does
+     * not serve yet (see `runCleanupViaApi`).
+     *
+     * It must never be set on a create/upsert path. A 404 there means the route
+     * did not exist on the server (client/server version skew, wrong base URL),
+     * so nothing was written; returning success-shaped data made the CLI print
+     * "Saved:" and exit 0 having persisted nothing. Default is fail-closed.
+     */
+    allow404?: boolean;
+}
+/**
+ * Authed JSON request. Throws {@link ApiRequestError} on every non-2xx,
+ * including 404, unless the caller opts into 404 pass-through via
+ * {@link ApiJsonOptions.allow404}.
+ */
+export declare function apiJson<T = unknown>(method: string, path: string, body?: unknown, options?: ApiJsonOptions): {
+    status: number;
+    data: T;
+};
+/** Build a query string from a filter object (skips undefined/null/empty). */
+export declare function toQuery(params: Record<string, unknown>): string;
+//# sourceMappingURL=api-mode.d.ts.map

package/dist/db/api-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-mode.d.ts","sourceRoot":"","sources":["../../src/db/api-mode.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AASD,eAAO,MAAM,gBAAgB,yDAA0D,CAAC;AACxF,eAAO,MAAM,gBAAgB,yDAA0D,CAAC;AACxF,eAAO,MAAM,qBAAqB,mEAAoE,CAAC;AAsBvG;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMtH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAOA;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,uCAAuC,CAAC;AAyDlF,6EAA6E;AAC7E,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,yDAA0D,CAAC;AAExF,2EAA2E;AAC3E,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,2BAA2B;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CA8BpF;AAED,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAyB/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AA0GD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAkC7B;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAe/D"}

package/dist/db/audit.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Immutable audit log queries.
+ * The audit_log table is append-only — never UPDATE or DELETE from it.
+ */
+import { SqliteAdapter as Database } from "../storage.js";
+export interface AuditEntry {
+    id: string;
+    memory_id: string;
+    memory_key: string | null;
+    operation: "create" | "update" | "delete" | "archive" | "restore" | "read";
+    agent_id: string | null;
+    /**
+     * md5 hex digest of the value the row held BEFORE the operation, or `null`.
+     *
+     * `null` means the digest is UNAVAILABLE, never that the value was empty. It is
+     * the honest answer on SQLite, which has no `md5()` and whose driver
+     * (`bun:sqlite`) exposes no user-defined-function API, so a trigger cannot
+     * compute one. Postgres computes `md5(COALESCE(...))` natively and populates it.
+     *
+     * So: compare `md5(candidate)` against a NON-NULL value to prove what a row
+     * held. A `null` is a statement about the BACKEND and must never be read as
+     * evidence about the content — treating it as a failed match is the confident
+     * wrong answer migration 37 exists to prevent.
+     */
+    old_value_hash: string | null;
+    /** md5 hex digest of the value AFTER the operation, or `null`. See `old_value_hash`. */
+    new_value_hash: string | null;
+    changes: Record<string, unknown>;
+    created_at: string;
+}
+/**
+ * Get audit trail for a specific memory.
+ */
+export declare function getMemoryAuditTrail(memoryId: string, limit?: number, db?: Database): AuditEntry[];
+/**
+ * Export full audit log for compliance reporting.
+ */
+export declare function exportAuditLog(options?: {
+    since?: string;
+    until?: string;
+    operation?: string;
+    agent_id?: string;
+    limit?: number;
+}, db?: Database): AuditEntry[];
+/**
+ * Get audit stats — operation counts, most active agents, etc.
+ */
+export declare function getAuditStats(db?: Database): {
+    total_entries: number;
+    by_operation: Record<string, number>;
+    recent_24h: number;
+};
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/db/audit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;;;;;;;;OAYG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,wFAAwF;IACxF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,UAAU,EAAE,CAMd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,UAAU,EAAE,CA6Bd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB,CAkBA"}

package/dist/db/database.d.ts

@@ -0,0 +1,26 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export declare function getDbPath(): string;
+export declare function getDatabase(dbPath?: string): Database;
+export declare function closeDatabase(): void;
+export declare function resetDatabase(): void;
+export declare function now(): string;
+export declare function uuid(): string;
+export declare function shortUuid(): string;
+/**
+ * Escape the SQL `LIKE` metacharacters so a caller-supplied id prefix is matched
+ * LITERALLY rather than as a pattern.
+ *
+ * `\` is replaced FIRST, or the backslashes this function itself introduces
+ * would be escaped a second time and the pattern would match nothing.
+ *
+ * Escaping is the right remedy here rather than rejecting any prefix outside the
+ * UUID charset `[0-9a-f-]`, because the id space is not UUID-only in practice:
+ * `bulkUpsertMemories` writes a caller-supplied `id` verbatim and validates no
+ * charset, so an imported row can legitimately carry `_` or `%` in its id. A
+ * charset rejection would make exactly those rows unaddressable by prefix, which
+ * trades a wrong-row deletion for a silent inability to reach a real row.
+ * Escaping fixes the injection at the root while keeping every id addressable.
+ */
+export declare function escapeLikePrefix(s: string): string;
+export declare function resolvePartialId(db: Database, table: string, partialId: string): string | null;
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,QAAQ,EAK1B,MAAM,eAAe,CAAC;AAuDvB,wBAAgB,SAAS,IAAI,MAAM,CA6BlC;AAqDD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAoGrD;AAgDD,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAuBf"}

package/dist/db/entities.d.ts

@@ -0,0 +1,62 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Entity, CreateEntityInput, UpdateEntityInput, EntityType } from "../types/index.js";
+export declare function parseEntityRow(row: Record<string, unknown>): Entity;
+export declare function createEntity(input: CreateEntityInput, db?: Database): Entity;
+export declare function getEntity(id: string, db?: Database): Entity;
+export declare function getEntityByName(name: string, type?: EntityType, projectId?: string, db?: Database): Entity | null;
+export declare function listEntities(filter?: {
+    type?: EntityType;
+    project_id?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}, db?: Database): Entity[];
+export declare function updateEntity(id: string, input: UpdateEntityInput, db?: Database): Entity;
+export declare function deleteEntity(id: string, db?: Database): void;
+export declare function mergeEntities(sourceId: string, targetId: string, db?: Database): Entity;
+export interface DuplicateEntityPair {
+    entity_a: Entity;
+    entity_b: Entity;
+    similarity: number;
+}
+/**
+ * Find potential duplicate entities by name similarity within same type+project.
+ * Returns pairs above the threshold (default 0.8) sorted by similarity descending.
+ */
+export declare function findDuplicateEntities(threshold?: number, db?: Database): DuplicateEntityPair[];
+export interface GraphTraversalPath {
+    entities: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    relations: Array<{
+        id: string;
+        relation_type: string;
+        weight: number;
+    }>;
+    depth: number;
+}
+export interface GraphTraversalResult {
+    paths: GraphTraversalPath[];
+    visited_entities: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    total_paths: number;
+}
+/**
+ * Multi-hop graph traversal using a recursive CTE.
+ *
+ * Starts from `startEntityId` and follows relations up to `max_depth` hops,
+ * returning all discovered paths. Handles cycles by tracking visited entities
+ * in each path. Supports direction filtering and relation-type filtering.
+ */
+export declare function graphTraverse(startEntityId: string, options?: {
+    max_depth?: number;
+    relation_types?: string[];
+    direction?: "outgoing" | "incoming" | "both";
+    limit?: number;
+}, db?: Database): GraphTraversalResult;
+//# sourceMappingURL=entities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/db/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAQ3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWnE;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmE5E;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAkB3D;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CAgCf;AAMD,wBAAgB,YAAY,CAC1B,MAAM,GAAE;IACN,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CA+CV;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAsCR;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAS5D;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAyER;AAgCD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,MAAY,EACvB,EAAE,CAAC,EAAE,QAAQ,GACZ,mBAAmB,EAAE,CA2CvB;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,gBAAgB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,oBAAoB,CA4JtB"}

package/dist/db/entity-memories.d.ts

@@ -0,0 +1,34 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Entity, Memory, EntityMemory, EntityRole } from "../types/index.js";
+/**
+ * Link an entity to a memory. Uses INSERT OR IGNORE so duplicate links
+ * are silently ignored rather than throwing an error.
+ */
+export declare function linkEntityToMemory(entityId: string, memoryId: string, role?: EntityRole, db?: Database): EntityMemory;
+/**
+ * Remove the link between an entity and a memory.
+ */
+export declare function unlinkEntityFromMemory(entityId: string, memoryId: string, db?: Database): void;
+/**
+ * Get all memories linked to a given entity.
+ * Performs a JOIN with the memories table to return full Memory objects.
+ */
+export declare function getMemoriesForEntity(entityId: string, db?: Database): Memory[];
+/**
+ * Get all entities linked to a given memory.
+ * Performs a JOIN with the entities table to return full Entity objects.
+ */
+export declare function getEntitiesForMemory(memoryId: string, db?: Database): Entity[];
+/**
+ * Link multiple entities to a single memory inside a transaction.
+ */
+export declare function bulkLinkEntities(entityIds: string[], memoryId: string, role?: EntityRole, db?: Database): void;
+/**
+ * Query entity-memory links with optional filters.
+ * - Pass entityId only to get all links for that entity.
+ * - Pass memoryId only to get all links for that memory.
+ * - Pass both to get the specific link (if it exists).
+ * - Pass neither to get all links.
+ */
+export declare function getEntityMemoryLinks(entityId?: string, memoryId?: string, db?: Database): EntityMemory[];
+//# sourceMappingURL=entity-memories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-memories.d.ts","sourceRoot":"","sources":["../../src/db/entity-memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiClF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,UAAsB,EAC5B,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,CAyBd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAaN;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CAmBV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CAYV;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,UAAsB,EAC5B,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAaN;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAsBhB"}

package/dist/db/feedback.d.ts

@@ -0,0 +1,9 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export interface FeedbackInput {
+    message: string;
+    email?: string | null;
+    category?: string | null;
+    version?: string | null;
+}
+export declare function saveFeedback(input: FeedbackInput, db?: Database): void;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/db/feedback.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAiBtE"}