Add CardioPulse — live cardiovascular fitness-test agent (BLE + ASI:One)

[ishneet42]

Summary

Adds CardioPulse under contributors/cardiopulse-agent/ — a live, stream-driven agent that reads a Garmin watch's heart rate over Bluetooth and runs a timed three-phase autonomic test (resting baseline → orthostatic → paced breathing) entirely through an ASI:One chat. It returns an estimated Cardio Fitness Age with reference ranges, an inline HR-timeline chart, and an ASI-1 coaching summary; repeated runs build a per-user trend.

Two-agent design: a local bridge agent subscribes to the watch's BLE Heart Rate characteristic (Bleak) and POSTs each reading to the main agent, which is registered on Agentverse via mailbox and reachable through ASI:One.

Scope: a proof of concept for a live, stream-driven agent — not a medical device and not health advice. Readings are illustrative estimates (~±5 years); the trend across repeated tests matters more than any single number.

Type of Change

• New agent example
• Bug fix
• Documentation update
• Refactor / cleanup
• Other

Checklist

• I have starred this repository.
• New community agents are under contributors/<agent-name>/ (not repo root).
• I ran ruff check ..
• I ran ruff format ..
• I added/updated README.md for changed example(s).
• I added .env.example if environment variables are required.
• I added demo image/GIF (if applicable).
• I added agent profile link (if applicable). (The agent address is derived per-deployment from AGENT_SEED; the README documents how to deploy via mailbox.)
• I updated contributors/CHANGELOG.md for community agent changes.
• I added my agent to the Community Contributors table in root README.md.
• I verified paths/commands used in docs.
• I understand this PR requires maintainer review before merge (review-required CI).

Related Issue

None.

Notes for Reviewers

• The agent needs local hardware — a Garmin watch broadcasting heart rate over BLE — so the live path can't run headless in CI. test_scoring.py exercises the scoring engine end-to-end with synthetic HR data and runs with no watch (python test_scoring.py).
• The bridge → agent link uses a localhost REST POST rather than agent-to-agent messaging, because Agentverse mailbox routing is too slow for the 1 Hz heart-rate stream; the mailbox carries the ASI:One conversation. Both agents run on the same machine. This is documented in the agent README's Architecture section.
• No secrets or personal data are committed; .env.example documents all configuration.

[gautammanak1]

No description provided.