Skip to content

Fix message system: render in /raw, preserve on updates, integrate into agent workflow#5

Open
jsell-rh wants to merge 5 commits intomarkturansky:mainfrom
jsell-rh:feat/message-system
Open

Fix message system: render in /raw, preserve on updates, integrate into agent workflow#5
jsell-rh wants to merge 5 commits intomarkturansky:mainfrom
jsell-rh:feat/message-system

Conversation

@jsell-rh
Copy link

@jsell-rh jsell-rh commented Mar 6, 2026

Summary

Messages sent via the dashboard were stored in agent JSON but never visible to agents because:

  1. The /raw markdown endpoint did not render them
  2. Agent status updates wiped the Messages field

This PR fixes both issues and makes the mailbox message system a first-class feature that agents discover during ignition and check for during every check-in.

Server changes

  • Render messages in /raw: New #### Messages section in renderAgentSection() with sender, timestamp, and content
  • Preserve messages on agent update: Messages and Documents fields are no longer wiped when agents POST status updates
  • Ignition shows pending messages: The /ignition/{agent} response now includes a "Pending Messages" section and documents the /message endpoint in protocol rules

Protocol and command changes

  • protocol.md: Added "Send message" endpoint row and rule 9 (check your messages)
  • boss.check.md: Agents now scan for #### Messages, acknowledge them, and act on instructions (4 steps instead of 3)
  • boss.ignite.md: New rules for checking messages and sending messages to other agents

Tests (9 new)

Test Coverage
TestMessagePostEndpoint POST, delivery confirmation, retrieval via GET
TestMessagePreservedOnAgentUpdate Messages survive agent status updates
TestMessageRenderedInMarkdown #### Messages appears in /raw output
TestMessageValidation Missing sender (400), empty message (400), wrong method (405)
TestMessageLimit 50-message cap enforced
TestMessageSSEBroadcast agent_message SSE event fires
TestMessageToNonexistentAgentCreatesAgent Auto-creates agent on message to unknown name
TestIgnitionEndpoint Ignition structure, tmux registration, /message docs
TestIgnitionShowsPendingMessages Pending messages shown in ignition response

Testing

  • All 44 tests pass with -race

jsell-rh added 2 commits March 6, 2026 14:07
…are empty

The callers of BroadcastCheckIn and SingleAgentCheckIn always pass empty
strings for checkModel and workModel, causing '/model ' (with no model
name) to be sent to agents. This resulted in broken model switch attempts
that would time out or fail.

Now when checkModel/workModel are empty, the model switch steps are
skipped entirely and the check-in runs on whatever model the agent is
already using. Model economy still works if actual model names are passed.
Rewrite tmuxIsIdle to use a comprehensive set of idle indicators instead
of only matching the Claude Code '>' prompt. New patterns recognized:

- Shell prompts: $, %, #, >, ❯, » (with false-positive guards for
  '=>', '->', '50%', 'line #3')
- Claude Code ❯ prompt with auto-suggested text after it
- Claude Code vim-mode status bar ('-- INSERT --', '-- NORMAL --')
- OpenCode status bar ('ctrl+p commands')
- Generic idle keywords ('waiting for input', 'ready', etc.)
- Heavy box-drawing character ┃ (U+2503) in addition to light │ (U+2502)

Also changes the default-on-error behavior from 'assume busy' to
'assume idle', preventing agents from being falsely skipped during
broadcasts when pane capture fails transiently.

Includes comprehensive table-driven tests for lineIsIdleIndicator (28
cases) and isShellPrompt (16 cases).
jsell-rh added 3 commits March 6, 2026 18:05
Fix broadcast model switching: skip /model when model names are empty
Improve tmux idle detection with robust prompt recognition
…protocol

Messages sent via the dashboard were stored in agent JSON but never
visible to agents because:
1. The /raw markdown endpoint did not render them
2. Agent status updates wiped the Messages field

This commit fixes both issues and makes messages a first-class feature:

Server changes:
- Render messages in /raw markdown under '#### Messages' with sender,
  timestamp, and content so agents see them during check-ins
- Preserve Messages and Documents fields when agents POST status updates
- Show pending messages in the ignition response with bold 'unread' header
- Add messaging protocol rule to ignition output

Protocol and command changes:
- Add 'Send message' endpoint to protocol.md endpoints table
- Add rule 9: check your messages on /raw, send via /message endpoint
- Update boss.check.md: scan for messages, acknowledge, act on instructions
- Update boss.ignite.md: document message checking and sending rules

Tests (9 new):
- TestMessagePostEndpoint: POST, verify delivery and retrieval
- TestMessagePreservedOnAgentUpdate: verify messages survive agent updates
- TestMessageRenderedInMarkdown: verify #### Messages in /raw output
- TestMessageValidation: missing sender, empty message, wrong method
- TestMessageLimit: verify 50-message cap
- TestMessageSSEBroadcast: verify agent_message SSE event
- TestMessageToNonexistentAgentCreatesAgent: auto-create on message
- TestIgnitionEndpoint: verify structure, tmux registration, /message docs
- TestIgnitionShowsPendingMessages: verify pending messages in ignition
@jsell-rh jsell-rh force-pushed the feat/message-system branch from 9d59b4f to 57aa9cd Compare March 6, 2026 23:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant