@webskill/chatbot 0.24.2 → 0.25.1

package/dist/chatbot.css

@@ -1204,6 +1204,9 @@
   .pb-1 {
     padding-bottom: var(--spacing);
   }
+  .pb-2 {
+    padding-bottom: calc(var(--spacing) * 2);
+  }
   .pb-3 {
     padding-bottom: calc(var(--spacing) * 3);
   }
@@ -1867,6 +1870,11 @@
       color: var(--sidebar-accent-foreground);
     }
   }
+  @media (prefers-reduced-motion: reduce) {
+    .motion-reduce\:animate-none {
+      animation: none;
+    }
+  }
   @media (width < 40rem) {
     .max-sm\:top-0 {
       top: 0px;

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

@@ -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

@@ -340,7 +340,7 @@ interface ChatbotHostAdapter {
   /** xlsx → 行流（`createXlsxBlockReader`）；不注入即 `read_document` 读不了 Excel @experimental */
   xlsxDocumentReader?: XlsxDocumentReader;
   /**
-   * xlsx → 单元格网格（`createXlsxTableReader`）。注入后，估算超过阈值的 xlsx 附件只以画像进消息，
+   * xlsx → 单元格网格或可重复扫描的行流（`createXlsxTableReader`）。注入后，估算超过阈值的 xlsx 附件只以画像进消息，
    * 统计交给 `query_table` 在本机对全表计算（整张表不进上下文）；不注入则两者都不发生。
    * @experimental
    */
@@ -1632,6 +1632,7 @@ declare const chatbotDictionary: {
     'composer.inputLabel': string;
     'composer.send': string;
     'composer.stop': string;
+    'composer.processingAttachments': string;
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
@@ -2092,6 +2093,7 @@ declare const chatbotDictionary: {
     'composer.inputLabel': string;
     'composer.send': string;
     'composer.stop': string;
+    'composer.processingAttachments': string;
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
@@ -2555,6 +2557,7 @@ declare const useT: () => TranslateFn<{
     'composer.inputLabel': string;
     'composer.send': string;
     'composer.stop': string;
+    'composer.processingAttachments': string;
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
@@ -3015,6 +3018,7 @@ declare const useT: () => TranslateFn<{
     'composer.inputLabel': string;
     'composer.send': string;
     'composer.stop': string;
+    'composer.processingAttachments': string;
     'composer.attachments': string;
     'composer.addAttachment': string;
     'composer.removeAttachment': string;
@@ -3494,6 +3498,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.2";
+declare const CHATBOT_VERSION = "0.25.1";
 //#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

@@ -23,7 +23,7 @@ import { ActionBarPrimitive, AttachmentPrimitive, AuiProvider, ComposerPrimitive
 import { BrowserWorkerScriptExecutor, WebOfficePolicy, capturePhoto, checkCameraAvailability, checkDictationAvailability, compressImageToBudget, createEncryptedMemoryStore, createLlmClient, createWebOfficeToolSource, deleteMemoryEncryptionKey, openCamera, openMemoryEncryptionKey, probeChromeBuiltinAvailability, startDictation, toDocumentImage } from "@webskill/sdk/browser";
 import { JsonRenderSpecSurface, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, SpecInteractionChannel, SurfaceFormTextsProvider, UiSurfaceSnapshotList, probeJsonRenderAvailability } from "@webskill/sdk/ui-react";
 import { A2UI_SPEC_FORM_PATH, collectFormScopes, createUiCatalogToolSource, fromA2uiSpecAction, fromA2uiSurfaceAction, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, renderMiniChart, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toVercelToolInvocation, uiCatalog } from "@webskill/sdk/ui";
-import { DownloadedFilePolicy, PAGE_ACTION_KINDS, SCROLL_DIRECTIONS, TodoStore, createDelegationToolSource, createDocumentToolSource, createDownloadedFileToolSource, createDwgToolSource, createPageActionToolSource, createPageImageToolSource, createPagePerceptionToolSource, createRemoteImageToolSource, createSkillGenerationToolSource, createSpreadsheetToolSource, createTabWorksetToolSource, createTableQueryToolSource, createTemplateToolSource, createTodoToolSource, profileTable, sniffDocumentFormat, withDelegationOrigin } from "@webskill/sdk/agent";
+import { DownloadedFilePolicy, PAGE_ACTION_KINDS, SCROLL_DIRECTIONS, TodoStore, createDelegationToolSource, createDocumentToolSource, createDownloadedFileToolSource, createDwgToolSource, createPageActionToolSource, createPageImageToolSource, createPagePerceptionToolSource, createRemoteImageToolSource, createSkillGenerationToolSource, createSpreadsheetToolSource, createTabWorksetToolSource, createTableQueryToolSource, createTemplateToolSource, createTodoToolSource, isStreamingTableWorkbook, profileStreamingTable, profileTable, sniffDocumentFormat, summarizeStreamingWorkbook, withDelegationOrigin } from "@webskill/sdk/agent";
 import { DataRenderers, Tools } from "@assistant-ui/core/react";
 import { ModelContext, Suggestions } from "@assistant-ui/core/store";
 import { Derived, attachTransformScopes, useClientLookup, useClientResource } from "@assistant-ui/store";
@@ -25916,6 +25916,7 @@ const chatbotDictionary = defineDictionary({
 		"composer.inputLabel": "Message input",
 		"composer.send": "Send",
 		"composer.stop": "Stop",
+		"composer.processingAttachments": "Processing attachments on this device. Large files may take a while; please keep this chat open…",
 		"composer.attachments": "Attachments",
 		"composer.addAttachment": "Attach a file",
 		"composer.removeAttachment": "Remove attachment: {name}",
@@ -26376,6 +26377,7 @@ const chatbotDictionary = defineDictionary({
 		"composer.inputLabel": "消息输入框",
 		"composer.send": "发送",
 		"composer.stop": "停止",
+		"composer.processingAttachments": "正在本机处理附件，大文件可能需要一些时间，请保持对话打开…",
 		"composer.attachments": "附件",
 		"composer.addAttachment": "添加附件",
 		"composer.removeAttachment": "移除附件：{name}",
@@ -27918,7 +27920,7 @@ function smallTableHint(id) {
 * 已解析的表按「会话 + 来源」缓存（FR-10.17）。
 *
 * 缓存的是进行中的 promise：分流时解析一次，紧接着的查询复用同一份；失败不留。
-* 容量 2、最近使用淘汰——一张 2 万 × 12 的网格在堆里是十余 MB，
+* 容量 2、最近使用淘汰——网格工作簿会占堆内存，流式工作簿只缓存元数据与取件出口，
 * 留两格是为「同一会话里先后传两份表做对比」。
 */
 var TableCache = class {
@@ -29474,33 +29476,56 @@ var ChatEngine = class {
 		if (extract === void 0) return void 0;
 		return await extract(bytes);
 	}
+	async #readTable(reader, path) {
+		if (reader.readStreaming !== void 0) {
+			const storage = this.#adapter.storage;
+			if (storage.createReadStream !== void 0) return await reader.readStreaming(() => storage.createReadStream(path));
+			return await reader.readStreaming(await storage.readBinary(path));
+		}
+		return await reader.read(await this.#adapter.storage.readBinary(path));
+	}
 	/**
 	* xlsx 附件的发送形态分流（0.26.0 分册 10 · FR-10.1 / FR-10.5）。
 	*
 	* 返回 `undefined` = 不适用（没接端口、不是 xlsx、解析失败），调用方走 0.25.0 的原路径——
 	* 解析失败时同一份坏文件会在原路径里以既有的形态报错，这里不新增失败形态。
-	* 解析在这里先做一次、网格进缓存，随后的 `query_table` 复用同一份。
+	* 解析在这里先做一次、工作簿进缓存，随后的 `query_table` 复用同一份。
 	*/
 	async #tableRouting(attachment, path, sessionId) {
 		const reader = this.#adapter.xlsxTableReader;
 		if (reader === void 0 || attachment.kind !== "document-text") return void 0;
 		if (extractedDocumentFormat(attachment.contentType, attachment.name) !== "xlsx") return void 0;
-		const workbook = await this.#tables.get(sessionId, `att:${attachment.path}`, async () => reader.read(await this.#adapter.storage.readBinary(path))).catch(() => void 0);
+		const workbook = await this.#tables.get(sessionId, `att:${attachment.path}`, async () => this.#readTable(reader, path)).catch(() => void 0);
 		if (workbook === void 0) return void 0;
-		const tokens = estimateTableTokens(workbook);
+		let tokens;
+		let rows;
+		let profile;
+		if (isStreamingTableWorkbook(workbook)) {
+			const summary = await summarizeStreamingWorkbook(workbook);
+			tokens = summary.tokens;
+			rows = summary.dataRows;
+			profile = () => profileStreamingTable({
+				name: attachment.name,
+				id: attachment.id,
+				workbook
+			});
+		} else {
+			tokens = estimateTableTokens(workbook);
+			rows = countDataRows(workbook);
+			profile = () => Promise.resolve(profileTable({
+				name: attachment.name,
+				id: attachment.id,
+				workbook
+			}));
+		}
 		if (tokens <= 24e3) return {
 			kind: "inline",
 			hint: smallTableHint(attachment.id)
 		};
-		const rows = countDataRows(workbook);
 		const locale = this.#liveConfig?.appearance.locale ?? "en";
 		return {
 			kind: "profile",
-			profile: profileTable({
-				name: attachment.name,
-				id: attachment.id,
-				workbook
-			}),
+			profile: await profile(),
 			steering: tableQuerySteering({
 				id: attachment.id,
 				tokens,
@@ -29523,8 +29548,22 @@ var ChatEngine = class {
 	async #downloadSheetRouting(input) {
 		const reader = this.#adapter.xlsxTableReader;
 		if (reader === void 0) return void 0;
-		const workbook = await this.#tables.get(this.#currentSessionId ?? "", `dl:${input.entry.id}`, () => reader.read(input.bytes)).catch(() => void 0);
+		const workbook = await this.#tables.get(this.#currentSessionId ?? "", `dl:${input.entry.id}`, () => reader.readStreaming !== void 0 ? reader.readStreaming(input.bytes) : reader.read(input.bytes)).catch(() => void 0);
 		if (workbook === void 0) return void 0;
+		if (isStreamingTableWorkbook(workbook)) {
+			const summary = await summarizeStreamingWorkbook(workbook);
+			if (summary.tokens <= 24e3 && summary.textChars <= ATTACHMENT_TEXT_LIMIT) return void 0;
+			return `${await profileStreamingTable({
+				name: input.entry.name,
+				id: input.entry.id,
+				workbook
+			})}\n\n` + tableQuerySteering({
+				id: input.entry.id,
+				tokens: summary.tokens,
+				rows: summary.dataRows,
+				download: true
+			});
+		}
 		const tokens = estimateTableTokens(workbook);
 		if (tokens <= 24e3 && tableTextChars(workbook) <= ATTACHMENT_TEXT_LIMIT) return void 0;
 		return `${profileTable({
@@ -29554,7 +29593,7 @@ var ChatEngine = class {
 		const notXlsx = (name) => new WebSkillError("TOOL_UNSUPPORTED", `"${name}" is not an Excel (.xlsx) workbook; query_table reads .xlsx only.`);
 		const fromAttachment = async (a) => {
 			if (a.kind !== "document-text" || extractedDocumentFormat(a.contentType, a.name) !== "xlsx") throw notXlsx(a.name);
-			const workbook = await this.#tables.get(sessionId, `att:${a.path}`, async () => reader.read(await this.#adapter.storage.readBinary(`${this.attachmentsRoot}/${a.path}`)));
+			const workbook = await this.#tables.get(sessionId, `att:${a.path}`, async () => this.#readTable(reader, `${this.attachmentsRoot}/${a.path}`));
 			return {
 				name: a.name,
 				workbook
@@ -29575,7 +29614,7 @@ var ChatEngine = class {
 			if (sniffDocumentFormat(bytes, name) !== "xlsx") throw notXlsx(name);
 			return {
 				name,
-				workbook: await this.#tables.get(sessionId, source, () => reader.read(bytes))
+				workbook: await this.#tables.get(sessionId, source, () => reader.readStreaming !== void 0 ? reader.readStreaming(bytes) : reader.read(bytes))
 			};
 		};
 		const stored = context?.binaries?.get(id);
@@ -30180,6 +30219,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 +30288,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) })] : [],
@@ -30234,7 +30305,16 @@ var ChatEngine = class {
 			}),
 			...this.#adapter.xlsxTableReader ? [createTableQueryToolSource({
 				tables: { load: (id, context) => this.#loadTable(id, context, downloadPolicy) },
-				downloadedFiles: () => downloadPolicy?.enabled === true
+				downloadedFiles: () => downloadPolicy?.enabled === true,
+				writeArtifact: (path, content, mimeType, context) => {
+					if (!context?.runId) throw new WebSkillError("TOOL_EXECUTION_FAILED", "Writing a query result requires an active run.");
+					return artifactStore.createBinaryArtifact({
+						runId: context.runId,
+						path,
+						content,
+						mimeType
+					});
+				}
 			})] : [],
 			...this.#adapter.xlsxTemplateEngine || this.#adapter.docxTemplateEngine ? [createTemplateToolSource({
 				files: { read: readTemplateBytes },
@@ -32410,7 +32490,7 @@ function ModelMenuButton({ models }) {
 		}, option.id))
 	})] });
 }
-function AssistantUiComposer({ running, disabled = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, onDictationPermissionDenied, onCameraPermissionDenied, capabilities }) {
+function AssistantUiComposer({ running, disabled = false, processingAttachments = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, onDictationPermissionDenied, onCameraPermissionDenied, capabilities }) {
 	const t = useT();
 	const locale = useLocale();
 	const dictation = useComposerDictation(dictationLang ?? DEFAULT_DICTATION_LANG[locale], onDictationPermissionDenied);
@@ -32427,11 +32507,20 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 	const cameraReason = !attachments ? t("composer.camera.noStorage") : attachmentReason ?? (camera.availability.available ? void 0 : t(`composer.camera.${camera.availability.reason}`));
 	const cameraFailure = camera.failure === void 0 ? void 0 : camera.failure === "denied" && onCameraPermissionDenied !== void 0 ? t("composer.camera.denied.handoff") : t(`composer.camera.${camera.failure}`);
 	const plainChatHintId = useId();
-	return /* @__PURE__ */ jsx(ComposerPrimitive.Root, {
+	return /* @__PURE__ */ jsxs(ComposerPrimitive.Root, {
 		"data-testid": "assistant-ui-composer",
 		"data-centered": centered,
 		className: "webskill-aui-composer shrink-0 px-4 py-4",
-		children: /* @__PURE__ */ jsxs(ComposerPrimitive.AttachmentDropzone, {
+		children: [processingAttachments ? /* @__PURE__ */ jsxs("div", {
+			"data-testid": "attachment-processing",
+			role: "status",
+			"aria-live": "polite",
+			className: "webskill-chat-prose mx-auto flex w-full items-center gap-2 px-3 pb-2 text-xs text-muted",
+			children: [/* @__PURE__ */ jsx(LoaderCircle, {
+				className: "size-3.5 shrink-0 animate-spin motion-reduce:animate-none",
+				"aria-hidden": true
+			}), /* @__PURE__ */ jsx("span", { children: t("composer.processingAttachments") })]
+		}) : null, /* @__PURE__ */ jsxs(ComposerPrimitive.AttachmentDropzone, {
 			disabled: !attachments,
 			className: "webskill-aui-composer-shell webskill-chat-prose mx-auto flex w-full flex-col gap-2 px-3 py-2 transition-colors data-[dragging=true]:border-ring",
 			children: [
@@ -32657,7 +32746,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 					onCancel: camera.cancel
 				})
 			]
-		})
+		})]
 	});
 }
 
@@ -42948,6 +43037,22 @@ function fallbackReason(error) {
 	const code = error?.code;
 	return typeof code === "string" && code !== "" ? code : "a2ui-render-failed";
 }
+function formControlValues(root) {
+	const values = {};
+	const visit = (node) => {
+		for (const child of node.children) {
+			if (child instanceof HTMLInputElement) {
+				if (child.id) values[child.id] = child.type === "checkbox" ? child.checked : child.type === "number" ? Number(child.value) : child.value;
+			} else if (child instanceof HTMLTextAreaElement || child instanceof HTMLSelectElement) {
+				if (child.id) values[child.id] = child instanceof HTMLSelectElement && child.multiple ? [...child.selectedOptions].map((option) => option.value) : child.value;
+			}
+			if (child.shadowRoot) visit(child.shadowRoot);
+			else visit(child);
+		}
+	};
+	if (root) visit(root.shadowRoot ?? root);
+	return values;
+}
 /**
 * `a2ui` 档：catalog 声明树经 BYOC catalog 的 Lit 元素渲染。
 * 元素与协议里公布的 `catalog_definition` 派生自同一份 shape，因此这里
@@ -42958,6 +43063,7 @@ function fallbackReason(error) {
 */
 function A2uiSpecSurface({ spec, surfaceId, actions, onAction, registry, runId, draft, onDraftChange }) {
 	const mountRef = useRef(null);
+	const formValuesRef = useRef({});
 	const [fallback, setFallback] = useState();
 	const emit = useEffectEvent((actionId, value) => {
 		const declared = (actions ?? []).find((action) => action.id === actionId);
@@ -42987,8 +43093,11 @@ function A2uiSpecSurface({ spec, surfaceId, actions, onAction, registry, runId,
 				const processor = new MessageProcessor([catalog, lit.basicCatalog], (action) => {
 					const decoded = fromA2uiSpecAction(action);
 					if (!decoded) return;
-					const values = processor.getClientDataModel("v0.9.1")?.surfaces?.[a2uiSurfaceId]?.[A2UI_SPEC_FORM_PATH.slice(1)];
-					emit(decoded.actionId, values ?? {});
+					const values = {
+						...processor.getClientDataModel("v0.9.1")?.surfaces?.[a2uiSurfaceId]?.[A2UI_SPEC_FORM_PATH.slice(1)],
+						...formControlValues(surfaceElement)
+					};
+					emit(decoded.actionId, values);
 				}, { version: "v0.9.1" });
 				processor.onSurfaceCreated((surface) => {
 					if (disposed) return;
@@ -42997,6 +43106,21 @@ function A2uiSpecSurface({ spec, surfaceId, actions, onAction, registry, runId,
 					mount.replaceChildren(surfaceElement);
 				});
 				processor.processMessages(toA2uiSpecMessages(uiCatalog, spec, { surfaceId: a2uiSurfaceId }));
+				const previousValues = formValuesRef.current;
+				if (Object.keys(previousValues).length > 0) {
+					const defaults = processor.getClientDataModel("v0.9.1")?.surfaces?.[a2uiSurfaceId]?.[A2UI_SPEC_FORM_PATH.slice(1)];
+					processor.processMessages([{
+						version: "v0.9.1",
+						updateDataModel: {
+							surfaceId: a2uiSurfaceId,
+							path: A2UI_SPEC_FORM_PATH,
+							value: {
+								...defaults,
+								...previousValues
+							}
+						}
+					}]);
+				}
 			} catch (error) {
 				reportA2uiFallback(surfaceId, "spec", error);
 				if (!disposed) setFallback(fallbackReason(error));
@@ -43004,6 +43128,8 @@ function A2uiSpecSurface({ spec, surfaceId, actions, onAction, registry, runId,
 		})();
 		return () => {
 			disposed = true;
+			const values = surfaceElement?.surface?.dataModel.get(A2UI_SPEC_FORM_PATH);
+			if (typeof values === "object" && values !== null && !Array.isArray(values)) formValuesRef.current = values;
 			surfaceElement?.remove();
 		};
 	}, [spec, surfaceId]);
@@ -46021,6 +46147,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 	const [loadingEarlierMessages, setLoadingEarlierMessages] = useState(false);
 	const [currentSessionId, setCurrentSessionId] = useState();
 	const [sending, setSending] = useState(false);
+	const [processingAttachments, setProcessingAttachments] = useState(false);
 	/** 这一条排在同会话的上一条后面（FR-20.3）：排队本身保护历史顺序，要改的是它不可见 */
 	const [queuedSend, setQueuedSend] = useState(false);
 	/**
@@ -46291,6 +46418,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 				setError(void 0);
 				break;
 			case "message-complete":
+				if (event.message.role === "user") setProcessingAttachments(false);
 				setMessages((prev) => prev.some((message) => message.id === event.message.id) ? prev : [...prev, event.message]);
 				break;
 			case "interaction-requested":
@@ -46364,7 +46492,13 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			setNoModelGuideOpen(true);
 			return;
 		}
+		const hasAttachments = attachments.length > 0;
+		if (hasAttachments) {
+			setProcessingAttachments(true);
+			setSending(true);
+		}
 		(async () => {
+			if (hasAttachments) await new Promise((resolve) => setTimeout(resolve, 0));
 			await flushPendingDeletes();
 			let sessionId = currentSessionId;
 			if (!sessionId) {
@@ -46376,7 +46510,13 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			const needsTitle = sessionsRef.current.find((session) => session.id === sessionId)?.title === void 0;
 			await engine.send(text, attachments);
 			if (needsTitle) await refreshSessions();
-		})().catch((e) => setError({ message: toErrorMessage(e) }));
+		})().catch((e) => {
+			if (hasAttachments) {
+				setProcessingAttachments(false);
+				setSending(false);
+			}
+			setError({ message: toErrorMessage(e) });
+		});
 	}, [
 		engine,
 		currentSessionId,
@@ -46732,6 +46872,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 										} } : {},
 										running: busy,
 										disabled: interactionPending,
+										processingAttachments,
 										...interactionTarget !== void 0 ? { waitTarget: interactionTarget } : {},
 										centered: composerCentered,
 										attachments: attachmentsReady,
@@ -46820,7 +46961,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.24.2";
+const CHATBOT_VERSION = "0.25.1";
 
 //#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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/chatbot",
-  "version": "0.24.2",
+  "version": "0.25.1",
   "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.27.0",
+    "@webskill/sdk": "^0.28.1",
     "mermaid": "^12.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",