@bip-krishna/agentmind 0.1.0

package/packages/embeddings/src/openai.ts

@@ -0,0 +1,50 @@
+import type { EmbeddingProvider } from "./provider.js";
+
+export interface OpenAIEmbeddingOptions {
+  apiKey: string;
+  model?: string; // default text-embedding-3-small
+  dimensions?: number;
+  baseURL?: string;
+}
+
+export class OpenAIEmbeddingProvider implements EmbeddingProvider {
+  readonly model: string;
+  readonly dimensions: number;
+  private apiKey: string;
+  private baseURL: string;
+
+  constructor(opts: OpenAIEmbeddingOptions) {
+    this.apiKey = opts.apiKey;
+    this.model = opts.model ?? "text-embedding-3-small";
+    this.dimensions = opts.dimensions ?? 1536;
+    this.baseURL = opts.baseURL ?? "https://api.openai.com/v1";
+  }
+
+  async embed(text: string): Promise<number[]> {
+    const res = await fetch(`${this.baseURL}/embeddings`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify({ model: this.model, input: text }),
+    });
+    if (!res.ok) throw new Error(`OpenAI embed failed: ${res.status} ${await res.text()}`);
+    const data = (await res.json()) as any;
+    return data.data[0].embedding as number[];
+  }
+
+  async embedBatch(texts: string[]): Promise<number[][]> {
+    const res = await fetch(`${this.baseURL}/embeddings`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify({ model: this.model, input: texts }),
+    });
+    if (!res.ok) throw new Error(`OpenAI embedBatch failed: ${res.status} ${await res.text()}`);
+    const data = (await res.json()) as any;
+    return data.data.sort((a: any, b: any) => a.index - b.index).map((d: any) => d.embedding);
+  }
+}

package/packages/embeddings/src/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CASjE"}

package/packages/embeddings/src/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["provider.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/packages/embeddings/src/provider.ts

@@ -0,0 +1,17 @@
+export interface EmbeddingProvider {
+  readonly model: string;
+  readonly dimensions: number;
+  embed(text: string): Promise<number[]>;
+  embedBatch(texts: string[]): Promise<number[][]>;
+}
+
+export function cosineSimilarity(a: number[], b: number[]): number {
+  let dot = 0, na = 0, nb = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
+  }
+  if (na === 0 || nb === 0) return 0;
+  return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}

package/packages/embeddings/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": false
+  }
+}

package/packages/integrations/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@agentmind/integrations",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts"
+}

package/packages/integrations/src/anthropic.ts

@@ -0,0 +1,34 @@
+import type { MemoryEngine } from "../../core/src/memory.js";
+import type { ChatMessage } from "./openai.js";
+
+export interface AnthropicWithMemoryOptions {
+  memory: MemoryEngine;
+  messages: ChatMessage[];
+  callLLM: (messages: ChatMessage[]) => Promise<string>;
+  extract?: boolean;
+}
+
+export async function withAnthropicMemory(opts: AnthropicWithMemoryOptions) {
+  const lastUser = [...opts.messages].reverse().find((m) => m.role === "user");
+  const query = lastUser?.content ?? opts.messages.map((m) => m.content).join("\n").slice(-500);
+  const ctx = await opts.memory.context({ query, maxTokens: 4000 });
+  const system = ctx.text ? ctx.text : undefined;
+  // Anthropic separates system; we prepend as system if provided
+  const augmented = system ? [{ role: "system" as const, content: system }, ...opts.messages.filter((m) => m.role !== "system")] : opts.messages;
+  const response = await opts.callLLM(augmented);
+  let memories: any[] = [];
+  if (opts.extract !== false) {
+    const ingested = await opts.memory.ingest({ role: "assistant", content: response });
+    if (ingested.extracted) memories = ingested.extracted;
+  }
+  return { response, context: ctx.text, memories };
+}
+
+export function createAnthropicCaller(anthropic: any, model: string) {
+  return async (messages: ChatMessage[]) => {
+    const system = messages.find((m) => m.role === "system")?.content;
+    const rest = messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+    const res = await anthropic.messages.create({ model, max_tokens: 1024, system, messages: rest });
+    return res.content[0].text as string;
+  };
+}

package/packages/integrations/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./openai.js";
+export * from "./anthropic.js";
+export * from "./vercel.js";

package/packages/integrations/src/openai.ts

@@ -0,0 +1,52 @@
+import type { MemoryEngine } from "../../core/src/memory.js";
+
+/**
+ * OpenAI integration — automates retrieve -> context -> LLM -> extract -> store
+ * Usage:
+ *   import { withMemory } from "@agentmind/integrations/openai";
+ *   const res = await withMemory({ memory, messages, openai, model: "gpt-4o" });
+ */
+
+export interface ChatMessage {
+  role: "system" | "user" | "assistant" | "tool";
+  content: string;
+}
+
+export interface WithMemoryOptions {
+  memory: MemoryEngine;
+  messages: ChatMessage[];
+  // Provide a function that calls OpenAI — keeps this package dependency-free
+  callLLM: (messages: ChatMessage[]) => Promise<string>;
+  // Optional: extract memories from assistant response
+  extract?: boolean;
+}
+
+export async function withMemory(opts: WithMemoryOptions): Promise<{ response: string; context: string; memories: any[] }> {
+  const lastUser = [...opts.messages].reverse().find((m) => m.role === "user");
+  const query = lastUser?.content ?? opts.messages.map((m) => m.content).join("\n").slice(-500);
+
+  const ctx = await opts.memory.context({ query, maxTokens: 4000 });
+  const augmented: ChatMessage[] = ctx.text
+    ? [{ role: "system", content: ctx.text }, ...opts.messages]
+    : [...opts.messages];
+
+  const response = await opts.callLLM(augmented);
+
+  let memories: any[] = [];
+  if (opts.extract !== false) {
+    // Use memory's extractor if available via ingest
+    const ingested = await opts.memory.ingest({ role: "assistant", content: response });
+    // If autoExtract is enabled, ingest already extracted; otherwise manually remember key facts via heuristic
+    if (ingested.extracted) memories = ingested.extracted;
+  }
+
+  return { response, context: ctx.text, memories };
+}
+
+/** Helper for OpenAI SDK users */
+export function createOpenAICaller(openai: any, model: string, opts?: { temperature?: number }) {
+  return async (messages: ChatMessage[]) => {
+    const res = await openai.chat.completions.create({ model, messages, temperature: opts?.temperature ?? 0.7 });
+    return res.choices[0].message.content as string;
+  };
+}

package/packages/integrations/src/vercel.ts

@@ -0,0 +1,26 @@
+import type { MemoryEngine } from "../../core/src/memory.js";
+
+/**
+ * Vercel AI SDK integration
+ * Example:
+ *   import { withMemoryAISDK } from "@agentmind/integrations/vercel";
+ *   const { text } = await withMemoryAISDK({ memory, prompt, generateText });
+ */
+export async function withMemoryAISDK(opts: {
+  memory: MemoryEngine;
+  prompt: string;
+  generateText: (prompt: string, system?: string) => Promise<string>;
+}): Promise<{ text: string; context: string }> {
+  const ctx = await opts.memory.context({ query: opts.prompt, maxTokens: 4000 });
+  const text = await opts.generateText(opts.prompt, ctx.text || undefined);
+  await opts.memory.ingest({ role: "assistant", content: text });
+  return { text, context: ctx.text };
+}
+
+// LangChain adapter stub
+export async function withLangChainMemory(opts: { memory: MemoryEngine; input: string; callChain: (input: string, context: string) => Promise<string> }) {
+  const ctx = await opts.memory.context({ query: opts.input });
+  const output = await opts.callChain(opts.input, ctx.text);
+  await opts.memory.ingest({ role: "assistant", content: output });
+  return { output, context: ctx.text };
+}

package/packages/retrieval/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@agentmind/retrieval",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": { "build": "tsc -b" }
+}

package/packages/retrieval/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./ranker.js";
+export * from "./token.js";

package/packages/retrieval/src/ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["ranker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAqBD,qBAAa,YAAY;IACvB,OAAO,EAAE,aAAa,CAAC;gBAEX,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAS5C,IAAI,CACF,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EAC7C,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,UAAU,EAAE;CAwBhB"}

package/packages/retrieval/src/ranker.js.map

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

package/packages/retrieval/src/ranker.ts

@@ -0,0 +1,77 @@
+import { cosineSimilarity } from "../../embeddings/src/provider.js";
+import type { Memory } from "../../core/src/types.js";
+
+export interface RankerWeights {
+  semantic: number; // 0.6
+  keyword: number; // 0.2
+  importance: number; // 0.1
+  recency: number; // 0.1
+}
+
+export interface RankedItem {
+  memory: Memory;
+  score: number;
+  semanticScore: number;
+  keywordScore: number;
+}
+
+function keywordScore(query: string, content: string): number {
+  const qTokens = new Set(query.toLowerCase().split(/\W+/).filter(Boolean));
+  const cTokens = content.toLowerCase().split(/\W+/).filter(Boolean);
+  if (qTokens.size === 0) return 0;
+  let hits = 0;
+  for (const t of cTokens) if (qTokens.has(t)) hits++;
+  // exact phrase boost
+  const phrase = query.toLowerCase().trim();
+  const phraseBoost = content.toLowerCase().includes(phrase) ? 0.3 : 0;
+  return Math.min(1, hits / qTokens.size + phraseBoost);
+}
+
+function recencyScore(mem: Memory): number {
+  const ageMs = Date.now() - new Date(mem.updatedAt).getTime();
+  const days = ageMs / (1000 * 60 * 60 * 24);
+  // exponential decay, half-life ~30 days
+  return Math.exp(-days / 30);
+}
+
+export class HybridRanker {
+  weights: RankerWeights;
+
+  constructor(weights?: Partial<RankerWeights>) {
+    this.weights = {
+      semantic: weights?.semantic ?? 0.6,
+      keyword: weights?.keyword ?? 0.2,
+      importance: weights?.importance ?? 0.1,
+      recency: weights?.recency ?? 0.1,
+    };
+  }
+
+  rank(
+    memories: Array<Memory & { _vec?: number[] }>,
+    query: string,
+    queryVec?: number[]
+  ): RankedItem[] {
+    const scored = memories.map((m) => {
+      const semantic = queryVec && m._vec ? (cosineSimilarity(queryVec, m._vec) + 1) / 2 : 0; // normalize -1..1 -> 0..1
+      const kw = keywordScore(query, m.content);
+      const imp = m.importance;
+      const rec = recencyScore(m);
+      const finalScore =
+        semantic * this.weights.semantic +
+        kw * this.weights.keyword +
+        imp * this.weights.importance +
+        rec * this.weights.recency;
+
+      return {
+        memory: m,
+        score: finalScore,
+        semanticScore: semantic,
+        keywordScore: kw,
+      } as RankedItem;
+    });
+
+    // If no query vectors, keyword+importance+recency still ranks
+    scored.sort((a, b) => b.score - a.score);
+    return scored;
+  }
+}

package/packages/retrieval/src/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["token.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/packages/retrieval/src/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["token.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/packages/retrieval/src/token.ts

@@ -0,0 +1,5 @@
+/** Very rough token estimator: ~4 chars per token */
+export function estimateTokens(text: string): number {
+  if (!text) return 0;
+  return Math.ceil(text.length / 4);
+}

package/packages/retrieval/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": false
+  }
+}

package/packages/storage/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@agentmind/storage",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": { "build": "tsc -b" },
+  "dependencies": {
+    "zod": "^3.23.0"
+  }
+}

package/packages/storage/src/config.ts

@@ -0,0 +1,44 @@
+import { SqliteMemoryStore } from "./sqlite-store.js";
+import { PostgresMemoryStore } from "./postgres-store.js";
+import type { MemoryStore } from "../../core/src/memory-store.js";
+
+export interface StorageConfig {
+  provider: "sqlite" | "postgres" | "memory";
+  sqlite?: { path?: string };
+  postgres?: { connectionString: string };
+}
+
+export function resolveStorageConfig(): StorageConfig {
+  const pgUrl = process.env.DATABASE_URL ?? process.env.POSTGRES_URL;
+  if (pgUrl) return { provider: "postgres", postgres: { connectionString: pgUrl } };
+  const sqlitePath = process.env.AGENTMIND_DB ?? process.env.CTX_MEMORY_DB ?? "./.agentmind/memory.db";
+  if (sqlitePath === ":memory:") return { provider: "memory" };
+  return { provider: "sqlite", sqlite: { path: sqlitePath } };
+}
+
+export function createStoreFromConfig(config: StorageConfig): MemoryStore {
+  switch (config.provider) {
+    case "postgres":
+      return new PostgresMemoryStore(config.postgres!.connectionString);
+    case "sqlite":
+      return new SqliteMemoryStore({ path: config.sqlite?.path });
+    case "memory":
+      return new SqliteMemoryStore({ path: ":memory:" });
+    default:
+      return new SqliteMemoryStore({ path: "./.agentmind/memory.db" });
+  }
+}
+
+export function autoDetectProject(): string {
+  if (process.env.AGENTMIND_PROJECT ?? process.env.CTX_MEMORY_PROJECT) return (process.env.AGENTMIND_PROJECT ?? process.env.CTX_MEMORY_PROJECT) as string;
+  try {
+    const pkg = JSON.parse(require("node:fs").readFileSync("package.json", "utf-8"));
+    if (pkg.name) return String(pkg.name).replace(/^@.*\//, "");
+  } catch {}
+  try {
+    const cwd = process.cwd().split("/").pop() ?? "default";
+    return cwd;
+  } catch {
+    return "default";
+  }
+}

package/packages/storage/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./sqlite-store.js";
+export * from "./memory-store.js";
+export * from "./postgres-store.js";

package/packages/storage/src/memory-store.ts

@@ -0,0 +1,100 @@
+import type { MemoryStore } from "../../core/src/memory-store.js";
+import type { Memory, Project, Source, SearchQuery, SearchResult, RetrievalEvent } from "../../core/src/types.js";
+
+/**
+ * Pure in-memory store — zero dependencies, ideal for tests.
+ */
+export class InMemoryStore implements MemoryStore {
+  private projects = new Map<string, Project>();
+  private projectsByName = new Map<string, Project>();
+  private sources = new Map<string, Source>();
+  private memories = new Map<string, Memory>();
+  private embeddings = new Map<string, { vector: number[]; model: string }>();
+  private retrievals: RetrievalEvent[] = [];
+
+  async createProject(project: Project): Promise<Project> {
+    this.projects.set(project.id, project);
+    this.projectsByName.set(project.name, project);
+    return project;
+  }
+  async getProject(id: string): Promise<Project | null> {
+    return this.projects.get(id) ?? null;
+  }
+  async getProjectByName(name: string): Promise<Project | null> {
+    return this.projectsByName.get(name) ?? null;
+  }
+  async listProjects(): Promise<Project[]> {
+    return [...this.projects.values()];
+  }
+  async deleteProject(projectId: string): Promise<void> {
+    const p = this.projects.get(projectId);
+    if (p) this.projectsByName.delete(p.name);
+    this.projects.delete(projectId);
+    for (const [id, m] of this.memories) if (m.projectId === projectId) this.memories.delete(id);
+  }
+  async createSource(source: Source): Promise<Source> {
+    this.sources.set(source.id, source);
+    return source;
+  }
+  async getSource(id: string): Promise<Source | null> {
+    return this.sources.get(id) ?? null;
+  }
+  async createMemory(memory: Memory): Promise<void> {
+    this.memories.set(memory.id, memory);
+  }
+  async getMemory(id: string): Promise<Memory | null> {
+    return this.memories.get(id) ?? null;
+  }
+  async updateMemory(id: string, update: Partial<Memory>): Promise<void> {
+    const existing = this.memories.get(id);
+    if (!existing) return;
+    this.memories.set(id, { ...existing, ...update, id, updatedAt: update.updatedAt ?? new Date() } as Memory);
+  }
+  async deleteMemory(id: string): Promise<void> {
+    this.memories.delete(id);
+  }
+  async archiveMemory(id: string): Promise<void> {
+    const m = this.memories.get(id);
+    if (m) this.memories.set(id, { ...m, archived: true, status: "archived", updatedAt: new Date() });
+  }
+  async listMemories(projectId: string): Promise<Memory[]> {
+    return [...this.memories.values()].filter((m) => m.projectId === projectId).sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+  }
+  async search(query: SearchQuery): Promise<SearchResult[]> {
+    let candidates = [...this.memories.values()].filter((m) => m.projectId === query.projectId);
+    if (query.types?.length) candidates = candidates.filter((m) => query.types!.includes(m.type));
+    if (query.minImportance !== undefined) candidates = candidates.filter((m) => m.importance >= query.minImportance!);
+    if (!query.includeArchived) candidates = candidates.filter((m) => !m.archived && m.status !== "archived");
+    const qLower = query.query.toLowerCase();
+    const qTokens = new Set(qLower.split(/\W+/).filter(Boolean));
+    const scored = candidates.map((m) => {
+      const cLower = m.content.toLowerCase();
+      const cTokens = cLower.split(/\W+/).filter(Boolean);
+      let hits = 0;
+      for (const t of cTokens) if (qTokens.has(t)) hits++;
+      const phraseBoost = cLower.includes(qLower) ? 0.5 : 0;
+      const keywordScore = qTokens.size ? Math.min(1, hits / qTokens.size + phraseBoost) : 0;
+      const recency = Math.exp(-(Date.now() - m.updatedAt.getTime()) / (1000 * 60 * 60 * 24 * 30));
+      const final = keywordScore * 0.7 + m.importance * 0.15 + recency * 0.15;
+      return { memory: m, score: final, semanticScore: 0, keywordScore };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, query.limit ?? 5);
+  }
+  async upsertEmbedding(memoryId: string, vector: number[], model: string): Promise<void> {
+    this.embeddings.set(memoryId, { vector, model });
+  }
+  async getEmbedding(memoryId: string): Promise<{ vector: number[]; model: string } | null> {
+    return this.embeddings.get(memoryId) ?? null;
+  }
+  async deleteEmbedding(memoryId: string): Promise<void> {
+    this.embeddings.delete(memoryId);
+  }
+  async logRetrieval(event: RetrievalEvent): Promise<void> {
+    this.retrievals.push(event);
+  }
+  async listRetrievals(projectId: string, limit = 20): Promise<RetrievalEvent[]> {
+    return this.retrievals.filter((r) => r.projectId === projectId).slice(-limit).reverse();
+  }
+  async close(): Promise<void> {}
+}

package/packages/storage/src/migrations.ts

@@ -0,0 +1,96 @@
+/**
+ * Migration system for both SQLite (node:sqlite) and Postgres.
+ * Versioned, idempotent — tracks `schema_migrations` table.
+ */
+
+export interface Migration {
+  version: number;
+  name: string;
+  up: string; // SQL
+}
+
+export const MIGRATIONS: Migration[] = [
+  {
+    version: 1,
+    name: "initial",
+    up: `
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        version INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        applied_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS projects (
+        id TEXT PRIMARY KEY,
+        name TEXT UNIQUE NOT NULL,
+        description TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS sources (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        type TEXT NOT NULL,
+        content TEXT,
+        created_at TEXT NOT NULL,
+        metadata TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        type TEXT NOT NULL,
+        content TEXT NOT NULL,
+        importance REAL NOT NULL,
+        confidence REAL NOT NULL,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        last_accessed_at TEXT,
+        access_count INTEGER NOT NULL,
+        source_id TEXT REFERENCES sources(id) ON DELETE SET NULL,
+        metadata TEXT NOT NULL,
+        archived INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE TABLE IF NOT EXISTS embeddings (
+        memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+        vector TEXT NOT NULL,
+        model TEXT NOT NULL,
+        dimensions INTEGER NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS retrieval_events (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        query TEXT NOT NULL,
+        retrieved_memory_ids TEXT NOT NULL,
+        scores TEXT NOT NULL,
+        final_context_tokens INTEGER NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS consolidations (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        summary_memory_id TEXT REFERENCES memories(id) ON DELETE SET NULL,
+        source_memory_ids TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_memories_project ON memories(project_id);
+      CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+      CREATE INDEX IF NOT EXISTS idx_memories_status ON memories(status);
+    `,
+  },
+  {
+    version: 2,
+    name: "pgvector",
+    up: `
+      -- Postgres only: enable pgvector
+      -- CREATE EXTENSION IF NOT EXISTS vector;
+      -- ALTER TABLE embeddings ADD COLUMN IF NOT EXISTS vec vector(1536);
+      -- CREATE INDEX IF NOT EXISTS idx_embeddings_vec ON embeddings USING hnsw (vec vector_cosine_ops);
+      -- For SQLite, this migration is a no-op (vector stored as JSON text)
+      SELECT 1;
+    `,
+  },
+];
+
+export function getPendingMigrations(applied: number[]): Migration[] {
+  return MIGRATIONS.filter((m) => !applied.includes(m.version));
+}