openclawdreams 3.0.6 → 3.0.7

package/dist/src/instrumentation.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Structured instrumentation for the dream cycle.
+ *
+ * Collects phase timings and LLM call metadata so failures
+ * can be diagnosed from the log without guesswork.
+ */
+import type { TokenUsage } from "./types.js";
+export interface LLMCallRecord {
+    phase: string;
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    duration_ms: number;
+}
+export interface PhaseRecord {
+    phase: string;
+    status: "ok" | "error" | "skipped";
+    duration_ms: number;
+    error?: string;
+    llm_calls: LLMCallRecord[];
+    metadata?: Record<string, unknown>;
+}
+export interface DreamCycleTrace {
+    run_id: string;
+    started_at: string;
+    ended_at: string;
+    total_duration_ms: number;
+    phases: PhaseRecord[];
+    total_llm_calls: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+}
+/**
+ * Lightweight tracer for a single dream cycle run.
+ *
+ * Usage:
+ *   const tracer = new DreamTracer();
+ *   tracer.startPhase("load_state");
+ *   // ... do work ...
+ *   tracer.endPhase("load_state");
+ *
+ *   // For LLM calls:
+ *   tracer.startPhase("generate_dream:first_pass");
+ *   const result = await callWithRetry(...);
+ *   tracer.recordLLMCall("generate_dream:first_pass", model, result.usage, startTime);
+ *   tracer.endPhase("generate_dream:first_pass");
+ *
+ *   tracer.finish(); // logs the full trace
+ */
+export declare class DreamTracer {
+    readonly runId: string;
+    private readonly startedAt;
+    private readonly phases;
+    private readonly activePhases;
+    constructor(runId?: string);
+    startPhase(phase: string): void;
+    recordLLMCall(phase: string, model: string, usage: TokenUsage | undefined, startTime: number): void;
+    endPhase(phase: string, opts?: {
+        status?: "ok" | "error" | "skipped";
+        error?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    skipPhase(phase: string, reason?: string): void;
+    finish(): DreamCycleTrace;
+}
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/src/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;gBAEQ,KAAK,CAAC,EAAE,MAAM;IAM1B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,aAAa,CACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAChB,IAAI;IAqBP,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,IAAI;IAoBP,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAa/C,MAAM,IAAI,eAAe;CAoC1B"}

package/dist/src/instrumentation.js

@@ -0,0 +1,112 @@
+/**
+ * Structured instrumentation for the dream cycle.
+ *
+ * Collects phase timings and LLM call metadata so failures
+ * can be diagnosed from the log without guesswork.
+ */
+import { randomUUID } from "node:crypto";
+import logger from "./logger.js";
+/**
+ * Lightweight tracer for a single dream cycle run.
+ *
+ * Usage:
+ *   const tracer = new DreamTracer();
+ *   tracer.startPhase("load_state");
+ *   // ... do work ...
+ *   tracer.endPhase("load_state");
+ *
+ *   // For LLM calls:
+ *   tracer.startPhase("generate_dream:first_pass");
+ *   const result = await callWithRetry(...);
+ *   tracer.recordLLMCall("generate_dream:first_pass", model, result.usage, startTime);
+ *   tracer.endPhase("generate_dream:first_pass");
+ *
+ *   tracer.finish(); // logs the full trace
+ */
+export class DreamTracer {
+    runId;
+    startedAt;
+    phases = [];
+    activePhases = new Map();
+    constructor(runId) {
+        this.runId = runId ?? randomUUID();
+        this.startedAt = new Date();
+        logger.info(`[trace:${this.runId}] Dream cycle instrumentation started`);
+    }
+    startPhase(phase) {
+        this.activePhases.set(phase, { start: performance.now(), llm_calls: [] });
+        logger.debug(`[trace:${this.runId}] phase:${phase} started`);
+    }
+    recordLLMCall(phase, model, usage, startTime) {
+        const duration_ms = Math.round(performance.now() - startTime);
+        const record = {
+            phase,
+            model,
+            input_tokens: usage?.input_tokens ?? 0,
+            output_tokens: usage?.output_tokens ?? 0,
+            duration_ms,
+        };
+        const active = this.activePhases.get(phase);
+        if (active) {
+            active.llm_calls.push(record);
+        }
+        logger.info(`[trace:${this.runId}] llm_call phase=${phase} model=${model} ` +
+            `in=${record.input_tokens} out=${record.output_tokens} dur=${duration_ms}ms`);
+    }
+    endPhase(phase, opts) {
+        const active = this.activePhases.get(phase);
+        const duration_ms = active ? Math.round(performance.now() - active.start) : 0;
+        const status = opts?.status ?? "ok";
+        this.phases.push({
+            phase,
+            status,
+            duration_ms,
+            error: opts?.error,
+            llm_calls: active?.llm_calls ?? [],
+            metadata: opts?.metadata,
+        });
+        this.activePhases.delete(phase);
+        logger.debug(`[trace:${this.runId}] phase:${phase} ended status=${status} dur=${duration_ms}ms`);
+    }
+    skipPhase(phase, reason) {
+        this.phases.push({
+            phase,
+            status: "skipped",
+            duration_ms: 0,
+            llm_calls: [],
+            metadata: reason ? { reason } : undefined,
+        });
+        logger.debug(`[trace:${this.runId}] phase:${phase} skipped${reason ? `: ${reason}` : ""}`);
+    }
+    finish() {
+        const ended = new Date();
+        const total_duration_ms = ended.getTime() - this.startedAt.getTime();
+        let total_llm_calls = 0;
+        let total_input_tokens = 0;
+        let total_output_tokens = 0;
+        for (const p of this.phases) {
+            for (const c of p.llm_calls) {
+                total_llm_calls++;
+                total_input_tokens += c.input_tokens;
+                total_output_tokens += c.output_tokens;
+            }
+        }
+        const trace = {
+            run_id: this.runId,
+            started_at: this.startedAt.toISOString(),
+            ended_at: ended.toISOString(),
+            total_duration_ms,
+            phases: this.phases,
+            total_llm_calls,
+            total_input_tokens,
+            total_output_tokens,
+        };
+        logger.info(`[trace:${this.runId}] Dream cycle complete: ` +
+            `${total_duration_ms}ms, ${this.phases.length} phases, ` +
+            `${total_llm_calls} LLM calls, ` +
+            `${total_input_tokens} in / ${total_output_tokens} out tokens`);
+        logger.debug(`[trace:${this.runId}] full_trace=${JSON.stringify(trace)}`);
+        return trace;
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/src/instrumentation.js.map

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

package/dist/src/llm.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared LLM client utilities.
+ *
+ * Provides retry configuration and call helpers used by both
+ * the waking and dreamer modules. The actual LLM client is
+ * provided by the OpenClaw gateway (see index.ts).
+ */
+import { type Options as RetryOptions } from "p-retry";
+import type { LLMClient, LLMResponse } from "./types.js";
+/** Standard retry options for waking-state LLM calls. */
+export declare const WAKING_RETRY_OPTS: RetryOptions;
+/** Retry options for dream-cycle LLM calls (longer timeouts). */
+export declare const DREAM_RETRY_OPTS: RetryOptions;
+/**
+ * Helper: call LLM with retry and return the response.
+ */
+export declare function callWithRetry(client: LLMClient, params: {
+    model?: string;
+    maxTokens: number;
+    system: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+}, retryOpts?: RetryOptions): Promise<LLMResponse>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/src/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAe,EAAE,KAAK,OAAO,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,YAS/B,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,YAS9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IACN,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD,EACD,SAAS,GAAE,YAAgC,GAC1C,OAAO,CAAC,WAAW,CAAC,CAWtB"}

package/dist/src/llm.js

@@ -0,0 +1,40 @@
+/**
+ * Shared LLM client utilities.
+ *
+ * Provides retry configuration and call helpers used by both
+ * the waking and dreamer modules. The actual LLM client is
+ * provided by the OpenClaw gateway (see index.ts).
+ */
+import pRetry from "p-retry";
+import { AGENT_MODEL } from "./config.js";
+import logger from "./logger.js";
+/** Standard retry options for waking-state LLM calls. */
+export const WAKING_RETRY_OPTS = {
+    retries: 3,
+    minTimeout: 1000,
+    maxTimeout: 10000,
+    onFailedAttempt: (error) => {
+        logger.warn(`LLM attempt failed: ${error instanceof Error ? error.message : String(error)}`);
+    },
+};
+/** Retry options for dream-cycle LLM calls (longer timeouts). */
+export const DREAM_RETRY_OPTS = {
+    retries: 3,
+    minTimeout: 2000,
+    maxTimeout: 20000,
+    onFailedAttempt: (error) => {
+        logger.warn(`Dream generation failed: ${error instanceof Error ? error.message : String(error)}`);
+    },
+};
+/**
+ * Helper: call LLM with retry and return the response.
+ */
+export function callWithRetry(client, params, retryOpts = WAKING_RETRY_OPTS) {
+    return pRetry(() => client.createMessage({
+        model: params.model ?? AGENT_MODEL,
+        maxTokens: params.maxTokens,
+        system: params.system,
+        messages: params.messages,
+    }), retryOpts);
+}
+//# sourceMappingURL=llm.js.map

package/dist/src/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAwC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,KAAK;IACjB,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;QACzB,MAAM,CAAC,IAAI,CACT,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,KAAK;IACjB,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;QACzB,MAAM,CAAC,IAAI,CACT,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,MAKC,EACD,YAA0B,iBAAiB;IAE3C,OAAO,MAAM,CACX,GAAG,EAAE,CACH,MAAM,CAAC,aAAa,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW;QAClC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,EACJ,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,6 @@
+import "winston-daily-rotate-file";
+declare const logger: import("winston").Logger;
+export declare function setVerbose(verbose: boolean): void;
+export declare function closeLogger(): Promise<void>;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,2BAA2B,CAAC;AAGnC,QAAA,MAAM,MAAM,0BA4BV,CAAC;AAEH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3C;AAED,eAAe,MAAM,CAAC"}

package/dist/src/logger.js

@@ -0,0 +1,32 @@
+import { createLogger, format, transports } from "winston";
+import "winston-daily-rotate-file";
+import { getDataDir } from "./config.js";
+const logger = createLogger({
+    level: "info",
+    format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.printf(({ timestamp, level, message }) => `${timestamp} [${level.toUpperCase()}]: ${message}`)),
+    transports: [
+        new transports.DailyRotateFile({
+            dirname: getDataDir(),
+            filename: "openclawdreams-%DATE%.log",
+            datePattern: "YYYY-MM-DD",
+            zippedArchive: true,
+            maxSize: "20m",
+            maxFiles: "14d",
+            level: "debug",
+        }),
+        new transports.Console({
+            format: format.combine(format.colorize(), format.printf(({ timestamp, level, message }) => `${timestamp} [${level}]: ${message}`)),
+        }),
+    ],
+});
+export function setVerbose(verbose) {
+    logger.level = verbose ? "debug" : "info";
+}
+export function closeLogger() {
+    return new Promise((resolve) => {
+        logger.on("finish", resolve);
+        logger.end();
+    });
+}
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,GAAG,YAAY,CAAC;IAC1B,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM,CAAC,OAAO,CACpB,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EACnD,MAAM,CAAC,MAAM,CACX,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAChC,GAAG,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE,MAAM,OAAO,EAAE,CACtD,CACF;IACD,UAAU,EAAE;QACV,IAAI,UAAU,CAAC,eAAe,CAAC;YAC7B,OAAO,EAAE,UAAU,EAAE;YACrB,QAAQ,EAAE,2BAA2B;YACrC,WAAW,EAAE,YAAY;YACzB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,OAAO;SACf,CAAC;QACF,IAAI,UAAU,CAAC,OAAO,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,OAAO,CACpB,MAAM,CAAC,QAAQ,EAAE,EACjB,MAAM,CAAC,MAAM,CACX,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,EAAE,CACzE,CACF;SACF,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,eAAe,MAAM,CAAC"}

package/dist/src/memory.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Encrypted deep memory system.
+ *
+ * All memories are encrypted with AES-256-GCM in a SQLite database.
+ * The waking agent writes to deep memory but cannot read it — only
+ * the dream process can decrypt. Context for LLM prompts is formatted
+ * via `formatDeepMemoryContext()`.
+ */
+import type { DecryptedMemory, DeepMemoryStats, MemoryEntry } from "./types.js";
+/**
+ * Parse `git diff --stat` output into structured FileDiff[].
+ */
+export declare function parseDiffStat(diffStat: string): import("./types.js").FileDiff[];
+/**
+ * Close the shared SQLite connection. Safe to call multiple times.
+ * After closing, the next getDb() call will reopen.
+ */
+export declare function closeDb(): void;
+export declare function storeDeepMemory(content: Record<string, unknown>, category?: string): number | bigint;
+export declare function getDeepMemoryById(id: number | bigint): DecryptedMemory | null;
+export declare function retrieveUndreamedMemories(): DecryptedMemory[];
+export declare function markAsDreamed(memoryIds: number[]): void;
+export declare function deepMemoryStats(): DeepMemoryStats;
+export interface DeepMemoryQueryOptions {
+    limit?: number;
+    categories?: string[];
+    undreamedOnly?: boolean;
+}
+/**
+ * Query deep memory with optional filters. Decrypts results, handles
+ * corruption gracefully, returns in chronological order.
+ */
+export declare function getRecentDeepMemories(options?: DeepMemoryQueryOptions): DecryptedMemory[];
+/**
+ * Format decrypted memories as a text block for LLM prompts.
+ *
+ * Extracts `content.summary` when available, falls back to truncated JSON.
+ * Respects an approximate token budget (1 token ≈ 4 chars).
+ */
+export declare function formatDeepMemoryContext(memories?: DecryptedMemory[], maxTokensApprox?: number): string;
+/** Register a new dream. INSERT OR IGNORE (idempotent). */
+export declare function registerDream(filename: string, title: string, dreamDate: string, options?: {
+    isNightmare?: boolean;
+    isMetaSynthesis?: boolean;
+    sourceFilenames?: string[];
+    deepMemoryId?: number | bigint;
+}): void;
+/** Increment remember_count for a dream that was selected. */
+export declare function incrementRememberCount(filename: string): void;
+/**
+ * Weighted random selection: score = 1/(count+1) * max(1, age_days).
+ * Fetch all rows from SQLite, compute scores in JS, do weighted pick.
+ * Returns filename and deep_memory_id, or null if table is empty.
+ */
+export declare function selectDreamToRemember(today: string): {
+    filename: string;
+    deep_memory_id: number | null;
+} | null;
+/** For inspection/testing. */
+export declare function getDreamRemembrances(): Array<{
+    filename: string;
+    title: string;
+    dream_date: string;
+    remember_count: number;
+    is_nightmare: number;
+    is_meta_synthesis: number;
+    source_filenames: string | null;
+    deep_memory_id: number | null;
+}>;
+export interface DreamLineageRow {
+    id: number;
+    dream_filename: string;
+    parent_memory_ids: string | null;
+    thematic_kin: string | null;
+    dominant_concepts: string | null;
+    created_at: string;
+}
+export declare function insertDreamLineage(dreamFilename: string, parentMemoryIds: number[], thematicKin: string[], dominantConcepts: string[]): void;
+export declare function getAllDreamLineage(): DreamLineageRow[];
+export declare function getDreamLineageByFilename(filename: string): DreamLineageRow | null;
+/**
+ * Find thematic kin for a dream by computing concept overlap with all prior dreams.
+ * Returns filenames of dreams with overlap >= threshold (default 0.3).
+ */
+export declare function findThematicKin(currentConcepts: string[], currentFilename: string, threshold?: number): Array<{
+    filename: string;
+    overlap: number;
+}>;
+/**
+ * Store a structured MemoryEntry in encrypted deep memory.
+ *
+ * Accepts either a MemoryEntry directly, or a legacy (summary, fullContext)
+ * pair for backward compatibility.
+ */
+export declare function remember(summaryOrEntry: string | MemoryEntry, fullContextOrCategory?: Record<string, unknown> | string, category?: string): void;
+//# sourceMappingURL=memory.d.ts.map

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

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