Lore Integration Migration Guide

AgentLens v0.12.0 removes built-in lesson management, community sharing, and redaction in favor of Lore — a dedicated cross-agent memory system.

What Was Removed

Component	Package	Replacement
Lesson CRUD (POST/GET/PUT/DELETE /api/lessons)	server	Lore API
Community sharing (/api/community/*)	server	Lore community features
Redaction pipeline (6-layer)	server	Lore's built-in redaction
pool-server package	pool-server	Lore server
agentlens_learn MCP tool	mcp	lore MCP tools
agentlens_community MCP tool	mcp	lore MCP tools
client.createLesson() etc.	sdk	lore-sdk

Setting Up Lore Integration

1. Enable the feature flag

# In your .env or environment
LORE_ENABLED=true
LORE_API_URL=http://localhost:3500   # Your Lore server
LORE_API_KEY=lore_your_key           # Optional, if Lore requires auth

2. What happens when enabled

• Dashboard shows a single Memories nav item (read-only, proxied to Lore)
• GET /api/config/features returns { lore: true, loreUrl: "..." }
• Proxy routes forward /api/lore/* to your Lore server

3. What happens when disabled (default)

• No lesson/community UI in the dashboard
• Lesson and community API endpoints return 404
• AgentLens works as a pure observability tool

SDK Migration

Before (v0.11.x):

import { AgentLensClient } from '@agentkitai/agentlens-sdk';
const client = new AgentLensClient({ baseUrl, apiKey });
await client.createLesson({ title: 'Fix', content: '...', category: 'debug' });
const lessons = await client.getLessons();

After (v0.12.0):

// SDK lesson methods now throw "deprecated" errors
// Use lore-sdk directly:
import { LoreClient } from 'lore-sdk';
const lore = new LoreClient({ url: 'http://localhost:3500' });
await lore.createLesson({ title: 'Fix', content: '...', category: 'debug' });

MCP Migration

Before: agentlens_learn and agentlens_community tools in @agentkitai/agentlens-mcp

After: Use the Lore MCP server alongside AgentLens MCP:

{
  "mcpServers": {
    "agentlens": {
      "command": "npx",
      "args": ["@agentkitai/agentlens-mcp"],
      "env": { "AGENTLENS_API_URL": "http://localhost:3400" }
    },
    "lore": {
      "command": "npx",
      "args": ["@lore/mcp"],
      "env": { "LORE_API_URL": "http://localhost:3500" }
    }
  }
}

Data Export

Before migrating, export existing lessons:

cd packages/server
npx tsx scripts/export-lessons.ts --output lessons-export.json

Then import into Lore using its CLI or API.

Timeline

• v0.12.0: Lesson/community/redaction removed, Lore proxy available
• Deprecated SDK methods throw errors immediately (no grace period)
• The pool-server package is fully removed from the monorepo