dsh-llm-codebuddy-power 1.0.0 → 1.2.0

package/lib/index.js

@@ -1,5 +1,6 @@
+import z from "@deepseek-ai/schemastery";
+import { CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ProviderRequestId, QUOTA_EXCEEDED_CODE, ReasoningEffortId, ToolCallId, contentHasImage, isContextWindowExceededError, isQuotaExceededError, resolveImageAttachmentAccess } from "@deepseek-ai/dsh-llm";
 import { gzipSync } from "node:zlib";
-import { CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ProviderRequestId, QUOTA_EXCEEDED_CODE, ReasoningEffortId, ToolCallId, contentHasImage, isContextWindowExceededError, isQuotaExceededError } from "@deepseek-ai/dsh-llm";
 import { randomBytes, randomUUID } from "node:crypto";
 import { promises } from "node:fs";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
@@ -7,7 +8,6 @@ import { dirname } from "node:path";
 import { EventSourceParserStream } from "eventsource-parser/stream";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { spawn } from "node:child_process";
-import z from "@deepseek-ai/schemastery";
 //#region lib/types/constants.js
 /**
 * CodeBuddy 服务的固定事实。
@@ -77,6 +77,14 @@ const REQUEST_IMAGE_DIMENSION_LADDER = [
 const LOGIN_TIMEOUT_MS = 600 * 1e3;
 /** 等待浏览器登录完成时的轮询间隔,单位 ms。 */
 const LOGIN_POLL_INTERVAL_MS = 1e3;
+/**
+* 握手结算后在宿主表里保留结果的时长,单位 ms。
+*
+* 逾期即回收,但**客户端是过一会儿才来问的**(它按自己的间隔轮询),所以结果不能
+* 一结算就丢:一丢,那次本已成功的登录就再也答不出 `done: true`,客户端只能干等到
+* 十分钟截止。保留窗口只需覆盖一个客户端轮询周期,取一个宽裕值。
+*/
+const LOGIN_RESULT_RETENTION_MS = 60 * 1e3;
 /** 含义为“浏览器登录尚未完成”的服务码。 */
 const AUTH_PENDING_CODE = 11217;
 //#endregion
@@ -1005,7 +1013,7 @@ async function updateSessionInfo(sessionId, change) {
 * (`$DSH_HOME/data/plugins/llm-codebuddy-power/`,通过 harness 所用的同一个
 * `@deepseek-ai/dsh-home-paths` 解析),而不放在插件包内,因此重装不会让
 * 用户退出登录。写入经 [atomic-file.ts](./atomic-file.ts) 做原子替换并按路径串行化:
-* 多个账号的令牌刷新、设置页的增删与 CLI 的调用都在改同一份文件,不串行化时
+* 多个账号的令牌刷新、配置页的增删与 CLI 的调用都在改同一份文件,不串行化时
 * 两个并发写入会各自基于自己读到的旧内容覆盖对方。残缺文件会让用户手里只有
 * 一份读不出的凭据,还无法与“从未登录过”区分开。
 *
@@ -1153,7 +1161,7 @@ async function updateStorage(change) {
 * 插入一个账号,或替换同 uid 账号的凭据。
 *
 * 同 uid 视为重新登录同一个账号:令牌被替换而不是追加成第二个条目,否则
-* 设置页会出现两个同名徽章,退出其中一个还会留下另一个。
+* 配置页会出现两个同名徽章,退出其中一个还会留下另一个。
 * @param entry - 刚登录得到的账号。
 */
 async function upsertAccount(entry) {
@@ -1774,7 +1782,7 @@ var CodeBuddySession = class {
 		return (this.storage?.accounts.length ?? 0) > 0;
 	}
 	/**
-	* 已存账号及其默认账号,供设置页与会话切换按钮展示。
+	* 已存账号及其默认账号,供配置页与会话切换按钮展示。
 	* @returns 账号列表(顺序与磁盘一致)与默认账号 uid;未登录时列表为空。
 	*/
 	async accountList() {
@@ -1922,7 +1930,7 @@ var CodeBuddySession = class {
 	/**
 	* 目录;读不到时返回空列表。
 	*
-	* 列出模型是设置页上的浏览动作,所以失败必须降级为“没有可显示的内容”,
+	* 列出模型是配置页上的浏览动作,所以失败必须降级为“没有可显示的内容”,
 	* 而不是让页面崩掉。请求路径直接使用 {@link models} 并保留真实失败。
 	* @param signal - 可选取消信号。
 	* @param sessionId - 用哪个会话的账号;缺省时用默认账号。
@@ -1998,12 +2006,12 @@ async function* parseSse(stream, onComment) {
 * 把 harness 消息序列化为 CodeBuddy(OpenAI 兼容)chat 请求。
 *
 * 用户文本被拼接,助手文本成为 `content`,工具调用成为
-* `tool_calls`,每个工具结果成为其自身的 `role: 'tool'` 消息 →
-* harness 把工具结果放在用户消息内部,而这条 wire 路由
-* 不接受这种形式。对于支持图像的模型,图像以 OpenAI 兼容的
-* `image_url` 部件(`data:<type>;base64,...`)出现在用户或工具 content
-* 数组中,与官方 CLI 的发送方式完全一致。工具结果的图只对 `read_image`
-* 这类"看图"工具发送,生成图工具的结果仍走纯文本信封。
+* `tool_calls`,每个工具结果是一条 `role: 'tool'` 的 harness 消息,直接映射为
+* 同名 wire 条目。对于支持图像的模型,用户消息里的图**不内联**:改为给出一段
+* 引导模型自行用 `read_image` 读取的提示词(附件服务解析出的只读绝对路径);
+* 解析不出路径时退回内联,以免模型既拿不到图也拿不到路径。`read_image` 的工具
+* 结果仍内联图片本身 —— 那是像素交给模型的唯一途径。生成图工具的结果继续走
+* 纯文本信封。
 *
 * @module dsh-llm-codebuddy-power/serialize
 */
@@ -2015,6 +2023,77 @@ function flattenText(blocks) {
 function imageDataUrl(version) {
 	return `data:${version.mediaType};base64,${Buffer.from(version.data).toString("base64")}`;
 }
+/** PTC 模式下模型只能直呼 `run_code`,其余工具经生成的 SDK 以 `tools.<name>` 调用。 */
+const RUN_CODE_TOOL = "run_code";
+/** PTC 模式 SDK 中读取图片的绑定名。 */
+const PTC_READ_IMAGE_BINDING = "tools.read_image";
+/** 产出需要模型看到的图的那个工具:`read_image`。 */
+const READ_IMAGE_TOOL = "read_image";
+/**
+* 本请求中模型能否按提示词自行读取一张图。
+*
+* 三种形态分开处理,因为"能不能读"取决于该会话实际暴露的工具,而不只是路径是否
+* 可解析:
+* - `'direct'` —— 工具目录里有 `read_image`,可直接调用;标准模式即此。
+* - `'ptc'` —— 目录里只有 `run_code`(PTC 模式把其余工具放进生成的 SDK,
+*   `read_image` 只是 `tools.read_image` 绑定),提示词须指明经代码调用。
+* - `'none'` —— 没有可用的读图途径(极简模式只有持久 shell)。此形态不引导,
+*   因为那会让模型去调一个不存在的工具,比内联更糟;而极简模式的模型尚未形成
+*   "自己不能看图"的想法(标准模式那个想法来自大段系统提示词与 `read_image`
+*   描述里的 `Requires the current model to accept image input.`),内联即可。
+* @param tools - 本次请求的 wire 工具目录。
+* @returns 本请求的读图形态。
+*/
+function readImageRoute(tools) {
+	const names = new Set((tools ?? []).map((tool) => tool.name));
+	if (names.has(READ_IMAGE_TOOL)) return "direct";
+	if (names.has(RUN_CODE_TOOL)) return "ptc";
+	return "none";
+}
+/**
+* 一张用户消息里的图:有可用的读图途径时只给"自行读取"的提示词,不再内联图片;
+* 否则退回内联。
+*
+* 不内联的理由:网关对非原生多模态模型的兼容路径把图转成文字描述,同时在同一条
+* 链路上附一句"内容已过滤"的错误声明。图随用户消息到达时,模型会采信那句声明并
+* 否认看图;改由模型自己调用 `read_image` 取回后,图是它自己取回的返回内容,它
+* 不再采信那句声明。退回内联则是为了不让模型既拿不到图、又被指去一个不存在的工具。
+* @param ref - 该次出现的持久化附件引用。
+* @param version - 该图本次请求已解析的版本,仅在退回内联时使用。
+* @param resolveAccess - 解析该图在当前执行世界中的只读路径。
+* @param route - 本请求的读图形态。
+* @returns 该图的读取提示词,或退回内联时的 image_url 部件。
+*/
+function userImageParts(ref, version, resolveAccess, route) {
+	const access = resolveAccess?.(ref);
+	if (route === "none" || access === void 0) return [inlineImagePart(version)];
+	return [{
+		type: "text",
+		text: imageReadPrompt(ref, access, route)
+	}];
+}
+/** 内联 base64 图部件。工具结果的像素只能这样交给模型。 */
+function inlineImagePart(version) {
+	return {
+		type: "image_url",
+		image_url: { url: imageDataUrl(version) }
+	};
+}
+/**
+* 组装引导模型自行读取该图的提示词。
+*
+* 只陈述路径与动作:图并未内联,任何形如"已发送的预览版本"的措辞都会让模型把
+* 这段话当成图的替代说明,而不是去读取它的指令。
+* @param ref - 该次出现的持久化附件引用,身份取自它。
+* @param access - 该图在当前执行世界中的只读路径。
+* @param route - 本请求的读图形态,决定用哪种调用方式。
+* @returns 面向模型的读取提示词。
+*/
+function imageReadPrompt(ref, access, route) {
+	const identity = ref.name === void 0 ? String(ref.attachmentId) : `${JSON.stringify(ref.name)} (${ref.attachmentId})`;
+	const call = route === "ptc" ? `Call it from your code as ${PTC_READ_IMAGE_BINDING}({ file_path: <path> }).` : `Call the ${READ_IMAGE_TOOL} tool with that path to view it.`;
+	return `[Image ${identity} is at the read-only path ${JSON.stringify(access.readonlyPath)}. ${call} This conversation delivers images through that tool, so read the image yourself before answering about it.]`;
+}
 /**
 * 在任何文本扁平化可能静默丢弃图像内容之前先拒绝它。
 * @param blocks - 消息内容。
@@ -2026,12 +2105,14 @@ function assertSupportedContent(blocks, supportsImages) {
 /**
 * 序列化一条用户消息中非工具结果的块。纯文本内容保持紧凑的
 * 字符串 wire 形式;含图像的内容变为 OpenAI 兼容的
-* 部件数组,并保持块顺序。
+* 部件数组(图可按读图形态换成读取提示词),并保持块顺序。
 * @param blocks - 消息中非工具结果的块。
 * @param images - 请求中每个图像已解析的请求版本。
+* @param resolveAccess - 解析单张图在当前执行世界中的只读路径。
+* @param route - 本请求的读图形态。
 * @returns 用户角色的 wire 内容。
 */
-function userContent(blocks, images) {
+function userContent(blocks, images, resolveAccess, route) {
 	if (!contentHasImage(blocks)) return flattenText(blocks);
 	const parts = [];
 	let text = "";
@@ -2052,10 +2133,7 @@ function userContent(blocks, images) {
 		const version = images.get(block.attachment.attachmentId);
 		if (version === void 0) throw new LlmError(`CodeBuddy request image ${block.attachment.attachmentId} was not prepared.`, "INVALID_REQUEST");
 		flush();
-		parts.push({
-			type: "image_url",
-			image_url: { url: imageDataUrl(version) }
-		});
+		parts.push(...userImageParts(block.attachment, version, resolveAccess, route));
 	}
 	flush();
 	return parts;
@@ -2081,16 +2159,24 @@ function serializeAssistant(message) {
 }
 /**
 * 按顺序序列化整个对话。
+*
+* 工具结果在 harness 里是**独立的 `role: 'tool'` 消息**(`ToolResultMessage`),
+* 因此这里逐条映射,而不是按块从 user 消息里筛选。
+* developer 消息由运行时在 `projectToolUpdates` 中剥离(本 adapter 未声明
+* `toolUpdate`),因此不会到达这里;万一到达即明确拒绝,而不是静默丢弃。
 * @param messages - harness 会话。
 * @param supportsImages - 所选模型是否声明支持图像输入。
 * @param images - 请求中每个图像已解析的请求版本。
-* @returns wire 消息,每个工具结果展开为独立条目。
+* @param resolveAccess - 解析单张图在当前执行世界中的只读路径。
+* @param route - 本请求的读图形态。
+* @returns wire 消息,工具结果各自成为独立条目。
 */
-function serializeMessages(messages, supportsImages, images = /* @__PURE__ */ new Map()) {
+function serializeMessages(messages, supportsImages, images = /* @__PURE__ */ new Map(), resolveAccess, route = "none") {
 	const wire = [];
 	const toolNames = collectToolNames(messages);
 	for (const message of messages) {
 		assertSupportedContent(message.content, supportsImages);
+		if (message.role === "developer") throw new LlmError("CodeBuddy chat does not support developer messages.", "UNSUPPORTED_CONTENT");
 		if (message.role === "system") {
 			wire.push({
 				role: "system",
@@ -2102,47 +2188,55 @@ function serializeMessages(messages, supportsImages, images = /* @__PURE__ */ ne
 			wire.push(serializeAssistant(message));
 			continue;
 		}
-		const toolResults = message.content.filter((block) => block.type === "tool-result");
-		const content = userContent(message.content.filter((block) => block.type !== "tool-result"), images);
-		if (content.length > 0 || toolResults.length === 0) wire.push({
+		if (message.role === "tool") {
+			wire.push(serializeToolResult(message, supportsImages, images, toolNames));
+			continue;
+		}
+		const routeForMessage = message.source?.kind === "user" ? route : "none";
+		wire.push({
 			role: "user",
-			content
+			content: userContent(message.content, images, resolveAccess, routeForMessage)
 		});
-		for (const result of toolResults) {
-			const text = flattenText(result.content);
-			const imageBlocks = result.content.filter((block) => block.type === "image");
-			if (!(supportsImages && imageBlocks.length > 0 && toolNames.get(result.toolCallId) === READ_IMAGE_TOOL)) {
-				wire.push({
-					role: "tool",
-					tool_call_id: result.toolCallId,
-					content: text.length === 0 ? "(no output)" : text
-				});
-				continue;
-			}
-			const parts = [];
-			if (text.length > 0) parts.push({
-				type: "text",
-				text
-			});
-			for (const block of imageBlocks) {
-				const version = images.get(block.attachment.attachmentId);
-				if (version === void 0) throw new LlmError(`CodeBuddy request image ${block.attachment.attachmentId} was not prepared.`, "INVALID_REQUEST");
-				parts.push({
-					type: "image_url",
-					image_url: { url: imageDataUrl(version) }
-				});
-			}
-			wire.push({
-				role: "tool",
-				tool_call_id: result.toolCallId,
-				content: parts
-			});
-		}
 	}
 	return wire;
 }
-/** 产出需要模型看到的图的那个工具:`read_image`。 */
-const READ_IMAGE_TOOL = "read_image";
+/**
+* 序列化一条工具结果消息。
+*
+* 工具结果的图是否发给模型取决于**产出它的工具**:`read_image` 的存在意义就是让
+* 模型看图,必须发送;`codebuddy-draw` 只需模型知道"图已生成"(与官方 image_gen
+* 的纯文本信封一致),发图纯属浪费 token。实测确认服务端接受 tool 消息里的
+* image_url,因此直接放进该条目的 content 数组。
+* @param message - 工具结果消息。
+* @param supportsImages - 所选模型是否声明支持图像输入。
+* @param images - 请求中每个图像已解析的请求版本。
+* @param toolNames - toolCallId → 工具名 的索引。
+* @returns 该工具结果的 wire 条目。
+*/
+function serializeToolResult(message, supportsImages, images, toolNames) {
+	const text = flattenText(message.content);
+	const imageBlocks = message.content.filter((block) => block.type === "image");
+	if (!(supportsImages && imageBlocks.length > 0 && toolNames.get(message.toolCallId) === READ_IMAGE_TOOL)) return {
+		role: "tool",
+		tool_call_id: message.toolCallId,
+		content: text.length === 0 ? "(no output)" : text
+	};
+	const parts = [];
+	if (text.length > 0) parts.push({
+		type: "text",
+		text
+	});
+	for (const block of imageBlocks) {
+		const version = images.get(block.attachment.attachmentId);
+		if (version === void 0) throw new LlmError(`CodeBuddy request image ${block.attachment.attachmentId} was not prepared.`, "INVALID_REQUEST");
+		parts.push(inlineImagePart(version));
+	}
+	return {
+		role: "tool",
+		tool_call_id: message.toolCallId,
+		content: parts
+	};
+}
 /**
 * 建立 toolCallId → 工具名 的索引。
 *
@@ -2166,15 +2260,17 @@ function collectToolNames(messages) {
 * @param options - 组装好的 harness 请求。
 * @param supportsImages - 所选模型是否声明支持图像输入。
 * @param images - 请求中每个图像已解析的请求版本。
+* @param resolveAccess - 解析单张图在当前执行世界中的只读路径。
+* @param route - 本请求的读图形态,由工具目录决定;写入前由调用方计算一次。
 * @returns 请求体。
 */
-function serializeRequest(options, supportsImages, images = /* @__PURE__ */ new Map()) {
+function serializeRequest(options, supportsImages, images = /* @__PURE__ */ new Map(), resolveAccess) {
 	const messages = [];
 	if (options.system !== void 0) messages.push({
 		role: "system",
 		content: options.system
 	});
-	messages.push(...serializeMessages(options.messages, supportsImages, images));
+	messages.push(...serializeMessages(options.messages, supportsImages, images, resolveAccess, readImageRoute(options.tools)));
 	const tools = options.tools?.map((tool) => ({
 		type: "function",
 		function: {
@@ -2518,48 +2614,45 @@ function requestId(headers) {
 	const value = headers.get("x-request-id") ?? headers.get("x-requestid");
 	return value === null || value.length === 0 ? void 0 : ProviderRequestId(value);
 }
-/** 收集单条消息内容中的全部图像引用,包括工具结果内的引用。 */
+/** 收集单条消息内容中的全部图像引用。 */
 function collectImageRefs(content, refs) {
 	for (const block of content) if (block.type === "image") refs.set(block.attachment.attachmentId, block.attachment);
-	else if (block.type === "tool-result") collectImageRefs(block.content, refs);
 }
 /**
-* 把"长边不超过 longEdge"折算为该图的总像素预算。
-*
-* 请求投影只接受总像素上限(`ImageRequestPolicy.maxPixels`),没有长边字段,
-* 而总像素无法约束长边:8000×460 仅 368 万像素,长边却达 8000。投影按
-* `sqrt(maxPixels / (width * height))` 等比缩放,因此令
-* `maxPixels = longEdge² × (短边 / 长边)` 时缩放系数恰为 `longEdge / 长边`,
-* 结果正好把长边压到该档。
+* 把"长边不超过 longEdge"折算为该图的目标尺寸。
 *
-* 长边本就在档内时返回原图总像素。这**不是**防放大所必需的:投影自身以
-* `min(1, …)` 截断缩放系数,且长边 ≤ longEdge 时恒有
-* `longEdge² × (短边/长边) ≥ 原面积`,故照公式给值也不会被放大。返回原图
-* 面积的作用是让**预算值在各档之间重复**,从而被逐档重试的去重跳过,避免
-* 对同一尺寸重复编码。
+* 请求投影接受的是目标宽高(`ImageRequestTarget`),因此长边档位直接折算成一对
+* 宽高,而不必再换算成总像素预算。目标大于源图时投影保持源图尺寸(不放大),
+* 所以长边本就在档内时直接给源图宽高。
 *
 * 宽高由会话格式的载荷校验强制为正整数(`payload-validation.ts` 的
 * `imageAttachmentValue`),故此处不做防御检查。
 * @param width - 原图宽度(像素)。
 * @param height - 原图高度(像素)。
 * @param longEdge - 本档的长边上限(像素)。
-* @returns 该图在该档下的 `maxPixels` 取值,恒为正整数。
+* @returns 该图在该档下的目标宽高。
 */
-function pixelBudgetForLongEdge(width, height, longEdge) {
+function dimensionsForLongEdge(width, height, longEdge) {
 	const source = Math.max(width, height);
-	if (source <= longEdge) return width * height;
+	if (source <= longEdge) return {
+		width,
+		height
+	};
 	const scale = longEdge / source;
-	return Math.max(1, Math.round(width * scale)) * Math.max(1, Math.round(height * scale));
+	return {
+		width: Math.max(1, Math.round(width * scale)),
+		height: Math.max(1, Math.round(height * scale))
+	};
 }
 /**
 * 解析一张图的请求版本:源图未超字节目标时原样复用,超过时才逐档收紧长边。
 *
-* 未超目标的一支不做任何转换:`maxPixels` 取原图总像素,投影因此不缩放,附件
-* 服务命中其直通分支返回原始字节,既不重编码也不写请求缓存 —— 降到 1920 会
-* 白白丢掉分辨率与画质,而模型侧的约束只有字节目标。
+* 未超目标的一支不做任何转换:目标取原图宽高,投影因此不缩放,附件服务命中其
+* 直通分支返回原始字节,既不重编码也不写请求缓存 —— 降到 1920 会白白丢掉分辨率
+* 与画质,而模型侧的约束只有字节目标。
 *
 * 超过目标的一支才逐档收紧长边。附件服务的编码阶梯只降质量、不降尺寸,单靠
-* 一档无法保证落到字节目标,故需要换更小的长边重来;预算相同的档位会被跳过。
+* 一档无法保证落到字节目标,故需要换更小的长边重来;尺寸相同的档位会被跳过。
 * @param ref - 持久化附件引用。
 * @param attachments - 已挂载的附件服务。
 * @param signal - 本次生成的取消信号。
@@ -2568,17 +2661,19 @@ function pixelBudgetForLongEdge(width, height, longEdge) {
 async function requestImageVersion(ref, attachments, signal) {
 	const maxBytes = REQUEST_IMAGE_MAX_BYTES;
 	if (ref.bytes <= maxBytes) return attachments.readImageRequest(ref, {
-		maxPixels: ref.width * ref.height,
+		width: ref.width,
+		height: ref.height,
 		maxBytes
 	}, signal);
 	const tried = /* @__PURE__ */ new Set();
 	let smallest;
 	for (const longEdge of REQUEST_IMAGE_DIMENSION_LADDER) {
-		const maxPixels = pixelBudgetForLongEdge(ref.width, ref.height, longEdge);
-		if (tried.has(maxPixels)) continue;
-		tried.add(maxPixels);
+		const size = dimensionsForLongEdge(ref.width, ref.height, longEdge);
+		const key = `${size.width}x${size.height}`;
+		if (tried.has(key)) continue;
+		tried.add(key);
 		const version = await attachments.readImageRequest(ref, {
-			maxPixels,
+			...size,
 			maxBytes
 		}, signal);
 		if (version.bytes <= maxBytes) return version;
@@ -2588,7 +2683,7 @@ async function requestImageVersion(ref, attachments, signal) {
 }
 /**
 * 在所选模型接受图像输入时,解析会话所携带每张图像的请求版本。持久化 harness 以引用
-* 方式附加;请求字节由附件服务按逐图的像素与字节预算派生,与官方 DeepSeek 适配器
+* 方式附加;请求字节由附件服务按逐图的目标尺寸与字节预算派生,与官方 DeepSeek 适配器
 * 的准备方式一致。
 * @param messages - 等待序列化的 harness 消息。
 * @param attachments - 持久化附件服务;未挂载时为 undefined。
@@ -2738,7 +2833,8 @@ var CodeBuddyAdapter = class extends LlmAdapter {
 		const entry = (await this.config.session.modelsOrEmpty(options.signal, sessionId)).find((candidate) => candidate.id === options.model);
 		const supportsImages = entry?.supportsImages === true;
 		if (options.tools !== void 0 && options.tools.length > 0 && entry?.supportsToolCall === false) throw new LlmError(`CodeBuddy model "${options.model}" does not support tool calls`, "UNSUPPORTED_OPTION");
-		const body = serializeRequest(options, supportsImages, supportsImages ? await prepareRequestImages(options.messages, this.config.resolveAttachments(), options.signal) : /* @__PURE__ */ new Map());
+		const attachments = this.config.resolveAttachments();
+		const body = serializeRequest(options, supportsImages, supportsImages ? await prepareRequestImages(options.messages, attachments, options.signal) : /* @__PURE__ */ new Map(), attachments === void 0 || this.config.resolveImageAccess === void 0 ? void 0 : (ref) => this.config.resolveImageAccess?.(attachments, ref));
 		const payload = gzipSync(Buffer.from(JSON.stringify(body), "utf8"));
 		const messageId = compactUuid();
 		const conversationId = options.sessionId === void 0 ? compactUuid() : this.config.session.conversationIdOf(String(options.sessionId));
@@ -3026,8 +3122,9 @@ function endpointOf(channel, pathname) {
 * @param res - 本路由在整个生命周期内持有的响应。
 */
 async function serveChannel(rpcCtx, channel, handler, req, res) {
-	const rejection = rpcCtx.connection.requestRejection(req);
-	if (rejection !== void 0) {
+	const admission = rpcCtx.connection.admit(req);
+	if ("rejection" in admission) {
+		const rejection = admission.rejection;
 		res.writeHead(rejection);
 		res.end(rejection === 401 ? "unauthorized" : "forbidden");
 		return;
@@ -3085,7 +3182,7 @@ async function serveChannel(rpcCtx, channel, handler, req, res) {
 		res.on("close", () => {
 			controller.abort();
 		});
-		const result = await handler(endpoint, message.payload, controller.signal);
+		const result = await handler(endpoint, message.payload, controller.signal, admission.peer);
 		writeJson(res, 200, serverResponse(message.rpcId, result));
 	} catch (error) {
 		res.writeHead(500);
@@ -3451,10 +3548,11 @@ function enrichModel(model, promotions, tiers, withOverrides) {
 /**
 * 通过私有 RPC 通道暴露给 Web 客户端的宿主侧 OAuth 服务。
 *
-* 浏览器登录是长时操作(要等待用户完成登录),因此拆成两个 RPC endpoint:
-* `startLogin` 生成握手并返回用户必须打开的 URL,`pollLogin` 检查该握手是否已完成;
+* 浏览器登录是长时操作(要等待用户完成登录),因此拆成三个 RPC endpoint:
+* `startLogin` 生成握手并返回用户必须打开的 URL,`pollLogin` 检查该握手是否已完成,
+* `pendingLogin` 报出仍在轮询的握手(浏览器刷新后据此接回);
 * 一次完成的登录会**追加**一个账号,而不是取代已有的。`accounts`、`activate`、
-* `setDefault`、`logout` 是设置页与会话账号按钮其余时间驱动的读写组合。
+* `setDefault`、`logout` 是配置页与会话账号按钮其余时间驱动的读写组合。
 *
 * @module dsh-llm-codebuddy-power/auth-service
 */
@@ -3525,13 +3623,18 @@ function projectWindow(window) {
 /**
 * CodeBuddy 认证 RPC 服务。
 *
-* 握手由 `startLogin` 发起,由 `pollLogin` 轮询至完成,其账号由适配器的
-* `CodeBuddySession` 在下一个请求中取用 → 因此通过 UI 完成的登录无需重启
-* 即可到达运行中的 harness。`logout` 移除指定账号并使会话缓存失效。
+* 握手由 `startLogin` 发起并**脱手**开跑,客户端经 `pollLogin` 反复查问它是否已结算,
+* 其账号由适配器的 `CodeBuddySession` 在下一个请求中取用 → 因此通过 UI 完成的登录
+* 无需重启即可到达运行中的 harness。`logout` 移除指定账号并使会话缓存失效。
 */
 var CodeBuddyAuthService = class {
 	session;
-	/** 按 state id 索引的进行中握手。 */
+	/**
+	* 按 state id 索引的握手。
+	*
+	* 同时存放进行中的与**刚结算、尚在保留窗口内**的条目 —— 后者供客户端取回结果,
+	* 由 `settle()` 安排回收,因此本表不是"进行中握手"的集合。
+	*/
 	pending = /* @__PURE__ */ new Map();
 	constructor(ctx, session) {
 		this.session = session;
@@ -3542,7 +3645,8 @@ var CodeBuddyAuthService = class {
 		switch (endpoint) {
 			case "accounts": return ok(await this.accounts());
 			case "startLogin": return ok(await this.startLogin());
-			case "pollLogin": return ok(await this.pollLogin(stringField(payload, "state")));
+			case "pollLogin": return ok(this.pollLogin(stringField(payload, "state")));
+			case "pendingLogin": return ok(this.pendingLogin());
 			case "cancelLogin": return this.cancelLogin(stringField(payload, "state")) ? ok(void 0) : err("bad-request", "a login handshake id is required");
 			case "sessionAccount": return ok(await this.sessionAccount(stringField(payload, "sessionId")));
 			case "activate": return await this.activate(stringField(payload, "sessionId"), stringField(payload, "uid")) ? ok(void 0) : err("unknown-account", "the requested account is not stored");
@@ -3581,37 +3685,70 @@ var CodeBuddyAuthService = class {
 	}
 	/**
 	* 发起一次浏览器登录握手。
-	* @returns 用户必须打开的 URL。
+	* @returns 用户必须打开的 URL,以及该握手的 id 与发起时刻。
 	*/
 	async startLogin() {
 		const handshake = await requestAuthState();
 		const controller = new AbortController();
+		const startedAt = Date.now();
 		const pending = {
 			state: handshake.state,
-			promise: this.runLogin(handshake.state, controller.signal),
+			startedAt,
+			account: void 0,
+			settled: false,
 			controller
 		};
 		this.pending.set(handshake.state, pending);
-		pending.promise.finally(() => {
-			if (this.pending.get(handshake.state) === pending) this.pending.delete(handshake.state);
-		});
+		this.runLogin(handshake.state, controller.signal).catch(() => {});
 		return {
 			authUrl: handshake.authUrl,
-			state: handshake.state
+			state: handshake.state,
+			startedAt
+		};
+	}
+	/**
+	* 仍在进行的握手。
+	*
+	* 客户端的「登录中」状态只活在浏览器内存里,刷新即丢,而本表里的握手仍在轮询,
+	* 浏览器重新挂载后据此接回(否则界面显示可再次登录,而宿主那边已有一次握手在等,
+	* 用户点了就会平白多出第二次)。
+	*
+	* **只报尚未结算的握手**:已结算的条目会在表里多留一会儿供客户端取结果,若把它们
+	* 也算作"进行中",刷新后接回的就是一次已经结束(甚至已经失败)的登录,界面会重新
+	* 显示「登录中…」并空转到截止时间。
+	*
+	* 同时存在多次时给出最近发起的那次:客户端的轮询、取消与超时都只针对一个握手,
+	* 而最晚发起的那次正是用户此刻在等的那次。
+	* @returns 该握手;没有进行中的登录时缺省。
+	*/
+	pendingLogin() {
+		let latest;
+		for (const pending of this.pending.values()) {
+			if (pending.settled) continue;
+			if (latest === void 0 || pending.startedAt > latest.startedAt) latest = pending;
+		}
+		return latest === void 0 ? void 0 : {
+			state: latest.state,
+			startedAt: latest.startedAt
 		};
 	}
 	/**
 	* 检查已发起的握手是否完成。
+	*
+	* **立即返回**,不等待后台握手:`runLogin` 可能还要跑满十分钟,若在这里 await 它,
+	* 浏览器的一次请求就会在整个登录窗口内停在待处理,占住一条连接不放;而客户端是
+	* 按自己的间隔反复来问的,让它每次都立刻拿到"还没好"才是这条 endpoint 的职责。
 	* @param state - 来自 `startLogin` 的握手 id。
 	* @returns 登录是否完成、账号是否已持久化。
 	*/
-	async pollLogin(state) {
+	pollLogin(state) {
 		const pending = this.pending.get(state);
 		if (pending === void 0) return { done: false };
-		const entry = await pending.promise;
+		if (!pending.settled) return { done: false };
+		const account = pending.account;
 		return {
-			done: entry !== void 0,
-			...entry === void 0 ? {} : { nickname: entry.account.nickname }
+			done: account !== void 0,
+			...account === void 0 ? {} : { nickname: account.account.nickname }
 		};
 	}
 	/**
@@ -3714,23 +3851,45 @@ var CodeBuddyAuthService = class {
 		};
 	}
 	/**
-	* 把一次握手推进到持久化的账号。
+	* 把一次握手推进到持久化的账号,并把结果写回 {@link pending} 里对应条目。
 	*
 	* 复用 `buildAccount`,使落盘结构与 CLI 登录完全一致。
-	* 任何失败都返回 `undefined`,让客户端的轮询得到 `done: false`,
+	* 任何失败都记为"结算为失败",让客户端的轮询得到 `done: false`,
 	* 从而可以从 `startLogin` 重试。
+	*
+	* 本方法由 `startLogin` **脱手**调用,`pollLogin` 不 await 它;因此它自己不返回
+	* 结果,只负责把结果写进条目并安排回收。
 	*/
 	async runLogin(state, signal) {
+		let entry;
 		try {
 			const token = await pollAuthToken(state, signal);
-			if (token === void 0) return void 0;
-			const entry = buildAccount(token, await getLoginAccount(state, token.accessToken, token.domain));
-			await upsertAccount(entry);
-			this.session?.invalidate();
-			return entry;
+			if (token !== void 0) {
+				entry = buildAccount(token, await getLoginAccount(state, token.accessToken, token.domain));
+				await upsertAccount(entry);
+				this.session?.invalidate();
+			}
 		} catch {
-			return;
+			entry = void 0;
 		}
+		this.settle(state, entry);
+	}
+	/**
+	* 记录一次握手的结局,并在保留窗口之后回收该条目。
+	*
+	* 回收之所以要延迟:客户端是按自己的间隔来问结果的,一结算就删会让那次本已成功的
+	* 登录再也答不出 `done: true`。取消过的握手已不在表里,这里的写入自然丢弃。
+	* @param state - 握手 id。
+	* @param account - 已落盘的账号;失败或取消时为 `undefined`。
+	*/
+	settle(state, account) {
+		const pending = this.pending.get(state);
+		if (pending === void 0) return;
+		pending.settled = true;
+		pending.account = account;
+		setTimeout(() => {
+			if (this.pending.get(state) === pending) this.pending.delete(state);
+		}, LOGIN_RESULT_RETENTION_MS).unref();
 	}
 	/**
 	* 供客户端面板使用的增强版 CodeBuddy 目录:应用了促销/等级展示信息与覆盖配置的模型。
@@ -3774,21 +3933,6 @@ var CodeBuddyAuthService = class {
 };
 //#endregion
 //#region lib/types/prefs.js
-/**
-* CodeBuddy 界面偏好的命名空间契约,Host 与 Client 两面共享。
-*
-* 这些偏好是**插件自己的设置命名空间**里的一段:`Config` 提供部署级 base,
-* 用户在 Web 设置页的写入落在 harness 的用户设置文档里,因此换浏览器、重启
-* harness 后仍然生效 —— 其中「极简模式画图工具」还会被宿主读取来决定
-* `codebuddy-draw` 对模型是否可见,存在浏览器里会让同一次部署因浏览器而异。
-*
-* 本文件必须保持零依赖:两面都会编译它,而 Client 面若因此引入 schemastery
-* 就会把它打进浏览器产物(校验 schema 是宿主面的事,见 `./settings.ts`)。
-*
-* @module dsh-llm-codebuddy-power/prefs
-*/
-/** 本插件拥有的设置命名空间,与插件名一致。 */
-const CODEBUDDY_SETTINGS_NAMESPACE = "llm-codebuddy-power";
 /** 未覆盖任何一层时使用的偏好默认值。 */
 const DEFAULT_CODEBUDDY_SETTINGS = {
 	showUsage: true,
@@ -3798,11 +3942,11 @@ const DEFAULT_CODEBUDDY_SETTINGS = {
 //#endregion
 //#region lib/types/settings.js
 /**
-* 本插件设置命名空间的宿主 schema。
+* 本插件的 `Config` schema —— 连接事实与界面偏好合一。
 *
-* 校验只在宿主发生:浏览器面若也引入 schemastery,它会连同校验器一起被打进
-* `lib/client.js`,而客户端本来就把服务端返回的数据当作已校验结果接收。因此
-* schema 只在此文件出现,浏览器面经 `./prefs.ts` 取同一份类型与默认值。
+* 设置表单只投影**入口自己的 `Config`** 里声明为 `.volatile()` 的字段(入口 id
+* 即命名空间),因此界面偏好字段与连接字段同在 `Config` 中,只有偏好那三个是
+* volatile。
 *
 * 字段的默认值一律取自 `DEFAULT_CODEBUDDY_SETTINGS`,不在此重复字面量 ——
 * 两处各写一份时,改了一处就会出现「宿主默认 90、界面显示 80」这种只有用户
@@ -3810,12 +3954,12 @@ const DEFAULT_CODEBUDDY_SETTINGS = {
 *
 * @module dsh-llm-codebuddy-power/settings
 */
-/** 用户设置文档中本插件命名空间的 schema。 */
-const CodeBuddySettingsSchema = z.object({
-	showUsage: z.boolean().default(DEFAULT_CODEBUDDY_SETTINGS.showUsage),
-	dangerPct: z.number().step(1).min(1).max(100).default(DEFAULT_CODEBUDDY_SETTINGS.dangerPct),
-	drawToolInMinimal: z.boolean().default(DEFAULT_CODEBUDDY_SETTINGS.drawToolInMinimal)
-});
+/** `Config.showUsage` 的 schema。 */
+const ShowUsageField = z.boolean().default(DEFAULT_CODEBUDDY_SETTINGS.showUsage).volatile();
+/** `Config.dangerPct` 的 schema。 */
+const DangerPctField = z.number().step(1).min(1).max(100).default(DEFAULT_CODEBUDDY_SETTINGS.dangerPct).volatile();
+/** `Config.drawToolInMinimal` 的 schema。 */
+const DrawToolInMinimalField = z.boolean().default(DEFAULT_CODEBUDDY_SETTINGS.drawToolInMinimal).volatile();
 //#endregion
 //#region lib/types/index.js
 /**
@@ -3834,9 +3978,9 @@ const CodeBuddySettingsSchema = z.object({
 const name = "llm-codebuddy-power";
 /**
 * 本插件的激活服务。`llm` 承载适配器路由,`tools` 接受文生图工具注册,
-* `agents` 用于极简模式会话中按 agent 限制画图工具可见性。生成图片经
-* 标准附件通道(attachments.saveImage + uiConversation.imageUrl)持久化与
-* 展示,工具注册在附件服务挂载后(`ctx.inject(['attachments'])`)。
+* `agents` 用于极简模式会话中按 agent 限制画图工具可见性。生成图片经标准附件通道
+* (attachments.saveImage + uiConversation.imageUrl)持久化与展示,工具注册在
+* 附件服务挂载后(`ctx.inject(['attachments'])`)。
 */
 const inject = [
 	"llm",
@@ -3844,14 +3988,29 @@ const inject = [
 	"agents"
 ];
 /**
-* 校验并补全原始配置。
+* {@link Config} 的运行时 schema。
 *
-* 编程式构造可以绕过任何 schema,因此边界在此判定,坏值在加载时就带字段名
-* 失败,而不是等到请求中途。
-* @param config - 原始入口配置。
+* 三个界面偏好字段必须是 volatile 才会被设置表单投影,而 volatile 只从
+* schemastery schema 产生;连接字段保持普通字段,因此不在表单里暴露 ——
+* 它们由 profile 的 cordis.patch.yml 配置。
+*/
+const Config = z.object({
+	baseURL: z.string(),
+	defaultContextWindow: z.number().step(1).min(1),
+	defaultMaxTokens: z.number().step(1).min(1),
+	streamIdleTimeoutMs: z.number().min(Number.MIN_VALUE),
+	showUsage: ShowUsageField,
+	dangerPct: DangerPctField,
+	drawToolInMinimal: DrawToolInMinimalField
+});
+/**
+* 从配置解析连接事实。
+*
+* 连接字段在 `Config` 里都是可选的,缺省值即公开的 CodeBuddy 服务。
+* @param config - 入口配置。
 * @returns 解析出的连接事实。
 */
-function resolveConnectionOptions(config = {}) {
+function resolveConnectionOptions(config) {
 	const positiveInteger = (value, field, fallback) => {
 		if (value === void 0) return fallback;
 		if (!Number.isInteger(value) || value <= 0) throw new Error(`dsh-llm-codebuddy-power: ${field} must be a positive integer`);
@@ -3869,34 +4028,23 @@ function resolveConnectionOptions(config = {}) {
 	};
 }
 /**
-* 解析界面偏好的部署级 base 层。用户设置文档中的写入覆盖它。
-*
-* 与 {@link resolveConnectionOptions} 同理,编程式构造可以绕过任何 schema,
-* 因此坏值在此判定并在加载时失败。
-* @param config - 原始入口配置。
-* @returns 设置命名空间的 base 值。
+* 读取界面偏好的当前值。
+* @param config - 入口配置。
+* @returns 三个界面偏好。
 */
-function resolvePrefsBase(config = {}) {
-	const dangerPct = config.dangerPct ?? DEFAULT_CODEBUDDY_SETTINGS.dangerPct;
-	if (!Number.isInteger(dangerPct) || dangerPct < 1 || dangerPct > 100) throw new Error(`dsh-llm-codebuddy-power: dangerPct must be an integer within 1..100`);
+function resolvePrefs(config) {
 	return {
-		showUsage: config.showUsage ?? DEFAULT_CODEBUDDY_SETTINGS.showUsage,
-		dangerPct,
-		drawToolInMinimal: config.drawToolInMinimal ?? DEFAULT_CODEBUDDY_SETTINGS.drawToolInMinimal
+		showUsage: config.showUsage.get(),
+		dangerPct: config.dangerPct.get(),
+		drawToolInMinimal: config.drawToolInMinimal.get()
 	};
 }
 /** 挂载插件:解析配置,然后注册路由。 */
-function apply(ctx, config = {}) {
+function apply(ctx, config) {
 	const resolved = resolveConnectionOptions(config);
-	const prefsBase = resolvePrefsBase(config);
-	let prefsSource = () => prefsBase;
+	const prefsSource = () => resolvePrefs(config);
 	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.installSection(ctx, CODEBUDDY_SETTINGS_NAMESPACE, CodeBuddySettingsSchema, prefsBase, {
-			setSource: (current) => {
-				prefsSource = current;
-			},
-			onChange: () => {}
-		});
+		settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber));
 	});
 	const session = new CodeBuddySession(ctx.logger, () => {
 		ctx.emit("llm/adapters-updated");
@@ -3905,6 +4053,7 @@ function apply(ctx, config = {}) {
 		session,
 		options: () => resolved,
 		resolveAttachments: () => ctx.get("attachments"),
+		resolveImageAccess: (attachments, ref) => resolveImageAttachmentAccess(attachments, (hostPath) => ctx.get("fs")?.processPathFromHostPath(hostPath), ref),
 		resolveOverrides: async (modelId) => {
 			return (await loadOverrides())[modelId];
 		}
@@ -3950,8 +4099,8 @@ function apply(ctx, config = {}) {
 	ctx.on("session/disposed", onSessionDisposed, { global: true });
 	session.isLoggedIn().then((loggedIn) => {
 		if (loggedIn) return;
-		ctx.logger.info("llm-codebuddy-power: no CodeBuddy session stored; sign in through the Settings → CodeBuddy page, or run `dsh plugin --profile web codebuddy-power` (no API key needed).");
+		ctx.logger.info("llm-codebuddy-power: no CodeBuddy session stored; sign in through this plugin's card on the Web sidebar's Plugins page, or run `dsh plugin --profile web codebuddy-power` (no API key needed).");
 	}).catch(() => {});
 }
 //#endregion
-export { AUTH_PENDING_CODE, BLOCKED_MODEL_IDS, CODEBUDDY_AUTH_CHANNEL, CODEBUDDY_AXIOS_USER_AGENT, CODEBUDDY_CHAT_BASE, CODEBUDDY_DISPLAY_NAME, CODEBUDDY_ENDPOINT, CODEBUDDY_IDE_VERSION, CODEBUDDY_PRODUCT_NAME, CODEBUDDY_PROVIDER, CodeBuddyAdapter, CodeBuddyAuthService, CodeBuddySession, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, LOGIN_POLL_INTERVAL_MS, LOGIN_TIMEOUT_MS, NotLoggedInError, REQUEST_IMAGE_DIMENSION_LADDER, REQUEST_IMAGE_MAX_BYTES, apply, fetchEnterpriseUsage, fetchPersonalUsage, fetchUsage, getStoragePath, hasDisclosedCapacity, httpErrorCode, inject, isBlockedModelId, loadSessionInfo, loadStorage, login, name, parseUsage, removeAccounts, resolveConnectionOptions, resolvePrefsBase, setDefaultAccount, setLastAccount, updateSessionInfo, updateStorage, upsertAccount };
+export { AUTH_PENDING_CODE, BLOCKED_MODEL_IDS, CODEBUDDY_AUTH_CHANNEL, CODEBUDDY_AXIOS_USER_AGENT, CODEBUDDY_CHAT_BASE, CODEBUDDY_DISPLAY_NAME, CODEBUDDY_ENDPOINT, CODEBUDDY_IDE_VERSION, CODEBUDDY_PRODUCT_NAME, CODEBUDDY_PROVIDER, CodeBuddyAdapter, CodeBuddyAuthService, CodeBuddySession, Config, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, LOGIN_POLL_INTERVAL_MS, LOGIN_RESULT_RETENTION_MS, LOGIN_TIMEOUT_MS, NotLoggedInError, REQUEST_IMAGE_DIMENSION_LADDER, REQUEST_IMAGE_MAX_BYTES, apply, fetchEnterpriseUsage, fetchPersonalUsage, fetchUsage, getStoragePath, hasDisclosedCapacity, httpErrorCode, inject, isBlockedModelId, loadSessionInfo, loadStorage, login, name, parseUsage, removeAccounts, resolveConnectionOptions, resolvePrefs, setDefaultAccount, setLastAccount, updateSessionInfo, updateStorage, upsertAccount };