Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[kimi-task] [refactor] Extract WebSocket message types into shared protocol module #667

New Issue
Closed
opened 2026-03-21 03:12:01 +00:00 by kimi · 1 comment
kimi commented 2026-03-21 03:12:01 +00:00
Collaborator
Copy Link

Epic: Matrix Unification

Task

Create src/infrastructure/protocol.py defining all WebSocket message types as an enum and dataclasses.
The Matrix PROTOCOL.md defines these types: agent_state, visitor_state, bark, thought, system_status,
connection_ack, error, task_update, memory_flash. Codify them as Python dataclasses with validation.

Files

  • src/infrastructure/protocol.py — NEW: MessageType enum + dataclasses for each message
  • tests/unit/test_protocol.py — NEW: validation tests

Acceptance Criteria

  • MessageType enum with all 9 types from Matrix PROTOCOL.md
  • Dataclass for each message type with required fields
  • to_json() and from_json() on each dataclass
  • tox -e unit passes
  • tox -e lint passes

Context

The Matrix frontend expects WebSocket messages in this format:

{"type": "agent_state", "agent_id": "timmy", "data": {...}, "ts": 1234567890}

We need a shared protocol module so the gateway and all producers speak the same language.
The current /api/world/ws endpoint in the dashboard uses ad-hoc dicts — this replaces that.

## Epic: Matrix Unification ## Task Create `src/infrastructure/protocol.py` defining all WebSocket message types as an enum and dataclasses. The Matrix PROTOCOL.md defines these types: agent_state, visitor_state, bark, thought, system_status, connection_ack, error, task_update, memory_flash. Codify them as Python dataclasses with validation. ## Files - src/infrastructure/protocol.py — NEW: MessageType enum + dataclasses for each message - tests/unit/test_protocol.py — NEW: validation tests ## Acceptance Criteria - [ ] MessageType enum with all 9 types from Matrix PROTOCOL.md - [ ] Dataclass for each message type with required fields - [ ] to_json() and from_json() on each dataclass - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context The Matrix frontend expects WebSocket messages in this format: ```json {"type": "agent_state", "agent_id": "timmy", "data": {...}, "ts": 1234567890} ``` We need a shared protocol module so the gateway and all producers speak the same language. The current /api/world/ws endpoint in the dashboard uses ad-hoc dicts — this replaces that.
kimi self-assigned this 2026-03-21 03:12:01 +00:00
kimi commented 2026-03-21 13:37:16 +00:00
Author
Collaborator
Copy Link

PR created. Added src/infrastructure/protocol.py with MessageType StrEnum (all 9 Matrix PROTOCOL.md types) and typed dataclasses with to_json()/from_json() serialisation. Comprehensive tests in tests/unit/test_protocol.py. All CI gates pass.

PR created. Added `src/infrastructure/protocol.py` with `MessageType` StrEnum (all 9 Matrix PROTOCOL.md types) and typed dataclasses with `to_json()`/`from_json()` serialisation. Comprehensive tests in `tests/unit/test_protocol.py`. All CI gates pass.
kimi closed this issue 2026-03-21 13:37:29 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok kimi manus perplexity Rockachopa
No Assignees kimi
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#667
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?