@hasna/mementos 0.14.33 → 0.14.35

package/dist/lib/decay.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Compute time decay factor (0–1).
+ * Uses exponential forgetting curve: exp(-lambda * days_since_access).
+ *
+ * Returns 1.0 for today, ~0.9 for 10 days, ~0.74 for 30 days, ~0.37 for 100 days.
+ *
+ * @param daysSinceAccess  Non-negative number of days since last access.
+ * @param lambda           Decay rate constant (default 0.01).
+ */
+export declare function timeDecay(daysSinceAccess: number, lambda?: number): number;
+/**
+ * Compute access frequency boost (>= 1.0).
+ * Formula: 1 + log(1 + access_count) * 0.1
+ *
+ * Returns 1.0 for 0 accesses, ~1.07 for 1, ~1.11 for 2, ~1.24 for 10.
+ *
+ * @param accessCount  Non-negative number of times the memory was accessed.
+ */
+export declare function accessBoost(accessCount: number): number;
+/**
+ * Compute effective importance using a forgetting curve model.
+ *
+ * effective_importance = importance * time_decay(days_since_access) * access_boost(access_count)
+ *
+ * Pinned memories always return their raw importance (no decay).
+ * When accessed_at is null, falls back to created_at for age calculation.
+ */
+export declare function computeDecayScore(memory: {
+    importance: number;
+    access_count: number;
+    accessed_at: string | null;
+    created_at: string;
+    pinned: boolean;
+}): number;
+//# sourceMappingURL=decay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["../../src/lib/decay.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAGhF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAaT"}

package/dist/lib/dedup.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Smart deduplication for auto-extracted memories.
+ * FTS5-based similarity check — no LLM needed, pure SQLite.
+ * Prevents memory bloat from repeated similar extractions.
+ */
+import type { MemoryFilter } from "../types/index.js";
+export interface DedupConfig {
+    /** Jaccard similarity threshold 0-1. Above this = duplicate. Default: 0.8 */
+    threshold: number;
+    /** If near-duplicate found, keep the longer/more specific one. Default: true */
+    keepLonger: boolean;
+}
+export interface DedupStats {
+    checked: number;
+    skipped: number;
+    updated: number;
+}
+export declare function getDedupStats(): Readonly<DedupStats>;
+export declare function resetDedupStats(): void;
+/**
+ * Check if content is a near-duplicate of an existing memory.
+ * Returns: 'unique' | 'duplicate' | { updateId: string } (update existing with better content)
+ */
+export declare function checkDuplicate(content: string, filter: Pick<MemoryFilter, "agent_id" | "project_id" | "scope">, config?: DedupConfig): "unique" | "duplicate" | {
+    updateId: string;
+    existingContent: string;
+};
+/**
+ * Full dedup pipeline: check and optionally update existing memory.
+ * Returns: null = save as new | string = skipped/updated (reason)
+ */
+export declare function dedup(content: string, filter: Pick<MemoryFilter, "agent_id" | "project_id" | "scope">, config?: DedupConfig): "save" | "skip";
+//# sourceMappingURL=dedup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/lib/dedup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC,CAEpD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAC/D,MAAM,GAAE,WAA4B,GACnC,QAAQ,GAAG,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAwCxE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAC/D,MAAM,GAAE,WAA4B,GACnC,MAAM,GAAG,MAAM,CAqBjB"}

package/dist/lib/duration.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Human-readable duration parsing and formatting.
+ *
+ * Supported formats:
+ *   Ns  — seconds
+ *   Nm  — minutes
+ *   Nh  — hours
+ *   Nd  — days
+ *   Nw  — weeks
+ *   Combinations: 1d12h, 2h30m
+ *   Plain numbers: treated as milliseconds (backwards compat)
+ */
+/**
+ * Parse a human-readable duration string into milliseconds.
+ *
+ * @param input - Duration string (e.g. "1d12h", "30m", "500") or numeric ms
+ * @returns milliseconds
+ * @throws Error on invalid format
+ */
+export declare function parseDuration(input: string | number): number;
+/**
+ * Format milliseconds into a human-readable duration string.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Human-readable string (e.g. "1d12h", "30m", "500ms")
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/lib/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAiC5D;AAWD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAoBjD"}

package/dist/lib/embeddings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Embedding generation and cosine similarity for semantic memory search.
+ *
+ * Uses OpenAI text-embedding-3-small if OPENAI_API_KEY is set,
+ * falls back to a simple TF-IDF term frequency vector otherwise.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    dimensions: number;
+}
+/**
+ * Generate an embedding for a text string.
+ * Uses OpenAI if OPENAI_API_KEY is available, otherwise uses TF-IDF hash trick.
+ */
+export declare function generateEmbedding(text: string): Promise<EmbeddingResult>;
+export declare function serializeEmbedding(embedding: number[]): string;
+export declare function deserializeEmbedding(raw: string): number[];
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAUjE;AAwDD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAY9E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D"}

package/dist/lib/export-v1.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Mementos Export v1 — portable JSONL format.
+ * One JSON object per line. Includes all memory fields + entity links.
+ */
+import type { Memory, MemoryFilter } from "../types/index.js";
+import { Database } from "bun:sqlite";
+export interface ExportV1Entry {
+    _format: "mementos-export-v1";
+    _exported_at: string;
+    memory: Memory;
+    entity_links: Array<{
+        entity_name: string;
+        entity_type: string;
+        role: string;
+    }>;
+}
+/**
+ * Export memories in mementos-export-v1 JSONL format.
+ * Returns an array of export entries (caller serializes to JSONL).
+ */
+export declare function exportV1(filter?: MemoryFilter, db?: Database): ExportV1Entry[];
+/**
+ * Serialize export entries to JSONL string (one JSON object per line).
+ */
+export declare function toJsonl(entries: ExportV1Entry[]): string;
+/**
+ * Parse JSONL string back to export entries.
+ */
+export declare function fromJsonl(jsonl: string): ExportV1Entry[];
+//# sourceMappingURL=export-v1.d.ts.map

package/dist/lib/export-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-v1.d.ts","sourceRoot":"","sources":["../../src/lib/export-v1.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,KAAK,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,YAAY,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,aAAa,EAAE,CA6BjB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAKxD"}

package/dist/lib/extractor.d.ts

@@ -0,0 +1,9 @@
+import { Database } from "bun:sqlite";
+import type { EntityType, Memory } from "../types/index.js";
+export interface ExtractedEntity {
+    name: string;
+    type: EntityType;
+    confidence: number;
+}
+export declare function extractEntities(memory: Memory, db?: Database): ExtractedEntity[];
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/lib/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAuBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,eAAe,EAAE,CA0EhF"}

package/dist/lib/extractors/audio.d.ts

@@ -0,0 +1,8 @@
+import type { ExtractionResult } from "./types.js";
+/**
+ * Transcribe an audio file using the OpenAI Whisper API.
+ * Requires the OPENAI_API_KEY environment variable.
+ * Returns empty result on failure — never throws.
+ */
+export declare function transcribeAudio(filePath: string): Promise<ExtractionResult>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/lib/extractors/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/lib/extractors/audio.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBnD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2EjF"}

package/dist/lib/extractors/index.d.ts

@@ -0,0 +1,12 @@
+import type { ExtractionResult } from "./types.js";
+export type { ExtractionResult } from "./types.js";
+export { emptyResult } from "./types.js";
+export { extractPdf } from "./pdf.js";
+export { extractImage } from "./ocr.js";
+export { transcribeAudio } from "./audio.js";
+/**
+ * Auto-detect file type by extension and route to the correct extractor.
+ * Returns an empty result for unsupported file types — never throws.
+ */
+export declare function extractFile(filePath: string): Promise<ExtractionResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/extractors/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAa7C;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoB7E"}

package/dist/lib/extractors/ocr.d.ts

@@ -0,0 +1,7 @@
+import type { ExtractionResult } from "./types.js";
+/**
+ * Extract text from an image file using Tesseract.js OCR.
+ * Returns empty result on failure — never throws.
+ */
+export declare function extractImage(filePath: string): Promise<ExtractionResult>;
+//# sourceMappingURL=ocr.d.ts.map

package/dist/lib/extractors/ocr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.d.ts","sourceRoot":"","sources":["../../../src/lib/extractors/ocr.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2B9E"}

package/dist/lib/extractors/pdf.d.ts

@@ -0,0 +1,7 @@
+import type { ExtractionResult } from "./types.js";
+/**
+ * Extract text from a PDF file using pdf-parse.
+ * Returns empty result on failure — never throws.
+ */
+export declare function extractPdf(filePath: string): Promise<ExtractionResult>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/lib/extractors/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/lib/extractors/pdf.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2B5E"}

package/dist/lib/extractors/types.d.ts

@@ -0,0 +1,12 @@
+export interface ExtractionResult {
+    text: string;
+    metadata: Record<string, unknown>;
+    pages?: number;
+    confidence?: number;
+}
+/**
+ * Returns an empty extraction result — used as a safe fallback when
+ * extraction fails or the file type is unsupported.
+ */
+export declare function emptyResult(metadata?: Record<string, unknown>): ExtractionResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/extractors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/extractors/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAMhF"}

package/dist/lib/file-deps.d.ts

@@ -0,0 +1,27 @@
+/**
+ * File dependency graph builder for open-mementos.
+ * Scans a codebase, creates 'file' entities for each source file, and
+ * creates 'depends_on' relations between files based on import/require statements.
+ *
+ * Supports: TypeScript, JavaScript, Python, Go (basic), Rust (basic).
+ */
+import type { Database } from "bun:sqlite";
+export interface FileDepsOptions {
+    root_dir: string;
+    project_id?: string;
+    extensions?: string[];
+    exclude_patterns?: string[];
+    incremental?: boolean;
+}
+export interface FileDepsResult {
+    files_scanned: number;
+    entities_created: number;
+    entities_updated: number;
+    relations_created: number;
+    errors: string[];
+}
+/**
+ * Scan a codebase, create file entities and import-based depends_on relations.
+ */
+export declare function buildFileDependencyGraph(opts: FileDepsOptions, db?: Database): Promise<FileDepsResult>;
+//# sourceMappingURL=file-deps.d.ts.map

package/dist/lib/file-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-deps.d.ts","sourceRoot":"","sources":["../../src/lib/file-deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgFD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,eAAe,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,cAAc,CAAC,CAwFzB"}

package/dist/lib/focus.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Focus mode — agents can "focus" on a project, which auto-scopes
+ * memory operations to that project's shared memories + their own private
+ * memories + all global memories.
+ *
+ * Priority for project_id resolution:
+ * 1. Per-call param (explicit override)
+ * 2. Session focus (in-memory Map, fastest)
+ * 3. DB active_project_id on agent record
+ * 4. No filter
+ */
+/**
+ * Set focus for an agent. Persists to DB + sets in-memory session focus.
+ * Pass project_id=null to unfocus.
+ */
+export declare function setFocus(agentId: string, projectId: string | null): void;
+/**
+ * Get the current focus project_id for an agent.
+ * Checks session cache first, then DB.
+ */
+export declare function getFocus(agentId: string): string | null;
+/**
+ * Remove focus for an agent (sets to null).
+ */
+export declare function unfocus(agentId: string): void;
+/**
+ * Resolve the effective project_id for a memory operation.
+ * Priority: explicit per-call param > session/DB focus > null
+ */
+export declare function resolveProjectId(agentId: string | undefined | null, explicitProjectId: string | undefined | null): string | null;
+/**
+ * Build the scope filter for memory queries when an agent is focused.
+ *
+ * When focused on project P:
+ *   - private memories of this agent (scope=private, agent_id=agentId)
+ *   - shared memories of project P (scope=shared, project_id=P)
+ *   - global memories (scope=global)
+ *
+ * When not focused: no automatic scope restriction (existing behavior).
+ */
+export interface FocusScopeFilter {
+    /** If set, apply this multi-scope filter instead of a single scope */
+    focusMode: true;
+    agentId: string;
+    projectId: string;
+}
+export declare function buildFocusFilter(agentId: string | undefined | null, explicitProjectId: string | undefined | null, explicitScope: string | undefined | null): FocusScopeFilter | null;
+/**
+ * Apply focus filter to a SQL WHERE clause builder.
+ * Returns SQL fragment + params for the focused scope filter.
+ *
+ * Generates: (scope = 'global') OR (scope = 'private' AND agent_id = ?) OR (scope = 'shared' AND project_id = ?)
+ */
+export declare function focusFilterSQL(agentId: string, projectId: string): {
+    sql: string;
+    params: string[];
+};
+//# sourceMappingURL=focus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/lib/focus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAqBxE;AAOD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAClC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC3C,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAClC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAC5C,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACvC,gBAAgB,GAAG,IAAI,CAazB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAKnC"}

package/dist/lib/gatherer.d.ts

@@ -0,0 +1,16 @@
+type GatherTrainingDataFn = (options?: {
+    limit?: number;
+    since?: Date;
+}) => Promise<{
+    source: string;
+    examples: Array<{
+        messages: Array<{
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>;
+    }>;
+    count: number;
+}>;
+export declare const gatherTrainingData: GatherTrainingDataFn;
+export {};
+//# sourceMappingURL=gatherer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/lib/gatherer.ts"],"names":[],"mappings":"AAMA,KAAK,oBAAoB,GAAG,CAAC,OAAO,CAAC,EAAE;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,KAAK,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7E,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAyEH,eAAO,MAAM,kBAAkB,EAAE,oBAgDhC,CAAC"}

package/dist/lib/gdpr.d.ts

@@ -0,0 +1,24 @@
+/**
+ * GDPR-compliant erasure (right to be forgotten).
+ *
+ * Deletes PII from memory values while preserving anonymized audit trail.
+ * The audit log entries remain with hashes only (no content).
+ */
+import { Database } from "bun:sqlite";
+export interface GdprErasureResult {
+    erased_count: number;
+    memory_ids: string[];
+    timestamp: string;
+}
+/**
+ * Erase all memories containing the given PII identifier.
+ * Replaces value, summary, and key with "[REDACTED]".
+ * Clears tags and metadata that might contain PII.
+ * Preserves the audit trail (audit_log entries have hashes, not content).
+ */
+export declare function gdprErase(identifier: string, options?: {
+    project_id?: string;
+    agent_id?: string;
+    dry_run?: boolean;
+}, db?: Database): GdprErasureResult;
+//# sourceMappingURL=gdpr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gdpr.d.ts","sourceRoot":"","sources":["../../src/lib/gdpr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,iBAAiB,CAwDnB"}

package/dist/lib/hooks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Hook registry — the central nervous system connecting all memory operations.
+ *
+ * Blocking hooks: await handler, return false = cancel the operation.
+ * Non-blocking hooks: fire-and-forget in background, never delay caller.
+ *
+ * Hooks run in priority order (ascending — lower number first).
+ * Per-agent and per-project scoping supported.
+ */
+import type { Hook, HookType, HookHandler, HookRegistration, HookContextMap } from "../types/hooks.js";
+declare class HookRegistry {
+    private hooks;
+    /**
+     * Register a hook. Returns the assigned hookId.
+     * Built-in hooks (builtin: true) cannot be unregistered.
+     */
+    register<T extends HookType>(reg: HookRegistration<T>): string;
+    /**
+     * Unregister a hook by ID.
+     * Returns false if hook not found or is a built-in.
+     */
+    unregister(hookId: string): boolean;
+    /** List all hooks, optionally filtered by type */
+    list(type?: HookType): Hook[];
+    /**
+     * Run all hooks of a given type for a given context.
+     *
+     * Returns true if the operation should proceed.
+     * Returns false if any blocking hook cancelled it.
+     *
+     * Non-blocking hooks are fired async and never delay the return.
+     */
+    runHooks<T extends HookType>(type: T, context: HookContextMap[T]): Promise<boolean>;
+    /**
+     * Get hooks matching type + agent/project scope.
+     * A hook with no agentId/projectId matches everything.
+     */
+    private getMatchingHooks;
+    /** Get stats about registered hooks */
+    stats(): {
+        total: number;
+        byType: Record<string, number>;
+        blocking: number;
+        nonBlocking: number;
+    };
+}
+/** Singleton — shared across the whole process */
+export declare const hookRegistry: HookRegistry;
+export type { Hook, HookType, HookHandler, HookRegistration };
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAO3B,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAA2B;IAExC;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM;IAW9D;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQnC,kDAAkD;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE;IAM7B;;;;;;;OAOG;IACG,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAC/B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC;IA8BnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAaxB,uCAAuC;IACvC,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAalG;AAED,kDAAkD;AAClD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Memory importers — parse export formats from Mem0, Zep, and LangMem into mementos memories.
+ */
+import type { CreateMemoryInput } from "../../types/index.js";
+export interface ImportResult {
+    memories: CreateMemoryInput[];
+    warnings: string[];
+    source_format: string;
+}
+interface Mem0Export {
+    id?: string;
+    memory?: string;
+    user_id?: string;
+    metadata?: Record<string, unknown>;
+    created_at?: string;
+    categories?: string[];
+}
+export declare function importMem0(data: Mem0Export[]): ImportResult;
+interface ZepExport {
+    uuid?: string;
+    fact?: string;
+    rating?: number;
+    valid_at?: string;
+    invalid_at?: string;
+    source_node_name?: string;
+    target_node_name?: string;
+}
+export declare function importZep(data: ZepExport[]): ImportResult;
+interface LangMemExport {
+    id?: string;
+    content?: string;
+    namespace?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function importLangMem(data: LangMemExport[]): ImportResult;
+export declare function detectFormat(data: unknown[]): "mem0" | "zep" | "langmem" | "unknown";
+export {};
+//# sourceMappingURL=index.d.ts.map

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,86 @@
+import { Database } from "bun:sqlite";
+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;
+    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;
+    /** 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,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAU,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYhF,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,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,+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;IA0L3D;;;OAGG;IACG,wBAAwB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuL/E;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG3B;AAoJD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyQ/F"}