Migration Guides

Move between major versions with explicit steps, code diffs, and effort estimates.

database • 2.0.0 → 3.0.0

Database Schema v3 Migration

breaking

Migrate database schema to v3 with new workspace isolation, multi-tenancy columns, and audit logging.

Effort: 1-2 hours

sdk • 1.0.0 → 2.0.0

Upgrade Agent Runtime from v1 to v2

breaking

Migrate agent runtime to the new LangGraph-based execution engine with state graphs and checkpointing.

Effort: 4-8 hours

api • 1.0.0 → 2.0.0

Migrate Authentication from NextAuth to Custom JWT

breaking

Complete guide for migrating from NextAuth session-based auth to custom JWT authentication with workspace support.

Effort: 2-4 hours