fix(presence): POST /registry/heartbeat keepalive (closes #6, closes molecule-core#24) #7

claude-ceo-assistant · 2026-05-07T15:28:44Z

2026-05-07 15:28:44 +00:00

Summary

v0.4.0-gitea.1 channel plugin polled /workspaces/:id/activity but never sent /registry/heartbeat. After ~90s the platform's healthsweep (workspace-server internal/registry/healthsweep.go) flipped the workspace back to status='awaiting_agent' even though A2A traffic flowed fine over the long-poll loop.
Fix: per-workspace setInterval posting {workspace_id: id} to /registry/heartbeat every 30s (three ticks inside the platform's 90s stale window).
New heartbeat.ts pure module + heartbeat.test.ts Bun.serve fixture pin the wire shape (POST + bearer + Origin + body).
New env var MOLECULE_HEARTBEAT_INTERVAL_MS (default 30000; set to 0 to disable).
Version bump: 0.4.0-gitea.1 → 0.4.0-gitea.2 (package.json + plugin.json + marketplace.json).

Why platform-side change skipped

core#24 proposed counting /workspaces/:id/activity GETs as keepalives. That's a deeper semantic change to a hot read endpoint and would mask actual bugs (e.g. a poll-mode workspace where the agent silently died but a stale tail process keeps polling). The plugin-side fix is the smaller blast radius and matches what the legacy server-mode + Python runtime already do. core#24 will be closed as won't-fix with a comment routing to this PR.

Test plan

bun test — 18 pass / 0 fail (4 new heartbeat tests).
Live verify on Hongming tenant: install v0.4.0-gitea.2, start plugin, observe canvas badge stays on online past 90s.

Closes

#6
molecule-core#24

## Summary - v0.4.0-gitea.1 channel plugin polled `/workspaces/:id/activity` but never sent `/registry/heartbeat`. After ~90s the platform's `healthsweep` (workspace-server `internal/registry/healthsweep.go`) flipped the workspace back to `status='awaiting_agent'` even though A2A traffic flowed fine over the long-poll loop. - Fix: per-workspace `setInterval` posting `{workspace_id: id}` to `/registry/heartbeat` every 30s (three ticks inside the platform's 90s stale window). - New `heartbeat.ts` pure module + `heartbeat.test.ts` Bun.serve fixture pin the wire shape (POST + bearer + Origin + body). - New env var `MOLECULE_HEARTBEAT_INTERVAL_MS` (default 30000; set to 0 to disable). - Version bump: `0.4.0-gitea.1` → `0.4.0-gitea.2` (package.json + plugin.json + marketplace.json). ## Why platform-side change skipped core#24 proposed counting `/workspaces/:id/activity` GETs as keepalives. That's a deeper semantic change to a hot read endpoint and would mask actual bugs (e.g. a poll-mode workspace where the agent silently died but a stale tail process keeps polling). The plugin-side fix is the smaller blast radius and matches what the legacy server-mode + Python runtime already do. core#24 will be closed as won't-fix with a comment routing to this PR. ## Test plan - [x] `bun test` — 18 pass / 0 fail (4 new heartbeat tests). - [ ] Live verify on Hongming tenant: install v0.4.0-gitea.2, start plugin, observe canvas badge stays on `online` past 90s. ## Closes - #6 - molecule-core#24

claude-ceo-assistant added 1 commit 2026-05-07 15:28:44 +00:00

fix(presence): POST /registry/heartbeat ticker so canvas badge stays online (closes #6 , closes molecule-core#24)

Test / bun test (pull_request) Successful in 20s

Details

b3b79a5efc

v0.4.0-gitea.1 polled /workspaces/:id/activity but never sent
/registry/heartbeat. The platform's healthsweep
(workspace-server/internal/registry/healthsweep.go) flipped any
runtime='external' workspace whose last_heartbeat_at was older than
90s back to status='awaiting_agent', so the canvas presence badge
stuck on awaiting_agent within 90s of plugin start even while A2A
traffic flowed fine over the long-poll loop.

Fix: per-workspace heartbeat ticker (default 30s, three ticks inside
the 90s stale window) POSTs the minimal HeartbeatPayload shape
(workspace_id only) — same path the Python runtime in
workspace/heartbeat.py uses when it has nothing else to report.

heartbeat.ts pure module + Bun.serve fixture test pin the wire
shape (POST + bearer + Origin + workspace_id body) so a future
refactor that drops any of those silently re-breaks the badge.

Bump 0.4.0-gitea.1 → 0.4.0-gitea.2 and document
MOLECULE_HEARTBEAT_INTERVAL_MS in README.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

claude-ceo-assistant merged commit 73367764f9 into main

2026-05-07 15:28:54 +00:00

claude-ceo-assistant referenced this issue from a commit

2026-05-07 15:28:55 +00:00

Merge pull request 'fix(presence): POST /registry/heartbeat keepalive (closes #6, closes molecule-core#24)' (#7) from fix/6-presence-heartbeat into main

claude-ceo-assistant referenced this pull request

2026-05-07 15:33:50 +00:00

[bug] [presence] v0.4.0-gitea.1 channel plugin: workspace stuck on awaiting_agent (cosmetic; tools work) #6

Sign in to join this conversation.

No reviewers

No Label

No Milestone