@webskill/chatbot 0.24.1 → 0.24.3

package/dist/config.d.ts

@@ -58,15 +58,22 @@ interface ApplyConfigDefaultsInput {
   /** 上次应用过的缺省值快照，可缺席 */
   readonly lastApplied?: WebSkillConfigDefaults;
 }
-/** 合并结果：可直接使用的配置，以及要持久化的本次缺省值快照 @experimental */
+/** 合并结果：可直接使用的配置，以及要持久化的本次快照 @experimental */
 interface AppliedConfigDefaults {
   readonly config: RuntimeConfig;
-  /** 本次应用的缺省值；调用方负责持久化，下次作为 `lastApplied` 传回 */
+  /**
+   * 本次应用的快照；调用方负责持久化，下次作为 `lastApplied` 传回。
+   * 有烘焙模型时它还带一个内部同步状态（0.27.1），**必须整对象存取**——
+   * 只挑 `WebSkillConfigDefaults` 的已知键会把状态丢掉。
+   */
   readonly snapshot: WebSkillConfigDefaults;
 }
 /**
  * `lastApplied` 缺席时每条分支都退化成「stored 存在就取 stored」，
  * 即老实现的 `deepMerge(defaults, stored)`——修订跟随是纯增量，不改既有语义。
+ *
+ * 快照里的内部同步状态只在有烘焙模型时出现；它不是 `RuntimeConfig` 字段，
+ * 宿主照旧整存整取快照即可。
  * @experimental
  */
 declare function applyConfigDefaults(input: ApplyConfigDefaultsInput): AppliedConfigDefaults;
@@ -97,7 +104,13 @@ declare const BAKED_KEY_SENTINEL = "\0webskill:baked-api-key";
  * @experimental
  */
 type BakedSecretLoader = () => Promise<Readonly<Record<string, string>>>;
-/** 上次生效的缺省值快照仓；存哪儿由宿主决定 @experimental */
+/**
+ * 上次生效的缺省值快照仓；存哪儿由宿主决定。
+ *
+ * 快照除了 `WebSkillConfigDefaults` 还可能带内部同步状态（0.27.1），
+ * 因此宿主必须**整对象存取**，不能只挑已知键。
+ * @experimental
+ */
 interface ConfigDefaultsSnapshotStore {
   read(): Promise<WebSkillConfigDefaults | undefined> | WebSkillConfigDefaults | undefined;
   write(snapshot: WebSkillConfigDefaults): Promise<void> | void;

package/dist/config.js

@@ -1,5 +1,5 @@
 import { r as mergeRuntimeConfigDefaults } from "./types-DzBMgDa6.js";
-import { a as NON_CONFIGURABLE_RUNTIME_PATHS, i as CONFIG_FIELDS, n as parseWebSkillConfig, o as WebSkillConfigError, r as CONFIGURED_RUNTIME_PATHS, t as CONFIG_TOP_LEVEL_SECTIONS } from "./parse-BaIF8Nm5.js";
+import { a as NON_CONFIGURABLE_RUNTIME_PATHS, i as CONFIG_FIELDS, n as parseWebSkillConfig, o as WebSkillConfigError, r as CONFIGURED_RUNTIME_PATHS, t as CONFIG_TOP_LEVEL_SECTIONS } from "./parse-B6YPceVb.js";
 
 //#region ../ui-kit/src/runtime-config/siteAccess.ts
 /**
@@ -57,6 +57,7 @@ function isAllowedSite(url, allowedHosts) {
 
 //#endregion
 //#region src/config/merge.ts
+const BAKED_SYNC_KEY = "__webskillBakedSync";
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -91,28 +92,125 @@ function mergeLeaf(stored, defaultValue, lastApplied) {
 	if (lastApplied !== void 0 && sameValue(stored, lastApplied)) return defaultValue;
 	return stored;
 }
+/** 模型列表内容的摘要；只用于判断「与上次记录相比有没有变」，不是加密承诺 */
+function fingerprintEntries(value) {
+	let text;
+	try {
+		text = JSON.stringify(value ?? []) ?? "null";
+	} catch {
+		return "unserializable";
+	}
+	let h1 = 2166136261;
+	let h2 = 16777619;
+	for (let i = 0; i < text.length; i += 1) {
+		const code = text.charCodeAt(i);
+		h1 = Math.imul(h1 ^ code, 16777619) >>> 0;
+		h2 = Math.imul(h2 ^ code, 2246822507) >>> 0;
+	}
+	return `${text.length}:${h1.toString(16)}:${h2.toString(16)}`;
+}
+/** 读快照里的内部状态；形状非法时当作没有（旧快照 / 手改过的存储） */
+function readBakedSync(snapshot) {
+	if (snapshot === void 0) return void 0;
+	const value = snapshot[BAKED_SYNC_KEY];
+	if (!isPlainObject(value)) return void 0;
+	const mode = value["mode"];
+	const fingerprint = value["fingerprint"];
+	if ((mode === "baked" || mode === "repair" || mode === "user") && typeof fingerprint === "string") return {
+		mode,
+		fingerprint
+	};
+}
+/**
+* 旧快照的一次性修复：只补烘焙条目里存储缺失的键，不覆盖已有值。
+*
+* 旧快照分不出「上一次下发留下的旧条目」与「用户主动清空过一个字段」，
+* 所以只能补缺失：`contextWindow`、`capabilities.image` 这类新字段能回来，
+* 用户改过的 `baseUrl` / `apiKey` / `image: false` 一个字不动。
+*/
+function fillMissingValue(current, fallback) {
+	if (current === void 0) return fallback;
+	if (isPlainObject(current) && isPlainObject(fallback)) {
+		const out = { ...current };
+		for (const key of Object.keys(fallback)) {
+			if (key === "apiKey") continue;
+			const value = fillMissingValue(current[key], fallback[key]);
+			if (value !== void 0) out[key] = value;
+		}
+		return out;
+	}
+	return current;
+}
+function repairBakedEntries(entries, baked) {
+	const byId = new Map(baked.map((entry) => [entry.id, entry]));
+	return entries.map((entry) => {
+		const source = byId.get(entry.id);
+		return source === void 0 ? entry : fillMissingValue(entry, source);
+	});
+}
 /**
-* 烘焙模型按 id 强制同步（0.21.0 分册 24 · FR-24.1）。
+* 烘焙模型按 id 强制同步（0.21.0 分册 24 · FR-24.1），并记住「下发/修复之后
+* 用户存储有没有变」（0.27.1 分册 10）。
 *
 * 与 `mergeLeaf` 的「缺省值」语义不同，这里是**下发**：整片 `entries` 是一片叶子，
-* 用户只要动过列表任意一处，此后所有重新打包的模型配置都到不了他那里。
+* 不做字段级合并，以免造出「一半新一半旧」的端点。
 * 所以烘焙条目按 id 整条覆盖、按 defaults 的顺序在前，用户自建的按原相对序在末尾。
 *
-* 但下发只在**运维真的重新打包过模型配置时**发生（FR-24.1d）：烘焙列表与快照逐字
+* 下发只在**运维真的重新打包过模型配置时**发生（FR-24.1d）：烘焙列表与快照逐字
 * 相同，说明这一版没人改过 `config.json`，此时用户在 Console 里的改动与排序全部作数。
 * 快照缺席（全新安装或重装扩展）按「变了」处理——那正是「恢复初始化配置」的时刻。
 *
 * 读的是 `stored` 原始值而不是合并后的那份：合并后的 `entries` 已经被叶子规则
 * 选过边，从它数不准「用户自建了哪些」。
+*
+* 0.27.1 之前，下发结果没有落进 `stored`，快照却在第一次加载后变成了新烘焙列表；
+* 第二次加载因此误判「用户没动过」的分支为「用户胜出」，把刚下发的字段丢掉。
+* 内部状态记录了下发那一刻 `stored` 的指纹：指纹没变就继续下发/修复，
+* 变了才是用户真的动过。
 */
-function syncBakedEntries(stored, baked, previous, retired) {
+function syncBakedEntries(stored, baked, previous, lastApplied, retired) {
+	const raw = Array.isArray(stored) ? stored : [];
+	const fingerprint = fingerprintEntries(raw);
+	const state = readBakedSync(lastApplied);
+	const bakedChanged = previous === void 0 || !sameValue(previous, baked);
+	const kept = raw.filter((entry) => isPlainObject(entry) && typeof entry["id"] === "string" && !retired.has(entry["id"]));
 	const bakedIds = new Set(baked.map((entry) => entry.id));
-	const kept = Array.isArray(stored) ? stored.filter((entry) => isPlainObject(entry) && typeof entry["id"] === "string" && !retired.has(entry["id"])) : [];
-	if (previous !== void 0 && sameValue(previous, baked)) {
-		const storedIds = new Set(kept.map((entry) => entry.id));
-		return [...kept, ...baked.filter((entry) => !storedIds.has(entry.id))];
-	}
-	return [...baked, ...kept.filter((entry) => !bakedIds.has(entry.id))];
+	const keptIds = new Set(kept.map((entry) => entry.id));
+	const bakedFirst = [...baked, ...kept.filter((entry) => !bakedIds.has(entry.id))];
+	const storedFirst = [...kept, ...baked.filter((entry) => !keptIds.has(entry.id))];
+	if (bakedChanged) return {
+		entries: bakedFirst,
+		state: {
+			mode: "baked",
+			fingerprint
+		}
+	};
+	if (state === void 0) return {
+		entries: repairBakedEntries(storedFirst, baked),
+		state: {
+			mode: "repair",
+			fingerprint
+		}
+	};
+	if (state.fingerprint !== fingerprint) return {
+		entries: storedFirst,
+		state: {
+			mode: "user",
+			fingerprint
+		}
+	};
+	if (state.mode === "baked") return {
+		entries: bakedFirst,
+		state
+	};
+	if (state.mode === "repair") return {
+		entries: repairBakedEntries(storedFirst, baked),
+		state
+	};
+	return {
+		entries: storedFirst,
+		state
+	};
 }
 /**
 * 上一版烘过、这一版不再烘的 id（FR-24.5）。
@@ -133,30 +231,40 @@ function resolveDefaultId(entries, current) {
 /** `llm.entries` 之外的一切仍走 0.20.0 的逐叶子规则 */
 function applyBakedModels(merged, stored, defaults, lastApplied) {
 	const baked = defaults.llm?.entries;
-	if (baked === void 0 || !isPlainObject(merged)) return merged;
+	if (baked === void 0 || !isPlainObject(merged)) return { merged };
 	const storedLlm = isPlainObject(stored) ? stored["llm"] : void 0;
-	const entries = syncBakedEntries(isPlainObject(storedLlm) ? storedLlm["entries"] : void 0, baked, lastApplied?.llm?.entries, retiredBakedIds(lastApplied, baked));
+	const sync = syncBakedEntries(isPlainObject(storedLlm) ? storedLlm["entries"] : void 0, baked, lastApplied?.llm?.entries, lastApplied, retiredBakedIds(lastApplied, baked));
 	const llm = isPlainObject(merged["llm"]) ? merged["llm"] : {};
-	const defaultId = resolveDefaultId(entries, llm["defaultId"]);
+	const defaultId = resolveDefaultId(sync.entries, llm["defaultId"]);
 	return {
-		...merged,
-		llm: {
-			...llm,
-			entries,
-			...defaultId === void 0 ? {} : { defaultId }
-		}
+		merged: {
+			...merged,
+			llm: {
+				...llm,
+				entries: sync.entries,
+				...defaultId === void 0 ? {} : { defaultId }
+			}
+		},
+		state: sync.state
 	};
 }
 /**
 * `lastApplied` 缺席时每条分支都退化成「stored 存在就取 stored」，
 * 即老实现的 `deepMerge(defaults, stored)`——修订跟随是纯增量，不改既有语义。
+*
+* 快照里的内部同步状态只在有烘焙模型时出现；它不是 `RuntimeConfig` 字段，
+* 宿主照旧整存整取快照即可。
 * @experimental
 */
 function applyConfigDefaults(input) {
 	const { stored, defaults, lastApplied } = input;
+	const baked = applyBakedModels(stored === void 0 ? defaults : mergeLeaf(stored, defaults, lastApplied), stored, defaults, lastApplied);
 	return {
-		config: mergeRuntimeConfigDefaults(applyBakedModels(stored === void 0 ? defaults : mergeLeaf(stored, defaults, lastApplied), stored, defaults, lastApplied)),
-		snapshot: defaults
+		config: mergeRuntimeConfigDefaults(baked.merged),
+		snapshot: baked.state === void 0 ? defaults : {
+			...defaults,
+			[BAKED_SYNC_KEY]: baked.state
+		}
 	};
 }
 

package/dist/index.d.ts

@@ -3494,6 +3494,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.24.1";
+declare const CHATBOT_VERSION = "0.24.3";
 //#endregion
 export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatComponent, type ChatComponentCallRecord, type ChatComponentConfirmation, type ChatComponentCredentialField, type ChatComponentInvokeContext, type ChatComponentOutcome, type ChatComponentStore, type ChatComponentText, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, ChatbotVisionDelegate, type ChatbotVisionDelegateOptions, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, type DwgHost, ErrorCard, type ErrorCardProps, type HttpMessageComponentOptions, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, type LocalizedText, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeQuickPrompt, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, type VisionDelegationConsent, type VisionDelegationEndpoint, WEB_OFFICE_TEMPLATE_PREFIX, chatbotDictionary, configureA2uiMarkdown, createHttpMessageComponent, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/dist/index.js

@@ -30180,6 +30180,45 @@ var ChatEngine = class {
 		*/
 		const hasTemplateEngine = Boolean(this.#adapter.xlsxTemplateEngine || this.#adapter.docxTemplateEngine);
 		const templateIdHints = [...this.#adapter.webOfficeTemplateSource ? [`For a document open in an online office viewer on the page, use "${WEB_OFFICE_TEMPLATE_PREFIX}<handle>" with the handle from list_weboffice_documents.`] : [], ...hasTemplateEngine && await this.#hasSkillResources(fs) ? [`For a file that ships inside an installed skill, use "${SKILL_FILE_PREFIX}<skill name>/<path inside the skill>", for example "${SKILL_FILE_PREFIX}quotation/assets/template.xlsx".`] : []];
+		/**
+		* 页面取像预算（0.27.1 分册 11）。
+		*
+		* 普通读页（`requested: false`）只认主模型自身能看图；显式 `images: true`
+		* 才允许用可用的视觉委派兜底。两条路径共享同一份配置读取，避免数值漂移。
+		*/
+		const pageImageBudget = async (requested) => {
+			const live = await this.#runtimeConfigStore()?.load();
+			const maxImageBytes = live?.multimodal.maxImageBytes ?? 0;
+			const maxImages = live?.multimodal.maxImagesPerMessage ?? 0;
+			const minImageArea = live?.multimodal.minImageArea ?? 0;
+			if (!(live?.multimodal.pageImageCapture ?? false)) return {
+				enabled: false,
+				maxImageBytes,
+				maxImages,
+				minImageArea,
+				unavailableReason: "Page image capture is turned off in the host settings."
+			};
+			if (entryCapabilities(pickLlmEntry(live, this.#selectedModelId)).image) return {
+				enabled: true,
+				maxImageBytes,
+				maxImages,
+				minImageArea
+			};
+			if (!requested) return {
+				enabled: false,
+				maxImageBytes,
+				maxImages,
+				minImageArea
+			};
+			const delegated = await this.#visionDelegate?.applies() === true;
+			return {
+				enabled: delegated,
+				maxImageBytes,
+				maxImages,
+				minImageArea,
+				...delegated ? {} : { unavailableReason: "No image-capable model is configured. Select a multimodal model or add one in Console." }
+			};
+		};
 		const baseTools = [
 			...pageSkillSource ? [pageSkillSource] : [],
 			createSpreadsheetToolSource({
@@ -30210,15 +30249,8 @@ var ChatEngine = class {
 			...pagePerception ? [createPagePerceptionToolSource({
 				policy: pagePerception,
 				...this.#adapter.pagePerceptionPaging === void 0 ? {} : { paging: () => this.#adapter.pagePerceptionPaging },
-				imageCapture: async () => {
-					const live = await this.#runtimeConfigStore()?.load();
-					return {
-						enabled: (live?.multimodal.pageImageCapture ?? false) && entryCapabilities(pickLlmEntry(live, this.#selectedModelId)).image,
-						maxImageBytes: live?.multimodal.maxImageBytes ?? 0,
-						maxImages: live?.multimodal.maxImagesPerMessage ?? 0,
-						minImageArea: live?.multimodal.minImageArea ?? 0
-					};
-				}
+				imageCapture: () => pageImageBudget(false),
+				imageCaptureForRequest: () => pageImageBudget(true)
 			})] : [],
 			...this.#adapter.pageActions ? [createPageActionToolSource({ policy: this.#adapter.pageActions })] : [],
 			...this.#adapter.pageImage ? [createPageImageToolSource({ capture: (input, context) => this.#capturePageImage(this.#adapter.pageImage, artifactStore, input, context?.runId) })] : [],
@@ -46820,7 +46852,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.24.1";
+const CHATBOT_VERSION = "0.24.3";
 
 //#endregion
 export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, ChatbotVisionDelegate, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, WEB_OFFICE_TEMPLATE_PREFIX, chatbotDictionary, configureA2uiMarkdown, createHttpMessageComponent, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/dist/{parse-BaIF8Nm5.js → parse-B6YPceVb.js}

@@ -480,7 +480,8 @@ function parseModels(raw, secrets, root) {
 			"model",
 			"requestTimeoutMs",
 			"capabilities",
-			"thinkingBudgetTokens"
+			"thinkingBudgetTokens",
+			"contextWindow"
 		], path);
 		const id = readString(source["id"], `${path}.id`);
 		if (seen.has(id)) fail("CONFIG_REFERENCE", `${path}.id`, `${path}.id duplicates an earlier entry: ${id}`);
@@ -495,6 +496,7 @@ function parseModels(raw, secrets, root) {
 		if (source["baseUrl"] !== void 0) entry.baseUrl = readString(source["baseUrl"], `${path}.baseUrl`);
 		if (source["requestTimeoutMs"] !== void 0) entry.requestTimeoutMs = readInt(source["requestTimeoutMs"], `${path}.requestTimeoutMs`, LLM_ENTRY_BOUNDS.requestTimeoutMs);
 		if (source["thinkingBudgetTokens"] !== void 0) entry.thinkingBudgetTokens = readInt(source["thinkingBudgetTokens"], `${path}.thinkingBudgetTokens`);
+		if (source["contextWindow"] !== void 0) entry.contextWindow = readInt(source["contextWindow"], `${path}.contextWindow`, LLM_ENTRY_BOUNDS.contextWindow);
 		if (source["capabilities"] !== void 0) {
 			const caps = expectObject(source["capabilities"], `${path}.capabilities`);
 			rejectUnknownKeys(caps, ["tools", "image"], `${path}.capabilities`);

package/dist/vite.js

@@ -1,4 +1,4 @@
-import { n as parseWebSkillConfig } from "./parse-BaIF8Nm5.js";
+import { n as parseWebSkillConfig } from "./parse-B6YPceVb.js";
 import { readFileSync } from "node:fs";
 import { webcrypto } from "node:crypto";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/chatbot",
-  "version": "0.24.1",
+  "version": "0.24.3",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -38,7 +38,7 @@
     "@a2ui/web_core": "^0.10.5",
     "@lit/context": "^1.1.0",
     "@openuidev/react-lang": "0.2.8",
-    "@webskill/sdk": "^0.26.0",
+    "@webskill/sdk": "^0.27.1",
     "mermaid": "^12.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",