@webskill/chatbot 0.15.0 → 0.17.0

package/README.md

@@ -115,7 +115,7 @@ implementation (OPFS storage, skills, demo/model providers, console embedding).
 default `FsSessionStore` decides what you see:
 
 - Sessions are sorted by `createdAt` **ascending**, and a page is taken from the
-  **tail** of that list. The first screen therefore holds the *newest* sessions,
+  **tail** of that list. The first screen therefore holds the _newest_ sessions,
   and the oldest session is not on it.
 - The page size is the store's (`FS_SESSION_PAGE_SIZE`, 50). `<Chatbot>` does
   not override it — pass your own `sessionStore` if you need another size.

package/dist/chatbot.css

@@ -1391,6 +1391,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,);
   }

package/dist/config.d.ts

@@ -0,0 +1,104 @@
+import { n as RuntimeConfig, r as RuntimeConfigStore } from "./index-B25ux241.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-Cc8nFxir.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: []` 是「用户把模型删光了」，
+ * 与「从没配过」（键缺席）必须分得开，否则删掉的条目会自己长回来。
+ */
+/** 三方合并的输入 @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,144 @@
+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-79VbXLl4.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;
+}
+/**
+* `lastApplied` 缺席时每条分支都退化成「stored 存在就取 stored」，
+* 即老实现的 `deepMerge(defaults, stored)`——修订跟随是纯增量，不改既有语义。
+* @experimental
+*/
+function applyConfigDefaults(input) {
+	const { stored, defaults, lastApplied } = input;
+	return {
+		config: mergeRuntimeConfigDefaults(stored === void 0 ? defaults : mergeLeaf(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 };