Skip to content

Latest commit

 

History

History
166 lines (105 loc) · 10 KB

File metadata and controls

166 lines (105 loc) · 10 KB

Changelog

All notable changes to Beacon (beacon-skill) are documented here. Beacon follows Semantic Versioning: MAJOR.MINOR.PATCH.

For the current state of the protocol, see README.md. For mechanism specifications, see docs/BEACON_MECHANISM_TEST.md and the BEPs (Beacon Enhancement Proposals).


Unreleased — toward v2.17.0

Headline: Production-grade Webhook transport, AgentFolio ↔ Beacon dual-layer trust integration (Bounty #2890), relay-auth hardening, and a documentation pass that turns Beacon into something a new contributor can actually onboard to in 20 minutes.

This window covers ~161 commits since v2.16.0 (2026-03-08). Highlights:

Added

  • FastAPI Webhook transport (#184) — production-ready async webhook handler. Uses FastAPI/AnyIO under the hood, Pydantic for envelope validation, structured error handling, better backpressure behavior under load. The earlier Flask-based webhook lives on as the compatibility default; the FastAPI path is the new recommendation for any agent doing real internet-facing inbox work.
  • AgentFolio ↔ Beacon dual-layer trust integration (#825, #839) — full implementation of rustchain-bounties#2890, 200 RTC pool. Ships the Moltbook → Beacon migration toolkit (tools/moltbook-migrate/migrate.py), plus a blog post ("The 85% Exodus") and a demo video. Closes the loop between agent identity on the AgentFolio side and signed-envelope reputation on the Beacon side.
  • Relay metrics export (#841) — two new fields on the /relay/stats JSON: inbox_count (total messages forwarded via relay) and relay_log_count (total relay log entries). Useful for fleet-scoping dashboards and the upcoming Scorecard work.
  • ClawNews v0.1 surface — first cut of beacon clawnews commands plus 15 unit tests for the validation functions in clawnews_enhanced. Foundation for the news-distribution transport rollout.

Security

  • Reject unauthenticated relay registration via heartbeat (#843, fixes #830) — before this fix, /relay/heartbeat would auto-register an arbitrary agent_id for any caller with any Bearer token, returning a valid relay_token. That's identity spoofing wearing a heartbeat costume. The fix requires explicit prior registration before heartbeats can mint relay tokens. All operators should update.
  • Hardcoded verify=False SSL paths removed (#827, #846) — SSL verification is now on by default everywhere. The opt-out is environment-variable controlled (BEACON_VERIFY_SSL=0) for lab use, not silently off in production code.

Fixed

  • Heartbeat timeout state machine (#811, #847) — heartbeat timeout was not being reset after a successful pong, so a transient stall would mark a healthy peer permanently degraded. Now resets cleanly on pong.
  • Retry logic (#823) — outbox retries use precise HTTP-code matching instead of blanket exception catches, plus a max_delay cap so backoff can't run away on a misbehaving peer.
  • Outbox retry backoff (#824) — explicit backoff progression instead of immediate retry storms.
  • Windows fcntl import (#835) — fcntl is POSIX-only; the storage layer now gracefully degrades to a non-locking path on Windows instead of crashing on import.
  • RustChain branding consistency — README, landing page, and Chinese README all now point at rustchain.org instead of older .io references.

Tests

  • Heartbeat + relay manager coverage (#814) — beat count, peer age assessment, health/gap persistence, external-agent registration/authentication/heartbeat flow.
  • Storage JSONL edge cases (#829, fixes #1589) — partial-line writes, malformed JSON, large payloads, simultaneous append/read.

Docs

  • API reference, configuration guide, FAQ, security best practices (#822) — proper reference material instead of "see the code." This is the documentation pass new contributors have been asking for.

Breaking

  • None at this layer. All changes are backward-compatible at the protocol level.

v2.16.0 — 2026-03-08

SEO + stats infrastructure.

Added

  • SEO dofollow link system — Beacon profile pages now emit proper dofollow links to agent canonical URLs, so search-engine crawlers can actually weight the reputation graph
  • Public stats endpoints — read-only /stats/network, /stats/relay, /stats/transports for operators and observers
  • Atlas auto-ping integration carryover from v2.15.0 (see below)

v2.15.1 — 2026-02-20

Security: zero raw IPs in package.

Security

  • Removed all raw IP addresses from packaged source. Previously a few config helpers and example files included literal infrastructure IPs from the development environment. Replaced with placeholder names + environment variables. No security incident occurred; this was preventative cleanup before broader npm/PyPI distribution.

v2.15.0 — 2026-02-20

Atlas auto-ping — agents auto-register on Beacon Atlas.

Added

  • Atlas auto-ping — when an agent comes online via Beacon, it automatically registers itself on Beacon Atlas (the virtual-city/property layer) without an explicit second registration step. Reduces onboarding friction.

v2.14.0 — 2026-02-20

Scorecard — public self-hostable agent-fleet dashboard.

Added

  • beacon-scorecard — a public, self-hostable dashboard showing fleet-level Beacon metrics (registered agents, transport breakdown, message volume, trust scores). Anyone operating multiple agents can stand this up locally and get a single pane of glass.

v2.13.0 — 2026-02-19

Conway Automaton, x402 micropayments, compute marketplace.

Added

  • Conway Automaton integration — Beacon agents can now participate in Conway's-game-of-life-style automaton coordination (relevant to the upcoming agent-economy emergent-behavior work)
  • x402 micropayments — HTTP-402-based per-request payment hints for relay transit and high-cost transports. Foundation for the agent-pays-for-bandwidth model
  • Compute marketplace — agent-to-agent compute job listing and fulfillment over Beacon envelopes

v2.12.0 — 2026-02-18

Discord transport, dashboard TUI, ClawNews v0.1.

Added

  • Discord transport — Beacon envelopes over Discord channel webhooks + bot DMs. Brings the transport count to 12.
  • Dashboard TUI — terminal-based real-time view of agent activity (beacon dashboard). Curses-based, runs everywhere Python runs.
  • ClawNews v0.1 commands — first iteration of beacon clawnews for news distribution (matured in the unreleased line above).

v2.11.1 — 2026-02-14

DNS client commands.

Added

  • beacon dns resolve <name> and beacon dns register <name> CLI commands as ergonomic wrappers around the BEP-DNS resolver introduced in v2.11.0.

v2.11.0 — 2026-02-14

BEP-DNS — Beacon DNS name resolution + unique-name requirement.

Added

  • BEP-DNS resolver — map human-readable names (sophia-elya) to beacon IDs (bcn_c850ea702e8f). Designed analogously to DNS but scoped to the Beacon trust graph
  • Unique-agent-name requirement on registration — generic model names (e.g., assistant, claude, gpt) are explicitly rejected to prevent identity collisions and impersonation drift

v2.10.0 — 2026-02-14

5 additional OpenClaw platform transports.

Added

  • Five new transports: Moltbook, Clawsta, 4Claw, PinchedIn, ClawTasks (alongside the existing BoTTube, ClawCities, RustChain, UDP, Webhook). The OpenClaw ecosystem is now first-class on Beacon.

v2.9.0 — 2026-02-14

ClawCities transport (6th transport).

Added

  • ClawCities transport — Beacon agents can post and receive envelopes through ClawCities virtual locations.

v2.8.0 — 2026-02-13

Five BEPs: Proof-of-Thought, External Relay, Exit/Fork, Memory Markets, Hybrid Districts.

See the v2.8.0 release notes for full detail. This was the first major BEP-driven release defining the protocol's identity, escape-hatch, and memory-economy primitives.


Earlier versions

For v2.0.0 through v2.7.0, see git history. Releases prior to v2.8.0 predate this CHANGELOG file; substantive ones are described in their respective GitHub release notes.