abmind 0.0.1 → 0.1.0

package/dist/src/sleep/native.js

@@ -0,0 +1,112 @@
+/**
+ * Native sleep level — agent-produced JSON → memory DB.
+ *
+ * The kiro agent already has the conversation in its context window.
+ * It writes a JSON file mapping directly to extracted_memories fields.
+ * This module validates and commits it.
+ */
+import { readFileSync } from "node:fs";
+import { logInfo, logWarn, logError } from "../mem-logger.js";
+import { MemoryManager } from "../memory-manager.js";
+import { writeDailyFile } from "./sleep-daily-summary.js";
+const TAG = "sleep-native";
+const VALID_TYPES = new Set(["fact", "decision", "preference", "event", "lesson", "feedback", "story"]);
+/** Validate and parse the agent-produced JSON. Exported for tests. */
+export function parseNativePayload(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        return { ok: false, error: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return { ok: false, error: "Expected a JSON object with 'daily' and 'memories' fields" };
+    }
+    const obj = parsed;
+    if (typeof obj["daily"] !== "string" || !obj["daily"].trim()) {
+        return { ok: false, error: "Missing or empty 'daily' field" };
+    }
+    if (!Array.isArray(obj["memories"])) {
+        return { ok: false, error: "Missing 'memories' array" };
+    }
+    const memories = [];
+    for (let i = 0; i < obj["memories"].length; i++) {
+        const m = obj["memories"][i];
+        if (typeof m["content_en"] !== "string" || !m["content_en"].trim()) {
+            return { ok: false, error: `memories[${i}]: missing or empty 'content_en'` };
+        }
+        if (typeof m["memory_type"] !== "string" || !VALID_TYPES.has(m["memory_type"])) {
+            return { ok: false, error: `memories[${i}]: invalid memory_type '${String(m["memory_type"])}' — expected: ${[...VALID_TYPES].join(", ")}` };
+        }
+        memories.push({
+            content_en: m["content_en"].trim(),
+            content_original: typeof m["content_original"] === "string" ? m["content_original"].trim() : undefined,
+            memory_type: m["memory_type"],
+        });
+    }
+    return { ok: true, payload: { daily: obj["daily"].trim(), memories } };
+}
+/** Apply an agent-produced JSON file to the memory DB. */
+export async function runNativeApply(opts) {
+    const warnings = [];
+    let raw;
+    try {
+        raw = readFileSync(opts.filePath, "utf-8");
+    }
+    catch (err) {
+        const msg = `Failed to read ${opts.filePath}: ${err instanceof Error ? err.message : String(err)}`;
+        logError(TAG, msg);
+        return { ok: false, dailyPath: null, memoriesStored: 0, warnings, error: msg };
+    }
+    const result = parseNativePayload(raw);
+    if (!result.ok) {
+        logError(TAG, result.error);
+        return { ok: false, dailyPath: null, memoriesStored: 0, warnings, error: result.error };
+    }
+    const { payload } = result;
+    const today = new Date().toISOString().slice(0, 10);
+    if (opts.dryRun) {
+        logInfo(TAG, `[dry-run] Would store ${payload.memories.length} memories + daily for ${today}`);
+        for (const m of payload.memories)
+            logInfo(TAG, `  [${m.memory_type}] ${m.content_en.slice(0, 80)}`);
+        return { ok: true, dailyPath: null, memoriesStored: 0, warnings };
+    }
+    const dailyPath = writeDailyFile(opts.memoryConfig.memoryDir, today, payload.daily);
+    logInfo(TAG, `Daily written: ${dailyPath}`);
+    const memory = new MemoryManager(opts.memoryConfig);
+    await memory.initialize({ skipEmbeddingCheck: true });
+    let memoriesStored = 0;
+    try {
+        for (const m of payload.memories) {
+            const storeResult = await memory.editor.instantStore({
+                userId: process.env["ABMIND_USER_ID"] ?? (() => { throw new Error("ABMIND_USER_ID env var required"); })(),
+                contentEn: m.content_en,
+                contentOriginal: m.content_original ?? m.content_en,
+                memoryType: m.memory_type,
+                emotionScore: 0,
+            });
+            if (storeResult.stored) {
+                memoriesStored += storeResult.memoriesCount;
+            }
+            else {
+                const w = `Memory rejected (${m.memory_type}): ${storeResult.error ?? "unknown"}`;
+                warnings.push(w);
+                logWarn(TAG, w);
+            }
+        }
+    }
+    finally {
+        memory.close();
+    }
+    logInfo(TAG, `🏁 Native: ${memoriesStored} memories stored, ${warnings.length} warnings`);
+    // Advance extraction watermark so hook-wakeup knows extraction is done
+    try {
+        const { SleepDataAccess } = await import("../sleep-data-access.js");
+        const sleepData = new SleepDataAccess(memory.getDb());
+        sleepData.advanceExtractionWatermarks();
+    }
+    catch { /* non-fatal — watermark stays stale, next wakeup re-triggers */ }
+    return { ok: true, dailyPath, memoriesStored, warnings };
+}
+//# sourceMappingURL=native.js.map

package/dist/src/sleep/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../src/sleep/native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,GAAG,GAAG,cAAc,CAAC;AAI3B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAa,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAqBpH,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACnG,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2DAA2D,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAA4B,CAAC;QACxD,IAAI,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,kCAAkC,EAAE,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAe,CAAC,EAAE,CAAC;YAC7F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,2BAA2B,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QAC9I,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;YAClC,gBAAgB,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YACtG,WAAW,EAAE,CAAC,CAAC,aAAa,CAAe;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;AACzE,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAIpC;IACC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,kBAAkB,IAAI,CAAC,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1F,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,EAAE,yBAAyB,OAAO,CAAC,QAAQ,CAAC,MAAM,yBAAyB,KAAK,EAAE,CAAC,CAAC;QAC/F,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACpG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,EAAE,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;gBACnD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC1G,SAAS,EAAE,CAAC,CAAC,UAAU;gBACvB,eAAe,EAAE,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,UAAU;gBACnD,UAAU,EAAE,CAAC,CAAC,WAAW;gBACzB,YAAY,EAAE,CAAC;aAChB,CAAC,CAAC;YACH,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACvB,cAAc,IAAI,WAAW,CAAC,aAAa,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,WAAW,MAAM,WAAW,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;gBAClF,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,cAAc,cAAc,qBAAqB,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IAE1F,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC,CAAC;QACvD,SAAS,CAAC,2BAA2B,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC,CAAC,gEAAgE,CAAC,CAAC;IAE5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC3D,CAAC"}

package/dist/src/sleep/orchestrator.d.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * abmind sleep orchestrator — library function for overnight memory maintenance.
+ *
+ * Called via runSleepCycle({ runtime, level, ... }). Gathers system state,
+ * runs through a pipeline of prompt-driven steps (gc-noise, daily-summary,
+ * extract-from-daily, retrospective, etc.), persists audit log, returns result.
+ *
+ * Library-only — no CLI entry point here. Standalone entry lives in
+ * cli/abmind-sleep.ts.
+ *
+ * Flags (passed via RunOpts.flags):
+ *   --dry-run   Gather state + build prompts, print to stdout, skip LLM calls
+ *   --verbose   Detailed logging at each orchestration step
+ *   --force     Run housekeeping even if no messages since last sleep
+ */
+import type { SleepRuntime } from "./runtime.js";
+import { type Level } from "./levels.js";
+/** Steps whose failure blocks watermark advance. Public so tests can derive reject targets. */
+export declare const ESSENTIAL_STEPS: ReadonlySet<string>;
+/** Thrown by runSleepCycle when memory layer fails to initialize. */
+export declare class SleepInitError extends Error {
+    constructor(message: string);
+}
+/** Thrown by runSleepCycle when the wall-clock timeout expires before completion. */
+export declare class SleepTimeoutError extends Error {
+    constructor(message: string);
+}
+/** Options for runSleepCycle. All optional — defaults preserve current main() behavior. */
+export interface RunOpts {
+    flags?: RawArgs;
+    runtime: SleepRuntime;
+    /** Which prompt set to run. Defaults to SLEEP_QUALITY env or "normal". */
+    level?: Level;
+    /** Inject a deterministic clock for decision sites (today/weekday/startedAt). Observations use real Date.now. */
+    now?: () => number;
+    /** Override the wall-clock timeout in ms. Default from SLEEP_TIMEOUT_MIN env. */
+    timeoutMs?: number;
+    /** Override inter-step backoff. Default: [10,30,60]s on consecutive failures. Tests: () => 0. */
+    backoffMs?: (consecutiveFailures: number) => number;
+    /** Override memory config (temp dirs in tests). */
+    memoryConfigOverride?: Partial<import("../memory-config.js").MemoryConfig>;
+}
+/** Result of runSleepCycle — thrown errors handled separately. */
+export interface RunResult {
+    ok: boolean;
+    failCount: number;
+}
+export type RawArgs = {
+    dryRun: boolean;
+    verbose: boolean;
+    force: boolean;
+};
+export declare function parseArgs(argv: string[]): RawArgs;
+/**
+ * Run the full sleep cycle. Extracted from main() for testability (#175).
+ * - Deterministic time injection via opts.now for decision sites
+ * - Throws SleepInitError / SleepTimeoutError instead of process.exit
+ * - Returns { ok, failCount } for observable outcomes
+ *
+ * Default args preserve current main() behavior exactly.
+ */
+export declare function runSleepCycle(opts: RunOpts): Promise<RunResult>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/sleep/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/sleep/orchestrator.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,KAAK,KAAK,EAA6B,MAAM,aAAa,CAAC;AAgBpE,+FAA+F;AAC/F,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAAqE,CAAC;AAGtH,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAC5B;AAED,qFAAqF;AACrF,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAC5B;AAED,2FAA2F;AAC3F,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,iHAAiH;IACjH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,SAAS,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,OAAO,CAAC,OAAO,qBAAqB,EAAE,YAAY,CAAC,CAAC;CAC5E;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,OAAO,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAmBjD;AAmdD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAierE"}