@a1hvdy/cc-openclaw 0.10.4 → 0.12.0

package/dist/src/patches/tools-restoration.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PatchSpec: tools-restoration — Phase E#3 scaffold.
+ *
+ * Target: removal of the legacy `body.tools=''` defensive block. Phase 2
+ * R5 — historically the proxy stripped tools; v0.5.x added Native streaming;
+ * Phase E#3 finalizes by ensuring no leftover `tools=''` write-paths exist.
+ * Drift-detection only today.
+ */
+import type { PatchSpec } from '../lifecycle/patch-manifest.js';
+type ToolsRestorationTarget = Record<string, unknown>;
+export declare const toolsRestorationSpec: PatchSpec<ToolsRestorationTarget>;
+export {};

package/dist/src/patches/tools-restoration.js

@@ -0,0 +1,43 @@
+/**
+ * PatchSpec: tools-restoration — Phase E#3 scaffold.
+ *
+ * Target: removal of the legacy `body.tools=''` defensive block. Phase 2
+ * R5 — historically the proxy stripped tools; v0.5.x added Native streaming;
+ * Phase E#3 finalizes by ensuring no leftover `tools=''` write-paths exist.
+ * Drift-detection only today.
+ */
+export const toolsRestorationSpec = {
+    id: 'tools-restoration',
+    targetModule: 'openclaw',
+    targetSymbol: 'EmbeddedServer.route — tools=[] forwarding',
+    async resolve() {
+        const upstream = (await import('openclaw'));
+        if (typeof upstream !== 'object' || upstream === null) {
+            throw new Error('openclaw import did not return an object');
+        }
+        return upstream;
+    },
+    expectedShape(target) {
+        // Tools-forwarding integrity probe — verify the server-startup +
+        // CLI entry surface, since tools routing flows through runLegacyCliEntry.
+        if (typeof target !== 'object' || target === null)
+            return false;
+        return (typeof target.runLegacyCliEntry === 'function' &&
+            typeof target.loadConfig === 'function');
+    },
+    async expectedBehavior(_target) {
+        // Phase E#3 finding 4 workaround (2026-05-13): tools-forwarding depends
+        // on the active openclaw.json. Verify it's reachable via raw JSON.parse
+        // rather than going through loadConfig (which schema-rejects
+        // cc-openclaw-specific keys).
+        const { probeOpenclawJsonReachable } = await import('../lib/safe-upstream-probes.js');
+        return probeOpenclawJsonReachable();
+    },
+    install(_target) {
+        // Phase E#3 — ensure tools forwarding is preserved (no `tools=''` overwrite).
+    },
+    uninstall(_target) {
+        // Phase E#3 — restore original tools forwarding behavior.
+    },
+};
+//# sourceMappingURL=tools-restoration.js.map

package/dist/src/patches/tools-restoration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-restoration.js","sourceRoot":"","sources":["../../../src/patches/tools-restoration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,CAAC,MAAM,oBAAoB,GAAsC;IACrE,EAAE,EAAE,mBAAmB;IACvB,YAAY,EAAE,UAAU;IACxB,YAAY,EAAE,4CAA4C;IAE1D,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAY,CAAC;QACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,QAAkC,CAAC;IAC5C,CAAC;IAED,aAAa,CAAC,MAA8B;QAC1C,iEAAiE;QACjE,0EAA0E;QAC1E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChE,OAAO,CACL,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU;YAC9C,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,CACxC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAA+B;QACpD,wEAAwE;QACxE,wEAAwE;QACxE,6DAA6D;QAC7D,8BAA8B;QAC9B,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;QACtF,OAAO,0BAA0B,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,OAA+B;QACrC,8EAA8E;IAChF,CAAC;IAED,SAAS,CAAC,OAA+B;QACvC,0DAA0D;IAC5D,CAAC;CACF,CAAC"}

package/dist/src/persistence/migration-v0.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MigrationV0 — reads the legacy 4-file persistence format READ-ONLY into
+ * SessionRegistry on first boot (Q5 resolution: auto-migrate read-only;
+ * explicit `cc-openclaw migrate --commit` required for deletion).
+ *
+ * Legacy files (NEVER deleted by this module):
+ *   ~/.openclaw/claude-sessions.json
+ *   ~/.openclaw/savvy-resume-registry.json
+ *   ~/.openclaw/session-pids.json
+ *   ~/.openclaw/openclaw-cache-parity-registry.json
+ *
+ * Shapes are parsed permissively (unknown → narrowed via type guards).
+ * Missing or malformed files are silently skipped — migration is best-effort.
+ */
+import { type SessionState } from './session-registry.js';
+export declare class MigrationV0 {
+    /**
+     * Read all legacy files and return SessionState[] for loading into
+     * SessionRegistry. NEVER modifies or deletes the source files.
+     */
+    readLegacy(): Promise<SessionState[]>;
+    private readPidMap;
+    private readCacheParityMap;
+}

package/dist/src/persistence/migration-v0.js

@@ -0,0 +1,142 @@
+/**
+ * MigrationV0 — reads the legacy 4-file persistence format READ-ONLY into
+ * SessionRegistry on first boot (Q5 resolution: auto-migrate read-only;
+ * explicit `cc-openclaw migrate --commit` required for deletion).
+ *
+ * Legacy files (NEVER deleted by this module):
+ *   ~/.openclaw/claude-sessions.json
+ *   ~/.openclaw/savvy-resume-registry.json
+ *   ~/.openclaw/session-pids.json
+ *   ~/.openclaw/openclaw-cache-parity-registry.json
+ *
+ * Shapes are parsed permissively (unknown → narrowed via type guards).
+ * Missing or malformed files are silently skipped — migration is best-effort.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { asSessionName } from './session-registry.js';
+const HOME = homedir();
+const OPENCLAW_ROOT = join(HOME, '.openclaw');
+const LEGACY_PATHS = {
+    claudeSessions: join(OPENCLAW_ROOT, 'claude-sessions.json'),
+    savvyResume: join(OPENCLAW_ROOT, 'savvy-resume-registry.json'),
+    sessionPids: join(OPENCLAW_ROOT, 'session-pids.json'),
+    cacheParity: join(OPENCLAW_ROOT, 'openclaw-cache-parity-registry.json'),
+};
+// ── Internal type guards ──────────────────────────────────────────────────────
+function isRecord(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function safeReadJson(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ── MigrationV0 ───────────────────────────────────────────────────────────────
+export class MigrationV0 {
+    /**
+     * Read all legacy files and return SessionState[] for loading into
+     * SessionRegistry. NEVER modifies or deletes the source files.
+     */
+    async readLegacy() {
+        const results = [];
+        const pidMap = this.readPidMap();
+        const cacheMap = this.readCacheParityMap();
+        const seen = new Set();
+        const addEntry = (keyOrName, val, defaults = { skipPersistence: 'never' }) => {
+            let name;
+            try {
+                name = asSessionName(keyOrName);
+            }
+            catch {
+                return;
+            }
+            if (seen.has(name))
+                return;
+            seen.add(name);
+            const cwd = isRecord(val) && typeof val['cwd'] === 'string' ? val['cwd'] : process.cwd();
+            const skipRaw = isRecord(val) ? val['skipPersistence'] : undefined;
+            const skipPersistence = skipRaw === 'session-only' || skipRaw === 'never-persist'
+                ? skipRaw
+                : defaults.skipPersistence;
+            results.push({
+                name,
+                pid: pidMap.get(name),
+                cwd,
+                cacheRegistryEntry: cacheMap.get(name),
+                skipPersistence,
+                updatedAt: new Date().toISOString(),
+            });
+        };
+        // claude-sessions.json — production shape is an ARRAY of {name, cwd, ...}.
+        // Older builds may have written a record keyed by session name; handle both.
+        const sessions = safeReadJson(LEGACY_PATHS.claudeSessions);
+        if (Array.isArray(sessions)) {
+            for (const item of sessions) {
+                if (isRecord(item) && typeof item['name'] === 'string') {
+                    addEntry(item['name'], item);
+                }
+            }
+        }
+        else if (isRecord(sessions)) {
+            for (const [key, val] of Object.entries(sessions))
+                addEntry(key, val);
+        }
+        // savvy-resume-registry.json — same dual-shape handling; supplies any
+        // sessions missing from claude-sessions.json.
+        const savvy = safeReadJson(LEGACY_PATHS.savvyResume);
+        if (Array.isArray(savvy)) {
+            for (const item of savvy) {
+                if (isRecord(item) && typeof item['name'] === 'string') {
+                    addEntry(item['name'], item);
+                }
+            }
+        }
+        else if (isRecord(savvy)) {
+            for (const [key, val] of Object.entries(savvy))
+                addEntry(key, val);
+        }
+        return results;
+    }
+    readPidMap() {
+        const map = new Map();
+        const raw = safeReadJson(LEGACY_PATHS.sessionPids);
+        if (!isRecord(raw))
+            return map;
+        for (const [key, val] of Object.entries(raw)) {
+            try {
+                const name = asSessionName(key);
+                if (typeof val === 'number')
+                    map.set(name, val);
+            }
+            catch {
+                // skip
+            }
+        }
+        return map;
+    }
+    readCacheParityMap() {
+        const map = new Map();
+        const raw = safeReadJson(LEGACY_PATHS.cacheParity);
+        if (!isRecord(raw))
+            return map;
+        for (const [key, val] of Object.entries(raw)) {
+            try {
+                const name = asSessionName(key);
+                if (typeof val === 'string')
+                    map.set(name, val);
+            }
+            catch {
+                // skip
+            }
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=migration-v0.js.map

package/dist/src/persistence/migration-v0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-v0.js","sourceRoot":"","sources":["../../../src/persistence/migration-v0.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAuC,MAAM,uBAAuB,CAAC;AAE3F,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AACvB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAE9C,MAAM,YAAY,GAAG;IACnB,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC3D,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,4BAA4B,CAAC;IAC9D,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC;IACrD,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,qCAAqC,CAAC;CAC/D,CAAC;AAEX,iFAAiF;AAEjF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,MAAM,OAAO,WAAW;IACtB;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAC;QAEpC,MAAM,QAAQ,GAAG,CACf,SAAiB,EACjB,GAAY,EACZ,WAAiE,EAAE,eAAe,EAAE,OAAO,EAAE,EACvF,EAAE;YACR,IAAI,IAAiB,CAAC;YACtB,IAAI,CAAC;gBACH,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEf,MAAM,GAAG,GACP,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAE/E,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnE,MAAM,eAAe,GACnB,OAAO,KAAK,cAAc,IAAI,OAAO,KAAK,eAAe;gBACvD,CAAC,CAAE,OAA2C;gBAC9C,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;YAE/B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBACrB,GAAG;gBACH,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBACtC,eAAe;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,2EAA2E;QAC3E,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACvD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC;QAED,sEAAsE;QACtE,8CAA8C;QAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACvD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU;QAChB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,kBAAkB;QACxB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/src/persistence/session-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SessionRegistry — typed, branded session state store.
+ *
+ * Closes the v0.6.0 namespace-bug class structurally:
+ *   - Branded SessionName ensures "openai-" prefix at the type level.
+ *   - asSessionName() throws DomainError.SessionPrefixMissing at runtime if
+ *     the prefix is missing — converting a class of silent bugs to compile errors
+ *     (branded type) + loud runtime errors (guard).
+ *
+ * skipPersistence is a typed enum, not a boolean cast (was AS4).
+ *
+ * WAL append and snapshot bodies are stubs; Phase E wires WalWriter/SnapshotWriter.
+ */
+export type SessionName = string & {
+    readonly __brand: 'SessionName';
+};
+/**
+ * Runtime guard that enforces the "openai-" prefix.
+ * Returns a branded SessionName on success.
+ * Throws SessionPrefixMissing on failure.
+ */
+export declare function asSessionName(s: string): SessionName;
+/**
+ * skipPersistence enum mirrors the boolean-cast in legacy session-manager.ts
+ * but is explicitly typed (AS4 fix).
+ *
+ * - "never"         → always persist (default)
+ * - "session-only"  → persist during session, delete on completion
+ * - "never-persist" → never write to disk (e.g. ephemeral test sessions)
+ */
+export type SkipPersistence = 'never' | 'session-only' | 'never-persist';
+export interface SessionState {
+    name: SessionName;
+    pid?: number;
+    cwd: string;
+    /** Entry in the cache-parity registry (Track B). */
+    cacheRegistryEntry?: string;
+    skipPersistence: SkipPersistence;
+    /** ISO timestamp of last state transition. */
+    updatedAt: string;
+}
+export declare class SessionRegistry {
+    private readonly map;
+    /**
+     * Upsert a session state. Triggers a WAL append (stub in Phase D).
+     */
+    set(state: SessionState): void;
+    get(name: SessionName): SessionState | undefined;
+    delete(name: SessionName): void;
+    /**
+     * Write current Map state to snapshot file (stub in Phase D).
+     * Phase E: delegates to SnapshotWriter.
+     */
+    snapshot(): Promise<void>;
+    get size(): number;
+    values(): IterableIterator<SessionState>;
+}

package/dist/src/persistence/session-registry.js

@@ -0,0 +1,58 @@
+/**
+ * SessionRegistry — typed, branded session state store.
+ *
+ * Closes the v0.6.0 namespace-bug class structurally:
+ *   - Branded SessionName ensures "openai-" prefix at the type level.
+ *   - asSessionName() throws DomainError.SessionPrefixMissing at runtime if
+ *     the prefix is missing — converting a class of silent bugs to compile errors
+ *     (branded type) + loud runtime errors (guard).
+ *
+ * skipPersistence is a typed enum, not a boolean cast (was AS4).
+ *
+ * WAL append and snapshot bodies are stubs; Phase E wires WalWriter/SnapshotWriter.
+ */
+import { SessionPrefixMissing } from '../lib/domain-error.js';
+/**
+ * Runtime guard that enforces the "openai-" prefix.
+ * Returns a branded SessionName on success.
+ * Throws SessionPrefixMissing on failure.
+ */
+export function asSessionName(s) {
+    if (!s.startsWith('openai-')) {
+        throw new SessionPrefixMissing(s);
+    }
+    return s;
+}
+// ── SessionRegistry class ─────────────────────────────────────────────────────
+export class SessionRegistry {
+    map = new Map();
+    /**
+     * Upsert a session state. Triggers a WAL append (stub in Phase D).
+     */
+    set(state) {
+        const entry = { ...state, updatedAt: new Date().toISOString() };
+        this.map.set(state.name, entry);
+        // Phase E: this.wal.append(entry);
+    }
+    get(name) {
+        return this.map.get(name);
+    }
+    delete(name) {
+        this.map.delete(name);
+        // Phase E: this.wal.append({ name, deleted: true, updatedAt: ... });
+    }
+    /**
+     * Write current Map state to snapshot file (stub in Phase D).
+     * Phase E: delegates to SnapshotWriter.
+     */
+    async snapshot() {
+        // Phase E: await this.snapshotWriter.write([...this.map.values()]);
+    }
+    get size() {
+        return this.map.size;
+    }
+    values() {
+        return this.map.values();
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/src/persistence/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../../../src/persistence/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAgB,CAAC;AAC1B,CAAC;AAyBD,iFAAiF;AAEjF,MAAM,OAAO,eAAe;IACT,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE5D;;OAEG;IACH,GAAG,CAAC,KAAmB;QACrB,MAAM,KAAK,GAAiB,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,mCAAmC;IACrC,CAAC;IAED,GAAG,CAAC,IAAiB;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,IAAiB;QACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,qEAAqE;IACvE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,oEAAoE;IACtE,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/persistence/snapshot.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SnapshotWriter — periodic full-state snapshot of the SessionRegistry.
+ *
+ * Snapshot file: ~/.openclaw/workspace/memory/cc-openclaw-session-snapshot.json
+ * Written every N minutes from phase 7 (schedule-jobs).
+ * Phase E wires SessionRegistry.snapshot() → SnapshotWriter.write().
+ * Stub body in Phase D.
+ */
+import type { SessionState } from './session-registry.js';
+export declare class SnapshotWriter {
+    private readonly path;
+    constructor(path?: string);
+    /**
+     * Write the full session state array as a JSON file.
+     * Phase E: write to a temp file then rename for atomicity.
+     */
+    write(states: SessionState[]): Promise<void>;
+}

package/dist/src/persistence/snapshot.js

@@ -0,0 +1,32 @@
+/**
+ * SnapshotWriter — periodic full-state snapshot of the SessionRegistry.
+ *
+ * Snapshot file: ~/.openclaw/workspace/memory/cc-openclaw-session-snapshot.json
+ * Written every N minutes from phase 7 (schedule-jobs).
+ * Phase E wires SessionRegistry.snapshot() → SnapshotWriter.write().
+ * Stub body in Phase D.
+ */
+import { mkdirSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+const SNAPSHOT_PATH = join(homedir(), '.openclaw', 'workspace', 'memory', 'cc-openclaw-session-snapshot.json');
+export class SnapshotWriter {
+    path;
+    constructor(path = SNAPSHOT_PATH) {
+        this.path = path;
+    }
+    /**
+     * Write the full session state array as a JSON file.
+     * Phase E: write to a temp file then rename for atomicity.
+     */
+    async write(states) {
+        try {
+            mkdirSync(dirname(this.path), { recursive: true });
+            writeFileSync(this.path, JSON.stringify(states, null, 2), 'utf8');
+        }
+        catch {
+            // Non-fatal stub; Phase E promotes to logged error.
+        }
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/src/persistence/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/persistence/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGrC,MAAM,aAAa,GAAG,IAAI,CACxB,OAAO,EAAE,EACT,WAAW,EACX,WAAW,EACX,QAAQ,EACR,mCAAmC,CACpC,CAAC;AAEF,MAAM,OAAO,cAAc;IACR,IAAI,CAAS;IAE9B,YAAY,OAAe,aAAa;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,MAAsB;QAChC,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;CACF"}

package/dist/src/persistence/wal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WalWriter — append-only JSONL writer for the session registry WAL.
+ *
+ * WAL file location: ~/.openclaw/workspace/memory/cc-openclaw-session-wal.jsonl
+ * Phase E wires this into SessionRegistry.set() / delete().
+ * Stub body in Phase D — compiles and exports the class with the correct interface.
+ */
+export declare class WalWriter {
+    private readonly path;
+    constructor(path?: string);
+    /**
+     * Append a JSON-serializable record as a single JSONL line.
+     * Creates parent directories if absent. Non-atomic in Phase D stub;
+     * Phase E adds write-then-rename for crash safety.
+     */
+    append(record: Record<string, unknown>): void;
+}

package/dist/src/persistence/wal.js

@@ -0,0 +1,32 @@
+/**
+ * WalWriter — append-only JSONL writer for the session registry WAL.
+ *
+ * WAL file location: ~/.openclaw/workspace/memory/cc-openclaw-session-wal.jsonl
+ * Phase E wires this into SessionRegistry.set() / delete().
+ * Stub body in Phase D — compiles and exports the class with the correct interface.
+ */
+import { mkdirSync, appendFileSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+const WAL_PATH = join(homedir(), '.openclaw', 'workspace', 'memory', 'cc-openclaw-session-wal.jsonl');
+export class WalWriter {
+    path;
+    constructor(path = WAL_PATH) {
+        this.path = path;
+    }
+    /**
+     * Append a JSON-serializable record as a single JSONL line.
+     * Creates parent directories if absent. Non-atomic in Phase D stub;
+     * Phase E adds write-then-rename for crash safety.
+     */
+    append(record) {
+        try {
+            mkdirSync(dirname(this.path), { recursive: true });
+            appendFileSync(this.path, JSON.stringify(record) + '\n', 'utf8');
+        }
+        catch {
+            // Non-fatal in Phase D; Phase E promotes to logged error.
+        }
+    }
+}
+//# sourceMappingURL=wal.js.map

package/dist/src/persistence/wal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal.js","sourceRoot":"","sources":["../../../src/persistence/wal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,QAAQ,GAAG,IAAI,CACnB,OAAO,EAAE,EACT,WAAW,EACX,WAAW,EACX,QAAQ,EACR,+BAA+B,CAChC,CAAC;AAEF,MAAM,OAAO,SAAS;IACH,IAAI,CAAS;IAE9B,YAAY,OAAe,QAAQ;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAA+B;QACpC,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;CACF"}

package/dist/src/session/persisted-sessions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Persisted sessions disk I/O — load + atomic-write + async-write of the
+ * `claude-sessions.json` registry.
+ *
+ * Extracted from `session-manager.ts` 2026-05-13 to reduce that file's LOC.
+ * The 3 functions form a coherent persistence layer; moving them together
+ * is bounded and behavior-preserving (existing `tests/session.test.ts`
+ * + `tests/cache-parity.test.ts` exercise the round-trip).
+ */
+import type { EngineType } from '../types.js';
+import { type Logger } from '../logger.js';
+export declare const PERSIST_DIR: string;
+export declare const PERSIST_FILE: string;
+export interface PersistedSession {
+    name: string;
+    claudeSessionId: string;
+    cwd: string;
+    model?: string;
+    engine?: EngineType;
+    originalCreated: string;
+    lastResumed: string;
+    lastActivity: number;
+}
+export declare function loadPersistedSessions(): Map<string, PersistedSession>;
+export declare function savePersistedSessions(sessions: Map<string, PersistedSession>, logger?: Logger): void;
+export declare function savePersistedSessionsAsync(sessions: Map<string, PersistedSession>, logger?: Logger): void;

package/dist/src/session/persisted-sessions.js

@@ -0,0 +1,70 @@
+/**
+ * Persisted sessions disk I/O — load + atomic-write + async-write of the
+ * `claude-sessions.json` registry.
+ *
+ * Extracted from `session-manager.ts` 2026-05-13 to reduce that file's LOC.
+ * The 3 functions form a coherent persistence layer; moving them together
+ * is bounded and behavior-preserving (existing `tests/session.test.ts`
+ * + `tests/cache-parity.test.ts` exercise the round-trip).
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createConsoleLogger } from '../logger.js';
+import { PERSIST_DISK_TTL_MS } from '../constants.js';
+export const PERSIST_DIR = path.join(os.homedir(), '.openclaw');
+export const PERSIST_FILE = path.join(PERSIST_DIR, 'claude-sessions.json');
+export function loadPersistedSessions() {
+    try {
+        if (!fs.existsSync(PERSIST_FILE))
+            return new Map();
+        const raw = fs.readFileSync(PERSIST_FILE, 'utf8');
+        const arr = JSON.parse(raw);
+        const now = Date.now();
+        // Filter out entries older than disk TTL
+        const valid = arr.filter((s) => now - s.lastActivity < PERSIST_DISK_TTL_MS);
+        return new Map(valid.map((s) => [s.name, s]));
+    }
+    catch {
+        return new Map();
+    }
+}
+// Atomic write: write to .tmp then rename to avoid corrupt reads on crash
+export function savePersistedSessions(sessions, logger) {
+    try {
+        fs.mkdirSync(PERSIST_DIR, { recursive: true });
+        const arr = Array.from(sessions.values());
+        const tmp = PERSIST_FILE + '.tmp';
+        fs.writeFileSync(tmp, JSON.stringify(arr, null, 2));
+        fs.renameSync(tmp, PERSIST_FILE);
+    }
+    catch (err) {
+        (logger || createConsoleLogger('SessionManager')).warn('Failed to persist sessions:', err.message);
+    }
+}
+// Async version for hot-path (sendMessage, TTL cleanup)
+export function savePersistedSessionsAsync(sessions, logger) {
+    const log = logger || createConsoleLogger('SessionManager');
+    const arr = Array.from(sessions.values());
+    const tmp = PERSIST_FILE + '.tmp';
+    fs.mkdir(PERSIST_DIR, { recursive: true }, (mkdirErr) => {
+        if (mkdirErr) {
+            log.error('Failed to create persist dir:', mkdirErr.message);
+            return;
+        }
+        fs.writeFile(tmp, JSON.stringify(arr, null, 2), (writeErr) => {
+            if (writeErr) {
+                log.error('Failed to write session file:', writeErr.message);
+                return;
+            }
+            fs.rename(tmp, PERSIST_FILE, (renameErr) => {
+                if (renameErr) {
+                    log.error('Failed to rename session file:', renameErr.message);
+                    // Clean up orphan tmp file
+                    fs.unlink(tmp, () => { });
+                }
+            });
+        });
+    });
+}
+//# sourceMappingURL=persisted-sessions.js.map

package/dist/src/session/persisted-sessions.js.map

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

package/dist/src/session/session-manager.d.ts

@@ -4,18 +4,9 @@
  * Replaces the Express server layer. Pure class with no HTTP dependency.
  * Can be used by Plugin tools, CLI, or any other consumer.
  */
-interface PersistedSession {
-    name: string;
-    claudeSessionId: string;
-    cwd: string;
-    model?: string;
-    engine?: EngineType;
-    originalCreated: string;
-    lastResumed: string;
-    lastActivity: number;
-}
+import { type PersistedSession } from './persisted-sessions.js';
 import { type Logger } from '../logger.js';
-import { type SessionConfig, type SessionInfo, type SendResult, type PluginConfig, type EffortLevel, type EngineType, type AgentInfo, type SkillInfo, type RuleInfo, type StreamEvent, type ISession, type CouncilConfig, type CouncilSession, type CouncilReviewResult, type CouncilAcceptResult, type CouncilRejectResult, type InboxMessage, type UltraplanResult, type UltrareviewResult } from '../types.js';
+import { type SessionConfig, type SessionInfo, type SendResult, type PluginConfig, type EffortLevel, type AgentInfo, type SkillInfo, type RuleInfo, type StreamEvent, type ISession, type CouncilConfig, type CouncilSession, type CouncilReviewResult, type CouncilAcceptResult, type CouncilRejectResult, type InboxMessage, type UltraplanResult, type UltrareviewResult } from '../types.js';
 interface SendOptions {
     effort?: EffortLevel;
     plan?: boolean;