v1.2.2 - Production-Grade Agent Discovery

What's New

Production-Grade Agent Discovery with Role:Instance Pattern

Workers can now register as discoverable agents in the A2A network, enabling true agent-to-agent communication.

Key Features

• Role:Instance Pattern: Unique identity + stable routing

  • name = unique discovery identity (code-reviewer:dev-vm:abc123)
  • role = routing identity for send_to_agent (code-reviewer)

• TTL-Based Liveness: Agents must heartbeat every 45s

  • Configurable via A2A_AGENT_DISCOVERY_MAX_AGE (default: 120s)
  • Lazy cleanup removes stale agents from all indexes
  • Clock skew tolerance for distributed deployments

• New MCP Tool: refresh_agent_heartbeat

Worker CLI Options

--agent-name NAME        # Routing role for send_to_agent
--agent-description DESC # Description for discovery
--agent-url URL          # Direct URL (optional)
--no-agent-registration  # Disable auto-registration

discover_agents Response

{
  "agents": [{
    "name": "code-reviewer:dev-vm:abc123",
    "role": "code-reviewer",
    "instance_id": "dev-vm:abc123",
    "last_seen": "2026-01-15T12:00:00"
  }],
  "routing_note": "Use 'role' with send_to_agent for routing."
}

Bug Fixes

• JSON-RPC response format compliance (result OR error, not both)
• Cross-platform hostname detection (Windows compatible)

Tests

• 13 new tests for agent discovery

Installation

pip install codetether==1.2.2

Full Changelog

See CHANGELOG.md