@hasna/mementos 0.14.30 → 0.14.32

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 { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,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 { Database } from "bun:sqlite";
+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,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,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 ~/.hasna/mementos/config.json.
+ */
+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 @@
+/**
+ * Open-sessions connector — bridge between open-sessions REST API and mementos.
+ *
+ * When open-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 {
+    /** open-sessions REST API base URL */
+    openSessionsUrl: string;
+    /** mementos REST API base URL */
+    mementosUrl: string;
+    /** Optional auth token for open-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 open-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 — open-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,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,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/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 { 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/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;AAEtD,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;AAUD;;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,CA2EjF;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 { 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/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"}

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

@@ -0,0 +1,96 @@
+/**
+ * LLM Provider abstraction for auto-memory formation.
+ * Any LLM (Anthropic, OpenAI, Cerebras, Grok) implements LLMProvider.
+ * All methods return structured data — providers must output valid JSON.
+ */
+import type { MemoryCategory, MemoryScope } from "../../types/index.js";
+export interface ProviderConfig {
+    apiKey: string;
+    model: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeoutMs?: number;
+}
+export type ProviderName = "anthropic" | "openai" | "cerebras" | "grok";
+export interface AutoMemoryConfig {
+    provider: ProviderName;
+    model?: string;
+    enabled: boolean;
+    minImportance: number;
+    autoEntityLink: boolean;
+    fallback?: ProviderName[];
+}
+export declare const DEFAULT_AUTO_MEMORY_CONFIG: AutoMemoryConfig;
+export interface MemoryExtractionContext {
+    agentId?: string;
+    projectId?: string;
+    sessionId?: string;
+    /** Compact summary of existing memories to avoid duplicates */
+    existingMemoriesSummary?: string;
+    /** Working directory or project name for scope hints */
+    projectName?: string;
+}
+export interface ExtractedMemory {
+    content: string;
+    category: MemoryCategory;
+    importance: number;
+    tags: string[];
+    suggestedScope: MemoryScope;
+    /** Why this is worth remembering — used for dedup decisions */
+    reasoning?: string;
+}
+export interface ExtractedEntity {
+    name: string;
+    /** Maps to EntityType in knowledge graph */
+    type: "person" | "project" | "tool" | "concept" | "file" | "api" | "pattern" | "organization";
+    /** 0-1 confidence score */
+    confidence: number;
+}
+export interface ExtractedRelation {
+    from: string;
+    to: string;
+    type: "uses" | "knows" | "depends_on" | "created_by" | "related_to" | "contradicts" | "part_of" | "implements" | "happened_before" | "happened_after" | "caused_by" | "resulted_in" | "supersedes" | "version_of";
+}
+export interface EntityExtractionResult {
+    entities: ExtractedEntity[];
+    relations: ExtractedRelation[];
+}
+export interface LLMProvider {
+    readonly name: ProviderName;
+    readonly config: ProviderConfig;
+    /**
+     * Extract memories worth saving from a conversation turn or session chunk.
+     * Must return [] on failure — never throw.
+     */
+    extractMemories(text: string, context: MemoryExtractionContext): Promise<ExtractedMemory[]>;
+    /**
+     * Extract entities and relations from text for knowledge graph linking.
+     * Must return empty arrays on failure — never throw.
+     */
+    extractEntities(text: string): Promise<EntityExtractionResult>;
+    /**
+     * Score how important a memory is (0-10).
+     * Used when we already have the content but need a quality signal.
+     * Must return a number on failure — never throw.
+     */
+    scoreImportance(content: string, context: MemoryExtractionContext): Promise<number>;
+}
+export declare abstract class BaseProvider implements LLMProvider {
+    abstract readonly name: ProviderName;
+    readonly config: ProviderConfig;
+    constructor(config: ProviderConfig);
+    abstract extractMemories(text: string, context: MemoryExtractionContext): Promise<ExtractedMemory[]>;
+    abstract extractEntities(text: string): Promise<EntityExtractionResult>;
+    abstract scoreImportance(content: string, context: MemoryExtractionContext): Promise<number>;
+    /** Parse JSON from LLM response, stripping markdown code fences if present */
+    protected parseJSON<T>(raw: string): T | null;
+    /** Clamp a number to 0-10 importance range */
+    protected clampImportance(value: unknown): number;
+    /** Validate and normalise a single extracted memory */
+    protected normaliseMemory(raw: unknown): ExtractedMemory | null;
+}
+export declare const MEMORY_EXTRACTION_SYSTEM_PROMPT = "You are a precise memory extraction engine for an AI agent.\nGiven text, extract facts worth remembering as structured JSON.\nFocus on: decisions made, preferences revealed, corrections, architectural choices, established facts, user preferences.\nIgnore: greetings, filler, questions without answers, temporary states.\nOutput ONLY a JSON array \u2014 no markdown, no explanation.";
+export declare const MEMORY_EXTRACTION_USER_TEMPLATE: (text: string, context: MemoryExtractionContext) => string;
+export declare const ENTITY_EXTRACTION_SYSTEM_PROMPT = "You are a knowledge graph entity extractor.\nGiven text, identify named entities and their relationships.\nOutput ONLY valid JSON \u2014 no markdown, no explanation.";
+export declare const ENTITY_EXTRACTION_USER_TEMPLATE: (text: string) => string;
+//# sourceMappingURL=base.d.ts.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Cerebras provider — ultra-fast inference (~2000 tok/sec).
+ * OpenAI-compatible API.
+ * Default model: llama-3.3-70b.
+ * Ideal for real-time non-blocking extraction.
+ * Env var: CEREBRAS_API_KEY.
+ */
+import { OpenAICompatProvider } from "./openai-compat.js";
+import type { ProviderConfig, ProviderName } from "./base.js";
+export declare const CEREBRAS_MODELS: {
+    readonly default: "llama-3.3-70b";
+    readonly fast: "llama3.1-8b";
+};
+export declare class CerebrasProvider extends OpenAICompatProvider {
+    readonly name: ProviderName;
+    protected readonly baseUrl = "https://api.cerebras.ai/v1";
+    protected readonly authHeader = "Authorization";
+    constructor(config?: Partial<ProviderConfig>);
+}
+//# sourceMappingURL=cerebras.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cerebras.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/cerebras.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAc;IACzC,SAAS,CAAC,QAAQ,CAAC,OAAO,gCAAgC;IAC1D,SAAS,CAAC,QAAQ,CAAC,UAAU,mBAAmB;gBAEpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;CAS7C"}

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

@@ -0,0 +1,19 @@
+/**
+ * Grok/xAI provider.
+ * OpenAI-compatible API.
+ * Default model: grok-3-mini (cheap). Premium: grok-3.
+ * Env var: XAI_API_KEY.
+ */
+import { OpenAICompatProvider } from "./openai-compat.js";
+import type { ProviderConfig, ProviderName } from "./base.js";
+export declare const GROK_MODELS: {
+    readonly default: "grok-3-mini";
+    readonly premium: "grok-3";
+};
+export declare class GrokProvider extends OpenAICompatProvider {
+    readonly name: ProviderName;
+    protected readonly baseUrl = "https://api.x.ai/v1";
+    protected readonly authHeader = "Authorization";
+    constructor(config?: Partial<ProviderConfig>);
+}
+//# sourceMappingURL=grok.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grok.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/grok.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,qBAAa,YAAa,SAAQ,oBAAoB;IACpD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAU;IACrC,SAAS,CAAC,QAAQ,CAAC,OAAO,yBAAyB;IACnD,SAAS,CAAC,QAAQ,CAAC,UAAU,mBAAmB;gBAEpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;CAS7C"}

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

@@ -0,0 +1,7 @@
+export * from "./base.js";
+export * from "./anthropic.js";
+export * from "./openai.js";
+export * from "./cerebras.js";
+export * from "./grok.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/lib/providers/openai-compat.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared base for all OpenAI-compatible providers.
+ * Used by: OpenAI, Cerebras, Grok/xAI.
+ * Handles: API calls, exponential backoff on 429, shared JSON parsing.
+ */
+import { BaseProvider, type ProviderConfig, type MemoryExtractionContext, type ExtractedMemory, type EntityExtractionResult } from "./base.js";
+export declare abstract class OpenAICompatProvider extends BaseProvider {
+    protected abstract readonly baseUrl: string;
+    protected abstract readonly authHeader: string;
+    constructor(config: ProviderConfig);
+    extractMemories(text: string, context: MemoryExtractionContext): Promise<ExtractedMemory[]>;
+    extractEntities(text: string): Promise<EntityExtractionResult>;
+    scoreImportance(content: string, _context: MemoryExtractionContext): Promise<number>;
+    /** Call with exponential backoff on 429 (rate limit), max 3 retries */
+    private callWithRetry;
+    private callAPI;
+}
+//# sourceMappingURL=openai-compat.d.ts.map

package/dist/lib/providers/openai-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compat.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/openai-compat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAK5B,MAAM,WAAW,CAAC;AAEnB,8BAAsB,oBAAqB,SAAQ,YAAY;IAC7D,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEnC,MAAM,EAAE,cAAc;IAI5B,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;IAalB,uEAAuE;YACzD,aAAa;YAsBb,OAAO;CA0CtB"}

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

@@ -0,0 +1,20 @@
+/**
+ * OpenAI provider.
+ * Default model: gpt-4.1-nano (ultra cheap, fast).
+ * Premium: gpt-4.1-mini, gpt-4.1.
+ * Env var: OPENAI_API_KEY.
+ */
+import { OpenAICompatProvider } from "./openai-compat.js";
+import type { ProviderConfig, ProviderName } from "./base.js";
+export declare const OPENAI_MODELS: {
+    readonly default: "gpt-4.1-nano";
+    readonly mini: "gpt-4.1-mini";
+    readonly full: "gpt-4.1";
+};
+export declare class OpenAIProvider extends OpenAICompatProvider {
+    readonly name: ProviderName;
+    protected readonly baseUrl = "https://api.openai.com/v1";
+    protected readonly authHeader = "Authorization";
+    constructor(config?: Partial<ProviderConfig>);
+}
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,qBAAa,cAAe,SAAQ,oBAAoB;IACtD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAY;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,+BAA+B;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,mBAAmB;gBAEpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;CAS7C"}

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

@@ -0,0 +1,38 @@
+/**
+ * Provider registry — resolves API keys, manages fallback chain,
+ * health checks. Works with zero config (just needs one env var set).
+ * Default: Anthropic Haiku → Cerebras → OpenAI.
+ */
+import { type AutoMemoryConfig, type LLMProvider, type ProviderName } from "./base.js";
+declare class ProviderRegistry {
+    private config;
+    private _instances;
+    /** Update runtime config without restart */
+    configure(partial: Partial<AutoMemoryConfig>): void;
+    getConfig(): Readonly<AutoMemoryConfig>;
+    /** Get primary provider, or null if no API key available */
+    getPrimary(): LLMProvider | null;
+    /** Get fallback chain — all available providers excluding primary */
+    getFallbacks(): LLMProvider[];
+    /**
+     * Get the best available provider.
+     * Returns primary if available, otherwise first available fallback.
+     * Returns null only if no providers have API keys configured.
+     */
+    getAvailable(): LLMProvider | null;
+    /**
+     * Get a specific provider by name.
+     * Returns null if no API key is configured for that provider.
+     */
+    getProvider(name: ProviderName): LLMProvider | null;
+    /** Check which providers have API keys configured */
+    health(): Record<ProviderName, {
+        available: boolean;
+        model: string;
+    }>;
+    private createProvider;
+}
+/** Singleton registry — shared across the whole process */
+export declare const providerRegistry: ProviderRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,WAAW,CAAC;AAInB,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,UAAU,CAAwC;IAE1D,4CAA4C;IAC5C,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAMnD,SAAS,IAAI,QAAQ,CAAC,gBAAgB,CAAC;IAIvC,4DAA4D;IAC5D,UAAU,IAAI,WAAW,GAAG,IAAI;IAIhC,qEAAqE;IACrE,YAAY,IAAI,WAAW,EAAE;IAQ7B;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAOlC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI;IAcnD,qDAAqD;IACrD,MAAM,IAAI,MAAM,CAAC,YAAY,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAarE,OAAO,CAAC,cAAc;CAiBvB;AAED,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}