hen 0.19.0

Run protocol-aware API request collections from the command line or through MCP.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

---
sidebar_position: 8
title: WebSocket
description: Open a WebSocket session and send a message through a session-backed follow-up step.
---

Source file:
[examples/ws_protocol.hen](https://gitlab.com/ben_goodman/apps/hen/-/blob/main/examples/ws_protocol.hen)

## What It Demonstrates

- `protocol = ws`
- a session-opening request
- a later session-backed send step
- capturing the reply body from the message exchange flow

## Key Pattern

```hen
protocol = ws
session = chat
GET {{ WS_ORIGIN }}/ws

---

session = chat
within = 1s

~~~
<Root seed="0">
  <Document>
      <Text>
        1. Sentence:
        <Sentence min="3" max="10"/>
      </Text>
  </Document>
</Root>
~~~
```

## Run It

```bash
hen verify ./examples/ws_protocol.hen
hen run ./examples/ws_protocol.hen all --non-interactive
```

## What To Notice

- The session-opening step establishes the WebSocket connection.
- The later body-backed step reuses that session.
- In the current example, the received body is captured for callback output rather than asserted.

Related reference: [Protocols](../reference/protocols.md)