Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

3.3 KB
Raw Blame
/**
 * SQLiteBackend - Thin wrapper around existing store.ts functions
 * Implements MemoryBackend interface by delegating to store.ts
 */

import { logger } from "../../../open-sse/utils/logger";
import type {
  MemoryBackend,
  CreateMemoryInput,
  MemoryFilter,
  SearchConfig,
  HealthCheckResult,
  Memory,
} from "./backend";
import { MemoryType } from "./types";
import { createMemory, getMemory, updateMemory, deleteMemory, listMemories } from "./store";
import { retrieveMemories } from "./retrieval";

const log = logger("SQLITE_BACKEND");

export class SQLiteBackend implements MemoryBackend {
  readonly id = "sqlite";
  readonly displayName = "SQLite";

  async initialize(): Promise<void> {
    // Tables created by migrations
    log.info("sqlite.backend.initialized");
  }

  async shutdown(): Promise<void> {
    log.info("sqlite.backend.shutdown");
  }

  // ─── CRUD ───

  async create(input: CreateMemoryInput): Promise<Memory> {
    return createMemory({
      apiKeyId: input.apiKeyId,
      sessionId: input.sessionId,
      type: input.type,
      key: input.key,
      content: input.content,
      metadata: input.metadata ?? {},
      expiresAt: input.expiresAt ?? null,
    });
  }

  async get(id: string): Promise<Memory | null> {
    return getMemory(id);
  }

  async update(id: string, updates: Partial<Omit<Memory, "id" | "createdAt">>): Promise<boolean> {
    return updateMemory(id, updates);
  }

  async delete(id: string): Promise<boolean> {
    return deleteMemory(id);
  }

  async list(
    filter: MemoryFilter
  ): Promise<{ data: Memory[]; total: number; byType: Record<string, number> }> {
    const result = await listMemories({
      apiKeyId: filter.apiKeyId,
      type: filter.type,
      sessionId: filter.sessionId,
      category: filter.category,
      query: filter.query,
      limit: filter.limit,
      offset: filter.offset,
      page:
        filter.offset && filter.limit ? Math.floor(filter.offset / filter.limit) + 1 : undefined,
    });
    return { data: result.data, total: result.total, byType: result.byType };
  }

  // ─── Search ───

  async search(config: SearchConfig): Promise<Memory[]> {
    // A count cannot be fractional or negative; zero explicitly requests no results.
    if (config.limit !== undefined && (!Number.isInteger(config.limit) || config.limit < 0)) {
      throw new RangeError("Memory search limit must be a nonnegative integer");
    }

    const memories = await retrieveMemories(config.apiKeyId, {
      query: config.query,
      // Omit an absent budget so retrieval retains its central default; preserve zero.
      ...(config.maxTokens !== undefined ? { maxTokens: config.maxTokens } : {}),
      retrievalStrategy: config.strategy ?? "hybrid",
    });
    return config.limit === undefined ? memories : memories.slice(0, config.limit);
  }

  // ─── Health ───

  async health(): Promise<HealthCheckResult> {
    const start = Date.now();
    try {
      // Try a simple query to verify DB is accessible
      const result = await getMemory("health-check-never-exists");
      return { ok: true, latencyMs: Date.now() - start };
    } catch (e) {
      return { ok: false, latencyMs: Date.now() - start, error: String(e) };
    }
  }
}

// Export singleton instance
export const sqliteBackend = new SQLiteBackend();
export default sqliteBackend;