@webskill/chatbot 0.9.0 → 0.10.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { t as yaml } from "./yaml-C888tCbJ.js";
 import { t as json } from "./json-BOcU6nei.js";
 import { t as typescript } from "./typescript-DAau_Qyl.js";
 import { t as jsx$1 } from "./jsx-D2Jv0wvt.js";
-import { BEHAVIOR_RECORDS_KEY, DEFAULT_LOOP_LIMITS, DEFAULT_USER_PROFILE_LIMITS, EventBus, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsToolStepStore, FullDisclosureRouter, SerializingMemoryStore, SkillDiscovery, USER_PROFILE_KEY, WebSkillError, WebSkillRuntime, applyUserProfileImport, assertRemoteUrlAllowed, atomicWriteText, diffUserProfile, exportUserProfile, isUnsupportedRunSnapshot, messageOf, readBehaviorRecords, readUserProfile, refineUserProfile, summarizeRunUsage, summarizeToolCalls, textParts } from "@webskill/sdk";
+import { BEHAVIOR_RECORDS_KEY, DEFAULT_LOOP_LIMITS, DEFAULT_USER_PROFILE_LIMITS, EventBus, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsToolStepStore, FullDisclosureRouter, SUPPORTED_DOCUMENT_MIME, SerializingMemoryStore, SkillDiscovery, USER_PROFILE_KEY, WebSkillError, WebSkillRuntime, applyUserProfileImport, assertRemoteUrlAllowed, atomicWriteText, diffUserProfile, exportUserProfile, isUnsupportedRunSnapshot, messageOf, readBehaviorRecords, readUserProfile, refineUserProfile, summarizeRunUsage, summarizeToolCalls, textParts } from "@webskill/sdk";
 import { BrowserWorkerScriptExecutor, checkDictationAvailability, compressImageToBudget, createEncryptedMemoryStore, createLlmClient, deleteMemoryEncryptionKey, openMemoryEncryptionKey, probeChromeBuiltinAvailability, startDictation } 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";
@@ -26,6 +26,63 @@ import { Derived, attachTransformScopes, useClientLookup, useClientResource } fr
 import { resource, useMemoCache, withKey } from "@assistant-ui/tap";
 import { POLICY_DENIAL_CODES } from "@webskill/sdk/governance";
 
+//#region ../ui-kit/src/i18n/localizedText.ts
+/**
+* 键的声明顺序即回退顺序（0.13.0 分册 21 FR-21.2）。
+* 写成 `Record<Locale, …>` 而不是 `['zh','en'] as const satisfies readonly Locale[]`：
+* 后者只校验元素合法、不校验取值穷尽，新增语种时会安静地少一个。
+*/
+const FALLBACK_ORDER = {
+	zh: null,
+	en: null
+};
+/**
+* SDK 支持的语种，声明顺序同时是缺语种时的回退顺序与设置界面里的展示顺序。
+* @experimental
+*/
+const SUPPORTED_LOCALES = Object.keys(FALLBACK_ORDER);
+const trimmed = (value) => {
+	if (typeof value !== "string") return void 0;
+	const text = value.trim();
+	return text === "" ? void 0 : text;
+};
+/**
+* 按当前语种解析多语种文案（0.13.0 分册 21 FR-21.2）：
+* 当前语种非空 → 用它；否则按 {@link SUPPORTED_LOCALES} 顺序取第一个非空的；
+* 全空返回 `undefined`——调用方据此整条丢弃，返回空串会一路流到渲染层变成空白卡片。
+* @experimental
+*/
+function resolveLocalizedText(text, locale) {
+	if (typeof text === "string") return trimmed(text);
+	if (typeof text !== "object" || text === null) return void 0;
+	const preferred = trimmed(text[locale]);
+	if (preferred !== void 0) return preferred;
+	for (const candidate of SUPPORTED_LOCALES) {
+		const value = trimmed(text[candidate]);
+		if (value !== void 0) return value;
+	}
+}
+/** 字符串简写填满全部语种：「这条不分语种，就这一句」。空白串得到空对象。 */
+function normalizeLocalizedText(value) {
+	if (typeof value === "string") {
+		const text = trimmed(value);
+		if (text === void 0) return {};
+		return Object.fromEntries(SUPPORTED_LOCALES.map((locale) => [locale, text]));
+	}
+	if (typeof value !== "object" || value === null) return {};
+	const out = {};
+	for (const locale of SUPPORTED_LOCALES) {
+		const text = trimmed(value[locale]);
+		if (text !== void 0) out[locale] = text;
+	}
+	return out;
+}
+/** 是否有任何语种填了内容；全空的条目一律丢弃（FR-21.2 规则 3） */
+function hasLocalizedText(text) {
+	return SUPPORTED_LOCALES.some((locale) => resolveLocalizedText(text, locale) !== void 0);
+}
+
+//#endregion
 //#region ../ui-kit/src/i18n/createI18n.ts
 /** 字典工厂：各包定义自己的双语字典（恒等返回，保留字面量类型） */
 function defineDictionary(dict) {
@@ -947,72 +1004,6 @@ const __iconNode$22 = [
 ];
 const Mic = createLucideIcon("mic", __iconNode$22);
 
-//#endregion
-//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/monitor-off.mjs
-/**
-* @license lucide-react v1.27.0 - ISC
-*
-* This source code is licensed under the ISC license.
-* See the LICENSE file in the root directory of this source tree.
-*/
-const __iconNode$21 = [
-	["path", {
-		d: "M12 17v4",
-		key: "1riwvh"
-	}],
-	["path", {
-		d: "M17 17H4a2 2 0 0 1-2-2V5a2 2 0 0 1 1.184-1.826",
-		key: "cv7jms"
-	}],
-	["path", {
-		d: "m2 2 20 20",
-		key: "1ooewy"
-	}],
-	["path", {
-		d: "M8 21h8",
-		key: "1ev6f3"
-	}],
-	["path", {
-		d: "M8.656 3H20a2 2 0 0 1 2 2v10a2 2 0 0 1-.293 1.042",
-		key: "z8ni2w"
-	}]
-];
-const MonitorOff = createLucideIcon("monitor-off", __iconNode$21);
-
-//#endregion
-//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/monitor.mjs
-/**
-* @license lucide-react v1.27.0 - ISC
-*
-* This source code is licensed under the ISC license.
-* See the LICENSE file in the root directory of this source tree.
-*/
-const __iconNode$20 = [
-	["rect", {
-		width: "20",
-		height: "14",
-		x: "2",
-		y: "3",
-		rx: "2",
-		key: "48i651"
-	}],
-	["line", {
-		x1: "8",
-		x2: "16",
-		y1: "21",
-		y2: "21",
-		key: "1svkeh"
-	}],
-	["line", {
-		x1: "12",
-		x2: "12",
-		y1: "17",
-		y2: "21",
-		key: "vw1qmm"
-	}]
-];
-const Monitor = createLucideIcon("monitor", __iconNode$20);
-
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/octagon-x.mjs
 /**
@@ -1021,7 +1012,7 @@ const Monitor = createLucideIcon("monitor", __iconNode$20);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$19 = [
+const __iconNode$21 = [
 	["path", {
 		d: "m15 9-6 6",
 		key: "1uzhvr"
@@ -1035,7 +1026,7 @@ const __iconNode$19 = [
 		key: "z0biqf"
 	}]
 ];
-const OctagonX = createLucideIcon("octagon-x", __iconNode$19);
+const OctagonX = createLucideIcon("octagon-x", __iconNode$21);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/panel-left.mjs
@@ -1045,7 +1036,7 @@ const OctagonX = createLucideIcon("octagon-x", __iconNode$19);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$18 = [["rect", {
+const __iconNode$20 = [["rect", {
 	width: "18",
 	height: "18",
 	x: "3",
@@ -1056,7 +1047,7 @@ const __iconNode$18 = [["rect", {
 	d: "M9 3v18",
 	key: "fh3hqa"
 }]];
-const PanelLeft = createLucideIcon("panel-left", __iconNode$18);
+const PanelLeft = createLucideIcon("panel-left", __iconNode$20);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/paperclip.mjs
@@ -1066,11 +1057,11 @@ const PanelLeft = createLucideIcon("panel-left", __iconNode$18);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$17 = [["path", {
+const __iconNode$19 = [["path", {
 	d: "m16 6-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551",
 	key: "1miecu"
 }]];
-const Paperclip = createLucideIcon("paperclip", __iconNode$17);
+const Paperclip = createLucideIcon("paperclip", __iconNode$19);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pencil.mjs
@@ -1080,14 +1071,59 @@ const Paperclip = createLucideIcon("paperclip", __iconNode$17);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$16 = [["path", {
+const __iconNode$18 = [["path", {
 	d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",
 	key: "1a8usu"
 }], ["path", {
 	d: "m15 5 4 4",
 	key: "1mk7zo"
 }]];
-const Pencil = createLucideIcon("pencil", __iconNode$16);
+const Pencil = createLucideIcon("pencil", __iconNode$18);
+
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pin-off.mjs
+/**
+* @license lucide-react v1.27.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const __iconNode$17 = [
+	["path", {
+		d: "M12 17v5",
+		key: "bb1du9"
+	}],
+	["path", {
+		d: "M15 9.34V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H7.89",
+		key: "znwnzq"
+	}],
+	["path", {
+		d: "m2 2 20 20",
+		key: "1ooewy"
+	}],
+	["path", {
+		d: "M9 9v1.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h11",
+		key: "c9qhm2"
+	}]
+];
+const PinOff = createLucideIcon("pin-off", __iconNode$17);
+
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pin.mjs
+/**
+* @license lucide-react v1.27.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const __iconNode$16 = [["path", {
+	d: "M12 17v5",
+	key: "bb1du9"
+}], ["path", {
+	d: "M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H8a2 2 0 0 0 0 4 1 1 0 0 1 1 1z",
+	key: "1nkz8b"
+}]];
+const Pin = createLucideIcon("pin", __iconNode$16);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/play.mjs
@@ -7967,7 +8003,7 @@ const DIALOG_WIDTHS = {
 * 基类锁定 `h` `rounded` `z`（className 覆盖不生效）：
 * `max-h` 是视口上限，圆角与层级属 ui-kit 的整体契约。
 */
-function Dialog({ open, onClose, title, description, footer, hideCloseButton = false, className = "", size, children }) {
+function Dialog({ open, onClose, title, description, footer, hideCloseButton = false, dismissOnOutsideClick = true, className = "", size, children }) {
 	const restoreFocusRef = useRef(null);
 	const wasOpenRef = useRef(false);
 	if (open && !wasOpenRef.current && typeof document !== "undefined") restoreFocusRef.current = document.activeElement;
@@ -7978,6 +8014,7 @@ function Dialog({ open, onClose, title, description, footer, hideCloseButton = f
 		children: /* @__PURE__ */ jsxs(DialogPortal, {
 			container: usePortalContainer(),
 			children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-scrim" }), /* @__PURE__ */ jsxs(DialogContent, {
+				...dismissOnOutsideClick ? {} : { onInteractOutside: (event) => event.preventDefault() },
 				onCloseAutoFocus: (event) => {
 					const source = restoreFocusRef.current;
 					if (source instanceof HTMLElement && source.isConnected) {
@@ -12748,7 +12785,7 @@ function merge(definitions, space) {
 *   Value that can be used to look up the properly cased property on a
 *   `Schema`.
 */
-function normalize$1(value) {
+function normalize$2(value) {
 	return value.toLowerCase();
 }
 
@@ -12899,8 +12936,8 @@ function create(definition) {
 		const info = new DefinedInfo(property, definition.transform(definition.attributes || {}, property), value, definition.space);
 		if (definition.mustUseProperty && definition.mustUseProperty.includes(property)) info.mustUseProperty = true;
 		properties[property] = info;
-		normals[normalize$1(property)] = property;
-		normals[normalize$1(info.attribute)] = property;
+		normals[normalize$2(property)] = property;
+		normals[normalize$2(info.attribute)] = property;
 	}
 	return new Schema(properties, normals, definition.space);
 }
@@ -13992,7 +14029,7 @@ const valid = /^data[-\w.:]+$/i;
 *   Info.
 */
 function find(schema, value) {
-	const normal = normalize$1(value);
+	const normal = normalize$2(value);
 	let property = value;
 	let Type = Info;
 	if (normal in schema.normal) return schema.property[schema.normal[normal]];
@@ -18879,7 +18916,7 @@ function join(...segments) {
 		assertPath$1(segments[index]);
 		if (segments[index]) joined = joined === void 0 ? segments[index] : joined + "/" + segments[index];
 	}
-	return joined === void 0 ? "." : normalize(joined);
+	return joined === void 0 ? "." : normalize$1(joined);
 }
 /**
 * Normalize a basic file path.
@@ -18889,7 +18926,7 @@ function join(...segments) {
 * @returns {string}
 *   File path.
 */
-function normalize(path) {
+function normalize$1(path) {
 	assertPath$1(path);
 	const absolute = path.codePointAt(0) === 47;
 	let value = normalizeString(path, !absolute);
@@ -27475,7 +27512,7 @@ function addChild(nodes, value) {
 function parsePrimitive(info, name, value) {
 	if (typeof value === "string") {
 		if (info.number && value && !Number.isNaN(Number(value))) return Number(value);
-		if ((info.boolean || info.overloadedBoolean) && (value === "" || normalize$1(value) === normalize$1(name))) return true;
+		if ((info.boolean || info.overloadedBoolean) && (value === "" || normalize$2(value) === normalize$2(name))) return true;
 	}
 	return value;
 }
@@ -30348,6 +30385,101 @@ const DEFAULT_LOOP_LIMITS$1 = {
 	maxHistoryMessages: 1e3
 };
 
+//#endregion
+//#region ../ui-kit/src/runtime-config/quickPrompts.ts
+/**
+* 图标表。这张表不进任何包的公开面：宿主只认名字，具体用哪套图标是实现细节。
+*/
+const ICONS = {
+	chart: ChartColumn,
+	document: FileText,
+	report: ClipboardList,
+	search: Search,
+	list: List,
+	bug: Bug,
+	test: FlaskConical,
+	metric: Gauge,
+	compare: GitCompare,
+	page: AppWindow,
+	run: Play,
+	warn: TriangleAlert,
+	sparkles: Sparkles,
+	settings: Settings
+};
+/** 受控枚举的全部取值（console 的图标下拉数据源） */
+const QUICK_PROMPT_ICON_NAMES = Object.keys(ICONS);
+/** 空态网格是两列，8 条即四行（FR-17.4 / D-17-6）；用户可在 console 里上调 */
+const DEFAULT_QUICK_PROMPT_LIMIT = 8;
+/** 可调范围的天花板：20 条已经把欢迎区撑成十行，再多就满屏都是按钮 */
+const MAX_QUICK_PROMPT_LIMIT = 20;
+/** 未知名字每个只提示一次，免得每次渲染都刷屏 */
+const warned$1 = /* @__PURE__ */ new Set();
+/**
+* 解析图标名；取值不在枚举内时返回 undefined（按无图标渲染），
+* 并在控制台提示一次可用取值——宿主拼错时不至于只看到「图标没出来」。
+*/
+function resolveQuickPromptIcon(icon) {
+	if (icon === void 0) return void 0;
+	const resolved = ICONS[icon];
+	if (resolved !== void 0) return resolved;
+	if (!warned$1.has(icon)) {
+		warned$1.add(icon);
+		console.debug("[webskill] unknown quick prompt icon", {
+			icon,
+			available: Object.keys(ICONS)
+		});
+	}
+}
+/** 统一成对象形态：宿主可以只给字符串，该字符串填满全部语种（FR-21.1） */
+const normalize = (entry) => typeof entry === "string" ? { text: normalizeLocalizedText(entry) } : entry;
+/**
+* 拼接动态与静态两批快捷指令（FR-17.4）。
+*
+* 动态在前——它是上下文相关的，更容易点到的位置留给它。
+* 去重**只发生在跨界处**：静态清单里与某条动态指令同文案的会让位；
+* 静态清单**内部**的重复原样保留（0.12.0 AC-21.6：宿主自定义时文案本就无唯一性约束，
+* 混排 `['A', {text:'A', icon:'bug'}]` 是合法的两张卡）。
+*
+* 0.13.0 分册 21 FR-21.4：去重口径是**按 `locale` 解析后的文案**，
+* 因此同一对条目在一个语种下会合并、在另一个语种下可能各自保留。
+* 按 `id` 去重不可行：动态清单传的是 `QuickPrompt`，本来就没有 `id`。
+*
+* 结果按 `limit` 截断（默认 {@link DEFAULT_QUICK_PROMPT_LIMIT}）。
+*/
+function mergeQuickPrompts(dynamic, statics, locale, limit = 8) {
+	const resolve = (entry) => {
+		const prompt = normalize(entry);
+		const text = resolveLocalizedText(prompt.text, locale);
+		if (text === void 0) return void 0;
+		return {
+			text,
+			...prompt.icon !== void 0 ? { icon: prompt.icon } : {}
+		};
+	};
+	const head = [];
+	const claimed = /* @__PURE__ */ new Set();
+	for (const entry of dynamic ?? []) {
+		const prompt = resolve(entry);
+		if (prompt === void 0 || claimed.has(prompt.text)) continue;
+		claimed.add(prompt.text);
+		head.push(prompt);
+	}
+	const tail = [];
+	for (const entry of statics) {
+		const prompt = resolve(entry);
+		if (prompt === void 0 || claimed.has(prompt.text)) continue;
+		tail.push(prompt);
+	}
+	return [...head, ...tail].slice(0, clampQuickPromptLimit(limit));
+}
+/** 存储里的脏值不能让空态变成空白或一堵墙；非正整数一律回默认 */
+function clampQuickPromptLimit(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return 8;
+	const floored = Math.floor(value);
+	if (floored < 1) return 8;
+	return Math.min(floored, 20);
+}
+
 //#endregion
 //#region ../ui-kit/src/runtime-config/types.ts
 /**
@@ -30427,7 +30559,8 @@ function defaultRuntimeConfig() {
 			imageAttachments: false,
 			pageImageCapture: false,
 			maxImageBytes: 10 * 1024 * 1024,
-			maxImagesPerMessage: 5
+			maxImagesPerMessage: 50,
+			minImageArea: 1024
 		},
 		documentSurface: { enabled: false },
 		userProfile: {
@@ -30437,6 +30570,9 @@ function defaultRuntimeConfig() {
 			encrypted: true
 		},
 		skillState: { quarantineThreshold: 5 },
+		quickPrompts: [],
+		quickPromptsSeeded: false,
+		quickPromptLimit: 8,
 		dismissedAutoEntries: []
 	};
 }
@@ -30521,6 +30657,9 @@ function mergeRuntimeConfigDefaults(partial) {
 		documentSurface: mergeDocumentSurface(p["documentSurface"], d.documentSurface),
 		userProfile: mergeUserProfile(p["userProfile"], d.userProfile),
 		skillState: mergeSkillState(p["skillState"], d.skillState),
+		quickPrompts: readQuickPrompts(p["quickPrompts"]),
+		quickPromptsSeeded: p["quickPromptsSeeded"] === true,
+		quickPromptLimit: clampQuickPromptLimit(p["quickPromptLimit"]),
 		dismissedAutoEntries: readStringList$1(p["dismissedAutoEntries"], [])
 	};
 }
@@ -30543,6 +30682,35 @@ function readStringList$1(raw, fallback) {
 	if (!Array.isArray(raw)) return [...fallback];
 	return raw.filter((item) => typeof item === "string");
 }
+/**
+* 快捷指令逐条校验（FR-17.2）：缺 `id` 或文案全语种皆空的条目**单条丢弃**，
+* 不因为一条脏数据把整段回退——用户其余的配置不该被连坐。
+* `icon` 取值不在枚举内时抹掉该字段（渲染侧按无图标处理）。
+*
+* 0.13.0 分册 25 FR-25.3：`text: string` 的存量条目一并丢弃，不再升级为语种对象——
+* 它们在 console 的快捷指令页里没有身份可言，留着就是「看得见、删不掉」。
+*/
+function readQuickPrompts(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const item of raw) {
+		if (typeof item !== "object" || item === null) continue;
+		const entry = item;
+		const id = typeof entry["id"] === "string" ? entry["id"].trim() : "";
+		const rawText = entry["text"];
+		if (id === "" || typeof rawText !== "object" || rawText === null) continue;
+		const text = normalizeLocalizedText(rawText);
+		if (!hasLocalizedText(text)) continue;
+		const icon = entry["icon"];
+		const valid = typeof icon === "string" && QUICK_PROMPT_ICON_NAMES.includes(icon) ? icon : void 0;
+		out.push({
+			id,
+			text,
+			...valid !== void 0 ? { icon: valid } : {}
+		});
+	}
+	return out;
+}
 /** 上限字段非正数时回退默认值：0 或负数会把整条通道变成永远拒收 */
 function mergeMultimodal(raw, d) {
 	const p = typeof raw === "object" && raw !== null ? raw : {};
@@ -30551,9 +30719,14 @@ function mergeMultimodal(raw, d) {
 		imageAttachments: typeof p["imageAttachments"] === "boolean" ? p["imageAttachments"] : d.imageAttachments,
 		pageImageCapture: typeof p["pageImageCapture"] === "boolean" ? p["pageImageCapture"] : d.pageImageCapture,
 		maxImageBytes: positive(p["maxImageBytes"], d.maxImageBytes),
-		maxImagesPerMessage: positive(p["maxImagesPerMessage"], d.maxImagesPerMessage)
+		maxImagesPerMessage: positive(p["maxImagesPerMessage"], d.maxImagesPerMessage),
+		minImageArea: nonNegative(p["minImageArea"], d.minImageArea)
 	};
 }
+/** 非有限数 / 负数回退默认值，`0` 原样保留 */
+function nonNegative(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+}
 /**
 * CSP 白名单只收字符串数组；存储被污染时回退默认值（空），
 * **不能**把非法值原样带进 CSP —— `viewerCspHeader` 会抛，等于整条投放面瘫掉。
@@ -31292,6 +31465,9 @@ const chatbotDictionary = defineDictionary({
 		"app.title": "WebSkill Chat",
 		"header.sessions": "Sessions",
 		"header.settings": "Settings",
+		"header.dock": "Dock to page",
+		"header.undock": "Undock from page",
+		"header.close": "Close chat",
 		"header.console": "Open Console",
 		"header.theme.light": "Switch to light theme",
 		"header.theme.dark": "Switch to dark theme",
@@ -31337,10 +31513,7 @@ const chatbotDictionary = defineDictionary({
 		"welcome.capability.transparency.title": "Run transparency",
 		"welcome.capability.transparency.description": "Routing, skill activation, tool calls and results are visible live, step by step.",
 		"welcome.quickPrompts": "Try an example",
-		"welcome.prompt.1": "What skills are installed in this workspace?",
-		"welcome.prompt.2": "Draft a short product update announcement for me",
-		"welcome.prompt.3": "Show me a bar chart of this quarter’s sales",
-		"welcome.prompt.4": "Explain how WebSkill runs skill scripts safely",
+		"welcome.dynamicPrompts": "Suggested for this page",
 		"message.copy": "Copy",
 		"message.copied": "Copied",
 		"message.retry": "Retry",
@@ -31495,9 +31668,6 @@ const chatbotDictionary = defineDictionary({
 		"composer.noModel.description": "A large language model has not been configured yet. Configure one on the model settings page before chatting.",
 		"composer.noModel.configure": "Configure model",
 		"capability.group": "Model capabilities",
-		"composer.pageCapture": "Read the page view",
-		"composer.pageCapture.disabled.setting": "page image capture is off in Settings → Multimodal",
-		"composer.pageCapture.disabled.model": "the selected model does not accept images",
 		"composer.addAttachment.imagesOff": "images are off in Settings → Multimodal",
 		"composer.addAttachment.modelNoImages": "the selected model does not accept images",
 		"attachment.imagesDropped": "Only {limit} images can be sent per message. Not sent: {names}",
@@ -31648,6 +31818,9 @@ const chatbotDictionary = defineDictionary({
 		"app.title": "WebSkill Chat",
 		"header.sessions": "会话",
 		"header.settings": "设置",
+		"header.dock": "固定到页面",
+		"header.undock": "取消固定",
+		"header.close": "关闭对话框",
 		"header.console": "打开 Console",
 		"header.theme.light": "切换到亮色主题",
 		"header.theme.dark": "切换到暗色主题",
@@ -31693,10 +31866,7 @@ const chatbotDictionary = defineDictionary({
 		"welcome.capability.transparency.title": "运行透明",
 		"welcome.capability.transparency.description": "路由、技能激活、工具调用与结果，逐步实时可见。",
 		"welcome.quickPrompts": "试试这些示例",
-		"welcome.prompt.1": "这个工作区里安装了哪些技能？",
-		"welcome.prompt.2": "帮我起草一份简短的产品更新公告",
-		"welcome.prompt.3": "给我展示本季度销售额的柱状图",
-		"welcome.prompt.4": "解释一下 WebSkill 如何安全地运行技能脚本",
+		"welcome.dynamicPrompts": "当前页面可用的快捷指令",
 		"message.copy": "复制",
 		"message.copied": "已复制",
 		"message.edit": "编辑消息",
@@ -31851,9 +32021,6 @@ const chatbotDictionary = defineDictionary({
 		"composer.noModel.description": "大模型尚未配置，请先前往大模型配置页面完成配置，再开始对话。",
 		"composer.noModel.configure": "配置大模型",
 		"capability.group": "模型能力",
-		"composer.pageCapture": "读取页面画面",
-		"composer.pageCapture.disabled.setting": "页面图像抓取已在「设置 → 多模态」中关闭",
-		"composer.pageCapture.disabled.model": "当前模型不接受图片",
 		"composer.addAttachment.imagesOff": "图片已在「设置 → 多模态」中关闭",
 		"composer.addAttachment.modelNoImages": "当前模型不接受图片",
 		"attachment.imagesDropped": "每条消息最多发送 {limit} 张图片。未发送：{names}",
@@ -32787,7 +32954,7 @@ var ChatEngine = class {
 		const rc = await this.#runtimeConfigStore()?.load();
 		if (!(rc?.multimodal.imageAttachments ?? false)) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Image attachments are turned off. Enable them in settings before sending images.");
 		if (!entryCapabilities(pickLlmEntry(rc, this.#selectedModelId)).image) throw new WebSkillError("MODEL_IMAGE_UNSUPPORTED", "Current model does not support image input. Switch model or remove the image.");
-		const limit = rc?.multimodal.maxImagesPerMessage ?? 5;
+		const limit = rc?.multimodal.maxImagesPerMessage ?? defaultRuntimeConfig().multimodal.maxImagesPerMessage;
 		if (images.length <= limit) return { accepted: attachments };
 		const dropped = images.slice(limit);
 		const droppedIds = new Set(dropped.map((a) => a.id));
@@ -33170,7 +33337,8 @@ var ChatEngine = class {
 					return {
 						enabled: (live?.multimodal.pageImageCapture ?? false) && entryCapabilities(pickLlmEntry(live, this.#selectedModelId)).image,
 						maxImageBytes: live?.multimodal.maxImageBytes ?? 0,
-						maxImages: live?.multimodal.maxImagesPerMessage ?? 0
+						maxImages: live?.multimodal.maxImagesPerMessage ?? 0,
+						minImageArea: live?.multimodal.minImageArea ?? 0
 					};
 				}
 			})] : [],
@@ -33211,6 +33379,8 @@ var ChatEngine = class {
 			...this.#options.fetchData ? { fetchData: this.#options.fetchData } : {},
 			...this.#adapter.linkedDocuments ? { linkedDocuments: this.#adapter.linkedDocuments } : {},
 			...this.#adapter.docxExtractor ? { docxExtractor: this.#adapter.docxExtractor } : {},
+			...this.#adapter.xlsxExtractor ? { xlsxExtractor: this.#adapter.xlsxExtractor } : {},
+			...this.#adapter.pdfExtractor ? { pdfExtractor: this.#adapter.pdfExtractor } : {},
 			...this.#adapter.documentAudit ? { documentAudit: this.#adapter.documentAudit } : {},
 			...toolStepStore ? { toolSteps: toolStepStore } : {}
 		};
@@ -34129,47 +34299,6 @@ function useWebSkillAui({ messages, live, sessions, currentSessionId, sessionsLo
 	}) });
 }
 
-//#endregion
-//#region src/react/quickPromptIcons.ts
-/**
-* 快捷指令图标表（0.12.0 分册 21）。
-* 这张表不导出到包外：宿主只认名字，具体用哪套图标是实现细节。
-*/
-const ICONS = {
-	chart: ChartColumn,
-	document: FileText,
-	report: ClipboardList,
-	search: Search,
-	list: List,
-	bug: Bug,
-	test: FlaskConical,
-	metric: Gauge,
-	compare: GitCompare,
-	page: AppWindow,
-	run: Play,
-	warn: TriangleAlert,
-	sparkles: Sparkles,
-	settings: Settings
-};
-/** 未知名字每个只提示一次，免得每次渲染都刷屏 */
-const warned$1 = /* @__PURE__ */ new Set();
-/**
-* 解析图标名；取值不在枚举内时返回 undefined（按无图标渲染），
-* 并在控制台提示一次可用取值——宿主拼错时不至于只看到「图标没出来」。
-*/
-function resolveQuickPromptIcon(icon) {
-	if (icon === void 0) return void 0;
-	const resolved = ICONS[icon];
-	if (resolved !== void 0) return resolved;
-	if (!warned$1.has(icon)) {
-		warned$1.add(icon);
-		console.debug("[webskill] unknown quick prompt icon", {
-			icon,
-			available: Object.keys(ICONS)
-		});
-	}
-}
-
 //#endregion
 //#region src/react/AssistantUiShell.tsx
 /**
@@ -34411,63 +34540,94 @@ function AssistantUiSessionList({ className = "", onNavigate, onCollapse, hasEar
 	});
 }
 /** Minimal Base toolbar: workspace controls stay secondary to the thread itself. */
-function AssistantUiThreadToolbar({ title, onOpenSessions, onCreateSession, onOpenSettings }) {
+function AssistantUiThreadToolbar({ title, onOpenSessions, onCreateSession, onOpenSettings, docked, onDock, onClose }) {
 	const t = useT();
+	const dockLabel = docked === true ? t("header.undock") : t("header.dock");
 	return /* @__PURE__ */ jsxs("header", {
 		className: "flex h-14 shrink-0 items-center justify-between bg-background px-3",
 		children: [/* @__PURE__ */ jsxs("div", {
 			className: "flex min-w-0 items-center gap-1",
-			children: [/* @__PURE__ */ jsx("button", {
-				type: "button",
-				"aria-label": t("session.expand"),
-				title: t("session.expand"),
-				"data-testid": "chatbot-sessions-button",
-				onClick: onOpenSessions,
-				className: "webskill-aui-sessions-button inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(PanelLeft, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}), title !== void 0 ? /* @__PURE__ */ jsx("span", {
-				className: "truncate px-2 text-sm font-medium text-ink",
-				children: title
-			}) : null]
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-label": t("session.expand"),
+					title: t("session.expand"),
+					"data-testid": "chatbot-sessions-button",
+					onClick: onOpenSessions,
+					className: "webskill-aui-sessions-button inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(PanelLeft, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}),
+				onDock ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-dock",
+					"aria-label": dockLabel,
+					"aria-pressed": docked === true,
+					title: dockLabel,
+					onClick: () => onDock(docked !== true),
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: docked === true ? /* @__PURE__ */ jsx(PinOff, {
+						className: "size-4",
+						"aria-hidden": true
+					}) : /* @__PURE__ */ jsx(Pin, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null,
+				title !== void 0 ? /* @__PURE__ */ jsx("span", {
+					className: "truncate px-2 text-sm font-medium text-ink",
+					children: title
+				}) : null
+			]
 		}), /* @__PURE__ */ jsxs("div", {
 			className: "flex items-center gap-1",
-			children: [/* @__PURE__ */ jsx("button", {
-				type: "button",
-				"data-testid": "header-new-chat",
-				"aria-label": t("session.new"),
-				title: t("session.new"),
-				onClick: onCreateSession,
-				className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(Plus, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}), onOpenSettings ? /* @__PURE__ */ jsx("button", {
-				type: "button",
-				"data-testid": "header-settings",
-				"aria-label": t("header.settings"),
-				title: t("header.settings"),
-				onClick: onOpenSettings,
-				className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(Settings, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}) : null]
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-new-chat",
+					"aria-label": t("session.new"),
+					title: t("session.new"),
+					onClick: onCreateSession,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(Plus, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}),
+				onOpenSettings ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-settings",
+					"aria-label": t("header.settings"),
+					title: t("header.settings"),
+					onClick: onOpenSettings,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(Settings, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null,
+				onClose ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-close",
+					"aria-label": t("header.close"),
+					title: t("header.close"),
+					onClick: onClose,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(X, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null
+			]
 		})]
 	});
 }
-function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
+function AssistantUiEmptyState({ title, prompts, dynamicPrompts, limit, disabled, onPrompt }) {
 	const t = useT();
-	const starterPrompts = prompts ?? [
-		t("welcome.prompt.1"),
-		t("welcome.prompt.2"),
-		t("welcome.prompt.3"),
-		t("welcome.prompt.4")
-	];
+	const locale = useLocale();
+	const starterPrompts = mergeQuickPrompts(dynamicPrompts, prompts ?? [], locale, limit);
 	return /* @__PURE__ */ jsx("div", {
 		"data-testid": "assistant-ui-empty-state",
 		className: "flex min-h-48 flex-col justify-center py-8 sm:min-h-72 sm:py-10",
@@ -34478,8 +34638,7 @@ function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
 				children: title ?? t("welcome.assistantTitle")
 			}), starterPrompts.length > 0 ? /* @__PURE__ */ jsx("div", {
 				className: "grid w-full grid-cols-1 gap-2 pt-3 sm:grid-cols-2",
-				children: starterPrompts.map((entry, index) => {
-					const item = typeof entry === "string" ? { text: entry } : entry;
+				children: starterPrompts.map((item, index) => {
 					const Icon = resolveQuickPromptIcon(item.icon);
 					return /* @__PURE__ */ jsxs("button", {
 						type: "button",
@@ -34496,6 +34655,34 @@ function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
 		})
 	});
 }
+/**
+* 对话进行中的动态快捷指令条（FR-17.6）。
+* 只接**动态**那一批：静态清单不随上下文变，常驻只会变成噪声。
+* 空列表时整条不渲染，DOM 里不留空容器。
+*/
+function AssistantUiDynamicPrompts({ prompts, limit, onPrompt }) {
+	const t = useT();
+	const items = mergeQuickPrompts(prompts, [], useLocale(), limit);
+	if (items.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		"data-testid": "chatbot-dynamic-prompts",
+		"aria-label": t("welcome.dynamicPrompts"),
+		className: "flex gap-2 overflow-x-auto px-4 pb-2",
+		children: items.map((item, index) => {
+			const Icon = resolveQuickPromptIcon(item.icon);
+			return /* @__PURE__ */ jsxs("button", {
+				type: "button",
+				"data-testid": "chatbot-dynamic-prompt",
+				onClick: () => onPrompt(item.text),
+				className: "inline-flex shrink-0 items-center gap-1.5 rounded-full border border-border bg-card px-3 py-1.5 text-xs text-muted transition-colors hover:bg-subtle hover:text-ink",
+				children: [Icon ? /* @__PURE__ */ jsx(Icon, {
+					className: "size-3.5 shrink-0",
+					"aria-hidden": true
+				}) : null, item.text]
+			}, `${index}:${item.text}`);
+		})
+	});
+}
 
 //#endregion
 //#region src/react/format.ts
@@ -34649,12 +34836,10 @@ const DEFAULT_DICTATION_LANG = {
 	zh: "zh-CN"
 };
 /**
-* 三个图标共用一套外观规则（FR-28.4）：明暗只由 supported 决定，
-* 交互可供性由 interactive 决定——能力是状态，取像是动作。
+* 两个图标共用一套外观（FR-28.4）：明暗只由 supported 决定。
 */
-function CAPABILITY_ICON_CLASS(supported, interactive) {
-	const base = `inline-flex size-8 shrink-0 items-center justify-center rounded-full ${supported ? "text-ink" : "text-muted"}`;
-	return interactive ? `${base} transition-colors hover:bg-accent hover:text-ink disabled:cursor-not-allowed disabled:hover:bg-transparent` : base;
+function CAPABILITY_ICON_CLASS(supported) {
+	return `inline-flex size-8 shrink-0 items-center justify-center rounded-full ${supported ? "text-ink" : "text-muted"}`;
 }
 function AttachmentMeta({ info }) {
 	const t = useT();
@@ -34714,16 +34899,14 @@ function ModelMenuButton({ models }) {
 		}, option.id))
 	})] });
 }
-function AssistantUiComposer({ running, disabled = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, pageCapture, capabilities }) {
+function AssistantUiComposer({ running, disabled = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, capabilities }) {
 	const t = useT();
 	const locale = useLocale();
 	const dictation = useComposerDictation(dictationLang ?? DEFAULT_DICTATION_LANG[locale]);
 	const dictationReason = dictation.availability.available ? void 0 : t(`composer.dictate.${dictation.availability.reason}`);
 	const waitReason = disabled ? t("interaction.wait", { target: waitTarget ?? t("interaction.wait.fallback") }) : void 0;
 	const attachmentReason = attachmentImages === void 0 || attachmentImages.enabled && attachmentImages.imageCapable ? void 0 : attachmentImages.enabled ? t("composer.addAttachment.modelNoImages") : t("composer.addAttachment.imagesOff");
-	const pageCaptureReason = pageCapture === void 0 || pageCapture.enabled && pageCapture.imageCapable ? void 0 : pageCapture.enabled ? t("composer.pageCapture.disabled.model") : t("composer.pageCapture.disabled.setting");
 	const plainChatHintId = useId();
-	const pageCaptureHintId = useId();
 	return /* @__PURE__ */ jsx(ComposerPrimitive.Root, {
 		"data-testid": "assistant-ui-composer",
 		"data-centered": centered,
@@ -34823,7 +35006,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										"aria-label": t(capabilities.tools ? "capability.tools.on" : "capability.tools.off"),
 										title: capabilities.tools ? t("capability.tools.on") : `${t("capability.tools.off")} — ${t("settings.capability.plainChat")}`,
 										...capabilities.tools ? {} : { "aria-describedby": plainChatHintId },
-										className: CAPABILITY_ICON_CLASS(capabilities.tools, false),
+										className: CAPABILITY_ICON_CLASS(capabilities.tools),
 										children: capabilities.tools ? /* @__PURE__ */ jsx(Wrench, {
 											className: "size-4",
 											"aria-hidden": true
@@ -34842,7 +35025,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										"data-supported": capabilities.image,
 										"aria-label": t(capabilities.image ? "capability.images.on" : "capability.images.off"),
 										title: t(capabilities.image ? "capability.images.on" : "capability.images.off"),
-										className: CAPABILITY_ICON_CLASS(capabilities.image, false),
+										className: CAPABILITY_ICON_CLASS(capabilities.image),
 										children: capabilities.image ? /* @__PURE__ */ jsx(Image, {
 											className: "size-4",
 											"aria-hidden": true
@@ -34852,29 +35035,6 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										})
 									})
 								]
-							}) : null,
-							pageCapture ? /* @__PURE__ */ jsx("button", {
-								type: "button",
-								"data-testid": "capability-page-capture",
-								"data-supported": pageCaptureReason === void 0,
-								"aria-label": t("composer.pageCapture"),
-								title: pageCaptureReason === void 0 ? t("composer.pageCapture") : `${t("composer.pageCapture")} — ${pageCaptureReason}`,
-								disabled: pageCaptureReason !== void 0,
-								...pageCaptureReason !== void 0 ? { "aria-describedby": pageCaptureHintId } : {},
-								onClick: pageCapture.onSelect,
-								className: CAPABILITY_ICON_CLASS(pageCaptureReason === void 0, true),
-								children: pageCaptureReason === void 0 ? /* @__PURE__ */ jsx(Monitor, {
-									className: "size-4",
-									"aria-hidden": true
-								}) : /* @__PURE__ */ jsx(MonitorOff, {
-									className: "size-4",
-									"aria-hidden": true
-								})
-							}) : null,
-							pageCapture && pageCaptureReason !== void 0 ? /* @__PURE__ */ jsx("span", {
-								id: pageCaptureHintId,
-								className: "sr-only",
-								children: pageCaptureReason
 							}) : null
 						]
 					}), /* @__PURE__ */ jsxs("div", {
@@ -46563,13 +46723,13 @@ const IMAGE_MIME_SET = new Set(IMAGE_MIME_TYPES);
 const FILE_MIME_TYPES = ["application/pdf"];
 const FILE_MIME_SET = new Set(FILE_MIME_TYPES);
 /**
-* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9）。
-* 不走直通的 `file`：docx 发给 provider 会被当成二进制垃圾。
+* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9 / 0.13.0 FR-12.5）。
+* 不走直通的 `file`：docx / xlsx 发给 provider 会被当成二进制垃圾。
 */
-const EXTRACTED_MIME_TYPES = ["application/vnd.openxmlformats-officedocument.wordprocessingml.document"];
-const EXTRACTED_MIME_SET = new Set(EXTRACTED_MIME_TYPES);
-const EXTRACTED_EXTENSIONS = ["docx"];
-const EXTRACTED_EXTENSION_SET = new Set(EXTRACTED_EXTENSIONS);
+const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+const EXTRACTED_MIME_SET = /* @__PURE__ */ new Set([DOCX_MIME, XLSX_MIME]);
+const EXTRACTED_EXTENSION_SET = /* @__PURE__ */ new Set(["docx", "xlsx"]);
 function extensionOf(fileName) {
 	return fileName.split(".").pop()?.toLowerCase() ?? "";
 }
@@ -46598,7 +46758,8 @@ function attachmentAccept(options) {
 	const parts = [...TEXT_ACCEPT, ...TEXT_EXTENSIONS.map((ext) => `.${ext}`)];
 	if (options.images) parts.push(...IMAGE_MIME_TYPES);
 	if (options.files) parts.push(...FILE_MIME_TYPES);
-	if (options.documents) parts.push(...EXTRACTED_MIME_TYPES, ...EXTRACTED_EXTENSIONS.map((ext) => `.${ext}`));
+	if (options.documents) parts.push(DOCX_MIME, ".docx");
+	if (options.spreadsheets) parts.push(XLSX_MIME, ".xlsx");
 	return parts.join(",");
 }
 
@@ -46607,17 +46768,19 @@ function attachmentAccept(options) {
 /** 非图片附件无法压缩，沿用固定上限；图片走 `RuntimeMultimodalConfig.maxImageBytes` */
 const MAX_BYTES = 10 * 1024 * 1024;
 const MAX_TEXT_CHARS = 32 * 1024;
-const DEFAULT_MULTIMODAL = {
-	imageAttachments: false,
-	pageImageCapture: false,
-	maxImageBytes: MAX_BYTES,
-	maxImagesPerMessage: 5
-};
+/** 0.13.0 FR-13.3：兜底值必须与 SDK 默认配置同源，各自写一份字面量必然静默漂移 */
+const DEFAULT_MULTIMODAL = defaultRuntimeConfig().multimodal;
 /** 去掉路径分隔符与 `..`，防止写出附件目录 */
 function safeName(name) {
 	const cleaned = (name.split(/[\\/]/).pop() ?? "attachment").replace(/[^\w.\- ]+/g, "_").replace(/^\.+/, "");
 	return cleaned === "" ? "attachment" : cleaned.slice(0, 80);
 }
+/** 两种待抽取格式共用 `document-text` 这一种 kind，选抽取器时要按格式再分一次 */
+function isSpreadsheet(file) {
+	const type = file.type.toLowerCase();
+	if (type !== "") return type === SUPPORTED_DOCUMENT_MIME.xlsx;
+	return file.name.toLowerCase().endsWith(".xlsx");
+}
 /**
 * 附件落盘到 `<attachmentsRoot>/<sessionId>/`，`ChatEngine.send` 再按路径读回构造 `LlmContentPart[]`。
 * UI 只持有元数据，正文的唯一真相是存储。
@@ -46634,7 +46797,8 @@ var WebSkillAttachmentAdapter = class {
 		return attachmentAccept({
 			images: this.#imagesAllowed(),
 			files: true,
-			documents: this.#options.docxExtractor !== void 0
+			documents: this.#options.docxExtractor !== void 0,
+			spreadsheets: this.#options.xlsxExtractor !== void 0
 		});
 	}
 	#multimodal() {
@@ -46643,13 +46807,16 @@ var WebSkillAttachmentAdapter = class {
 	#imagesAllowed() {
 		return this.#multimodal().imageAttachments && (this.#options.imageCapable?.() ?? false);
 	}
+	#extractorFor(file) {
+		return isSpreadsheet(file) ? this.#options.xlsxExtractor : this.#options.docxExtractor;
+	}
 	async add({ file }) {
 		const kind = classifyAttachment(file.type, file.name);
 		if (kind === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", `Attachment "${file.name}" has an unsupported type "${file.type === "" ? "unknown" : file.type}"`);
 		if (kind === "image") {
 			if (!this.#multimodal().imageAttachments) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Image attachments are turned off. Enable them in settings before sending images.");
 			if (!(this.#options.imageCapable?.() ?? false)) throw new WebSkillError("MODEL_IMAGE_UNSUPPORTED", "Current model does not support image input. Switch model or remove the image.");
-		} else if (kind === "document-text" && this.#options.docxExtractor === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Word documents are not supported in this environment: no docx extractor is wired up.");
+		} else if (kind === "document-text" && this.#extractorFor(file) === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", `${isSpreadsheet(file) ? "Excel workbooks" : "Word documents"} are not supported in this environment: no ${isSpreadsheet(file) ? "xlsx" : "docx"} extractor is wired up.`);
 		else if (file.size > MAX_BYTES) throw new WebSkillError("ATTACHMENT_TOO_LARGE", `Attachment "${file.name}" is ${Math.round(file.size / 1024 / 1024)} MB, which exceeds the 10 MB limit`);
 		const id = `att-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 		const relative = `${this.#options.sessionId() ?? "pending"}/${id}-${safeName(file.name)}`;
@@ -46692,8 +46859,8 @@ var WebSkillAttachmentAdapter = class {
 			};
 		}
 		if (kind === "document-text") {
-			const extract = this.#options.docxExtractor;
-			if (extract === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "No docx extractor is wired up in this environment.");
+			const extract = this.#extractorFor(file);
+			if (extract === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "No document text extractor is wired up in this environment.");
 			await this.#options.storage.writeText(path, await extract(new Uint8Array(await file.arrayBuffer())));
 			return {
 				...base,
@@ -47666,8 +47833,35 @@ function LocalizedUndoToastProvider({ children }) {
 	});
 }
 const toErrorMessage = (e) => e instanceof Error ? e.message : String(e);
-/** 「读取页面画面」菜单项发出的提示词：说清要的是画面，模型才会走取像而非纯文本抽取 */
-const PAGE_CAPTURE_PROMPT = "Read the current page view, including the images on it, and tell me what you see.";
+/** 与 console 的快捷指令条目同款 id：时间戳 + 随机后缀 */
+const newQuickPromptId = () => `qp-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+/**
+* 宿主种子只注入一次（0.13.0 分册 21 FR-21.6）。
+* 写盘会触发 subscribe 再跑一遍装载，届时 `quickPromptsSeeded` 已为 true，不会二次写入。
+* 宿主没传种子（`undefined`）时什么都不做——不该为「宿主没配」产生一次持久化；
+* 传空数组是「本应用不要快捷指令」，照样落盘打标记（FR-25.4）。
+* 返回已注入的条目（可能是空数组），调用方要立刻拿去更新界面：写盘是 fire-and-forget。
+*/
+function seedQuickPrompts(store, config, seed) {
+	if (config.quickPromptsSeeded || seed === void 0) return void 0;
+	const entries = [];
+	for (const item of seed) {
+		const text = normalizeLocalizedText(typeof item === "string" ? item : item.text);
+		if (Object.keys(text).length === 0) continue;
+		const icon = typeof item === "string" ? void 0 : item.icon;
+		entries.push({
+			id: newQuickPromptId(),
+			text,
+			...icon !== void 0 ? { icon } : {}
+		});
+	}
+	store.save({
+		...config,
+		quickPrompts: entries,
+		quickPromptsSeeded: true
+	}).catch(() => void 0);
+	return entries;
+}
 /** 读 artifact 存储并触发浏览器下载（Blob + a[download]） */
 async function downloadArtifactFile(storage, chatRoot, file) {
 	const fullPath = `${chatRoot}/artifacts/${file.runId ?? ""}/${file.path}`;
@@ -47689,7 +47883,7 @@ async function downloadArtifactFile(storage, chatRoot, file) {
 * presentation shell and accessible thread primitives.
 * @stable
 */
-function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout = "auto", sessionList = "auto", onOpenSettings, onEngineReady }) {
+function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout = "auto", sessionList = "auto", onOpenSettings, docked, onDock, onClose, onEngineReady }) {
 	const engine = useMemo(() => new ChatEngine(adapter, {
 		...config?.chatRoot ? { chatRoot: config.chatRoot } : {},
 		...config?.llm ? { llm: config.llm } : {},
@@ -47770,6 +47964,29 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 	});
 	/** 当前进行中 run 的 part 累积器（流式正文 / 工具 / 生命周期步进的唯一来源） */
 	const [live, setLive] = useState();
+	/** RuntimeConfig 里快捷指令的镜像（FR-21.5）：console 改完经 subscribe 回来 */
+	const [storedQuickPrompts, setStoredQuickPrompts] = useState([]);
+	/** 空态与动态指令条最多展示多少条（console 可改） */
+	const [quickPromptLimit, setQuickPromptLimit] = useState(8);
+	/** 种子的 ref 镜像：props 每次渲染都是新数组，进 effect 依赖表会让配置订阅反复重建 */
+	const seedRef = useRef(config?.quickPrompts);
+	seedRef.current = config?.quickPrompts;
+	/**
+	* 静态清单（FR-21.6 / FR-25.2）：存储里有什么就是什么。
+	* 未接配置存储的宿主用 props；接了存储就以存储为准，两者皆空即一张卡都不渲染——
+	* 内置示例已下线（分册 25），chatbot 显示的每一条都要在 console 的快捷指令页里管得到。
+	*/
+	const staticQuickPrompts = useMemo(() => {
+		if (storedQuickPrompts.length > 0) return storedQuickPrompts.map(({ text, icon }) => ({
+			text,
+			...icon !== void 0 ? { icon } : {}
+		}));
+		return configStore === void 0 ? config?.quickPrompts : [];
+	}, [
+		storedQuickPrompts,
+		config?.quickPrompts,
+		configStore
+	]);
 	const [interactionPending, setInteractionPending] = useState(false);
 	/** 等待对象名称（interaction-requested 携带）：等待指示器要说清在等什么 */
 	const [interactionLabel, setInteractionLabel] = useState();
@@ -47823,7 +48040,8 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		sessionId: () => sessionRef.current,
 		multimodal: () => multimodalRef.current,
 		imageCapable: () => imageCapableRef.current,
-		...adapter.docxExtractor ? { docxExtractor: adapter.docxExtractor } : {}
+		...adapter.docxExtractor ? { docxExtractor: adapter.docxExtractor } : {},
+		...adapter.xlsxExtractor ? { xlsxExtractor: adapter.xlsxExtractor } : {}
 	}), [adapter, engine]);
 	useEffect(() => {
 		let cancelled = false;
@@ -47850,6 +48068,9 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 					...rc.llm.defaultId ? { defaultId: rc.llm.defaultId } : {}
 				});
 				setLlmSelectionLoaded(true);
+				const seeded = seedQuickPrompts(merged, rc, seedRef.current);
+				setStoredQuickPrompts(seeded ?? rc.quickPrompts);
+				setQuickPromptLimit(rc.quickPromptLimit);
 				multimodalRef.current = rc.multimodal;
 				setMultimodal(rc.multimodal);
 				setLoopLimits({
@@ -48087,6 +48308,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			setCurrentSessionId(id);
 			setMessages(history.items);
 			setMessagesCursor(history.nextCursor);
+			setError(void 0);
 			setModelId(engine.modelId);
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
 	}, [engine, flushPendingDeletes]);
@@ -48146,6 +48368,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			setCurrentSessionId(meta.id);
 			setMessages([]);
 			setMessagesCursor(void 0);
+			setError(void 0);
 			setModelId(engine.modelId);
 			await refreshSessions();
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
@@ -48181,6 +48404,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			if (id === currentSessionId) {
 				setCurrentSessionId(void 0);
 				setMessages([]);
+				setError(void 0);
 			}
 			await refreshSessions();
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
@@ -48246,7 +48470,10 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 							...config?.title ? { title: config.title } : {},
 							onOpenSessions: () => setSessionsOpen(true),
 							onCreateSession: handleCreate,
-							...onOpenSettings ? { onOpenSettings: () => onOpenSettings() } : {}
+							...onOpenSettings ? { onOpenSettings: () => onOpenSettings() } : {},
+							...docked !== void 0 ? { docked } : {},
+							...onDock ? { onDock } : {},
+							...onClose ? { onClose } : {}
 						}),
 						/* @__PURE__ */ jsx(InterruptedBanner, {
 							engine,
@@ -48262,7 +48489,9 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 										children: [
 											messages.length === 0 && !sending ? /* @__PURE__ */ jsx(AssistantUiEmptyState, {
 												...config?.title ? { title: config.title } : {},
-												...config?.quickPrompts ? { prompts: config.quickPrompts } : {},
+												...staticQuickPrompts ? { prompts: staticQuickPrompts } : {},
+												...config?.dynamicQuickPrompts ? { dynamicPrompts: config.dynamicQuickPrompts } : {},
+												limit: quickPromptLimit,
 												disabled: sending,
 												onPrompt: handleSend
 											}) : null,
@@ -48328,6 +48557,11 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 									} : {},
 									onLocate: handleLocateInteraction
 								}),
+								messages.length > 0 && !sending && config?.dynamicQuickPrompts ? /* @__PURE__ */ jsx(AssistantUiDynamicPrompts, {
+									prompts: config.dynamicQuickPrompts,
+									limit: quickPromptLimit,
+									onPrompt: handleSend
+								}) : null,
 								/* @__PURE__ */ jsx(AssistantUiComposer, {
 									...modelCapabilities ? { capabilities: {
 										tools: modelCapabilities.tools,
@@ -48343,11 +48577,6 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 										enabled: multimodal.imageAttachments,
 										imageCapable: modelTakesImages
 									},
-									pageCapture: {
-										enabled: multimodal.pageImageCapture,
-										imageCapable: modelTakesImages,
-										onSelect: () => handleSend(PAGE_CAPTURE_PROMPT)
-									},
 									...dictationLang !== "" ? { dictationLang } : {},
 									...composerModels && !noUsableModel ? { models: composerModels } : {},
 									...noUsableModel ? { noModel: { onConfigure: () => setNoModelGuideOpen(true) } } : {},
@@ -48425,7 +48654,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.8.0";
+const CHATBOT_VERSION = "0.10.0";
 
 //#endregion
 export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };