@aalis/plugin-checkpoint 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @aalis/plugin-checkpoint
+
+运行时插件
+
+## 角色
+
+运行时插件
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-checkpoint
+```
+
+## 使用
+
+参考 [docs/architecture.md](../../docs/architecture.md) 与 [docs/guide/third-party-plugin.md](../../docs/guide/third-party-plugin.md)。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import type { ConfigSchema, Context, PluginModule } from '@aalis/core';
+import '@aalis/plugin-agent-api';
+export declare const name = "@aalis/plugin-checkpoint";
+export declare const displayName = "\u56DE\u6EDA\u68C0\u67E5\u70B9";
+export declare const subsystem = "scheduler";
+export declare const provides: string[];
+export declare const configSchema: ConfigSchema;
+export declare const defaultConfig: {
+    rootDir: string;
+    maxFileSize: number;
+    keepSessions: number;
+    scopes: string[];
+};
+export declare const actions: PluginModule['actions'];
+export declare function apply(ctx: Context, rawConfig: Record<string, unknown>): Promise<void>;
+export type { CheckpointFileRecord, CheckpointService, RollbackResult, RollbackWithChatResult, TurnManifest, TurnSummary, } from './service.js';
+declare module '@aalis/core' {
+    interface ServiceTypeMap {
+        checkpoint: import('./service.js').CheckpointService;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,yBAAyB,CAAC;AAQjC,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,WAAW,mCAAU,CAAC;AACnC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,QAAQ,UAAiB,CAAC;AAEvC,eAAO,MAAM,YAAY,EAAE,YAkC1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;CAKzB,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,YAAY,CAAC,SAAS,CA2C3C,CAAC;AAIF,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgI3F;AAED,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAU,cAAc;QACtB,UAAU,EAAE,OAAO,cAAc,EAAE,iBAAiB,CAAC;KACtD;CACF"}

package/dist/index.js

@@ -0,0 +1,210 @@
+import { createStorageGateway } from '@aalis/plugin-storage-api';
+import '@aalis/plugin-agent-api'; // 加载 agent:* 钩子的 HookContextMap augmentation
+import { CheckpointServiceImpl, resolveConfig } from './service.js';
+// ════════════════════════════════════════════════════════════
+// plugin-checkpoint — 文件操作快照与回滚
+// ════════════════════════════════════════════════════════════
+export const name = '@aalis/plugin-checkpoint';
+export const displayName = '回滚检查点';
+export const subsystem = 'scheduler';
+export const provides = ['checkpoint'];
+export const configSchema = {
+    rootDir: {
+        type: 'string',
+        label: '存储目录',
+        description: '存储 URI（默认 data:/checkpoints），也兼容裸名/相对路径。所有 checkpoint blob 和 manifest 写入此位置。',
+        default: 'data:/checkpoints',
+    },
+    maxFileSize: {
+        type: 'number',
+        label: '单文件大小上限（字节）',
+        description: '超过此大小的文件不做内容快照，只在 manifest 里记录为 skipped。',
+        default: 10 * 1024 * 1024,
+    },
+    keepSessions: {
+        type: 'number',
+        label: '保留的会话数',
+        description: 'GC 阈值。每次提交回合后，若 session 目录数超过此值，删除最早的几个。设为 0 关闭 GC。',
+        default: 20,
+    },
+    scopes: {
+        type: 'multiselect',
+        label: '启用作用域',
+        description: '仅在匹配下列 platform:sessionType 的会话中参与 turn 生命周期（建 checkpoint）。格式举例：`webui:*` / `onebot:group` / `*` 表示全部。默认仅 `webui:*`：onebot 等聊天平台不会为每条消息创建 checkpoint。留空数组 = 禁用 checkpoint（仅允许手动 rollback）。',
+        options: [
+            { label: '所有会话', value: '*' },
+            { label: 'WebUI 会话（推荐）', value: 'webui:*' },
+            { label: 'OneBot 群聊', value: 'onebot:group' },
+            { label: 'OneBot 私聊', value: 'onebot:private' },
+            { label: 'CLI', value: 'cli:*' },
+        ],
+        default: ['webui:*'],
+    },
+};
+export const defaultConfig = {
+    rootDir: 'data:/checkpoints',
+    maxFileSize: 10 * 1024 * 1024,
+    keepSessions: 20,
+    scopes: ['webui:*'],
+};
+// ──────────── Plugin actions (供 WebUI 调用) ────────────
+export const actions = {
+    async listTurns(ctx, args) {
+        const svc = ctx.getService('checkpoint');
+        if (!svc)
+            return [];
+        const sessionId = args.sessionId ?? '';
+        if (!sessionId)
+            return { error: '缺少 sessionId' };
+        return svc.listTurns(sessionId);
+    },
+    async getManifest(ctx, args) {
+        const svc = ctx.getService('checkpoint');
+        if (!svc)
+            return null;
+        const sessionId = args.sessionId;
+        const turnId = args.turnId;
+        return svc.getManifest(sessionId, turnId);
+    },
+    async rollback(ctx, args) {
+        const svc = ctx.getService('checkpoint');
+        if (!svc)
+            return { ok: false, errors: [{ uri: '', reason: 'checkpoint 服务未启用' }] };
+        const sessionId = args.sessionId;
+        const turnId = args.turnId;
+        if (!sessionId || !turnId)
+            return { ok: false, errors: [{ uri: '', reason: '缺少 sessionId 或 turnId' }] };
+        return svc.rollback(sessionId, turnId);
+    },
+    async rollbackWithChat(ctx, args) {
+        const svc = ctx.getService('checkpoint');
+        if (!svc)
+            return {
+                ok: false,
+                errors: [{ uri: '', reason: 'checkpoint 服务未启用' }],
+                deletedMessages: 0,
+                chatDeleted: false,
+            };
+        const sessionId = args.sessionId;
+        const turnId = args.turnId;
+        if (!sessionId || !turnId)
+            return {
+                ok: false,
+                errors: [{ uri: '', reason: '缺少 sessionId 或 turnId' }],
+                deletedMessages: 0,
+                chatDeleted: false,
+            };
+        return svc.rollbackWithChat(sessionId, turnId);
+    },
+};
+// ──────────── 插件入口 ────────────
+export async function apply(ctx, rawConfig) {
+    const config = resolveConfig(rawConfig);
+    const logger = ctx.logger.child('checkpoint');
+    const storage = createStorageGateway(ctx);
+    const service = new CheckpointServiceImpl(config, logger, storage);
+    ctx.provide('checkpoint', service);
+    // 注入回滚后端：通过 storage gateway helper 按 URI 路由到各 root
+    // 在 apply 阶段，storage 可能还没注册；gateway 本身是闭包，调用时才枚举 entry
+    service.setBackend(async (uri, data) => {
+        if (ctx.getAllServices('storage').length === 0)
+            throw new Error('storage 服务不可用');
+        await storage.writeFile(uri, data);
+    }, async (uri) => {
+        if (ctx.getAllServices('storage').length === 0)
+            throw new Error('storage 服务不可用');
+        await storage.delete(uri);
+    });
+    // 注入 chat 回滚所需依赖：memory + 事件发出器（懒解析 memory，但事件发出器立即可用）
+    const memoryProxy = new Proxy({}, {
+        get(_t, prop) {
+            const m = ctx.getService('memory');
+            if (!m)
+                return undefined;
+            const v = m[prop];
+            return typeof v === 'function' ? v.bind(m) : v;
+        },
+    });
+    service.setChatRollbackDeps({
+        memory: memoryProxy,
+        emitMessagesDeleted: (sessionId, timestamps) => {
+            ctx
+                .emit('memory:messages-deleted', { sessionId, timestamps })
+                .catch(err => logger.debug(`emit memory:messages-deleted 失败: ${err.message}`));
+        },
+        emitHistoryChanged: sessionId => {
+            ctx
+                .emit('history:changed', { sessionId })
+                .catch(err => logger.debug(`emit history:changed 失败: ${err.message}`));
+        },
+    });
+    // ──────────── 回合生命周期 ────────────
+    // agent:input:before：一次 LLM 回合开始（一个用户消息进来）
+    // 仅对配置 scopes 匹配的会话参与回合生命周期，避免 onebot 等聊天平台为每条消息都创建空 checkpoint。
+    const isScopeEnabled = (platform, sessionType) => {
+        if (config.scopes.length === 0)
+            return false;
+        const p = platform ?? '';
+        const t = sessionType ?? '';
+        for (const raw of config.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;
+    };
+    ctx.middleware('agent:input:before', async (data, next) => {
+        if (isScopeEnabled(data.message.platform, data.message.sessionType)) {
+            service.beginTurn(data.message.sessionId);
+        }
+        await next();
+    });
+    // agent:turn:after：回合结束（endTurn 是幂等的：没 current 则直接 return）
+    ctx.middleware('agent:turn:after', async (_data, next) => {
+        await next();
+        await service.endTurn();
+    });
+    // 监听 exec 工具调用，给当前 turn 打 execUsed 标记（UI 显示 "部分未保护"）
+    ctx.middleware('agent:tool:before', async (data, next) => {
+        if (data.name === 'exec' || data.name === 'shell') {
+            service.markExecUsed();
+        }
+        await next();
+    });
+    // ──────────── 参与统一的 memory:clear ────────────
+    // /clear 与 session-manager.deleteSession 都通过 memory:clear hook 编排，
+    // 之前 checkpoint 没监听，导致 checkpoint 目录无人清理，长期泄漏。
+    ctx.middleware('memory:clear', async (data, next) => {
+        if (data.types && !data.types.includes('checkpoint')) {
+            await next();
+            return;
+        }
+        try {
+            if (data.scope === 'all') {
+                const n = await service.clearAll();
+                data.results.push({
+                    source: 'checkpoint',
+                    success: true,
+                    message: `所有 checkpoint 已清空（${n} 个 session）`,
+                });
+            }
+            else if (data.sessionId) {
+                const n = await service.clearSession(data.sessionId);
+                data.results.push({
+                    source: 'checkpoint',
+                    success: true,
+                    message: n > 0 ? `当前会话 checkpoint 已清空（${n} 个 turn）` : '当前会话无 checkpoint',
+                });
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            data.results.push({ source: 'checkpoint', success: false, message: `checkpoint 清空失败: ${msg}` });
+        }
+        await next();
+    });
+    logger.info(`checkpoint 服务就绪 rootUri=${config.rootUri} maxFileSize=${config.maxFileSize} scopes=${config.scopes.join('|') || '<空>'}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,138 @@
+import type { Logger } from '@aalis/core';
+import type { MemoryService } from '@aalis/plugin-memory-api';
+import type { StorageService } from '@aalis/plugin-storage-api';
+/**
+ * Checkpoint 服务
+ *
+ * 在 LLM 一次回合（assistant turn）期间记录所有受控存储中的写入/删除/重命名操作，
+ * 在改动发生前自动备份原始文件内容，使用户可以从 WebUI 一键回滚整轮操作。
+ *
+ * 协作模型：
+ * - plugin-storage-local 在执行 writeFile/delete/rename 之前，通过
+ *   `ctx.getService<CheckpointService>('checkpoint')?.beforeMutate(...)` 探测本服务。
+ * - 本服务通过 hooks `agent:input:before` / `agent:turn:after` 维护「当前回合」状态。
+ * - exec 工具直接调用系统命令，不在本服务保护范围内（前端 UI 标注「未保护」）。
+ */
+export interface CheckpointService {
+    /** 探测：是否在某个回合内（storage-local 提早判断以避免无谓 stat） */
+    isActive(): boolean;
+    /**
+     * 在 storage 即将修改 uri 时调用。本调用是 op="write"|"delete"|"rename" 之前的一次性快照机会。
+     * 如果同一 uri 在当前回合内已被快照过，则跳过（保留最早的原始内容）。
+     * loadOriginal 是按需读取原始内容的闭包；首次需要快照时才调用。
+     */
+    beforeMutate(uri: string, op: 'write' | 'delete' | 'rename', loadOriginal: () => Promise<{
+        data: Buffer;
+        size: number;
+    } | null>): Promise<void>;
+    /** 列出某个 session 的所有回合 checkpoint */
+    listTurns(sessionId: string): Promise<TurnSummary[]>;
+    /** 读取某回合 manifest */
+    getManifest(sessionId: string, turnId: string): Promise<TurnManifest | null>;
+    /** 回滚某回合（恢复 / 删除 / 重命名复原）。返回受影响文件计数 */
+    rollback(sessionId: string, turnId: string): Promise<RollbackResult>;
+    /** 回滚某回合并同步删除本轮对话消息与向量条目 */
+    rollbackWithChat(sessionId: string, turnId: string): Promise<RollbackWithChatResult>;
+    /** 清除某会话的所有 checkpoint（/clear 与 deleteSession 调用）。幂等；不存在也返回 0。 */
+    clearSession(sessionId: string): Promise<number>;
+    /** 清除全部 checkpoint（/clear all 调用）。幂等。 */
+    clearAll(): Promise<number>;
+}
+export interface CheckpointFileRecord {
+    uri: string;
+    /** write=覆盖已有, write-new=新创建, delete=删除, rename=重命名 */
+    action: 'write' | 'write-new' | 'delete' | 'rename';
+    /** 原始大小（如果有快照） */
+    originalSize?: number;
+    /** 备份 blob 文件名（相对于 turn 目录） */
+    blob?: string;
+    /** 跳过原因（过大、读取失败等） */
+    skipped?: string;
+}
+export interface TurnManifest {
+    turnId: string;
+    sessionId: string;
+    startedAt: number;
+    endedAt?: number;
+    files: CheckpointFileRecord[];
+    /** 本轮对话内消息的时间戳，用于 rollbackWithChat 精确删除消息与向量条目 */
+    messageTimestamps?: number[];
+}
+export interface TurnSummary {
+    turnId: string;
+    sessionId: string;
+    startedAt: number;
+    endedAt?: number;
+    fileCount: number;
+    /** 是否在 turn 内调用过 exec 工具（前端用于显示「部分未保护」） */
+    execUsed?: boolean;
+    /** 摘要预览（前 3 个文件 URI） */
+    filesPreview: string[];
+}
+export interface RollbackResult {
+    ok: boolean;
+    restored: string[];
+    deleted: string[];
+    errors: Array<{
+        uri: string;
+        reason: string;
+    }>;
+}
+export interface RollbackWithChatResult extends RollbackResult {
+    /** 实际从 memory 中删除的消息条数 */
+    deletedMessages: number;
+    /** chat 删除是否成功；若失败，errors 也会记录原因 */
+    chatDeleted: boolean;
+}
+interface ServiceConfig {
+    rootUri: string;
+    maxFileSize: number;
+    keepSessions: number;
+    scopes: string[];
+}
+/**
+ * 实现
+ */
+export declare class CheckpointServiceImpl implements CheckpointService {
+    private readonly cfg;
+    private readonly logger;
+    private readonly storage;
+    private current;
+    /** 当前回合内已快照过的 uri 集合（用于去重） */
+    private snapshotted;
+    /** 文件计数器，用于命名 blob 文件 */
+    private blobIndex;
+    constructor(cfg: ServiceConfig, logger: Logger, storage: StorageService);
+    beginTurn(sessionId: string): string;
+    endTurn(): Promise<void>;
+    /** 标记当前回合调用过 exec，UI 端会提示「部分未保护」 */
+    markExecUsed(): void;
+    isActive(): boolean;
+    beforeMutate(uri: string, op: 'write' | 'delete' | 'rename', loadOriginal: () => Promise<{
+        data: Buffer;
+        size: number;
+    } | null>): Promise<void>;
+    listTurns(sessionId: string): Promise<TurnSummary[]>;
+    getManifest(sessionId: string, turnId: string): Promise<TurnManifest | null>;
+    rollback(sessionId: string, turnId: string): Promise<RollbackResult>;
+    private _backendWrite?;
+    private _backendDelete?;
+    private _memory?;
+    private _emitMessagesDeleted?;
+    private _emitHistoryChanged?;
+    setBackend(write: (uri: string, data: Buffer) => Promise<void>, del: (uri: string) => Promise<void>): void;
+    /** 注入聊天回滚所需的依赖：memory 服务 + 事件发出器 */
+    setChatRollbackDeps(deps: {
+        memory: MemoryService;
+        emitMessagesDeleted: (sessionId: string, timestamps: number[]) => void;
+        emitHistoryChanged: (sessionId: string) => void;
+    }): void;
+    rollbackWithChat(sessionId: string, turnId: string): Promise<RollbackWithChatResult>;
+    private gc;
+    private turnDir;
+    clearSession(sessionId: string): Promise<number>;
+    clearAll(): Promise<number>;
+}
+export declare function resolveConfig(raw: Record<string, unknown>): ServiceConfig;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -0,0 +1,381 @@
+/**
+ * 实现
+ */
+export class CheckpointServiceImpl {
+    cfg;
+    logger;
+    storage;
+    current = null;
+    /** 当前回合内已快照过的 uri 集合（用于去重） */
+    snapshotted = new Set();
+    /** 文件计数器，用于命名 blob 文件 */
+    blobIndex = 0;
+    constructor(cfg, logger, storage) {
+        this.cfg = cfg;
+        this.logger = logger;
+        this.storage = storage;
+    }
+    // ──────────── 生命周期 ────────────
+    beginTurn(sessionId) {
+        // 如果上一回合没有正常结束，先把它 commit 掉避免遗失
+        if (this.current) {
+            this.endTurn().catch(err => this.logger.warn(`finalize 旧回合失败: ${err.message}`));
+        }
+        const turnId = crypto.randomUUID();
+        this.current = {
+            turnId,
+            sessionId,
+            startedAt: Date.now(),
+            files: [],
+        };
+        this.snapshotted = new Set();
+        this.blobIndex = 0;
+        this.logger.debug(`checkpoint 回合开始 ${sessionId} turn=${turnId}`);
+        return turnId;
+    }
+    async endTurn() {
+        if (!this.current)
+            return;
+        this.current.endedAt = Date.now();
+        // 在持久化前抓取本轮对话的消息时间戳（供 rollbackWithChat 使用）
+        // 即使本轮无文件改动，只要有消息就会持久化 manifest
+        if (this._memory && typeof this._memory.getMessagesBySessionRange === 'function') {
+            try {
+                // 宽松边界 200ms，用于容纳 archiveIncoming/saveMessage 时钟偏差
+                const msgs = await this._memory.getMessagesBySessionRange(this.current.sessionId, this.current.startedAt - 200, this.current.endedAt + 200);
+                this.current.messageTimestamps = msgs.map(m => m.timestamp).filter((t) => typeof t === 'number');
+            }
+            catch (err) {
+                this.logger.warn(`抓取本轮消息时间戳失败: ${err.message}`);
+            }
+        }
+        // 若整个回合没有任何文件改动且没有任何消息时间戳，跳过持久化
+        if (this.current.files.length === 0 &&
+            (!this.current.messageTimestamps || this.current.messageTimestamps.length === 0)) {
+            this.logger.debug(`checkpoint 回合无改动，跳过 ${this.current.turnId}`);
+            this.current = null;
+            return;
+        }
+        const turnDir = this.turnDir(this.current.sessionId, this.current.turnId);
+        await this.storage.writeFile(joinUri(turnDir, 'manifest.json'), JSON.stringify(this.current, null, 2));
+        this.logger.info(`checkpoint 回合提交 turn=${this.current.turnId} 文件数=${this.current.files.length}`);
+        this.current = null;
+        this.gc().catch(err => this.logger.warn(`checkpoint GC 失败: ${err.message}`));
+    }
+    /** 标记当前回合调用过 exec，UI 端会提示「部分未保护」 */
+    markExecUsed() {
+        if (!this.current)
+            return;
+        this.current.execUsed = true;
+    }
+    // ──────────── beforeMutate ────────────
+    isActive() {
+        return this.current !== null;
+    }
+    async beforeMutate(uri, op, loadOriginal) {
+        if (!this.current)
+            return; // 回合外，忽略
+        if (this.snapshotted.has(uri))
+            return; // 同回合已快照过
+        this.snapshotted.add(uri);
+        let original = null;
+        try {
+            original = await loadOriginal();
+        }
+        catch (err) {
+            this.logger.warn(`checkpoint 加载原文件失败 ${uri}: ${err.message}`);
+        }
+        // 情况 1：write 且原文件不存在 → 标记为新创建（回滚时需要删除）
+        if (!original && op === 'write') {
+            this.current.files.push({ uri, action: 'write-new' });
+            return;
+        }
+        // 情况 2：原文件不存在但是 delete/rename → 不可能，跳过
+        if (!original)
+            return;
+        // 情况 3：过大 → 跳过快照但记录为「skipped」
+        if (original.size > this.cfg.maxFileSize) {
+            this.current.files.push({
+                uri,
+                action: op === 'rename' ? 'rename' : op,
+                originalSize: original.size,
+                skipped: `文件过大 (${original.size} > ${this.cfg.maxFileSize})`,
+            });
+            return;
+        }
+        // 情况 4：正常快照
+        const blobName = `${this.blobIndex++}.bin`;
+        const turnDir = this.turnDir(this.current.sessionId, this.current.turnId);
+        await this.storage.writeFile(joinUri(turnDir, `blobs/${blobName}`), original.data);
+        this.current.files.push({
+            uri,
+            action: op === 'rename' ? 'rename' : op,
+            originalSize: original.size,
+            blob: blobName,
+        });
+    }
+    // ──────────── 查询 ────────────
+    async listTurns(sessionId) {
+        const sessionDir = joinUri(this.cfg.rootUri, encodeSegment(sessionId));
+        let entries;
+        try {
+            const listed = await this.storage.list(sessionDir);
+            entries = listed.entries.filter(e => e.isDirectory).map(e => e.name);
+        }
+        catch {
+            return [];
+        }
+        const summaries = [];
+        for (const turnId of entries) {
+            const manifest = await this.getManifest(sessionId, turnId);
+            if (!manifest)
+                continue;
+            summaries.push({
+                turnId: manifest.turnId,
+                sessionId: manifest.sessionId,
+                startedAt: manifest.startedAt,
+                endedAt: manifest.endedAt,
+                fileCount: manifest.files.length,
+                execUsed: manifest.execUsed,
+                filesPreview: manifest.files.slice(0, 3).map(f => f.uri),
+            });
+        }
+        summaries.sort((a, b) => b.startedAt - a.startedAt);
+        return summaries;
+    }
+    async getManifest(sessionId, turnId) {
+        const uri = joinUri(this.turnDir(sessionId, turnId), 'manifest.json');
+        try {
+            const raw = await this.storage.readFile(uri, 'utf-8');
+            return JSON.parse(String(raw));
+        }
+        catch {
+            return null;
+        }
+    }
+    // ──────────── 回滚 ────────────
+    async rollback(sessionId, turnId) {
+        const manifest = await this.getManifest(sessionId, turnId);
+        if (!manifest) {
+            return { ok: false, restored: [], deleted: [], errors: [{ uri: '', reason: 'checkpoint 不存在' }] };
+        }
+        // 通过 storage service 来执行回滚操作，避免直接绕过权限
+        // 此处通过模块外部注入 writeBack/deleteBack 函数
+        const result = { ok: true, restored: [], deleted: [], errors: [] };
+        if (!this._backendWrite || !this._backendDelete) {
+            return { ok: false, restored: [], deleted: [], errors: [{ uri: '', reason: '回滚后端未注入' }] };
+        }
+        const turnDir = this.turnDir(sessionId, turnId);
+        for (const file of manifest.files) {
+            try {
+                if (file.action === 'write-new') {
+                    // 新创建的文件 → 删除
+                    await this._backendDelete(file.uri);
+                    result.deleted.push(file.uri);
+                }
+                else if (file.skipped) {
+                    // 跳过快照的，无法恢复
+                    result.errors.push({ uri: file.uri, reason: file.skipped });
+                }
+                else if (file.blob) {
+                    const data = await this.storage.readFile(joinUri(turnDir, `blobs/${file.blob}`));
+                    await this._backendWrite(file.uri, Buffer.from(data));
+                    result.restored.push(file.uri);
+                }
+            }
+            catch (err) {
+                result.errors.push({ uri: file.uri, reason: err.message });
+            }
+        }
+        if (result.errors.length > 0)
+            result.ok = false;
+        return result;
+    }
+    // ──────────── 回滚后端注入 ────────────
+    _backendWrite;
+    _backendDelete;
+    _memory;
+    _emitMessagesDeleted;
+    _emitHistoryChanged;
+    setBackend(write, del) {
+        this._backendWrite = write;
+        this._backendDelete = del;
+    }
+    /** 注入聊天回滚所需的依赖：memory 服务 + 事件发出器 */
+    setChatRollbackDeps(deps) {
+        this._memory = deps.memory;
+        this._emitMessagesDeleted = deps.emitMessagesDeleted;
+        this._emitHistoryChanged = deps.emitHistoryChanged;
+    }
+    async rollbackWithChat(sessionId, turnId) {
+        const manifest = await this.getManifest(sessionId, turnId);
+        if (!manifest) {
+            return {
+                ok: false,
+                restored: [],
+                deleted: [],
+                errors: [{ uri: '', reason: 'checkpoint 不存在' }],
+                deletedMessages: 0,
+                chatDeleted: false,
+            };
+        }
+        // 先执行文件回滚
+        const fileResult = await this.rollback(sessionId, turnId);
+        const result = {
+            ...fileResult,
+            deletedMessages: 0,
+            chatDeleted: false,
+        };
+        const timestamps = manifest.messageTimestamps ?? [];
+        if (timestamps.length === 0) {
+            // 无消息可删（例如旧 checkpoint），仅文件回滚生效
+            result.chatDeleted = true;
+            return result;
+        }
+        if (!this._memory || typeof this._memory.deleteMessagesByTimestamps !== 'function') {
+            result.errors.push({ uri: '', reason: '当前 memory 后端不支持 deleteMessagesByTimestamps' });
+            result.ok = false;
+            return result;
+        }
+        try {
+            result.deletedMessages = await this._memory.deleteMessagesByTimestamps(sessionId, timestamps);
+            result.chatDeleted = true;
+        }
+        catch (err) {
+            result.errors.push({ uri: '', reason: `删除消息失败: ${err.message}` });
+            result.ok = false;
+            return result;
+        }
+        // 通知向量插件清理同时间戳的向量条目
+        try {
+            this._emitMessagesDeleted?.(sessionId, timestamps);
+        }
+        catch (err) {
+            this.logger.warn(`emit memory:messages-deleted 失败: ${err.message}`);
+        }
+        // 通知前端刷新历史
+        try {
+            this._emitHistoryChanged?.(sessionId);
+        }
+        catch (err) {
+            this.logger.warn(`emit history:changed 失败: ${err.message}`);
+        }
+        return result;
+    }
+    // ──────────── GC ────────────
+    async gc() {
+        if (this.cfg.keepSessions <= 0)
+            return;
+        let sessions;
+        try {
+            const listed = await this.storage.list(this.cfg.rootUri);
+            sessions = listed.entries.filter(e => e.isDirectory).map(e => ({ name: e.name, uri: e.uri }));
+        }
+        catch {
+            return;
+        }
+        if (sessions.length <= this.cfg.keepSessions)
+            return;
+        // 按 session 目录的最新 mtime 排序，淘汰最旧的
+        const sessionInfo = [];
+        for (const item of sessions) {
+            try {
+                const s = await this.storage.stat(item.uri);
+                sessionInfo.push({ name: item.name, uri: item.uri, mtime: new Date(s.mtime).getTime() || 0 });
+            }
+            catch {
+                /* skip */
+            }
+        }
+        sessionInfo.sort((a, b) => b.mtime - a.mtime);
+        const toDelete = sessionInfo.slice(this.cfg.keepSessions);
+        for (const item of toDelete) {
+            try {
+                await this.storage.delete(item.uri);
+            }
+            catch (err) {
+                this.logger.warn(`GC 删除 ${item.name} 失败: ${err.message}`);
+            }
+        }
+    }
+    turnDir(sessionId, turnId) {
+        return joinUri(this.cfg.rootUri, `${encodeSegment(sessionId)}/${encodeSegment(turnId)}`);
+    }
+    // ──────────── 会话级清理 ────────────
+    // 与 plugin-commands / plugin-session-manager 的 memory:clear 调度对齐，
+    // 避免 /clear 与 deleteSession 后 checkpoint 目录泄露。
+    async clearSession(sessionId) {
+        const sessionDir = joinUri(this.cfg.rootUri, encodeSegment(sessionId));
+        try {
+            const listed = await this.storage.list(sessionDir);
+            const count = listed.entries.filter(e => e.isDirectory).length;
+            await this.storage.delete(sessionDir);
+            if (count > 0)
+                this.logger.info(`checkpoint 清理 session=${sessionId} 共 ${count} 个 turn`);
+            return count;
+        }
+        catch (err) {
+            // 目录不存在是正常情况
+            this.logger.debug(`checkpoint clearSession ${sessionId} 跳过: ${err.message}`);
+            return 0;
+        }
+    }
+    async clearAll() {
+        try {
+            const listed = await this.storage.list(this.cfg.rootUri);
+            const sessions = listed.entries.filter(e => e.isDirectory);
+            for (const item of sessions) {
+                try {
+                    await this.storage.delete(item.uri);
+                }
+                catch (err) {
+                    this.logger.warn(`checkpoint clearAll 删 ${item.name} 失败: ${err.message}`);
+                }
+            }
+            if (sessions.length > 0)
+                this.logger.info(`checkpoint 全量清理：${sessions.length} 个 session`);
+            return sessions.length;
+        }
+        catch (err) {
+            this.logger.debug(`checkpoint clearAll 跳过: ${err.message}`);
+            return 0;
+        }
+    }
+}
+function joinUri(base, rel) {
+    const b = base.endsWith('/') ? base : `${base}/`;
+    return `${b}${rel.replace(/^\/+/, '')}`;
+}
+/** 文件系统路径段：把 ":" "/" "\" 等特殊字符 URL 编码 */
+function encodeSegment(s) {
+    return s.replace(/[^A-Za-z0-9._-]/g, c => `_${c.charCodeAt(0).toString(16)}`);
+}
+export function resolveConfig(raw) {
+    const rootInput = typeof raw.rootDir === 'string' ? raw.rootDir : 'data:/checkpoints';
+    const rawScopes = raw.scopes;
+    const scopes = Array.isArray(rawScopes)
+        ? rawScopes.filter((x) => typeof x === 'string' && x.length > 0)
+        : typeof rawScopes === 'string' && rawScopes.length > 0
+            ? rawScopes
+                .split(/[,\s]+/)
+                .map(s => s.trim())
+                .filter(Boolean)
+            : ['webui:*'];
+    return {
+        rootUri: toUri(rootInput),
+        maxFileSize: typeof raw.maxFileSize === 'number' ? Math.max(1024, raw.maxFileSize) : 10 * 1024 * 1024,
+        keepSessions: typeof raw.keepSessions === 'number' ? Math.max(0, Math.floor(raw.keepSessions)) : 20,
+        scopes,
+    };
+}
+function toUri(input) {
+    const s = String(input ?? '').trim();
+    if (!s)
+        return 'data:/checkpoints';
+    if (s.includes(':/'))
+        return s;
+    const cleaned = s.replace(/^\.?\/+/, '');
+    const idx = cleaned.indexOf('/');
+    return idx > 0 ? `${cleaned.slice(0, idx)}:/${cleaned.slice(idx + 1)}` : `data:/${cleaned}`;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@aalis/plugin-checkpoint",
+  "version": "0.1.0",
+  "type": "module",
+  "keywords": [
+    "aalis-plugin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aalis/plugin-agent-api": "^0.1.0",
+    "@aalis/plugin-storage-api": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/plugin-memory-api": "0.1.0",
+    "@aalis/plugin-webui-api": "0.1.0",
+    "@aalis/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@aalis/core": "^0.1.0"
+  },
+  "aalis": {
+    "service": {
+      "provides": [
+        "checkpoint"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}