visionclaw 0.1.213-beta.16 → 0.1.213-beta.17

package/dist/agent/memory-dreaming.d.ts

@@ -1,54 +1,13 @@
 /**
- * Memory dreaming — the agent tidying its own long-term memory
- * (issue #453 Phase 2; reworked in PR #2070).
+ * The agent tidies its existing memory files during the idle deep-night sweep.
+ * Dreaming is a default capability, independent of the layered-memory gate.
+ * The model decides how to organize, merge and retire memory; the runtime only
+ * applies explicit file edits, with backups before replacing or deleting files.
+ * No layer, entry type, index format or recall budget dictates what survives.
  *
- * A fast-model pass that runs once a day, in the deep-night window, while the
- * agent is idle — never after an individual wake cycle, because it rewrites and
- * deletes files. It is given the most recent transcript AND the current
- * contents of the memory store, and it returns EDITS to that store: entries to
- * write, entries to delete, the order they should be recalled in, and
- * optionally new text for the always-injected preferences file.
- *
- * Why edits and not extraction: the earlier design mined a transcript into four
- * fixed buckets and only ever APPENDED, so the store could grow but never
- * correct itself — a superseded entry stayed until a separate compaction pass
- * happened to fire. The owner's framing (2026-09-05) is the one implemented
- * here: "dreaming 的结果就是整理 memory … 就跟你日常经常发现 memory 超大，自己
- * 整理是一样的." Tidying therefore SUBSUMES the old warm-index compaction pass
- * (`memory-warm-compaction.ts`, deleted with this change) rather than composing
- * with it — two LLM passes editing the same files is a real bug, not defence in
- * depth.
- *
- * Design notes:
- *  - Dreaming is fully INDEPENDENT of the `memoryEnabled` feature gate, which
- *    still governs injection / critical-state-flush / system prompt but has no
- *    say here, and it has no gate of its own: it is a default capability of the
- *    agent (owner, 2026-09-05). The agent decides when to dream from its own
- *    clock — the deep-night window in `deep-night-dreaming.ts` is the ONLY
- *    trigger. A turn-count threshold still keeps a thin transcript from
- *    spending tokens.
- *  - The model returns OPERATIONS, never a rewritten store. Anything it does
- *    not name is kept byte-for-byte, so a hallucinating model can only damage
- *    what it explicitly touched, and omitting an entry from `order` can demote
- *    it but never delete it.
- *  - The one guardrail (owner's ruling: "写新文件永远可以忽略，删旧条目不可逆")
- *    is a snapshot taken before the first destructive write: `warm/index.md`,
- *    `hot/preferences.md` AND every `warm/<slug>.md` detail file are copied to
- *    `.bak` siblings. The detail files are the point — backing up the index
- *    alone would restore pointers to bodies this pass had already deleted.
- *    `.bak` is deliberately not a `.md` suffix so the injector never reads
- *    them back, and the orphan sweep never collects them.
- *  - SCOPE: this pass owns exactly what dreaming has always written — the
- *    `warm/` entry store and `hot/preferences.md` under {@link getMemoriesDir}.
- *    It does NOT read the memories ROOT (which holds `identity.md` and other
- *    secrets that must never reach a side call), does not touch
- *    `hot/active_tasks.md` / `hot/pending_actions.md` (owned by
- *    `critical-state-flush.ts`, rewritten from scratch each flush), and does
- *    not reach into the Claude CLI's separate `claude-auto-memory/` tree.
- *  - Each run appends a human-readable entry under `.dream_log/`, pruned to a
- *    90-day retention window.
- *  - Never throws and uses the fast model tier.
- *  - Injection-safe: transcript and stored content are treated as data only.
+ * Ordinary memory and Claude auto-memory keep their existing locations and
+ * formats. Credentials, runtime-owned task snapshots, hidden files and symlinks
+ * are excluded. Untouched files are never rewritten or garbage-collected.
  */
 import { z } from "zod";
 import type { VisionClawConfig } from "../config/types.js";
@@ -66,56 +25,27 @@ export declare const DREAM_MIN_TURNS = 5;
  */
 export declare function countTranscriptTurns(transcriptText: string): number;
 export declare const TidyOutputSchema: z.ZodObject<{
-    entries: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<{
-            lesson: "lesson";
-            fact: "fact";
-        }>;
-        summary: z.ZodString;
-        slug: z.ZodString;
-        detail: z.ZodString;
+    writes: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
     }, z.core.$strip>>;
-    delete_slugs: z.ZodArray<z.ZodString>;
-    order: z.ZodArray<z.ZodString>;
-    preferences: z.ZodNullable<z.ZodString>;
+    delete_paths: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 export type TidyOutput = z.infer<typeof TidyOutputSchema>;
 export interface RunMemoryDreamingOptions {
-    /** Override the memories directory. Defaults to {@link getMemoriesDir}. */
+    /** Override ordinary memory storage and the dreaming log/state location. */
     memoriesDir?: string;
-    /** ISO timestamp for deterministic logs/tests. Defaults to now. */
+    /** Override native auto-memory storage; null excludes that store. */
+    autoMemoryDir?: string | null;
+    /** Timestamp for deterministic logs/tests. Defaults to now. */
     now?: Date;
 }
 export interface RunMemoryDreamingResult {
     consolidated: boolean;
     skipped?: "no-transcript" | "transcript-too-short" | "below-turn-threshold" | "already-dreamed" | "no-op" | "error";
-    /** Count of store edits applied (writes + deletes + preferences rewrite). */
+    /** Number of file writes and deletes actually applied. */
     written?: number;
 }
-/** Parsed `[type] summary → warm/<slug>.md` index line. */
-export interface WarmIndexEntry {
-    type: "lesson" | "fact";
-    summary: string;
-    slug: string;
-}
-/**
- * Sanitize a model-supplied slug into a safe kebab-case file stem: lowercase,
- * only `[a-z0-9-]`, collapsed dashes, trimmed, capped at 40 chars. Falls back
- * to "entry" when nothing usable remains. Path separators and dots are stripped
- * so a slug can never escape `warm/` or collide with `index.md`.
- */
-export declare function sanitizeSlug(raw: string): string;
-/** Parse one index line into an entry, or null if it isn't an entry line. */
-export declare function parseIndexLine(line: string): WarmIndexEntry | null;
-/** Read + parse the index into entries (header/blank lines dropped). */
-export declare function readIndexEntries(memoriesDir: string): WarmIndexEntry[];
-/**
- * Rewrite `warm/index.md` from the given entries and enforce pointer
- * integrity: drop entries whose detail file is missing (dangling pointers) and
- * delete detail files that no entry references (orphans). Returns the entries
- * actually kept, in the order given.
- */
-export declare function reconcileWarmStore(memoriesDir: string, entries: WarmIndexEntry[]): WarmIndexEntry[];
 /**
  * Agent-local day (`YYYYMMDD`) of the last deep-night sweep, or null if none is
  * recorded. Used by the client-side deep-night decision to hold itself to one
@@ -124,10 +54,6 @@ export declare function reconcileWarmStore(memoriesDir: string, entries: WarmInd
 export declare function readDeepNightDreamDay(memoriesDir?: string): number | null;
 /** Latch the deep-night sweep to `localDay` (`YYYYMMDD`). */
 export declare function recordDeepNightDreamDay(localDay: number, memoriesDir?: string): void;
-/**
- * Run one dreaming/tidying pass. Safe to fire-and-forget at wake-cycle end: it
- * self-gates, swallows all errors, and only writes when the model surfaces
- * actual edits.
- */
+/** Run one idle tidying pass. Never throws; failed edits remain retryable. */
 export declare function runMemoryDreaming(transcriptPath: string | null, config: VisionClawConfig, options: RunMemoryDreamingOptions): Promise<RunMemoryDreamingResult>;
 //# sourceMappingURL=memory-dreaming.d.ts.map

package/dist/agent/memory-dreaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-dreaming.d.ts","sourceRoot":"","sources":["../../src/agent/memory-dreaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAc3D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAGnE;AAoDD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAgB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAoB1D,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EACJ,eAAe,GACf,sBAAsB,GACtB,sBAAsB,GACtB,iBAAiB,GACjB,OAAO,GACP,OAAO,CAAC;IACZ,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAoBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAMlE;AAMD,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAOtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EAAE,GACxB,cAAc,EAAE,CAkClB;AA8RD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF;AAuBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAwFlC"}
+{"version":3,"file":"memory-dreaming.d.ts","sourceRoot":"","sources":["../../src/agent/memory-dreaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAuB3D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAGnE;AAoBD,eAAO,MAAM,gBAAgB;;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAmB1D,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EACJ,eAAe,GACf,sBAAsB,GACtB,sBAAsB,GACtB,iBAAiB,GACjB,OAAO,GACP,OAAO,CAAC;IACZ,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqQD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAyDlC"}