Vapora

🤖

Specialized Agents

82 tests verify agent orchestration, learning profiles, and task assignment. stable_id = role ensures learning expertise survives restarts and hot-reloads. SIGHUP + POST /reload for zero-downtime config updates. Agents track expertise per task type with 7-day recency bias (3× weight).

🧠

Intelligent Orchestration

53 tests verify multi-provider routing (Claude, OpenAI, Gemini, Ollama), per-role budget limits, cost tracking, and automatic fallback chains. Swarm coordination with load-balanced assignment using success_rate / (1 + load) formula.

📚

Recursive Language Models (RLM)

Process 100k+ token documents without context limits. Hybrid search combines BM25 (keywords) + semantic embeddings via RRF fusion. Intelligent chunking (Fixed/Semantic/Code) with SurrealDB persistence. Perfect for large codebases and documentation.

🔗

Agent-to-Agent (A2A) Protocol

Distributed agent coordination with task dispatch, status tracking, and result collection. Real SurrealDB persistence (no in-memory HashMap). NATS messaging for async completion. Exponential backoff retry with circuit breaker. 12 integration tests verify real behavior.

🕸️

Knowledge Graph

Temporal execution history with causal relationships. Hybrid search: HNSW (SurrealDB 3 native ANN) + BM25 full-text fused via Reciprocal Rank Fusion (k=60) — exact keyword matches and semantic proximity combined. Learning curves from daily windowed aggregations. 28 tests verify graph persistence, hybrid retrieval, and execution tracking.

⚡

NATS JetStream

Reliable message delivery for agent coordination. JetStream streams for workflow events, task completion, and status updates. Graceful fallback when NATS unavailable. Background subscribers with DashMap for async result delivery.

🗄️

SurrealDB

Multi-model database with graph capabilities. Multi-tenant scopes for workspace isolation. Native graph relations for Knowledge Graph. All queries use parameterized bindings for security. SCHEMAFULL tables with explicit indexes.

🔌

Backend API & MCP Connectors

40+ REST endpoints (projects, tasks, agents, workflows, swarm). WebSocket real-time updates. MCP gateway for external tool integration and plugin system. Multi-tenant SurrealDB scopes. Prometheus metrics at /metrics. 161 tests verify API correctness.

☸️

Cloud-Native & Self-Hosted

161 backend tests + K8s manifests with Kustomize overlays. Health checks, Prometheus metrics (/metrics endpoint), StatefulSets with anti-affinity. Local Docker Compose for development. Zero vendor lock-in.

⏰

Autonomous Scheduling

Cron-triggered workflow execution with IANA timezone support via chrono-tz. Distributed fire-lock using SurrealDB conditional UPDATE prevents double-fires across multi-instance deployments — no external lock service required. 48 tests.

🔔

Webhook Notifications

Real-time alerts to Slack, Discord, and Telegram — no vendor SDKs. ${VAR} secret resolution is built into ChannelRegistry construction; tokens never reach the HTTP layer unresolved. Fire-and-forget hooks on task completion, proposal approval/rejection, and workflow lifecycle events.

🧩

Capability Packages

Domain-optimized agent bundles — system prompt, preferred LLM model, task types, and MCP tools pre-configured per role. Three built-ins (code-reviewer, doc-generator, pr-monitor) loaded at startup via CapabilityRegistry. TOML overrides let you swap model or prompt without code changes. In-process executor dispatch via DashMap channels — no NATS required for standalone mode. 22 tests.

🌿

VCS-Agnostic Worktree

vapora-worktree isolates agent workspaces from the main repository. WorkspaceBackend trait supports jj (Jujutsu — stable change IDs, native workspaces) and git (worktrees). Auto-detected at runtime via detect_vcs. jj's stable change IDs survive rebase and amendment — agents always reference the same change regardless of commit history rewrites. Integration tests require real jj/git binaries.

🧭

Ontology Protocol (ontoref)

vapora-ontology exposes VaporaOntology — loads .ontology/*.ncl (core, state, gate), queries invariant axioms, checks gate membranes, and returns open FSM dimensions. vapora-reflection runs NCL-defined execution modes (CreateAgentTask, DeployService) via stratum-reflection-core. Both support live reload without process restart. Architecture is machine-readable: agents can query architectural constraints before acting.

Development Flows

The 4 Problems It Solves

Context Switching

Knowledge Fragmentation

Manual Coordination

Dev-Ops Friction

How It Works