@aalis/schema-config 0.15.0 → 0.16.0

package/README.md

@@ -1,10 +1,10 @@
 # @aalis/schema-config
 
-配置表单 Schema 词汇契约包：`ConfigSchema` / `SchemaField` / `SchemaGroup` / `SchemaArray` 及 `SchemaFieldTypes` 扩展点；声明与读取插件配置的 `defineConfig` / `ConfigOf` / `parseConfig`；对这套词汇的中立解释函数 `defaultsFrom` / `deepMergeDefaults` / `validateConfig` / `removeExtraFields`，密钥引用的类型与工具 `SecretRef` / `isSecretRef` / `mapSecretFields` / `SecretPosition`，配置危险键闸与拷贝 `isUnsafeConfigKey` / `cloneConfigObject`，以及插件因配置问题无法激活时在 `apply` 里抛出的 `configError` / `missingConfigError`（后者用于缺必填项；name 为 `ConfigError`、不带 stack，激活失败日志只有一行，不像程序崩溃）。
+配置表单 Schema 词汇契约包：`ConfigSchema` / `SchemaField` / `SchemaGroup` / `SchemaArray` 及 `SchemaFieldTypes` 扩展点；声明与读取插件配置的 `defineConfig` / `ConfigOf` / `parseConfig`；可按会话覆盖的字段 `SessionFieldSpec` / `SessionFieldsOf` / `isSessionField`，经 JSON 下发的 `WireSchemaField` / `WireConfigSchema`；对这套词汇的中立解释函数 `defaultsFrom` / `deepMergeDefaults` / `validateConfig` / `readFieldValue` / `removeExtraFields`，密钥引用的类型与工具 `SecretRef` / `isSecretRef` / `mapSecretFields` / `SecretPosition`，配置危险键闸与拷贝 `isUnsafeConfigKey` / `cloneConfigObject`，以及插件因配置问题无法激活时在 `apply` 里抛出的 `configError` / `missingConfigError`（后者用于缺必填项；name 为 `ConfigError`、不带 stack，激活失败日志只有一行，不像程序崩溃）。
 
 `@aalis/core` 把插件的 `configSchema` 当作 opaque 数据透传、不解释任何字段；表单词汇（label / options / textarea …）属呈现层，统一住在本包。同一份 schema 既是表单描述，又是插件配置值类型的来源（`ConfigOf`）和运行时解析规则（`parseConfig`）；渲染宿主（WebUI）与宿主政策（runtime 的配置同步）也用它消费 schema。
 
-零运行时依赖：对 `@aalis/core` 只有 type-only 锚点（以 peer 依赖声明）。字段类型可由其他 api 包经 declaration merging 扩展（如 `api-llm` 注入 `'llm-ref'`）。
+运行时只依赖同样零依赖的 `@aalis/schema-i18n`（给人看的文字是它的文字对象）；对 `@aalis/core` 只有 type-only 锚点（以 peer 依赖声明）。字段类型可由其他 api 包经 declaration merging 扩展（如 `api-llm` 注入 `'llm-ref'`）。
 
 ## 声明与读取
 
@@ -38,9 +38,16 @@ export default definePlugin({
 ```
 
 - **`defineConfig(schema)`**：运行时原样返回传入的对象（不冻结、不加任何属性，WebUI 读的就是这个活对象），类型层保留字面量，返回值可直接放进 `definePlugin({ configSchema })`。不要给变量标 `ConfigSchema` 类型注解，注解会把字面量拓宽掉，`ConfigOf` 只能推出宽类型。推出的类型里各属性只读、`options` 是字面量元组；需要在运行时改写 schema（如按已注册的服务补全选项）时，经 `ConfigSchema` 或 `SchemaField` 类型的引用改写。
-- **`ConfigOf<S>`**：从 schema 推导配置值类型。字段取 `SchemaFieldTypes` 里登记的取值类型（见下表）；select / multiselect 有静态 `options`、没有 `dynamicOptions` 且 `allowCustom` 不为 `true` 时收窄为选项值的字面量联合，数字选项对应数字字面量。有 `default` 或 `required: true` 的字段必定存在，其余为可选；分组推为嵌套对象，总是存在；数组推为元素类型的数组，元素按同一规则推导。
+- **`ConfigOf<S>`**：从 schema 推导配置值类型。字段取 `SchemaFieldTypes` 里登记的取值类型（见下表）；select / multiselect 有静态 `options`、没有 `dynamicOptions` 且 `allowCustom` 不为 `true` 时收窄为选项值的字面量联合，数字选项对应数字字面量。有 `default` 或 `required: true` 的字段必定存在，其余为可选；分组推为嵌套对象，总是存在；数组推为元素类型的数组，元素按同一规则推导。带 `session` 的顶层字段不在其中（见下文「可按会话覆盖的字段」）。
 - **`parseConfig(schema, raw, logger?)`**：按 schema 解析插件拿到的配置，返回 `ConfigOf` 类型的新对象，不改入参。之后的夹紧、跨字段约束等核对作用于返回值。
 
+## 给人看的文字
+
+- 字段、分组与数组的 `label`、`description` 和选项的 `label` 可以写字符串，也可以写 `@aalis/schema-i18n` 的文字对象（插件自己原文字典里的 `t('…')`），渲染宿主按读者语言渲染。`default` 是取值，不是文字。
+- `validateConfig` 的每条问题带 `code`（`missing`、`type`、`not-option`、`pattern`、`format`、`integer`、`min`、`max`、`reserved-key`、`validate`）与原因的文字对象 `text`；`message` 是它的原文，日志用。
+- `configError(message)` 收字符串或文字对象，收文字对象时挂上它（name 仍是 `ConfigError`），WebUI 按读者语言显示失败原因；`missingConfigError` 的说法本身是文字对象，`note` 同样可以是文字对象。
+- 本包自己的字典（ns `@aalis/schema-config`）收核心配置表单（`CORE_CONFIG_SCHEMA`）、校验原因与配置错误的说法。
+
 ## 字段类型
 
 本包内置的中立类型。「判定」一列是 `validateConfig` 与 `parseConfig` 共用的逐字段规则：
@@ -51,7 +58,7 @@ export default definePlugin({
 | `number` | `number` | 有限数值；去掉首尾空白后非空、能完整解析为有限数的字符串按数字收；`min` / `max` / `integer` |
 | `boolean` | `boolean` | 类型，不做转换 |
 | `select` | 选项值的字面量联合，否则 `string` | 字符串或有限数字；有静态 `options`、没有 `dynamicOptions` 且 `allowCustom` 不为 `true` 时须是某个选项值 |
-| `multiselect` | 选项值字面量联合的数组，否则 `string[]` | 数组；元素同 `select`；集合语义，WebUI 以勾选框编辑，不能表达重复项 |
+| `multiselect` | 选项值字面量联合的数组，否则 `string[]` | 数组；元素同 `select`；按输入顺序保留。`ordered: true` 时先后有意义（如语言的先后）：去掉重复项（按选项归位后的值比，不算问题），WebUI 给排序控件 |
 | `list` | `string[]` | 数组，元素按字符串判定；有序，允许重复（如命令行参数） |
 | `map` | `Record<string, string>` | 对象，每个值按字符串判定（如环境变量表） |
 
@@ -59,11 +66,26 @@ export default definePlugin({
 - **`format`**：写宿主文件路径的 `string` / `textarea` 字段声明。`'absolute-path'` 只收绝对路径（`/…`、`C:\…` 或 `\\…`）；`'executable'` 另收不含路径分隔符的命令名（按 PATH 查找），`C:foo` 这类带盘符的相对写法不算。判定忽略首尾空白，交给插件的值也去掉首尾空白；空串与只有空白都表示未填、不查（`required` 字段算缺失）；只按写法判定、与宿主平台无关，Windows 形状的绝对路径在 POSIX 宿主上同样通过。配置里的相对路径没有可靠的基准（宿主进程的 cwd 不带语义），所以不收。
 - **选项即取值范围**：选项按字符串比较，`parseConfig` 取选项声明的原值（WebUI 把数字选项存成字符串，读出时归位成数字）。
 - **`dynamicOptions` / `allowCustom`**：两者影响取值判定，由本包声明。`dynamicOptions` 是动态选项来源的服务名（WebUI 经 webui-server 调该服务的 `listModels()` 或等价方法获取选项），声明后静态 `options` 不再是取值范围，只查取值是字符串或数字；`allowCustom` 表示接受选项之外的值，不查是否在选项内：WebUI 给 multiselect 提供手动输入；select 用它表示静态选项不全（例如由插件在运行时补全选项的字段）。
-- **扩展字段类型**：api 包经 declaration merging 往 `SchemaFieldTypes` 登记类型名与取值类型（如 `'llm-ref': ModelRef`），`ConfigOf` 据此推导。本包不校验外来类型的取值：`validateConfig` 跳过，`parseConfig` 除把 `''` 当作未配置外原样透传。
+- **扩展字段类型**：api 包经 declaration merging 往 `SchemaFieldTypes` 登记类型名与取值类型（如 `'llm-ref': ModelRef`），`ConfigOf` 据此推导。本包不按类型校验外来类型的取值，只调字段自己的 `validate`（见下文）：`validateConfig` 放行，`parseConfig` 除把 `''` 当作未配置外原样透传。
+
+## 字段自己的校验与文字读写（`validate` / `fromText` / `toText`）
+
+- **`validate(value)`**：合法返回 `undefined`，不合法返回原因（非空字符串或文字对象）；抛错或返回别的值都按不合法，原因写「校验时出错」，不转述抛出的错。在类型与约束都过了之后调，拿换算后的取值（外来类型是原值）。`validateConfig` 报 `invalid`（`code` 为 `validate`），`parseConfig` 按无效处置（见下文），`readFieldValue` 给出原因。list、map、multiselect 有坏元素时，`validateConfig` 与 `readFieldValue` 只报元素、不调它，`parseConfig` 先丢坏元素、再拿剩下的值调它。外来类型的字段要核取值就写它。原因会原样进 `parseConfig` 的告警与拒绝激活的消息，不要在里面写取值（字段可能是密钥）。
+- **`fromText(text)` / `toText(value)`**：文字与取值互换；内置类型不用写。
+- 三者是进程内函数，schema 经 JSON 下发时没有；线上类型是 `WireSchemaField` / `WireConfigSchema`。
+
+## 可按会话覆盖的字段（`session`）
+
+顶层字段写了 `session`（声明 `SessionFieldSpec`，成员由 `@aalis/api-session-settings` 并入）即可按会话覆盖：插件经会话设置的读取器按会话读它，改了不重载插件。`isSessionField(entry)` 判一个顶层条目是不是这种字段（分组、数组上写了不算，分组与数组元素里的字段不按它判）。
+
+- **`parseConfig`** 不交出这类字段、不补 `default`，配置里有这个键也不告警；`ConfigOf` 同样不含。
+- **`SessionFieldsOf<S>`**：这类字段经读取器读到的值。取值类型同 `ConfigOf`，`onInvalid: 'error'` 的为 `unknown`（坏值原样交出，由插件核）；有 `default` 的必定存在，没有的为可选。
+- **`validateConfig`、`defaultsFrom`、`removeExtraFields`** 照常把它当 schema 字段：它的全局层就是配置文档里的值，作者默认照常写进文档。
+- **`readFieldValue(field, value)`**：单个值的判定，与 `validateConfig` 同一套：合法给 `{ value }`（换算后的取值；没配置的给 `undefined`），不合法给 `{ invalid }`（集合里有坏元素也算）。不回落 `default`、不抛错、不拷贝。判的是取值，不是文档写法：密钥字段上的引用 `validateConfig` 放行，这里判为不合法。
 
 ## 密钥字段（`secret`）
 
-`secret: true` 表示字段的值是凭据（API key、token、可能带账号密码的连接串），由本包声明，各宿主都按它处理：值不放在配置文档里，存进宿主的密钥存储（Node 宿主 `@aalis/runtime` 用家目录的 `secrets.yaml`），文档里只写引用 `{ $secret: '<键>' }`（类型 `SecretRef`），宿主把配置交给插件之前解析回原值，展示与回传都不给原值。标在 `map`、`list` 等非标量字段上时整个值算一个密钥。名字像凭据却不是凭据的字段（如 `maxTokens`）写 `secret: false` 表明已判断过。本包只声明词汇，不读写密钥存储。
+`secret: true` 表示字段的值是凭据（API key、token、可能带账号密码的连接串），由本包声明，各宿主都按它处理：值不放在配置文档里，存进宿主的密钥存储（Node 宿主 `@aalis/runtime` 用家目录的 `secrets.yaml`），文档里只写引用 `{ $secret: '<键>' }`（类型 `SecretRef`），宿主把配置交给插件之前解析回原值，展示与回传都不给原值。标在 `map`、`list` 等非标量字段上时整个值算一个密钥。本包只声明词汇，不读写密钥存储。
 
 - **`isSecretRef(value)`**：是不是引用，即只有 `$secret` 一个自有键、值为非空字符串的纯对象。只在 `secret: true` 的字段上有这层含义。
 - **`mapSecretFields(schema, config, fn)`**：逐个处理配置里密钥字段上的值（顶层、分组内、数组元素内；值为 `undefined` 的跳过），`fn` 收到值与位置 `SecretPosition`（`path` 是点号路径，数组元素里的不带下标；`inArray` 表示在数组元素里），`fn` 返回 `undefined` 时删掉这个键。不改入参：有改动时返回浅拷贝（没动到的部分与入参共享），没有改动时返回入参本身，调用方要改写结果请先复制。宿主拆出、解析密钥与给呈现方去掉密钥都用它。
@@ -74,8 +96,8 @@ export default definePlugin({
 ## parseConfig 的处置
 
 - **缺失**：`undefined` 与 `null`（YAML 裸键）；`required` 字段另把 `''` 当作缺失（WebUI 与脚手架用 `''` 表示未填；声明了 `format` 的只有空白也算），外来类型的 `''` 一律当作缺失（WebUI 给未选的 `llm-ref` 存 `''`）。有 `default` 用 `default` 的拷贝；无 `default` 且 `required` 不可恢复；否则省略该键。
-- **无效**（不符合上表的判定）：未声明 `onInvalid` 时保持宽容处置：有 `default` 回落并告警；无 `default` 且 `required` 不可恢复；否则省略并告警。字段声明 `onInvalid: 'error'` 时，显式无效值即使有 `default` 也抛 `ConfigError`；它不改变 `required` 的缺省含义，`undefined` / `null` 仍走上述缺省规则。
-- **list / map / multiselect**：默认坏元素、坏值逐个丢弃并告警，其余保留；稀疏数组的空位和 map 的保留键也属于坏成员。严格字段只要含一个坏成员就拒绝整个值，不返回部分结果。
+- **无效**（不符合上表的判定，或字段的 `validate` 判为不合法）：未声明 `onInvalid` 时保持宽容处置：有 `default` 回落并告警；无 `default` 且 `required` 不可恢复；否则省略并告警。字段声明 `onInvalid: 'error'` 时，显式无效值即使有 `default` 也抛 `ConfigError`；它不改变 `required` 的缺省含义，`undefined` / `null` 仍走上述缺省规则。
+- **list / map / multiselect**：默认坏元素、坏值逐个丢弃并告警，其余保留，剩下的值再过字段的 `validate`；稀疏数组的空位和 map 的保留键也属于坏成员。严格字段只要含一个坏成员就拒绝整个值，不返回部分结果。
 - **分组**：值不是对象时默认告警，整组按空对象解析，子字段各取默认值。显式给非对象且分组含严格字段时拒绝；`undefined` / `null` 仍视为缺省。
 - **数组**：值不是数组按无效处理，含严格元素字段时显式无效的数组值会被拒绝；元素不是对象、或元素内有不可恢复的字段时只丢这一条元素并告警，邻居元素照常解析；元素字段的默认值逐元素补齐（runtime 的配置同步不补数组元素的默认值）。
 - **整体配置**：显式非对象且 schema 含严格字段时拒绝；`undefined` / `null` 仍视为缺省。严格错误说明字段路径与安全的类型或约束原因；集合的下标可定位，map 的键可能含密钥，因此错误只定位到 map 字段，不写用户值或键。

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { type TextRef } from '@aalis/schema-i18n';
 /**
  * Schema 字段类型注册表 —— declaration merging 扩展点。
  *
@@ -13,7 +14,8 @@
  * }
  * ```
  *
- * 外来类型的取值不经本包校验：parseConfig 除把 `''` 当作未配置外原样透传，value 只是类型层的声明。
+ * 外来类型的取值不经本包按类型校验，只过字段自己的 validate：parseConfig 除把 `''` 当作未配置外原样透传，
+ * value 只是类型层的声明。
  */
 export interface SchemaFieldTypes {
     string: string;
@@ -21,25 +23,33 @@ export interface SchemaFieldTypes {
     boolean: boolean;
     /** 有静态 options、没有 dynamicOptions 且 allowCustom 不为 true 时，ConfigOf 收窄为选项值的字面量联合 */
     select: string;
-    /** 有静态 options、没有 dynamicOptions 且 allowCustom 不为 true 时，ConfigOf 收窄为选项值字面量联合的数组 */
+    /**
+     * 选中的若干项，按输入顺序保留；声明了 ordered 的先后有意义且不重复。有静态 options、没有 dynamicOptions 且
+     * allowCustom 不为 true 时，ConfigOf 收窄为选项值字面量联合的数组
+     */
     multiselect: string[];
     textarea: string;
-    /** 有序字符串列表：保序、允许重复；与 multiselect 的集合语义不同 */
+    /** 有序字符串列表：保序、允许重复，不限可选项 */
     list: string[];
     /** 字符串映射，如环境变量表 */
     map: Record<string, string>;
 }
 export type SchemaFieldType = keyof SchemaFieldTypes & string;
+/** 可按会话覆盖的声明（{@link SchemaField.session}）：扩展点，成员由 @aalis/api-session-settings 经 declaration merging 并入 */
+export interface SessionFieldSpec {
+}
 /**
  * 单个配置字段。
  *
  * 声明各渲染宿主共需的字段、影响取值判定的属性（`dynamicOptions` / `allowCustom`）与各宿主都按它处理的
  * `secret`；只影响单一宿主呈现的交互属性由消费它们的宿主 api 包通过 declaration merging 注入。
+ * 给人看的 label、description 与选项的 label 可以是字符串或文字对象（@aalis/schema-i18n），渲染宿主按读者语言渲染；
+ * default 是取值，不是文字。
  */
 export interface SchemaField {
     type: SchemaFieldType;
-    label: string;
-    description?: string;
+    label: string | TextRef;
+    description?: string | TextRef;
     default?: unknown;
     required?: boolean;
     /** 显式配置的值无效时拒绝激活；缺省仍按 default / required 处理，省略时保持宽容回落 */
@@ -49,7 +59,7 @@ export interface SchemaField {
      * 值按字符串与选项值比较，parseConfig 取选项声明的原值（数字选项存成字符串也能归位）
      */
     options?: Array<{
-        label: string;
+        label: string | TextRef;
         value: string | number;
     }>;
     /**
@@ -62,6 +72,11 @@ export interface SchemaField {
      * WebUI 只给 multiselect 提供手动输入；select 用它表示静态选项不全（例如由插件在运行时补全选项的字段）
      */
     allowCustom?: boolean;
+    /**
+     * multiselect：选中项的先后有意义（如语言的先后），呈现方据此给排序控件。为 true 时 validateConfig 与 parseConfig
+     * 去掉重复项（按选项归位后的值比），重复不算问题
+     */
+    ordered?: boolean;
     /** number：数值下限（含），validateConfig 与 parseConfig 强制。无 default 的 number 表单不预填（留空=走服务端默认），带 min 仍建议声明 default 以免长期处于缺失告警 */
     min?: number;
     /** number：数值上限（含），validateConfig 与 parseConfig 强制 */
@@ -86,9 +101,24 @@ export interface SchemaField {
      * （Node 宿主是家目录的 `secrets.yaml`），文档里只写引用 {@link SecretRef}，交给插件之前解析回原值；
      * 展示与回传都不给原值。标在 map、list 上时整个值算一个密钥。插件照常经 parseConfig 读到原值；
      * 引用没被宿主解析（键不在密钥存储里）时 parseConfig 拒绝激活，不回落默认值。
-     * 名字像凭据却不是凭据的字段（如 `maxTokens`）写 `false` 表明已判断过
+     * `false` 与不写在运行时相同；仓内第一方的声明守卫要名字像凭据的字段写 `false` 表明判断过
      */
     secret?: boolean;
+    /**
+     * 可按会话覆盖：宿主不交给插件的运行态配置，插件经会话设置的读取器读；改了不重载插件。只写在顶层字段上，
+     * 判定见 {@link isSessionField}
+     */
+    session?: SessionFieldSpec;
+    /**
+     * 取值校验（进程内函数，经 JSON 下发时没有）。合法返回 undefined，不合法返回原因（非空字符串或文字对象）；抛错或返回
+     * 别的值都按不合法，原因写「校验时出错」。在类型与约束键之后调，拿到的是换算后的取值（外来类型是原值）；validateConfig、
+     * parseConfig 与 readFieldValue 都调它。原因会原样进告警与拒绝激活的消息，不要在里面写取值（字段可能是密钥）
+     */
+    validate?(value: unknown): string | TextRef | undefined;
+    /** 文字读成取值；内置类型不用写 */
+    fromText?(text: string): unknown;
+    /** 取值写成文字；内置类型不用写 */
+    toText?(value: unknown): string;
 }
 /**
  * 配置文档里密钥字段的值：指向宿主密钥存储里的一个键。几个字段可以指向同一个键。
@@ -113,15 +143,15 @@ export interface SecretPosition {
  */
 export declare function mapSecretFields(schema: ConfigSchema | undefined, config: Record<string, unknown>, fn: (value: unknown, at: SecretPosition) => unknown): Record<string, unknown>;
 export interface SchemaGroup {
-    label?: string;
-    description?: string;
+    label?: string | TextRef;
+    description?: string | TextRef;
     fields: Record<string, SchemaField>;
 }
 /** 数组 Schema：对象数组，每个元素用 items 描述其字段结构 */
 export interface SchemaArray {
     type: 'array';
-    label: string;
-    description?: string;
+    label: string | TextRef;
+    description?: string | TextRef;
     /** 数组每个元素的字段定义 */
     items: Record<string, SchemaField>;
     default?: unknown[];
@@ -130,6 +160,21 @@ export interface SchemaArray {
 }
 /** 配置 Schema：顶层 key 可以是字段、分组或数组 */
 export type ConfigSchema = Record<string, SchemaField | SchemaGroup | SchemaArray>;
+/** 经 JSON 下发的字段：去掉函数成员，session 原样保留 */
+export type WireSchemaField = Omit<SchemaField, 'validate' | 'fromText' | 'toText'>;
+/** 经 JSON 下发的 schema：同 {@link ConfigSchema}，分组与数组元素里的字段也换成 {@link WireSchemaField} */
+export type WireConfigSchema = Record<string, WireSchemaField | (Omit<SchemaGroup, 'fields'> & {
+    fields: Record<string, WireSchemaField>;
+}) | (Omit<SchemaArray, 'items'> & {
+    items: Record<string, WireSchemaField>;
+})>;
+/**
+ * 顶层条目是不是可按会话覆盖的字段：是字段（不是分组、数组）且 session 不为 undefined。只对 configSchema 的顶层条目问，
+ * 分组与数组元素里的字段不按它判
+ */
+export declare function isSessionField(entry: unknown): entry is SchemaField & {
+    session: SessionFieldSpec;
+};
 /**
  * 声明插件的配置 schema：运行时原样返回传入的对象（不冻结、不加任何属性），类型层保留字面量，
  * 供 {@link ConfigOf} 推出配置值类型。返回值可直接放进 `definePlugin({ configSchema })`。
@@ -143,17 +188,24 @@ export declare function defineConfig<const S extends ConfigSchema>(schema: S): S
 type Flatten<T> = {
     [K in keyof T]: T[K];
 } & {};
+/** 条目声明了 K（不是 undefined） */
+type Declares<E, K extends string> = E extends {
+    [P in K]: infer D;
+} ? ([D] extends [undefined] ? false : true) : false;
 /** parseConfig 成功后必定存在的条目：分组、required 字段、声明了 default 的字段与数组 */
 type IsPresent<E> = E extends {
     fields: unknown;
 } ? true : E extends {
     required: true;
-} ? true : E extends {
-    default: infer D;
-} ? [D] extends [undefined] ? false : true : false;
-type HasDynamicOptions<E> = E extends {
-    dynamicOptions: infer D;
-} ? ([D] extends [undefined] ? false : true) : false;
+} ? true : Declares<E, 'default'>;
+/** 带 session 的顶层字段的键（{@link isSessionField} 的类型层）：分组、数组上写了不算，写成 undefined 不算 */
+type SessionKeys<S> = {
+    [K in keyof S]: S[K] extends {
+        fields: unknown;
+    } | {
+        type: 'array';
+    } ? never : Declares<S[K], 'session'> extends true ? K : never;
+}[keyof S];
 /** allowCustom 不是字面量 false 时按可能允许算：宽类型总是安全的 */
 type AllowsCustom<E> = E extends {
     allowCustom: infer A;
@@ -164,7 +216,7 @@ type StaticOptionValue<E> = E extends {
     }>;
 } ? V : never;
 /** 有非空静态 options 且没有动态来源时收窄为选项值的字面量联合，否则取宽类型 */
-type ChoiceValue<E> = HasDynamicOptions<E> extends true ? string : [StaticOptionValue<E>] extends [never] ? string : StaticOptionValue<E>;
+type ChoiceValue<E> = Declares<E, 'dynamicOptions'> extends true ? string : [StaticOptionValue<E>] extends [never] ? string : StaticOptionValue<E>;
 type FieldValue<E> = E extends {
     type: 'select';
 } ? AllowsCustom<E> extends true ? string : ChoiceValue<E> : E extends {
@@ -174,21 +226,39 @@ type FieldValue<E> = E extends {
 } ? SchemaFieldTypes[T] : unknown;
 type EntryValue<E> = E extends {
     fields: infer F extends ConfigSchema;
-} ? ConfigOf<F> : E extends {
+} ? EntriesOf<F> : E extends {
     type: 'array';
     items: infer I extends ConfigSchema;
-} ? ConfigOf<I>[] : FieldValue<E>;
+} ? EntriesOf<I>[] : FieldValue<E>;
+/** 各条目解析出的值：分组与数组元素也用它，带 session 的字段只在顶层由 ConfigOf 排除 */
+type EntriesOf<S> = Flatten<{
+    -readonly [K in keyof S as IsPresent<S[K]> extends true ? K : never]: EntryValue<S[K]>;
+} & {
+    -readonly [K in keyof S as IsPresent<S[K]> extends true ? never : K]?: EntryValue<S[K]>;
+}>;
 /**
  * 从 schema 推导 {@link parseConfig} 返回的配置值类型（schema 须经 {@link defineConfig} 声明才保留字面量）。
  *
  * - 字段取 {@link SchemaFieldTypes} 里登记的取值类型；select / multiselect 见该注册表的说明
  * - 有 default 或 `required: true` 的字段必定存在，其余为可选（parseConfig 省略未配置的键）
  * - 分组推为嵌套对象，总是存在；数组推为元素类型的数组，元素按同一规则推导
+ * - 带 session 的顶层字段不在其中（parseConfig 不交出），见 {@link SessionFieldsOf}
  */
-export type ConfigOf<S extends ConfigSchema> = Flatten<{
-    -readonly [K in keyof S as IsPresent<S[K]> extends true ? K : never]: EntryValue<S[K]>;
+export type ConfigOf<S extends ConfigSchema> = EntriesOf<Omit<S, SessionKeys<S>>>;
+/** 带 session 的字段经会话设置读到的值：严格字段的坏值原样交出、不往下回落，所以是 unknown */
+type SessionValue<E> = E extends {
+    onInvalid: 'error';
+} ? unknown : FieldValue<E>;
+/**
+ * 从 schema 推导带 session 的顶层字段经会话设置的读取器读到的值（ConfigOf 不含的那部分）。
+ *
+ * - 取值类型同 ConfigOf；`onInvalid: 'error'` 的为 unknown，由插件自己核
+ * - 有 default 的必定存在，没有的为可选（哪层都没设时没有值）
+ */
+export type SessionFieldsOf<S extends ConfigSchema> = Flatten<{
+    [K in SessionKeys<S> as Declares<S[K], 'default'> extends true ? K : never]: SessionValue<S[K]>;
 } & {
-    -readonly [K in keyof S as IsPresent<S[K]> extends true ? never : K]?: EntryValue<S[K]>;
+    [K in SessionKeys<S> as Declares<S[K], 'default'> extends true ? never : K]?: SessionValue<S[K]>;
 }>;
 /**
  * core 基础设施配置（name / logLevel / slowThresholdMs）的表单描述。
@@ -197,6 +267,11 @@ export type ConfigOf<S extends ConfigSchema> = Flatten<{
  * 渲染宿主（webui-server 设置页）从这里取。
  */
 export declare const CORE_CONFIG_SCHEMA: ConfigSchema;
+/**
+ * 宿主配置里只在启动时读、改了要重启才生效的核心键：runtime 启动时读它们交给 core，WebUI 设置页据此标「重启后生效」。
+ * runtime 改了哪些键只在启动时读，同步改这一份。name 只是显示用的应用名称，保存即生效
+ */
+export declare const CORE_RESTART_KEYS: readonly string[];
 /**
  * 从 ConfigSchema 派生默认配置（密钥字段除外）。
  *
@@ -218,28 +293,45 @@ export declare function defaultsFrom(schema: ConfigSchema | undefined): Record<s
  * 宿主的配置同步与 WebUI 保存插件配置用同一个合并，两条路径写出的配置形状一致。
  */
 export declare function deepMergeDefaults(defaults: Record<string, unknown>, current: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 校验问题的原因种类：
+ * - `missing`：必填却没配；
+ * - `type`：类型或形状不符（如期望字符串却是对象、期望数组却是字符串）；
+ * - `not-option`：不是可选值；`pattern`：不匹配正则；`format`：路径的写法不符；
+ * - `integer`、`min`、`max`：数值约束；`reserved-key`：映射里用了保留键；
+ * - `validate`：字段自己的 validate 判为不合法（含它抛错）。
+ */
+export type SchemaIssueCode = 'missing' | 'type' | 'not-option' | 'pattern' | 'format' | 'integer' | 'min' | 'max' | 'reserved-key' | 'validate';
 /**
  * validateConfig 发现的单条问题。path 以点号/下标定位（如 `server.port`、`hosts[2]`）。
  * kind 区分两类性质不同的问题，供调用方分级处置：
  * - `missing`：必填字段未配置——"没配全"，半成品配置的正常中间态；
  * - `invalid`：值与声明的类型/形状不符——"配错了"，任何时候都不该写入。
+ *
+ * 原因：code 给程序判断，text 是本包字典的文字对象（出口按读者语言渲染），message 是它的原文（日志用）。
  */
 export interface SchemaIssue {
     path: string;
     message: string;
     kind: 'missing' | 'invalid';
+    code: SchemaIssueCode;
+    text: TextRef;
 }
-/** 字段类型是不是本包内置的：内置类型的取值经 validateConfig 与 parseConfig 校验，外来类型（如 'llm-ref'）的不经 */
+/**
+ * 字段类型是不是本包内置的：内置类型的取值经 validateConfig 与 parseConfig 按类型校验，外来类型（如 'llm-ref'）的
+ * 只过字段的 validate
+ */
 export declare function isBuiltinFieldType(type: string): boolean;
 /**
  * 按 ConfigSchema 对配置做只读结构校验，返回问题清单（空数组 = 无问题）。
  *
  * 定位与边界：
  * - **只读**：不转换、不回填、不裁剪——回填是 defaultsFrom，裁剪是 removeExtraFields，取值是 parseConfig。
- *   逐字段判定与 parseConfig 共用同一份：这里报 invalid 的值，parseConfig 会回落、忽略或拒绝。
+ *   逐字段判定与 parseConfig 共用同一份：这里报 invalid 的值，parseConfig 会回落、忽略或拒绝（带 session 的顶层字段除外，
+ *   parseConfig 不交出它）。
  *   校验器出错的最大代价必须始终是"少一条警告"，因此它对畸形 schema 不抛错。
- * - **只解释本包的词汇**：type/required、约束键、影响取值的 dynamicOptions/allowCustom 与 secret；
- *   宿主经 declaration merging 注入的呈现属性一概不解读。
+ * - **只解释本包的词汇**：type/required、约束键、影响取值的 dynamicOptions/allowCustom、secret 与字段自己的 validate；
+ *   宿主经 declaration merging 注入的呈现属性一概不解读。带 session 的字段照常校验（它的全局层就在配置文档里）。
  * - **校验的是文档**：`secret` 字段上的 {@link SecretRef} 算合法（值在宿主的密钥存储里），不查引用的键在不在。
  * - **标量宽容**：期望字符串的位置（string/textarea、list 元素、map 值、选项比较）接受有限数字；
  *   期望数字的位置接受去掉首尾空白后能完整解析为有限数的字符串。boolean 不做转换。
@@ -248,6 +340,8 @@ export declare function isBuiltinFieldType(type: string): boolean;
  * - **约束键**：number 强制 min/max（含边界）与 integer，string/textarea 强制
  *   pattern（模式非法则跳过该检查）与 format（空串与只有空白不查）；step 是纯 UI 提示不校验。约束只在类型
  *   检查通过后评估——类型都不对时报类型错，不叠报约束错。
+ * - **validate**：类型与约束键都过了才调，拿换算后的取值；返回原因报 invalid（code 为 `validate`），抛错同样报，不外传。
+ *   list、map、multiselect 有坏元素时只报元素、不调它：它拿到的会是剔掉坏元素的值，报的原因对不上文档里写的。
  * - **list / map**：list 须为数组、map 须为对象，逐元素 / 逐值报错，路径形如 `args[1]`、`env.KEY`。
  * - **宽容缺失**：undefined 与 null（YAML 裸键）视为"未配置"，required 字段的 `''` 也算未配置（WebUI 与脚手架
  *   用 `''` 表示未填，与 parseConfig 一致；声明了 format 的只有空白也算；空数组仍算已配置），仅在 required 且未声明 default 时报缺——顶层/分组的默认值在调用点已合并，数组元素的默认值
@@ -263,10 +357,12 @@ export declare function validateConfig(schema: ConfigSchema | undefined, config:
  *
  * - **缺失**：undefined 与 null；required 字段另把 `''` 当作缺失（WebUI 与脚手架用 `''` 表示未填；声明了 format 的
  *   只有空白也算），外来类型的 `''` 一律当作缺失。有 default 用 default（拷贝），无 default 且 required 不可恢复，否则省略该键。
- * - **无效**：逐字段判定与 validateConfig 共用（标量宽容、选项即取值范围、约束键）。
+ * - **无效**：逐字段判定与 validateConfig 共用（标量宽容、选项即取值范围、约束键、字段的 validate）。
+ *   list、map、multiselect 先丢坏元素，validate 判的是剩下的值。
  *   默认有 default 回落并告警；无 default 且 required 不可恢复；否则省略并告警。
  *   `onInvalid: 'error'` 的字段遇到显式无效值或坏集合成员时，即使有 default 也不可恢复。
- * - **外来类型**：除 `''` 外原样透传，不校验。
+ * - **外来类型**：除 `''` 外原样透传，只过字段的 validate。
+ * - **带 session 的顶层字段**：不交出、不补 default，配置里有这个键也不告警（插件经会话设置的读取器读）。
  * - **密钥字段**：宿主交给插件之前已把引用解析成原值；`secret` 字段上仍是 {@link SecretRef}，说明引用的键不在
  *   宿主的密钥存储里，一律不可恢复（不回落 default，数组元素里的也不只丢这一条），消息点名键名。owner 写了引用，
  *   引用落空就是配置错误，回落默认值会悄悄连上别的东西（例如默认的本机数据库）。
@@ -277,11 +373,22 @@ export declare function validateConfig(schema: ConfigSchema | undefined, config:
  * - **schema 外的键**：丢弃并告警。
  * - **不可恢复**（顶层或分组内）：缺失抛 {@link missingConfigError}，无效抛 {@link configError}，插件随之进 error 态。
  *
- * 告警只写路径、类型名与约束，不写原值（可能是密钥）；默认值可以写。
+ * 告警只写路径、类型名与约束，不写原值（可能是密钥）；默认值可以写。字段 validate 返回的原因原样写进去。
  */
 export declare function parseConfig<S extends ConfigSchema>(schema: S, raw: unknown, logger?: {
     warn(message: string): void;
 }): ConfigOf<S>;
+/**
+ * 单个字段对一个值的判定，与 validateConfig 同一套（类型、约束键、字段的 validate）：合法给出换算后的取值，没配置的
+ * （undefined、null，外来类型与 required 字段的空串）给 `{ value: undefined }`；不合法给出原因，list、map、multiselect
+ * 里有元素不合法也算（取第一个）。不回落 default、不抛错，不拷贝（外来类型的值原样交出）。判的是取值本身：密钥字段上的
+ * 引用不像 validateConfig 那样按文档的写法放行
+ */
+export declare function readFieldValue(field: SchemaField, value: unknown): {
+    value: unknown;
+} | {
+    invalid: TextRef;
+};
 /**
  * 按 schema 键集裁掉未知字段。configSchema 是插件配置的**唯一声明来源**（默认值也从它派生），
  * 所以它的键集就是完整的白名单：不在 schema 里的字段，要么是用户手写的错别字，
@@ -296,13 +403,14 @@ export declare function removeExtraFields(config: Record<string, unknown>, schem
  *
  * 实例照常转入 error 态，但这不是程序出错：core 的 DefaultLogger 对没有 stack 的错误只写「名称: 消息」，
  * 激活失败日志因此只有一行，不像程序崩溃。缺必填项用 {@link missingConfigError}。
+ * 收文字对象时挂上它（schema-i18n 的 withText，name 不变），出口按读者语言显示，message 是它的原文。
  */
-export declare function configError(message: string): Error;
+export declare function configError(message: string | TextRef): Error;
 /**
  * 缺少必填配置时的 {@link configError}：消息点名缺的字段（`note` 是放在字段名后括号里的补充说明），并说明
  * 填入后生效——WebUI 保存或配置文件热重载会重建实例、重试激活。
  */
-export declare function missingConfigError(field: string, note?: string): Error;
+export declare function missingConfigError(field: string, note?: string | TextRef): Error;
 /** 配置层无合法含义、落到原型链的键（`__proto__` / `constructor` / `prototype`）；宿主的配置文档按它拦 */
 export declare function isUnsafeConfigKey(key: string): boolean;
 export declare function cloneConfigObject(obj: Record<string, unknown>): Record<string, unknown>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}