feat(agentctl): add setGuildActivity and clearGuildActivity headless helpers

Phase 528 presence automation for activity set/clear roundtrips.

Co-authored-by: Cursor <[email protected]>

README.md

@@ -124,6 +124,8 @@ See [docs/AGENTCTL.md](../../docs/AGENTCTL.md) for full reference, security note
 - Optional `PEARCORD_AGENTCTL_TOKEN` shared secret; still localhost-only.
 - Can execute any UI IPC type (moderation, guild admin, etc.) — same power as the logged-in user session.
 
+**v0.8.491 (Phase 528):** Headless helpers `setGuildActivity(activity)` and `clearGuildActivity()` for rich-presence automation (plus existing `setPresenceStatus`, `setCustomStatus`). Bundle: `npm run test:phase528-presence` (app repo).
+
 **v0.8.490 (Phase 527):** Headless helpers `playGuildSoundboardSound`, `upsertGuildSound`, `removeGuildSound` for soundboard roundtrip automation. Bundle: `npm run test:phase527-soundboard` (app repo).
 
 **v0.8.489 (Phase 526):** Headless helpers `startGuildScreenShare`, `stopGuildScreenShare` for screen share roundtrip automation. Bundle: `npm run test:phase526-screen` (app repo).

headless.js

@@ -574,6 +574,16 @@ class HeadlessSession {
     return this.platform.setPresence(status, text)
   }
 
+  async setGuildActivity (activity) {
+    if (!this.platform) throw new Error('headless not started')
+    return this.platform.setActivity(activity ?? null)
+  }
+
+  async clearGuildActivity () {
+    if (!this.platform) throw new Error('headless not started')
+    return this.platform.setActivity(null)
+  }
+
   async searchGuildMessages (query, opts = {}) {
     if (!this.platform) throw new Error('headless not started')
     const guildId = opts.guildId || this.platform.guild?.guild?.id