WHC
6e81513e36
A second implementation of cst_agent_hooks_t next to the TUI: the turn runs on a worker thread, the hooks publish events into a ring buffer that SSE clients read, so the engine itself needs no changes. - src/net.c, include/cst_net.h: POSIX/Winsock sockets, non-blocking connect - src/http_srv.c, include/cst_http.h: HTTP/1.1, keep-alive, chunked streaming, body caps (413), Expect: 100-continue, connection cap, exact routing - src/web_md.c, include/cst_web_md.h: streaming markdown -> sanitized HTML (tag/attribute allowlist, javascript: URLs and off-site images dropped) - src/webui.c, include/cst_webui.h: event ring + SSE broadcast, all routes, token (Bearer/Cookie/query) and loopback Host checks, 3 s auto-deny when no client is attached - src/webui_stub.c, CST_WEBUI=0 / CST_BUILD_WEBUI=OFF: build without the WebUI - web/: no-build front end (transcript, approvals, todo, sessions, image upload, status bar) - docs/webui.md: engine API v1 - events, requests, security model - tests/test_webui.c, scripts/e2e_webui.sh: unit tests plus an end-to-end run driven by a recorded SSE stream (no API key needed) - src/main.c: --web --web-port --web-host --web-token --web-dev --web-open and CST_WEB_PORT/HOST/TOKEN/ROOT An empty POST body is now accepted without Content-Length (RFC 9112 6.3) so curl-driven clients can reach cancel/undo/compact/quit; CMakeList's core tests learned about sashidown and test_webui, and CST_WEBUI=0 defines CST_NO_WEBUI.
69 lines
2.4 KiB
C
69 lines
2.4 KiB
C
#ifndef CST_NET_H
|
|
#define CST_NET_H
|
|
|
|
/* Minimal TCP sockets for the embedded HTTP server (src/net.c).
|
|
*
|
|
* The point of this layer is that src/http_srv.c and src/webui.c never
|
|
* include a socket header: Unix file descriptors and Windows SOCKETs differ
|
|
* in type, close() and error reporting, and Windows needs WSAStartup before
|
|
* anything works. */
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifdef _WIN32
|
|
typedef intptr_t os_socket_t;
|
|
#define OS_SOCKET_BAD ((os_socket_t)-1)
|
|
#else
|
|
typedef int os_socket_t;
|
|
#define OS_SOCKET_BAD (-1)
|
|
#endif
|
|
|
|
/* Longest "address:port" os_net_peer writes (IPv6 hosts are bracketed so a
|
|
* URL built from it stays unambiguous). */
|
|
#define OS_NET_ADDR_MAX 64
|
|
|
|
/* Winsock startup (no-op on Unix, which also ignores SIGPIPE so a client
|
|
* that hangs up cannot kill the process). 0 / -1. */
|
|
int os_net_init(void);
|
|
void os_net_cleanup(void);
|
|
|
|
/* Bind and listen on host:port. host may be NULL/"" (then "127.0.0.1"),
|
|
* "0.0.0.0"/"::" (every interface) or any literal address / name; port 0
|
|
* picks a free one. Returns the listening socket, or OS_SOCKET_BAD with a
|
|
* short reason in err. */
|
|
os_socket_t os_net_listen(const char *host, int port, char *err, size_t err_sz);
|
|
/* The port actually bound (0 when unknown). */
|
|
int os_net_port(os_socket_t s);
|
|
/* A one-line "host:port" for messages. */
|
|
void os_net_peer(os_socket_t s, char *out, size_t out_sz);
|
|
|
|
/* Connect to host:port, waiting up to timeout_ms: the socket, or
|
|
* OS_SOCKET_BAD. Used by the tests and by anything that drives the WebUI
|
|
* API from inside the process. */
|
|
os_socket_t os_net_connect(const char *host, int port, int timeout_ms);
|
|
|
|
/* Accept one connection, waiting up to timeout_ms (<0 = forever).
|
|
* Returns the socket, OS_SOCKET_BAD on error, or OS_SOCKET_BAD with
|
|
* *timed_out set when the wait ran out. */
|
|
os_socket_t os_net_accept(os_socket_t s, int timeout_ms, int *timed_out);
|
|
|
|
/* Read at most n bytes, waiting up to timeout_ms: bytes read, 0 at EOF,
|
|
* -1 on error, -2 when nothing arrived in time. */
|
|
long os_net_recv(os_socket_t s, void *buf, size_t n, int timeout_ms);
|
|
/* Write everything (timeout_ms per call): 0 / -1. */
|
|
int os_net_send_all(os_socket_t s, const void *buf, size_t n, int timeout_ms);
|
|
/* Wake up a thread blocked in recv/send on this socket (shutdown, no close). */
|
|
void os_net_shutdown(os_socket_t s);
|
|
void os_net_close(os_socket_t s);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* CST_NET_H */
|