johannes/assistant
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(vela-gateway): add websocket session skeleton

Browse Source
This commit is contained in:
Johannes Kresner
2026-04-08 18:30:21 +02:00
parent 4fd27db11e
commit fa5a458003
8 changed files with 655 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/integrations.md
View File

@@ -4,7 +4,16 @@
- `vela-ui` is implemented as a SvelteKit application
- `vela-gateway` is implemented as a Fastify service
- current integration work beyond the gateway HTTP baseline remains future implementation
- `vela-gateway` now exposes `/ws` as the minimal WebSocket session entrypoint using the shared `@vela/protocol` contract
- current integration work beyond the gateway WebSocket/session baseline remains future implementation
## Gateway Session Contract
- transport: WebSocket on `/ws`
- session storage: in-memory only, one ephemeral record per live connection
- message format: `@vela/protocol` `MessageEnvelope<{ type, payload }>`
- current server behavior: acknowledge connect with `session.ready` and `session.state`
- safety baseline: invalid JSON, invalid envelopes, and malformed frames return protocol errors or close that socket without taking down the service
## STT (Speech-to-Text)