Wevna

// architecture

// overview

Wevna is a workflow engine for AI agents built around a typed runtime protocol, a shared contract of events, envelopes, and sessions that the SDK, server, and dashboard all speak. The backend architecture handles session lifecycle and a pluggable storage abstraction behind both REST and WebSocket APIs, with streaming transport and MCP-based tool integration for agents that need to call real tools mid-workflow. It's structured as a TypeScript monorepo with the shared protocol package as the single source of truth across every part of the system.

• ·A typed runtime protocol of events, envelopes, and sessions, shared across the SDK, server, and dashboard so nothing drifts out of sync.
• ·Architected the shared protocol package that gives the whole TypeScript monorepo a single typed contract.
• ·Fastify backend handling session lifecycle, with a pluggable storage abstraction behind both REST and WebSocket APIs.
• ·MCP-based tool integration, so agents can call real tools mid-workflow rather than just generating text.
• ·Streaming transport over WebSockets for real-time visibility into a running workflow.
• ·In active development.