Protocol Notes

This repository keeps the protocol experiments small and reproducible.

Local Probe

Start the app-server:

npm run server:ws

Probe it from another terminal:

npm run probe:ws

The probe performs:

1. initialize
2. initialized
3. thread/start

It prints the JSON-RPC messages it sent and received so changes in Codex app-server behavior can be inspected directly.

Observed Health Behavior

• GET /readyz returns 200 OK when the app-server is ready.
• GET /healthz returns 200 OK without an external origin.
• GET /healthz with an Origin header returned 403 Forbidden in the local smoke test.

Bridge Behavior

The bridge keeps one upstream WebSocket connection per shared browser thread. Browser clients talk to /bridge?token=..., while the upstream Codex app-server remains at ws://127.0.0.1:45213.