@hasna/mementos 0.14.86 → 0.14.88

package/dist/lib/importers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/importers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAM9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,YAAY,CAqB3D;AAMD,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,YAAY,CA8BzD;AAMD,UAAU,aAAa;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,YAAY,CAqBjE;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAOpF"}

package/dist/lib/injector.d.ts

@@ -0,0 +1,89 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { MemoryCategory, MementosConfig } from "../types/index.js";
+export type InjectionStrategy = "default" | "smart" | "smart-pipeline";
+export interface InjectionOptions {
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    max_tokens?: number;
+    categories?: MemoryCategory[];
+    min_importance?: number;
+    strategy?: InjectionStrategy;
+    query?: string;
+    machine_id?: string | null;
+    db?: Database;
+}
+export interface SmartInjectionOptions {
+    /** Free-text description of what the agent is currently doing */
+    task_context: string;
+    /** Project to scope memories to */
+    project_id?: string;
+    /** Agent to scope private memories to */
+    agent_id?: string;
+    /** Session for working memory */
+    session_id?: string;
+    /** Max tokens for the entire output (~4 chars/token) */
+    max_tokens?: number;
+    /** Minimum importance threshold (before decay) */
+    min_importance?: number;
+    /** Current machine ID for machine-local memory visibility */
+    machine_id?: string | null;
+    /** Force profile resynthesis even if cached */
+    force_profile_refresh?: boolean;
+    /** Optional DB handle */
+    db?: Database;
+}
+/** Structured result from the smart injection pipeline */
+export interface SmartInjectionResult {
+    /** Formatted markdown string ready for system prompt */
+    output: string;
+    /** Token estimate of the output */
+    token_estimate: number;
+    /** Number of memories included */
+    memory_count: number;
+    /** Whether the profile was loaded from cache */
+    profile_from_cache: boolean;
+    /** Tool names detected in task_context */
+    detected_tools: string[];
+}
+export declare class MemoryInjector {
+    private config;
+    private injectedIds;
+    constructor(config?: MementosConfig);
+    /**
+     * Get formatted injection context suitable for system prompt insertion.
+     * Produces structured output with Key Memories and Recent Context sections.
+     * Token-budget aware.
+     */
+    getInjectionContext(options?: InjectionOptions): string;
+    /**
+     * Async smart injection: scores memories by embedding similarity + importance + recency.
+     * Falls back to default strategy if no embeddings exist or no query is provided.
+     */
+    getSmartInjectionContext(options?: InjectionOptions): Promise<string>;
+    /**
+     * Reset the deduplication window (call between refresh intervals)
+     */
+    resetDedup(): void;
+    /**
+     * Get count of memories injected so far in this session
+     */
+    getInjectedCount(): number;
+}
+/**
+ * Smart injection pipeline — the full-featured context injection strategy.
+ *
+ * Pipeline stages:
+ * 1. Parse task context — accept a task_context string describing what the agent is doing
+ * 2. Load or synthesize agent/project profile
+ * 3. Activation match — semantic search against task_context when embeddings exist
+ * 4. Tool guide retrieval — pull tool stats/lessons if task mentions tools
+ * 5. Decay scoring — apply forgetting curve to all candidate memories
+ * 6. Layer by type — Profile > Core Facts > Tool Guides > Procedural > Preferences > History
+ * 7. Token budgeting — fit into max_tokens, trimming lowest-relevance items first
+ *
+ * Falls back gracefully: no embeddings -> keyword matching, no profile -> skip section,
+ * no tool mentions -> skip tool guides.
+ */
+export declare function smartInject(options: SmartInjectionOptions): Promise<SmartInjectionResult>;
+//# sourceMappingURL=injector.d.ts.map

package/dist/lib/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../src/lib/injector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAU,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiBhF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAMD,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB;IACzB,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAgBD,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,0CAA0C;IAC1C,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAA0B;gBAEjC,MAAM,CAAC,EAAE,cAAc;IAInC;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM;IA+L3D;;;OAGG;IACG,wBAAwB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4L/E;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG3B;AAkKD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2Q/F"}

package/dist/lib/machine-visibility.d.ts

@@ -0,0 +1,6 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { MemoryFilter, Memory } from "../types/index.js";
+export declare function resolveVisibleMachineId(machineId?: string | null, db?: Database): string | null;
+export declare function visibleToMachineFilter(machineId?: string | null, db?: Database): Pick<MemoryFilter, "visible_to_machine_id">;
+export declare function isMemoryVisibleToMachine(memory: Pick<Memory, "machine_id">, machineId?: string | null, db?: Database): boolean;
+//# sourceMappingURL=machine-visibility.d.ts.map

package/dist/lib/machine-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/machine-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAI7C;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAOT"}

package/dist/lib/matryoshka.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Matryoshka Embedding Slicing — 2-stage retrieval using variable-dimension embedding slices.
+ *
+ * Key insight: OpenAI text-embedding-3-small supports native dimension reduction.
+ * Halving the dimension keeps quality nearly intact, so a 384-dim slice is 4x faster
+ * to compare but nearly as accurate for shortlisting. We use this for a 2-stage search:
+ *   Stage 1: 384-dim slice → fast approximate shortlist (3x limit)
+ *   Stage 2: Full 1536-dim → precise rerank → top limit results
+ */
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Memory } from "../types/index.js";
+export interface MatryoshkaConfig {
+    /** Full embedding dimensions (1536 for text-embedding-3-small) */
+    full_dims: number;
+    /** Shortlist slice dimensions (1/4 of full for fast approximate search) */
+    shortlist_dims: number;
+    /** How many extra candidates to fetch in Stage 1 (multiplier of final limit) */
+    shortlist_multiplier: number;
+}
+export interface MatryoshkaSearchResult {
+    memory: Memory;
+    score: number;
+    shortlist_score: number;
+}
+/**
+ * Slice an embedding to the first `dims` dimensions.
+ * Exploits the Matryoshka property of text-embedding-3-small where
+ * leading dimensions carry the most information.
+ */
+export declare function sliceEmbedding(embedding: number[], dims: number): number[];
+/**
+ * L2 (Euclidean) normalize a vector to unit length.
+ * Required after slicing to ensure cosine similarity remains valid.
+ */
+export declare function l2Normalize(embedding: number[]): number[];
+/**
+ * 2-stage Matryoshka search:
+ *   1. Generate query embedding, slice to 384-dim, shortlist top N*3 candidates
+ *   2. Rerank shortlisted candidates using full 1536-dim embeddings
+ *
+ * Returns the top `limit` results ordered by full-dimension similarity.
+ */
+export declare function matryoshkaSearch(db: Database, query: string, opts?: {
+    limit?: number;
+    project_id?: string;
+    agent_id?: string;
+    config?: MatryoshkaConfig;
+    threshold?: number;
+}): Promise<MatryoshkaSearchResult[]>;
+//# sourceMappingURL=matryoshka.d.ts.map

package/dist/lib/matryoshka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matryoshka.d.ts","sourceRoot":"","sources":["../../src/lib/matryoshka.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYzD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IACL,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA+EnC"}

package/dist/lib/memory-lock.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OPE4-00111: Concurrent memory access coordination
+ *
+ * Uses the resource_locks table (Migration 8) to provide:
+ * - Advisory locks for read-heavy coordination
+ * - Exclusive locks to prevent simultaneous writes to the same key
+ *
+ * Design:
+ * - Reads: always parallel, no locking needed
+ * - Writes: agents SHOULD acquire an exclusive lock on the memory key before writing
+ *   The lock resource_id uses format: "{scope}:{key}:{agent_id}:{project_id}"
+ *   This prevents two agents overwriting the same shared memory simultaneously
+ * - Optimistic fallback: if lock can't be acquired, VersionConflictError from
+ *   updateMemory() provides a second layer of protection
+ */
+import { SqliteAdapter as Database } from "../storage.js";
+import { type ResourceLock } from "../db/locks.js";
+/**
+ * Compute the lock resource_id for a memory key.
+ * Scoped by scope + key + project so different projects don't block each other.
+ */
+export declare function memoryLockId(key: string, scope: string, projectId?: string | null): string;
+/**
+ * Acquire an exclusive write lock on a memory key.
+ * Returns the lock if acquired, null if another agent is writing.
+ */
+export declare function acquireMemoryWriteLock(agentId: string, key: string, scope: string, projectId?: string | null, ttlSeconds?: number, db?: Database): ResourceLock | null;
+/**
+ * Release a memory write lock.
+ */
+export declare function releaseMemoryWriteLock(lockId: string, agentId: string, db?: Database): boolean;
+/**
+ * Check if a memory key is currently write-locked.
+ * Returns the active lock or null.
+ */
+export declare function checkMemoryWriteLock(key: string, scope: string, projectId?: string | null, db?: Database): ResourceLock | null;
+/**
+ * Execute a callback with an exclusive memory write lock.
+ * Throws if the lock cannot be acquired (another agent is writing).
+ * Automatically releases the lock after the callback completes.
+ *
+ * Usage:
+ *   withMemoryLock(agentId, "my-key", "shared", projectId, () => {
+ *     createMemory({ key: "my-key", ... });
+ *   });
+ */
+export declare function withMemoryLock<T>(agentId: string, key: string, scope: string, projectId: string | null | undefined, fn: () => T, ttlSeconds?: number, db?: Database): T;
+/**
+ * Error thrown when a memory write lock cannot be acquired.
+ */
+export declare class MemoryLockConflictError extends Error {
+    readonly conflict: true;
+    readonly key: string;
+    readonly scope: string;
+    readonly blocking_agent_id: string;
+    constructor(key: string, scope: string, blockingAgentId: string);
+}
+//# sourceMappingURL=memory-lock.d.ts.map

package/dist/lib/memory-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lock.d.ts","sourceRoot":"","sources":["../../src/lib/memory-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKxF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,SAAmB,EAC7B,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAGrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAIrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,EAAE,EAAE,MAAM,CAAC,EACX,UAAU,SAAmB,EAC7B,EAAE,CAAC,EAAE,QAAQ,GACZ,CAAC,CAcH;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,QAAQ,EAAG,IAAI,CAAU;IACzC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM;CAUhE"}

package/dist/lib/model-config.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_MODEL = "gpt-4o-mini";
+/**
+ * Returns the currently active fine-tuned model ID, or the default model.
+ */
+export declare function getActiveModel(): string;
+/**
+ * Sets the active fine-tuned model ID in config.json under the effective data root.
+ */
+export declare function setActiveModel(modelId: string): void;
+/**
+ * Clears the active fine-tuned model, reverting to the default.
+ */
+export declare function clearActiveModel(): void;
+//# sourceMappingURL=model-config.d.ts.map

package/dist/lib/model-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.d.ts","sourceRoot":"","sources":["../../src/lib/model-config.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,gBAAgB,CAAC;AA2B3C;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/dist/lib/open-sessions-connector.d.ts

@@ -0,0 +1,60 @@
+/**
+ * sessions connector — bridge between the sessions REST API and mementos.
+ *
+ * When sessions ingests a new session, this connector fetches the session
+ * transcript and submits it to mementos for memory extraction.
+ *
+ * Usage:
+ *   const connector = new OpenSessionsConnector({ openSessionsUrl, mementosUrl });
+ *   await connector.ingestSession(sessionId, { agentId, projectId });
+ *   await connector.syncRecentSessions({ since: "2026-03-17", limit: 10 });
+ */
+export interface OpenSessionsConnectorConfig {
+    /** sessions REST API base URL */
+    openSessionsUrl: string;
+    /** mementos REST API base URL */
+    mementosUrl: string;
+    /** Optional auth token for sessions */
+    openSessionsToken?: string;
+    /** Default agent ID for extracted memories */
+    defaultAgentId?: string;
+    /** Default project ID for extracted memories */
+    defaultProjectId?: string;
+}
+export interface IngestResult {
+    sessionId: string;
+    jobId: string;
+    status: "queued" | "skipped" | "error";
+    message: string;
+}
+export declare class OpenSessionsConnector {
+    private config;
+    constructor(config: OpenSessionsConnectorConfig);
+    /**
+     * Fetch a session transcript from sessions and ingest into mementos.
+     */
+    ingestSession(sessionId: string, options?: {
+        agentId?: string;
+        projectId?: string;
+    }): Promise<IngestResult>;
+    /**
+     * Fetch and ingest multiple recent sessions.
+     */
+    syncRecentSessions(options?: {
+        since?: string;
+        limit?: number;
+        agentId?: string;
+        projectId?: string;
+    }): Promise<IngestResult[]>;
+    private fetchSessionTranscript;
+    private listRecentSessionIds;
+}
+/**
+ * Create a connector from environment variables.
+ *
+ * OPEN_SESSIONS_URL — sessions server URL
+ * OPEN_SESSIONS_TOKEN — optional auth token
+ * MEMENTOS_URL — mementos server URL (default: http://localhost:19428)
+ */
+export declare function connectorFromEnv(): OpenSessionsConnector;
+//# sourceMappingURL=open-sessions-connector.d.ts.map

package/dist/lib/open-sessions-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-sessions-connector.d.ts","sourceRoot":"","sources":["../../src/lib/open-sessions-connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,EAAE,2BAA2B;IAI/C;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,YAAY,CAAC;IAwCxB;;OAEG;IACG,kBAAkB,CAAC,OAAO,GAAE;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAelB,sBAAsB;YAiBtB,oBAAoB;CAqBnC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAWxD"}

package/dist/lib/package-version.d.ts

@@ -0,0 +1,3 @@
+/** Read the package version from source or either bundled output layout. */
+export declare function getMementosPackageVersion(): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/lib/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/lib/package-version.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,wBAAgB,yBAAyB,IAAI,MAAM,CAclD"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @hasna/mementos data-home resolution through the @hasna/paths resolver.
+ *
+ * mementos stores its sqlite database (`mementos.db`), `config.json`, the
+ * per-agent `agents/`, `profiles/`, `training/` and `backups/` data and the
+ * remote-storage `storage/config.json` under a single data root. Historically
+ * that root was `~/.hasna/mementos`. This module resolves the root through
+ * `@hasna/paths` (XDG / macOS home layout) with a gated legacy adoption: the
+ * legacy `~/.hasna/mementos` stays the effective data root until the store is
+ * physically migrated to the XDG data home (`mementos.db` present there) or
+ * the operator sets the data-kind override `HASNA_DATA_HOME`. An existing
+ * live store never becomes invisible on upgrade. The exact-app overrides
+ * `HASNA_MEMENTOS_HOME` (then `MEMENTOS_HOME`) win unconditionally, and the
+ * db-path overrides (`HASNA_MEMENTOS_DB_PATH` / `MEMENTOS_DB_PATH`) stay
+ * layered on top by `getDbPath`.
+ *
+ * Nothing moves on disk in this phase — the package just resolves the new
+ * paths.
+ */
+/** The effective user home, mirroring the pre-existing mementos resolution (`HOME` || `USERPROFILE`). */
+export declare function effectiveHome(): string;
+/** The legacy (pre-XDG) data root: `~/.hasna/mementos`. */
+export declare function legacyDataRoot(): string;
+/**
+ * The @hasna/paths-resolved (XDG / macOS home layout) data root for mementos:
+ * `~/.local/share/hasna/mementos` on Linux, `~/Library/Application
+ * Support/Hasna/mementos` on macOS. The home override mirrors the pre-existing
+ * `$HOME`-first resolution so the resolver follows the same home the legacy
+ * path does.
+ */
+export declare function resolverDataRoot(): string;
+/**
+ * Whether the resolver (XDG) data root should be adopted as the effective
+ * data root. The resolver root is adopted only when the operator has set
+ * `HASNA_DATA_HOME` (the data-kind override — a deliberate opt-in to the XDG
+ * layout) or the store has already been physically migrated there
+ * (`mementos.db` exists — mementos' store file). A machine that only
+ * redirects another kind (e.g. cache to tmpfs) must NOT have its data home
+ * moved, and a live store at the legacy home must never become invisible on
+ * upgrade.
+ */
+export declare function adoptResolverDataRoot(resolved: string, env?: NodeJS.ProcessEnv): boolean;
+/** The exact-app override root, when set: `HASNA_MEMENTOS_HOME`, then `MEMENTOS_HOME`. */
+export declare function exactDataRoot(): string | undefined;
+/**
+ * The effective data root: an exact-app override (`HASNA_MEMENTOS_HOME`, then
+ * `MEMENTOS_HOME`) wins unconditionally; otherwise the resolver (XDG) data
+ * root once adopted; otherwise the legacy `~/.hasna/mementos` default.
+ */
+export declare function getDataRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yGAAyG;AACzG,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAIT;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC"}

package/dist/lib/poisoning.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory poisoning detection.
+ *
+ * Computes a trust score (0.0 - 1.0) for incoming memories based on heuristic
+ * checks. Low-trust memories are flagged for review.
+ */
+import type { Memory } from "../types/index.js";
+/**
+ * Compute a trust score for a memory value.
+ *
+ * Returns a float between 0.0 and 1.0 where 1.0 = fully trusted.
+ * Heuristic penalties:
+ *   - Instruction-like patterns (-0.2)
+ *   - Promotional patterns (-0.3)
+ *   - Contradicts existing high-importance memories (-0.3)
+ *   - Very short value (<10 chars) with high importance claim (-0.1)
+ */
+export declare function computeTrustScore(value: string, key: string, existingMemories?: Memory[], claimedImportance?: number): number;
+//# sourceMappingURL=poisoning.d.ts.map

package/dist/lib/poisoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poisoning.d.ts","sourceRoot":"","sources":["../../src/lib/poisoning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA+BhD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAyDR"}

package/dist/lib/poll.d.ts

@@ -0,0 +1,17 @@
+import type { SqliteAdapter as Database } from "../storage.js";
+import type { Memory, MemoryScope, MemoryCategory } from "../types/index.js";
+export interface PollOptions {
+    interval_ms?: number;
+    scope?: MemoryScope;
+    category?: MemoryCategory;
+    agent_id?: string;
+    project_id?: string;
+    on_memories: (memories: Memory[]) => void;
+    on_error?: (error: Error) => void;
+    db?: Database;
+}
+export interface PollHandle {
+    stop: () => void;
+}
+export declare function startPolling(opts: PollOptions): PollHandle;
+//# sourceMappingURL=poll.d.ts.map

package/dist/lib/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../../src/lib/poll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAS7E,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAsJ1D"}

package/dist/lib/procedural-extractor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * LLM-based procedural memory extractor from session transcripts.
+ * Extracts workflow patterns, step sequences, failure lessons, problem-solution pairs.
+ * Saves as chained procedural memories with when_to_use and sequence_group.
+ */
+interface ExtractedProcedure {
+    title: string;
+    steps: {
+        action: string;
+        when_to_use: string;
+    }[];
+    failure_patterns: string[];
+    when_to_use: string;
+}
+export declare function extractProcedures(transcript: string, options?: {
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+}): Promise<ExtractedProcedure[]>;
+export {};
+//# sourceMappingURL=procedural-extractor.d.ts.map

package/dist/lib/procedural-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-extractor.d.ts","sourceRoot":"","sources":["../../src/lib/procedural-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyF/B"}

package/dist/lib/profile-sync.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Cross-profile memory sync.
+ * Selectively copy memories between different mementos profiles/databases.
+ */
+import type { MemoryFilter } from "../types/index.js";
+export interface ProfileSyncOptions {
+    filter?: MemoryFilter;
+    strategy?: "skip" | "merge" | "overwrite";
+}
+export interface ProfileSyncResult {
+    copied: number;
+    skipped: number;
+    source_profile: string;
+    target_profile: string;
+}
+/**
+ * Sync memories from one profile to another.
+ */
+export declare function syncProfiles(sourceProfile: string, targetProfile: string, options?: ProfileSyncOptions): ProfileSyncResult;
+//# sourceMappingURL=profile-sync.d.ts.map

package/dist/lib/profile-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-sync.d.ts","sourceRoot":"","sources":["../../src/lib/profile-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAmDnB"}

package/dist/lib/profile-synthesizer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Profile Synthesizer — aggregates preference and fact memories into a coherent profile.
+ * Cached as a special pinned memory, auto-refreshed when preferences change.
+ */
+export declare function getProfileKey(scope: string, id: string): string;
+export declare function synthesizeProfile(options: {
+    project_id?: string;
+    agent_id?: string;
+    scope?: "agent" | "project" | "global";
+    force_refresh?: boolean;
+}): Promise<{
+    profile: string;
+    memory_count: number;
+    from_cache: boolean;
+} | null>;
+/**
+ * Mark profile as stale. Called from PostMemorySave hook when a preference/fact is saved.
+ */
+export declare function markProfileStale(projectId?: string, _agentId?: string): void;
+//# sourceMappingURL=profile-synthesizer.d.ts.map

package/dist/lib/profile-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-synthesizer.d.ts","sourceRoot":"","sources":["../../src/lib/profile-synthesizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CA6EjF;AA2BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAa5E"}

package/dist/lib/project-detect.d.ts

@@ -0,0 +1,18 @@
+import { SqliteAdapter as Database } from "../storage.js";
+import type { Project } from "../types/index.js";
+/**
+ * Auto-detect the current project from cwd's git root.
+ * - Finds the git root directory
+ * - Extracts the repo name from the directory basename
+ * - Checks if a project is already registered by path
+ * - If not, registers it automatically
+ * - Returns the Project object, or null if not in a git repo
+ *
+ * Results are cached for the lifetime of the process.
+ */
+export declare function detectProject(db?: Database): Project | null;
+/**
+ * Reset the cached project (useful for tests).
+ */
+export declare function resetProjectCache(): void;
+//# sourceMappingURL=project-detect.d.ts.map

package/dist/lib/project-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detect.d.ts","sourceRoot":"","sources":["../../src/lib/project-detect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkBjD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAgC3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/lib/project-panel.d.ts

@@ -0,0 +1,7 @@
+import { type ProjectPanel } from "@hasna/contracts";
+export interface MementosProjectPanelOptions {
+    limit?: number;
+}
+export declare function createMementosProjectPanel(projectRef: string, options?: MementosProjectPanelOptions): ProjectPanel;
+export declare function formatMementosProjectPanel(panel: ProjectPanel): string;
+//# sourceMappingURL=project-panel.d.ts.map

package/dist/lib/project-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-panel.d.ts","sourceRoot":"","sources":["../../src/lib/project-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwGD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,YAAY,CAkGtH;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAgBtE"}

package/dist/lib/providers/anthropic.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Anthropic provider (DEFAULT).
+ * Default model: claude-haiku-4-5 — cheap, fast, good quality.
+ * Premium option: claude-sonnet-4-5.
+ * Never throws — returns [] / empty results on failure.
+ */
+import { BaseProvider, type ProviderConfig, type ProviderName, type MemoryExtractionContext, type ExtractedMemory, type EntityExtractionResult } from "./base.js";
+export declare const ANTHROPIC_MODELS: {
+    readonly default: "claude-haiku-4-5";
+    readonly premium: "claude-sonnet-4-5";
+};
+export declare class AnthropicProvider extends BaseProvider {
+    readonly name: ProviderName;
+    private readonly baseUrl;
+    constructor(config?: Partial<ProviderConfig>);
+    extractMemories(text: string, context: MemoryExtractionContext): Promise<ExtractedMemory[]>;
+    extractEntities(text: string): Promise<EntityExtractionResult>;
+    scoreImportance(content: string, _context: MemoryExtractionContext): Promise<number>;
+    private callAPI;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/lib/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAK5B,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAWtC,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,eAAe,EAAE,CAAC;IAkBvB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoB9D,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC;YAaJ,OAAO;CAsCtB"}