Skip to content

Add canonical PerkOS Chat client - #2

Merged
JulioMCruz merged 1 commit into
mainfrom
agent/canonical-chat-client
Aug 4, 2026
Merged

Add canonical PerkOS Chat client#2
JulioMCruz merged 1 commit into
mainfrom
agent/canonical-chat-client

Conversation

@JulioMCruz

Copy link
Copy Markdown
Contributor

What changed

  • adds the reusable browser WebSocket client for chat.perkos.xyz
  • adds a Firestore conversation-metadata repository that cannot accept message bodies
  • supports independent threads, realtime messages, acknowledgements and canonical history paging
  • exports shared conversation identity helpers and lifecycle operations
  • prepares version 0.3.0 for consumption by PerkOS App and Desktop

Why

PerkOS Desktop still sends local window history to /assistant/chat, so it cannot share the same agent conversations as PerkOS App. The canonical protocol and metadata lifecycle belong in Shared Client instead of being copied into each frontend.

Impact

This is the service/client foundation for JOURNEY-CHAT-002. No frontend is switched by this PR alone and no production deployment is included.

Validation

  • npm test — 26 tests passed
  • npm run typecheck
  • npm run build

@JulioMCruz
JulioMCruz marked this pull request as ready for review August 4, 2026 11:52
@JulioMCruz
JulioMCruz merged commit 4ae36af into main Aug 4, 2026
1 check passed
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