@hasna/mementos 0.3.7 → 0.4.1

package/dist/lib/config.d.ts

@@ -0,0 +1,5 @@
+import type { MementosConfig } from "../types";
+export declare const DEFAULT_CONFIG: MementosConfig;
+export declare function loadConfig(): MementosConfig;
+export declare function getDbPath(): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAA+B,MAAM,UAAU,CAAC;AAM5E,eAAO,MAAM,cAAc,EAAE,cA2B5B,CAAC;AA4DF,wBAAgB,UAAU,IAAI,cAAc,CAwC3C;AAgDD,wBAAgB,SAAS,IAAI,MAAM,CA+BlC"}

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/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/injector.d.ts

@@ -0,0 +1,31 @@
+import { Database } from "bun:sqlite";
+import type { MemoryCategory, MementosConfig } from "../types/index.js";
+export interface InjectionOptions {
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    max_tokens?: number;
+    categories?: MemoryCategory[];
+    min_importance?: number;
+    db?: Database;
+}
+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;
+    /**
+     * Reset the deduplication window (call between refresh intervals)
+     */
+    resetDedup(): void;
+    /**
+     * Get count of memories injected so far in this session
+     */
+    getInjectedCount(): number;
+}
+//# 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;AAQhF,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,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;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;IA0K3D;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG3B"}

package/dist/lib/poll.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQ7E,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,CA0F1D"}

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

@@ -0,0 +1,18 @@
+import { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkBjD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CA0B3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/lib/redact.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Detect and redact secrets from text.
+ * Returns the text with secrets replaced by [REDACTED].
+ */
+export declare function redactSecrets(text: string): string;
+/**
+ * Check if text contains any detectable secrets.
+ */
+export declare function containsSecrets(text: string): boolean;
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/lib/redact.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD"}

package/dist/lib/retention.d.ts

@@ -0,0 +1,14 @@
+import type { Database } from "bun:sqlite";
+import type { MementosConfig } from "../types/index.js";
+export declare function enforceQuotas(config: MementosConfig, db?: Database): number;
+export declare function archiveStale(staleDays: number, db?: Database): number;
+export declare function archiveUnused(days: number, db?: Database): number;
+export declare function deprioritizeStale(days: number, db?: Database): number;
+export declare function runCleanup(config: MementosConfig, db?: Database): {
+    expired: number;
+    evicted: number;
+    archived: number;
+    unused_archived: number;
+    deprioritized: number;
+};
+//# sourceMappingURL=retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAQrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA0C3E;AAMD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwBrE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAoBjE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA2BrE;AAMD,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAgBxG"}

package/dist/lib/search.d.ts

@@ -0,0 +1,22 @@
+import { Database } from "bun:sqlite";
+import type { MemoryFilter, MemorySearchResult } from "../types/index.js";
+/**
+ * Search memories by query string with relevance scoring.
+ *
+ * Uses FTS5 full-text search when available, falling back to LIKE queries.
+ * Searches across key, value, summary, and tags. Results are scored,
+ * weighted by importance, filtered, and sorted by score DESC then
+ * importance DESC.
+ */
+export declare function searchMemories(query: string, filter?: MemoryFilter, db?: Database): MemorySearchResult[];
+export declare function logSearchQuery(query: string, resultCount: number, agentId?: string, projectId?: string, db?: Database): void;
+export declare function getSearchHistory(limit?: number, projectId?: string, db?: Database): {
+    query: string;
+    result_count: number;
+    created_at: string;
+}[];
+export declare function getPopularSearches(limit?: number, projectId?: string, db?: Database): {
+    query: string;
+    count: number;
+}[];
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAU,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAyoBlF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EACrB,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,EAAE,CAoDtB;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAWN;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,MAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAU/D;AAED,wBAAgB,kBAAkB,CAChC,KAAK,GAAE,MAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAUpC"}

package/dist/lib/sync.d.ts

@@ -0,0 +1,10 @@
+import { Database } from "bun:sqlite";
+import type { ConflictResolution, SyncDirection, SyncResult } from "../types/index.js";
+export declare function syncMemories(agentName: string, direction?: SyncDirection, options?: {
+    agent_id?: string;
+    project_id?: string;
+    conflict_resolution?: ConflictResolution;
+    db?: Database;
+}): SyncResult;
+export declare const defaultSyncAgents: string[];
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/lib/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EACV,kBAAkB,EAElB,aAAa,EACb,UAAU,EACX,MAAM,mBAAmB,CAAC;AA6K3B,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,aAAsB,EACjC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,EAAE,CAAC,EAAE,QAAQ,CAAC;CACV,GACL,UAAU,CAgCZ;AAED,eAAO,MAAM,iBAAiB,UAAgC,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

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