@aalis/plugin-checkpoint 0.14.0 → 0.16.0

package/dist/config.d.ts

@@ -2,45 +2,47 @@ import { type ConfigOf } from '@aalis/schema-config';
 export declare const configSchema: {
     readonly rootDir: {
         readonly type: "string";
-        readonly label: "存储目录";
+        readonly label: import("@aalis/schema-i18n").TextRef;
         readonly onInvalid: "error";
-        readonly description: "存储 URI（默认 data:/checkpoints）。所有 checkpoint blob 和 manifest 写入此位置。";
+        readonly description: import("@aalis/schema-i18n").TextRef;
         readonly default: "data:/checkpoints";
     };
     readonly maxFileSize: {
         readonly type: "number";
-        readonly label: "单文件大小上限（字节）";
-        readonly description: "超过此大小的文件不做内容快照，只在 manifest 里记录为 skipped。";
+        readonly label: import("@aalis/schema-i18n").TextRef;
+        readonly description: import("@aalis/schema-i18n").TextRef;
         readonly default: number;
     };
     readonly keepSessions: {
         readonly type: "number";
-        readonly label: "保留的会话数";
-        readonly description: "GC 阈值。每次提交回合后，若 session 目录数超过此值，删除最早的几个。设为 0 关闭 GC。";
+        readonly label: import("@aalis/schema-i18n").TextRef;
+        readonly description: import("@aalis/schema-i18n").TextRef;
         readonly default: 20;
     };
-    readonly scopes: {
-        readonly type: "multiselect";
-        readonly label: "启用作用域";
-        readonly description: "仅在匹配下列 platform:sessionType 的会话中参与 turn 生命周期（建 checkpoint）。格式举例：`webui:*` / `onebot:group` / `*` 表示全部。默认仅 `webui:*`：onebot 等聊天平台不会为每条消息创建 checkpoint。留空数组 = 禁用 checkpoint（仅允许手动 rollback）。";
-        readonly allowCustom: true;
+    readonly keepTurns: {
+        readonly type: "number";
+        readonly label: import("@aalis/schema-i18n").TextRef;
+        readonly description: import("@aalis/schema-i18n").TextRef;
+        readonly default: 200;
+    };
+    readonly coverage: {
+        readonly type: "select";
+        readonly label: import("@aalis/schema-i18n").TextRef;
+        readonly description: import("@aalis/schema-i18n").TextRef;
+        readonly default: "ownerOnly";
         readonly options: [{
-            readonly label: "所有会话";
-            readonly value: "*";
-        }, {
-            readonly label: "WebUI 会话（推荐）";
-            readonly value: "webui:*";
-        }, {
-            readonly label: "OneBot 群聊";
-            readonly value: "onebot:group";
+            readonly label: import("@aalis/schema-i18n").TextRef;
+            readonly value: "off";
         }, {
-            readonly label: "OneBot 私聊";
-            readonly value: "onebot:private";
+            readonly label: import("@aalis/schema-i18n").TextRef;
+            readonly value: "ownerOnly";
         }, {
-            readonly label: "CLI";
-            readonly value: "cli:*";
+            readonly label: import("@aalis/schema-i18n").TextRef;
+            readonly value: "all";
         }];
-        readonly default: readonly ["webui:*"];
+        readonly session: {
+            readonly prominence: "advanced";
+        };
     };
 };
 export type CheckpointConfig = ConfigOf<typeof configSchema>;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAEnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCvB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAGnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCvB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/config.js

@@ -1,38 +1,43 @@
 import { defineConfig } from '@aalis/schema-config';
+import { t } from './texts.js';
 export const configSchema = defineConfig({
     rootDir: {
         type: 'string',
-        label: '存储目录',
+        label: t('rootDirLabel'),
         onInvalid: 'error',
-        description: '存储 URI（默认 data:/checkpoints）。所有 checkpoint blob 和 manifest 写入此位置。',
+        description: t('rootDirDescription'),
         default: 'data:/checkpoints',
     },
     maxFileSize: {
         type: 'number',
-        label: '单文件大小上限（字节）',
-        description: '超过此大小的文件不做内容快照，只在 manifest 里记录为 skipped。',
+        label: t('maxFileSizeLabel'),
+        description: t('maxFileSizeDescription'),
         default: 10 * 1024 * 1024,
     },
     keepSessions: {
         type: 'number',
-        label: '保留的会话数',
-        description: 'GC 阈值。每次提交回合后，若 session 目录数超过此值，删除最早的几个。设为 0 关闭 GC。',
+        label: t('keepSessionsLabel'),
+        description: t('keepSessionsDescription'),
         default: 20,
     },
-    scopes: {
-        type: 'multiselect',
-        label: '启用作用域',
-        description: '仅在匹配下列 platform:sessionType 的会话中参与 turn 生命周期（建 checkpoint）。格式举例：`webui:*` / `onebot:group` / `*` 表示全部。默认仅 `webui:*`：onebot 等聊天平台不会为每条消息创建 checkpoint。留空数组 = 禁用 checkpoint（仅允许手动 rollback）。',
-        // 常用选项之外的作用域也合法
-        allowCustom: true,
+    keepTurns: {
+        type: 'number',
+        label: t('keepTurnsLabel'),
+        description: t('keepTurnsDescription'),
+        default: 200,
+    },
+    // 按会话字段：在哪一层读都是字面意思，在某个群的场所层选「记」就是这个群记
+    coverage: {
+        type: 'select',
+        label: t('coverageLabel'),
+        description: t('coverageDescription'),
+        default: 'ownerOnly',
         options: [
-            { label: '所有会话', value: '*' },
-            { label: 'WebUI 会话（推荐）', value: 'webui:*' },
-            { label: 'OneBot 群聊', value: 'onebot:group' },
-            { label: 'OneBot 私聊', value: 'onebot:private' },
-            { label: 'CLI', value: 'cli:*' },
+            { label: t('coverageOff'), value: 'off' },
+            { label: t('coverageOwnerOnly'), value: 'ownerOnly' },
+            { label: t('coverageAll'), value: 'all' },
         ],
-        default: ['webui:*'],
+        session: { prominence: 'advanced' },
     },
 });
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACvC,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,MAAM;QACb,SAAS,EAAE,OAAO;QAClB,WAAW,EAAE,mEAAmE;QAChF,OAAO,EAAE,mBAAmB;KAC7B;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC1B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,qDAAqD;QAClE,OAAO,EAAE,EAAE;KACZ;IACD,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,OAAO;QACd,WAAW,EACT,4LAA4L;QAC9L,gBAAgB;QAChB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;YAC7B,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE;YAC3C,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE;YAC7C,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,EAAE;YAC/C,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;SACjC;QACD,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB;CACF,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACvC,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC;QACxB,SAAS,EAAE,OAAO;QAClB,WAAW,EAAE,CAAC,CAAC,oBAAoB,CAAC;QACpC,OAAO,EAAE,mBAAmB;KAC7B;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC;QAC5B,WAAW,EAAE,CAAC,CAAC,wBAAwB,CAAC;QACxC,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC1B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,CAAC,mBAAmB,CAAC;QAC7B,WAAW,EAAE,CAAC,CAAC,yBAAyB,CAAC;QACzC,OAAO,EAAE,EAAE;KACZ;IACD,SAAS,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC;QAC1B,WAAW,EAAE,CAAC,CAAC,sBAAsB,CAAC;QACtC,OAAO,EAAE,GAAG;KACb;IACD,uCAAuC;IACvC,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC;QACzB,WAAW,EAAE,CAAC,CAAC,qBAAqB,CAAC;QACrC,OAAO,EAAE,WAAW;QACpB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;YACzC,EAAE,KAAK,EAAE,CAAC,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;YACrD,EAAE,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;SAC1C;QACD,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE;KACpC;CACF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { type CheckpointService } from './service.js';
-export declare const checkpoint: import("@aalis/core").ServiceDescriptor<CheckpointService, import("@aalis/core").ServiceRef<CheckpointService>>;
 declare const _default: import("@aalis/core").PluginDefinition<{
     /**
      * storage 是硬依赖：本插件的快照/manifest 全部经 storage 落盘。
@@ -8,11 +6,19 @@ declare const _default: import("@aalis/core").PluginDefinition<{
      * 该保证只在 app.stop() 的整体拓扑逆序成立；单独禁用/热重载 storage 时 flushAll 会落空
      * （回合 blob 在写点已落盘，丢的只是在飞回合的 manifest）。
      */
-    storage: import("@aalis/core").ServiceDescriptor<import("@aalis/api-storage").StorageService, import("@aalis/core").ServiceRef<import("@aalis/api-storage").StorageService>>;
+    storage: import("@aalis/core").ServiceDescriptor<import("@aalis/api-storage").StorageService, import("@aalis/api-storage").BoundStorage>;
     /** 只有「回滚整轮对话」用得到（抓消息时间戳、删消息）；没有 memory 也能做纯文件回滚 */
-    memory: import("@aalis/core").OptionalUse<import("@aalis/api-memory").MemoryService, import("@aalis/core").ServiceRef<import("@aalis/api-memory").MemoryService>>;
-    /** 页面动作的登记口；无 WebUI 时本插件照常在后台记账 */
-    webui: import("@aalis/core").OptionalUse<import("@aalis/api-webui").WebUIService, import("@aalis/api-webui").BoundWebui>;
+    memory: import("@aalis/core").OptionalUse<import("@aalis/api-memory").MemoryService, import("@aalis/api-memory").MemoryService>;
+    /** 登记 /clear 的 checkpoint 类型 */
+    contributions: import("@aalis/core").OptionalUse<import("@aalis/api-contributions").ContributionRegistry, import("@aalis/api-contributions").Contributions>;
+    /** 判会话的受众（房间类别，子会话取根会话的）：coverage 为按受众时用；会话管理缺席时判不出，不记 */
+    sessionManager: import("@aalis/core").OptionalUse<import("@aalis/api-session-manager").SessionManagerService, import("@aalis/api-session-manager").SessionManagerService>;
+    /** 房间类别里谁是 owner；缺席时没有人是 owner */
+    authority: import("@aalis/core").OptionalUse<import("@aalis/api-authority").AuthorityService, import("@aalis/api-authority").AuthorityService>;
+    /** 按会话读 coverage；缺席时取插件配置里的值 */
+    sessionFields: import("@aalis/core").OptionalUse<import("@aalis/api-session-settings").SessionSettingsService, import("@aalis/api-session-settings").SessionFields>;
+    /** 按会话字段的全局层：宿主配置文档里本实例的那一段 */
+    document: import("@aalis/core").OptionalUse<import("@aalis/api-host-config").HostConfig, import("@aalis/api-host-config").OwnHostConfig>;
     events: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Events, import("@aalis/core").Events>;
     hooks: import("@aalis/core").ServiceDescriptor<import("@aalis/api-hooks").HookRegistry, import("@aalis/api-hooks").Hooks>;
     lifecycle: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").LifecycleCap, import("@aalis/core").LifecycleCap>;
@@ -21,5 +27,4 @@ declare const _default: import("@aalis/core").PluginDefinition<{
     provide: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Provide, import("@aalis/core").Provide>;
 }>;
 export default _default;
-export type { CheckpointFileRecord, CheckpointService, RollbackResult, RollbackWithChatResult, TurnManifest, TurnSummary, } from './service.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,iBAAiB,EAA0C,MAAM,cAAc,CAAC;AAO9F,eAAO,MAAM,UAAU,iHAAiD,CAAC;;IAGvE;;;;;;OAMG;;IAEH,mDAAmD;;IAEnD,mCAAmC;;;;;;;;;AAWrC,wBAQG;AAiJH,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,WAAW,GACZ,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";IAsBE;;;;;;OAMG;;IAEH,mDAAmD;;IAEnD,gCAAgC;;IAEhC,0DAA0D;;IAE1D,kCAAkC;;IAElC,gCAAgC;;IAEhC,+BAA+B;;;;;;;;;AAWjC,wBAQG"}

package/dist/index.js

@@ -1,16 +1,21 @@
+import { authority } from '@aalis/api-authority';
+import { checkpoint } from '@aalis/api-checkpoint';
+import { contributions } from '@aalis/api-contributions';
 import { hooks } from '@aalis/api-hooks';
+import { ownHostConfig } from '@aalis/api-host-config';
 import { memory } from '@aalis/api-memory';
-import { createStorageGateway, storage } from '@aalis/api-storage';
-import { webuiServer } from '@aalis/api-webui';
-import { config, definePlugin, defineService, events, lifecycle, logger, optional, provide, } from '@aalis/core';
+import { roomClass, sessionManager } from '@aalis/api-session-manager';
+import { sessionFields } from '@aalis/api-session-settings';
+import { storage } from '@aalis/api-storage';
+import { config, definePlugin, events, lifecycle, logger, optional, provide } from '@aalis/core';
 import { parseConfig } from '@aalis/schema-config';
+import { textOf } from '@aalis/schema-i18n';
 import { configSchema } from './config.js';
 import { CheckpointServiceImpl, normalizeConfig } from './service.js';
+import { t } from './texts.js';
 // ════════════════════════════════════════════════════════════
-// plugin-checkpoint — 文件操作快照与回滚
+// plugin-checkpoint — 文件操作快照与回滚（契约见 @aalis/api-checkpoint）
 // ════════════════════════════════════════════════════════════
-// ----- 服务描述符（按激活绑定；调用型：绑定接口是 ServiceRef）-----
-export const checkpoint = defineService('checkpoint');
 const uses = {
     /**
      * storage 是硬依赖：本插件的快照/manifest 全部经 storage 落盘。
@@ -22,8 +27,16 @@ const uses = {
     storage,
     /** 只有「回滚整轮对话」用得到（抓消息时间戳、删消息）；没有 memory 也能做纯文件回滚 */
     memory: optional(memory),
-    /** 页面动作的登记口；无 WebUI 时本插件照常在后台记账 */
-    webui: optional(webuiServer),
+    /** 登记 /clear 的 checkpoint 类型 */
+    contributions: optional(contributions),
+    /** 判会话的受众（房间类别，子会话取根会话的）：coverage 为按受众时用；会话管理缺席时判不出，不记 */
+    sessionManager: optional(sessionManager),
+    /** 房间类别里谁是 owner；缺席时没有人是 owner */
+    authority: optional(authority),
+    /** 按会话读 coverage；缺席时取插件配置里的值 */
+    sessionFields: optional(sessionFields),
+    /** 按会话字段的全局层：宿主配置文档里本实例的那一段 */
+    document: optional(ownHostConfig),
     events,
     hooks,
     lifecycle,
@@ -33,7 +46,7 @@ const uses = {
 };
 export default definePlugin({
     name: '@aalis/plugin-checkpoint',
-    displayName: '回滚检查点',
+    displayName: t('displayName'),
     subsystem: 'scheduler',
     configSchema,
     provides: [checkpoint],
@@ -41,96 +54,51 @@ export default definePlugin({
     apply: run,
 });
 function run(caps) {
-    const { storage, memory, webui, events, hooks, lifecycle, provide } = caps;
+    const { storage, memory, events, hooks, lifecycle, provide, contributions, sessionManager, authority } = caps;
     /** 服务内部的 commitTurn / gc / flush 都写这个 source，日志页按 `…:checkpoint` 归组 */
-    const logger = caps.logger.child('checkpoint');
-    const cfg = normalizeConfig(parseConfig(configSchema, caps.config, logger));
-    const gateway = createStorageGateway(storage);
+    const logger = caps.logger.use.child('checkpoint');
+    const cfg = normalizeConfig(parseConfig(configSchema, caps.config.use, logger));
+    const gateway = storage.use;
     const service = new CheckpointServiceImpl(cfg, logger, gateway);
-    provide(checkpoint, service);
+    provide.use(checkpoint, service);
     // 注入 chat 回滚所需依赖：memory 引用（每次调用解析当前提供者）+ 事件发出器
     service.setChatRollbackDeps({
         memory,
         emitMessagesDeleted: (sessionId, timestamps) => {
-            events
+            events.use
                 .emit('memory:messages-deleted', { sessionId, timestamps })
                 .catch(err => logger.debug(`emit memory:messages-deleted 失败: ${err.message}`));
         },
         emitHistoryChanged: sessionId => {
-            events
+            events.use
                 .emit('history:changed', { sessionId })
                 .catch(err => logger.debug(`emit history:changed 失败: ${err.message}`));
         },
     });
-    // ──────────── 页面动作（供 WebUI 调用）────────────
-    webui.registerAction('listTurns', async (args) => {
-        const sessionId = args.sessionId ?? '';
-        if (!sessionId)
-            return { error: '缺少 sessionId' };
-        return service.listTurns(sessionId);
-    });
-    webui.registerAction('getManifest', async (args) => service.getManifest(args.sessionId, args.turnId));
-    webui.registerAction('rollback', async (args) => {
-        const sessionId = args.sessionId;
-        const turnId = args.turnId;
-        if (!sessionId || !turnId)
-            return { ok: false, errors: [{ uri: '', reason: '缺少 sessionId 或 turnId' }] };
-        return service.rollback(sessionId, turnId);
-    });
-    webui.registerAction('rollbackWithChat', async (args) => {
-        const sessionId = args.sessionId;
-        const turnId = args.turnId;
-        if (!sessionId || !turnId) {
-            return {
-                ok: false,
-                errors: [{ uri: '', reason: '缺少 sessionId 或 turnId' }],
-                deletedMessages: 0,
-                chatDeleted: false,
-            };
-        }
-        return service.rollbackWithChat(sessionId, turnId);
-    });
     // ──────────── 回合生命周期 ────────────
-    // agent:input:before：一次 LLM 回合开始（一个用户消息进来）
-    // 仅对配置 scopes 匹配的会话参与回合生命周期，避免 onebot 等聊天平台为每条消息都创建空 checkpoint。
-    const isScopeEnabled = (platform, sessionType) => {
-        if (cfg.scopes.length === 0)
-            return false;
-        const p = platform ?? '';
-        const t = sessionType ?? '';
-        for (const raw of cfg.scopes) {
-            const [sp = '*', st = '*'] = raw.includes(':') ? raw.split(':', 2) : [raw, '*'];
-            const platOk = sp === '*' || sp === '' || sp === p;
-            const typeOk = st === '*' || st === '' || st === t;
-            if (platOk && typeOk)
-                return true;
-        }
-        return false;
+    // agent:turn:before 的 next 就是这一轮的全部（后续中间件、输入的归档、模型调用、工具、回合结束钩子），
+    // 用 agent 给的 turnId 把它包进 runTurn：期间的存储改动记进这一轮，next 返回（含被下游拦下、出错）即提交。
+    // 只包 coverage 覆盖的会话：按受众时看根会话的房间类别，不看这一轮从哪个入口进来（入口平台取开轮那条输入的）。
+    const fields = caps.sessionFields.use.fields(configSchema, caps);
+    const lookup = (id) => (sessionManager.present ? sessionManager.use.getSession(id) : undefined);
+    const isOwner = (platform, userId) => authority.present && authority.use.isOwner(platform, userId);
+    const covered = (sessionId, platform) => {
+        const coverage = fields.get(sessionId, { platform }).coverage;
+        return (coverage === 'all' || (coverage === 'ownerOnly' && roomClass(lookup(sessionId), lookup, isOwner) === 'owner-only'));
     };
-    hooks.middleware('agent:input:before', async (data, next) => {
-        if (isScopeEnabled(data.message.platform, data.message.sessionType)) {
-            service.beginTurn(data.message.sessionId);
+    hooks.use.middleware('agent:turn:before', async (data, next) => {
+        if (covered(data.sessionId, data.inputs[0].message.platform)) {
+            await service.runTurn(data.turnId, data.sessionId, next);
         }
-        await next();
-    });
-    // agent:turn:after：回合结束（按 sessionId 提交该会话回合；无对应回合则直接 return）
-    hooks.middleware('agent:turn:after', async (data, next) => {
-        await next();
-        await service.endTurn(data.sessionId);
-    });
-    // 监听命令类工具调用，给该会话当前 turn 打 execUsed 标记（UI 显示 "部分未保护"）：
-    // 这些工具的副作用（子进程改磁盘、装包、起服务）不经 storage，快照覆盖不到。
-    hooks.middleware('agent:tool:before', async (data, next) => {
-        const name = data.name;
-        if (name === 'exec' || name === 'exec_background' || name.startsWith('run_')) {
-            service.markExecUsed(data.toolCallContext.sessionId);
+        else {
+            await next();
         }
-        await next();
     });
     // ──────────── 参与统一的 memory:clear ────────────
     // /clear 与 session-manager.deleteSession 都通过 memory:clear hook 编排，
-    // 不监听的话 checkpoint 目录无人清理，长期泄漏。
-    hooks.middleware('memory:clear', async (data, next) => {
+    // 不监听的话 checkpoint 目录无人清理，长期泄漏。登记 checkpoint 类型，/clear -t 才选得中。
+    contributions.use.contribute('memory:clear-type', { id: 'checkpoint', label: t('clearType') });
+    hooks.use.middleware('memory:clear', async (data, next) => {
         if (data.types && !data.types.includes('checkpoint')) {
             await next();
             return;
@@ -142,7 +110,7 @@ function run(caps) {
                     source: 'checkpoint',
                     type: 'checkpoint',
                     success: true,
-                    message: `所有 checkpoint 已清空（${n} 个 session）`,
+                    message: t('clearedAll', { count: n }),
                 });
             }
             else if (data.sessionId) {
@@ -151,23 +119,22 @@ function run(caps) {
                     source: 'checkpoint',
                     type: 'checkpoint',
                     success: true,
-                    message: n > 0 ? `当前会话 checkpoint 已清空（${n} 个 turn）` : '当前会话无 checkpoint',
+                    message: n > 0 ? t('clearedSession', { count: n }) : t('noneInSession'),
                 });
             }
         }
         catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
             data.results.push({
                 source: 'checkpoint',
                 type: 'checkpoint',
                 success: false,
-                message: `checkpoint 清空失败: ${msg}`,
+                message: t('clearFailed', { error: textOf(err) }),
             });
         }
         await next();
     });
-    // 进程退出前提交所有未结束的活跃回合，避免崩溃/重载时丢失（per-session 化后不再有"任意新回合 flush 旧回合"的兜底）
-    lifecycle.onDispose(() => service.flushAll());
-    logger.info(`checkpoint 服务就绪 rootUri=${cfg.rootUri} maxFileSize=${cfg.maxFileSize} scopes=${cfg.scopes.join('|') || '<空>'}`);
+    // 拆卸时提交所有还在跑的回合，避免崩溃/重载时丢失
+    lifecycle.use.onDispose(() => service.flushAll());
+    logger.info(`checkpoint 服务就绪 rootUri=${cfg.rootUri} maxFileSize=${cfg.maxFileSize}`);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/locales/en.d.ts

@@ -0,0 +1,30 @@
+declare const _default: {
+    readonly displayName: "Rewind checkpoints";
+    readonly rootDirLabel: "Storage directory";
+    readonly rootDirDescription: "Storage URI (data:/checkpoints by default). All checkpoint blobs and manifests are written here.";
+    readonly maxFileSizeLabel: "Per-file size limit (bytes)";
+    readonly maxFileSizeDescription: "Files larger than this get no content snapshot and are only recorded as skipped in the manifest.";
+    readonly keepSessionsLabel: "Sessions to keep";
+    readonly keepSessionsDescription: "GC threshold. After each turn is committed, if there are more session directories than this, the oldest ones are deleted. 0 turns GC off.";
+    readonly keepTurnsLabel: "Turns to keep per session";
+    readonly keepTurnsDescription: "After each turn is committed, once this session has more turns than this, the oldest ones are deleted (with their backups), so only the most recent turns can be rewound; a turn that changed no files and only talked still counts. 0 means no limit.";
+    readonly coverageLabel: "Sessions with checkpoints";
+    readonly coverageDescription: "Which sessions get checkpoints for their turns (rewind relies on them). “By audience” only records in sessions whose audience is just you: WebUI, the terminal and your own IM private chats; group chats and other people's private chats are not recorded, nor is a turn you send into a group from WebUI.";
+    readonly coverageOff: "Off";
+    readonly coverageOwnerOnly: "By audience (when it is just you)";
+    readonly coverageAll: "On";
+    readonly rootDirNotUri: "plugin-checkpoint config error: rootDir is not a storage URI; write it as <root>:/<path>";
+    readonly clearType: "Checkpoints (conversation rewind saves)";
+    readonly clearedAll: "Cleared all checkpoints ({count, plural, one {# session} other {# sessions}})";
+    readonly clearedSession: "Cleared the checkpoints of this session ({count, plural, one {# turn} other {# turns}})";
+    readonly noneInSession: "This session has no checkpoints";
+    readonly clearFailed: "Clearing checkpoints failed: {error}";
+    readonly notSnapshotUnreadable: "Not snapshotted (the original file could not be read; cannot be rewound)";
+    readonly notSnapshotDirectory: "Not snapshotted (a directory, or reading failed)";
+    readonly tooLarge: "File too large ({size} > {max})";
+    readonly noCheckpoint: "The checkpoint does not exist";
+    readonly noDeleteByTimestamps: "The current memory backend does not support deleteMessagesByTimestamps";
+    readonly deleteMessagesFailed: "Deleting messages failed: {error}";
+};
+export default _default;
+//# sourceMappingURL=en.d.ts.map

package/dist/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBAgCG"}

package/dist/locales/en.js

@@ -0,0 +1,30 @@
+import { defineLocale } from '@aalis/schema-i18n';
+export default defineLocale()({
+    displayName: 'Rewind checkpoints',
+    rootDirLabel: 'Storage directory',
+    rootDirDescription: 'Storage URI (data:/checkpoints by default). All checkpoint blobs and manifests are written here.',
+    maxFileSizeLabel: 'Per-file size limit (bytes)',
+    maxFileSizeDescription: 'Files larger than this get no content snapshot and are only recorded as skipped in the manifest.',
+    keepSessionsLabel: 'Sessions to keep',
+    keepSessionsDescription: 'GC threshold. After each turn is committed, if there are more session directories than this, the oldest ones are deleted. 0 turns GC off.',
+    keepTurnsLabel: 'Turns to keep per session',
+    keepTurnsDescription: 'After each turn is committed, once this session has more turns than this, the oldest ones are deleted (with their backups), so only the most recent turns can be rewound; a turn that changed no files and only talked still counts. 0 means no limit.',
+    coverageLabel: 'Sessions with checkpoints',
+    coverageDescription: "Which sessions get checkpoints for their turns (rewind relies on them). “By audience” only records in sessions whose audience is just you: WebUI, the terminal and your own IM private chats; group chats and other people's private chats are not recorded, nor is a turn you send into a group from WebUI.",
+    coverageOff: 'Off',
+    coverageOwnerOnly: 'By audience (when it is just you)',
+    coverageAll: 'On',
+    rootDirNotUri: 'plugin-checkpoint config error: rootDir is not a storage URI; write it as <root>:/<path>',
+    clearType: 'Checkpoints (conversation rewind saves)',
+    clearedAll: 'Cleared all checkpoints ({count, plural, one {# session} other {# sessions}})',
+    clearedSession: 'Cleared the checkpoints of this session ({count, plural, one {# turn} other {# turns}})',
+    noneInSession: 'This session has no checkpoints',
+    clearFailed: 'Clearing checkpoints failed: {error}',
+    notSnapshotUnreadable: 'Not snapshotted (the original file could not be read; cannot be rewound)',
+    notSnapshotDirectory: 'Not snapshotted (a directory, or reading failed)',
+    tooLarge: 'File too large ({size} > {max})',
+    noCheckpoint: 'The checkpoint does not exist',
+    noDeleteByTimestamps: 'The current memory backend does not support deleteMessagesByTimestamps',
+    deleteMessagesFailed: 'Deleting messages failed: {error}',
+});
+//# sourceMappingURL=en.js.map

package/dist/locales/en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.js","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,eAAe,YAAY,EAAU,CAAC;IACpC,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,mBAAmB;IACjC,kBAAkB,EAChB,kGAAkG;IACpG,gBAAgB,EAAE,6BAA6B;IAC/C,sBAAsB,EACpB,kGAAkG;IACpG,iBAAiB,EAAE,kBAAkB;IACrC,uBAAuB,EACrB,2IAA2I;IAC7I,cAAc,EAAE,2BAA2B;IAC3C,oBAAoB,EAClB,wPAAwP;IAC1P,aAAa,EAAE,2BAA2B;IAC1C,mBAAmB,EACjB,8SAA8S;IAChT,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,mCAAmC;IACtD,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,0FAA0F;IACzG,SAAS,EAAE,yCAAyC;IACpD,UAAU,EAAE,+EAA+E;IAC3F,cAAc,EAAE,yFAAyF;IACzG,aAAa,EAAE,iCAAiC;IAChD,WAAW,EAAE,sCAAsC;IACnD,qBAAqB,EAAE,0EAA0E;IACjG,oBAAoB,EAAE,kDAAkD;IACxE,QAAQ,EAAE,iCAAiC;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,oBAAoB,EAAE,wEAAwE;IAC9F,oBAAoB,EAAE,mCAAmC;CAC1D,CAAC,CAAC"}