@alfe.ai/openclaw-memory-cloud 0.0.37 → 0.0.39

package/dist/session-backfill.js

@@ -1,192 +0,0 @@
-/**
- * Session backfill — one-time ingestion of pre-existing chat history into
- * cloud memory, run fire-and-forget at plugin startup (see index.ts).
- *
- * Reads the openclaw-chat plugin's on-disk session files directly:
- *   ~/.alfe/sessions/chat/{sessionId}.json
- * The write side is packages/openclaw-chat/src/session-store.ts — that path
- * and file shape are a read contract; keep the two in sync. The chat plugin
- * is not a package dependency because its session-store functions aren't
- * part of its public entry and the plugin isn't guaranteed to be installed
- * alongside memory. Like the session store itself, this assumes one agent
- * per machine (`alfe remove` deletes ~/.alfe, so files never outlive the
- * agent they belong to).
- *
- * No-re-sync guarantees (in concert with services/memory):
- * 1. Runs only while the server-side `sessionsBackfillSyncedAt` flag is
- *    unset; the flag survives integration uninstall/reinstall.
- * 2. Only messages with timestamp < cutoffMs are ingested — for agents that
- *    already had memory installed, everything after `bootstrapSyncedAt` was
- *    already captured live by AutoCapture.
- * 3. sessionKey = file sessionId and index = file array position, so the
- *    ingest consumer's per-session `lastProcessedIndex` high-water mark makes
- *    a crash-and-retry replay free (filtered server-side before any cost).
- *
- * Each session is sent as exactly ONE memoryIngest call (one SQS message,
- * windowed to the most recent messages that fit the caps below). Splitting a
- * session across multiple SQS messages would race the shared per-session
- * high-water mark on the standard (non-FIFO) ingest queue: a transiently
- * failed early chunk redelivered after a later chunk succeeds gets filtered
- * out and silently lost.
- */
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { homedir } from "node:os";
-const DEFAULT_SESSIONS_DIR = join(homedir(), ".alfe", "sessions", "chat");
-// Server-side zod caps on /agent/memory/ingest (services/memory
-// api-agents/ingest/post.ts) — exceeding any of these is a deterministic 400,
-// which would put the startup retry loop into a permanent failure.
-const MAX_MESSAGES_PER_SESSION = 500;
-const MAX_SESSION_KEY_CHARS = 256;
-const MAX_MESSAGE_INDEX = 1_000_000;
-const MAX_CONTENT_CHARS = 100_000;
-/** One ingest call becomes one SQS SendMessage (256KB hard limit). */
-const MAX_BATCH_BYTES = 180_000;
-export async function runSessionsBackfill(client, config, logger, opts) {
-    const sessionsDir = opts.sessionsDir ?? DEFAULT_SESSIONS_DIR;
-    let fileNames;
-    try {
-        fileNames = (await readdir(sessionsDir)).filter((name) => name.endsWith(".json"));
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            // No sessions directory — nothing to backfill, ever.
-            logger.debug("sessions backfill: no sessions directory, marking complete");
-            try {
-                await client.memoryBootstrapStatusMark("sessions");
-            }
-            catch { /* retry next start */ }
-        }
-        else {
-            // Transient (EACCES/EMFILE/...) — don't forfeit the backfill.
-            logger.warn("sessions backfill: sessions directory unreadable; will retry on next startup", { err: String(err) });
-        }
-        return;
-    }
-    const sessions = [];
-    for (const name of fileNames) {
-        const parsed = await parseSessionFile(join(sessionsDir, name), config.captureMaxChars, opts.cutoffMs);
-        if (parsed)
-            sessions.push(parsed);
-    }
-    // Most recent non-empty sessions first, capped. Filter BEFORE capping:
-    // on a retrofit agent the newest sessions are often entirely post-install
-    // (emptied by the cutoff) and must not occupy the cap slots.
-    const eligible = sessions
-        .filter((s) => s.messages.length > 0)
-        .sort((a, b) => b.lastMessageMs - a.lastMessageMs)
-        .slice(0, config.backfillMaxSessions);
-    if (eligible.length === 0) {
-        logger.debug("sessions backfill: no eligible sessions, marking complete");
-        try {
-            await client.memoryBootstrapStatusMark("sessions");
-        }
-        catch { /* retry next start */ }
-        return;
-    }
-    logger.info("sessions backfill: ingesting sessions", {
-        sessionCount: eligible.length,
-        messageCount: eligible.reduce((n, s) => n + s.messages.length, 0),
-    });
-    for (const session of eligible) {
-        const metadata = {
-            ...(session.channel ? { channelId: session.channel } : {}),
-            ...(session.userId ? { userId: session.userId } : {}),
-        };
-        try {
-            await client.memoryIngest(session.sessionId, session.messages, metadata);
-        }
-        catch (err) {
-            // Abort without marking — next startup replays, and the server-side
-            // lastProcessedIndex filter discards already-processed sessions free.
-            logger.warn("sessions backfill: ingest failed; will retry on next startup", {
-                sessionId: session.sessionId,
-                err: String(err),
-            });
-            return;
-        }
-    }
-    try {
-        await client.memoryBootstrapStatusMark("sessions");
-        logger.info("sessions backfill: complete", { sessionCount: eligible.length });
-    }
-    catch (err) {
-        logger.warn("sessions backfill: mark failed; will retry on next startup", { err: String(err) });
-    }
-}
-/**
- * Tolerant parse of a single session file. Returns null for corrupt or
- * shape-mismatched files (skipped, never fatal). Message `index` is the
- * original array position in the file — stable because the store is
- * append-only — so retries resume idempotently server-side.
- */
-async function parseSessionFile(filePath, captureMaxChars, cutoffMs) {
-    let raw;
-    try {
-        raw = JSON.parse(await readFile(filePath, "utf8"));
-    }
-    catch {
-        return null;
-    }
-    if (typeof raw !== "object" || raw === null)
-        return null;
-    const data = raw;
-    if (typeof data.sessionId !== "string" || data.sessionId.length === 0)
-        return null;
-    if (data.sessionId.length > MAX_SESSION_KEY_CHARS)
-        return null;
-    if (!Array.isArray(data.messages))
-        return null;
-    const maxContentChars = Math.min(captureMaxChars, MAX_CONTENT_CHARS);
-    let lastMessageMs = 0;
-    const filtered = [];
-    for (const [index, entry] of data.messages.entries()) {
-        if (index > MAX_MESSAGE_INDEX)
-            break;
-        if (typeof entry !== "object" || entry === null)
-            continue;
-        const msg = entry;
-        if (msg.role !== "user" && msg.role !== "assistant")
-            continue;
-        if (typeof msg.content !== "string" || msg.content.trim().length === 0)
-            continue;
-        if (typeof msg.timestamp !== "number")
-            continue;
-        lastMessageMs = Math.max(lastMessageMs, msg.timestamp);
-        if (msg.timestamp >= cutoffMs)
-            continue;
-        filtered.push({
-            role: msg.role,
-            content: msg.content.length > maxContentChars ? msg.content.slice(0, maxContentChars) : msg.content,
-            index,
-            timestamp: new Date(msg.timestamp).toISOString(),
-        });
-    }
-    return {
-        sessionId: data.sessionId,
-        channel: typeof data.channel === "string" ? data.channel : undefined,
-        userId: typeof data.userId === "string" ? data.userId : undefined,
-        messages: recentWindow(filtered),
-        lastMessageMs,
-    };
-}
-/**
- * The most recent contiguous run of messages fitting both ingest caps
- * (message count and serialized bytes). Walks backwards from the newest
- * message and stops at the first one that would overflow the byte budget.
- */
-function recentWindow(messages) {
-    const window = [];
-    let bytes = 0;
-    for (let i = messages.length - 1; i >= 0; i--) {
-        if (window.length >= MAX_MESSAGES_PER_SESSION)
-            break;
-        const msgBytes = Buffer.byteLength(JSON.stringify(messages[i])) + 1;
-        if (bytes + msgBytes > MAX_BATCH_BYTES)
-            break;
-        window.unshift(messages[i]);
-        bytes += msgBytes;
-    }
-    return window;
-}
-//# sourceMappingURL=session-backfill.js.map

package/dist/session-backfill.js.map

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

package/dist/types.d.ts

@@ -1,113 +0,0 @@
-export interface MemoryCloudConfig {
-    autoCapture: boolean;
-    autoRecall: boolean;
-    captureMaxChars: number;
-    idleFlushSeconds: number;
-    backfillSessions: boolean;
-    backfillMaxSessions: number;
-}
-export interface MemoryMessage {
-    role: string;
-    content: string;
-    index: number;
-    timestamp?: string;
-}
-export interface SessionMetadata {
-    channelId?: string;
-    userId?: string;
-    userName?: string;
-}
-export interface MemorySearchResult {
-    facts: {
-        subject: string;
-        predicate: string;
-        object: string;
-        since: string;
-        confidence: number;
-    }[];
-    memories: {
-        id: string;
-        text: string;
-        topic: string;
-        subtopic: string;
-        tag: string;
-        importance: number;
-        timestamp: number;
-        score: number;
-    }[];
-}
-export interface MemoryContext {
-    tier: number;
-    facts: {
-        subject: string;
-        predicate: string;
-        object: string;
-        since: string;
-    }[];
-    memories: {
-        text: string;
-        topic: string;
-        subtopic: string;
-        score: number;
-    }[];
-    tokenEstimate: number;
-    formatted: string;
-}
-/**
- * Interface for memory API calls. Satisfied by AgentApiClient so the plugin
- * doesn't need a hard dependency on the agent-api-client package.
- */
-export interface MemoryApi {
-    memorySearch(query: string, opts?: {
-        limit?: number;
-        topic?: string;
-        subtopic?: string;
-        tag?: string;
-        includeKnowledge?: boolean;
-    }): Promise<MemorySearchResult>;
-    memoryStore(text: string, opts?: {
-        topic?: string;
-        subtopic?: string;
-        tag?: string;
-        importance?: number;
-    }): Promise<{
-        memoryId: string;
-    }>;
-    memoryIngest(sessionKey: string, messages: MemoryMessage[], metadata?: SessionMetadata, ingestEpoch?: number): Promise<{
-        queued: boolean;
-        messageCount: number;
-    }>;
-    memoryLoadContext(tier?: number, topicHint?: string): Promise<{
-        formatted: string;
-        [key: string]: unknown;
-    }>;
-    memoryLookupEntity(subject: string): Promise<{
-        subject: string;
-        triples: {
-            tripleId: string;
-            predicate: string;
-            object: string;
-            validFrom: string;
-            validTo?: string;
-            confidence: number;
-        }[];
-    }>;
-    memoryNavigate(): Promise<{
-        topics: {
-            name: string;
-            tripleCount: number;
-            subtopics: string[];
-        }[];
-        cursor: string | null;
-    }>;
-    memoryDelete(memoryId: string): Promise<{
-        deleted: boolean;
-    }>;
-    memoryStats(): Promise<{
-        vectorCount: number;
-        tripleCount: number;
-        storageEstimateBytes: number;
-        lastIngestionAt?: string;
-    }>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/src/__tests__/auto-capture.test.ts

@@ -1,115 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { AutoCapture } from "../auto-capture.js";
-import type { MemoryApi, MemoryCloudConfig, MemoryMessage, SessionMetadata } from "../types.js";
-
-/**
- * Restart-drop regression (Defect 1).
- *
- * `AutoCapture.messageIndex` is process-local and resets to 0 on every daemon
- * restart, but the memory service's per-session `lastProcessedIndex` high-water
- * mark survives. Before the fix, a `index > lastProcessedIndex` filter dropped
- * every post-restart capture (`storedCount: 0`) until the local counter climbed
- * back past the old max. The fix: each flush carries a per-boot `ingestEpoch`,
- * and the server resets the mark when it sees a strictly-newer epoch.
- *
- * This drives two AutoCapture instances (a restart == a fresh instance with the
- * counter back at 0) against a fake server that applies the real epoch rule,
- * and asserts the post-restart captures survive.
- */
-
-const config: MemoryCloudConfig = {
-  autoCapture: true,
-  autoRecall: true,
-  captureMaxChars: 500,
-  // Huge idle window so the debounce timer never fires; we flush explicitly.
-  idleFlushSeconds: 3600,
-  backfillSessions: false,
-  backfillMaxSessions: 0,
-};
-
-const logger = { debug: vi.fn(), warn: vi.fn() };
-
-/** Minimal in-memory replica of the server's per-session epoch-fenced watermark. */
-function createFakeServer() {
-  const marks = new Map<string, { lastIndex: number; epoch?: number }>();
-  const stored = new Map<string, MemoryMessage[]>();
-
-  const client: Pick<MemoryApi, "memoryIngest"> = {
-    async memoryIngest(sessionKey: string, messages: MemoryMessage[], _metadata?: SessionMetadata, ingestEpoch?: number) {
-      const prev = marks.get(sessionKey);
-      const storedEpoch = prev?.epoch;
-      const storedIndex = prev?.lastIndex ?? -1;
-
-      let lastIndex = storedIndex;
-      let nextEpoch = storedEpoch;
-      if (ingestEpoch !== undefined) {
-        if (storedEpoch === undefined || ingestEpoch > storedEpoch) {
-          lastIndex = -1; // new/newer boot → reset
-          nextEpoch = ingestEpoch;
-        } else if (ingestEpoch < storedEpoch) {
-          return { queued: true, messageCount: 0 }; // stale boot → skip
-        }
-      }
-
-      const survivors = messages.filter((m) => m.index > lastIndex);
-      if (survivors.length > 0) {
-        stored.set(sessionKey, [...(stored.get(sessionKey) ?? []), ...survivors]);
-        marks.set(sessionKey, { lastIndex: Math.max(...survivors.map((m) => m.index)), epoch: nextEpoch });
-      }
-      return { queued: true, messageCount: survivors.length };
-    },
-  };
-
-  return { client: client as MemoryApi, storedFor: (k: string) => stored.get(k) ?? [] };
-}
-
-const SESSION = "conv:web:idn_1";
-
-describe("AutoCapture restart-drop fix", () => {
-  it("does NOT drop post-restart captures against a surviving high-water mark", async () => {
-    const server = createFakeServer();
-
-    // ── Boot 1: capture three messages (indices 0,1,2), advancing the mark ──
-    const boot1 = new AutoCapture(server.client, config, logger, 1000);
-    boot1.setSession(SESSION);
-    boot1.trackMessage("user", "hello");
-    boot1.trackMessage("assistant", "hi there");
-    boot1.trackMessage("user", "how are you");
-    await boot1.flush();
-    boot1.destroy();
-    expect(server.storedFor(SESSION)).toHaveLength(3);
-
-    // ── Restart: a fresh instance, message counter back at 0, higher epoch ──
-    const boot2 = new AutoCapture(server.client, config, logger, 2000);
-    boot2.setSession(SESSION);
-    boot2.trackMessage("user", "still here?");
-    boot2.trackMessage("assistant", "yep");
-    await boot2.flush();
-    boot2.destroy();
-
-    // The two post-restart messages must NOT be silently dropped.
-    expect(server.storedFor(SESSION)).toHaveLength(5);
-  });
-
-  it("REGRESSION GUARD: without a newer epoch the same messages WOULD be dropped", async () => {
-    const server = createFakeServer();
-
-    const boot1 = new AutoCapture(server.client, config, logger, 1000);
-    boot1.setSession(SESSION);
-    boot1.trackMessage("user", "hello");
-    boot1.trackMessage("assistant", "hi there");
-    boot1.trackMessage("user", "how are you");
-    await boot1.flush();
-
-    // Simulate the OLD behaviour: a restart that reuses the same epoch (no
-    // reset signal). The post-restart index-0.. messages fall under the stale
-    // watermark and are dropped — exactly the bug the epoch fixes.
-    const boot2 = new AutoCapture(server.client, config, logger, 1000);
-    boot2.setSession(SESSION);
-    boot2.trackMessage("user", "still here?");
-    boot2.trackMessage("assistant", "yep");
-    await boot2.flush();
-
-    expect(server.storedFor(SESSION)).toHaveLength(3);
-  });
-});

package/src/__tests__/ingest-epoch.test.ts

@@ -1,67 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync, readFileSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { resolveIngestEpoch } from "../ingest-epoch.js";
-
-// The client-side guard that keeps the server's stale-boot branch a rare edge
-// rather than a whole-process outage: the per-boot epoch must be STRICTLY
-// monotonic across restarts even if the wall clock steps backward. Otherwise a
-// backward clock makes every flush look older than the stored epoch and the
-// server silently acks (drops) all of them for the life of the process.
-
-describe("resolveIngestEpoch", () => {
-  let dir: string;
-  let epochFile: string;
-
-  beforeEach(() => {
-    dir = mkdtempSync(join(tmpdir(), "ingest-epoch-"));
-    epochFile = join(dir, "memory", "ingest-epoch.json");
-  });
-  afterEach(() => rmSync(dir, { recursive: true, force: true }));
-
-  it("first boot with no state file returns now and persists it", () => {
-    const epoch = resolveIngestEpoch({ epochFile, now: 1000 });
-    expect(epoch).toBe(1000);
-    expect(JSON.parse(readFileSync(epochFile, "utf8"))).toEqual({ epoch: 1000 });
-  });
-
-  it("BACKWARD CLOCK across a restart still yields a strictly-greater epoch", () => {
-    // Boot 1 at a high wall-clock time.
-    const first = resolveIngestEpoch({ epochFile, now: 5_000_000 });
-    expect(first).toBe(5_000_000);
-
-    // Restart with the clock stepped BACKWARD (NTP correction / pre-sync boot).
-    const second = resolveIngestEpoch({ epochFile, now: 4_000_000 });
-
-    // Must be strictly greater than the stored epoch, NOT the (smaller) now —
-    // so the server sees a newer boot and resets the watermark instead of
-    // classifying every flush as stale and dropping it.
-    expect(second).toBe(5_000_001);
-    expect(second).toBeGreaterThan(first);
-    expect(JSON.parse(readFileSync(epochFile, "utf8"))).toEqual({ epoch: 5_000_001 });
-  });
-
-  it("forward clock uses the real time (monotonicity doesn't peg it low)", () => {
-    resolveIngestEpoch({ epochFile, now: 1000 });
-    const next = resolveIngestEpoch({ epochFile, now: 9000 });
-    expect(next).toBe(9000);
-  });
-
-  it("repeated restarts stay strictly increasing even under a stuck/rewound clock", () => {
-    let last = 0;
-    for (const now of [1000, 1000, 999, 500, 1000]) {
-      const epoch = resolveIngestEpoch({ epochFile, now });
-      expect(epoch).toBeGreaterThan(last);
-      last = epoch;
-    }
-  });
-
-  it("a corrupt state file is treated as no prior epoch (falls back to now)", () => {
-    resolveIngestEpoch({ epochFile, now: 1000 });
-    // Clobber with garbage.
-    writeFileSync(epochFile, "{ not json");
-    const epoch = resolveIngestEpoch({ epochFile, now: 7000 });
-    expect(epoch).toBe(7000);
-  });
-});