From 2c37727e653d2340d8977dd5db4addc767dd81ea Mon Sep 17 00:00:00 2001 From: Onur Gündüz Date: Wed, 10 Jun 2026 08:24:39 +0200 Subject: gitignore: track new binary and library names --- embed_server.c | 2431 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 2431 insertions(+) create mode 100644 embed_server.c (limited to 'embed_server.c') diff --git a/embed_server.c b/embed_server.c new file mode 100644 index 0000000..d831062 --- /dev/null +++ b/embed_server.c @@ -0,0 +1,2431 @@ +#ifndef _GNU_SOURCE +#define _GNU_SOURCE +#endif + +#include "pplx_server.h" +#include "pplx_embed.h" +#include "qwen_safetensors.h" +#include "qwen_tokenizer.h" + +#ifdef USE_MLX +#include "pplx_embed_mlx.h" +#endif +#ifdef USE_CUDA +#include "pplx_embed_cuda.h" +#endif + +#include "deps/ae/ae.h" +#include "deps/ae/anet.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#ifdef __APPLE__ +#include +#endif + +#include + +#define PPLX_HTTP_IO_BUF 8192 +#define PPLX_HTTP_MAX_HEADER (64u * 1024u) +#define PPLX_HTTP_MAX_BODY (64u * 1024u * 1024u) +#define PPLX_HTTP_MAX_PATH 255u +#define PPLX_HTTP_BACKLOG 128 +#define PPLX_HTTP_SETSIZE 10240 +#define PPLX_HTTP_CLIENT_TIMEOUT_MS 30000 +#define PPLX_HTTP_SWEEP_MS 1000 + +#define PPLX_API_MAX_STANDARD_INPUTS 512 +#define PPLX_API_MAX_CONTEXT_DOCS 512 +#define PPLX_API_MAX_CONTEXT_CHUNKS 16000 +#define PPLX_API_MAX_ITEM_TOKENS 32768 +#define PPLX_API_MAX_TOTAL_TOKENS 120000 +#define PPLX_SERVER_DEFAULT_BATCH_SIZE 8 +#define PPLX_SERVER_DEFAULT_MAX_BATCH_TOKENS 16384 +#define PPLX_SERVER_BATCH_WAIT_US 1000 +#define PPLX_SERVER_MICROBATCH_MAX_JOBS 128 +#define PPLX_MLX_MEMORY_BUDGET_PERCENT 90 +#define PPLX_MLX_RESIDENT_MULTIPLIER 2 + +typedef struct { + char *ptr; + size_t len; + size_t cap; +} sbuf; + +static void die_oom(void) { + fprintf(stderr, "pplx-serve: out of memory\n"); + exit(1); +} + +static void *xmalloc(size_t n) { + void *p = malloc(n ? n : 1); + if (!p) die_oom(); + return p; +} + +static void *xcalloc(size_t n, size_t sz) { + void *p = calloc(n ? n : 1, sz ? sz : 1); + if (!p) die_oom(); + return p; +} + +static void *xrealloc(void *p, size_t n) { + p = realloc(p, n ? n : 1); + if (!p) die_oom(); + return p; +} + +static char *xstrdup(const char *s) { + size_t n = strlen(s); + char *p = xmalloc(n + 1); + memcpy(p, s, n + 1); + return p; +} + +static char *xstrndup(const char *s, size_t n) { + char *p = xmalloc(n + 1); + memcpy(p, s, n); + p[n] = '\0'; + return p; +} + +static uint64_t mstime(void) { + struct timespec ts; + if (clock_gettime(CLOCK_MONOTONIC, &ts) == 0) + return (uint64_t)ts.tv_sec * 1000u + (uint64_t)ts.tv_nsec / 1000000u; + struct timeval tv; + gettimeofday(&tv, NULL); + return (uint64_t)tv.tv_sec * 1000u + (uint64_t)tv.tv_usec / 1000u; +} + +static uint64_t nstime(void) { + struct timespec ts; + if (clock_gettime(CLOCK_MONOTONIC, &ts) == 0) + return (uint64_t)ts.tv_sec * 1000000000u + (uint64_t)ts.tv_nsec; + struct timeval tv; + gettimeofday(&tv, NULL); + return (uint64_t)tv.tv_sec * 1000000000u + (uint64_t)tv.tv_usec * 1000u; +} + +static double ns_to_ms(uint64_t ns) { + return (double)ns / 1000000.0; +} + +static void server_log(const char *fmt, ...) { + char ts[32]; + time_t now = time(NULL); + struct tm tmv; + localtime_r(&now, &tmv); + strftime(ts, sizeof(ts), "%m%d %H:%M:%S", &tmv); + fprintf(stderr, "%s ", ts); + va_list ap; + va_start(ap, fmt); + vfprintf(stderr, fmt, ap); + va_end(ap); + fputc('\n', stderr); +} + +static void sbuf_reserve(sbuf *b, size_t add) { + if (add > SIZE_MAX - b->len - 1) die_oom(); + size_t need = b->len + add + 1; + if (need <= b->cap) return; + size_t cap = b->cap ? b->cap * 2 : 256; + while (cap < need) { + if (cap > SIZE_MAX / 2) die_oom(); + cap *= 2; + } + b->ptr = xrealloc(b->ptr, cap); + b->cap = cap; +} + +static void sbuf_append(sbuf *b, const void *p, size_t n) { + sbuf_reserve(b, n); + memcpy(b->ptr + b->len, p, n); + b->len += n; + b->ptr[b->len] = '\0'; +} + +static void sbuf_putc(sbuf *b, char c) { sbuf_append(b, &c, 1); } +static void sbuf_puts(sbuf *b, const char *s) { sbuf_append(b, s, strlen(s)); } + +static void sbuf_clear(sbuf *b) { + b->len = 0; + if (b->ptr) b->ptr[0] = '\0'; +} + +static void sbuf_printf(sbuf *b, const char *fmt, ...) { + va_list ap, ap2; + va_start(ap, fmt); + va_copy(ap2, ap); + int n = vsnprintf(NULL, 0, fmt, ap); + va_end(ap); + if (n < 0) die_oom(); + sbuf_reserve(b, (size_t)n); + int n2 = vsnprintf(b->ptr + b->len, b->cap - b->len, fmt, ap2); + va_end(ap2); + if (n2 < 0 || n2 != n) die_oom(); + b->len += (size_t)n; +} + +static void sbuf_free(sbuf *b) { + free(b->ptr); + memset(b, 0, sizeof(*b)); +} + +typedef enum { + MODEL_STD_06, + MODEL_STD_4, + MODEL_CTX_06, + MODEL_CTX_4, + MODEL_UNKNOWN +} model_slot; + +typedef struct { + const char *id; + int is_contextual; + int dim; + double price_per_mtok; +} model_info; + +static const model_info k_models[] = { + {"pplx-embed-v1-0.6b", 0, 1024, 0.004}, + {"pplx-embed-v1-4b", 0, 2560, 0.030}, + {"pplx-embed-context-v1-0.6b", 1, 1024, 0.008}, + {"pplx-embed-context-v1-4b", 1, 2560, 0.050}, +}; + +static model_slot model_slot_for_id(const char *id) { + if (!id) return MODEL_UNKNOWN; + for (int i = 0; i < 4; i++) { + if (!strcmp(id, k_models[i].id)) return (model_slot)i; + } + return MODEL_UNKNOWN; +} + +typedef struct { + const model_info *info; + char *path; + qwen_tokenizer_t *tok; + qwen_tokenizer_workspace_t *tok_ws; + int context_separator_id; + pplx_model_t *cpu_model; + pplx_workspace_t *cpu_ws; +#ifdef USE_MLX + pplx_mlx_ctx_t *mlx_ctx; +#endif +#ifdef USE_CUDA + pplx_cuda_ctx_t *cuda_ctx; +#endif +} loaded_model; + +typedef struct client client; +typedef struct job job; + +typedef struct { + aeEventLoop *loop; + int listen_fd; + int completion_pipe[2]; + int signal_pipe[2]; + const char *host; + int port; + int batch_size; + int max_batch_tokens; + int batch_wait_us; + int enable_cors; + char *api_key; + loaded_model models[4]; + int use_mlx; + int use_cuda; + int mlx_quantize_bits; + int mlx_quantize_group_size; + + pthread_t worker; + pthread_mutex_t mu; + pthread_cond_t cv; + int stopping; + int worker_ready; + int worker_init_rc; + job *job_head; + job *job_tail; + job *done_head; + job *done_tail; + + client *clients; + int n_clients; +} http_server; + +typedef struct { + char method[8]; + char path[PPLX_HTTP_MAX_PATH + 1]; + char version[16]; + char *body; + size_t body_len; + char *auth; +} http_request; + +struct client { + http_server *srv; + int fd; + int refcount; + int cancelled; + int linked; + uint64_t last_active_ms; + sbuf in; + sbuf out; + size_t sent; + int header_done; + size_t header_len; + size_t content_length; + int close_after_write; + http_request req; + client *prev; + client *next; +}; + +struct job { + http_server *srv; + client *c; + char method[8]; + char path[PPLX_HTTP_MAX_PATH + 1]; + char *body; + size_t body_len; + char *auth; + int status; + char *content_type; + char *extra_headers; + char *response; + size_t response_len; + uint64_t created_ns; + uint64_t started_ns; + uint64_t parse_ns; + uint64_t tokenize_ns; + uint64_t infer_ns; + uint64_t encode_ns; + job *next; +}; + +static int queue_write(client *c); +static void dispatch_request(client *c); +static void read_cb(aeEventLoop *loop, int fd, void *clientData, int mask); + +static volatile sig_atomic_t g_stop_requested = 0; +static volatile sig_atomic_t g_signal_wfd = -1; + +static void stop_signal_handler(int sig) { + (void)sig; + if (g_stop_requested) _exit(130); + int saved = errno; + g_stop_requested = 1; + int fd = (int)g_signal_wfd; + if (fd >= 0) { + const unsigned char byte = 1; + (void)write(fd, &byte, 1); + } + errno = saved; +} + +static int set_nonblock(int fd) { + int flags = fcntl(fd, F_GETFL, 0); + if (flags < 0) return -1; + return fcntl(fd, F_SETFL, flags | O_NONBLOCK); +} + +static void http_request_free(http_request *r) { + free(r->body); + free(r->auth); + memset(r, 0, sizeof(*r)); +} + +static void client_free(client *c) { + if (!c) return; + http_request_free(&c->req); + sbuf_free(&c->in); + sbuf_free(&c->out); + free(c); +} + +static void client_incref(client *c) { + pthread_mutex_lock(&c->srv->mu); + c->refcount++; + pthread_mutex_unlock(&c->srv->mu); +} + +static void client_decref(client *c) { + int free_now = 0; + pthread_mutex_lock(&c->srv->mu); + if (--c->refcount == 0) free_now = 1; + pthread_mutex_unlock(&c->srv->mu); + if (free_now) client_free(c); +} + +static void client_decref_n(client *c, int n) { + int free_now = 0; + if (n <= 0) return; + pthread_mutex_lock(&c->srv->mu); + c->refcount -= n; + if (c->refcount <= 0) free_now = 1; + pthread_mutex_unlock(&c->srv->mu); + if (free_now) client_free(c); +} + +static void client_unlink(client *c) { + http_server *s = c->srv; + if (!c->linked) return; + if (c->prev) c->prev->next = c->next; + else s->clients = c->next; + if (c->next) c->next->prev = c->prev; + c->prev = c->next = NULL; + c->linked = 0; + if (s->n_clients > 0) s->n_clients--; +} + +static int close_client_unlink(client *c) { + if (!c || c->cancelled) return 0; + c->cancelled = 1; + if (c->fd >= 0) { + aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE); + aeDeleteFileEvent(c->srv->loop, c->fd, AE_WRITABLE); + close(c->fd); + c->fd = -1; + } + client_unlink(c); + return 1; +} + +static void close_client(client *c) { + if (!close_client_unlink(c)) return; + client_decref(c); +} + +static void append_http_response_ex(client *c, int status, const char *ctype, + const char *extra_headers, + const char *body, size_t body_len) { + const char *reason = "OK"; + if (status == 204) reason = "No Content"; + else if (status == 400) reason = "Bad Request"; + else if (status == 401) reason = "Unauthorized"; + else if (status == 404) reason = "Not Found"; + else if (status == 405) reason = "Method Not Allowed"; + else if (status == 422) reason = "Unprocessable Entity"; + else if (status == 503) reason = "Service Unavailable"; + else if (status >= 500) reason = "Internal Server Error"; + + sbuf_printf(&c->out, + "HTTP/1.1 %d %s\r\n" + "Content-Length: %zu\r\n" + "Connection: %s\r\n", + status, reason, body_len, + c->close_after_write ? "close" : "keep-alive"); + if (ctype) + sbuf_printf(&c->out, "Content-Type: %s\r\n", ctype); + if (c->srv->enable_cors) { + sbuf_puts(&c->out, "Access-Control-Allow-Origin: *\r\n"); + sbuf_puts(&c->out, "Access-Control-Allow-Headers: authorization, content-type\r\n"); + sbuf_puts(&c->out, "Access-Control-Allow-Methods: POST, OPTIONS\r\n"); + } + if (extra_headers) + sbuf_puts(&c->out, extra_headers); + sbuf_puts(&c->out, "\r\n"); + if (body_len) sbuf_append(&c->out, body, body_len); +} + +static void append_http_response(client *c, int status, const char *ctype, + const char *body, size_t body_len) { + append_http_response_ex(c, status, ctype, NULL, body, body_len); +} + +static void append_json_error(sbuf *b, const char *message, const char *type) { + sbuf_puts(b, "{\"error\":{\"message\":\""); + for (const char *p = message ? message : ""; *p; p++) { + if (*p == '"' || *p == '\\') { + sbuf_putc(b, '\\'); + sbuf_putc(b, *p); + } else { + sbuf_putc(b, *p); + } + } + sbuf_puts(b, "\",\"type\":\""); + sbuf_puts(b, type ? type : "server_error"); + sbuf_puts(b, "\"}}"); +} + +static char *json_error_body(const char *message, const char *type, size_t *len) { + sbuf b = {0}; + append_json_error(&b, message, type); + *len = b.len; + return b.ptr; +} + +static void job_set_error(job *j, int status, const char *message, const char *type) { + free(j->response); + j->status = status; + j->content_type = "application/json"; + j->response = json_error_body(message, type, &j->response_len); +} + +static bool auth_ok(http_server *s, const char *auth) { + if (!s->api_key || !s->api_key[0]) return true; + if (!auth) return false; + const char prefix[] = "Bearer "; + return !strncmp(auth, prefix, sizeof(prefix) - 1) && + !strcmp(auth + sizeof(prefix) - 1, s->api_key); +} + +static ssize_t find_header_end(const char *p, size_t n) { + for (size_t i = 3; i < n; i++) { + if (p[i - 3] == '\r' && p[i - 2] == '\n' && + p[i - 1] == '\r' && p[i] == '\n') + return (ssize_t)(i + 1); + } + for (size_t i = 1; i < n; i++) { + if (p[i - 1] == '\n' && p[i] == '\n') return (ssize_t)(i + 1); + } + return -1; +} + +static char *header_value_dup(const char *h, size_t n, const char *name) { + size_t name_len = strlen(name); + const char *p = h, *end = h + n; + while (p < end) { + const char *line = p; + while (p < end && *p != '\n') p++; + size_t len = (size_t)(p - line); + if (len && line[len - 1] == '\r') len--; + if (len > name_len && !strncasecmp(line, name, name_len) && + line[name_len] == ':') { + const char *v = line + name_len + 1; + while (v < line + len && isspace((unsigned char)*v)) v++; + const char *e = line + len; + while (e > v && isspace((unsigned char)e[-1])) e--; + return xstrndup(v, (size_t)(e - v)); + } + if (p < end) p++; + } + return NULL; +} + +static int header_has_token(const char *value, const char *token) { + size_t token_len = strlen(token); + const char *p = value; + while (p && *p) { + while (*p == ',' || isspace((unsigned char)*p)) p++; + const char *start = p; + while (*p && *p != ',') p++; + const char *end = p; + while (end > start && isspace((unsigned char)end[-1])) end--; + if ((size_t)(end - start) == token_len && + !strncasecmp(start, token, token_len)) + return 1; + } + return 0; +} + +static int parse_request_headers(client *c) { + char line[512]; + size_t i = 0; + while (i < c->header_len && c->in.ptr[i] != '\n' && i + 1 < sizeof(line)) { + line[i] = c->in.ptr[i]; + i++; + } + line[i] = '\0'; + int fields = sscanf(line, "%7s %255s %15s", + c->req.method, c->req.path, c->req.version); + if (fields < 2) + return -1; + if (fields < 3) + snprintf(c->req.version, sizeof(c->req.version), "HTTP/1.0"); + char *q = strchr(c->req.path, '?'); + if (q) *q = '\0'; + + c->close_after_write = strcasecmp(c->req.version, "HTTP/1.1") != 0; + char *conn = header_value_dup(c->in.ptr, c->header_len, "Connection"); + if (conn) { + if (header_has_token(conn, "close")) + c->close_after_write = 1; + else if (header_has_token(conn, "keep-alive")) + c->close_after_write = 0; + free(conn); + } + + char *cl = header_value_dup(c->in.ptr, c->header_len, "Content-Length"); + if (cl) { + char *end = NULL; + errno = 0; + unsigned long long v = strtoull(cl, &end, 10); + if (errno || !end || *end || v > PPLX_HTTP_MAX_BODY) { + free(cl); + return -1; + } + c->content_length = (size_t)v; + free(cl); + } + c->req.auth = header_value_dup(c->in.ptr, c->header_len, "Authorization"); + return 0; +} + +static int complete_request(client *c) { + if (!c->header_done) { + ssize_t hend = find_header_end(c->in.ptr, c->in.len); + if (hend < 0) { + if (c->in.len > PPLX_HTTP_MAX_HEADER) return -1; + return 0; + } + c->header_done = 1; + c->header_len = (size_t)hend; + if (parse_request_headers(c) != 0) return -1; + } + if (c->content_length > PPLX_HTTP_MAX_BODY) return -1; + if (c->in.len < c->header_len + c->content_length) return 0; + c->req.body_len = c->content_length; + c->req.body = xmalloc(c->content_length + 1); + memcpy(c->req.body, c->in.ptr + c->header_len, c->content_length); + c->req.body[c->content_length] = '\0'; + return 1; +} + +static void send_bad_http_request(client *c) { + size_t len; + char *body = json_error_body("bad HTTP request", "invalid_request_error", + &len); + c->close_after_write = 1; + append_http_response(c, 400, "application/json", body, len); + free(body); + aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE); + if (queue_write(c) != AE_OK) close_client(c); +} + +static void reset_client_for_next_request(client *c) { + size_t consumed = c->header_len + c->content_length; + if (consumed > c->in.len) consumed = c->in.len; + size_t remain = c->in.len - consumed; + if (remain) + memmove(c->in.ptr, c->in.ptr + consumed, remain); + c->in.len = remain; + if (c->in.ptr) c->in.ptr[remain] = '\0'; + + http_request_free(&c->req); + sbuf_clear(&c->out); + c->sent = 0; + c->header_done = 0; + c->header_len = 0; + c->content_length = 0; + c->close_after_write = 0; +} + +static void arm_next_request(client *c) { + reset_client_for_next_request(c); + if (c->cancelled || c->fd < 0) return; + + if (c->in.len) { + int done = complete_request(c); + if (done < 0) { + send_bad_http_request(c); + return; + } + if (done > 0) { + dispatch_request(c); + return; + } + } + + if (aeCreateFileEvent(c->srv->loop, c->fd, AE_READABLE, read_cb, c) != AE_OK) + close_client(c); +} + +static void write_cb(aeEventLoop *loop, int fd, void *clientData, int mask) { + (void)loop; (void)mask; + client *c = clientData; + while (c->sent < c->out.len) { + ssize_t n = write(fd, c->out.ptr + c->sent, c->out.len - c->sent); + if (n > 0) { + c->sent += (size_t)n; + c->last_active_ms = mstime(); + continue; + } + if (n < 0 && errno == EINTR) continue; + if (n < 0 && (errno == EAGAIN || errno == EWOULDBLOCK)) return; + close_client(c); + return; + } + aeDeleteFileEvent(c->srv->loop, fd, AE_WRITABLE); + if (c->close_after_write) close_client(c); + else arm_next_request(c); +} + +static int queue_write(client *c) { + if (!c || c->cancelled || c->fd < 0) return -1; + return aeCreateFileEvent(c->srv->loop, c->fd, AE_WRITABLE, write_cb, c); +} + +static void enqueue_done(job *j) { + http_server *s = j->srv; + pthread_mutex_lock(&s->mu); + if (s->done_tail) s->done_tail->next = j; + else s->done_head = j; + s->done_tail = j; + pthread_mutex_unlock(&s->mu); + const unsigned char byte = 1; + (void)write(s->completion_pipe[1], &byte, 1); +} + +static job *dequeue_job(http_server *s) { + pthread_mutex_lock(&s->mu); + while (!s->job_head && !s->stopping) + pthread_cond_wait(&s->cv, &s->mu); + job *j = s->job_head; + if (j) { + s->job_head = j->next; + if (!s->job_head) s->job_tail = NULL; + j->next = NULL; + } + pthread_mutex_unlock(&s->mu); + return j; +} + +static int drain_ready_jobs(http_server *s, job **jobs, int max_jobs) { + int n = 0; + pthread_mutex_lock(&s->mu); + while (n < max_jobs && s->job_head) { + job *j = s->job_head; + s->job_head = j->next; + if (!s->job_head) s->job_tail = NULL; + j->next = NULL; + jobs[n++] = j; + } + pthread_mutex_unlock(&s->mu); + return n; +} + +static void enqueue_job(job *j) { + http_server *s = j->srv; + pthread_mutex_lock(&s->mu); + if (s->job_tail) s->job_tail->next = j; + else s->job_head = j; + s->job_tail = j; + pthread_cond_signal(&s->cv); + pthread_mutex_unlock(&s->mu); +} + +static job *pop_done(http_server *s) { + pthread_mutex_lock(&s->mu); + job *j = s->done_head; + if (j) { + s->done_head = j->next; + if (!s->done_head) s->done_tail = NULL; + j->next = NULL; + } + pthread_mutex_unlock(&s->mu); + return j; +} + +static void job_free(job *j) { + if (!j) return; + free(j->body); + free(j->auth); + free(j->extra_headers); + free(j->response); + free(j); +} + +static void completion_cb(aeEventLoop *loop, int fd, void *clientData, int mask) { + (void)loop; (void)mask; + http_server *s = clientData; + unsigned char tmp[128]; + while (read(fd, tmp, sizeof(tmp)) > 0) {} + + job *j; + while ((j = pop_done(s)) != NULL) { + client *c = j->c; + int refs_to_drop = 1; /* job reference */ + if (!c->cancelled) { + append_http_response_ex(c, j->status, j->content_type, + j->extra_headers, + j->response ? j->response : "", + j->response ? j->response_len : 0); + if (queue_write(c) != AE_OK) + refs_to_drop += close_client_unlink(c); + } + client_decref_n(c, refs_to_drop); + job_free(j); + } +} + +static bool route_is_embedding(const char *method, const char *path) { + return !strcmp(method, "POST") && + (!strcmp(path, "/v1/embeddings") || + !strcmp(path, "/v1/contextualizedembeddings")); +} + +static void dispatch_request(client *c) { + aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE); + + if (!strcmp(c->req.method, "OPTIONS")) { + append_http_response(c, 204, NULL, "", 0); + if (queue_write(c) != AE_OK) close_client(c); + return; + } + + if (!route_is_embedding(c->req.method, c->req.path)) { + size_t len; + char *body = json_error_body("unknown endpoint", "invalid_request_error", &len); + append_http_response(c, 404, "application/json", body, len); + free(body); + if (queue_write(c) != AE_OK) close_client(c); + return; + } + + if (!auth_ok(c->srv, c->req.auth)) { + size_t len; + char *body = json_error_body("missing or invalid bearer token", + "authentication_error", &len); + append_http_response(c, 401, "application/json", body, len); + free(body); + if (queue_write(c) != AE_OK) close_client(c); + return; + } + + job *j = xcalloc(1, sizeof(*j)); + j->srv = c->srv; + j->c = c; + snprintf(j->method, sizeof(j->method), "%s", c->req.method); + snprintf(j->path, sizeof(j->path), "%s", c->req.path); + j->body = xstrndup(c->req.body ? c->req.body : "", c->req.body_len); + j->body_len = c->req.body_len; + j->auth = c->req.auth ? xstrdup(c->req.auth) : NULL; + j->created_ns = nstime(); + client_incref(c); + enqueue_job(j); +} + +static void read_cb(aeEventLoop *loop, int fd, void *clientData, int mask) { + (void)loop; (void)mask; + client *c = clientData; + char tmp[PPLX_HTTP_IO_BUF]; + for (;;) { + ssize_t n = read(fd, tmp, sizeof(tmp)); + if (n > 0) { + sbuf_append(&c->in, tmp, (size_t)n); + c->last_active_ms = mstime(); + int done = complete_request(c); + if (done < 0) { + send_bad_http_request(c); + return; + } + if (done > 0) { + dispatch_request(c); + return; + } + continue; + } + if (n == 0) { + close_client(c); + return; + } + if (errno == EINTR) continue; + if (errno == EAGAIN || errno == EWOULDBLOCK) return; + close_client(c); + return; + } +} + +static void accept_cb(aeEventLoop *loop, int fd, void *clientData, int mask) { + (void)loop; (void)mask; + http_server *s = clientData; + char cip[64]; + int cport = 0; + for (;;) { + int cfd = anetTcpAccept(NULL, fd, cip, sizeof(cip), &cport); + if (cfd == ANET_ERR) { + if (errno == EAGAIN || errno == EWOULDBLOCK) return; + if (errno == EINTR) continue; + return; + } + set_nonblock(cfd); + client *c = xcalloc(1, sizeof(*c)); + c->srv = s; + c->fd = cfd; + c->refcount = 1; + c->last_active_ms = mstime(); + c->linked = 1; + c->next = s->clients; + if (s->clients) s->clients->prev = c; + s->clients = c; + s->n_clients++; + if (aeCreateFileEvent(s->loop, cfd, AE_READABLE, read_cb, c) != AE_OK) + close_client(c); + } +} + +static int timeout_cb(aeEventLoop *loop, long long id, void *clientData) { + (void)loop; (void)id; + http_server *s = clientData; + uint64_t now = mstime(); + client *c = s->clients; + while (c) { + client *next = c->next; + if (!c->cancelled && + now - c->last_active_ms > PPLX_HTTP_CLIENT_TIMEOUT_MS) + close_client(c); + c = next; + } + return PPLX_HTTP_SWEEP_MS; +} + +static void signal_cb(aeEventLoop *loop, int fd, void *clientData, int mask) { + (void)fd; (void)mask; + http_server *s = clientData; + unsigned char tmp[128]; + while (read(s->signal_pipe[0], tmp, sizeof(tmp)) > 0) {} + aeStop(loop); +} + +static bool ve_add(cJSON *detail, const char *loc_json, + const char *msg, const char *type) { + cJSON *obj = cJSON_CreateObject(); + cJSON *loc = cJSON_Parse(loc_json); + if (!obj || !loc) { + cJSON_Delete(obj); + cJSON_Delete(loc); + return false; + } + cJSON_AddItemToObject(obj, "loc", loc); + cJSON_AddStringToObject(obj, "msg", msg ? msg : ""); + cJSON_AddStringToObject(obj, "type", type ? type : ""); + cJSON_AddItemToArray(detail, obj); + return true; +} + +static void job_set_422(job *j, cJSON *detail) { + cJSON *root = cJSON_CreateObject(); + cJSON_AddItemToObject(root, "detail", cJSON_Duplicate(detail, 1)); + char *s = cJSON_PrintUnformatted(root); + cJSON_Delete(root); + if (!s) { + job_set_error(j, 500, "failed to render validation error", "server_error"); + return; + } + j->status = 422; + j->content_type = "application/json"; + j->response = xstrdup(s); + j->response_len = strlen(j->response); + cJSON_free(s); +} + +static void job_set_timing_header(job *j) { + if (!j || j->extra_headers || !j->created_ns) return; + uint64_t done_ns = nstime(); + uint64_t queue_ns = j->started_ns > j->created_ns + ? j->started_ns - j->created_ns : 0; + uint64_t worker_ns = j->started_ns && done_ns > j->started_ns + ? done_ns - j->started_ns : 0; + + char buf[384]; + int n = snprintf(buf, sizeof(buf), + "Server-Timing: queue;dur=%.3f, parse;dur=%.3f, " + "tokenize;dur=%.3f, infer;dur=%.3f, encode;dur=%.3f, " + "worker;dur=%.3f\r\n", + ns_to_ms(queue_ns), ns_to_ms(j->parse_ns), + ns_to_ms(j->tokenize_ns), ns_to_ms(j->infer_ns), + ns_to_ms(j->encode_ns), ns_to_ms(worker_ns)); + if (n > 0 && (size_t)n < sizeof(buf)) + j->extra_headers = xstrdup(buf); +} + +static cJSON *parse_json_body(job *j, cJSON *detail) { + if (!j->body || j->body_len == 0) { + ve_add(detail, "[\"body\"]", "body required", "missing"); + return NULL; + } + const char *end = NULL; + cJSON *root = cJSON_ParseWithLengthOpts(j->body, j->body_len, &end, false); + if (!root) { + ve_add(detail, "[\"body\"]", "invalid JSON", "json_invalid"); + return NULL; + } + const char *body_end = j->body + j->body_len; + while (end && end < body_end && isspace((unsigned char)*end)) end++; + if (!end || end != body_end) { + ve_add(detail, "[\"body\"]", "invalid JSON", "json_invalid"); + cJSON_Delete(root); + return NULL; + } + if (!cJSON_IsObject(root)) { + ve_add(detail, "[\"body\"]", "body must be a JSON object", "type_error.object"); + cJSON_Delete(root); + return NULL; + } + return root; +} + +static bool cjson_is_integer(cJSON *item) { + if (!cJSON_IsNumber(item)) return false; + double d = item->valuedouble; + int i = item->valueint; + return d >= (double)INT_MIN && d <= (double)INT_MAX && d == (double)i; +} + +static const char *encoding_from_root(cJSON *root, cJSON *detail) { + cJSON *encoding = cJSON_GetObjectItemCaseSensitive(root, "encoding_format"); + if (!encoding) return "base64_int8"; + if (!cJSON_IsString(encoding) || !encoding->valuestring) { + ve_add(detail, "[\"body\",\"encoding_format\"]", + "encoding_format must be a string", "type_error.string"); + return "base64_int8"; + } + if (strcmp(encoding->valuestring, "base64_int8") && + strcmp(encoding->valuestring, "base64_binary") && + strcmp(encoding->valuestring, "float")) { + ve_add(detail, "[\"body\",\"encoding_format\"]", + "value is not a valid enum member; permitted: 'base64_int8', 'base64_binary', 'float'", + "enum"); + return "base64_int8"; + } + return encoding->valuestring; +} + +static int dimensions_from_root(cJSON *root, cJSON *detail, int max_dim, + const char *encoding) { + int dims = max_dim; + cJSON *dimensions = cJSON_GetObjectItemCaseSensitive(root, "dimensions"); + if (dimensions) { + if (!cjson_is_integer(dimensions)) { + ve_add(detail, "[\"body\",\"dimensions\"]", "dimensions must be an integer", + "type_error.integer"); + } else { + dims = dimensions->valueint; + if (dims < 128 || dims > max_dim) { + char msg[96]; + snprintf(msg, sizeof(msg), "dimensions must be between 128 and %d", max_dim); + ve_add(detail, "[\"body\",\"dimensions\"]", msg, "value_error.range"); + } + } + } + if (!strcmp(encoding, "base64_binary") && dims % 8 != 0) + ve_add(detail, "[\"body\",\"dimensions\"]", + "dimensions must be divisible by 8 for base64_binary", + "value_error.divisible"); + return dims; +} + +static char *base64_encode(const unsigned char *src, size_t n) { + static const char tbl[] = + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; + size_t out_len = ((n + 2) / 3) * 4; + char *out = xmalloc(out_len + 1); + size_t o = 0; + for (size_t i = 0; i < n; i += 3) { + unsigned v = (unsigned)src[i] << 16; + int remain = (int)(n - i); + if (remain > 1) v |= (unsigned)src[i + 1] << 8; + if (remain > 2) v |= (unsigned)src[i + 2]; + out[o++] = tbl[(v >> 18) & 63]; + out[o++] = tbl[(v >> 12) & 63]; + out[o++] = remain > 1 ? tbl[(v >> 6) & 63] : '='; + out[o++] = remain > 2 ? tbl[v & 63] : '='; + } + out[o] = '\0'; + return out; +} + +static signed char quantize_int8_tanh(float x) { + int v = (int)lrintf(tanhf(x) * 127.0f); + if (v > 127) v = 127; + if (v < -128) v = -128; + return (signed char)v; +} + +static char *encode_embedding(const float *emb, int dims, const char *encoding) { + if (!strcmp(encoding, "base64_binary")) { + size_t bytes = (size_t)dims / 8; + unsigned char *bits = xcalloc(bytes, 1); + for (int i = 0; i < dims; i++) { + if (emb[i] >= 0.0f) + bits[(size_t)i >> 3] |= (unsigned char)(1u << (i & 7)); + } + char *out = base64_encode(bits, bytes); + free(bits); + return out; + } + + signed char *q = xmalloc((size_t)dims); + for (int i = 0; i < dims; i++) + q[i] = quantize_int8_tanh(emb[i]); + char *out = base64_encode((const unsigned char *)q, (size_t)dims); + free(q); + return out; +} + +typedef struct { + int *ids; + int n_tokens; +} token_buf; + +typedef struct { + job *j; + cJSON *root; + loaded_model *model; + int dims; + const char *encoding; + int n_inputs; + token_buf *tokens; + pplx_input_t *inputs; + int total_tokens; + int ready; +} embedding_request; + +typedef struct { + int *ids; + int n_tokens; + pplx_span_t *spans; + int n_spans; +} contextual_doc; + +typedef struct { + job *j; + cJSON *root; + loaded_model *model; + int dims; + const char *encoding; + contextual_doc *docs; + int n_docs; + int total_chunks; + int total_tokens; + int ready; +} contextual_request; + +static void free_token_bufs(token_buf *t, int n) { + if (!t) return; + for (int i = 0; i < n; i++) free(t[i].ids); +} + +static void embedding_request_free(embedding_request *r) { + if (!r) return; + free_token_bufs(r->tokens, r->n_inputs); + free(r->tokens); + free(r->inputs); + if (r->root) cJSON_Delete(r->root); + memset(r, 0, sizeof(*r)); +} + +static void contextual_request_free(contextual_request *r) { + if (!r) return; + for (int i = 0; i < r->n_docs; i++) { + free(r->docs[i].ids); + free(r->docs[i].spans); + } + free(r->docs); + if (r->root) cJSON_Delete(r->root); + memset(r, 0, sizeof(*r)); +} + +static int tokenize_one(loaded_model *m, job *j, const char *text, + token_buf *out) { + memset(out, 0, sizeof(*out)); + uint64_t t0 = nstime(); + out->ids = qwen_tokenizer_encode_with_workspace(m->tok, m->tok_ws, + text, &out->n_tokens); + if (j) j->tokenize_ns += nstime() - t0; + if (!out->ids || out->n_tokens <= 0) { + free(out->ids); + memset(out, 0, sizeof(*out)); + return -1; + } + return 0; +} + +static int model_embed_batch(loaded_model *m, const pplx_input_t *inputs, + int batch, float *out) { +#ifdef USE_MLX + if (m->mlx_ctx) + return pplx_mlx_embed_batch(m->mlx_ctx, inputs, batch, out); +#endif +#ifdef USE_CUDA + if (m->cuda_ctx) + return pplx_cuda_embed_batch(m->cuda_ctx, inputs, batch, out); +#endif + return pplx_model_embed_batch(m->cpu_model, m->cpu_ws, inputs, batch, out); +} + +static int model_embed_spans_batch(loaded_model *m, + const pplx_context_input_t *inputs, + int batch, float *out) { +#ifdef USE_MLX + if (m->mlx_ctx) + return pplx_mlx_embed_spans_batch(m->mlx_ctx, inputs, batch, out); +#endif +#ifdef USE_CUDA + if (m->cuda_ctx) + return pplx_cuda_embed_spans_batch(m->cuda_ctx, inputs, batch, out); +#endif + return pplx_model_embed_spans_batch(m->cpu_model, m->cpu_ws, inputs, batch, + out); +} + +static int model_uses_dense_batches(const loaded_model *m) { +#ifdef USE_MLX + return m->mlx_ctx != NULL; +#else + (void)m; + return 0; +#endif +} + +/* Inputs are sorted by length before chunking. CPU packs real tokens while MLX + * pads each dense row to the longest input in the chunk. */ +static int inference_batch_accepts_input(const loaded_model *m, int batch, + int packed_tokens, int next_tokens, + int max_batch_tokens) { + if (batch == 0) return 1; + if (model_uses_dense_batches(m)) + return next_tokens <= max_batch_tokens / (batch + 1); + return next_tokens <= max_batch_tokens - packed_tokens; +} + +static void append_embedding_object(sbuf *b, int index, const char *embedding) { + sbuf_printf(b, "{\"object\":\"embedding\",\"index\":%d,\"embedding\":\"", index); + sbuf_puts(b, embedding); + sbuf_puts(b, "\"}"); +} + +static void append_float_embedding_object(sbuf *b, int index, + const float *emb, int dims) { + sbuf_printf(b, "{\"object\":\"embedding\",\"index\":%d,\"embedding\":[", index); + for (int i = 0; i < dims; i++) { + if (i) sbuf_putc(b, ','); + float v = (float)quantize_int8_tanh(emb[i]) / 128.0f; + sbuf_printf(b, "%.9g", (double)v); + } + sbuf_puts(b, "]}"); +} + +static void set_response_from_buf(job *j, sbuf *b) { + j->status = 200; + j->content_type = "application/json"; + j->response = b->ptr; + j->response_len = b->len; + memset(b, 0, sizeof(*b)); +} + +static void render_embedding_response(embedding_request *r, const float *embs) { + char **encoded = NULL; + if (strcmp(r->encoding, "float")) { + encoded = xcalloc((size_t)r->n_inputs, sizeof(*encoded)); + for (int i = 0; i < r->n_inputs; i++) + encoded[i] = encode_embedding(embs + (size_t)i * r->model->info->dim, + r->dims, r->encoding); + } + + sbuf b = {0}; + sbuf_puts(&b, "{\"object\":\"list\",\"data\":["); + for (int i = 0; i < r->n_inputs; i++) { + if (i) sbuf_putc(&b, ','); + if (encoded) + append_embedding_object(&b, i, encoded[i]); + else + append_float_embedding_object(&b, i, + embs + (size_t)i * r->model->info->dim, r->dims); + } + double cost = ((double)r->total_tokens / 1000000.0) * + r->model->info->price_per_mtok; + sbuf_printf(&b, + "],\"model\":\"%s\",\"usage\":{\"prompt_tokens\":%d," + "\"total_tokens\":%d,\"cost\":{\"input_cost\":%.10g," + "\"total_cost\":%.10g,\"currency\":\"USD\"}}}", + r->model->info->id, r->total_tokens, r->total_tokens, cost, cost); + set_response_from_buf(r->j, &b); + + for (int i = 0; encoded && i < r->n_inputs; i++) free(encoded[i]); + free(encoded); +} + +static int embedding_request_compatible(const embedding_request *a, + const embedding_request *b) { + return a->ready && b->ready && + a->model == b->model && + a->dims == b->dims && + !strcmp(a->encoding, b->encoding); +} + +typedef struct { + pplx_input_t input; + int output_index; +} embedding_batch_item; + +static int embedding_batch_item_cmp(const void *a, const void *b) { + const embedding_batch_item *ia = a; + const embedding_batch_item *ib = b; + if (ia->input.n_tokens < ib->input.n_tokens) return -1; + if (ia->input.n_tokens > ib->input.n_tokens) return 1; + return ia->output_index - ib->output_index; +} + +static int embedding_request_fits_group(const embedding_request *r, + int group_inputs, int group_tokens, + int max_batch, int max_batch_tokens) { + if (group_inputs == 0) return 1; + return r->n_inputs <= max_batch - group_inputs && + r->total_tokens <= max_batch_tokens - group_tokens; +} + +static void execute_embedding_request_list(embedding_request **reqs, int n_reqs) { + if (n_reqs <= 0) return; + loaded_model *m = reqs[0]->model; + int dim = m->info->dim; + int total_inputs = 0; + for (int i = 0; i < n_reqs; i++) + total_inputs += reqs[i]->n_inputs; + + embedding_batch_item *items = xmalloc((size_t)total_inputs * sizeof(*items)); + float *embs = xmalloc((size_t)total_inputs * dim * sizeof(float)); + + int pos = 0; + for (int i = 0; i < n_reqs; i++) { + for (int k = 0; k < reqs[i]->n_inputs; k++) { + items[pos].input = reqs[i]->inputs[k]; + items[pos].output_index = pos; + pos++; + } + } + qsort(items, (size_t)total_inputs, sizeof(*items), embedding_batch_item_cmp); + + int max_batch = reqs[0]->j->srv->batch_size > 0 + ? reqs[0]->j->srv->batch_size : total_inputs; + if (max_batch > total_inputs) max_batch = total_inputs; + int max_batch_tokens = reqs[0]->j->srv->max_batch_tokens; + pplx_input_t *inputs = xmalloc((size_t)max_batch * sizeof(*inputs)); + float *batch_embs = xmalloc((size_t)max_batch * dim * sizeof(float)); + + int failed = 0; + uint64_t infer_ns = 0; + for (int start = 0; start < total_inputs;) { + int cur = 0; + int tokens = 0; + while (start + cur < total_inputs && cur < max_batch) { + int n_tokens = items[start + cur].input.n_tokens; + if (!inference_batch_accepts_input(m, cur, tokens, n_tokens, + max_batch_tokens)) + break; + inputs[cur] = items[start + cur].input; + tokens += n_tokens; + cur++; + } + uint64_t t0 = nstime(); + int embed_rc = model_embed_batch(m, inputs, cur, batch_embs); + infer_ns += nstime() - t0; + if (embed_rc != 0) { + failed = 1; + break; + } + for (int i = 0; i < cur; i++) + memcpy(embs + (size_t)items[start + i].output_index * dim, + batch_embs + (size_t)i * dim, (size_t)dim * sizeof(float)); + start += cur; + } + + pos = 0; + for (int i = 0; i < n_reqs; i++) { + reqs[i]->j->infer_ns += infer_ns; + if (failed) { + job_set_error(reqs[i]->j, 500, "embedding failed", "server_error"); + } else { + uint64_t t0 = nstime(); + render_embedding_response(reqs[i], embs + (size_t)pos * dim); + reqs[i]->j->encode_ns += nstime() - t0; + } + pos += reqs[i]->n_inputs; + } + + free(batch_embs); + free(inputs); + free(embs); + free(items); +} + +static void render_contextual_response(contextual_request *r, + const float *embs) { + sbuf b = {0}; + sbuf_puts(&b, "{\"object\":\"list\",\"data\":["); + int span_offset = 0; + for (int di = 0; di < r->n_docs; di++) { + if (di) sbuf_putc(&b, ','); + sbuf_printf(&b, "{\"object\":\"list\",\"index\":%d,\"data\":[", di); + for (int ci = 0; ci < r->docs[di].n_spans; ci++) { + if (ci) sbuf_putc(&b, ','); + const float *emb = embs + (size_t)span_offset * r->model->info->dim; + if (!strcmp(r->encoding, "float")) { + append_float_embedding_object(&b, ci, + emb, r->dims); + } else { + char *encoded = encode_embedding(emb, r->dims, r->encoding); + append_embedding_object(&b, ci, encoded); + free(encoded); + } + span_offset++; + } + sbuf_puts(&b, "]}"); + } + sbuf_printf(&b, + "],\"model\":\"%s\",\"usage\":{\"prompt_tokens\":%d,\"total_tokens\":%d}}", + r->model->info->id, r->total_tokens, r->total_tokens); + set_response_from_buf(r->j, &b); +} + +static int contextual_request_compatible(const contextual_request *a, + const contextual_request *b) { + return a->ready && b->ready && + a->model == b->model && + a->dims == b->dims && + !strcmp(a->encoding, b->encoding); +} + +static int contextual_request_fits_group(const contextual_request *r, + int group_docs, int group_tokens, + int max_batch, int max_batch_tokens) { + if (group_docs == 0) return 1; + return r->n_docs <= max_batch - group_docs && + r->total_tokens <= max_batch_tokens - group_tokens; +} + +typedef struct { + pplx_context_input_t input; + int output_span_index; + int order; +} contextual_batch_item; + +static int contextual_batch_item_cmp(const void *a, const void *b) { + const contextual_batch_item *ia = a; + const contextual_batch_item *ib = b; + if (ia->input.input.n_tokens < ib->input.input.n_tokens) return -1; + if (ia->input.input.n_tokens > ib->input.input.n_tokens) return 1; + return ia->order - ib->order; +} + +static void execute_contextual_request_list(contextual_request **reqs, + int n_reqs) { + if (n_reqs <= 0) return; + loaded_model *m = reqs[0]->model; + int dim = m->info->dim; + int total_docs = 0; + int total_chunks = 0; + for (int i = 0; i < n_reqs; i++) { + if (total_docs > INT_MAX - reqs[i]->n_docs || + total_chunks > INT_MAX - reqs[i]->total_chunks) { + for (int k = 0; k < n_reqs; k++) + job_set_error(reqs[k]->j, 500, "contextual batch is too large", + "server_error"); + return; + } + total_docs += reqs[i]->n_docs; + total_chunks += reqs[i]->total_chunks; + } + if ((size_t)total_chunks > SIZE_MAX / (size_t)dim / sizeof(float)) { + for (int i = 0; i < n_reqs; i++) + job_set_error(reqs[i]->j, 500, "contextual batch is too large", + "server_error"); + return; + } + + contextual_batch_item *items = + xmalloc((size_t)total_docs * sizeof(*items)); + float *embs = xmalloc((size_t)total_chunks * dim * sizeof(*embs)); + int pos = 0; + int span_offset = 0; + for (int i = 0; i < n_reqs; i++) { + for (int d = 0; d < reqs[i]->n_docs; d++) { + contextual_doc *doc = &reqs[i]->docs[d]; + items[pos].input.input.ids = doc->ids; + items[pos].input.input.n_tokens = doc->n_tokens; + items[pos].input.spans = doc->spans; + items[pos].input.n_spans = doc->n_spans; + items[pos].output_span_index = span_offset; + items[pos].order = pos; + span_offset += doc->n_spans; + pos++; + } + } + qsort(items, (size_t)total_docs, sizeof(*items), contextual_batch_item_cmp); + + int max_batch = reqs[0]->j->srv->batch_size > 0 + ? reqs[0]->j->srv->batch_size : total_docs; + if (max_batch > total_docs) max_batch = total_docs; + int max_batch_tokens = reqs[0]->j->srv->max_batch_tokens; + pplx_context_input_t *inputs = + xmalloc((size_t)max_batch * sizeof(*inputs)); + float *batch_embs = NULL; + size_t batch_emb_cap = 0; + + int failed = 0; + uint64_t infer_ns = 0; + for (int start = 0; start < total_docs;) { + int cur = 0; + int tokens = 0; + int chunks = 0; + while (start + cur < total_docs && cur < max_batch) { + const pplx_context_input_t *input = &items[start + cur].input; + if (!inference_batch_accepts_input(m, cur, tokens, + input->input.n_tokens, + max_batch_tokens)) + break; + inputs[cur] = *input; + tokens += input->input.n_tokens; + chunks += input->n_spans; + cur++; + } + size_t needed = (size_t)chunks * dim; + if (needed > batch_emb_cap) { + batch_embs = xrealloc(batch_embs, needed * sizeof(*batch_embs)); + batch_emb_cap = needed; + } + uint64_t t0 = nstime(); + int embed_rc = model_embed_spans_batch(m, inputs, cur, batch_embs); + infer_ns += nstime() - t0; + if (embed_rc != 0) { + failed = 1; + break; + } + int batch_span = 0; + for (int i = 0; i < cur; i++) { + int n_spans = inputs[i].n_spans; + memcpy(embs + (size_t)items[start + i].output_span_index * dim, + batch_embs + (size_t)batch_span * dim, + (size_t)n_spans * dim * sizeof(*embs)); + batch_span += n_spans; + } + start += cur; + } + + span_offset = 0; + for (int i = 0; i < n_reqs; i++) { + reqs[i]->j->infer_ns += infer_ns; + if (failed) { + job_set_error(reqs[i]->j, 500, "contextual embedding failed", + "server_error"); + } else { + uint64_t t0 = nstime(); + render_contextual_response(reqs[i], + embs + (size_t)span_offset * dim); + reqs[i]->j->encode_ns += nstime() - t0; + } + span_offset += reqs[i]->total_chunks; + } + + free(batch_embs); + free(inputs); + free(embs); + free(items); +} + +static int validate_common(cJSON *root, cJSON *detail, int expect_context, + loaded_model **out_model, int *out_dims, + const char **out_encoding, http_server *s) { + cJSON *model_item = cJSON_GetObjectItemCaseSensitive(root, "model"); + const char *model_id = NULL; + if (!model_item) { + ve_add(detail, "[\"body\",\"model\"]", "field required", "missing"); + } else if (!cJSON_IsString(model_item) || !model_item->valuestring) { + ve_add(detail, "[\"body\",\"model\"]", "model must be a string", "type_error.string"); + } else { + model_id = model_item->valuestring; + model_slot slot = model_slot_for_id(model_id); + if (slot == MODEL_UNKNOWN || k_models[slot].is_contextual != expect_context) { + ve_add(detail, "[\"body\",\"model\"]", + "value is not a valid enum member for this endpoint", "enum"); + } else { + loaded_model *m = &s->models[slot]; + if (!m->info) { + *out_model = NULL; + } else { + *out_model = m; + } + } + } + const char *enc = encoding_from_root(root, detail); + int max_dim = model_id && model_slot_for_id(model_id) != MODEL_UNKNOWN + ? k_models[model_slot_for_id(model_id)].dim : 2560; + int dims = dimensions_from_root(root, detail, max_dim, enc); + *out_encoding = enc; + *out_dims = dims; + return model_id && model_slot_for_id(model_id) != MODEL_UNKNOWN && + !s->models[model_slot_for_id(model_id)].info ? 503 : 0; +} + +static void prepare_embedding_request(job *j, cJSON *root, http_server *s, + embedding_request *out) { + memset(out, 0, sizeof(*out)); + out->j = j; + out->root = root; + + cJSON *detail = cJSON_CreateArray(); + loaded_model *m = NULL; + int dims = 0; + const char *encoding = NULL; + int unloaded = validate_common(root, detail, 0, &m, &dims, &encoding, s); + out->model = m; + out->dims = dims; + out->encoding = encoding; + + cJSON *input = cJSON_GetObjectItemCaseSensitive(root, "input"); + int n_inputs = 0; + if (!input) { + ve_add(detail, "[\"body\",\"input\"]", "field required", "missing"); + } else if (cJSON_IsString(input)) { + if (!input->valuestring || input->valuestring[0] == '\0') + ve_add(detail, "[\"body\",\"input\"]", "input must not be empty", + "value_error.empty"); + n_inputs = 1; + } else if (cJSON_IsArray(input)) { + n_inputs = cJSON_GetArraySize(input); + if (n_inputs < 1) + ve_add(detail, "[\"body\",\"input\"]", "input must contain at least 1 item", + "value_error.list.min_items"); + else if (n_inputs > PPLX_API_MAX_STANDARD_INPUTS) + ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 512 items", + "value_error.list.max_items"); + cJSON *item; + int i = 0; + cJSON_ArrayForEach(item, input) { + char loc[64]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", i); + if (!cJSON_IsString(item)) { + ve_add(detail, loc, "input item must be a string", "type_error.string"); + } else if (!item->valuestring || item->valuestring[0] == '\0') { + ve_add(detail, loc, "input item must not be empty", "value_error.empty"); + } + i++; + } + } else { + ve_add(detail, "[\"body\",\"input\"]", + "input must be a string or an array of strings", "type_error"); + } + + if (cJSON_GetArraySize(detail) == 0 && unloaded) { + job_set_error(j, 503, "requested model is valid but not loaded", + "model_not_loaded"); + cJSON_Delete(detail); + return; + } + + if (cJSON_GetArraySize(detail) == 0 && m && input) { + out->n_inputs = n_inputs; + out->tokens = xcalloc((size_t)n_inputs, sizeof(*out->tokens)); + out->inputs = xmalloc((size_t)n_inputs * sizeof(*out->inputs)); + + int idx = 0; + if (input && cJSON_IsString(input) && input->valuestring) { + if (tokenize_one(m, j, input->valuestring, &out->tokens[0]) != 0) { + ve_add(detail, "[\"body\",\"input\"]", "tokenization failed", + "value_error.tokenization"); + } else { + out->inputs[0].ids = out->tokens[0].ids; + out->inputs[0].n_tokens = out->tokens[0].n_tokens; + out->total_tokens = out->tokens[0].n_tokens; + if (out->tokens[0].n_tokens > PPLX_API_MAX_ITEM_TOKENS) + ve_add(detail, "[\"body\",\"input\"]", + "input exceeds 32768 token limit", + "value_error.context_length"); + } + } else { + cJSON *item; + cJSON_ArrayForEach(item, input) { + char loc[64]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", idx); + if (!cJSON_IsString(item) || !item->valuestring) { + ve_add(detail, loc, "input item must be a string", + "type_error.string"); + idx++; + continue; + } + if (tokenize_one(m, j, item->valuestring, + &out->tokens[idx]) != 0) { + ve_add(detail, loc, "tokenization failed", + "value_error.tokenization"); + } else { + out->inputs[idx].ids = out->tokens[idx].ids; + out->inputs[idx].n_tokens = out->tokens[idx].n_tokens; + out->total_tokens += out->tokens[idx].n_tokens; + if (out->tokens[idx].n_tokens > PPLX_API_MAX_ITEM_TOKENS) + ve_add(detail, loc, "input exceeds 32768 token limit", + "value_error.context_length"); + } + idx++; + } + } + + if (out->total_tokens > PPLX_API_MAX_TOTAL_TOKENS) + ve_add(detail, "[\"body\",\"input\"]", "request exceeds 120000 token limit", + "value_error.context_length"); + } + + if (cJSON_GetArraySize(detail) > 0) { + job_set_422(j, detail); + embedding_request_free(out); + out->j = j; + } else { + out->ready = 1; + } + cJSON_Delete(detail); +} + +static void prepare_contextual_request(job *j, cJSON *root, http_server *s, + contextual_request *out) { + memset(out, 0, sizeof(*out)); + out->j = j; + out->root = root; + + cJSON *detail = cJSON_CreateArray(); + loaded_model *m = NULL; + int dims = 0; + const char *encoding = NULL; + int unloaded = validate_common(root, detail, 1, &m, &dims, &encoding, s); + out->model = m; + out->dims = dims; + out->encoding = encoding; + + cJSON *input = cJSON_GetObjectItemCaseSensitive(root, "input"); + int n_docs = 0; + int total_chunks = 0; + if (!input) { + ve_add(detail, "[\"body\",\"input\"]", "field required", "missing"); + } else if (!cJSON_IsArray(input)) { + ve_add(detail, "[\"body\",\"input\"]", + "input must be an array of document chunk arrays", "type_error.array"); + } else { + n_docs = cJSON_GetArraySize(input); + if (n_docs < 1) + ve_add(detail, "[\"body\",\"input\"]", "input must contain at least 1 document", + "value_error.list.min_items"); + else if (n_docs > PPLX_API_MAX_CONTEXT_DOCS) + ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 512 documents", + "value_error.list.max_items"); + cJSON *doc_arr; + int di = 0; + cJSON_ArrayForEach(doc_arr, input) { + if (!cJSON_IsArray(doc_arr)) { + char loc[64]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di); + ve_add(detail, loc, "document must be an array of strings", + "type_error.array"); + di++; + continue; + } + int doc_chunks = cJSON_GetArraySize(doc_arr); + if (doc_chunks > PPLX_API_MAX_CONTEXT_CHUNKS - total_chunks) + total_chunks = PPLX_API_MAX_CONTEXT_CHUNKS + 1; + else + total_chunks += doc_chunks; + if (doc_chunks < 1) { + char loc[64]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di); + ve_add(detail, loc, "document must contain at least 1 chunk", + "value_error.list.min_items"); + } + cJSON *chunk; + int ci = 0; + cJSON_ArrayForEach(chunk, doc_arr) { + char loc[80]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d,%d]", di, ci); + if (!cJSON_IsString(chunk)) { + ve_add(detail, loc, "chunk must be a string", "type_error.string"); + } else if (!chunk->valuestring || chunk->valuestring[0] == '\0') { + ve_add(detail, loc, "chunk must not be empty", "value_error.empty"); + } + ci++; + } + di++; + } + if (total_chunks > PPLX_API_MAX_CONTEXT_CHUNKS) + ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 16000 chunks", + "value_error.list.max_items"); + } + + if (cJSON_GetArraySize(detail) == 0 && unloaded) { + job_set_error(j, 503, "requested model is valid but not loaded", + "model_not_loaded"); + cJSON_Delete(detail); + return; + } + + if (cJSON_GetArraySize(detail) == 0 && m) { + out->n_docs = n_docs; + out->docs = xcalloc((size_t)n_docs, sizeof(*out->docs)); + int64_t request_tokens = 0; + cJSON *doc_arr; + int di = 0; + cJSON_ArrayForEach(doc_arr, input) { + contextual_doc *doc = &out->docs[di]; + int n_chunks = cJSON_GetArraySize(doc_arr); + token_buf *chunk_tokens = + xcalloc((size_t)n_chunks, sizeof(*chunk_tokens)); + doc->spans = xcalloc((size_t)n_chunks, sizeof(*doc->spans)); + doc->n_spans = n_chunks; + int64_t doc_tokens = n_chunks > 1 ? n_chunks - 1 : 0; + int doc_valid = 1; + + cJSON *chunk; + int ci = 0; + cJSON_ArrayForEach(chunk, doc_arr) { + char loc[80]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d,%d]", di, ci); + if (tokenize_one(m, j, chunk->valuestring, + &chunk_tokens[ci]) != 0) { + ve_add(detail, loc, "tokenization failed", + "value_error.tokenization"); + doc_valid = 0; + } else { + doc_tokens += chunk_tokens[ci].n_tokens; + } + ci++; + } + + if (doc_tokens > PPLX_API_MAX_ITEM_TOKENS) { + char loc[64]; + snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di); + ve_add(detail, loc, "document exceeds 32768 token limit", + "value_error.context_length"); + doc_valid = 0; + } + request_tokens += doc_tokens; + + if (doc_valid) { + doc->n_tokens = (int)doc_tokens; + doc->ids = xmalloc((size_t)doc->n_tokens * sizeof(*doc->ids)); + int pos = 0; + for (ci = 0; ci < n_chunks; ci++) { + doc->spans[ci].start = pos; + doc->spans[ci].n_tokens = chunk_tokens[ci].n_tokens; + memcpy(doc->ids + pos, chunk_tokens[ci].ids, + (size_t)chunk_tokens[ci].n_tokens * sizeof(*doc->ids)); + pos += chunk_tokens[ci].n_tokens; + if (ci + 1 < n_chunks) { + doc->ids[pos++] = m->context_separator_id; + } + } + } + free_token_bufs(chunk_tokens, n_chunks); + free(chunk_tokens); + di++; + } + if (request_tokens > PPLX_API_MAX_TOTAL_TOKENS) { + ve_add(detail, "[\"body\",\"input\"]", + "request exceeds 120000 token limit", + "value_error.context_length"); + } else { + out->total_tokens = (int)request_tokens; + out->total_chunks = total_chunks; + } + } + + if (cJSON_GetArraySize(detail) > 0) { + job_set_422(j, detail); + contextual_request_free(out); + out->j = j; + } else { + out->ready = 1; + } + cJSON_Delete(detail); +} + +static int parse_job_root(job *j, cJSON **out_root) { + cJSON *detail = cJSON_CreateArray(); + cJSON *root = parse_json_body(j, detail); + if (!root) { + job_set_422(j, detail); + cJSON_Delete(detail); + *out_root = NULL; + return -1; + } + cJSON_Delete(detail); + *out_root = root; + return 0; +} + +static void process_unknown_job(job *j) { + cJSON *root = NULL; + if (!j->started_ns) j->started_ns = nstime(); + uint64_t t0 = nstime(); + int rc = parse_job_root(j, &root); + j->parse_ns += nstime() - t0; + if (rc != 0) + return; + job_set_error(j, 404, "unknown endpoint", "invalid_request_error"); + cJSON_Delete(root); +} + +static void process_job_group(http_server *s, job **jobs, int n_jobs) { + embedding_request *std_reqs = xcalloc((size_t)n_jobs, sizeof(*std_reqs)); + contextual_request *ctx_reqs = xcalloc((size_t)n_jobs, sizeof(*ctx_reqs)); + int *kind = xcalloc((size_t)n_jobs, sizeof(*kind)); + int *done = xcalloc((size_t)n_jobs, sizeof(*done)); + embedding_request **std_group = xmalloc((size_t)n_jobs * sizeof(*std_group)); + contextual_request **ctx_group = xmalloc((size_t)n_jobs * sizeof(*ctx_group)); + + for (int i = 0; i < n_jobs; i++) { + cJSON *root = NULL; + if (!jobs[i]->started_ns) jobs[i]->started_ns = nstime(); + if (!strcmp(jobs[i]->path, "/v1/embeddings")) { + kind[i] = 1; + } else if (!strcmp(jobs[i]->path, "/v1/contextualizedembeddings")) { + kind[i] = 2; + } else { + continue; + } + uint64_t t0 = nstime(); + int parse_rc = parse_job_root(jobs[i], &root); + jobs[i]->parse_ns += nstime() - t0; + if (parse_rc != 0) + continue; + if (kind[i] == 1) + prepare_embedding_request(jobs[i], root, s, &std_reqs[i]); + else + prepare_contextual_request(jobs[i], root, s, &ctx_reqs[i]); + } + + for (int i = 0; i < n_jobs; i++) { + if (done[i]) + continue; + + if (!kind[i]) { + process_unknown_job(jobs[i]); + job_set_timing_header(jobs[i]); + enqueue_done(jobs[i]); + done[i] = 1; + continue; + } + + if ((kind[i] == 1 && !std_reqs[i].ready) || + (kind[i] == 2 && !ctx_reqs[i].ready)) { + job_set_timing_header(jobs[i]); + enqueue_done(jobs[i]); + done[i] = 1; + continue; + } + + if (kind[i] == 1) { + int group_n = 1; + int group_inputs = std_reqs[i].n_inputs; + int group_tokens = std_reqs[i].total_tokens; + std_group[0] = &std_reqs[i]; + for (int k = i + 1; k < n_jobs; k++) { + if (!done[k] && kind[k] == 1 && std_reqs[k].ready && + embedding_request_compatible(&std_reqs[i], &std_reqs[k]) && + embedding_request_fits_group(&std_reqs[k], group_inputs, + group_tokens, s->batch_size, s->max_batch_tokens)) { + std_group[group_n++] = &std_reqs[k]; + group_inputs += std_reqs[k].n_inputs; + group_tokens += std_reqs[k].total_tokens; + } + } + execute_embedding_request_list(std_group, group_n); + for (int k = 0; k < group_n; k++) { + int idx = (int)(std_group[k] - std_reqs); + job_set_timing_header(jobs[idx]); + enqueue_done(jobs[idx]); + done[idx] = 1; + } + } else { + int group_n = 1; + int group_docs = ctx_reqs[i].n_docs; + int group_tokens = ctx_reqs[i].total_tokens; + ctx_group[0] = &ctx_reqs[i]; + for (int k = i + 1; k < n_jobs; k++) { + if (!done[k] && kind[k] == 2 && ctx_reqs[k].ready && + contextual_request_compatible(&ctx_reqs[i], &ctx_reqs[k]) && + contextual_request_fits_group(&ctx_reqs[k], group_docs, + group_tokens, s->batch_size, s->max_batch_tokens)) { + ctx_group[group_n++] = &ctx_reqs[k]; + group_docs += ctx_reqs[k].n_docs; + group_tokens += ctx_reqs[k].total_tokens; + } + } + execute_contextual_request_list(ctx_group, group_n); + for (int k = 0; k < group_n; k++) { + int idx = (int)(ctx_group[k] - ctx_reqs); + job_set_timing_header(jobs[idx]); + enqueue_done(jobs[idx]); + done[idx] = 1; + } + } + } + + for (int i = 0; i < n_jobs; i++) { + embedding_request_free(&std_reqs[i]); + contextual_request_free(&ctx_reqs[i]); + } + free(ctx_group); + free(std_group); + free(done); + free(kind); + free(ctx_reqs); + free(std_reqs); +} + +static void *worker_main(void *arg) { + http_server *s = arg; +#ifdef USE_MLX + if (s->use_mlx) { + int rc = 0; + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (!m->info) continue; + pplx_mlx_options_t mlx_opts = { + .quantize_bits = s->mlx_quantize_bits, + .quantize_group_size = s->mlx_quantize_group_size, + }; + m->mlx_ctx = pplx_mlx_load_with_options(m->path, &mlx_opts); + if (!m->mlx_ctx) { + server_log("pplx-serve: failed to load MLX model on worker: %s", + m->path); + rc = 1; + break; + } + if (pplx_mlx_config(m->mlx_ctx)->hidden_size != m->info->dim) { + server_log("pplx-serve: model %s has unexpected dimension %d", + m->info->id, + pplx_mlx_config(m->mlx_ctx)->hidden_size); + rc = 1; + break; + } + } + pthread_mutex_lock(&s->mu); + s->worker_init_rc = rc; + s->worker_ready = 1; + if (rc) s->stopping = 1; + pthread_cond_broadcast(&s->cv); + pthread_mutex_unlock(&s->mu); + if (rc) { + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (m->mlx_ctx) { + pplx_mlx_free(m->mlx_ctx); + m->mlx_ctx = NULL; + } + } + return NULL; + } + } else +#endif +#ifdef USE_CUDA + if (s->use_cuda) { + int rc = 0; + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (!m->info) continue; + m->cuda_ctx = pplx_cuda_load(m->path); + if (!m->cuda_ctx) { + server_log("pplx-serve: failed to load CUDA model on worker: %s", + m->path); + rc = 1; + break; + } + if (pplx_cuda_config(m->cuda_ctx)->hidden_size != m->info->dim) { + server_log("pplx-serve: model %s has unexpected dimension %d", + m->info->id, + pplx_cuda_config(m->cuda_ctx)->hidden_size); + rc = 1; + break; + } + } + pthread_mutex_lock(&s->mu); + s->worker_init_rc = rc; + s->worker_ready = 1; + if (rc) s->stopping = 1; + pthread_cond_broadcast(&s->cv); + pthread_mutex_unlock(&s->mu); + if (rc) { + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (m->cuda_ctx) { + pplx_cuda_free(m->cuda_ctx); + m->cuda_ctx = NULL; + } + } + return NULL; + } + } else +#endif + { + pthread_mutex_lock(&s->mu); + s->worker_ready = 1; + pthread_cond_broadcast(&s->cv); + pthread_mutex_unlock(&s->mu); + } + + for (;;) { + job *j = dequeue_job(s); + if (!j) break; + job *jobs[PPLX_SERVER_MICROBATCH_MAX_JOBS]; + int n_jobs = 1; + jobs[0] = j; + + if ((!strcmp(j->path, "/v1/embeddings") || + !strcmp(j->path, "/v1/contextualizedembeddings")) && + s->batch_size > 1) { + if (s->batch_wait_us > 0) + usleep((useconds_t)s->batch_wait_us); + n_jobs += drain_ready_jobs(s, jobs + 1, + PPLX_SERVER_MICROBATCH_MAX_JOBS - 1); + } + + process_job_group(s, jobs, n_jobs); + } +#ifdef USE_MLX + if (s->use_mlx) { + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (m->mlx_ctx) { + pplx_mlx_free(m->mlx_ctx); + m->mlx_ctx = NULL; + } + } + } +#endif +#ifdef USE_CUDA + if (s->use_cuda) { + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + if (m->cuda_ctx) { + pplx_cuda_free(m->cuda_ctx); + m->cuda_ctx = NULL; + } + } + } +#endif + return NULL; +} + +static int listen_on(const char *host, int port) { + char portbuf[32]; + snprintf(portbuf, sizeof(portbuf), "%d", port); + char err[ANET_ERR_LEN]; + int fd = anetTcpServer(err, port, (char *)host, PPLX_HTTP_BACKLOG); + (void)portbuf; + if (fd == ANET_ERR) { + server_log("pplx-serve: listen failed on %s:%d: %s", host, port, err); + return -1; + } + set_nonblock(fd); + return fd; +} + +static int load_one_model(http_server *s, model_slot slot, const char *path) { + loaded_model *m = &s->models[slot]; + m->info = &k_models[slot]; + m->path = xstrdup(path); + char vocab_path[1024]; + snprintf(vocab_path, sizeof(vocab_path), "%s/vocab.json", path); + m->tok = qwen_tokenizer_load(vocab_path); + if (!m->tok) { + server_log("pplx-serve: failed to load tokenizer: %s", vocab_path); + return -1; + } + m->tok_ws = qwen_tokenizer_workspace_new(); + if (!m->tok_ws) { + server_log("pplx-serve: failed to allocate tokenizer workspace: %s", + path); + return -1; + } + m->context_separator_id = PPLX_CONTEXT_SEPARATOR_TOKEN_ID; +#ifdef USE_MLX + if (s->use_mlx) { + /* MLX streams are thread-local. The inference worker loads the MLX + * model so all MLX arrays/streams are created, used, and freed by the + * same thread. */ + return 0; + } +#endif +#ifdef USE_CUDA + if (s->use_cuda) { + return 0; + } +#endif + m->cpu_model = pplx_model_load(path); + if (!m->cpu_model) { + server_log("pplx-serve: failed to load model: %s", path); + return -1; + } + m->cpu_ws = pplx_workspace_new(m->cpu_model); + if (!m->cpu_ws) { + server_log("pplx-serve: failed to allocate workspace: %s", path); + return -1; + } + if (pplx_model_config(m->cpu_model)->hidden_size != m->info->dim) { + server_log("pplx-serve: model %s has unexpected dimension %d", + m->info->id, pplx_model_config(m->cpu_model)->hidden_size); + return -1; + } + return 0; +} + +static void free_models(http_server *s) { + for (int i = 0; i < 4; i++) { + loaded_model *m = &s->models[i]; + free(m->path); + if (m->tok_ws) qwen_tokenizer_workspace_free(m->tok_ws); + if (m->tok) qwen_tokenizer_free(m->tok); + if (m->cpu_ws) pplx_workspace_free(m->cpu_ws); + if (m->cpu_model) pplx_model_free(m->cpu_model); +#ifdef USE_MLX + if (m->mlx_ctx) pplx_mlx_free(m->mlx_ctx); +#endif +#ifdef USE_CUDA + if (m->cuda_ctx) pplx_cuda_free(m->cuda_ctx); +#endif + } +} + +static uint64_t physical_memory_nbytes(void) { +#ifdef __APPLE__ + uint64_t bytes = 0; + size_t len = sizeof(bytes); + if (sysctlbyname("hw.memsize", &bytes, &len, NULL, 0) == 0 && + len == sizeof(bytes) && bytes > 0) + return bytes; +#endif + long pages = sysconf(_SC_PHYS_PAGES); + long page_size = sysconf(_SC_PAGESIZE); + if (pages <= 0 || page_size <= 0 || + (uint64_t)pages > UINT64_MAX / (uint64_t)page_size) + return 0; + return (uint64_t)pages * (uint64_t)page_size; +} + +static int validate_model_specs(const pplx_server_config_t *cfg) { + int seen[4] = {0}; + for (int i = 0; i < cfg->n_models; i++) { + const pplx_server_model_spec_t *spec = &cfg->models[i]; + model_slot slot = model_slot_for_id(spec->id); + if (slot == MODEL_UNKNOWN) { + fprintf(stderr, "pplx-serve: unknown model id: %s\n", + spec->id ? spec->id : ""); + return -1; + } + if (!spec->path || !spec->path[0]) { + fprintf(stderr, "pplx-serve: model %s has an empty path\n", + spec->id); + return -1; + } + if (seen[slot]) { + fprintf(stderr, "pplx-serve: duplicate model id: %s\n", spec->id); + return -1; + } + seen[slot] = 1; + } + return 0; +} + +static int mlx_memory_preflight(const pplx_server_config_t *cfg) { + if (!cfg->use_mlx) return 0; + + uint64_t payload = 0; + for (int i = 0; i < cfg->n_models; i++) { + multi_safetensors_t *ms = + multi_safetensors_open(cfg->models[i].path); + size_t model_payload = 0; + if (!ms || multi_safetensors_data_nbytes(ms, &model_payload) != 0) { + multi_safetensors_close(ms); + fprintf(stderr, "pplx-serve: failed to inspect MLX model: %s\n", + cfg->models[i].path); + return -1; + } + multi_safetensors_close(ms); + if ((uint64_t)model_payload > UINT64_MAX - payload) { + fprintf(stderr, "pplx-serve: MLX model payload size overflow\n"); + return -1; + } + payload += (uint64_t)model_payload; + } + + if (payload > UINT64_MAX / PPLX_MLX_RESIDENT_MULTIPLIER) { + fprintf(stderr, "pplx-serve: MLX resident-memory estimate overflow\n"); + return -1; + } + uint64_t estimated = payload * PPLX_MLX_RESIDENT_MULTIPLIER; + uint64_t physical = physical_memory_nbytes(); + if (physical == 0) { + server_log("pplx-serve: warning: could not determine physical memory; " + "skipping MLX memory preflight"); + return 0; + } + double utilization = cfg->memory_utilization > 0.0 + ? cfg->memory_utilization + : PPLX_MLX_MEMORY_BUDGET_PERCENT / 100.0; + uint64_t budget = (uint64_t)((double)physical * utilization); + const double gib = 1024.0 * 1024.0 * 1024.0; + server_log("pplx-serve: MLX memory preflight: %.1f GiB tensors, " + "%.1f GiB estimated resident, %.1f GiB budget " + "(%.2f of physical memory)", + (double)payload / gib, (double)estimated / gib, + (double)budget / gib, utilization); + if (cfg->mlx_quantize_bits) { + server_log("pplx-serve: MLX %d-bit quantization enabled; preflight " + "uses source payload as a conservative peak estimate", + cfg->mlx_quantize_bits); + } + if (estimated <= budget) return 0; + server_log("pplx-serve: refusing MLX model set above the host-memory " + "budget"); + server_log("pplx-serve: use BF16 artifacts, load fewer models, or raise " + "--memory-utilization (values above 1.0 overcommit)"); + return -1; +} + +int pplx_run_server(const pplx_server_config_t *cfg) { + if (!cfg || !cfg->models || cfg->n_models <= 0) { + fprintf(stderr, "pplx-serve: at least one --model MODEL_ID=PATH is required\n"); + return 1; + } + if (validate_model_specs(cfg) != 0 || mlx_memory_preflight(cfg) != 0) + return 1; + + http_server s; + memset(&s, 0, sizeof(s)); + s.host = cfg->host && cfg->host[0] ? cfg->host : "127.0.0.1"; + s.port = cfg->port > 0 ? cfg->port : 8000; + s.batch_size = cfg->batch_size > 0 + ? cfg->batch_size : PPLX_SERVER_DEFAULT_BATCH_SIZE; + s.max_batch_tokens = cfg->max_batch_tokens > 0 + ? cfg->max_batch_tokens : PPLX_SERVER_DEFAULT_MAX_BATCH_TOKENS; + s.batch_wait_us = cfg->batch_wait_us >= 0 + ? cfg->batch_wait_us : PPLX_SERVER_BATCH_WAIT_US; + s.enable_cors = cfg->enable_cors; + s.use_mlx = cfg->use_mlx; + s.use_cuda = cfg->use_cuda; + s.mlx_quantize_bits = cfg->mlx_quantize_bits; + s.mlx_quantize_group_size = cfg->mlx_quantize_group_size > 0 + ? cfg->mlx_quantize_group_size : 64; + if (cfg->api_key && cfg->api_key[0]) + s.api_key = xstrdup(cfg->api_key); + else { + const char *env_key = getenv("PPLX_API_KEY"); + if (env_key && env_key[0]) s.api_key = xstrdup(env_key); + } + + pthread_mutex_init(&s.mu, NULL); + pthread_cond_init(&s.cv, NULL); + + for (int i = 0; i < cfg->n_models; i++) { + model_slot slot = model_slot_for_id(cfg->models[i].id); + if (slot == MODEL_UNKNOWN) { + fprintf(stderr, "pplx-serve: unknown model id: %s\n", cfg->models[i].id); + free_models(&s); + return 1; + } + if (load_one_model(&s, slot, cfg->models[i].path) != 0) { + free_models(&s); + return 1; + } + } + + if (pipe(s.completion_pipe) != 0 || pipe(s.signal_pipe) != 0) { + perror("pipe"); + free_models(&s); + return 1; + } + set_nonblock(s.completion_pipe[0]); + set_nonblock(s.completion_pipe[1]); + set_nonblock(s.signal_pipe[0]); + set_nonblock(s.signal_pipe[1]); + + struct sigaction sa; + memset(&sa, 0, sizeof(sa)); + sa.sa_handler = stop_signal_handler; + sigemptyset(&sa.sa_mask); + sigaction(SIGINT, &sa, NULL); + sigaction(SIGTERM, &sa, NULL); + signal(SIGPIPE, SIG_IGN); + g_signal_wfd = s.signal_pipe[1]; + + s.loop = aeCreateEventLoop(PPLX_HTTP_SETSIZE); + if (!s.loop) { + fprintf(stderr, "pplx-serve: failed to create event loop\n"); + free_models(&s); + return 1; + } + + if (pthread_create(&s.worker, NULL, worker_main, &s) != 0) { + fprintf(stderr, "pplx-serve: failed to start worker\n"); + aeDeleteEventLoop(s.loop); + free_models(&s); + return 1; + } + pthread_mutex_lock(&s.mu); + while (!s.worker_ready) + pthread_cond_wait(&s.cv, &s.mu); + int worker_init_rc = s.worker_init_rc; + pthread_mutex_unlock(&s.mu); + if (worker_init_rc) { + pthread_join(s.worker, NULL); + aeDeleteEventLoop(s.loop); + free_models(&s); + free(s.api_key); + pthread_cond_destroy(&s.cv); + pthread_mutex_destroy(&s.mu); + return 1; + } + + s.listen_fd = listen_on(s.host, s.port); + if (s.listen_fd < 0) { + pthread_mutex_lock(&s.mu); + s.stopping = 1; + pthread_cond_signal(&s.cv); + pthread_mutex_unlock(&s.mu); + pthread_join(s.worker, NULL); + aeDeleteEventLoop(s.loop); + free_models(&s); + return 1; + } + + aeCreateFileEvent(s.loop, s.listen_fd, AE_READABLE, accept_cb, &s); + aeCreateFileEvent(s.loop, s.completion_pipe[0], AE_READABLE, completion_cb, &s); + aeCreateFileEvent(s.loop, s.signal_pipe[0], AE_READABLE, signal_cb, &s); + aeCreateTimeEvent(s.loop, PPLX_HTTP_SWEEP_MS, timeout_cb, &s, NULL); + + server_log("pplx-serve: listening on http://%s:%d", s.host, s.port); + aeMain(s.loop); + + server_log("pplx-serve: shutdown requested"); + if (s.listen_fd >= 0) close(s.listen_fd); + client *c = s.clients; + while (c) { + client *next = c->next; + close_client(c); + c = next; + } + + pthread_mutex_lock(&s.mu); + s.stopping = 1; + pthread_cond_signal(&s.cv); + pthread_mutex_unlock(&s.mu); + pthread_join(s.worker, NULL); + + aeDeleteEventLoop(s.loop); + close(s.completion_pipe[0]); + close(s.completion_pipe[1]); + close(s.signal_pipe[0]); + close(s.signal_pipe[1]); + free_models(&s); + free(s.api_key); + pthread_cond_destroy(&s.cv); + pthread_mutex_destroy(&s.mu); + return 0; +} -- cgit v1.3.1