@webskill/chatbot 0.16.0 → 0.18.0

package/dist/chatbot.css

@@ -388,6 +388,9 @@
   .ms-auto {
     margin-inline-start: auto;
   }
+  .me-1 {
+    margin-inline-end: var(--spacing);
+  }
   .mt-0\.5 {
     margin-top: calc(var(--spacing) * 0.5);
   }
@@ -708,6 +711,9 @@
   .cursor-default {
     cursor: default;
   }
+  .cursor-grab {
+    cursor: grab;
+  }
   .cursor-not-allowed {
     cursor: not-allowed;
   }
@@ -1032,6 +1038,12 @@
   .bg-muted-foreground {
     background-color: var(--muted-foreground);
   }
+  .bg-muted\/40 {
+    background-color: var(--muted-foreground);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--muted-foreground) 40%, transparent);
+    }
+  }
   .bg-popover {
     background-color: var(--popover);
   }
@@ -1391,6 +1403,10 @@
     outline-style: var(--tw-outline-style);
     outline-width: 1px;
   }
+  .sepia {
+    --tw-sepia: sepia(100%);
+    filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
+  }
   .filter {
     filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
   }
@@ -1703,6 +1719,9 @@
     --tw-outline-style: none;
     outline-style: none;
   }
+  .active\:cursor-grabbing:active {
+    cursor: grabbing;
+  }
   .active\:bg-primary\/80:active {
     background-color: var(--primary);
     @supports (color: color-mix(in lab, red, red)) {

package/dist/config.d.ts

@@ -0,0 +1,107 @@
+import { n as RuntimeConfig, r as RuntimeConfigStore } from "./index-Nnkn73aD.js";
+import { a as parseWebSkillConfig, c as ConfigFieldSpec, i as WebSkillConfigDefaults, l as ConfigLeafKind, n as ParseWebSkillConfigOptions, o as CONFIGURED_RUNTIME_PATHS, r as ParsedWebSkillConfig, s as CONFIG_FIELDS, t as CONFIG_TOP_LEVEL_SECTIONS, u as NON_CONFIGURABLE_RUNTIME_PATHS } from "./parse-B8D0fl8I.js";
+//#region src/config/errors.d.ts
+/** 稳定错误码，供宿主可编程处理；`message` 一律英文 @experimental */
+type WebSkillConfigErrorCode = 'CONFIG_UNKNOWN_KEY' | 'CONFIG_TYPE' | 'CONFIG_RANGE' | 'CONFIG_ENUM' | 'CONFIG_SHAPE' | 'CONFIG_REFERENCE';
+/**
+ * 配置文件校验失败。
+ *
+ * 校验一律**硬失败**：拼错一个字段名而解析器静默忽略，得到的是「看起来生效了其实没生效」
+ * 的构建产物，症状出现在运行时且完全无从反推。
+ * @experimental
+ */
+declare class WebSkillConfigError extends Error {
+  readonly code: WebSkillConfigErrorCode;
+  /** 出问题的位置在配置文件里的路径，如 `agentRuntime.loop.maxTurns` */
+  readonly path: string;
+  constructor(code: WebSkillConfigErrorCode, path: string, message: string);
+}
+//#endregion
+//#region src/config/merge.d.ts
+/**
+ * 三方合并：宿主缺省值 · 用户存储 · 上次应用过的缺省值快照。
+ *
+ * 语义是**缺省值**而不是强制覆盖：用户在 Console 里改过的项永远优先。
+ * 合并按层递归而非顶层 spread——SDK 后续新增字段时，老的存储里没有那个字段，
+ * 逐层合并才能让缺省值填进去；顶层 spread 会因为 `sandbox` 整体存在而整段落空。
+ *
+ * 数组是**替换**语义：`entries: []` 是「用户把模型删光了」，
+ * 与「从没配过」（键缺席）必须分得开，否则删掉的条目会自己长回来。
+ *
+ * 唯一的例外是 `llm.entries` 里的**烘焙条目**：它们是随扩展一起发的运维配置，
+ * 不是用户资产，走 `syncBakedEntries` 的下发语义（0.21.0 分册 24）。
+ */
+/** 三方合并的输入 @experimental */
+interface ApplyConfigDefaultsInput {
+  /** 用户存储里的原始值（**未**合并默认值），可缺席 */
+  readonly stored?: unknown;
+  /** `parseWebSkillConfig(...).defaults` */
+  readonly defaults: WebSkillConfigDefaults;
+  /** 上次应用过的缺省值快照，可缺席 */
+  readonly lastApplied?: WebSkillConfigDefaults;
+}
+/** 合并结果：可直接使用的配置，以及要持久化的本次缺省值快照 @experimental */
+interface AppliedConfigDefaults {
+  readonly config: RuntimeConfig;
+  /** 本次应用的缺省值；调用方负责持久化，下次作为 `lastApplied` 传回 */
+  readonly snapshot: WebSkillConfigDefaults;
+}
+/**
+ * `lastApplied` 缺席时每条分支都退化成「stored 存在就取 stored」，
+ * 即老实现的 `deepMerge(defaults, stored)`——修订跟随是纯增量，不改既有语义。
+ * @experimental
+ */
+declare function applyConfigDefaults(input: ApplyConfigDefaultsInput): AppliedConfigDefaults;
+//#endregion
+//#region src/config/store.d.ts
+/**
+ * 把「宿主缺省值」接进宿主已有的 `RuntimeConfigStore`。
+ *
+ * 不改 `RuntimeConfigStore` 接口——那是既有公开契约。包装器额外要一条读**原始**
+ * 存储的通道（`readRaw`）：`load()` 返回的是补齐默认值之后的完整配置，
+ * 从它分不出「用户显式设成 deny-all」和「用户没配、SDK 默认就是 deny-all」。
+ */
+/**
+ * 存储里代替明文 apiKey 的占位串。
+ *
+ * 它让烘焙的密钥不落盘（F12 看 localStorage 看不到），但**到此为止**：
+ * 密钥运行时必然在内存里以明文存在，也必然明文发给模型提供方。
+ * 这不是安全边界，只是把可被顺手读到的面缩小一点。
+ * @experimental
+ */
+declare const BAKED_KEY_SENTINEL = "\0webskill:baked-api-key";
+/**
+ * entryId → 明文 apiKey。
+ *
+ * 解密代码由 `@webskill/chatbot/vite` 在 `secrets: 'bake'` 时**生成**，
+ * 因此本模块里一行 WebCrypto 都没有——`'omit'` 构建的产物里也就扫不到 `crypto.subtle`。
+ * 宿主直接把虚拟模块的 `loadWebSkillSecrets` 传进来即可。
+ * @experimental
+ */
+type BakedSecretLoader = () => Promise<Readonly<Record<string, string>>>;
+/** 上次生效的缺省值快照仓；存哪儿由宿主决定 @experimental */
+interface ConfigDefaultsSnapshotStore {
+  read(): Promise<WebSkillConfigDefaults | undefined> | WebSkillConfigDefaults | undefined;
+  write(snapshot: WebSkillConfigDefaults): Promise<void> | void;
+  clear(): Promise<void> | void;
+}
+/** 包装选项 @experimental */
+interface ConfigDefaultsStoreOptions {
+  /** `parseWebSkillConfig(...).defaults` */
+  readonly defaults: WebSkillConfigDefaults;
+  /** 读原始存储；返回 `undefined` 表示这台机器上从没存过配置 */
+  readRaw(): Promise<unknown> | unknown;
+  /** 上次应用过的缺省值快照的读写。不给就退化成「每次都按首次应用处理」 */
+  readonly snapshot?: ConfigDefaultsSnapshotStore;
+  /** 烘焙凭据的读取器，通常是 `virtual:webskill-config` 的 `loadWebSkillSecrets` */
+  readonly secrets?: BakedSecretLoader;
+}
+/**
+ * 把一个 `RuntimeConfigStore` 包成「读时叠缺省值、写时摘凭据」的 store。
+ *
+ * 用户改过的字段永远优先；传了 `snapshot` 时，没改过的字段会跟随重新打包后的新缺省值。
+ * @experimental
+ */
+declare function createConfigDefaultsStore(store: RuntimeConfigStore, options: ConfigDefaultsStoreOptions): RuntimeConfigStore;
+//#endregion
+export { type AppliedConfigDefaults, type ApplyConfigDefaultsInput, BAKED_KEY_SENTINEL, type BakedSecretLoader, CONFIGURED_RUNTIME_PATHS, CONFIG_FIELDS, CONFIG_TOP_LEVEL_SECTIONS, type ConfigDefaultsSnapshotStore, type ConfigDefaultsStoreOptions, type ConfigFieldSpec, type ConfigLeafKind, NON_CONFIGURABLE_RUNTIME_PATHS, type ParseWebSkillConfigOptions, type ParsedWebSkillConfig, type WebSkillConfigDefaults, WebSkillConfigError, type WebSkillConfigErrorCode, applyConfigDefaults, createConfigDefaultsStore, parseWebSkillConfig };

package/dist/config.js

@@ -0,0 +1,200 @@
+import { r as mergeRuntimeConfigDefaults } from "./types-C4dzGOPp.js";
+import { a as NON_CONFIGURABLE_RUNTIME_PATHS, i as CONFIG_FIELDS, n as parseWebSkillConfig, o as WebSkillConfigError, r as CONFIGURED_RUNTIME_PATHS, t as CONFIG_TOP_LEVEL_SECTIONS } from "./parse-Bo68XTn_.js";
+
+//#region src/config/merge.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** 叶子相等判定。数组与对象都按结构比，因为叶子可以是数组（模型列表、提示词） */
+function sameValue(a, b) {
+	if (Object.is(a, b)) return true;
+	if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((item, index) => sameValue(item, b[index]));
+	if (isPlainObject(a) && isPlainObject(b)) {
+		const keys = Object.keys(a);
+		if (keys.length !== Object.keys(b).length) return false;
+		return keys.every((key) => key in b && sameValue(a[key], b[key]));
+	}
+	return false;
+}
+/**
+* 逐叶子决定归属。
+*
+* 中间那个分支是本版的**全部新增语义**，也是最容易被后人当成冗余删掉的一条：
+* 存储里的值与上次应用过的缺省值逐字相等，说明用户从没碰过这一项，
+* 于是它应当跟随宿主新一版的缺省值。没有这一条，宿主改了默认值，
+* 所有装过旧版的用户永远停在旧默认值上，而他们自己完全不知道有这么一项。
+*/
+function mergeLeaf(stored, defaultValue, lastApplied) {
+	if (defaultValue === void 0) return stored;
+	if (stored === void 0) return defaultValue;
+	if (isPlainObject(stored) && isPlainObject(defaultValue)) {
+		const last = isPlainObject(lastApplied) ? lastApplied : void 0;
+		const out = { ...stored };
+		for (const key of Object.keys(defaultValue)) out[key] = mergeLeaf(stored[key], defaultValue[key], last?.[key]);
+		return out;
+	}
+	if (lastApplied !== void 0 && sameValue(stored, lastApplied)) return defaultValue;
+	return stored;
+}
+/**
+* 烘焙模型按 id 强制同步（0.21.0 分册 24 · FR-24.1）。
+*
+* 与 `mergeLeaf` 的「缺省值」语义不同，这里是**下发**：整片 `entries` 是一片叶子，
+* 用户只要动过列表任意一处，此后所有重新打包的模型配置都到不了他那里。
+* 所以烘焙条目按 id 整条覆盖、按 defaults 的顺序在前，用户自建的按原相对序在末尾。
+*
+* 但下发只在**运维真的重新打包过模型配置时**发生（FR-24.1d）：烘焙列表与快照逐字
+* 相同，说明这一版没人改过 `config.json`，此时用户在 Console 里的改动与排序全部作数。
+* 快照缺席（全新安装或重装扩展）按「变了」处理——那正是「恢复初始化配置」的时刻。
+*
+* 读的是 `stored` 原始值而不是合并后的那份：合并后的 `entries` 已经被叶子规则
+* 选过边，从它数不准「用户自建了哪些」。
+*/
+function syncBakedEntries(stored, baked, previous, retired) {
+	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))];
+}
+/**
+* 上一版烘过、这一版不再烘的 id（FR-24.5）。
+*
+* 不认它们的话，运维从 `config.json` 里删掉的模型会以「用户自建」的身份
+* 永久留在每台机器上。快照缺席时分辨不出来，一律保留。
+*/
+function retiredBakedIds(lastApplied, baked) {
+	const previous = lastApplied?.llm?.entries ?? [];
+	const bakedIds = new Set(baked.map((entry) => entry.id));
+	return new Set(previous.map((entry) => entry.id).filter((id) => !bakedIds.has(id)));
+}
+/** 烘焙条目在新一版里被删掉时，用户的默认项会变成空引用——那条空引用正是本册造出来的（FR-24.4） */
+function resolveDefaultId(entries, current) {
+	if (typeof current === "string" && entries.some((entry) => entry.id === current)) return current;
+	return entries[0]?.id;
+}
+/** `llm.entries` 之外的一切仍走 0.20.0 的逐叶子规则 */
+function applyBakedModels(merged, stored, defaults, lastApplied) {
+	const baked = defaults.llm?.entries;
+	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 llm = isPlainObject(merged["llm"]) ? merged["llm"] : {};
+	const defaultId = resolveDefaultId(entries, llm["defaultId"]);
+	return {
+		...merged,
+		llm: {
+			...llm,
+			entries,
+			...defaultId === void 0 ? {} : { defaultId }
+		}
+	};
+}
+/**
+* `lastApplied` 缺席时每条分支都退化成「stored 存在就取 stored」，
+* 即老实现的 `deepMerge(defaults, stored)`——修订跟随是纯增量，不改既有语义。
+* @experimental
+*/
+function applyConfigDefaults(input) {
+	const { stored, defaults, lastApplied } = input;
+	return {
+		config: mergeRuntimeConfigDefaults(applyBakedModels(stored === void 0 ? defaults : mergeLeaf(stored, defaults, lastApplied), stored, defaults, lastApplied)),
+		snapshot: defaults
+	};
+}
+
+//#endregion
+//#region src/config/store.ts
+/**
+* 把「宿主缺省值」接进宿主已有的 `RuntimeConfigStore`。
+*
+* 不改 `RuntimeConfigStore` 接口——那是既有公开契约。包装器额外要一条读**原始**
+* 存储的通道（`readRaw`）：`load()` 返回的是补齐默认值之后的完整配置，
+* 从它分不出「用户显式设成 deny-all」和「用户没配、SDK 默认就是 deny-all」。
+*/
+/**
+* 存储里代替明文 apiKey 的占位串。
+*
+* 它让烘焙的密钥不落盘（F12 看 localStorage 看不到），但**到此为止**：
+* 密钥运行时必然在内存里以明文存在，也必然明文发给模型提供方。
+* 这不是安全边界，只是把可被顺手读到的面缩小一点。
+* @experimental
+*/
+const BAKED_KEY_SENTINEL = "\0webskill:baked-api-key";
+function mapEntries(config, map) {
+	return {
+		...config,
+		llm: {
+			...config.llm,
+			entries: config.llm.entries.map(map)
+		}
+	};
+}
+function createSecretVault(loader) {
+	let cache;
+	async function read() {
+		if (cache === void 0) cache = loader === void 0 ? {} : await loader();
+		return cache;
+	}
+	return {
+		/**
+		* 只在 `apiKey` 缺席或等于占位串时注入：空串是用户**显式清空**，
+		* 再注入回去等于用户删不掉这个密钥。
+		*/
+		async restore(config) {
+			const secrets = await read();
+			if (Object.keys(secrets).length === 0) return config;
+			return mapEntries(config, (entry) => {
+				const baked = secrets[entry.id];
+				if (baked === void 0) return entry;
+				if (entry.apiKey !== void 0 && entry.apiKey !== "\0webskill:baked-api-key") return entry;
+				return {
+					...entry,
+					apiKey: baked
+				};
+			});
+		},
+		/** 落盘前把烘焙密钥换回占位串，明文因此不进存储 */
+		async strip(config) {
+			const secrets = await read();
+			if (Object.keys(secrets).length === 0) return config;
+			return mapEntries(config, (entry) => entry.apiKey !== void 0 && entry.apiKey === secrets[entry.id] ? {
+				...entry,
+				apiKey: BAKED_KEY_SENTINEL
+			} : entry);
+		}
+	};
+}
+/**
+* 把一个 `RuntimeConfigStore` 包成「读时叠缺省值、写时摘凭据」的 store。
+*
+* 用户改过的字段永远优先；传了 `snapshot` 时，没改过的字段会跟随重新打包后的新缺省值。
+* @experimental
+*/
+function createConfigDefaultsStore(store, options) {
+	const vault = createSecretVault(options.secrets);
+	return {
+		load: async () => {
+			const stored = await options.readRaw();
+			const lastApplied = await options.snapshot?.read();
+			const { config, snapshot } = applyConfigDefaults({
+				stored: stored ?? void 0,
+				defaults: options.defaults,
+				lastApplied
+			});
+			await options.snapshot?.write(snapshot);
+			return vault.restore(config);
+		},
+		save: async (config) => store.save(await vault.strip(config)),
+		reset: async () => {
+			await store.reset();
+			await options.snapshot?.clear();
+		},
+		...store.subscribe ? { subscribe: (listener) => store.subscribe(listener) } : {}
+	};
+}
+
+//#endregion
+export { BAKED_KEY_SENTINEL, CONFIGURED_RUNTIME_PATHS, CONFIG_FIELDS, CONFIG_TOP_LEVEL_SECTIONS, NON_CONFIGURABLE_RUNTIME_PATHS, WebSkillConfigError, applyConfigDefaults, createConfigDefaultsStore, parseWebSkillConfig };