Changelog

Every notable change to GraphBus β€” the core protocol, CLI, runtime engine, and tooling. Follow the project on GitHub for real-time updates.

Unreleased In progress
  • Ollama local LLM backend β€” run negotiation without cloud API keys
  • graphbus dev β€” hot-reload mode; re-builds agents on file change during development
  • Message trace UI β€” browser-based replay of message flows
  • Visual graph editor β€” drag-and-drop agent graph in the browser
  • Cloud-hosted build service β€” run negotiation builds without local LLM keys
  • Protocol specification β€” language-agnostic GraphBus wire format for non-Python implementations
v0.5.1 February 24, 2026 Patch

Fix for graphbus tui crash. The TUI command tried to import a module (chat_app.py) that was never included in the package. The resulting ImportError was caught and misreported as a missing textual dependency. Tests passed because they mocked the module or silently skipped.

  • graphbus tui launch failure β€” missing chat_app.py module caused a misleading "textual not installed" error even when textual was installed
  • Chat-based TUI (graphbus_cli/tui/chat_app.py) β€” type natural language and GraphBus translates it to CLI commands. Example: graphbus negotiate .graphbus --intent "add retry logic"
  • CHANGELOG.md β€” full release history now tracked in the repository
  • README update β€” --intent flag highlighted as the primary workflow; PyPI install instructions updated
πŸ“¦ View on GitHub Releases β†’
v0.5.0 February 20, 2026 Minor

First PyPI release. Adds namespace isolation, codebase ingestion, model management, auth, session persistence, and TUI orchestration infrastructure. Test coverage at 85%.

  • PyPI release β€” pip install graphbus now works. Optional extras: graphbus[tui], graphbus[dev], graphbus[server]
  • Namespace support β€” graphbus ns create|use|current|list|show for logical agent isolation boundaries
  • graphbus ingest β€” convert any existing codebase into GraphBus agents automatically
  • graphbus model β€” LLM model configuration and tier management
  • graphbus auth β€” API key management for GraphBus cloud services
  • graphbus session β€” session persistence across CLI invocations
  • TUI orchestration layer β€” event loop, task queue, state management, and human-in-the-loop modules for the upcoming TUI
  • Multi-provider LLM support β€” Anthropic, OpenAI, DeepSeek, OpenRouter via LiteLLM
  • Syntax error in state.py
  • Multiple missing modules and methods required by the test suite
  • Test coverage improved from ~70% to 85%
πŸ“¦ View on GitHub Releases β†’
v0.1.0-alpha February 1, 2026 Alpha

Initial alpha release. Core protocol implemented end-to-end: build pipeline, LLM negotiation engine, typed message bus, runtime executor, 18-command CLI, REST API, MCP server, and 3 working examples. 832 tests passing.

18 CLI commands
832 tests passing
3 working examples
100% build + runtime coverage
Core Framework
  • GraphBusNode base class β€” subclass to define an agent with focused context
  • @schema_method decorator β€” declare typed input/output contracts per method; enforced at runtime
  • @subscribe decorator β€” register pub/sub handlers on the typed message bus
  • @depends_on decorator β€” declare dependency edges in the agent DAG
  • BuildConfig and RuntimeConfig β€” typed configuration objects
  • build_project() β€” entry point for the full build pipeline

Build Pipeline
  • Scanner β€” discovers all GraphBusNode subclasses in a target path
  • Extractor β€” parses methods, schemas, subscriptions, system prompts per class
  • Graph Builder β€” constructs networkx DAG from @depends_on edges with topological sort
  • Code Writer β€” applies accepted proposal diffs to source files
  • Artifact Writer β€” serializes graph.json, agents.json, topics.json, build_summary.json

LLM Negotiation Engine
  • Proposal protocol β€” structured diffs with rationale and affected-agent lists
  • Evaluation protocol β€” accept/reject decisions with reasoning and optional counter-proposals
  • Arbiter protocol β€” IS_ARBITER = True designates a conflict-resolution agent
  • Multi-round negotiation β€” configurable rounds via --rounds flag
  • Negotiation history β€” persisted to .graphbus/negotiation_log.json

Runtime Engine
  • Artifact Loader β€” loads and validates .graphbus/ JSON artifacts
  • Message Bus β€” in-process typed pub/sub routing with topic registry
  • Event Router β€” dispatches published events to all registered @subscribe handlers
  • Runtime Executor β€” initializes agents, runs the event loop, exposes REPL
  • Contract Validator β€” runtime schema contract enforcement on every message
  • Coherence Tracker β€” detects inter-agent schema drift at runtime
  • Hot Reload β€” watches .graphbus/ for artifact changes and reloads without restart
  • Profiler β€” latency/throughput metrics per agent and topic
  • State Manager β€” optional agent state persistence across invocations
  • Migration Engine β€” handles artifact version upgrades

CLI β€” 18 Commands
  • graphbus build β€” scan agents, build graph, emit artifacts
  • graphbus run β€” load artifacts, start runtime (with optional REPL)
  • graphbus inspect β€” rich display of artifact contents
  • graphbus validate β€” validate schemas without building
  • graphbus init β€” scaffold new project from template
  • graphbus generate agent β€” generate GraphBusNode boilerplate
  • graphbus negotiate β€” standalone negotiation round
  • graphbus inspect-negotiation β€” browse negotiation history
  • graphbus profile β€” runtime performance profiler
  • graphbus dashboard β€” web-based graph visualization
  • graphbus state β€” agent state persistence management
  • graphbus coherence β€” inter-agent coherence check
  • graphbus contract β€” schema contract validation
  • graphbus migrate β€” artifact version migration
  • graphbus docker build/run β€” Docker helpers
  • graphbus k8s generate/deploy β€” Kubernetes manifest generation
  • graphbus ci github/gitlab β€” CI pipeline generation

Integrations
  • REST API (graphbus_api) β€” trigger builds, query runtime state over HTTP; WebSocket for live event streaming
  • MCP Server (graphbus-mcp-server) β€” expose agents as tools to Claude Desktop and any MCP-compatible client

Examples
  • examples/hello_graphbus/ β€” minimal 4-agent Hello World pipeline
  • examples/hello_world_mcp/ β€” MCP integration example
  • examples/news_summarizer/ β€” 3-agent news pipeline: FetcherService β†’ CleanerService β†’ FormatterService. Tutorial β†’

Open Source & Developer Experience
  • CONTRIBUTING.md β€” setup guide, PR process, conventional commit format
  • CODE_OF_CONDUCT.md β€” Contributor Covenant based
  • GitHub issue templates β€” bug report + feature request
  • GitHub Actions CI β€” pytest on Python 3.9/3.10/3.11/3.12 + Ruff linter
  • LICENSE β€” MIT
  • SECURITY.md β€” vulnerability reporting process
  • CHANGELOG.md β€” this document, in the repo
  • ROADMAP.md β€” full roadmap with milestones through v0.5
  • LLM backends: Claude (Anthropic) only. Resolved in v0.5.0 β€” multi-provider via LiteLLM
  • TUI: graphbus tui command scaffolded but implementation missing. Resolved in v0.5.1
  • PyPI: Install from source only. Resolved in v0.5.0 β€” pip install graphbus
  • Arbiter __init__: Agents with IS_ARBITER = True cannot take __init__ parameters; workaround: use super().__init__().
πŸ“¦ View on GitHub Releases β†’
Pre-Alpha Q4 2025 β€” January 2026

Development history before public alpha

2025 Q4 Protocol design and architecture decisions. Initial GraphBusNode prototype. Build/Runtime separation concept validated.
Jan 2026 Full build pipeline implemented and tested. Runtime engine implemented and tested. CLI scaffolded with all command stubs. Negotiation protocol first working version. MCP server integration prototype.
Feb 2026 Test suite reaches 832 passing. All examples working. Open-source launch prep: CONTRIBUTING.md, CI, issue templates, CHANGELOG.md, ROADMAP.md. Alpha published.

Stay updated: watch the GitHub repo for releases, or join the waitlist for launch announcements.

Join the waitlist Documentation