ai-memory-layer 2.0.0

package/dist/contracts/policy.d.ts

@@ -0,0 +1,108 @@
+import type { KnowledgeClass } from './types.js';
+export type ConflictStrategy = 'supersede' | 'keep_both' | 'skip';
+export type ContextMode = 'chat' | 'coding' | 'autonomous_agent' | 'review';
+export interface MonitorPatterns {
+    subjectChange: RegExp[];
+    taskReset: RegExp[];
+    acknowledgment: RegExp[];
+    close: RegExp[];
+}
+export interface MaintenancePolicy {
+    workingMemoryTtlSeconds?: number;
+    completedWorkItemTtlSeconds?: number;
+    knowledgeStaleAfterSeconds?: number;
+    minKnowledgeAccessCount?: number;
+    maxActiveKnowledgeItems?: number;
+    consolidateKnowledge?: boolean;
+    trustedCoreRetentionDays?: number;
+    provisionalRetentionDays?: number;
+    disputedRetentionDays?: number;
+    reverificationCadenceDays?: number;
+    classRetentionOverrides?: Partial<Record<'identity' | 'preference' | 'constraint' | 'procedure' | 'strategy' | 'anti_pattern' | 'project_fact' | 'episodic_fact', number>>;
+    requireReconfirmationForProjectFacts?: boolean;
+    preserveEvidenceForTrustedKnowledge?: boolean;
+}
+export interface MonitorPolicy {
+    softTurnThreshold?: number;
+    hardTurnThreshold?: number;
+    softTokenThreshold?: number;
+    hardTokenThreshold?: number;
+    softRetainTurns?: number;
+    hardRetainTurns?: number;
+    softScoreThreshold?: number;
+    hardScoreThreshold?: number;
+    floorTurns?: number;
+    floorTokens?: number;
+    recentWindow?: number;
+    toolLookBack?: number;
+    heavySingleTokenSoft?: number;
+    heavySingleTokenHard?: number;
+    heavyCumulativeTokens?: number;
+    intraSessionGapSeconds?: number;
+    customPatterns?: Partial<MonitorPatterns>;
+}
+export interface ExtractionPolicy {
+    autoExtractAfterCompaction?: boolean;
+    maxFactsPerExtraction?: number;
+    deduplicateFacts?: boolean;
+    touchDuplicates?: boolean;
+    minConfidenceForPromotion?: 'high' | 'medium';
+    conflictStrategy?: ConflictStrategy;
+    requireGroundingForTrusted?: boolean;
+    minimumEvidenceCountForTrusted?: number;
+    assistantClaimPenalty?: number;
+    toolEvidenceBoost?: number;
+    explicitStatementBoost?: number;
+    contradictionDisputeThreshold?: number;
+    trustPromotionThreshold?: number;
+    trustProvisionalThreshold?: number;
+    humanFeedbackBoost?: number;
+    executionSuccessBoost?: number;
+    executionFailurePenalty?: number;
+    noGroundingPenalty?: number;
+    contradictionTrustPenalty?: number;
+    reverificationExplicitnessBoost?: number;
+    reverificationContradictionPenalty?: number;
+    contradictionSeverityMediumThreshold?: number;
+    contradictionSeverityHighThreshold?: number;
+}
+export interface ContextPolicy {
+    mode?: ContextMode;
+    maxKnowledgeItems?: number;
+    maxRecentSummaries?: number;
+    tokenBudget?: number;
+    lexicalWeight?: number;
+    semanticWeight?: number;
+    recencyWeight?: number;
+    importanceWeight?: number;
+    trustWeight?: number;
+    durabilityWeight?: number;
+    evidenceWeight?: number;
+    contradictionPenalty?: number;
+    provisionalPenalty?: number;
+    objectiveLinkWeight?: number;
+    scopeRelationWeight?: number;
+    collaborationScopeScore?: number;
+    systemScopeScore?: number;
+    tenantScopeScore?: number;
+    localTrustedBonus?: number;
+    localTrustedThreshold?: number;
+    lineageWeight?: number;
+    unrelatedLineagePenalty?: number;
+    minimumLineageScore?: number;
+    evidenceSaturationCount?: number;
+    classImportanceOverrides?: Partial<Record<KnowledgeClass, number>>;
+    semanticMinSimilarity?: number;
+    trustedCoreLimit?: number;
+    taskRelevantLimit?: number;
+    diversityPenalty?: number;
+    maxPerFactType?: number;
+    touchSelectedKnowledge?: boolean;
+}
+export declare const DEFAULT_MONITOR_POLICY: Required<Omit<MonitorPolicy, 'customPatterns'>> & {
+    customPatterns: Required<MonitorPatterns>;
+};
+export declare const DEFAULT_EXTRACTION_POLICY: Required<ExtractionPolicy>;
+export declare const DEFAULT_CONTEXT_POLICY: Required<ContextPolicy>;
+export declare const DEFAULT_MAINTENANCE_POLICY: Required<MaintenancePolicy>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/contracts/policy.d.ts.map

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

package/dist/contracts/policy.js

@@ -0,0 +1,107 @@
+export const DEFAULT_MONITOR_POLICY = {
+    softTurnThreshold: 15,
+    hardTurnThreshold: 30,
+    softTokenThreshold: 3000,
+    hardTokenThreshold: 6000,
+    softRetainTurns: 12,
+    hardRetainTurns: 8,
+    softScoreThreshold: 4,
+    hardScoreThreshold: 6,
+    floorTurns: 15,
+    floorTokens: 3000,
+    recentWindow: 10,
+    toolLookBack: 5,
+    heavySingleTokenSoft: 600,
+    heavySingleTokenHard: 1200,
+    heavyCumulativeTokens: 2400,
+    intraSessionGapSeconds: 1800,
+    customPatterns: {
+        subjectChange: [],
+        taskReset: [],
+        acknowledgment: [],
+        close: [],
+    },
+};
+export const DEFAULT_EXTRACTION_POLICY = {
+    autoExtractAfterCompaction: true,
+    maxFactsPerExtraction: 10,
+    deduplicateFacts: true,
+    touchDuplicates: true,
+    minConfidenceForPromotion: 'medium',
+    conflictStrategy: 'supersede',
+    requireGroundingForTrusted: true,
+    minimumEvidenceCountForTrusted: 2,
+    assistantClaimPenalty: 0.15,
+    toolEvidenceBoost: 0.2,
+    explicitStatementBoost: 0.1,
+    contradictionDisputeThreshold: 0.35,
+    trustPromotionThreshold: 0.7,
+    trustProvisionalThreshold: 0.45,
+    humanFeedbackBoost: 0.2,
+    executionSuccessBoost: 0.15,
+    executionFailurePenalty: 0.2,
+    noGroundingPenalty: 0.35,
+    contradictionTrustPenalty: 0.5,
+    reverificationExplicitnessBoost: 0.1,
+    reverificationContradictionPenalty: 0.25,
+    contradictionSeverityMediumThreshold: 0.35,
+    contradictionSeverityHighThreshold: 0.75,
+};
+export const DEFAULT_CONTEXT_POLICY = {
+    maxKnowledgeItems: 20,
+    maxRecentSummaries: 3,
+    mode: 'chat',
+    tokenBudget: Number.MAX_SAFE_INTEGER,
+    lexicalWeight: 1,
+    semanticWeight: 1.2,
+    recencyWeight: 1,
+    importanceWeight: 0.25,
+    trustWeight: 1.3,
+    durabilityWeight: 0.8,
+    evidenceWeight: 0.5,
+    contradictionPenalty: 1.5,
+    provisionalPenalty: 0.75,
+    objectiveLinkWeight: 0.4,
+    scopeRelationWeight: 0.25,
+    collaborationScopeScore: 0.65,
+    systemScopeScore: 0.3,
+    tenantScopeScore: 0.1,
+    localTrustedBonus: 0.35,
+    localTrustedThreshold: 0.7,
+    lineageWeight: 0.3,
+    unrelatedLineagePenalty: 0.35,
+    minimumLineageScore: 0.5,
+    evidenceSaturationCount: 3,
+    classImportanceOverrides: {},
+    semanticMinSimilarity: 0.1,
+    trustedCoreLimit: 8,
+    taskRelevantLimit: 12,
+    diversityPenalty: 0.2,
+    maxPerFactType: 8,
+    touchSelectedKnowledge: true,
+};
+export const DEFAULT_MAINTENANCE_POLICY = {
+    workingMemoryTtlSeconds: 30 * 24 * 60 * 60,
+    completedWorkItemTtlSeconds: 14 * 24 * 60 * 60,
+    knowledgeStaleAfterSeconds: 60 * 24 * 60 * 60,
+    minKnowledgeAccessCount: 1,
+    maxActiveKnowledgeItems: 500,
+    consolidateKnowledge: false,
+    trustedCoreRetentionDays: 365,
+    provisionalRetentionDays: 14,
+    disputedRetentionDays: 90,
+    reverificationCadenceDays: 30,
+    classRetentionOverrides: {
+        identity: 3650,
+        preference: 365,
+        constraint: 365,
+        procedure: 180,
+        strategy: 180,
+        anti_pattern: 365,
+        project_fact: 90,
+        episodic_fact: 14,
+    },
+    requireReconfirmationForProjectFacts: true,
+    preserveEvidenceForTrustedKnowledge: true,
+};
+//# sourceMappingURL=policy.js.map

package/dist/contracts/policy.js.map

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

package/dist/contracts/storage.d.ts

@@ -0,0 +1,78 @@
+import type { MemoryScope, ScopeLevel } from './identity.js';
+import type { CompactionLog, ContextMonitor, ContextMonitorUpsert, KnowledgeCandidate, KnowledgeEvidence, KnowledgeMemory, KnowledgeMemoryAudit, NewCompactionLog, NewKnowledgeCandidate, NewKnowledgeEvidence, NewKnowledgeMemory, NewKnowledgeMemoryAudit, NewWorkItem, NewTurn, NewWorkingMemory, PaginationOptions, PaginatedResult, SearchOptions, SearchResult, TimeRange, Turn, WorkItem, WorkingMemory } from './types.js';
+export interface StorageAdapter {
+    insertTurn(input: NewTurn): Turn;
+    insertTurns(inputs: NewTurn[]): Turn[];
+    getTurnById(id: number): Turn | null;
+    getActiveTurns(scope: MemoryScope, sessionId?: string): Turn[];
+    getActiveTurnsPaginated(scope: MemoryScope, options?: PaginationOptions): PaginatedResult<Turn>;
+    getTurnsByTimeRange(scope: MemoryScope, range: TimeRange): Turn[];
+    searchTurns(scope: MemoryScope, query: string, options?: SearchOptions): SearchResult<Turn>[];
+    archiveTurn(id: number, archivedAt: number, compactionLogId: number): void;
+    getArchivedTurnRange(sessionId: string, startId: number, endId: number, scope: MemoryScope): Turn[];
+    insertWorkingMemory(input: NewWorkingMemory): WorkingMemory;
+    getWorkingMemoryById(id: number): WorkingMemory | null;
+    getWorkingMemoryBySession(sessionId: string, scope: MemoryScope): WorkingMemory[];
+    getActiveWorkingMemory(scope: MemoryScope, sessionId?: string): WorkingMemory[];
+    getLatestWorkingMemory(scope: MemoryScope, sessionId?: string): WorkingMemory | null;
+    getWorkingMemoryByTimeRange(scope: MemoryScope, range: TimeRange): WorkingMemory[];
+    expireWorkingMemory(id: number): void;
+    markWorkingMemoryPromoted(id: number, knowledgeMemoryId: number): void;
+    insertKnowledgeMemory(input: NewKnowledgeMemory): KnowledgeMemory;
+    insertKnowledgeMemories(inputs: NewKnowledgeMemory[]): KnowledgeMemory[];
+    insertKnowledgeCandidate(input: NewKnowledgeCandidate): KnowledgeCandidate;
+    insertKnowledgeCandidates(inputs: NewKnowledgeCandidate[]): KnowledgeCandidate[];
+    getKnowledgeCandidateById(id: number): KnowledgeCandidate | null;
+    listKnowledgeCandidates(scope: MemoryScope, options?: {
+        state?: Array<KnowledgeCandidate['state']>;
+    }): KnowledgeCandidate[];
+    insertKnowledgeEvidence(input: NewKnowledgeEvidence): KnowledgeEvidence;
+    insertKnowledgeEvidenceBatch(inputs: NewKnowledgeEvidence[]): KnowledgeEvidence[];
+    listKnowledgeEvidenceForKnowledge(knowledgeId: number): KnowledgeEvidence[];
+    listKnowledgeEvidenceForCandidate(candidateId: number): KnowledgeEvidence[];
+    promoteKnowledgeCandidate(candidateId: number, input: NewKnowledgeMemory): KnowledgeMemory;
+    getKnowledgeMemoryById(id: number): KnowledgeMemory | null;
+    getActiveKnowledgeMemory(scope: MemoryScope): KnowledgeMemory[];
+    getActiveKnowledgeMemoryPaginated(scope: MemoryScope, options?: PaginationOptions): PaginatedResult<KnowledgeMemory>;
+    getActiveKnowledgeCrossScope(scope: MemoryScope, level: ScopeLevel): KnowledgeMemory[];
+    getKnowledgeSince(scope: MemoryScope, level: ScopeLevel, since: number): KnowledgeMemory[];
+    getKnowledgeByTimeRange(scope: MemoryScope, range: TimeRange): KnowledgeMemory[];
+    searchKnowledge(scope: MemoryScope, query: string, options?: SearchOptions): SearchResult<KnowledgeMemory>[];
+    searchKnowledgeCrossScope(scope: MemoryScope, level: ScopeLevel, query: string, options?: SearchOptions): SearchResult<KnowledgeMemory>[];
+    insertKnowledgeMemoryAudit(input: NewKnowledgeMemoryAudit): KnowledgeMemoryAudit;
+    getRecentKnowledgeMemoryAudits(scope: MemoryScope, limit?: number): KnowledgeMemoryAudit[];
+    getKnowledgeMemoryAuditsForKnowledge(scope: MemoryScope, knowledgeId: number, limit?: number): KnowledgeMemoryAudit[];
+    updateKnowledgeMemory(id: number, patch: {
+        knowledge_state?: KnowledgeMemory['knowledge_state'];
+        knowledge_class?: KnowledgeMemory['knowledge_class'];
+        trust_score?: number;
+        verification_status?: KnowledgeMemory['verification_status'];
+        verification_notes?: string | null;
+        last_verified_at?: number | null;
+        next_reverification_at?: number | null;
+        last_confirmed_at?: number | null;
+        confirmation_count?: number;
+        disputed_at?: number | null;
+        dispute_reason?: string | null;
+        contradiction_score?: number;
+        superseded_at?: number | null;
+        successful_use_count?: number;
+        failed_use_count?: number;
+    }): KnowledgeMemory | null;
+    touchKnowledgeMemory(id: number): void;
+    retireKnowledgeMemory(id: number, retiredAt?: number): void;
+    supersedeKnowledgeMemory(oldId: number, newId: number): void;
+    insertWorkItem(input: NewWorkItem): WorkItem;
+    getActiveWorkItems(scope: MemoryScope): WorkItem[];
+    getWorkItemsByTimeRange(scope: MemoryScope, range: TimeRange): WorkItem[];
+    updateWorkItemStatus(id: number, status: WorkItem['status']): void;
+    deleteWorkItem(id: number): void;
+    upsertContextMonitor(input: ContextMonitorUpsert): ContextMonitor;
+    getContextMonitor(scope: MemoryScope): ContextMonitor | null;
+    insertCompactionLog(input: NewCompactionLog): CompactionLog;
+    getCompactionLogById(id: number): CompactionLog | null;
+    getRecentCompactionLogs(scope: MemoryScope, limit?: number): CompactionLog[];
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/contracts/storage.d.ts.map

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

package/dist/contracts/storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/contracts/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/contracts/storage.ts"],"names":[],"mappings":""}