@smyslenny/agent-memory 2.2.0 → 3.1.0

package/dist/index.d.ts

@@ -77,51 +77,6 @@ declare function getPathsByDomain(db: Database.Database, domain: string, agent_i
 declare function getPathsByPrefix(db: Database.Database, prefix: string, agent_id?: string): Path[];
 declare function deletePath(db: Database.Database, id: string): boolean;
 
-type RelationType = "related" | "caused" | "reminds" | "evolved" | "contradicts";
-interface Link {
-    agent_id: string;
-    source_id: string;
-    target_id: string;
-    relation: RelationType;
-    weight: number;
-    created_at: string;
-}
-declare function createLink(db: Database.Database, sourceId: string, targetId: string, relation: RelationType, weight?: number, agent_id?: string): Link;
-declare function getLinks(db: Database.Database, memoryId: string, agent_id?: string): Link[];
-declare function getOutgoingLinks(db: Database.Database, sourceId: string, agent_id?: string): Link[];
-/**
- * Multi-hop traversal: find all memories reachable within N hops
- * Inspired by PowerMem's knowledge graph traversal
- */
-declare function traverse(db: Database.Database, startId: string, maxHops?: number, agent_id?: string): Array<{
-    id: string;
-    hop: number;
-    relation: string;
-}>;
-declare function deleteLink(db: Database.Database, sourceId: string, targetId: string, agent_id?: string): boolean;
-
-type SnapshotAction = "create" | "update" | "delete" | "merge";
-interface Snapshot {
-    id: string;
-    memory_id: string;
-    content: string;
-    changed_by: string | null;
-    action: SnapshotAction;
-    created_at: string;
-}
-/**
- * Create a snapshot before modifying a memory.
- * Call this BEFORE any update/delete operation.
- */
-declare function createSnapshot(db: Database.Database, memoryId: string, action: SnapshotAction, changedBy?: string): Snapshot;
-declare function getSnapshots(db: Database.Database, memoryId: string): Snapshot[];
-declare function getSnapshot(db: Database.Database, id: string): Snapshot | null;
-/**
- * Rollback a memory to a specific snapshot.
- * Creates a new snapshot of the current state before rolling back.
- */
-declare function rollback(db: Database.Database, snapshotId: string): boolean;
-
 type GuardAction = "add" | "update" | "skip" | "merge";
 interface GuardResult {
     action: GuardAction;
@@ -177,129 +132,62 @@ declare function searchBM25(db: Database.Database, query: string, opts?: {
  */
 declare function tokenize(text: string): string[];
 
-type SearchIntent = "factual" | "exploratory" | "temporal" | "causal";
-interface IntentResult {
-    intent: SearchIntent;
-    confidence: number;
+interface IngestBlock {
+    title: string;
+    content: string;
 }
-/**
- * Classify the intent of a search query.
- * Uses keyword pattern matching + structural analysis.
- * Enhanced for Chinese with jieba-aware token analysis.
- */
-declare function classifyIntent(query: string): IntentResult;
-/**
- * Get search strategy based on intent
- */
-declare function getStrategy(intent: SearchIntent): {
-    boostRecent: boolean;
-    boostPriority: boolean;
-    limit: number;
-};
-
-interface RerankResult {
+interface IngestExtractedItem {
     index: number;
-    relevance_score: number;
+    title: string;
+    content: string;
+    type: MemoryType;
+    uri: string;
 }
-interface RerankProvider {
-    id: string;
-    model: string;
-    rerank(query: string, documents: string[]): Promise<RerankResult[]>;
+interface IngestDryRunDetail {
+    index: number;
+    type: MemoryType;
+    uri: string;
+    preview: string;
 }
-declare function getRerankerProviderFromEnv(): RerankProvider | null;
-declare function createOpenAIRerankProvider(opts: {
-    apiKey: string;
-    model: string;
-    baseUrl?: string;
-}): RerankProvider;
-
-/**
- * Optionally rerank results using an external semantic reranker provider.
- * Best-effort: on failure, returns original results unchanged.
- */
-declare function rerankWithProvider(results: SearchResult[], query: string, provider: RerankProvider): Promise<SearchResult[]>;
-/**
- * Rerank search results based on intent strategy and priority weighting.
- */
-declare function rerank(results: SearchResult[], opts: {
-    intent?: SearchIntent;
-    boostRecent: boolean;
-    boostPriority: boolean;
-    limit: number;
-}): SearchResult[];
-
-interface EmbeddingProvider {
-    id: string;
-    model: string;
-    dimension?: number;
-    instructionPrefix?: string | null;
-    embed(text: string): Promise<number[]>;
-    embedQuery?(query: string): Promise<number[]>;
+interface IngestWriteDetail {
+    index: number;
+    type: MemoryType;
+    uri: string;
+    action: "added" | "updated" | "merged" | "skipped";
+    reason: string;
+    memoryId?: string;
 }
-declare function getDefaultInstruction(model: string): string | null;
-declare function getEmbeddingProviderFromEnv(): EmbeddingProvider | null;
-declare function createOpenAIProvider(opts: {
-    id?: string;
-    apiKey: string;
-    model: string;
-    baseUrl?: string;
-    instruction?: string | null;
-}): EmbeddingProvider;
-declare function createDashScopeProvider(opts: {
-    apiKey: string;
-    model: string;
-    baseUrl?: string;
-    instruction?: string | null;
-}): EmbeddingProvider;
-
-interface HybridSearchOptions {
-    agent_id?: string;
-    limit?: number;
-    bm25CandidateMultiplier?: number;
-    semanticCandidates?: number;
-    rrfK?: number;
-    embeddingProvider?: EmbeddingProvider | null;
-    embeddingModel?: string;
+interface IngestResult {
+    extracted: number;
+    written: number;
+    skipped: number;
+    dry_run: boolean;
+    details: Array<IngestDryRunDetail | IngestWriteDetail>;
 }
-declare function searchHybrid(db: Database.Database, query: string, opts?: HybridSearchOptions): Promise<SearchResult[]>;
-
-interface StoredEmbedding {
-    agent_id: string;
-    memory_id: string;
-    model: string;
-    dim: number;
-    vector: Float32Array;
-    created_at: string;
-    updated_at: string;
+interface IngestRunOptions {
+    text: string;
+    source?: string;
+    dryRun?: boolean;
+    agentId?: string;
 }
-declare function encodeEmbedding(vector: number[] | Float32Array): Buffer;
-declare function decodeEmbedding(buf: Buffer): Float32Array;
-declare function upsertEmbedding(db: Database.Database, input: {
-    agent_id: string;
-    memory_id: string;
-    model: string;
-    vector: number[] | Float32Array;
-}): void;
-declare function getEmbedding(db: Database.Database, agent_id: string, memory_id: string, model: string): StoredEmbedding | null;
-declare function listEmbeddings(db: Database.Database, agent_id: string, model: string): Array<{
-    memory_id: string;
-    vector: Float32Array;
-}>;
+declare function slugify(input: string): string;
+declare function classifyIngestType(text: string): MemoryType;
+declare function splitIngestBlocks(text: string): IngestBlock[];
+declare function extractIngestItems(text: string, source?: string): IngestExtractedItem[];
+declare function ingestText(db: Database.Database, options: IngestRunOptions): IngestResult;
 
-declare function embedMemory(db: Database.Database, memoryId: string, provider: EmbeddingProvider, opts?: {
-    agent_id?: string;
-    model?: string;
-    maxChars?: number;
-}): Promise<boolean>;
-declare function embedMissingForAgent(db: Database.Database, provider: EmbeddingProvider, opts?: {
-    agent_id?: string;
-    model?: string;
-    limit?: number;
-    maxChars?: number;
-}): Promise<{
-    embedded: number;
-    scanned: number;
-}>;
+interface AutoIngestWatcherOptions {
+    db: Database.Database;
+    workspaceDir: string;
+    agentId: string;
+    debounceMs?: number;
+    initialScan?: boolean;
+    logger?: Pick<Console, "log" | "warn" | "error">;
+}
+interface AutoIngestWatcher {
+    close: () => void;
+}
+declare function runAutoIngestWatcher(options: AutoIngestWatcherOptions): AutoIngestWatcher;
 
 /**
  * Calculate vitality using Ebbinghaus forgetting curve.
@@ -360,30 +248,25 @@ declare function syncBatch(db: Database.Database, inputs: SyncInput[]): SyncResu
 interface TidyResult {
     archived: number;
     orphansCleaned: number;
-    snapshotsPruned: number;
 }
 /**
  * Run the tidy (deep sleep) cycle:
  * 1. Archive decayed P3 memories (vitality < threshold)
  * 2. Clean orphan paths (paths with no memory)
- * 3. Prune old snapshots (keep last N per memory)
  */
 declare function runTidy(db: Database.Database, opts?: {
     vitalityThreshold?: number;
-    maxSnapshotsPerMemory?: number;
     agent_id?: string;
 }): TidyResult;
 
 interface GovernResult {
     orphanPaths: number;
-    orphanLinks: number;
     emptyMemories: number;
 }
 /**
  * Run governance checks and cleanup:
  * 1. Remove orphan paths (no parent memory)
- * 2. Remove orphan links (source or target missing)
- * 3. Remove empty memories (blank content)
+ * 2. Remove empty memories (blank content)
  */
 declare function runGovern(db: Database.Database, opts?: {
     agent_id?: string;
@@ -402,4 +285,4 @@ declare function boot(db: Database.Database, opts?: {
     corePaths?: string[];
 }): BootResult;
 
-export { type BootResult, type CreateMemoryInput, type EmbeddingProvider, type ExportResult, type GovernResult, type GuardAction, type GuardResult, type HybridSearchOptions, type IntentResult, type Link, type Memory, type MemoryType, type Path, type Priority, type RelationType, type RerankProvider, type RerankResult, type SearchIntent, type SearchResult, type Snapshot, type SnapshotAction, type StoredEmbedding, type SyncInput, type SyncResult, type TidyResult, type UpdateMemoryInput, boot, calculateVitality, classifyIntent, contentHash, countMemories, createDashScopeProvider, createLink, createMemory, createOpenAIProvider, createOpenAIRerankProvider, createPath, createSnapshot, decodeEmbedding, deleteLink, deleteMemory, deletePath, embedMemory, embedMissingForAgent, encodeEmbedding, exportMemories, getDecayedMemories, getDefaultInstruction, getEmbedding, getEmbeddingProviderFromEnv, getLinks, getMemory, getOutgoingLinks, getPath, getPathByUri, getPathsByDomain, getPathsByMemory, getPathsByPrefix, getRerankerProviderFromEnv, getSnapshot, getSnapshots, getStrategy, guard, listEmbeddings, listMemories, parseUri, recordAccess, rerank, rerankWithProvider, rollback, runDecay, runGovern, runTidy, searchBM25, searchHybrid, syncBatch, syncOne, tokenize, traverse, updateMemory, upsertEmbedding };
+export { type AutoIngestWatcher, type AutoIngestWatcherOptions, type BootResult, type CreateMemoryInput, type ExportResult, type GovernResult, type GuardAction, type GuardResult, type IngestExtractedItem, type IngestResult, type IngestRunOptions, type Memory, type MemoryType, type Path, type Priority, type SearchResult, type SyncInput, type SyncResult, type TidyResult, type UpdateMemoryInput, boot, calculateVitality, classifyIngestType, contentHash, countMemories, createMemory, createPath, deleteMemory, deletePath, exportMemories, extractIngestItems, getDecayedMemories, getMemory, getPath, getPathByUri, getPathsByDomain, getPathsByMemory, getPathsByPrefix, guard, ingestText, listMemories, parseUri, recordAccess, runAutoIngestWatcher, runDecay, runGovern, runTidy, searchBM25, slugify, splitIngestBlocks, syncBatch, syncOne, tokenize, updateMemory };