v2.0.0

🎉 Major Release - BackpackFlow v2.0.0

This is a major breaking release that transforms BackpackFlow from a simple flow orchestrator into a production-ready, fully observable, config-driven LLM framework with complete nested flow composition and type-safe data contracts.

✨ What's New

🏗️ Core Architecture

• Git-like State Management - Complete history, time-travel debugging, snapshots
• EventStreamer - Real-time observability with lifecycle events
• Config-Driven Serialization - Load/export entire flows from JSON

🔄 Composite Nodes & Nested Flows (PRD-004)

• createInternalFlow() - Standard method for nesting flows
• Automatic context inheritance (namespace, backpack, events)
• FlowAction enum + convenience methods (.onComplete(), .onError(), etc.)
• Recursive serialization with circular reference detection
• Query utilities for introspection

📊 Complete Flow Observability (PRD-005)

• Zod Data Contracts - Type-safe input/output schemas with runtime validation
• Edge-Level Data Mappings - Transform data keys between nodes
• Enhanced Serialization - Full params, edges, and contracts in JSON
• ContractValidationError - Detailed validation error messages

📊 Statistics

• 274 tests passing
• 6,000+ lines of production code
• 5 comprehensive PRDs + 8 visual diagrams
• Node 18 & 20 support

🎯 Use Cases

• 🐛 Debug production agents (time-travel debugging)
• 📊 Build observability dashboards (real-time events)
• 🎨 Visual flow editors (config-driven serialization)
• 🧪 A/B testing (swap configs without code changes)
• 🤖 Multi-agent systems (namespace isolation)

🔧 Breaking Changes

• Replaced SharedStore with Backpack
• Nodes should extend BackpackNode instead of BaseNode
• New hierarchical namespace structure
• See Migration Guide

📚 Documentation

• README
• v2.0 Docs
• YouTube Research Agent Tutorial
• Full CHANGELOG

🚀 Installation

npm install backpackflow@2.0.0

🙏 Thanks

Special thanks to the PocketFlow community for the foundational flow orchestration patterns!

1.0.1

1.0.1