@migor/agentia 0.9.4 → 0.10.0

package/dist/transport/http-endpoints.js

@@ -0,0 +1,480 @@
+import { parseTraceparent } from '../core/trace.js';
+import { TaskInputError, normalizeMessages } from '../engine/spec.js';
+import { TaskApproveError, TaskCancelError, TaskEventError, TaskQueueFullError, TaskStreamError, } from './async.js';
+import { PARSE_FAILED, RETRY_AFTER_SECONDS, errMessage, headerValue, methodNotAllowed, parseJsonBody, sendInternalError, sendJson, sendPrometheus, sendShuttingDown, } from './http-io.js';
+import { parseApproveBody, parseEventBody, toHttpBody, toTaskSubmitBody } from './http-shapes.js';
+import { sseWriter } from './sse.js';
+/**
+ * **派发表**：`HttpRoute` 的每个 kind → 谁来做。
+ *
+ * 免鉴权组（`healthz` / `metrics`）与它们的 405 也在这张表里 —— 调用方
+ * （`http.ts` 的 `handler`）只在**调用本函数之前**决定要不要过鉴权闸，
+ * 表本身不认识「鉴权」这回事（见文件头注的分界）。
+ *
+ * `case` 顺序在这里**没有语义**（不像 `http-route.ts` 那边顺序即全部内容）：
+ * `kind` 已经是一个被判定完的判别联合成员，落到这里只剩「谁接」。
+ * 这点值得单独说：**判定与派发是两件事**，把顺序陷阱留在判定那一侧，
+ * 才能让这张表纯粹到「读一眼就是全部」。
+ *
+ * 末尾 `default` 是**编译期穷尽性断言**：12 个 kind 全被 `case` 覆盖后
+ * `route` 收窄为 `never`，新增成员即 TS2322 —— 而不是被静默吞成 404。
+ * （拆分前这里是 `const residual: 'healthz' | 'metrics' | 'notFound' = route.kind`：
+ * 因为免鉴权组在上游提前 return 了，只能断言「剩下的只可能是这三个」。现在 12 条
+ * 全在一张表里，断言可以更强、也不必再解释「前两个已经回过了」。）
+ */
+export async function handleRoute(route, ctx) {
+    switch (route.kind) {
+        case 'healthz':
+            return handleHealthz(ctx);
+        case 'metrics':
+            return handleMetrics(ctx);
+        case 'methodNotAllowed':
+            return methodNotAllowed(ctx.res, ctx.method, route.allowed);
+        case 'run':
+            return handleRun(ctx);
+        case 'submit':
+            return handleSubmit(ctx);
+        case 'approve':
+            return handleApprove(route.taskId, ctx);
+        case 'poll':
+            return handlePoll(route.taskId, ctx);
+        case 'cancel':
+            return handleCancel(route.taskId, ctx);
+        case 'taskEvent':
+            return handleTaskEvent(route.taskId, ctx);
+        case 'taskStream':
+            return handleTaskStream(route.taskId, ctx);
+        case 'badTaskId':
+            // 残缺的 % 转义会抛 URIError —— 是调用方的输入问题（400），不是服务端 500
+            return sendJson(ctx.res, 400, { error: 'taskId 不是合法的 URL 编码' });
+        case 'notFound':
+            return sendJson(ctx.res, 404, { error: `路径不存在: ${ctx.pathname}` });
+        default: {
+            const _never = route;
+            void _never;
+        }
+    }
+}
+// ────────────────────────────────────────────────────────────────────────────
+// 免鉴权组：探针与指标抓取（不鉴权、停机中也照回），以及它们的 405
+// ────────────────────────────────────────────────────────────────────────────
+/** GET /healthz：进程活着就回 200；就绪与否看 `draining`，在飞口径见 `HealthResponse` */
+function handleHealthz(ctx) {
+    const { res, runner, state, startedAt } = ctx;
+    sendJson(res, 200, {
+        ok: true,
+        inFlight: state.inFlightRuns + runner.inFlight,
+        uptimeMs: Date.now() - startedAt,
+        draining: state.draining,
+        // 挂起读数（配套 6）：在飞 ≠ 在等 —— 「几条在睡、最早什么时候醒」是运维要看的那半
+        suspended: runner.suspendedSummary,
+    });
+}
+/**
+ * GET /metrics（G4）：输出提供者 `render()` 的文本，与 `/healthz` 同档（不鉴权、
+ * 停机中仍可拉 —— 抓取端在集群内网）。
+ *
+ * `?.` 只为让类型收窄（这条分支只在配了 metrics 出口时可达），行为与原来一致。
+ * Content-Type 跟提供者走：metricsSink 在 openmetrics 模式下会声明
+ * `application/openmetrics-text`（带 exemplar 的文本拿 0.0.4 的头去发，
+ * 严格抓取端会解析失败）；纯函数形态的提供者没有这个字段 ⇒ 回落 0.0.4。
+ */
+function handleMetrics(ctx) {
+    const provider = ctx.metrics;
+    sendPrometheus(ctx.res, typeof provider === 'function' ? provider() : (provider?.render() ?? ''), typeof provider === 'function' ? undefined : provider?.contentType);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// 同步 RPC
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * POST /run：同步 RPC。body = `RunInput`（string / messages / `{prompt|text|messages}`），
+ * 走 `normalizeMessages` 规整后同步执行。
+ *
+ * 两个出口：
+ * - `Accept: text/event-stream` ⇒ SSE 逐帧下发（`text.delta` / `trace.event` /
+ *   `run.end`，异常时 `error`）；
+ * - 其余 ⇒ 一元 JSON（旧行为逐字不变）。
+ *
+ * 状态码：输入无法规整为 messages → 400；并发 run 超 `maxConcurrentRuns` → 503 +
+ * `Retry-After`；`status=failed` **也照返 200**（`rethrow:false` 语义：硬失败以
+ * `error` 字段返回，不用 HTTP 错误码表达）。
+ */
+async function handleRun(ctx) {
+    const { req, res, app, state, maxConcurrentRuns, sseMaxBufferedBytes } = ctx;
+    if (state.draining) {
+        sendShuttingDown(req, res);
+        return;
+    }
+    const input = await parseJsonBody(req, res, ctx.maxBodyBytes);
+    if (input === PARSE_FAILED)
+        return;
+    let messages;
+    try {
+        messages = normalizeMessages(input);
+    }
+    catch (e) {
+        sendJson(res, 400, { error: errMessage(e) });
+        return;
+    }
+    // 并发闸门：body 已读完（连接可复用），只是暂时不给跑 —— 回 503 让调用方退避重试
+    if (state.inFlightRuns >= maxConcurrentRuns) {
+        res.setHeader('retry-after', RETRY_AFTER_SECONDS);
+        sendJson(res, 503, {
+            error: `并发 run 已达上限 ${maxConcurrentRuns}，请稍后重试`,
+        });
+        return;
+    }
+    state.inFlightRuns++;
+    // 客户端中途断开 → 中止本次 run（省 token）。res 'close' 正常结束也会触发，
+    // 故以 writableEnded 区分：只有响应还没写完才算「断开」。
+    const runAc = new AbortController();
+    const onClose = () => {
+        if (!res.writableEnded)
+            runAc.abort();
+    };
+    res.once('close', onClose);
+    // 内容协商：`Accept: text/event-stream` → SSE 逐帧下发；否则一元 JSON（旧行为逐字不变）
+    const wantsSse = String(req.headers.accept ?? '').includes('text/event-stream');
+    // 入站链路（spec §9.2）：W3C `traceparent` 头 → run 根的 links。
+    // 畸形/缺头一律静默当作「没有上游上下文」（parseTraceparent 统一判定）——
+    // 链路是观测行为，不该因为一个坏头把业务请求打成 400。
+    const traceContext = parseTraceparent(headerValue(req, 'traceparent'));
+    try {
+        if (wantsSse) {
+            const sse = sseWriter(res, {
+                maxBufferedBytes: sseMaxBufferedBytes,
+                // 下游积压超限 → 收口并中止本次 run（见 sseWriter 的背压说明）
+                onBackpressure: () => runAc.abort(),
+            });
+            const heartbeat = setInterval(() => sse.comment('ping'), 15_000);
+            heartbeat.unref?.();
+            // 登记收口函数：drain 时强制关闭（SSE 是长连，不关会把进程吊住）。
+            // 收口必须同时 abort 对应 run：sse.close() → res.end() 后 writableEnded 同步
+            // 变 true，上面的 onClose 守卫（`!writableEnded`）在 close 事件时不成立，
+            // 只 close 不 abort 会让 run 在后台继续烧 token（与背压收口路径的
+            // onBackpressure → abort 对齐；run 已正常结束时 abort 是无害 no-op）。
+            const closeSse = () => {
+                clearInterval(heartbeat);
+                runAc.abort();
+                sse.close();
+            };
+            // `cutsRun: true` —— 收口连带中止本次 run（见 `OpenSseHandle`：drain 的返回值靠它如实）
+            const sseHandle = { close: closeSse, cutsRun: true };
+            state.openSse.add(sseHandle);
+            try {
+                // rethrow:false —— 与 AsyncRunner 对齐：硬失败也以 run.end 下发（status/error 字段）
+                const out = await app.run(messages, {
+                    rethrow: false,
+                    signal: runAc.signal,
+                    onText: (delta) => sse.event('text.delta', { text: delta }),
+                    // 增量记账出口（F3 当初判「架构代价大、后置」的那半）：既有三帧
+                    //（text.delta / run.end / error）逐字不变，这里只**追加**一族帧 ——
+                    // 不认识 `trace.event` 的老客户端行为零变化。
+                    // 帧名取一族（body 里的 type 区分）而不是每类型一帧：将来加新事件类型时，
+                    // 老客户端只是漏掉一种 type，而不是漏掉一种**帧名**（后者更隐蔽）。
+                    onTraceEvent: (e) => sse.event('trace.event', e),
+                    ...(traceContext !== undefined ? { traceContext } : {}),
+                });
+                sse.event('run.end', toHttpBody(out));
+            }
+            catch (e) {
+                // 流已开（200 与头已发出）→ 只能以 error 事件收尾，不能再改 HTTP 状态码
+                sse.event('error', { message: errMessage(e) });
+            }
+            finally {
+                state.openSse.delete(sseHandle);
+                closeSse();
+            }
+            return;
+        }
+        // rethrow:false —— 与 AsyncRunner 对齐：硬失败也以 status/error 字段返回 200
+        const out = await app.run(messages, {
+            rethrow: false,
+            signal: runAc.signal,
+            ...(traceContext !== undefined ? { traceContext } : {}),
+        });
+        sendJson(res, 200, toHttpBody(out));
+    }
+    finally {
+        res.off('close', onClose);
+        state.inFlightRuns--;
+    }
+}
+/**
+ * POST /tasks：异步任务。body `{ input, idempotencyKey?, options? }`
+ * → `runner.submit` → 202 `TaskRecord`（queued，幂等键去重照常生效）。
+ */
+async function handleSubmit(ctx) {
+    const { req, res, runner, state } = ctx;
+    // 停机中不再接单（含直接 drain 了 runner 的情况）；GET /tasks/<id> 不受影响
+    if (state.draining || runner.isDraining) {
+        sendShuttingDown(req, res);
+        return;
+    }
+    const body = await parseJsonBody(req, res, ctx.maxBodyBytes);
+    if (body === PARSE_FAILED)
+        return;
+    const submitBody = toTaskSubmitBody(body);
+    if (!submitBody) {
+        sendJson(res, 400, { error: 'body 需为 { input, idempotencyKey?, options? }' });
+        return;
+    }
+    // 入站链路（spec §9.2）：body 显式给的 `options.traceContext` 优先，否则取
+    // `traceparent` 头。它随 `spec.options` 落进 TaskRecord —— 所以**跨进程续跑**
+    // 的那次 run（另一个进程 `resumePending` 接着跑）也带得上，关联不断链。
+    const submitTrace = parseTraceparent(headerValue(req, 'traceparent'));
+    let rec;
+    try {
+        rec = runner.submit(submitBody.input, {
+            ...(submitBody.idempotencyKey !== undefined
+                ? { idempotencyKey: submitBody.idempotencyKey }
+                : {}),
+            options: submitBody.options?.traceContext !== undefined
+                ? submitBody.options
+                : {
+                    ...submitBody.options,
+                    ...(submitTrace !== undefined ? { traceContext: submitTrace } : {}),
+                },
+            source: 'http',
+        });
+    }
+    catch (e) {
+        // `submit` 是同步的：入参校验失败与 store 落库故障从同一个 catch 出去。
+        // 前者是调用方的错（400 + 原因），后者是服务端的错 —— 必须走与 500 路径同一套
+        // `exposeErrors` 策略，否则一次磁盘/Redis 故障会被报成「你参数写错了」，
+        // 并把内部错误消息原样回给调用方（500/401 路径都不这么干）。
+        if (e instanceof TaskInputError) {
+            sendJson(res, 400, { error: errMessage(e) });
+            return;
+        }
+        // 排队段满（T5）：**不是**调用方的错，回 503 让它退避重试 —— 与 `maxConcurrentRuns`
+        // 那一支同款（同一种情况在「已跑满」与「排满了」两个阶段各有一道闸，状态码就该一致）。
+        // 放在 `TaskInputError` 之后：入参不合法仍是 400（那是它能自己修好的），
+        // 排在 `isDraining` 之前：停机文案说「服务正在优雅停机」，而这条说的是「排队满了」——
+        // 两句话对运维的指示不同（前者别再来，后者稍后再来），不能混成一句。
+        if (e instanceof TaskQueueFullError) {
+            res.setHeader('retry-after', RETRY_AFTER_SECONDS);
+            sendJson(res, 503, { error: errMessage(e) });
+            return;
+        }
+        // 上面的停机闸门与 `submit` 之间隔着一次 `await parseJsonBody`：读 body 期间
+        // drain 可能刚开始，此时 submit 抛「正在优雅停机」。这是 503 而不是 500 ——
+        // 调用方应该退避重试，跟闸门本身回的是同一句话。
+        if (runner.isDraining) {
+            sendShuttingDown(req, res);
+            return;
+        }
+        sendInternalError(res, e, ctx.exposeErrors);
+        return;
+    }
+    sendJson(res, 202, rec);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// 任务控制面（四条：approve / poll / cancel / events —— 停机中仍可用）
+//
+// 它们与 POST /run、POST /tasks 的关键差别是：**停机窗口里照常受理**。
+// 理由是同一个 —— 挂起的任务只有人能推进（approve / events），而停机窗口正是
+// 最想取消在飞任务的时候（cancel）；GET 轮询更是调用方拿回在飞任务结果的唯一途径。
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * POST /tasks/<id>/approve（HITL）：审批挂起的任务。body
+ * `{ decisions: { <tool_use_id>: { approved, reason? } }, decidedBy? }`。
+ * 任务不存在 → 404；不在 suspended 状态 → 409；body 非法 → 400。
+ */
+async function handleApprove(taskId, ctx) {
+    const { req, res, runner } = ctx;
+    const body = await parseJsonBody(req, res, ctx.maxBodyBytes);
+    if (body === PARSE_FAILED)
+        return;
+    const parsed = parseApproveBody(body);
+    if (!parsed) {
+        sendJson(res, 400, {
+            error: 'body 需为 { decisions: { <tool_use_id>: { approved: boolean, reason?: string } }, decidedBy?: string }',
+        });
+        return;
+    }
+    try {
+        const rec = await runner.approve(taskId, parsed.decisions, parsed.decidedBy !== undefined ? { decidedBy: parsed.decidedBy } : {});
+        sendJson(res, 200, rec);
+    }
+    catch (e) {
+        // 404（任务不存在）/ 409（状态不对）是调用方语义；其余按内部错误处理
+        if (e instanceof TaskApproveError) {
+            sendJson(res, e.status, { error: errMessage(e) });
+            return;
+        }
+        sendInternalError(res, e, ctx.exposeErrors);
+    }
+}
+/** GET /tasks/<id>：轮询任务记录 → 200 `TaskRecord`；不存在 → 404。停机中照常可轮询 */
+async function handlePoll(taskId, ctx) {
+    const rec = await ctx.runner.poll(taskId); // MaybePromise：异步 store 下必须 await
+    if (!rec) {
+        sendJson(ctx.res, 404, { error: `task 不存在: ${taskId}` });
+        return;
+    }
+    sendJson(ctx.res, 200, rec);
+}
+/**
+ * POST /tasks/<id>/cancel：取消一个任务（在跑的真中断 / 在睡的不再醒 / 在排队的绝不起跑）。
+ * 无 body。不存在 → 404；已终态、或在跑的 run 不在本进程 → 409。
+ */
+async function handleCancel(taskId, ctx) {
+    try {
+        const rec = await ctx.runner.cancel(taskId); // MaybePromise：异步 store 下必须 await
+        sendJson(ctx.res, 200, rec);
+    }
+    catch (e) {
+        // 404（不存在）/ 409（已终态、或在跑的 run 不在本进程）是调用方语义
+        if (e instanceof TaskCancelError) {
+            sendJson(ctx.res, e.status, { error: errMessage(e) });
+            return;
+        }
+        sendInternalError(ctx.res, e, ctx.exposeErrors);
+    }
+}
+/**
+ * POST /tasks/<id>/events（run 事件投入口，2026-09-28 ⑥）：投一个事件给挂起的任务
+ * —— 事件落 `pendingEvents`、状态回 running，先落库再派发，醒来进消息历史。
+ * body `{ eventId?, type, payload }`（白名单，全是字符串，多一个字段 → 400）；
+ * 不存在 → 404；不在 suspended 状态、或同 eventId 重复投递 → 409。
+ */
+async function handleTaskEvent(taskId, ctx) {
+    const { req, res, runner } = ctx;
+    const body = await parseJsonBody(req, res, ctx.maxBodyBytes);
+    if (body === PARSE_FAILED)
+        return;
+    const event = parseEventBody(body);
+    if (!event) {
+        sendJson(res, 400, {
+            error: 'body 需为 { eventId?: string, type: string, payload: string }（白名单：多一个字段即拒）',
+        });
+        return;
+    }
+    try {
+        const rec = await runner.signalTask(taskId, event);
+        sendJson(res, 200, rec);
+    }
+    catch (e) {
+        // 404（不存在）/ 409（不在挂起态、同 eventId 重复投递）是调用方语义
+        if (e instanceof TaskEventError) {
+            sendJson(res, e.status, { error: errMessage(e) });
+            return;
+        }
+        sendInternalError(res, e, ctx.exposeErrors);
+    }
+}
+/**
+ * GET /tasks/<id>/stream：订阅某任务的记账事件流（SSE）。帧名与语义见
+ * `docs/usage-guide.md §7`：`trace.event`（带 SSE `id:` 供断线续订）、
+ * `stream.truncated` / `stream.unavailable` / `stream.closed` / `task.end`。
+ *
+ * 与 `/run` 的 SSE 那条**气质不同**（背压时处置相反）：
+ * 这条流的读者是**旁观者**，所以背压只收口本流（不 abort 任务）——
+ * 任务不该因为看的人慢而变慢。
+ */
+async function handleTaskStream(taskId, ctx) {
+    const { req, res, runner, state, sseMaxBufferedBytes } = ctx;
+    // 先查一次记录：任务不存在要回 **404**，而 SSE 一旦写出响应头状态码就定死 200 了
+    //（见 sse.ts 的语义约束），所以「存不存在」必须在建流之前问。
+    const known = await runner.poll(taskId);
+    if (!known) {
+        sendJson(res, 404, { error: `task 不存在: ${taskId}` });
+        return;
+    }
+    // 续订锚点：SSE 标准头 `Last-Event-ID` 优先，其次 `?from=`（非 EventSource 的客户端用）
+    const fromRaw = headerValue(req, 'last-event-id') ??
+        new URL(req.url ?? '/', 'http://localhost').searchParams.get('from');
+    const from = fromRaw === null || fromRaw === undefined ? undefined : Number(fromRaw);
+    let unsubscribe = () => { };
+    let finished = false;
+    let heartbeat;
+    // 登记的收口句柄（下面三处 add / delete 都用**同一个对象**）：`closeStream` 自己也要把
+    // 这条从 openSse 摘掉（客户端断连、任务终态、背压都走它）。句柄先声明、赋值在 add 处 ——
+    // `closeStream` 只会在 `runner.streamTask`（本函数尾部）之后被调用，那时它一定已就位。
+    let sseHandle;
+    const closeStream = () => {
+        if (finished)
+            return;
+        finished = true;
+        if (heartbeat)
+            clearInterval(heartbeat);
+        unsubscribe();
+        if (sseHandle !== undefined)
+            state.openSse.delete(sseHandle);
+        sse.close();
+    };
+    const sse = sseWriter(res, {
+        maxBufferedBytes: sseMaxBufferedBytes,
+        // ⚠️ 背压**不 abort 任务**：这条流的读者是**旁观者**，任务不该因为看的人慢而变慢。
+        //（对比 /run 的 SSE：那里的下游就是 run 的所有者，背压等于「别继续烧 token 了」。）
+        onBackpressure: () => closeStream(),
+    });
+    heartbeat = setInterval(() => sse.comment('ping'), 15_000);
+    heartbeat.unref?.();
+    // 登记收口函数：drain 时强制关闭（SSE 是长连，不关会把进程吊住）。
+    // `cutsRun: false` —— 关掉本流只是旁观者退订，**不**中止任务、也不损失工作（见 `OpenSseHandle`）
+    sseHandle = { close: closeStream, cutsRun: false };
+    state.openSse.add(sseHandle);
+    // 客户端断开 ⇒ 退订（不退订订阅者会一直挂在 runner 的表里）
+    res.once('close', () => {
+        if (!res.writableEnded)
+            closeStream();
+    });
+    const write = (frame) => {
+        if (finished)
+            return;
+        switch (frame.type) {
+            case 'trace':
+                // 帧名一族 + SSE `id:` 给流序号 ⇒ 断线重连带 Last-Event-ID 就能续上
+                sse.event('trace.event', frame.event, String(frame.index));
+                return;
+            case 'truncated':
+                sse.event('stream.truncated', { droppedBefore: frame.droppedBefore });
+                return;
+            case 'unavailable':
+                sse.event('stream.unavailable', { reason: frame.reason });
+                return;
+            case 'closed':
+                // 流级收尾（任务未终态，见 TaskStreamFrame）：帧先发出去再关连接 ——
+                // 客户端据此知道「没有更多帧了，去轮询」，而不是对着断线猜
+                sse.event('stream.closed', { reason: frame.reason });
+                closeStream();
+                return;
+            case 'end':
+                sse.event('task.end', frame.record);
+                closeStream();
+                return;
+            default: {
+                // 编译期穷尽性断言：`TaskStreamFrame` 新增成员时这里会编译失败，
+                // 而不是被静默丢掉 —— 静默丢帧的客户端只会对着流干等，最后靠超时猜。
+                const _never = frame;
+                void _never;
+            }
+        }
+    };
+    try {
+        const off = await runner.streamTask(taskId, write, from !== undefined ? { from } : {});
+        // 重放阶段就可能已收口（终态任务）：那时 finished 为真，别再登记退订
+        if (finished)
+            off();
+        else
+            unsubscribe = off;
+    }
+    catch (e) {
+        if (e instanceof TaskStreamError) {
+            // 理论上不可达（上面已查过存在性），但保留这条：状态码还没写出去就还能回 404
+            if (!res.headersSent) {
+                sendJson(res, e.status, { error: errMessage(e) });
+            }
+            else {
+                sse.event('error', { message: errMessage(e) });
+                closeStream();
+            }
+            return;
+        }
+        sse.event('error', { message: errMessage(e) });
+        closeStream();
+    }
+}
+//# sourceMappingURL=http-endpoints.js.map

package/dist/transport/http-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-endpoints.js","sourceRoot":"","sources":["../../src/transport/http-endpoints.ts"],"names":[],"mappings":"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"}

package/dist/transport/http-io.d.ts

@@ -0,0 +1,66 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * Agentia —— HTTP 宿主的**收发原语**（`transport/http.ts` 拆分第三步的两半之一）。
+ *
+ * 这一组只做「把请求读进来、把话说回去」的机械动作，与**这是哪条路**
+ * （`http-route.ts` 的纯判定）和**走到这条路上做什么**（`http-endpoints.ts` 的端点体）
+ * 都无关 —— 三个模块各管一件事，谁越界就是新的乱源。
+ *
+ * 边界（本模块**不**做的事）：
+ * - 不判路由、不选分支：`(pathname, method) → 该走哪条` 是 `http-route.ts` 的事；
+ * - 不决定状态码的**语义**：`sendJson(res, 400, …)` 里的 400 由调用方选，这里只负责写；
+ * - 不碰 AsyncRunner / store / 引擎：本模块的入参只有 req / res / 一段未知的 body。
+ *
+ * 依赖方向：本模块只 import `node:http` 的**类型**，零内部依赖 —— 所以
+ * `http.ts` 与 `http-endpoints.ts` 都能引它而不可能引成环。`HttpException` **刻意不在这里**
+ * （它是宿主契约的一部分，住在 `http.ts`）⇒ `sendUnauthorized` 也随之留在那边：
+ * 它是唯一一处 `instanceof HttpException` 的落点，搬过来会让本模块反向依赖宿主。
+ *
+ * 有两条**踩过坑**的兜底写进了这里，别当成可选装饰（原文见 `readBody` 与 `sendShuttingDown`）：
+ * body 上限（未鉴权的大 body 能打满内存）与连接不可复用时的 `connection: close`
+ * （残留字节会被当成下一个请求）。
+ */
+/** 503 建议重试间隔（秒）：同步 run 通常秒级，给 1s 足够错峰 */
+export declare const RETRY_AFTER_SECONDS = "1";
+/** 写一个 JSON 响应：带 `content-type` 与 `content-length`（后者用 `Buffer.byteLength`，不是 `.length`） */
+export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
+/** 405 统一响应（方法不符）：文案与其余错误一致用中文，并带 Allow 头。 */
+export declare function methodNotAllowed(res: ServerResponse, method: string, allowed: string): void;
+/** Prometheus 文本响应（G4）：抓取端按 text/plain; version=0.0.4 解析 */
+export declare function sendPrometheus(res: ServerResponse, body: string, contentType?: string): void;
+export type BodyResult = {
+    ok: true;
+    raw: string;
+} | {
+    ok: false;
+    reason: 'too-large' | 'aborted';
+};
+/**
+ * 读取 body 全文。两道兜底（原实现两者皆无）：
+ * - **maxBytes 上限**：超限立即停止累积并 resolve 成哨兵（调用方回 413）——
+ *   否则一个未鉴权的大 body 就能把宿主内存打满；
+ * - **close 兜底**：客户端中途断开时既不会有 `end` 也不会有 `error`（Node 发 `aborted`/`close`），
+ *   Promise 永不 settle → 每个半截请求漏一个 handler 与一份 buffer。
+ */
+export declare function readBody(req: IncomingMessage, maxBytes: number): Promise<BodyResult>;
+/** 把 unknown 异常收成一句人话（`Error` 取 `message`，其余 `String()`） */
+export declare function errMessage(e: unknown): string;
+/** 503：停机中不再接单（在读 body 之前就拒，省一次传输） */
+export declare function sendShuttingDown(req: IncomingMessage, res: ServerResponse): void;
+/**
+ * 500：内部错误。
+ *
+ * `exposeErrors` 为假时只回通用文案、细节走 `console.error` —— 否则
+ * `ECONNREFUSED 10.0.0.7:6379` 这类内部拓扑会回给未鉴权的调用方。
+ * `exposeErrors` 由宿主透传（它是 `HttpHandlerOptions` 的旋钮），本模块不持有策略。
+ */
+export declare function sendInternalError(res: ServerResponse, e: unknown, exposeErrors: boolean): void;
+/**
+ * 读单个请求头。Node 对重复头给数组（`traceparent` 语义上只该有一个）——
+ * 取第一个即可，多余的忽略。
+ */
+export declare function headerValue(req: IncomingMessage, name: string): string | undefined;
+/** 「body 已自行回过错误响应、调用方直接返回」的哨兵（连接已断时无响应可回，同样走它） */
+export declare const PARSE_FAILED: unique symbol;
+/** 读取并解析 JSON body；失败时直接回错误响应并返回哨兵（连接已断则无响应可回）。 */
+export declare function parseJsonBody(req: IncomingMessage, res: ServerResponse, maxBytes: number): Promise<unknown | typeof PARSE_FAILED>;