db.memories.addFact(
  "api-endpoint",                    // key
  "The API is at /api/v2/users",     // content
  "discovered in auth.ts"            // source
);

db.memories.addLearning(
  "test-pattern",
  "Use vitest for unit tests in this project",
  "package.json analysis"
);

db.memories.addPreference(
  "commit-style",
  "Use conventional commits with scope",
  "project"  // scope
);

db.memories.add({
  category: "skill",
  key: "deploy-process",
  content: "1. Run tests\n2. Build\n3. Push to main\n4. Deploy triggers automatically",
  scope: "project",
  source: "CONTRIBUTING.md",
});

const memory = db.memories.get("fact", "api-endpoint");
// { id, category, key, content, source, scope, ... }

// All facts
const facts = db.memories.list("fact");

// Project-scoped preferences
const prefs = db.memories.list("preference", "project");

// All memories, limited
const all = db.memories.list(undefined, undefined, 100);

const relevant = db.memories.search("API endpoint", "fact", 5);
// Returns memories matching the search query

db.memories.update(memoryId, {
  content: "Updated content",
});

db.memories.delete(memoryId);

const stats = db.memories.stats();
// {
//   total: 42,
//   byCategory: { fact: 20, learning: 15, preference: 7 },
//   byScope: { global: 10, project: 30, session: 2 }
// }

<Claude
  onFinished={(result) => {
    // Extract and store discoveries
    if (result.output.includes("found endpoint")) {
      db.memories.addFact(
        "discovered-endpoint",
        result.output,
        "codebase exploration"
      );
    }
  }}
>
  Explore the API structure.
</Claude>

<Claude
  onError={(error) => {
    db.memories.addLearning(
      `error-${Date.now()}`,
      `Encountered error: ${error.message}. Solution: ...`,
      "error handler"
    );
  }}
>
  Attempt the task.
</Claude>

function InformedWorkflow() {
  // Load relevant memories
  const facts = db.memories.list("fact", "project");
  const prefs = db.memories.list("preference", "project");

  const context = [
    "Known facts:",
    ...facts.map(f => `- ${f.content}`),
    "Preferences:",
    ...prefs.map(p => `- ${p.content}`),
  ].join("\n");

  return (
    <Claude systemPrompt={context}>
      Work with knowledge of the project.
    </Claude>
  );
}

interface Memory {
  id: string;
  category: "fact" | "learning" | "preference" | "context" | "skill";
  key: string;
  content: string;
  confidence: number;
  source?: string;
  source_execution_id?: string;
  scope: "global" | "project" | "session";
  created_at: string;
  updated_at: string;
  accessed_at: string;
  expires_at?: string;
}

interface MemoryInput {
  category: Memory["category"];
  key: string;
  content: string;
  confidence?: number;
  source?: string;
  scope?: Memory["scope"];
  expires_at?: string;
}