@turingflow/agent-kit 0.0.0-stage → 0.1.0

package/dist/server/sessions.js

@@ -0,0 +1,541 @@
+/**
+ * agent-kit · 会话管理 API（侧边栏会话列表增删改查）
+ *
+ * 路由接线（宿主 app，basePath=/agent）：
+ *   // app/api/sessions/route.js            -> GET 列表 / POST 注册新会话
+ *   // app/api/sessions/[id]/route.js       -> PATCH 重命名 / DELETE 删除
+ *   // app/api/sessions/[id]/messages/route.js -> GET 消息列表 / POST 追加消息
+ *
+ * 设计要点：
+ *   - 所有操作以登录用户（verifySession → sub，即 `provider:unionId` 主体键）为归属边界，未登录 / 游客一律 401；
+ *   - 会话 id 即前端 sessionId（UUID 文本），与 CLI 续接 key 一致；
+ *   - 数据库未配置时（isDbEnabled=false）返回 503，前端自动降级为纯本地会话。
+ */
+import { verifySession } from "./auth/handlers.js";
+import { loadAuthConfig } from "./auth/config.js";
+import { createSessionToken, verifySessionToken, sessionCookieOptions } from "./auth/session.js";
+import { createAgentSession, listAgentSessions, getAgentSession, renameAgentSession, setSessionTitleIfNotUserRenamed, updateAgentSessionWorkspace, deleteAgentSession, addAgentMessage, listAgentMessages, listSessionAttachmentUrls, truncateAgentMessages, isDbEnabled, queryAdminUsage, forkAgentSession, } from "./auth/db.js";
+import { createAgentStream, getModelContextLimit } from "./sdk.js";
+import { slog } from "./debug-log.js";
+import { unlink } from "node:fs/promises";
+import path from "node:path";
+function json(data, status = 200) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+    });
+}
+/** 解析请求 Cookie 中的指定键值。 */
+function getCookieValue(request, name) {
+    const raw = request.headers.get("cookie");
+    if (!raw)
+        return undefined;
+    for (const part of raw.split(";")) {
+        const eq = part.indexOf("=");
+        if (eq === -1)
+            continue;
+        if (part.slice(0, eq).trim() === name)
+            return part.slice(eq + 1).trim();
+    }
+    return undefined;
+}
+// ---- admin 用量页登录保护（独立于飞书用户会话）----
+// 用户名 / 密码固定为 admin / admin（本地桌面 app 的轻量保护），登录后签发
+// 12 小时 httpOnly Cookie，usage 接口校验该 Cookie，未登录一律 401。
+const ADMIN_COOKIE = "agent_admin";
+const ADMIN_SUB = "local:admin";
+const ADMIN_MAX_AGE_SECONDS = 60 * 60 * 12; // 12 小时
+/** 校验请求是否携带有效的 admin 登录 Cookie。 */
+function verifyAdmin(request) {
+    const config = loadAuthConfig();
+    const token = getCookieValue(request, ADMIN_COOKIE);
+    if (!token)
+        return false;
+    const user = verifySessionToken(token, config.sessionSecret);
+    return !!user && user.sub === ADMIN_SUB;
+}
+/** 组装 admin Cookie 的 Set-Cookie 头（复用标准会话选项，path 跟随 cookiePath）。 */
+function adminCookieHeader(token) {
+    const config = loadAuthConfig();
+    const opts = sessionCookieOptions(config.cookiePath, config.secureCookie, ADMIN_MAX_AGE_SECONDS);
+    const parts = [`${ADMIN_COOKIE}=${token ?? ""}`, `Path=${opts.path}`];
+    if (token)
+        parts.push(`Max-Age=${opts.maxAge}`);
+    else
+        parts.push("Max-Age=0");
+    parts.push("HttpOnly");
+    parts.push(opts.sameSite === "none" ? "SameSite=None" : "SameSite=Lax");
+    if (opts.secure)
+        parts.push("Secure");
+    return parts.join("; ");
+}
+/** POST /api/admin/login：校验 admin/admin，成功签发登录 Cookie。 */
+async function adminLogin(request) {
+    const body = (await request.json().catch(() => ({})));
+    const username = typeof body.username === "string" ? body.username : "";
+    const password = typeof body.password === "string" ? body.password : "";
+    if (username !== "admin" || password !== "admin") {
+        return json({ error: "用户名或密码错误" }, 401);
+    }
+    const config = loadAuthConfig();
+    const sessionUser = {
+        sub: ADMIN_SUB,
+        provider: "builtin",
+        unionId: "admin",
+        openId: "",
+        name: "管理员",
+        avatar: "",
+        exp: Math.floor(Date.now() / 1000) + ADMIN_MAX_AGE_SECONDS,
+    };
+    const token = createSessionToken(sessionUser, config.sessionSecret);
+    return new Response(JSON.stringify({ ok: true }), {
+        status: 200,
+        headers: { "Content-Type": "application/json; charset=utf-8", "Set-Cookie": adminCookieHeader(token) },
+    });
+}
+/** POST /api/admin/logout：清除 admin 登录 Cookie。 */
+function adminLogout() {
+    return new Response(JSON.stringify({ ok: true }), {
+        status: 200,
+        headers: { "Content-Type": "application/json; charset=utf-8", "Set-Cookie": adminCookieHeader(null) },
+    });
+}
+/** 解析 Next.js 动态路由参数（Next 15 中 params 可能是 Promise）。 */
+async function resolveParams(ctx) {
+    const params = (ctx && ctx.params) || {};
+    const resolved = params instanceof Promise ? await params : params;
+    return resolved;
+}
+/** 跑一次极简 LLM 调用，把用户首条消息总结成 6-12 字中文标题（fire-and-forget，失败返回空串）。
+ *  失败不打扰对话：标题保持快速占位（deriveQuickTitle）。 */
+export async function summarizeSessionTitle(userMessage) {
+    let title = "";
+    // 单次执行（含内部重试）：返回 { title, retryable }
+    async function runOnce() {
+        let t = "";
+        try {
+            console.log(`[agent-kit] summarizeSessionTitle start: "${userMessage.slice(0, 80)}"`);
+            const stream = createAgentStream({
+                messages: [
+                    {
+                        role: "system",
+                        content: "你是一个标题生成器，不是对话助手。不要回答用户，不要和用户交流。你的唯一任务是：把下面这段用户输入总结成一个 6-12 字的中文会话标题，概括用户意图或主题。只输出标题本身，不要引号、不要解释、不要句号结尾、不要问候。例如用户说'帮我写个爬虫'，你输出'编写爬虫'；用户说'hi'，你输出'打招呼'。",
+                    },
+                    { role: "user", content: `请为以下用户输入生成标题：\n\n${userMessage.slice(0, 500)}` },
+                ],
+                config: { sessionId: undefined, resume: false, continueSession: false, maxTurns: 1, allowedTools: [], webFetch: false },
+            });
+            const reader = stream.getReader();
+            const decoder = new TextDecoder();
+            let buf = "";
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buf += decoder.decode(value, { stream: true });
+                let idx;
+                while ((idx = buf.indexOf("\n\n")) !== -1) {
+                    const frame = buf.slice(0, idx);
+                    buf = buf.slice(idx + 2);
+                    const evM = frame.match(/^event: (.+)$/m);
+                    const dataM = frame.match(/^data: (.+)$/m);
+                    if (evM && evM[1] === "text" && dataM) {
+                        try {
+                            t += JSON.parse(dataM[1]).text || "";
+                        }
+                        catch { /* ignore */ }
+                    }
+                    if (evM && evM[1] === "error" && dataM) {
+                        const raw = dataM[1];
+                        let detail = raw;
+                        try {
+                            detail = JSON.parse(raw).text || raw;
+                        }
+                        catch { /* ignore */ }
+                        console.error(`[agent-kit] summarizeSessionTitle SSE error: ${detail}`);
+                    }
+                }
+            }
+            console.log(`[agent-kit] summarizeSessionTitle done: "${t}"`);
+            return { title: t, retryable: false };
+        }
+        catch (e) {
+            const msg = e instanceof Error && e.message ? e.message : String(e);
+            // transport 竞态（CLI 子进程未就绪/已退出）与单轮超限：主对话占着 CLI 时偶发，
+            // 标题只是占位增强，可重试一次吸收竞态；其他错误不重试。
+            const retryable = msg.includes("Transport not started") ||
+                msg.includes("Max turns") ||
+                msg.includes("Connection") ||
+                msg.includes("ETIMEDOUT") ||
+                msg.includes("ECONNRESET");
+            console.error(`[agent-kit] auto-title 生成失败（不影响对话，标题暂用快速占位）${retryable ? "，将重试一次" : ""}: ${msg}`);
+            return { title: "", retryable };
+        }
+    }
+    const first = await runOnce();
+    if (!first.title && first.retryable) {
+        await new Promise((r) => setTimeout(r, 800));
+        const second = await runOnce();
+        title = second.title;
+    }
+    else {
+        title = first.title;
+    }
+    return title.trim().replace(/^["「『]|["」』。.！!？?\s]+$/g, "").slice(0, 30);
+}
+/** 本地规则占位标题：取用户首条消息开头 6-12 字（去掉常见开场词/附件前缀/尾部标点）。
+ *  仅作「消息一发出标题就刷新」的立即占位，不依赖 LLM 渠道（hy3 免费渠道并发可能 429），
+ *  后台 LLM 标题到达后替换；空输入返回 ""（不落库，保持默认"新对话"）。 */
+function deriveQuickTitle(text) {
+    const s = (text || "").trim();
+    if (!s)
+        return "";
+    const cleaned = s
+        .replace(/^\[附件\]\s*/, "")
+        .replace(/^(帮我|请|麻烦|你好|嗨|hi|哈喽|hello)[，。!！？?\s、,]*/i, "");
+    const base = (cleaned || s).replace(/[。！!？\s，,、;；]+$/g, "").trim();
+    if (!base)
+        return "";
+    return base.length > 12 ? base.slice(0, 12) + "…" : base;
+}
+export function createSessionHandlers() {
+    /** 401：未登录 / 游客 */
+    function unauth() {
+        return json({ error: "unauthorized" }, 401);
+    }
+    /** 503：数据库未配置，前端应降级为本地会话 */
+    function noDb() {
+        return json({ error: "database_unavailable" }, 503);
+    }
+    async function currentUserId(request) {
+        const user = verifySession(request, loadAuthConfig());
+        if (!user || !user.sub)
+            return null;
+        return user.sub;
+    }
+    /** GET /api/sessions：当前用户的会话列表 */
+    async function list(request) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const rows = await listAgentSessions(userId);
+        return json({ sessions: rows });
+    }
+    /** POST /api/sessions：注册新会话（body { sessionId, title?, workspaceDir? }）；已存在则复用 */
+    async function create(request) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const body = (await request.json().catch(() => ({})));
+        const sessionId = typeof body.sessionId === "string" && body.sessionId ? body.sessionId : null;
+        if (!sessionId)
+            return json({ error: "missing_session_id" }, 400);
+        const title = typeof body.title === "string" ? body.title : "新任务";
+        const workspaceDir = typeof body.workspaceDir === "string" && body.workspaceDir.trim()
+            ? body.workspaceDir.trim()
+            : null;
+        const row = await createAgentSession(userId, sessionId, title, workspaceDir);
+        return json({ session: row }, row ? 200 : 500);
+    }
+    /** PATCH /api/sessions/:id：更新会话（body { title?, workspaceDir? }，至少一项；title 重命名，workspaceDir 切工作目录） */
+    async function rename(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        const body = (await request.json().catch(() => ({})));
+        const title = typeof body.title === "string" ? body.title.trim() : "";
+        const hasWorkspace = Object.prototype.hasOwnProperty.call(body, "workspaceDir");
+        const workspaceDir = typeof body.workspaceDir === "string" && body.workspaceDir.trim()
+            ? body.workspaceDir.trim()
+            : null;
+        if (!title && !hasWorkspace)
+            return json({ error: "missing_title_or_workspace" }, 400);
+        let ok = true;
+        if (title)
+            ok = (await renameAgentSession(userId, id, title, true)) && ok;
+        if (hasWorkspace)
+            ok = (await updateAgentSessionWorkspace(userId, id, workspaceDir)) && ok;
+        return json({ ok }, ok ? 200 : 404);
+    }
+    /** 按附件 url 清理磁盘文件：uploads 持久源 + attachments 派生副本（路径安全：只取 basename）。 */
+    async function removeAttachmentFiles(urls) {
+        const prefix = "/uploads";
+        const realDir = path.join(process.cwd(), "public", "uploads");
+        const virtualDir = path.join(process.cwd(), "attachments");
+        for (const url of urls) {
+            if (typeof url !== "string" || !url.startsWith(prefix))
+                continue;
+            const rel = url.slice(prefix.length).replace(/\\/g, "/").replace(/^\/+/, "");
+            const name = path.basename(rel).trim();
+            if (!name || name === "." || name === ".." || name.includes("\0"))
+                continue;
+            for (const dir of [realDir, virtualDir]) {
+                try {
+                    await unlink(path.join(dir, name));
+                }
+                catch {
+                    // 文件不存在 / 无权限：忽略（attachments 是派生的缓存副本，本来就可能没有）
+                }
+            }
+        }
+    }
+    /** DELETE /api/sessions/:id：删除会话（消息级联删除），并清理该会话上传的磁盘文件 */
+    async function remove(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        // 删除会话前先收集该会话全部上传附件 url（消息随后级联删除，无法再查）
+        let attachmentUrls = [];
+        try {
+            attachmentUrls = await listSessionAttachmentUrls(userId, id);
+        }
+        catch (e) {
+            console.warn(`[agent-kit] 收集会话附件失败（不影响删除）session=${id}:`, e instanceof Error ? e.message : e);
+        }
+        const ok = await deleteAgentSession(userId, id);
+        if (!ok)
+            return json({ ok }, 404);
+        // 磁盘清理：uploads（持久源）+ attachments（模型读取副本）
+        await removeAttachmentFiles(attachmentUrls);
+        return json({ ok }, 200);
+    }
+    /** GET /api/sessions/:id/messages：会话内消息（时间正序） */
+    async function messages(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        const rows = await listAgentMessages(userId, id);
+        return json({ messages: rows });
+    }
+    /** POST /api/sessions/:id/messages：追加消息（body { role, content, images?, modelInfo? }） */
+    async function appendMessage(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        // 会话必须归属当前用户（校验存在性）
+        const session = await getAgentSession(userId, id);
+        if (!session)
+            return json({ error: "not_found" }, 404);
+        const body = (await request.json().catch(() => ({})));
+        const role = body.role === "assistant" ? "assistant" : body.role === "user" ? "user" : "";
+        const content = typeof body.content === "string" ? body.content : "";
+        if (!role || (!content && !(role === "assistant" && Array.isArray(body.steps) && body.steps.length)))
+            return json({ error: "missing_role_or_content" }, 400);
+        const thinkingSecs = typeof body.thinkingSecs === "number" ? body.thinkingSecs : body.thinkingSecs === null ? null : undefined;
+        const elapsedSecs = typeof body.elapsedSecs === "number" ? body.elapsedSecs : body.elapsedSecs === null ? null : undefined;
+        try {
+            await addAgentMessage(id, role, content, body.images ?? null, body.steps ?? null, thinkingSecs, body.modelInfo ?? null, body.artifacts ?? null, body.attachment ?? null, elapsedSecs, body.costInfo ?? null);
+        }
+        catch (e) {
+            // 落库失败必须可见：前端会因 HTTP 非 2xx 在控制台告警，避免"历史凭空消失"无法排查
+            console.error(`[agent-kit] appendMessage 落库失败 session=${id} role=${role}:`, e instanceof Error ? e.message : e);
+            return json({ error: "message_save_failed" }, 500);
+        }
+        return json({ ok: true }, 200);
+    }
+    /** POST /api/sessions/:id/auto-title：首条消息生成会话标题（双轨）。
+     *  ① 立即：本地规则占位标题落库并返回——任何网络/渠道状况下标题都即刻刷新，不停在"新对话"；
+     *  ② LLM 标题：等待生成后随本响应直接返回更精确标题（标题摘要为单轮短 prompt，通常数秒），
+     *     前端拿到即刷新——满足"拿到 title 就立即刷新"，即使主对话还在思考也能即时显示；
+     *     LLM 渠道失败/返回空则回退占位标题，答复流中 SDK 的 ai-title（topic）继续兜底。
+     *  说明：标题请求与主对话是两个独立 SDK query（各自新建 transport），并发互不阻塞。 */
+    async function autoTitle(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId) {
+            console.log("[auto-title] unauth");
+            return unauth();
+        }
+        if (!isDbEnabled()) {
+            console.log("[auto-title] db disabled");
+            return noDb();
+        }
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        const session = await getAgentSession(userId, id);
+        if (!session) {
+            console.log(`[auto-title] session not found: ${id}`);
+            return json({ error: "not_found" }, 404);
+        }
+        // 只对首条消息生成标题：会话已有真实标题（非默认"新对话"/"新任务"）时直接跳过，不再消耗 LLM
+        const hasRealTitle = typeof session.title === "string" &&
+            session.title.trim() !== "" &&
+            session.title !== "新对话" &&
+            session.title !== "新任务";
+        if (hasRealTitle) {
+            console.log(`[auto-title] skip (already titled): ${id}`);
+            return json({ skipped: true, title: session.title });
+        }
+        const body = (await request.json().catch(() => ({})));
+        const userMessage = typeof body.userMessage === "string" ? body.userMessage.trim() : "";
+        if (!userMessage)
+            return json({ error: "missing_user_message" }, 400);
+        // ① 立即落库本地规则占位标题：消息刚发出标题就刷新（不再显示"新对话"）
+        //    兜底：即使派生为空（纯附件/特殊字符）也截取原文前 12 字，保证返回 title 非空、前端可刷新
+        const quick = deriveQuickTitle(userMessage) || userMessage.replace(/\s+/g, " ").trim().slice(0, 12);
+        if (quick) {
+            try {
+                const saved = await setSessionTitleIfNotUserRenamed(userId, id, quick);
+                if (saved)
+                    console.log(`[auto-title] quick title="${quick}"`);
+                else
+                    console.warn(`[auto-title] quick title 未落库（行不存在或 user_renamed=true）title="${quick}"`);
+            }
+            catch (e) {
+                // DB 异常不得 500：前端仍拿 title 刷新界面；DB 由后续重试 / SDK ai-title 补齐
+                console.error(`[auto-title] quick title 落库异常（不阻塞响应）:`, e instanceof Error ? e.message : e);
+            }
+        }
+        // ② LLM 标题：等待生成（单轮短 prompt，通常数秒）后随响应返回，前端拿到即刷新；
+        //    失败/返回空则回退占位标题，并由答复流中 SDK 的 ai-title 兜底。
+        //    这样即便 SDK 不为该模型回传 title 事件，首条消息的精确标题也能在模型还在思考时即时显示。
+        let improved = "";
+        try {
+            improved = String(await summarizeSessionTitle(userMessage)).trim();
+        }
+        catch (e) {
+            console.error("[auto-title] LLM 标题生成失败（回退占位）:", e instanceof Error ? e.message : e);
+        }
+        if (improved) {
+            try {
+                await setSessionTitleIfNotUserRenamed(userId, id, improved);
+                console.log(`[auto-title] llm title="${improved}"`);
+            }
+            catch (e) {
+                console.error("[auto-title] LLM 标题落库异常:", e instanceof Error ? e.message : e);
+            }
+        }
+        return json({ title: improved || quick, improving: true });
+    }
+    /** POST /api/sessions/:id/truncate：删除 upToId 之后的所有消息（编辑重发时调用）。 */
+    async function truncate(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        const session = await getAgentSession(userId, id);
+        if (!session)
+            return json({ error: "not_found" }, 404);
+        const body = (await request.json().catch(() => ({})));
+        const upToId = typeof body.upToId === "number" ? body.upToId : -1;
+        if (upToId < 0)
+            return json({ error: "missing_upToId" }, 400);
+        slog(id, "http.truncate", { userId, upToId }, "info");
+        await truncateAgentMessages(userId, id, upToId);
+        return json({ ok: true }, 200);
+    }
+    async function fork(request, ctx) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        if (!isDbEnabled())
+            return noDb();
+        const { id } = await resolveParams(ctx);
+        if (!id)
+            return json({ error: "missing_id" }, 400);
+        if (!await getAgentSession(userId, id))
+            return json({ error: "会话不存在或无权访问" }, 404);
+        const body = await request.json().catch(() => ({}));
+        if (!Number.isSafeInteger(body.messageIndex) || body.messageIndex < 0 || (body.messageId !== undefined && (!Number.isSafeInteger(body.messageId) || body.messageId <= 0)))
+            return json({ error: "分支位置无效" }, 400);
+        try {
+            return json({ session: await forkAgentSession(userId, id, body.messageIndex, body.messageId, body.snapshot) }, 201);
+        }
+        catch (error) {
+            console.error("[agent-kit] fork failed", error);
+            return json({ error: error instanceof Error ? error.message : "创建分支失败" }, 409);
+        }
+    }
+    /** POST /api/sessions/:id/close-sdk：关闭指定 sdkSid 的常驻 CLI Session（编辑重发时清旧 transcript）。 */
+    async function closeSdk(request, ctx) {
+        const body = (await request.json().catch(() => ({})));
+        const sdkSid = typeof body.sdkSid === "string" ? body.sdkSid : "";
+        if (sdkSid) {
+            const { closeSession } = await import("./session-store.js");
+            closeSession(sdkSid);
+            slog(sdkSid, "http.closeSdk", {}, "info");
+        }
+        return json({ ok: true }, 200);
+    }
+    /** GET /api/admin/usage：token 用量聚合（需 admin 登录 Cookie，未登录 401）。
+     *  summary 总量 + 按会话分组明细；数据源为消息表 cost_info。
+     *  没有 cost_info 数据时返回 200 空聚合（前端展示「暂无用量数据」），不报错。 */
+    async function adminUsage(request) {
+        if (!verifyAdmin(request))
+            return json({ error: "未登录或登录已过期，请先登录" }, 401);
+        if (!isDbEnabled())
+            return noDb();
+        try {
+            const data = await queryAdminUsage(200);
+            if (!data)
+                return noDb();
+            return json(data);
+        }
+        catch (e) {
+            // 数据库未迁移（如缺 cost_info 列）等异常：返回带可读 message 的 500，
+            // 前端优先展示服务端错误信息，便于定位；空数据不走到这里。
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error("[agent-kit] admin usage 查询失败:", e);
+            return json({ error: `用量数据查询失败：${msg}` }, 500);
+        }
+    }
+    /** GET /api/models/context?model=&sid=：当前模型上下文窗口上限（token）。
+     *  容量百分比 = 前端最新一轮 cost_info.usage.input_tokens / maxTokens；
+     *  会话创建后服务端已后台预取（getAvailableModelsRaw，无需先 send），
+     *  拿不到时返回 null（前端按「无数据不显示」策略隐藏圆环）。 */
+    async function modelContext(request) {
+        const userId = await currentUserId(request);
+        if (!userId)
+            return unauth();
+        const url = new URL(request.url);
+        const model = url.searchParams.get("model") || undefined;
+        const sid = url.searchParams.get("sid") || undefined;
+        const maxTokens = await getModelContextLimit(model || undefined, sid || undefined);
+        slog(sid ?? "", "modelContext.route", { model: model ?? null, maxTokens }, "info");
+        return json({ model: model ?? null, maxTokens });
+    }
+    return {
+        list,
+        create,
+        rename,
+        remove,
+        messages,
+        appendMessage,
+        autoTitle,
+        truncate,
+        fork,
+        closeSdk,
+        adminUsage,
+        adminLogin,
+        adminLogout,
+        modelContext,
+    };
+}

package/dist/server/share.d.ts

@@ -0,0 +1,15 @@
+export interface ShareHandlers {
+    create: {
+        POST: (request: Request) => Promise<Response>;
+    };
+    jsapiSign: {
+        POST: (request: Request) => Promise<Response>;
+    };
+    view: {
+        GET: (request: Request, ctx: unknown) => Promise<Response>;
+    };
+    send: {
+        POST: (request: Request, ctx: unknown) => Promise<Response>;
+    };
+}
+export declare function createShareHandlers(): ShareHandlers;