@intrect/openswarm 0.2.0

package/dist/memory/memoryCore.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Persistent Cognitive Memory Module v2.0 - Core
+ *
+ * Types, embedding, distillation, database init, save, search.
+ * High-level operations (revision, formatting, background) are in memoryOps.ts.
+ */
+import { Table, Connection } from '@lancedb/lancedb';
+export declare const EMBEDDING_DIM = 768;
+export declare const PERMANENT_EXPIRY: number;
+/**
+ * Normalize records before LanceDB createTable
+ * - Prevents type inference errors (especially expiresAt)
+ * - Converts BigInt to Number, undefined to defaults
+ */
+export declare function normalizeRecords(records: any[]): CognitiveMemoryRecord[];
+export type CognitiveMemoryType = 'belief' | 'strategy' | 'user_model' | 'system_pattern' | 'constraint';
+export type LegacyMemoryType = 'decision' | 'repomap' | 'journal' | 'fact';
+export type MemoryType = CognitiveMemoryType | LegacyMemoryType;
+export type StabilityLevel = 'low' | 'medium' | 'high';
+export interface CognitiveMemoryRecord {
+    [key: string]: unknown;
+    id: string;
+    type: MemoryType;
+    content: string;
+    vector: number[];
+    importance: number;
+    confidence: number;
+    createdAt: number;
+    lastUpdated: number;
+    lastAccessed: number;
+    revisionCount: number;
+    decay: number;
+    stability: StabilityLevel;
+    contradicts: string;
+    supports: string;
+    derivedFrom: string;
+    repo: string;
+    title: string;
+    metadata: string;
+    trust: number;
+    expiresAt: number;
+}
+export interface MemoryRecord extends CognitiveMemoryRecord {
+}
+export declare const BASE_IMPORTANCE: Record<CognitiveMemoryType, number>;
+export interface MemorySearchResult {
+    id: string;
+    type: MemoryType;
+    repo: string;
+    title: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    trust: number;
+    createdAt: number;
+    score: number;
+    freshness: number;
+    importance: number;
+    confidence: number;
+    stability: StabilityLevel;
+    revisionCount: number;
+    decay: number;
+    similarityScore: number;
+}
+export interface SearchOptions {
+    types?: MemoryType[];
+    repo?: string;
+    minSimilarity?: number;
+    minTrust?: number;
+    minFreshness?: number;
+    limit?: number;
+    includeExpired?: boolean;
+}
+export interface SearchResult {
+    success: boolean;
+    memories: MemorySearchResult[];
+    error?: string;
+    errorCode?: 'DB_INIT_FAILED' | 'EMBEDDING_FAILED' | 'QUERY_FAILED' | 'UNKNOWN';
+}
+export declare function getDb(): Connection | null;
+export declare function getTable(): Table | null;
+export declare function setTable(t: Table | null): void;
+/**
+ * Generate embeddings via Xenova/transformers (local, no external dependencies)
+ * @throws Error - on embedding generation failure (zero vector fallback removed)
+ */
+export declare function getEmbedding(text: string): Promise<number[]>;
+/**
+ * Distillation Quality Test (PRD core)
+ * "Would future reasoning performance degrade if this memory disappeared?"
+ */
+interface DistillationResult {
+    shouldStore: boolean;
+    type: CognitiveMemoryType;
+    importance: number;
+    confidence: number;
+    reason: string;
+}
+/**
+ * Semantic Distillation: evaluate whether content is worth storing
+ */
+export declare function distillContent(content: string, context?: {
+    isRepeated?: boolean;
+    isVerified?: boolean;
+    source?: string;
+}): DistillationResult;
+/**
+ * Calculate importance score (PRD Table + Adjustments)
+ */
+export declare function calculateImportance(type: MemoryType, options?: {
+    isRepeated?: boolean;
+    isVerified?: boolean;
+    age?: number;
+    hasContradiction?: boolean;
+}): number;
+/**
+ * Determine stability based on revision history
+ */
+export declare function calculateStability(revisionCount: number, age: number): StabilityLevel;
+/**
+ * Initialize database
+ */
+export declare function initDatabase(): Promise<void>;
+/**
+ * Calculate freshness (0-1, higher for more recent)
+ */
+export declare function calculateFreshness(createdAt: number, halfLifeDays?: number): number;
+/**
+ * Save memory (PRD v2.0 with Distillation)
+ */
+export declare function saveMemory(type: MemoryType, repo: string, title: string, content: string, options?: {
+    metadata?: Record<string, unknown>;
+    trust?: number;
+    ttlDays?: number;
+    importance?: number;
+    confidence?: number;
+    skipDistillation?: boolean;
+    isRepeated?: boolean;
+    isVerified?: boolean;
+    derivedFrom?: string;
+}): Promise<string | null>;
+/**
+ * Save cognitive memory directly (for PRD Schema)
+ */
+export declare function saveCognitiveMemory(type: CognitiveMemoryType, content: string, options?: {
+    importance?: number;
+    confidence?: number;
+    derivedFrom?: string;
+    supports?: string[];
+    contradicts?: string[];
+}): Promise<string | null>;
+/**
+ * Record design decision (ADR style)
+ */
+export declare function recordDecision(repo: string, title: string, context: string, decision: string, consequences: string, alternatives?: string): Promise<string>;
+/**
+ * Update repository map
+ */
+export declare function updateRepoMap(repo: string, modules: string[], entryPoints: string[], dependencies: Record<string, string>, notes?: string): Promise<string>;
+/**
+ * Log work entry
+ */
+export declare function logWork(repo: string, summary: string, details: string, filesChanged?: string[], issueRef?: string): Promise<string>;
+/**
+ * Record a fact (versions, environments, etc.)
+ */
+export declare function recordFact(repo: string, title: string, content: string, category: 'version' | 'build' | 'deploy' | 'constraint' | 'other'): Promise<string>;
+/**
+ * Search memory (PRD Hybrid Retrieval) - Safe version
+ * Distinguishes between errors and empty results
+ */
+export declare function searchMemorySafe(query: string, options?: SearchOptions): Promise<SearchResult>;
+/**
+ * Search memory (PRD Hybrid Retrieval) - Legacy compatible
+ * @deprecated Use searchMemorySafe instead
+ */
+export declare function searchMemory(query: string, options?: SearchOptions): Promise<MemorySearchResult[]>;
+export {};
+//# sourceMappingURL=memoryCore.d.ts.map

package/dist/memory/memoryCore.d.ts.map

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