gnosys 4.0.0

package/dist/lib/dream.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Gnosys Dream Mode — Sleep-time consolidation engine.
+ *
+ * Metaphor: "closing all the open books overnight."
+ *
+ * Dream Mode runs during idle periods (configurable threshold) and performs:
+ *   1. Confidence decay sweep — apply exponential decay to unreinforced memories
+ *   2. Summary generation — hierarchical summaries per category
+ *   3. Self-critique — score memories but NEVER delete; produces a review list
+ *   4. Relationship discovery — find new links between memories
+ *   5. Deduplication pass — flag similar memories for human review
+ *
+ * Safety guarantees:
+ *   - Never deletes or archives autonomously
+ *   - All changes are non-destructive (confidence updates, summaries, review flags)
+ *   - Configurable max runtime (default 30 min)
+ *   - Off by default — must be explicitly enabled
+ *   - Uses cheap/local LLM (configurable, defaults to Ollama)
+ */
+import { GnosysDB } from "./db.js";
+import { GnosysConfig, LLMProviderName } from "./config.js";
+export interface DreamConfig {
+    /** Enable dream mode (default: false) */
+    enabled: boolean;
+    /** Idle time in minutes before triggering (default: 10) */
+    idleMinutes: number;
+    /** Max runtime in minutes (default: 30) */
+    maxRuntimeMinutes: number;
+    /** LLM provider to use for dream operations (default: "ollama") */
+    provider: LLMProviderName;
+    /** LLM model override for dream operations */
+    model?: string;
+    /** Enable self-critique scoring (default: true) */
+    selfCritique: boolean;
+    /** Enable summary generation (default: true) */
+    generateSummaries: boolean;
+    /** Enable relationship discovery (default: true) */
+    discoverRelationships: boolean;
+    /** Min memory count before dream mode activates (default: 10) */
+    minMemories: number;
+}
+export declare const DEFAULT_DREAM_CONFIG: DreamConfig;
+export interface DreamReport {
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    decayUpdated: number;
+    summariesGenerated: number;
+    summariesUpdated: number;
+    reviewSuggestions: ReviewSuggestion[];
+    relationshipsDiscovered: number;
+    duplicatesFound: number;
+    errors: string[];
+    aborted: boolean;
+    abortReason?: string;
+}
+export interface ReviewSuggestion {
+    memoryId: string;
+    title: string;
+    reason: string;
+    currentConfidence: number;
+    suggestedAction: "review" | "consider-archive" | "consider-merge" | "needs-update";
+}
+export declare class GnosysDreamEngine {
+    private db;
+    private config;
+    private dreamConfig;
+    private provider;
+    private abortRequested;
+    private startTime;
+    constructor(db: GnosysDB, config: GnosysConfig, dreamConfig?: Partial<DreamConfig>);
+    /**
+     * Request abort — dream cycle will stop at the next safe checkpoint.
+     */
+    abort(): void;
+    /**
+     * Check if we've exceeded max runtime.
+     */
+    private isOvertime;
+    /**
+     * Check if we should stop (abort requested or overtime).
+     */
+    private shouldStop;
+    /**
+     * Run the full dream cycle.
+     * This is the main entry point — runs all dream operations in sequence.
+     */
+    dream(onProgress?: (phase: string, detail: string) => void): Promise<DreamReport>;
+    private finalize;
+    /**
+     * Apply exponential decay to all active memories.
+     * Formula: decayed = confidence * e^(-λ * days_since_reinforced)
+     * Only updates if decayed value differs from stored value by > 0.01.
+     */
+    private decaySweep;
+    /**
+     * Score memories and generate review suggestions.
+     * NEVER deletes or archives — only flags for human review.
+     */
+    private selfCritique;
+    /**
+     * Rule-based critique — fast, no LLM needed.
+     */
+    private critiquMemory;
+    /**
+     * LLM-based critique for borderline memories.
+     */
+    private llmCritique;
+    /**
+     * Determine suggested action based on issues.
+     */
+    private suggestAction;
+    /**
+     * Generate or update hierarchical summaries per category.
+     * Uses LLM to synthesize category-level overviews.
+     */
+    private generateSummaries;
+    /**
+     * Use LLM to generate a category summary.
+     */
+    private summarizeCategory;
+    /**
+     * Use LLM to discover relationships between memories.
+     * Only creates new edges — never removes existing ones.
+     */
+    private discoverRelationships;
+    /**
+     * Use LLM to find relationships for a batch of source memories.
+     */
+    private findRelationships;
+}
+/**
+ * Manages the dream cycle schedule within a running server.
+ * Monitors idle time and triggers dream mode when conditions are met.
+ */
+export declare class DreamScheduler {
+    private engine;
+    private config;
+    private lastActivity;
+    private checkInterval;
+    private running;
+    private currentDream;
+    constructor(engine: GnosysDreamEngine, config?: Partial<DreamConfig>);
+    /**
+     * Record activity — resets the idle timer.
+     * Call this on every MCP tool invocation.
+     */
+    recordActivity(): void;
+    /**
+     * Start the scheduler — checks idle time periodically.
+     */
+    start(): void;
+    /**
+     * Stop the scheduler and abort any running dream.
+     */
+    stop(): void;
+    /**
+     * Check if idle long enough to start dreaming.
+     */
+    private checkIdle;
+    /**
+     * Check if currently dreaming.
+     */
+    isDreaming(): boolean;
+}
+/**
+ * Format a dream report as human-readable text.
+ */
+export declare function formatDreamReport(report: DreamReport): string;
+//# sourceMappingURL=dream.d.ts.map

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

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