@aalis/plugin-session-settings 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Nyan <ace@acenyan.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @aalis/plugin-session-settings
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+会话设置：插件配置字段按平台档、平台类型档、场所与会话覆盖的存放、解析与修改，以及 /session 系列指令
+## 角色
+
+运行时插件
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-session-settings
+```
+
+## 文档
+
+详见 [docs/plugins/plugin-session-settings.md](../../docs/plugins/plugin-session-settings.md)。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/caps.d.ts

@@ -0,0 +1,14 @@
+import { type BoundOf } from '@aalis/core';
+export declare const uses: {
+    sessionManager: import("@aalis/core").ServiceDescriptor<import("@aalis/api-session-manager").SessionManagerService, import("@aalis/api-session-manager").SessionManagerService>;
+    events: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Events, import("@aalis/core").Events>;
+    logger: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Logger, import("@aalis/core").Logger>;
+    provide: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Provide, import("@aalis/core").Provide>;
+    services: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Services, import("@aalis/core").Services>;
+    hostConfig: import("@aalis/core").OptionalUse<import("@aalis/api-host-config").HostConfig, import("@aalis/api-host-config").HostConfig>;
+    platform: import("@aalis/core").OptionalUse<import("@aalis/api-platform").PlatformAdapter, import("@aalis/api-platform").PlatformAdapter>;
+    authority: import("@aalis/core").OptionalUse<import("@aalis/api-authority").AuthorityService, import("@aalis/api-authority").AuthorityService>;
+    commands: import("@aalis/core").OptionalUse<import("@aalis/api-commands").CommandService, import("@aalis/api-commands").BoundCommands>;
+};
+export type Caps = BoundOf<typeof uses>;
+//# sourceMappingURL=caps.d.ts.map

package/dist/caps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caps.d.ts","sourceRoot":"","sources":["../src/caps.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,OAAO,EAA+C,MAAM,aAAa,CAAC;AAKxF,eAAO,MAAM,IAAI;;;;;;;;;;CAUhB,CAAC;AACF,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC"}

package/dist/caps.js

@@ -0,0 +1,21 @@
+import { authority } from '@aalis/api-authority';
+import { commands } from '@aalis/api-commands';
+import { hostConfig } from '@aalis/api-host-config';
+import { platform } from '@aalis/api-platform';
+import { sessionManager } from '@aalis/api-session-manager';
+import { events, logger, optional, provide, services } from '@aalis/core';
+// 会话设置插件用到的能力。值在会话管理的记录上，会话管理缺席时停在 pending。宿主配置文档缺席时平台档、平台类型档为空，
+// 写这两层与全局层被拒；services 写声明了 preference 的字段的本插件偏好。平台列可设的平台与类型；权限服务给指令判门槛，缺席时
+// 指令一律拒绝写；指令服务缺席时 /session 系列不在
+export const uses = {
+    sessionManager,
+    events,
+    logger,
+    provide,
+    services,
+    hostConfig: optional(hostConfig),
+    platform: optional(platform),
+    authority: optional(authority),
+    commands: optional(commands),
+};
+//# sourceMappingURL=caps.js.map

package/dist/caps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caps.js","sourceRoot":"","sources":["../src/caps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAgB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAExF,iEAAiE;AACjE,2EAA2E;AAC3E,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC7B,CAAC"}

package/dist/commands.d.ts

@@ -0,0 +1,60 @@
+import type { UserIdentity } from '@aalis/api-authority';
+import { type SessionAt, type SessionLayerName } from '@aalis/api-session-settings';
+import { type TextRef } from '@aalis/schema-i18n';
+import type { Caps } from './caps.js';
+import type { SessionSettingsProvider } from './provider.js';
+/** 发出者的授权身份 */
+type Identity = {
+    platform: string;
+    userId?: string;
+};
+/** 回执 */
+type Receipt = {
+    ok: boolean;
+    text: TextRef;
+};
+export declare class SettingsEditor {
+    private readonly provider;
+    private readonly caps;
+    constructor(provider: SessionSettingsProvider, caps: Caps);
+    private get sm();
+    /** 这个会话里写到 name 这一层的目标；这个会话没有这一层时给出原因 */
+    private target;
+    /** 一层的称呼：平台档、平台类型档与场所另写这个会话取的是哪一份；平台类型写声明的显示名，没声明时写类型名 */
+    private layerText;
+    private placeText;
+    /** 指令里怎么写这一项：同名的写成 <实例 id>/<键> */
+    private nameOf;
+    /** 按项名认项：写成 <实例 id>/<键> 的按全名，只写键的要唯一；重名时给出全部同名的 */
+    private find;
+    /** 项的门槛与层的门槛都过才写：没过时给出原因 */
+    private denied;
+    /** 这个身份在这一层能改的项 */
+    private editable;
+    private editableLine;
+    /** 认项、判门槛；不成时给出回执 */
+    private resolve;
+    /** 写一项，回执写这次改成了什么；落盘失败时另写那一句 */
+    private write;
+    /** 静态可选项另列一行 */
+    private withChoices;
+    /**
+     * 以 identity 的身份在 sessionId 这个会话里把 itemText 写到 layer 这一层（缺省本会话），值是 valueText 的文字读法。
+     * 会话管理还没收录的会话写本会话层之前先建档
+     */
+    set(identity: Identity, sessionId: string, at: SessionAt, layer: SessionLayerName, itemText: string | undefined, valueText: string | undefined): Promise<Receipt>;
+    /** 父会话改子会话设置的工具与 /session.set 写本会话层：同一份 */
+    setAs(identity: UserIdentity, sessionId: string, item: string, text: string): Promise<Receipt>;
+    /**
+     * 恢复继承：给了项只清那一项；不给项时清掉这一层里身份能改的全部项，只用于本会话与场所，平台类型档以上必须写明清哪一项
+     */
+    reset(identity: Identity, sessionId: string, at: SessionAt, layer: SessionLayerName, itemText: string | undefined): Promise<Receipt>;
+    /** /session：只列身份在本会话层能改的项（owner 看到全部），每项写生效值与来源 */
+    list(identity: Identity, sessionId: string, at: SessionAt): TextRef;
+    /** 来源的称呼：作者默认写「默认」，其余同层的称呼 */
+    private sourceText;
+}
+/** 登记 /session 系列（指令服务缺席时登记留着，它上线后生效） */
+export declare function registerCommands(caps: Caps, editor: SettingsEditor): void;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,gBAAgB,EAGtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAA+B,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAO1F,eAAe;AACf,KAAK,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAUtD,SAAS;AACT,KAAK,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAO9C,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,IAAI;IAG7B,OAAO,KAAK,EAAE,GAEb;IAED,yCAAyC;IACzC,OAAO,CAAC,MAAM;IA0Bd,0DAA0D;IAC1D,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,SAAS;IAKjB,kCAAkC;IAClC,OAAO,CAAC,MAAM;IAId,mDAAmD;IACnD,OAAO,CAAC,IAAI;IAQZ,4BAA4B;IAC5B,OAAO,CAAC,MAAM;IAmBd,mBAAmB;IACnB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,YAAY;IAOpB,qBAAqB;IACrB,OAAO,CAAC,OAAO;IAUf,gCAAgC;YAClB,KAAK;IAoBnB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACG,GAAG,CACP,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,OAAO,CAAC;IAuBnB,2CAA2C;IAC3C,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9F;;OAEG;IACG,KAAK,CACT,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GAAG,SAAS;IAmC9B,mDAAmD;IACnD,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO;IAyBnE,8BAA8B;IAC9B,OAAO,CAAC,UAAU;CAGnB;AAMD,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA2DzE"}

package/dist/commands.js

@@ -0,0 +1,308 @@
+// ════════════════════════════════════════════════════════════
+// 在聊天里看与改设置：/session、/session.set、/session.reset，以及父会话改子会话设置的 setAs（就是 /session.set 写本会话层的
+// 那一段）。
+//
+// 门槛取「项的门槛」与「写在哪一层的门槛」两者中较高的。项的门槛是能力 setting:<实例 id>/<键>，默认按声明的 minLevel（没写即只有
+// owner），交给权限服务的 authorize 裁决，owner 在「操作门槛」里改过的按改过的；层的门槛固定、经 meetsLevel 裁决：本会话不另设，
+// 群与私聊的场所 2 级，工作区场所与平台类型档、平台档、全局只有 owner。所有会话一律判；权限服务不在时一律拒绝。
+// 项与值的写入校验都在提供者的 update 里，这里不做 narrowest 之类的预检，update 拒收时把原因写进回执。
+// ════════════════════════════════════════════════════════════
+import { saveFailureText } from '@aalis/api-host-config';
+import { sessionTypeLabel } from '@aalis/api-platform';
+import { placeLabel, sessionLabel } from '@aalis/api-session-manager';
+import { isSessionSettingsError, layerLabel, SESSION_LAYERS, } from '@aalis/api-session-settings';
+import { readFieldValue } from '@aalis/schema-config';
+import { textLines, textOf } from '@aalis/schema-i18n';
+import { fixedChoices, readText, writeText } from './text-values.js';
+import { itemName, t } from './texts.js';
+/** --at 收的层：层表从窄到宽 */
+const AT_LAYERS = [...SESSION_LAYERS].reverse().map(layer => layer.name);
+const refuse = (text) => ({
+    ok: false,
+    text: typeof text === 'string' ? textLines([text]) : text,
+});
+export class SettingsEditor {
+    provider;
+    caps;
+    constructor(provider, caps) {
+        this.provider = provider;
+        this.caps = caps;
+    }
+    get sm() {
+        return this.caps.sessionManager.use;
+    }
+    /** 这个会话里写到 name 这一层的目标；这个会话没有这一层时给出原因 */
+    target(sessionId, at, name) {
+        const ctx = this.provider.contextOf(sessionId, at);
+        const { platform, type, place } = ctx;
+        const owners = Number.POSITIVE_INFINITY;
+        const make = (to, minLevel) => ({
+            to,
+            label: this.layerText(name, ctx),
+            minLevel,
+            accepts: this.provider.acceptsAt(name, ctx),
+        });
+        switch (name) {
+            case 'session':
+                return make({ sessionId }, 0);
+            case 'place':
+                if (!place)
+                    return t('notFiled');
+                return make({ layer: { scope: 'place', key: place.key } }, place.kind === 'window' ? 2 : owners);
+            case 'platformType':
+                if (type === undefined || platform === undefined)
+                    return t('noPlatformType');
+                return make({ layer: { scope: 'platformType', platform, type } }, owners);
+            case 'platform':
+                return make({ layer: { scope: 'platform', platform: platform ?? '' } }, owners);
+            case 'global':
+                return make({ layer: { scope: 'global' } }, owners);
+        }
+    }
+    /** 一层的称呼：平台档、平台类型档与场所另写这个会话取的是哪一份；平台类型写声明的显示名，没声明时写类型名 */
+    layerText(name, { platform = '', type = '', place }) {
+        switch (name) {
+            case 'platform':
+                return t('namedLayer', { layer: layerLabel(name), name: platform });
+            case 'platformType':
+                return t('platformTypeLayer', {
+                    layer: layerLabel(name),
+                    platform,
+                    type: sessionTypeLabel(this.caps.platform, platform, type) ?? type,
+                });
+            case 'place':
+                return place ? this.placeText(place.key) : layerLabel(name);
+            default:
+                return layerLabel(name);
+        }
+    }
+    placeText(key) {
+        const record = this.sm.getPlace(key);
+        return t('placeLayer', { layer: layerLabel('place'), name: record ? placeLabel(record) : key });
+    }
+    /** 指令里怎么写这一项：同名的写成 <实例 id>/<键> */
+    nameOf({ plugin, key }) {
+        return this.provider.items().filter(other => other.key === key).length > 1 ? `${plugin}/${key}` : key;
+    }
+    /** 按项名认项：写成 <实例 id>/<键> 的按全名，只写键的要唯一；重名时给出全部同名的 */
+    find(text) {
+        const items = this.provider.items();
+        const exact = items.find(item => `${item.plugin}/${item.key}` === text);
+        if (exact)
+            return exact;
+        const named = items.filter(item => item.key === text);
+        return named.length === 1 ? named[0] : named.length > 1 ? named : undefined;
+    }
+    /** 项的门槛与层的门槛都过才写：没过时给出原因 */
+    denied(identity, item, target) {
+        const authority = this.caps.authority.use;
+        const itemDenied = authority.authorize(identity, {
+            capability: `setting:${item.plugin}/${item.key}`,
+            visibility: 'restricted',
+            minLevel: item.field.session.minLevel ?? Number.POSITIVE_INFINITY,
+        });
+        if (itemDenied)
+            return itemDenied;
+        // 项的门槛已挡掉封禁的身份，层的门槛为 0 时这里恒过
+        if (authority.meetsLevel(identity, target.minLevel))
+            return null;
+        return target.minLevel === Number.POSITIVE_INFINITY
+            ? t('layerOwnerOnly', { layer: target.label })
+            : t('layerLevel', { layer: target.label, level: target.minLevel });
+    }
+    /** 这个身份在这一层能改的项 */
+    editable(identity, target) {
+        return this.provider.items().filter(item => target.accepts(item.field) && !this.denied(identity, item, target));
+    }
+    editableLine(identity, target) {
+        const items = this.editable(identity, target).map(item => this.nameOf(item));
+        return items.length > 0
+            ? t('editable', { layer: target.label, items })
+            : t('noneEditable', { layer: target.label });
+    }
+    /** 认项、判门槛；不成时给出回执 */
+    resolve(identity, target, text) {
+        const found = this.find(text);
+        if (Array.isArray(found)) {
+            return refuse(t('ambiguous', { item: text, items: found.map(item => `${item.plugin}/${item.key}`) }));
+        }
+        if (!found)
+            return refuse(textLines([t('noSuchItem', { item: text }), this.editableLine(identity, target)]));
+        const denied = this.denied(identity, found, target);
+        return denied ? refuse(denied) : found;
+    }
+    /** 写一项，回执写这次改成了什么；落盘失败时另写那一句 */
+    async write(identity, target, item, value) {
+        let saveError;
+        try {
+            ({ saveError } = await this.provider.update(target.to, { plugin: item.plugin, key: item.key, value }));
+        }
+        catch (err) {
+            if (!isSessionSettingsError(err))
+                throw err;
+            return refuse(textLines([textOf(err), this.editableLine(identity, target)]));
+        }
+        const name = this.nameOf(item);
+        const done = value === null
+            ? t('resetDone', {
+                layer: target.label,
+                items: [name],
+                global: 'layer' in target.to && target.to.layer.scope === 'global' ? 'yes' : 'no',
+            })
+            : t('setDone', { layer: target.label, item: name, value: writeText(item.field, value) });
+        return { ok: true, text: saveError === undefined ? done : textLines([done, saveFailureText(saveError, 'reload')]) };
+    }
+    /** 静态可选项另列一行 */
+    withChoices(text, field) {
+        const choices = fixedChoices(field);
+        return choices ? textLines([text, t('choices', { choices })]) : text;
+    }
+    /**
+     * 以 identity 的身份在 sessionId 这个会话里把 itemText 写到 layer 这一层（缺省本会话），值是 valueText 的文字读法。
+     * 会话管理还没收录的会话写本会话层之前先建档
+     */
+    async set(identity, sessionId, at, layer, itemText, valueText) {
+        if (!this.caps.authority.present)
+            return refuse(t('authorityAbsent'));
+        if (layer === 'session' && !this.sm.getSession(sessionId))
+            await this.sm.ensureSession(sessionId);
+        const target = this.target(sessionId, at, layer);
+        if (!('to' in target))
+            return refuse(target);
+        if (itemText === undefined)
+            return refuse(textLines([t('needItem'), this.editableLine(identity, target)]));
+        const item = this.resolve(identity, target, itemText);
+        if ('ok' in item)
+            return item;
+        const name = this.nameOf(item);
+        // 空串是写出来的空值（聊天里的 `""`），照文字读法读
+        if (valueText === undefined)
+            return refuse(this.withChoices(t('needValue', { item: name }), item.field));
+        const parsed = readText(item.field, valueText);
+        const read = 'invalid' in parsed ? parsed : readFieldValue(item.field, parsed.value);
+        if ('invalid' in read)
+            return refuse(this.withChoices(t('invalidValue', { item: itemName(item.field.label, name), reason: read.invalid }), item.field));
+        return this.write(identity, target, item, read.value ?? null);
+    }
+    /** 父会话改子会话设置的工具与 /session.set 写本会话层：同一份 */
+    setAs(identity, sessionId, item, text) {
+        return this.set(identity, sessionId, {}, 'session', item, text);
+    }
+    /**
+     * 恢复继承：给了项只清那一项；不给项时清掉这一层里身份能改的全部项，只用于本会话与场所，平台类型档以上必须写明清哪一项
+     */
+    async reset(identity, sessionId, at, layer, itemText) {
+        if (!this.caps.authority.present)
+            return refuse(t('authorityAbsent'));
+        const target = this.target(sessionId, at, layer);
+        if (!('to' in target))
+            return refuse(target);
+        if (itemText !== undefined) {
+            const item = this.resolve(identity, target, itemText);
+            return 'ok' in item ? item : this.write(identity, target, item, null);
+        }
+        const set = this.provider
+            .rows(target.to)
+            .filter(row => row.value !== undefined)
+            .map(row => ({ plugin: row.plugin, key: row.key }));
+        if (layer !== 'session' && layer !== 'place') {
+            const items = set.map(item => this.nameOf(item));
+            return refuse(textLines([
+                t('resetNeedsItem', { layer: target.label }),
+                ...(items.length > 0 ? [t('setHere', { items })] : []),
+            ]));
+        }
+        const clearable = this.editable(identity, target).filter(item => set.some(own => own.plugin === item.plugin && own.key === item.key));
+        if (clearable.length === 0)
+            return refuse(t('nothingToReset', { layer: target.label }));
+        for (const item of clearable) {
+            await this.provider.update(target.to, { plugin: item.plugin, key: item.key, value: null });
+        }
+        return {
+            ok: true,
+            text: t('resetDone', { layer: target.label, items: clearable.map(item => this.nameOf(item)), global: 'no' }),
+        };
+    }
+    /** /session：只列身份在本会话层能改的项（owner 看到全部），每项写生效值与来源 */
+    list(identity, sessionId, at) {
+        if (!this.caps.authority.present)
+            return t('authorityAbsent');
+        const target = this.target(sessionId, at, 'session');
+        const ctx = this.provider.contextOf(sessionId, at);
+        const editable = this.editable(identity, target);
+        const lines = [];
+        const session = this.sm.getSession(sessionId);
+        lines.push(t('sessionHeader', { session: session ? sessionLabel(session) : sessionId }));
+        for (const row of this.provider.rows({ sessionId, at })) {
+            const item = editable.find(e => e.plugin === row.plugin && e.key === row.key);
+            if (!item)
+                continue;
+            const params = { label: item.field.label, item: this.nameOf(item) };
+            if (row.effective === undefined) {
+                const unset = item.field.session.unset ?? t('unsetValue');
+                const now = row.actual && (row.actual.label ?? writeText(item.field, row.actual.value));
+                lines.push(t('rowUnset', { ...params, value: now ? t('unsetNow', { unset, now }) : unset }));
+            }
+            else {
+                const value = writeText(item.field, row.effective);
+                lines.push(t('row', { ...params, value, source: this.sourceText(row.source, ctx) }));
+            }
+        }
+        if (!this.caps.authority.use.isOwner(identity.platform, identity.userId))
+            lines.push(t('onlyYours'));
+        return textLines(lines);
+    }
+    /** 来源的称呼：作者默认写「默认」，其余同层的称呼 */
+    sourceText(source, ctx) {
+        return source === undefined || source === 'default' ? t('sourceDefault') : this.layerText(source, ctx);
+    }
+}
+/** 指令的发出者 */
+const identityOf = (argv) => ({ platform: argv.session.platform, userId: argv.session.userId });
+const layerOf = (argv) => argv.options.at ?? 'session';
+/** 登记 /session 系列（指令服务缺席时登记留着，它上线后生效） */
+export function registerCommands(caps, editor) {
+    const commands = caps.commands.use;
+    const at = (argv) => ({ platform: argv.session.platform });
+    commands
+        .command('session', t('sessionDescription'), { risk: 'sensitive' })
+        .action(argv => editor.list(identityOf(argv), argv.session.sessionId, at(argv)));
+    commands
+        .command('session.set [item:string] [value:text]', t('setDescription'), {
+        risk: 'sensitive',
+        examples: [
+            '/session.set persona <name>',
+            '/session.set --at place llm <instance>/<model>',
+            '/session.set -n <name>',
+        ],
+    })
+        .option('at', '--at <layer:string>', { description: t('atDescription'), choices: AT_LAYERS })
+        .option('name', '-n <name:string>', { description: t('nameDescription') })
+        .argument('item', t('itemArgument'))
+        .argument('value', t('valueArgument'))
+        .action(async (argv, item, value) => {
+        const lines = [];
+        const name = typeof argv.options.name === 'string' ? argv.options.name.trim() : '';
+        if (name) {
+            await caps.sessionManager.use.ensureSession(argv.session.sessionId, { name });
+            lines.push(t('renamed', { name }));
+        }
+        if (item !== undefined || !name) {
+            const receipt = await editor.set(identityOf(argv), argv.session.sessionId, at(argv), layerOf(argv), item === undefined ? undefined : String(item), value === undefined ? undefined : String(value));
+            lines.push(receipt.text);
+        }
+        return textLines(lines);
+    });
+    commands
+        .command('session.reset [item:string]', t('resetDescription'), {
+        risk: 'sensitive',
+        examples: ['/session.reset', '/session.reset persona', '/session.reset --at platformType persona'],
+    })
+        .option('at', '--at <layer:string>', { description: t('atDescription'), choices: AT_LAYERS })
+        .argument('item', t('itemArgument'))
+        .action(async (argv, item) => {
+        const receipt = await editor.reset(identityOf(argv), argv.session.sessionId, at(argv), layerOf(argv), item === undefined ? undefined : String(item));
+        return receipt.text;
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/doc.d.ts

@@ -0,0 +1,32 @@
+/** 一个实例在一处写的值 */
+export type Values = Record<string, unknown>;
+/** 实例 id → 值 */
+type Instances = Map<string, Values>;
+/** 文档里的两层，形状已核过 */
+export interface DocLayers {
+    platforms: Map<string, Instances>;
+    /** 平台 → 类型名 → 各实例的值 */
+    platformTypes: Map<string, Map<string, Instances>>;
+}
+/** 层标识里的平台名与类型名：与窗口键 `平台:类型:目标` 的段同一套写法（非空、不含 `:`、不是 `*`），还要能当配置文档里的对象键 */
+export declare function isLayerName(name: unknown): name is string;
+export declare const isRecord: (value: unknown) => value is Values;
+/** 读文档时的两个依据：这个实例 id 认不认识（已登记或配置文档里有它的配置段），与告警（调用方去重） */
+interface ReadContext {
+    known(instance: string): boolean;
+    warn(message: string): void;
+}
+/** 读出文档里的两层（交出的是复制品之上的整理结果） */
+export declare function readDoc(doc: unknown, ctx: ReadContext): DocLayers;
+/**
+ * 在原样的 sessionConfig 上只改一处（path 是 sessionConfig 之下到实例的各段）的这一项：stored 为 null 即删掉，删空了的对象沿路径
+ * 逐级删掉（sessionConfig 自己留着）；别的部分（含读不懂的）原样留着。要写的路径上已有的值不是对象时不改，返回那一段的路径；删的
+ * 时候路径不在就什么都不改
+ */
+export declare function putDocValue(doc: unknown, path: readonly string[], key: string, stored: unknown): {
+    doc: unknown;
+} | {
+    notObject: string;
+};
+export {};
+//# sourceMappingURL=doc.d.ts.map

package/dist/doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../src/doc.ts"],"names":[],"mappings":"AASA,iBAAiB;AACjB,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,gBAAgB;AAChB,KAAK,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErC,mBAAmB;AACnB,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,uBAAuB;IACvB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACpD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEzD;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACmB,CAAC;AAIvE,yDAAyD;AACzD,UAAU,WAAW;IACnB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAiCD,+BAA+B;AAC/B,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,CAuBjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAoB1C"}

package/dist/doc.js

@@ -0,0 +1,103 @@
+// ════════════════════════════════════════════════════════════
+// 宿主配置文档里的两层：sessionConfig 的平台档（platforms）与平台类型档（platformTypes），每处按插件实例 id 放这个实例的值。
+// 读的时候核形状：不认识的段、名字不合层标识写法的条目、不是对象的实例值告警后忽略；既没登记、配置文档的 plugins 里也没有的
+// 实例 id 告警一次，值留着不生效。值本身在解析时按字段校验。写的时候在原样的文档上只改这一处的这一项，读不懂的部分原样留着。
+// 留空的段（配置文件里只剩键名，读出来是 null）读写都与没有这一段同样处理。
+// ════════════════════════════════════════════════════════════
+import { isUnsafeConfigKey } from '@aalis/schema-config';
+/** 层标识里的平台名与类型名：与窗口键 `平台:类型:目标` 的段同一套写法（非空、不含 `:`、不是 `*`），还要能当配置文档里的对象键 */
+export function isLayerName(name) {
+    return typeof name === 'string' && name !== '' && name !== '*' && !name.includes(':') && !isUnsafeConfigKey(name);
+}
+export const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const SECTIONS = new Set(['platforms', 'platformTypes']);
+/** 名字 → 对象的一张表：名字不合写法、值不是对象的告警后忽略 */
+function table(value, path, ctx) {
+    const out = new Map();
+    if (value == null)
+        return out;
+    if (!isRecord(value)) {
+        ctx.warn(`宿主配置 ${path} 不是对象，已忽略`);
+        return out;
+    }
+    for (const [name, entry] of Object.entries(value)) {
+        if (!isLayerName(name))
+            ctx.warn(`宿主配置 ${path} 里的「${name}」不合法（非空、不含 :、不是 *），已忽略`);
+        else if (isRecord(entry))
+            out.set(name, entry);
+        else if (entry != null)
+            ctx.warn(`宿主配置 ${path}.${name} 不是对象，已忽略`);
+    }
+    return out;
+}
+/** 一处各实例的值：实例值不是对象的告警后忽略，不认识的实例告警一次、照样留着 */
+function instances(value, path, ctx) {
+    const out = new Map();
+    for (const [instance, values] of Object.entries(value)) {
+        if (isUnsafeConfigKey(instance) || values == null)
+            continue;
+        if (!isRecord(values)) {
+            ctx.warn(`宿主配置 ${path}.${instance} 不是对象，已忽略`);
+            continue;
+        }
+        if (!ctx.known(instance))
+            ctx.warn(`宿主配置 ${path} 里的 ${instance} 不是已装的插件实例，这一段不生效`);
+        out.set(instance, values);
+    }
+    return out;
+}
+/** 读出文档里的两层（交出的是复制品之上的整理结果） */
+export function readDoc(doc, ctx) {
+    const layers = { platforms: new Map(), platformTypes: new Map() };
+    if (doc == null)
+        return layers;
+    if (!isRecord(doc)) {
+        ctx.warn('宿主配置 sessionConfig 不是对象，已忽略');
+        return layers;
+    }
+    for (const key of Object.keys(doc)) {
+        if (!SECTIONS.has(key)) {
+            ctx.warn(`宿主配置 sessionConfig.${key} 不认识（只有 platforms、platformTypes），已忽略`);
+        }
+    }
+    for (const [name, value] of table(doc.platforms, 'sessionConfig.platforms', ctx)) {
+        layers.platforms.set(name, instances(value, `sessionConfig.platforms.${name}`, ctx));
+    }
+    for (const [platform, byType] of table(doc.platformTypes, 'sessionConfig.platformTypes', ctx)) {
+        const path = `sessionConfig.platformTypes.${platform}`;
+        layers.platformTypes.set(platform, new Map([...table(byType, path, ctx)].map(([type, value]) => [type, instances(value, `${path}.${type}`, ctx)])));
+    }
+    return layers;
+}
+/**
+ * 在原样的 sessionConfig 上只改一处（path 是 sessionConfig 之下到实例的各段）的这一项：stored 为 null 即删掉，删空了的对象沿路径
+ * 逐级删掉（sessionConfig 自己留着）；别的部分（含读不懂的）原样留着。要写的路径上已有的值不是对象时不改，返回那一段的路径；删的
+ * 时候路径不在就什么都不改
+ */
+export function putDocValue(doc, path, key, stored) {
+    const segments = ['sessionConfig', ...path];
+    const holder = { sessionConfig: doc };
+    const nodes = [holder];
+    for (const [i, name] of segments.entries()) {
+        const node = nodes[i];
+        const next = Object.hasOwn(node, name) ? node[name] : undefined;
+        if (next == null) {
+            if (stored === null)
+                return { doc };
+            node[name] = {};
+        }
+        else if (!isRecord(next)) {
+            return stored === null ? { doc } : { notObject: segments.slice(0, i + 1).join('.') };
+        }
+        nodes.push(node[name]);
+    }
+    const target = nodes[segments.length];
+    if (stored === null)
+        delete target[key];
+    else
+        target[key] = stored;
+    for (let i = segments.length; i > 1 && Object.keys(nodes[i]).length === 0; i--)
+        delete nodes[i - 1][segments[i - 1]];
+    return { doc: holder.sessionConfig };
+}
+//# sourceMappingURL=doc.js.map