agent-first-http 0.4.2

Persistent HTTP client for AI agents — one request, one JSON line
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

"""
WebSocket test server for afhttp WebSocket tests.
Requires: pip install websockets  (>=10)
"""

import asyncio
import json
import os
import re
import threading

WS_PORT = int(os.environ.get("AFH_TEST_WS_PORT", "18081"))
WS_BASE = f"ws://127.0.0.1:{WS_PORT}"


async def handler(websocket):
    path = websocket.request.path

    # /ws/push/<n> — send n JSON messages then close
    m = re.match(r"^/ws/push/(\d+)$", path)
    if m:
        n = int(m.group(1))
        for i in range(n):
            await websocket.send(json.dumps({"seq": i}))
        return  # handler return → server closes connection

    # /ws/push/<n>/<delay_ms> — send n messages with inter-message delay
    m = re.match(r"^/ws/push/(\d+)/(\d+)$", path)
    if m:
        n, delay_ms = int(m.group(1)), int(m.group(2))
        for i in range(n):
            await websocket.send(json.dumps({"seq": i}))
            if i < n - 1:
                await asyncio.sleep(delay_ms / 1000.0)
        return

    # /ws/echo — echo every message back until client closes
    if path == "/ws/echo":
        async for message in websocket:
            await websocket.send(message)
        return

    # /ws/binary — send one 16-byte binary frame then close
    if path == "/ws/binary":
        await websocket.send(bytes(range(16)))
        return

    # /ws/headers — echo the HTTP upgrade request headers as a JSON text message
    if path == "/ws/headers":
        headers = {k: v for k, v in websocket.request.headers.items()}
        await websocket.send(json.dumps(headers))
        return

    # Unknown path — reject
    await websocket.close(1008, "unknown path")


def start_ws_server(port: int = WS_PORT) -> threading.Thread:
    """Start WS test server in a daemon thread. Blocks until server is ready."""
    import websockets

    ready = threading.Event()

    async def _main():
        async with websockets.serve(handler, "127.0.0.1", port, ping_interval=None):
            ready.set()
            await asyncio.Future()  # run until daemon thread is killed

    def _run():
        asyncio.run(_main())

    thread = threading.Thread(target=_run, daemon=True)
    thread.start()
    if not ready.wait(timeout=5):
        raise RuntimeError("WebSocket test server failed to start")
    return thread


if __name__ == "__main__":
    import sys
    import websockets

    port = int(sys.argv[1]) if len(sys.argv) > 1 else WS_PORT
    print(f"WebSocket test server on ws://127.0.0.1:{port}", file=sys.stderr)

    async def _serve():
        async with websockets.serve(handler, "127.0.0.1", port, ping_interval=None):
            await asyncio.Future()

    asyncio.run(_serve())