@hasna/mementos 0.14.86 → 0.14.87

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;AAkDvB,wBAAgB,SAAS,IAAI,MAAM,CAwBlC;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"}

package/dist/db/locks.d.ts

@@ -0,0 +1,63 @@
+import { SqliteAdapter as Database } from "../storage.js";
+export type ResourceType = "project" | "memory" | "entity" | "agent" | "connector" | "file";
+export type LockType = "advisory" | "exclusive";
+export interface ResourceLock {
+    id: string;
+    resource_type: ResourceType;
+    resource_id: string;
+    agent_id: string;
+    lock_type: LockType;
+    locked_at: string;
+    expires_at: string;
+}
+/**
+ * Acquire a lock on a resource.
+ * - advisory: multiple agents can hold advisory locks simultaneously
+ * - exclusive: only one agent can hold an exclusive lock at a time
+ *
+ * Returns the lock if acquired, null if blocked by an existing exclusive lock.
+ * TTL is in seconds (default: 5 minutes).
+ */
+export declare function acquireLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, ttlSeconds?: number, db?: Database): ResourceLock | null;
+/**
+ * Release a specific lock by ID. Only the owning agent can release it.
+ * Returns true if released, false if not found or not owned.
+ */
+export declare function releaseLock(lockId: string, agentId: string, db?: Database): boolean;
+/**
+ * Release all locks held by an agent on a specific resource.
+ */
+export declare function releaseResourceLocks(agentId: string, resourceType: ResourceType, resourceId: string, db?: Database): number;
+/**
+ * Release all locks held by an agent (e.g., on session end).
+ */
+export declare function releaseAllAgentLocks(agentId: string, db?: Database): number;
+/**
+ * Check if a resource is currently locked.
+ * Returns the active lock(s) or empty array.
+ */
+export declare function checkLock(resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock[];
+/**
+ * Check if a specific agent holds a lock on a resource.
+ */
+export declare function agentHoldsLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock | null;
+/**
+ * List all active locks for an agent.
+ */
+export declare function listAgentLocks(agentId: string, db?: Database): ResourceLock[];
+/**
+ * Delete all expired locks. Called automatically by other lock functions.
+ */
+export interface ExpiredLockInfo {
+    id: string;
+    resource_type: string;
+    resource_id: string;
+    agent_id: string;
+    lock_type: string;
+}
+/**
+ * Clean expired locks and return info about what was cleaned for notification purposes.
+ */
+export declare function cleanExpiredLocksWithInfo(db?: Database): ExpiredLockInfo[];
+export declare function cleanExpiredLocks(db?: Database): number;
+//# sourceMappingURL=locks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAC5F,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuErB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAgBnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAW3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAqBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAa7E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,eAAe,EAAE,CAS1E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAQvD"}

package/dist/db/machines.d.ts

@@ -0,0 +1,23 @@
+export interface Machine {
+    id: string;
+    name: string;
+    hostname: string;
+    platform: string;
+    is_primary: boolean;
+    created_at: string;
+    last_seen_at: string;
+}
+export declare function registerMachine(name?: string, db?: import("../storage.js").SqliteAdapter): Machine;
+export declare function listMachines(db?: import("../storage.js").SqliteAdapter): Machine[];
+export declare function getMachine(id: string, db?: import("../storage.js").SqliteAdapter): Machine | null;
+export declare function renameMachine(id: string, newName: string, db?: import("../storage.js").SqliteAdapter): Machine;
+export declare function getPrimaryMachine(db?: import("../storage.js").SqliteAdapter): Machine | null;
+export declare function getPrimaryMachineCandidate(db?: import("../storage.js").SqliteAdapter): Machine | null;
+export declare function setPrimaryMachine(id: string, db?: import("../storage.js").SqliteAdapter): Machine;
+export declare function deleteMachine(id: string, db?: import("../storage.js").SqliteAdapter): void;
+export declare function getFallbackSyncTargetMachine(db?: import("../storage.js").SqliteAdapter): Machine | null;
+export declare function getPrimaryMachineStartupWarning(db?: import("../storage.js").SqliteAdapter): string | null;
+export declare function touchMachine(id: string, db?: import("../storage.js").SqliteAdapter): void;
+/** Get or auto-register the current machine and return its ID. */
+export declare function getCurrentMachineId(db?: import("../storage.js").SqliteAdapter): string;
+//# sourceMappingURL=machines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"machines.d.ts","sourceRoot":"","sources":["../../src/db/machines.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAmBD,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,OAAO,CAgC1E;AAED,wBAAgB,YAAY,CAAC,EAAE,wCAAgB,GAAG,OAAO,EAAE,CAK1D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,OAAO,GAAG,IAAI,CAIzE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,OAAO,CAWtF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,wCAAgB,GAAG,OAAO,GAAG,IAAI,CAIpE;AAED,wBAAgB,0BAA0B,CAAC,EAAE,wCAAgB,GAAG,OAAO,GAAG,IAAI,CAK7E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,OAAO,CAezE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,IAAI,CAOlE;AAED,wBAAgB,4BAA4B,CAAC,EAAE,wCAAgB,GAAG,OAAO,GAAG,IAAI,CAE/E;AAED,wBAAgB,+BAA+B,CAAC,EAAE,wCAAgB,GAAG,MAAM,GAAG,IAAI,CASjF;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,wCAAgB,GAAG,IAAI,CAEjE;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,EAAE,wCAAgB,GAAG,MAAM,CAQ9D"}