@sema-agent/server 7.79.3 → 7.80.1

package/dist/http/routes/sessions.js

@@ -7,6 +7,7 @@ import { recordFailOpen } from "../../observability/fail-open.js";
 import { MAX_SETTINGS_OUTPUT_STYLE_CHARS, MAX_SETTINGS_PERMISSION_RULES, MAX_SETTINGS_ENV_VARS, MAX_SETTINGS_ENV_KEY_CHARS, MAX_SETTINGS_ENV_VALUE_CHARS } from "../../task-settings.js";
 import { sendJson, sendError, sseHeaders } from "../send.js";
 import { gatedPrincipal, explicitOperatorOk, runOwnerReadable, sendPrincipalRefusal } from "../principal-gate.js";
+import { assertNever } from "../route-ctx.js";
 const MCP_STATUS_TTL_MS = 5_000;
 const MCP_MATERIALIZE_TIMEOUT_MS = 10_000;
 const A2A_STATUS_TTL_MS = 5_000;
@@ -61,26 +62,20 @@ async function readLastLegMcp(deps, sessionId, principal) {
     }
     return undefined;
 }
-export async function handleSessions(req, res, url, ctx) {
-    const miss = { fell: false };
-    await handleSessionsBody(req, res, url, ctx, miss);
-    return !miss.fell;
-}
-async function handleSessionsBody(req, res, url, ctx, miss) {
+export async function handleSessions(req, res, match, ctx) {
     const { deps } = ctx;
     const { readJson, safeDecode, runOwnerOk, sessionOwnerScope, sessionOwnerScopeForWrite } = ctx.helpers;
     const sse = ctx.local.sessions;
     const { mcpStatusCache, a2aStatusCache } = ctx.local.sessions;
     {
-        const im = /^\/v1\/sessions\/([^/]+)\/init$/.exec(url);
-        if (im && req.method === "GET") {
+        if (match.decl.id === "session-init") {
             const principal = gatedPrincipal(req, deps.config);
             if (deps.config.requirePrincipal && !principal) {
                 sendPrincipalRefusal(res, req, deps.config);
                 return;
             }
             sendJson(res, 200, {
-                sessionId: im[1],
+                sessionId: match.params.sessionId,
                 model: { provider: deps.config.model.provider, modelId: deps.config.model.id },
                 ...(deps.config.autonomy ? { mode: deps.config.autonomy } : {}),
             });
@@ -88,8 +83,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const stm = /^\/v1\/sessions\/([^/]+)\/settings$/.exec(url);
-        if (stm && req.method === "GET") {
+        if (match.decl.id === "session-settings") {
             const principal = gatedPrincipal(req, deps.config);
             if (deps.config.requirePrincipal && !principal) {
                 sendPrincipalRefusal(res, req, deps.config);
@@ -109,14 +103,13 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const mm = /^\/v1\/sessions\/([^/]+)\/mcp$/.exec(url);
-        if (mm && req.method === "GET") {
+        if (match.decl.id === "session-mcp") {
             const principal = gatedPrincipal(req, deps.config);
             if (deps.config.requirePrincipal && !principal) {
                 sendPrincipalRefusal(res, req, deps.config);
                 return;
             }
-            const lastLegMcp = await lastLegMcpFor(deps, safeDecode(mm[1]), principal);
+            const lastLegMcp = await lastLegMcpFor(deps, safeDecode(match.params.sessionId), principal);
             const specs = mcpForScenario(deps.config.mcpServers, deps.config.defaultScenario);
             const cacheKey = `${deps.config.defaultScenario}::${principal ?? ""}`;
             if (!specs || specs.length === 0) {
@@ -160,8 +153,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const am = /^\/v1\/sessions\/([^/]+)\/a2a$/.exec(url);
-        if (am && req.method === "GET") {
+        if (match.decl.id === "session-a2a") {
             if (deps.config.requirePrincipal && !gatedPrincipal(req, deps.config)) {
                 sendPrincipalRefusal(res, req, deps.config);
                 return;
@@ -220,15 +212,14 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const hm = req.method === "GET" ? /^\/v1\/sessions\/([^/]+)\/head$/.exec(url) : null;
-        if (hm) {
+        if (match.decl.id === "session-head") {
             const getLeafId = deps.sessionStorage?.getLeafId?.bind(deps.sessionStorage);
             const ownerOf = deps.sessionStorage?.ownerOf?.bind(deps.sessionStorage);
             if (!getLeafId || !ownerOf) {
                 sendError(res, 501, "capability.session_store_required", "session head probe requires a durable session store (DB_BACKEND=mysql|pg|local)");
                 return;
             }
-            const headSession = decodeURIComponent(hm[1]);
+            const headSession = decodeURIComponent(match.params.sessionId);
             const getHead = deps.sessionStorage?.getHead?.bind(deps.sessionStorage);
             let owner;
             let leafId;
@@ -264,15 +255,14 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const em = req.method === "GET" ? /^\/v1\/sessions\/([^/]+)\/events$/.exec(url) : null;
-        if (em) {
+        if (match.decl.id === "session-events") {
             const ownerOf = deps.sessionStorage?.ownerOf?.bind(deps.sessionStorage);
             const watch = deps.sessionWatch;
             if (!deps.sessionStorage?.getLeafId || !ownerOf || !watch) {
                 sendError(res, 501, "capability.session_store_required", "session events require a durable session store (DB_BACKEND=mysql|pg|local)");
                 return;
             }
-            const evSession = decodeURIComponent(em[1]);
+            const evSession = decodeURIComponent(match.params.sessionId);
             if (sse.sseConnections >= (deps.sessionEventsMaxConnections ?? 256)) {
                 res.setHeader("retry-after", "5");
                 sendError(res, 503, "state.sse_connection_cap", "session-events connection cap reached — fall back to /head polling");
@@ -333,7 +323,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
                     cleanup();
                     return;
                 }
-                const q = new URL(req.url ?? url, "http://x").searchParams;
+                const q = new URLSearchParams(match.search);
                 const lastLeafId = q.get("lastLeafId");
                 let first = true;
                 let lastAccepted;
@@ -453,9 +443,8 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const em = req.method === "POST" ? /^\/v1\/sessions\/([^/]+)\/memory\/erase$/.exec(url) : null;
-        if (em) {
-            const sessionId = safeDecode(em[1]);
+        if (match.decl.id === "session-memory-erase") {
+            const sessionId = safeDecode(match.params.sessionId);
             if (sessionId === null) {
                 sendError(res, 400, "request.path_malformed", "session id segment is not valid percent-encoding");
                 return;
@@ -513,9 +502,8 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const msm = req.method === "GET" ? /^\/v1\/sessions\/([^/]+)\/memory-status$/.exec(url) : null;
-        if (msm) {
-            const sessionId = safeDecode(msm[1]);
+        if (match.decl.id === "session-memory-status") {
+            const sessionId = safeDecode(match.params.sessionId);
             if (sessionId === null) {
                 sendError(res, 400, "request.path_malformed", "session id segment is not valid percent-encoding");
                 return;
@@ -570,17 +558,20 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
             return;
         }
     }
-    if (deps.sessionAudit && req.method === "GET") {
-        const sm = /^\/v1\/sessions\/([^/]+)$/.exec(url);
-        if (sm) {
-            const audit = await deps.sessionAudit(sm[1]);
+    if (match.decl.id === "session-detail") {
+        {
+            if (!deps.sessionAudit) {
+                sendError(res, 404, "not_found.route", "not found");
+                return;
+            }
+            const audit = await deps.sessionAudit(match.params.sessionId);
             if (!audit) {
                 sendError(res, 404, "not_found.session", "session not found");
                 return;
             }
             if (!runOwnerOk(req, res, audit.owner))
                 return;
-            const q = new URL(req.url ?? url, "http://x").searchParams;
+            const q = new URLSearchParams(match.search);
             const qi = (k) => {
                 const v = q.get(k);
                 if (v === null)
@@ -619,8 +610,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const fm = req.method === "POST" ? /^\/v1\/sessions\/([^/]+)\/fork$/.exec(url) : null;
-        if (fm) {
+        if (match.decl.id === "session-fork") {
             const fork = deps.sessionStorage?.fork?.bind(deps.sessionStorage);
             const ownerOf = deps.sessionStorage?.ownerOf?.bind(deps.sessionStorage);
             if (!fork || !ownerOf) {
@@ -632,7 +622,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
                 sendError(res, 401, "auth.unauthorized", "unauthorized");
                 return;
             }
-            const sourceId = safeDecode(fm[1]);
+            const sourceId = safeDecode(match.params.sessionId);
             if (sourceId === null || !isUuidV7(sourceId)) {
                 sendError(res, 400, "request.id_invalid", "invalid session id (must be a uuidv7)");
                 return;
@@ -657,8 +647,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const dm = req.method === "DELETE" ? /^\/v1\/sessions\/([^/]+)$/.exec(url) : null;
-        if (dm) {
+        if (match.decl.id === "session-delete") {
             const purge = deps.purgeSession;
             const ownerOf = deps.sessionStorage?.ownerOf?.bind(deps.sessionStorage);
             if (!purge || !ownerOf) {
@@ -670,7 +659,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
                 sendError(res, 401, "auth.unauthorized", "unauthorized");
                 return;
             }
-            const sessionId = safeDecode(dm[1]);
+            const sessionId = safeDecode(match.params.sessionId);
             if (sessionId === null || !isUuidV7(sessionId)) {
                 sendError(res, 400, "request.id_invalid", "invalid session id (must be a uuidv7)");
                 return;
@@ -699,8 +688,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const pm = req.method === "GET" || req.method === "PUT" ? /^\/v1\/sessions\/([^/]+)\/policy$/.exec(url) : null;
-        if (pm) {
+        if (match.decl.id === "session-policy-get" || match.decl.id === "session-policy-put") {
             const store = deps.sessionPolicyStore;
             const ownerOf = deps.sessionStorage?.ownerOf?.bind(deps.sessionStorage);
             if (!store || !ownerOf) {
@@ -712,7 +700,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
                 sendError(res, 401, "auth.unauthorized", "unauthorized");
                 return;
             }
-            const sessionId = safeDecode(pm[1]);
+            const sessionId = safeDecode(match.params.sessionId);
             if (sessionId === null || !isUuidV7(sessionId)) {
                 sendError(res, 400, "request.id_invalid", "invalid session id (must be a uuidv7)");
                 return;
@@ -732,7 +720,7 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
                 return;
             }
             const target = owner;
-            if (req.method === "GET") {
+            if (match.decl.id === "session-policy-get") {
                 sendJson(res, 200, { rules: (await store.getRules(sessionId, target)) ?? { rev: 0 } });
                 return;
             }
@@ -778,12 +766,27 @@ async function handleSessionsBody(req, res, url, ctx, miss) {
         }
     }
     {
-        const wm = req.method === "GET" ? /^\/v1\/sessions\/([^/]+)\/workspace(?:\/([^/]+)(?:\/(tree|file|archive))?)?$/.exec(url) : null;
-        if (wm) {
+        if (match.decl.id === "session-workspace") {
             sendError(res, 501, "capability.workspace_retired", "workspace browse is retired: the whole-tree snapshot epoch it projected was replaced by per-edited-file rewind history (which holds only files the agent edited, not the workspace). There is no whole-tree manifest to browse anymore.");
             return;
         }
     }
-    miss.fell = true;
+    return assertNever(match.decl.id);
 }
+export const SESSIONS_ROUTES = [
+    { id: "session-init", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/init$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-settings", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/settings$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-mcp", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/mcp$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-a2a", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/a2a$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-head", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/head$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-events", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/events$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-fork", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/fork$/, label: "/v1/sessions/:id/$verb", methods: ["POST"] },
+    { id: "session-policy-get", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/policy$/, label: "/v1/sessions/:id/$verb", methods: ["GET"] },
+    { id: "session-policy-put", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/policy$/, label: "/v1/sessions/:id/$verb", methods: ["PUT"] },
+    { id: "session-memory-erase", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/memory\/erase$/, label: "/v1/sessions/:id/memory/erase", methods: ["POST"] },
+    { id: "session-memory-status", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/memory-status$/, label: "/v1/sessions/:id/memory-status", methods: ["GET"] },
+    { id: "session-workspace", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)\/workspace(?:\/(?<key>[^/]+)(?:\/(?<sub>tree|file|archive))?)?$/, label: "/v1/sessions/:id/workspace", methods: ["GET"] },
+    { id: "session-detail", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)$/, label: "/v1/sessions/:id", methods: ["GET"] },
+    { id: "session-delete", pattern: /^\/v1\/sessions\/(?<sessionId>[^/]+)$/, label: "/v1/sessions/:id", methods: ["DELETE"] },
+];
 //# sourceMappingURL=sessions.js.map

package/dist/http/routes/shared-memory.d.ts

@@ -26,6 +26,23 @@
  * 「库里没有这份文件」对他不是秘密,把它和「你不是成员」合并反而会让成员无法区分打错路径和权限问题。
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
-import type { RouteCtx } from "../route-ctx.js";
-export declare function handleSharedMemory(req: IncomingMessage, res: ServerResponse, url: string, ctx: RouteCtx): Promise<boolean>;
+import type { RouteCtx, RouteMatch, RouteIdsOf } from "../route-ctx.js";
+export declare function handleSharedMemory(req: IncomingMessage, res: ServerResponse, match: RouteMatch<SharedMemoryRouteId>, ctx: RouteCtx): Promise<void>;
+export declare const SHARED_MEMORY_ROUTES: readonly [{
+    readonly id: "shared-memory-stores";
+    readonly path: "/v1/shared-memory/stores";
+    readonly methods: readonly ["GET"];
+}, {
+    readonly id: "shared-memory-store-documents";
+    readonly pattern: RegExp;
+    readonly label: "/v1/shared-memory/stores/:store/documents";
+    readonly methods: readonly ["GET"];
+}, {
+    readonly id: "shared-memory-store-document";
+    readonly pattern: RegExp;
+    readonly label: "/v1/shared-memory/stores/:store/document";
+    readonly methods: readonly ["GET"];
+}];
+/** 本域可分派行的 `id` 闭集 —— handler 的 `switch` 按它判穷尽(漏一口 = 编译红)。 */
+export type SharedMemoryRouteId = RouteIdsOf<typeof SHARED_MEMORY_ROUTES>;
 //# sourceMappingURL=shared-memory.d.ts.map

package/dist/http/routes/shared-memory.js

@@ -1,7 +1,7 @@
 import { SHARED_MEMORY_READ_CAP_BYTES, SharedMemoryStoreError } from "@sema-agent/core";
 import { sendJson, sendError } from "../send.js";
 import { gatedPrincipal } from "../principal-gate.js";
-const PREFIX = "/v1/shared-memory/";
+import { assertNever } from "../route-ctx.js";
 const RETRY_AFTER_SEC = 10;
 const HTTP_LIST_LIMIT = 100;
 const FORBIDDEN_PATH_CHARS = /[\p{Cc}\p{Cf}\p{Co}\p{Cn}\p{Default_Ignorable_Code_Point}\u2028\u2029\\]/u;
@@ -75,76 +75,78 @@ function resolveStore(res, snapshot, storeId) {
     }
     return found.reader;
 }
-export async function handleSharedMemory(req, res, url, ctx) {
-    const miss = { fell: false };
-    await handleSharedMemoryBody(req, res, url, ctx, miss);
-    return !miss.fell;
-}
-async function handleSharedMemoryBody(req, res, url, ctx, miss) {
-    if (url === "/v1/shared-memory/stores" && req.method === "GET") {
-        const snapshot = await bindSnapshot(req, res, ctx);
-        if (!snapshot)
-            return;
-        if (snapshot.state !== "connected") {
-            sendJson(res, 200, { state: "connecting", stores: [] });
+export async function handleSharedMemory(req, res, match, ctx) {
+    switch (match.decl.id) {
+        case "shared-memory-stores": {
+            const snapshot = await bindSnapshot(req, res, ctx);
+            if (!snapshot)
+                return;
+            if (snapshot.state !== "connected") {
+                sendJson(res, 200, { state: "connecting", stores: [] });
+                return;
+            }
+            sendJson(res, 200, { state: "connected", stores: snapshot.stores.map((s) => ({ id: s.info.id, description: s.info.description, writable: s.info.writable })) });
             return;
         }
-        sendJson(res, 200, { state: "connected", stores: snapshot.stores.map((s) => ({ id: s.info.id, description: s.info.description, writable: s.info.writable })) });
-        return;
-    }
-    const rest = url.startsWith(PREFIX) ? url.slice(PREFIX.length) : undefined;
-    const segments = rest === undefined ? [] : rest.split("/");
-    if (segments.length === 3 && segments[0] === "stores" && req.method === "GET" && (segments[2] === "documents" || segments[2] === "document")) {
-        const storeId = decodeURIComponent(segments[1]);
-        const query = new URL(req.url ?? "", "http://x").searchParams;
-        const snapshot = await bindSnapshot(req, res, ctx);
-        if (!snapshot)
-            return;
-        const reader = resolveStore(res, snapshot, storeId);
-        if (!reader)
-            return;
-        if (segments[2] === "documents") {
-            const prefix = query.get("path_prefix") ?? undefined;
-            const cursor = query.get("cursor") ?? undefined;
-            const page = await reader.list(prefix, { ...(cursor !== undefined ? { cursor } : {}), limit: HTTP_LIST_LIMIT }).catch((err) => {
-                if (foldReaderError(res, err))
-                    return undefined;
+        case "shared-memory-store-documents":
+        case "shared-memory-store-document": {
+            const storeId = decodeURIComponent(match.params.store);
+            const query = new URLSearchParams(match.search);
+            const snapshot = await bindSnapshot(req, res, ctx);
+            if (!snapshot)
+                return;
+            const reader = resolveStore(res, snapshot, storeId);
+            if (!reader)
+                return;
+            if (match.decl.id === "shared-memory-store-documents") {
+                const prefix = query.get("path_prefix") ?? undefined;
+                const cursor = query.get("cursor") ?? undefined;
+                const page = await reader.list(prefix, { ...(cursor !== undefined ? { cursor } : {}), limit: HTTP_LIST_LIMIT }).catch((err) => {
+                    if (foldReaderError(res, err))
+                        return undefined;
+                    throw err;
+                });
+                if (page === undefined)
+                    return;
+                const entries = Array.isArray(page) ? page : page.entries;
+                const nextCursor = Array.isArray(page) ? undefined : page.nextCursor;
+                sendJson(res, 200, { store: storeId, entries, ...(nextCursor !== undefined ? { nextCursor } : {}) });
+                return;
+            }
+            const path = query.get("path");
+            if (path === null || path === "" || !isDocumentPath(path)) {
+                sendError(res, 400, "request.query_invalid", "missing or malformed ?path= (absolute, .md/.txt/.json/.jsonl)");
+                return;
+            }
+            let folded = false;
+            const doc = await reader.read(path, {}).catch((err) => {
+                if (foldReaderError(res, err)) {
+                    folded = true;
+                    return null;
+                }
                 throw err;
             });
-            if (page === undefined)
+            if (folded)
+                return;
+            if (doc === null) {
+                sendError(res, 404, "not_found.shared_memory_document", "not found");
                 return;
-            const entries = Array.isArray(page) ? page : page.entries;
-            const nextCursor = Array.isArray(page) ? undefined : page.nextCursor;
-            sendJson(res, 200, { store: storeId, entries, ...(nextCursor !== undefined ? { nextCursor } : {}) });
-            return;
-        }
-        const path = query.get("path");
-        if (path === null || path === "" || !isDocumentPath(path)) {
-            sendError(res, 400, "request.query_invalid", "missing or malformed ?path= (absolute, .md/.txt/.json/.jsonl)");
-            return;
-        }
-        let folded = false;
-        const doc = await reader.read(path, {}).catch((err) => {
-            if (foldReaderError(res, err)) {
-                folded = true;
-                return null;
             }
-            throw err;
-        });
-        if (folded)
-            return;
-        if (doc === null) {
-            sendError(res, 404, "not_found.shared_memory_document", "not found");
-            return;
-        }
-        const bytes = Buffer.byteLength(doc.content, "utf8");
-        if (bytes > SHARED_MEMORY_READ_CAP_BYTES) {
-            sendError(res, 413, "request.payload_too_large", `document is ${bytes} bytes, over the ${SHARED_MEMORY_READ_CAP_BYTES}-byte shared-store read cap`, { bytes, capBytes: SHARED_MEMORY_READ_CAP_BYTES });
+            const bytes = Buffer.byteLength(doc.content, "utf8");
+            if (bytes > SHARED_MEMORY_READ_CAP_BYTES) {
+                sendError(res, 413, "request.payload_too_large", `document is ${bytes} bytes, over the ${SHARED_MEMORY_READ_CAP_BYTES}-byte shared-store read cap`, { bytes, capBytes: SHARED_MEMORY_READ_CAP_BYTES });
+                return;
+            }
+            sendJson(res, 200, { store: storeId, path, content: doc.content, bytes, ...(doc.updatedAt !== undefined ? { updatedAt: doc.updatedAt } : {}) });
             return;
         }
-        sendJson(res, 200, { store: storeId, path, content: doc.content, bytes, ...(doc.updatedAt !== undefined ? { updatedAt: doc.updatedAt } : {}) });
-        return;
+        default:
+            return assertNever(match.decl.id);
     }
-    miss.fell = true;
 }
+export const SHARED_MEMORY_ROUTES = [
+    { id: "shared-memory-stores", path: "/v1/shared-memory/stores", methods: ["GET"] },
+    { id: "shared-memory-store-documents", pattern: /^\/v1\/shared-memory\/stores\/(?<store>[^/]+)\/documents$/, label: "/v1/shared-memory/stores/:store/documents", methods: ["GET"] },
+    { id: "shared-memory-store-document", pattern: /^\/v1\/shared-memory\/stores\/(?<store>[^/]+)\/document$/, label: "/v1/shared-memory/stores/:store/document", methods: ["GET"] },
+];
 //# sourceMappingURL=shared-memory.js.map

package/dist/http/routes/side-query.d.ts

@@ -7,10 +7,19 @@
  * 已含本路径,故 no-token 503 / draining / model-ready 三闸在进本域前就已生效。本域零可变状态。
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
-import type { RouteCtx } from "../route-ctx.js";
+import type { RouteCtx, RouteMatch, RouteIdsOf } from "../route-ctx.js";
 /** 表内=core 的前置校验形(客户端可改请求)⇒ 400;表外一律 500。 */
 export declare function isCorePreflightValidationError(message: string): boolean;
 /** 供跨仓锚门读:门要拿这张表去装机的 core 里逐条对账(见上方 doc)。 */
 export declare const CORE_PREFLIGHT_VALIDATION_ANCHORS: readonly string[];
-export declare function handleSideQuery(req: IncomingMessage, res: ServerResponse, url: string, ctx: RouteCtx): Promise<boolean>;
+/** 路由体 = 从 `server.ts` 的 `handle()` 里**整段剪切**过来的原文(唯一改动:统一去缩进两格)。 */
+export declare function handleSideQuery(req: IncomingMessage, res: ServerResponse, match: RouteMatch<SideQueryRouteId>, ctx: RouteCtx): Promise<void>;
+export declare const SIDE_QUERY_ROUTES: readonly [{
+    readonly id: "side-query";
+    readonly path: "/v1/side-query";
+    readonly billable: true;
+    readonly methods: readonly ["POST"];
+}];
+/** 本域可分派行的 `id` 闭集 —— handler 的 `switch` 按它判穷尽(漏一口 = 编译红)。 */
+export type SideQueryRouteId = RouteIdsOf<typeof SIDE_QUERY_ROUTES>;
 //# sourceMappingURL=side-query.d.ts.map