visionclaw 0.1.219-beta.0 → 0.1.219-dev.codex-issue-2805-worker-runtime.1

package/dist/agent/mailbox.d.ts

@@ -1,50 +0,0 @@
-export type SessionMode = "general" | "coding";
-export interface MailboxMemo {
-    from: SessionMode;
-    to: SessionMode;
-    timestamp: string;
-    content: string;
-    inFlight?: boolean;
-}
-export interface CodingSessionInfo {
-    id: string | null;
-    status: "idle" | "in_progress" | "paused" | "completed";
-    taskSummary: string;
-    cwd?: string;
-    startedAt?: string;
-}
-export interface MailboxData {
-    activeSession: SessionMode;
-    memos: MailboxMemo[];
-    codingSession: CodingSessionInfo;
-}
-export declare function loadMailbox(options?: {
-    preserveInFlight?: boolean;
-}): MailboxData;
-export declare function saveMailbox(data: MailboxData): void;
-export declare function addMemo(from: SessionMode, to: SessionMode, content: string): void;
-/**
- * Mark memos addressed to the given session as in-flight and return them.
- * The memos remain on disk until explicitly acknowledged via `ackMemos()`.
- * If the process crashes before ack, the memos survive and will be
- * re-delivered on the next call (their `inFlight` flag is cleared on load).
- */
-export declare function consumeMemosFor(target: SessionMode): MailboxMemo[];
-/**
- * Acknowledge that memos for the target session have been successfully
- * injected into the agent context. Removes them from the mailbox on disk.
- */
-export declare function ackMemos(target: SessionMode): void;
-export declare function setActiveSession(mode: SessionMode): void;
-export declare function getActiveSession(): SessionMode;
-export declare function updateCodingSessionInfo(info: Partial<CodingSessionInfo>): void;
-/**
- * Reset the mailbox to its empty default state.
- *
- * Used by the startup engine-switch boundary: when the agent engine
- * changes between runs we collapse general + coding into a single
- * fresh general session, so any cross-session memos / in-progress
- * coding state would be stale and confusing if carried over.
- */
-export declare function clearMailbox(): void;
-//# sourceMappingURL=mailbox.d.ts.map

package/dist/agent/mailbox.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/agent/mailbox.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,WAAW,CAAC;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAsCD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAejF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAKnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAalE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIlD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAI9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/agent/mailbox.js

@@ -1,124 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { z } from "zod";
-import { getConfigDir } from "../config/index.js";
-const DEFAULT_MAILBOX = {
-    activeSession: "general",
-    memos: [],
-    codingSession: {
-        id: null,
-        status: "idle",
-        taskSummary: "",
-    },
-};
-const MailboxMemoSchema = z.object({
-    from: z.enum(["general", "coding"]),
-    to: z.enum(["general", "coding"]),
-    timestamp: z.string(),
-    content: z.string(),
-    inFlight: z.boolean().optional(),
-});
-const CodingSessionInfoSchema = z.object({
-    id: z.string().nullable().default(null),
-    status: z.enum(["idle", "in_progress", "paused", "completed"]).default("idle"),
-    taskSummary: z.string().default(""),
-    cwd: z.string().optional(),
-    startedAt: z.string().optional(),
-});
-const MailboxDataSchema = z.object({
-    activeSession: z.enum(["general", "coding"]).default("general"),
-    memos: z.array(MailboxMemoSchema).default([]),
-    codingSession: CodingSessionInfoSchema.default(DEFAULT_MAILBOX.codingSession),
-});
-function getMailboxFile() {
-    return path.join(getConfigDir(), "session-mailbox.json");
-}
-export function loadMailbox(options) {
-    const file = getMailboxFile();
-    if (!fs.existsSync(file))
-        return { ...DEFAULT_MAILBOX };
-    try {
-        const raw = JSON.parse(fs.readFileSync(file, "utf-8"));
-        const data = MailboxDataSchema.parse(raw);
-        if (!options?.preserveInFlight) {
-            for (const m of data.memos) {
-                m.inFlight = false;
-            }
-        }
-        return data;
-    }
-    catch {
-        return { ...DEFAULT_MAILBOX };
-    }
-}
-export function saveMailbox(data) {
-    const file = getMailboxFile();
-    const dir = path.dirname(file);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(file, JSON.stringify(data, null, 2), "utf-8");
-}
-export function addMemo(from, to, content) {
-    const data = loadMailbox();
-    data.memos.push({
-        from,
-        to,
-        timestamp: new Date().toISOString(),
-        content,
-    });
-    saveMailbox(data);
-}
-/**
- * Mark memos addressed to the given session as in-flight and return them.
- * The memos remain on disk until explicitly acknowledged via `ackMemos()`.
- * If the process crashes before ack, the memos survive and will be
- * re-delivered on the next call (their `inFlight` flag is cleared on load).
- */
-export function consumeMemosFor(target) {
-    const data = loadMailbox();
-    const forTarget = [];
-    for (const m of data.memos) {
-        if (m.to === target) {
-            m.inFlight = true;
-            forTarget.push(m);
-        }
-    }
-    if (forTarget.length > 0) {
-        saveMailbox(data);
-    }
-    return forTarget;
-}
-/**
- * Acknowledge that memos for the target session have been successfully
- * injected into the agent context. Removes them from the mailbox on disk.
- */
-export function ackMemos(target) {
-    const data = loadMailbox({ preserveInFlight: true });
-    data.memos = data.memos.filter((m) => !(m.to === target && m.inFlight));
-    saveMailbox(data);
-}
-export function setActiveSession(mode) {
-    const data = loadMailbox();
-    data.activeSession = mode;
-    saveMailbox(data);
-}
-export function getActiveSession() {
-    return loadMailbox().activeSession;
-}
-export function updateCodingSessionInfo(info) {
-    const data = loadMailbox();
-    data.codingSession = { ...data.codingSession, ...info };
-    saveMailbox(data);
-}
-/**
- * Reset the mailbox to its empty default state.
- *
- * Used by the startup engine-switch boundary: when the agent engine
- * changes between runs we collapse general + coding into a single
- * fresh general session, so any cross-session memos / in-progress
- * coding state would be stale and confusing if carried over.
- */
-export function clearMailbox() {
-    saveMailbox({ ...DEFAULT_MAILBOX, codingSession: { ...DEFAULT_MAILBOX.codingSession } });
-}
-//# sourceMappingURL=mailbox.js.map

package/dist/agent/mailbox.js.map

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

package/dist/agent/nightly-maintenance/memory-dreaming-sweep.d.ts

@@ -1,77 +0,0 @@
-/**
- * Transcript selection and one-job execution for NightlyMaintenance.
- * The same selection covers the main process and persisted worker threads;
- * the maintenance owner serializes jobs and yields to messages between them.
- */
-import type { VisionClawConfig } from "../../config/types.js";
-/**
- * Activity window for the deep-night dreaming fan-out. A thread whose most
- * recent transcript has not been touched within this many hours is not a
- * dreaming candidate: thread directories are never garbage-collected, so
- * without this the fan-out re-dreams months-dead threads on every dispatch.
- *
- * This asks "is this thread alive?" — the only remaining 72h window now that
- * the server-side usage proxy is gone: the client holds the originals, so it
- * reads the transcripts directly instead of inferring activity from billing.
- */
-export declare const DREAM_THREAD_ACTIVITY_WINDOW_MS: number;
-/** Thread id + the single transcript that thread's dreaming job will mine. */
-export interface DreamingTarget {
-    threadId: string;
-    transcriptPath: string;
-}
-export interface DreamingRunOptions {
-    /** Optional independent gate for vocabulary learning during dreaming. */
-    vocabularyLearningEnabled?: boolean;
-}
-/**
- * Every directory a single profile/thread dir can hold transcripts in.
- *
- * The Claude SDK writes under `~/.claude/projects/<slug>`, while the Pi engine
- * writes under `<profileDir>/pi-agent/<mode>/sessions` (see
- * `engines/pi-coding/session.ts`). A Pi-engine agent has nothing at all in the
- * Claude location, so resolving only that one silently excludes it from the
- * night sweep.
- */
-export declare function transcriptDirsForProfileDir(profileDir: string): string[];
-/**
- * Resolve the most-recently-modified transcript file under `transcriptDir`.
- * `discoverTranscriptSessionFiles` returns files grouped by session and
- * sorted by sessionId, not by time, so we stat each candidate and pick the
- * newest mtime. The discovery walk itself is unguarded at its leading
- * readdir/stat, so wrap it and return null on any missing dir / IO error.
- */
-export declare function mostRecentTranscript(transcriptDir: string): {
-    path: string;
-    mtimeMs: number;
-} | null;
-/** Newest transcript across several candidate directories, or null. */
-export declare function mostRecentTranscriptAcross(transcriptDirs: string[]): {
-    path: string;
-    mtimeMs: number;
-} | null;
-/**
- * Pick one transcript per thread for a deep-night sweep: the main process's own
- * plus every persisted thread in `threadIds`.
- *
- * Only one engine writes a given thread at a time, so taking the newest across
- * that thread's Claude *and* Pi directories yields the transcript that thread
- * actually last used. Threads idle beyond
- * {@link DREAM_THREAD_ACTIVITY_WINDOW_MS} are dropped: thread dirs are never
- * garbage-collected, and the downstream content gate does NOT filter them out
- * (a long-dead thread's transcript still clears the character and turn
- * thresholds), so the liveness check has to happen here.
- */
-export declare function resolveDreamingTargets(threadIds: string[], now?: number): DreamingTarget[];
-/**
- * Run one dreaming job. Never throws; the caller gets the outcome so it can
- * report it rather than guess.
- *
- * `memory-dreaming.js` is imported lazily to keep its (LLM-facing)
- * dependencies off the startup path.
- */
-export declare function runDreamingJob(threadId: string, transcriptPath: string, config: VisionClawConfig, options?: DreamingRunOptions): Promise<{
-    consolidated: boolean;
-    failed: boolean;
-}>;
-//# sourceMappingURL=memory-dreaming-sweep.d.ts.map

package/dist/agent/nightly-maintenance/memory-dreaming-sweep.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-dreaming-sweep.d.ts","sourceRoot":"","sources":["../../../src/agent/nightly-maintenance/memory-dreaming-sweep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,QAAsB,CAAC;AASnE,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB1C;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,EAAE,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,GAAE,MAAmB,GACvB,cAAc,EAAE,CA2BlB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA0BrD"}

package/dist/agent/nightly-maintenance/memory-dreaming-sweep.js

@@ -1,158 +0,0 @@
-/**
- * Transcript selection and one-job execution for NightlyMaintenance.
- * The same selection covers the main process and persisted worker threads;
- * the maintenance owner serializes jobs and yields to messages between them.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { getConfigDir, getThreadDir, loadOwnerConfig } from "../../config/index.js";
-import { discoverTranscriptSessionFiles } from "../../data-processing/transcript-discovery.js";
-import { logger } from "../../logger.js";
-import { getClaudeTranscriptDirForProfileDir } from "../../utils/claude-transcripts.js";
-import { threadApplication } from "../../threads/application-context.js";
-/**
- * Activity window for the deep-night dreaming fan-out. A thread whose most
- * recent transcript has not been touched within this many hours is not a
- * dreaming candidate: thread directories are never garbage-collected, so
- * without this the fan-out re-dreams months-dead threads on every dispatch.
- *
- * This asks "is this thread alive?" — the only remaining 72h window now that
- * the server-side usage proxy is gone: the client holds the originals, so it
- * reads the transcripts directly instead of inferring activity from billing.
- */
-export const DREAM_THREAD_ACTIVITY_WINDOW_MS = 72 * 60 * 60 * 1000;
-/**
- * Session modes the Pi engine persists transcripts for. Mirrors `SessionMode`
- * in `mailbox.ts`; spelled out here so this module does not depend on the
- * mailbox just for two string literals.
- */
-const PI_SESSION_MODES = ["general", "coding"];
-/**
- * Every directory a single profile/thread dir can hold transcripts in.
- *
- * The Claude SDK writes under `~/.claude/projects/<slug>`, while the Pi engine
- * writes under `<profileDir>/pi-agent/<mode>/sessions` (see
- * `engines/pi-coding/session.ts`). A Pi-engine agent has nothing at all in the
- * Claude location, so resolving only that one silently excludes it from the
- * night sweep.
- */
-export function transcriptDirsForProfileDir(profileDir) {
-    return [
-        getClaudeTranscriptDirForProfileDir(profileDir),
-        ...PI_SESSION_MODES.map((mode) => path.join(profileDir, "pi-agent", mode, "sessions")),
-    ];
-}
-/**
- * Resolve the most-recently-modified transcript file under `transcriptDir`.
- * `discoverTranscriptSessionFiles` returns files grouped by session and
- * sorted by sessionId, not by time, so we stat each candidate and pick the
- * newest mtime. The discovery walk itself is unguarded at its leading
- * readdir/stat, so wrap it and return null on any missing dir / IO error.
- */
-export function mostRecentTranscript(transcriptDir) {
-    let candidates;
-    try {
-        if (!fs.existsSync(transcriptDir))
-            return null;
-        candidates = discoverTranscriptSessionFiles(transcriptDir).flatMap((d) => d.files);
-    }
-    catch {
-        return null;
-    }
-    let newest = null;
-    let newestMtime = -1;
-    for (const file of candidates) {
-        try {
-            const mtime = fs.statSync(file).mtimeMs;
-            if (mtime > newestMtime) {
-                newestMtime = mtime;
-                newest = file;
-            }
-        }
-        catch {
-            // File vanished between discovery and stat; skip it.
-        }
-    }
-    return newest === null ? null : { path: newest, mtimeMs: newestMtime };
-}
-/** Newest transcript across several candidate directories, or null. */
-export function mostRecentTranscriptAcross(transcriptDirs) {
-    let newest = null;
-    for (const dir of transcriptDirs) {
-        const candidate = mostRecentTranscript(dir);
-        if (candidate && (!newest || candidate.mtimeMs > newest.mtimeMs)) {
-            newest = candidate;
-        }
-    }
-    return newest;
-}
-/**
- * Pick one transcript per thread for a deep-night sweep: the main process's own
- * plus every persisted thread in `threadIds`.
- *
- * Only one engine writes a given thread at a time, so taking the newest across
- * that thread's Claude *and* Pi directories yields the transcript that thread
- * actually last used. Threads idle beyond
- * {@link DREAM_THREAD_ACTIVITY_WINDOW_MS} are dropped: thread dirs are never
- * garbage-collected, and the downstream content gate does NOT filter them out
- * (a long-dead thread's transcript still clears the character and turn
- * thresholds), so the liveness check has to happen here.
- */
-export function resolveDreamingTargets(threadIds, now = Date.now()) {
-    const scopes = [
-        { threadId: "main", transcriptDirs: transcriptDirsForProfileDir(getConfigDir()) },
-        ...threadIds.map((threadId) => ({
-            threadId,
-            transcriptDirs: transcriptDirsForProfileDir(getThreadDir(threadId)),
-        })),
-    ];
-    const targets = [];
-    for (const { threadId, transcriptDirs } of scopes) {
-        const newest = mostRecentTranscriptAcross(transcriptDirs);
-        if (!newest) {
-            logger.debug(`[memory-dreaming] No transcript for deep-night dreaming in thread=${threadId}`);
-            continue;
-        }
-        const idleMs = now - newest.mtimeMs;
-        if (idleMs > DREAM_THREAD_ACTIVITY_WINDOW_MS) {
-            logger.debug(`[memory-dreaming] Skipping deep-night dreaming for idle thread=${threadId} ` +
-                `(${Math.round(idleMs / 3_600_000)}h since last activity)`);
-            continue;
-        }
-        targets.push({ threadId, transcriptPath: newest.path });
-    }
-    return targets;
-}
-/**
- * Run one dreaming job. Never throws; the caller gets the outcome so it can
- * report it rather than guess.
- *
- * `memory-dreaming.js` is imported lazily to keep its (LLM-facing)
- * dependencies off the startup path.
- */
-export async function runDreamingJob(threadId, transcriptPath, config, options = {}) {
-    try {
-        const sourceThread = threadId === "main" ? "default" : threadId;
-        const app = threadApplication(sourceThread, config);
-        const { runMemoryDreaming } = await import("./memory-dreaming.js");
-        let ownerPublicId;
-        try {
-            ownerPublicId = loadOwnerConfig().ownerPublicId;
-        }
-        catch {
-            // Onboarding may not have created owner.json yet; dreaming can still tidy memory.
-        }
-        const result = await runMemoryDreaming(transcriptPath, config, {
-            applicationContext: { threadId: sourceThread, app },
-            ownerPublicId,
-            vocabularyLearningEnabled: options.vocabularyLearningEnabled,
-        });
-        logger.debug(`[memory-dreaming] Dreaming done for thread=${threadId} (consolidated=${result.consolidated})`);
-        return { consolidated: result.consolidated, failed: false };
-    }
-    catch (err) {
-        logger.debug(`[memory-dreaming] Dreaming failed for thread=${threadId}: ${err instanceof Error ? err.message : String(err)}`);
-        return { consolidated: false, failed: true };
-    }
-}
-//# sourceMappingURL=memory-dreaming-sweep.js.map

package/dist/agent/nightly-maintenance/memory-dreaming-sweep.js.map

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

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

@@ -1,116 +0,0 @@
-/**
- * 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.
- *
- * 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";
-import type { ApplicationId } from "../../config/application-config.js";
-/**
- * Minimum number of meaningful transcript messages (user/assistant turns) in a
- * wake cycle before dreaming is worth the tokens. Counted from the transcript
- * itself rather than the inbound-message count, since one owner message
- * typically drives many agent turns.
- */
-export declare const DREAM_MIN_TURNS = 5;
-/**
- * Count meaningful user/assistant turns in the extracted transcript text. The
- * transcript-summarizer prefixes each retained message with `[user]:` /
- * `[assistant]:`, so we count those line markers.
- */
-export declare function countTranscriptTurns(transcriptText: string): number;
-/** Vocabulary candidate extracted during dreaming for STT personalization. */
-export declare const VocabularyCandidateSchema: z.ZodObject<{
-    term: z.ZodString;
-    spokenForms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    language: z.ZodOptional<z.ZodString>;
-    category: z.ZodEnum<{
-        code: "code";
-        stock: "stock";
-        person: "person";
-        company: "company";
-        product: "product";
-        technical: "technical";
-        other: "other";
-    }>;
-    confidence: z.ZodDefault<z.ZodNumber>;
-    evidenceKind: z.ZodEnum<{
-        user_text: "user_text";
-        confirmed_output: "confirmed_output";
-        structured_tool: "structured_tool";
-        asr_transcript: "asr_transcript";
-    }>;
-    sourceId: z.ZodString;
-}, z.core.$strip>;
-export type VocabularyCandidate = z.infer<typeof VocabularyCandidateSchema>;
-export declare const TidyOutputSchema: z.ZodObject<{
-    writes: z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
-        content: z.ZodString;
-    }, z.core.$strip>>;
-    delete_paths: z.ZodArray<z.ZodString>;
-    vocabularyCandidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        term: z.ZodString;
-        spokenForms: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        language: z.ZodOptional<z.ZodString>;
-        category: z.ZodEnum<{
-            code: "code";
-            stock: "stock";
-            person: "person";
-            company: "company";
-            product: "product";
-            technical: "technical";
-            other: "other";
-        }>;
-        confidence: z.ZodDefault<z.ZodNumber>;
-        evidenceKind: z.ZodEnum<{
-            user_text: "user_text";
-            confirmed_output: "confirmed_output";
-            structured_tool: "structured_tool";
-            asr_transcript: "asr_transcript";
-        }>;
-        sourceId: z.ZodString;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export type TidyOutput = z.infer<typeof TidyOutputSchema>;
-export interface RunMemoryDreamingOptions {
-    /** Source of this independent consolidation job; memory storage remains shared. */
-    applicationContext?: {
-        threadId: string;
-        app?: ApplicationId;
-    };
-    /** Override ordinary memory storage and the dreaming log/state location. */
-    memoriesDir?: string;
-    /** Override native auto-memory storage; null excludes that store. */
-    autoMemoryDir?: string | null;
-    /** Timestamp for deterministic logs/tests. Defaults to now. */
-    now?: Date;
-    /** Owner public ID for vocabulary glossary updates. Optional. */
-    ownerPublicId?: string;
-    /**
-     * Whether vocabulary learning is enabled for this dreaming pass.
-     * Defaults to true when an owner is available.
-     */
-    vocabularyLearningEnabled?: boolean;
-}
-export interface RunMemoryDreamingResult {
-    consolidated: boolean;
-    skipped?: "no-transcript" | "transcript-too-short" | "below-turn-threshold" | "already-dreamed" | "no-op" | "error";
-    /** Number of file writes and deletes actually applied. */
-    written?: number;
-}
-/**
- * Agent-local day (`YYYYMMDD`) of the last deep-night sweep, or null if none is
- * recorded. Read only for migration to the unified maintenance progress file;
- * an upgrade during the night must not repeat an already attempted sweep.
- */
-export declare function readDeepNightDreamDay(memoriesDir?: string): number | null;
-/** 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/nightly-maintenance/memory-dreaming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-dreaming.d.ts","sourceRoot":"","sources":["../../../src/agent/nightly-maintenance/memory-dreaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAuBxE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAGnE;AAmBD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAepC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA4B1D,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;IAC/D,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;IACX,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;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;AAsQD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAkGlC"}