hoomanjs 1.8.1 → 1.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Bun-powered local AI agent CLI with chat, exec, ACP, MCP, and skills support.",
   "author": {
     "name": "Vaibhav Pandey",

package/src/core/memory/stm/flat-file-storage.ts

@@ -0,0 +1,89 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import type {
+  Snapshot,
+  SnapshotLocation,
+  SnapshotManifest,
+  SnapshotStorage,
+} from "@strands-agents/sdk";
+
+/**
+ * Snapshot storage with a flat per-session layout:
+ * `<baseDir>/<sessionId>/snapshot_latest.json`.
+ */
+export class FlatFileStorage implements SnapshotStorage {
+  constructor(private readonly baseDir: string) {}
+
+  async saveSnapshot(params: {
+    location: SnapshotLocation;
+    snapshotId: string;
+    isLatest: boolean;
+    snapshot: Snapshot;
+  }): Promise<void> {
+    const path = this.snapshotPath(params.location, params.snapshotId);
+    await mkdir(join(this.sessionDir(params.location.sessionId)), {
+      recursive: true,
+    });
+    await writeFile(path, JSON.stringify(params.snapshot, null, 2), "utf8");
+  }
+
+  async loadSnapshot(params: {
+    location: SnapshotLocation;
+    snapshotId?: string;
+  }): Promise<Snapshot | null> {
+    const path = this.snapshotPath(params.location, params.snapshotId);
+    try {
+      const raw = await readFile(path, "utf8");
+      return JSON.parse(raw) as Snapshot;
+    } catch (error) {
+      if (
+        error instanceof Error &&
+        "code" in error &&
+        error.code === "ENOENT"
+      ) {
+        return null;
+      }
+      throw error;
+    }
+  }
+
+  async listSnapshotIds(): Promise<string[]> {
+    // Flat storage only tracks one mutable snapshot.
+    return [];
+  }
+
+  async deleteSession(params: { sessionId: string }): Promise<void> {
+    await rm(this.sessionDir(params.sessionId), {
+      recursive: true,
+      force: true,
+    });
+  }
+
+  async loadManifest(): Promise<SnapshotManifest> {
+    return {
+      schemaVersion: "1.0",
+      updatedAt: new Date().toISOString(),
+    };
+  }
+
+  async saveManifest(): Promise<void> {
+    // No-op: flat storage doesn't persist manifest metadata.
+  }
+
+  private sessionDir(sessionId: string): string {
+    return join(this.baseDir, sessionId);
+  }
+
+  private snapshotPath(
+    location: SnapshotLocation,
+    snapshotId?: string,
+  ): string {
+    if (snapshotId && snapshotId !== "latest") {
+      return join(
+        this.sessionDir(location.sessionId),
+        `snapshot_${snapshotId}.json`,
+      );
+    }
+    return join(this.sessionDir(location.sessionId), "snapshot_latest.json");
+  }
+}

package/src/core/memory/stm/index.ts

@@ -1,9 +1,9 @@
 import {
-  FileStorage,
   SessionManager,
   SummarizingConversationManager,
 } from "@strands-agents/sdk";
 import { sessionsPath } from "../../utils/paths";
+import { FlatFileStorage } from "./flat-file-storage";
 import { LazySessionManager } from "./lazy-session-manager";
 
 export function create(sessionId?: string) {
@@ -11,7 +11,7 @@ export function create(sessionId?: string) {
     summaryRatio: 0.5,
     preserveRecentMessages: 5,
   });
-  const storage = new FileStorage(sessionsPath());
+  const storage = new FlatFileStorage(sessionsPath());
 
   if (!sessionId) {
     return {