Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

2.8 KB
Raw Blame
import { homedir } from "node:os";
import { join, resolve, sep } from "node:path";
import { existsSync } from "node:fs";
import { mkdir, writeFile, unlink, utimes, stat } from "node:fs/promises";
import { createHash } from "node:crypto";

export const IMAGES_DIR = join(homedir(), ".agentmemory", "images");

const DEFAULT_MAX_BYTES = 500 * 1024 * 1024;

export function getMaxBytes(): number {
  return Number(process.env.AGENTMEMORY_IMAGE_STORE_MAX_BYTES) || DEFAULT_MAX_BYTES;
}

export function isManagedImagePath(filePath: string): boolean {
  const resolved = resolve(filePath);
  const normalizedImagesDir = resolve(IMAGES_DIR);
  return resolved.startsWith(normalizedImagesDir + sep) || resolved === normalizedImagesDir;
}

function contentHash(data: string): string {
  return createHash("sha256").update(data).digest("hex");
}

export async function saveImageToDisk(base64Data: string): Promise<{ filePath: string; bytesWritten: number }> {
  if (!base64Data) return { filePath: "", bytesWritten: 0 };

  if (!existsSync(IMAGES_DIR)) {
    await mkdir(IMAGES_DIR, { recursive: true });
  }

  let cleanBase64 = base64Data;
  let ext = "png";

  if (base64Data.startsWith("data:image/")) {
     const commaIdx = base64Data.indexOf(",");
     if (commaIdx !== -1) {
       const meta = base64Data.substring(0, commaIdx);
       if (meta.includes("jpeg") || meta.includes("jpg")) ext = "jpg";
       else if (meta.includes("webp")) ext = "webp";
       else if (meta.includes("gif")) ext = "gif";
       cleanBase64 = base64Data.substring(commaIdx + 1);
     }
  } else if (base64Data.startsWith("/9j/")) {
     ext = "jpg";
  }

  const hash = contentHash(cleanBase64);
  const filePath = join(IMAGES_DIR, `${hash}.${ext}`);

  if (existsSync(filePath)) {
    return { filePath, bytesWritten: 0 };
  }

  const buffer = Buffer.from(cleanBase64, "base64");
  await writeFile(filePath, buffer);

  const s = await stat(filePath);

  return { filePath, bytesWritten: s.size };
}

export async function deleteImage(filePath: string | undefined): Promise<{ deletedBytes: number }> {
  if (!filePath) return { deletedBytes: 0 };
  if (!isManagedImagePath(filePath)) return { deletedBytes: 0 };
  try {
    if (existsSync(filePath)) {
      const s = await stat(filePath);
      const size = s.size;
      await unlink(filePath);
      return { deletedBytes: size };
    }
  } catch (err) {
    console.error("[agentmemory] Failed to delete image context:", err);
  }
  return { deletedBytes: 0 };
}

/** Touch an image file to update its mtime (marking it as recently used for LRU eviction) */
export async function touchImage(filePath: string): Promise<void> {
  if (!filePath || !isManagedImagePath(filePath)) return;
  try {
    if (existsSync(filePath)) {
      const now = new Date();
      await utimes(filePath, now, now);
    }
  } catch (err) {
    // Ignore touch errors silently
  }
}