@webskill/chatbot 0.15.0 → 0.17.0

package/dist/types-C4dzGOPp.js

@@ -0,0 +1,511 @@
+//#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 ../runtime/src/tools/types.ts
+/**
+* `file` 分片的上限（FR-23.4），量的是**实际上线的 base64 长度**而不是解码后的字节——
+* provider 的限额算的是请求载荷。
+*
+* 2026-08-14 查证的三家上限：
+* | provider  | 上限                                    | 出处                    |
+* | --------- | --------------------------------------- | ----------------------- |
+* | Anthropic | **32 MB**（**整个请求载荷**）、600 页   | PDF support / 请求大小  |
+* | OpenAI    | 单文件 50 MB，全部文件合计 50 MB        | File inputs / 使用须知  |
+* | Gemini    | 50 MB 或 1000 页（内联与 Files API 同） | 文档理解 / 技术详情     |
+*
+* 取最小值 Anthropic 的 32 MB。它是**整个请求**的额度，不是文档单独的额度，
+* 所以再留出余量给系统提示词、catalog（约 34 KB）、历史消息与其余分片。
+* 25 000 KB base64 ≈ 18.75 MB 原始 PDF。取 1024 的整数倍：设置界面按 KB 展示，
+* 十进制的 24 000 000 会显示成 23437.5 这种读不出来的数。
+*/
+const DEFAULT_MAX_DOCUMENT_BYTES = 256e5;
+/**
+* `document-text` 分片的上限（FR-23.4）。
+*
+* 约束来自**上下文窗口**而不是请求大小：抽出来的文本要整段进上下文。
+* 按英文约 4 字节/token 折算，500 KB ≈ 128K token，占 200K 窗口的多半，
+* 给历史消息与模型的回答留下其余。
+*/
+const DEFAULT_MAX_DOCUMENT_TEXT_BYTES = 512e3;
+/**
+* 单次 fetchData 结果的字节上限（分册 16，FR-16.6）：1000 KB。
+* 结构化数据不是文档，量级差一个数量级；超出**只拒不截**——截断的 JSON 解不出来。
+*/
+const DEFAULT_MAX_DATA_SOURCE_BYTES = 1024e3;
+/**
+* 单个上传文件交给脚本的字节上限（0.15.0 分册 17，FR-17.5）：20 MB。
+* 取得比模型图片预算宽：字节不进模型上下文，只进脚本，护的是内存不是 token。
+*/
+const DEFAULT_MAX_UPLOAD_FILE_BYTES = 20 * 1024 * 1024;
+
+//#endregion
+//#region ../runtime/src/engine/limits.ts
+/**
+* Agent loop 的运行上限默认值。**全仓唯一来源**（S8）。
+*
+* 在 0.7.0 之前这三个数字在 `AgentLoop` 的构造与 ui-kit 的 `defaultRuntimeConfig()`
+* 里各写了一遍。两份值今天恰好相等，所以不出事；一旦其中一处被改，
+* 「恢复默认值」会恢复到 agent loop 根本不用的值——验收绿、行为错。
+* @stable
+*/
+const DEFAULT_LOOP_LIMITS = {
+	maxTurns: 1e3,
+	totalTimeoutMs: 36e5,
+	toolTimeoutMs: 6e5,
+	maxHistoryMessages: 1e3
+};
+
+//#endregion
+//#region ../ui-kit/src/runtime-config/quickPrompts.ts
+/**
+* 受控枚举的全部取值（console 的图标下拉数据源）。
+*
+* 0.20.0：写成字面量而不是 `Object.keys(ICONS)`——后者会让「只要名字」的
+* 调用方（`@webskill/chatbot/config`）在运行时依赖图标表，把 lucide-react 连同 React 一起拖进产物。
+* 与 `QuickPromptIconName` 的一致性由 `enums.ts` 里的 `RuntimeConfigEnumsAreExhaustive` 双向锁定；
+* 与图标表的一致性由 `./quickPromptIcons` 的 `Record<QuickPromptIconName, LucideIcon>` 锁定。
+* @experimental
+*/
+const QUICK_PROMPT_ICON_NAMES = [
+	"chart",
+	"document",
+	"report",
+	"search",
+	"list",
+	"bug",
+	"test",
+	"metric",
+	"compare",
+	"page",
+	"run",
+	"warn",
+	"sparkles",
+	"settings"
+];
+/**
+* 图标表与 `resolveQuickPromptIcon` 拆在 `./quickPromptIcons`：本文件被
+* `@webskill/chatbot/config` 依赖，不能沾 React。
+*/
+/** 空态网格是两列，8 条即四行（FR-17.4 / D-17-6）；用户可在 console 里上调 */
+const DEFAULT_QUICK_PROMPT_LIMIT = 8;
+/** 可调范围的天花板：20 条已经把欢迎区撑成十行，再多就满屏都是按钮 */
+const MAX_QUICK_PROMPT_LIMIT = 20;
+/** 统一成对象形态：宿主可以只给字符串，该字符串填满全部语种（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
+/**
+* 生成式 UI 场景预设的默认开放范围。
+* ui-kit 不依赖 `@webskill/ui`，因此这里只能写字面量；
+* 与目录实际导出的 `UI_PRESET_NAMES` 是否一致由 console 的测试守护。
+*/
+const DEFAULT_UI_PRESETS = [
+	"charts",
+	"cards",
+	"dashboards",
+	"slides",
+	"reports"
+];
+/** 渲染器档位的枚举值；下拉选项与导入校验共用同一份，避免两处各写一个列表 */
+const RUNTIME_RENDERER_IDS = [
+	"native",
+	"a2ui",
+	"openui",
+	"vercel"
+];
+/** SDK 默认值（三个运行上限取自 `DEFAULT_LOOP_LIMITS`；interaction user/required/300s、deny-all 等） */
+function defaultRuntimeConfig() {
+	return {
+		loop: {
+			...DEFAULT_LOOP_LIMITS,
+			toolResultMaxBytes: 256e3,
+			maxDocumentBytes: DEFAULT_MAX_DOCUMENT_BYTES,
+			maxDocumentTextBytes: DEFAULT_MAX_DOCUMENT_TEXT_BYTES
+		},
+		interaction: {
+			missingParams: "user",
+			confirmations: "required",
+			interactionTimeoutMs: 3e5,
+			approvalScope: "once-per-run"
+		},
+		router: { strategy: "progressive" },
+		hooks: {
+			timeoutMs: 5e3,
+			failOnHookError: false
+		},
+		streaming: true,
+		renderResult: true,
+		sandbox: {
+			executor: "auto",
+			networkPolicy: "deny-all",
+			capabilities: {
+				readReference: true,
+				readAsset: true,
+				writeArtifact: true,
+				confirm: true,
+				fetchData: false
+			},
+			maxDataSourceBytes: DEFAULT_MAX_DATA_SOURCE_BYTES,
+			dataSources: [],
+			remoteUrl: {
+				allowHttp: false,
+				allowPrivateHosts: false
+			},
+			typescript: { enabled: false },
+			downloadedFiles: false,
+			uploadFiles: false,
+			maxUploadFileBytes: DEFAULT_MAX_UPLOAD_FILE_BYTES
+		},
+		llm: { entries: [] },
+		agentCapabilities: {
+			todo: true,
+			skillGeneration: false,
+			generativeUi: false,
+			delegation: false,
+			uiPresets: [...DEFAULT_UI_PRESETS]
+		},
+		security: { unsignedSkills: "warn" },
+		appearance: {
+			theme: "dark",
+			locale: "zh",
+			renderer: "native",
+			dictationLang: ""
+		},
+		multimodal: {
+			imageAttachments: false,
+			pageImageCapture: false,
+			maxImageBytes: 10 * 1024 * 1024,
+			maxImagesPerMessage: 50,
+			minImageArea: 1024
+		},
+		documentSurface: { enabled: false },
+		userProfile: {
+			enabled: false,
+			injectMaxBytes: 4096,
+			recordLimit: 500,
+			encrypted: true
+		},
+		skillState: { quarantineThreshold: 5 },
+		quickPrompts: [],
+		quickPromptsSeeded: false,
+		quickPromptLimit: 8,
+		dismissedAutoEntries: []
+	};
+}
+/** 旧的单对象配置升格成列表时使用的固定 id：每次 load 都重算，随机 id 会让会话里存的归属失效 */
+const MIGRATED_ENTRY_ID = "llm-1";
+function isLlmEntry(value) {
+	const e = value;
+	return typeof e?.id === "string" && e.id !== "" && typeof e.provider === "string";
+}
+/**
+* `llm` 段的迁移（AC-4.2）：旧的单对象升格为单元素列表，原字段一个不丢（含 `apiKey`）。
+* 全空的旧配置等价于「还没配过模型」，不生成占位条目。
+*/
+function mergeLlmSelection(raw) {
+	const value = typeof raw === "object" && raw !== null ? raw : {};
+	const entries = Array.isArray(value["entries"]) ? value["entries"].filter(isLlmEntry).map((entry) => ({
+		...entry,
+		label: entry.label ?? entry.model ?? entry.id
+	})) : upgradeLegacyLlm(value);
+	if (entries.length === 0) return { entries: [] };
+	const requested = typeof value["defaultId"] === "string" ? value["defaultId"] : void 0;
+	const defaultId = entries.some((entry) => entry.id === requested) ? requested : entries[0]?.id;
+	return defaultId !== void 0 ? {
+		entries,
+		defaultId
+	} : { entries };
+}
+function upgradeLegacyLlm(legacy) {
+	const model = typeof legacy.model === "string" ? legacy.model.trim() : "";
+	const baseUrl = typeof legacy.baseUrl === "string" ? legacy.baseUrl.trim() : "";
+	const apiKey = typeof legacy.apiKey === "string" ? legacy.apiKey.trim() : "";
+	if (model === "" && baseUrl === "" && apiKey === "") return [];
+	const provider = typeof legacy.provider === "string" ? legacy.provider : "openai-compatible";
+	return [{
+		id: MIGRATED_ENTRY_ID,
+		label: model !== "" ? model : provider,
+		provider,
+		model,
+		...baseUrl !== "" ? { baseUrl } : {},
+		...apiKey !== "" ? { apiKey } : {},
+		...typeof legacy.requestTimeoutMs === "number" ? { requestTimeoutMs: legacy.requestTimeoutMs } : {}
+	}];
+}
+/** 存储读出的部分配置按默认值补齐（老版本存储缺字段时平滑迁移） */
+function mergeRuntimeConfigDefaults(partial) {
+	const d = defaultRuntimeConfig();
+	const p = typeof partial === "object" && partial !== null ? partial : {};
+	const sub = (key, base) => ({
+		...base,
+		...p[key] ?? {}
+	});
+	return {
+		loop: sub("loop", d.loop),
+		interaction: sub("interaction", d.interaction),
+		router: sub("router", d.router),
+		hooks: sub("hooks", d.hooks),
+		streaming: typeof p["streaming"] === "boolean" ? p["streaming"] : d.streaming,
+		renderResult: typeof p["renderResult"] === "boolean" ? p["renderResult"] : d.renderResult,
+		sandbox: {
+			...sub("sandbox", d.sandbox),
+			capabilities: {
+				...d.sandbox.capabilities,
+				...p["sandbox"]?.["capabilities"] ?? {}
+			},
+			remoteUrl: {
+				...d.sandbox.remoteUrl,
+				...p["sandbox"]?.["remoteUrl"] ?? {}
+			},
+			typescript: {
+				...d.sandbox.typescript,
+				...p["sandbox"]?.["typescript"] ?? {}
+			},
+			dataSources: readDataSourceEntries(p["sandbox"]?.["dataSources"])
+		},
+		llm: mergeLlmSelection(p["llm"]),
+		agentCapabilities: {
+			...sub("agentCapabilities", d.agentCapabilities),
+			uiPresets: readStringList(p["agentCapabilities"]?.["uiPresets"], d.agentCapabilities.uiPresets)
+		},
+		security: sub("security", d.security),
+		appearance: mergeAppearance(p["appearance"], d.appearance),
+		multimodal: mergeMultimodal(p["multimodal"], d.multimodal),
+		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(p["dismissedAutoEntries"], [])
+	};
+}
+const RENDERER_IDS = RUNTIME_RENDERER_IDS;
+/**
+* `appearance` 逐字段校验而不是整段展开：这三个字段都是字面量联合，
+* 存储里的脏值（旧版本、手改的 localStorage）展开后会变成类型上不存在的档位。
+*/
+function mergeAppearance(raw, d) {
+	const p = typeof raw === "object" && raw !== null ? raw : {};
+	const stored = p["dictationLang"];
+	return {
+		theme: p["theme"] === "light" || p["theme"] === "dark" ? p["theme"] : d.theme,
+		locale: p["locale"] === "zh" || p["locale"] === "en" ? p["locale"] : d.locale,
+		renderer: RENDERER_IDS.includes(p["renderer"]) ? p["renderer"] : d.renderer,
+		dictationLang: typeof stored === "string" ? stored.trim() : d.dictationLang
+	};
+}
+function readStringList(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;
+}
+/**
+* 逐条校验用户配的数据源：`id` / `url` 缺失或非字符串即整条丢弃。
+* 不整段回退，一条脏数据不该连坐其余几条。
+*/
+function readDataSourceEntries(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	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 url = typeof entry["url"] === "string" ? entry["url"].trim() : "";
+		if (id === "" || url === "" || seen.has(id)) continue;
+		seen.add(id);
+		out.push({
+			id,
+			url,
+			description: typeof entry["description"] === "string" ? entry["description"] : ""
+		});
+	}
+	return out;
+}
+/** 上限字段非正数时回退默认值：0 或负数会把整条通道变成永远拒收 */
+function mergeMultimodal(raw, d) {
+	const p = typeof raw === "object" && raw !== null ? raw : {};
+	const positive = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+	return {
+		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),
+		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` 会抛，等于整条投放面瘫掉。
+*/
+function mergeDocumentSurface(raw, d) {
+	const p = typeof raw === "object" && raw !== null ? raw : {};
+	return { enabled: typeof p["enabled"] === "boolean" ? p["enabled"] : d.enabled };
+}
+/** 与 multimodal 同一套判据：非正数上限会让记录/注入通道恒空，回退默认值 */
+function mergeUserProfile(raw, d) {
+	const p = typeof raw === "object" && raw !== null ? raw : {};
+	const positive = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+	return {
+		enabled: typeof p["enabled"] === "boolean" ? p["enabled"] : d.enabled,
+		injectMaxBytes: positive(p["injectMaxBytes"], d.injectMaxBytes),
+		recordLimit: positive(p["recordLimit"], d.recordLimit),
+		encrypted: typeof p["encrypted"] === "boolean" ? p["encrypted"] : d.encrypted
+	};
+}
+/** 与 multimodal 同一套判据：阈值非正整数会让隔离永不触发或立即触发，回退默认值 */
+function mergeSkillState(raw, d) {
+	const value = (typeof raw === "object" && raw !== null ? raw : {})["quarantineThreshold"];
+	return { quarantineThreshold: typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : d.quarantineThreshold };
+}
+/**
+* Wraps a store whose load() may return partial/legacy data, normalizing every read
+* through mergeRuntimeConfigDefaults so all consumers share one defaults-filling
+* behavior (0.2.7 B3). save/reset pass through unchanged.
+*/
+function withRuntimeConfigDefaults(store) {
+	return {
+		load: async () => mergeRuntimeConfigDefaults(await store.load()),
+		save: (config) => store.save(config),
+		reset: () => store.reset(),
+		...store.subscribe ? { subscribe: (listener) => store.subscribe(listener) } : {}
+	};
+}
+
+//#endregion
+export { QUICK_PROMPT_ICON_NAMES as a, withRuntimeConfigDefaults as i, defaultRuntimeConfig as n, mergeQuickPrompts as o, mergeRuntimeConfigDefaults as r, normalizeLocalizedText as s, RUNTIME_RENDERER_IDS as t };

package/dist/vite.d.ts

@@ -0,0 +1,33 @@
+import { n as ParseWebSkillConfigOptions, r as ParsedWebSkillConfig } from "./parse-Cc8nFxir.js";
+import { Plugin } from "vite";
+//#region src/vite.d.ts
+/**
+ * `'bake'` 时打印的警告。
+ *
+ * 是导出常量而不是内联串：AC-12.2 对它做断言，而措辞本身正是那条 AC 要守的东西。
+ * @experimental
+ */
+declare const WEBSKILL_SECRETS_WARNING: string;
+/**
+ * 凭据三态。`'omit'` 是**不生成**解密代码，而不是生成了但走不到。
+ * @experimental
+ */
+type WebSkillSecretsMode = 'omit' | 'bake' | 'dev-only';
+/** 插件选项。`hostSections` 等解析选项从 `ParseWebSkillConfigOptions` 继承 @experimental */
+interface WebSkillConfigPluginOptions extends ParseWebSkillConfigOptions {
+  /** 配置文件路径。文件不存在时按「没有宿主缺省值」处理，不报错 */
+  readonly file: string;
+  /** 缺省 `'omit'`：不猜这个构建是不是私有部署，猜错的代价是把凭据发上公网 */
+  readonly secrets?: WebSkillSecretsMode;
+  /** 解析成功后回调，宿主用来读 `host` 分节（如浏览器扩展的 manifest 覆写） */
+  onParsed?(parsed: ParsedWebSkillConfig): void;
+}
+/**
+ * 构建期读 `config.json`，把结果以虚拟模块 `virtual:webskill-config` 交给应用代码。
+ *
+ * 校验失败一律**中断构建**（带字段完整路径）；文件不存在则按「无宿主缺省值」继续。
+ * @experimental
+ */
+declare function webskillConfig(options: WebSkillConfigPluginOptions): Plugin;
+//#endregion
+export { WEBSKILL_SECRETS_WARNING, WebSkillConfigPluginOptions, WebSkillSecretsMode, webskillConfig };

package/dist/vite.js

@@ -0,0 +1,132 @@
+import { n as parseWebSkillConfig } from "./parse-79VbXLl4.js";
+import { readFileSync } from "node:fs";
+import { webcrypto } from "node:crypto";
+
+//#region src/vite.ts
+/**
+* `@webskill/chatbot/vite` —— 把配置文件接进构建。
+*
+* 只有这个入口碰 `node:*`；配置契约本身在 `@webskill/chatbot/config`，
+* 收的是已解析的 JSON 值，浏览器侧与构建脚本共用。
+*/
+const VIRTUAL_ID = "virtual:webskill-config";
+const RESOLVED_ID = `\0${VIRTUAL_ID}`;
+/**
+* `'bake'` 时打印的警告。
+*
+* 是导出常量而不是内联串：AC-12.2 对它做断言，而措辞本身正是那条 AC 要守的东西。
+* @experimental
+*/
+const WEBSKILL_SECRETS_WARNING = "WARNING: WebSkill is baking API keys into the build output. The decryption key travels in the same bundle as the ciphertext, so this is obfuscation, not encryption — anyone holding the build output can recover the plaintext. Only ship it to a distribution surface you control.";
+const EMPTY_PARSE = {
+	defaults: {},
+	secrets: {},
+	host: {}
+};
+const toBase64 = (bytes) => Buffer.from(bytes).toString("base64");
+/**
+* `'omit'` 分支生成的源码里**没有任何 crypto 调用**。
+* 留一段走不到的 WebCrypto 分支等于给审计者一个「这里可能有密钥」的假信号。
+*/
+const NO_SECRETS_SOURCE = "export const loadWebSkillSecrets = async () => ({});\n";
+/** 渲染函数里禁止出现反引号注释：它会静默终止模板字符串，残骸在运行时才炸 */
+function renderSecretLoader(key, entries) {
+	return `const SECRET_KEY = ${JSON.stringify(key)};
+const SECRET_ENTRIES = ${JSON.stringify(entries, null, 2)};
+
+function fromBase64(value) {
+  const binary = atob(value);
+  const buffer = new ArrayBuffer(binary.length);
+  const bytes = new Uint8Array(buffer);
+  for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+  return buffer;
+}
+
+let cache;
+
+export async function loadWebSkillSecrets() {
+  if (cache !== undefined) return cache;
+  const out = {};
+  try {
+    const key = await crypto.subtle.importKey('raw', fromBase64(SECRET_KEY), 'AES-GCM', false, ['decrypt']);
+    for (const id of Object.keys(SECRET_ENTRIES)) {
+      const secret = SECRET_ENTRIES[id];
+      const plain = await crypto.subtle.decrypt(
+        { name: 'AES-GCM', iv: fromBase64(secret.iv) },
+        key,
+        fromBase64(secret.data)
+      );
+      out[id] = new TextDecoder().decode(plain);
+    }
+  } catch {
+    // 产物被改坏时按「没有烘焙凭据」处理：用户仍可自己填，不该整页失败
+    for (const id of Object.keys(out)) delete out[id];
+  }
+  cache = out;
+  return cache;
+}
+`;
+}
+async function renderSecrets(secrets) {
+	const ids = Object.keys(secrets);
+	if (ids.length === 0) return NO_SECRETS_SOURCE;
+	const rawKey = webcrypto.getRandomValues(/* @__PURE__ */ new Uint8Array(32));
+	const cryptoKey = await webcrypto.subtle.importKey("raw", rawKey, "AES-GCM", false, ["encrypt"]);
+	const entries = {};
+	for (const id of ids) {
+		const iv = webcrypto.getRandomValues(/* @__PURE__ */ new Uint8Array(12));
+		const data = await webcrypto.subtle.encrypt({
+			name: "AES-GCM",
+			iv
+		}, cryptoKey, new TextEncoder().encode(secrets[id]));
+		entries[id] = {
+			iv: toBase64(iv),
+			data: toBase64(new Uint8Array(data))
+		};
+	}
+	return renderSecretLoader(toBase64(rawKey), entries);
+}
+function readConfigFile(file) {
+	let text;
+	try {
+		text = readFileSync(file, "utf8");
+	} catch {
+		return;
+	}
+	return JSON.parse(text);
+}
+/**
+* 构建期读 `config.json`，把结果以虚拟模块 `virtual:webskill-config` 交给应用代码。
+*
+* 校验失败一律**中断构建**（带字段完整路径）；文件不存在则按「无宿主缺省值」继续。
+* @experimental
+*/
+function webskillConfig(options) {
+	const secretsMode = options.secrets ?? "omit";
+	let parsed = EMPTY_PARSE;
+	let bakeSecrets = false;
+	return {
+		name: "webskill:config",
+		configResolved(config) {
+			const raw = readConfigFile(options.file);
+			parsed = raw === void 0 ? EMPTY_PARSE : parseWebSkillConfig(raw, { hostSections: options.hostSections });
+			bakeSecrets = secretsMode === "bake" || secretsMode === "dev-only" && config.mode === "development";
+			if (bakeSecrets && Object.keys(parsed.secrets).length > 0) config.logger.warn(WEBSKILL_SECRETS_WARNING);
+			options.onParsed?.(parsed);
+		},
+		resolveId(id) {
+			return id === VIRTUAL_ID ? RESOLVED_ID : void 0;
+		},
+		async load(id) {
+			if (id !== RESOLVED_ID) return void 0;
+			const secretsSource = bakeSecrets ? await renderSecrets(parsed.secrets) : NO_SECRETS_SOURCE;
+			return `/* Generated by @webskill/chatbot/vite. Do not edit. */
+export const WEBSKILL_CONFIG = ${JSON.stringify(parsed.defaults, null, 2)};
+
+${secretsSource}`;
+		}
+	};
+}
+
+//#endregion
+export { WEBSKILL_SECRETS_WARNING, webskillConfig };